콘텐츠로 이동

트레이더 연동 개요

Jasper Vault는 명령줄 도구 jv(npm 패키지 jaspervault_cli)를 제공합니다. 이 도구로 터미널, 스크립트 또는 AI 에이전트에서 무기한 선물을 거래할 수 있습니다.

기능 명령
거래 가능한 시장과 실시간 가격 조회 jv market list, jv price
무기한 선물 시장가 주문, 지정가 주문, 포지션 추가, 축소, 종료 jv order create, jv order close
익절·손절 jv tp set, jv sl set
Perpetual Protect(PP): 포지션 오픈 시 PPO를 함께 적용하거나 기존 포지션에 별도로 추가 --ppo 계열 파라미터, jv order protect
Base에서 입금, Base로 출금: 명령이 웹 페이지 주소를 제공하며, 웹 페이지에서 지갑으로 서명 jv deposit, jv withdraw
포지션, 지정가 주문, 익절·손절 주문 및 시장가 주문 실행 결과 조회 jv orders, jv limit-order, jv job status

두 방법은 같은 로컬 권한 부여를 공유하므로 한 번만 권한을 부여하면 됩니다. CLI는 기본적으로 Jasper Vault 정식 환경에 연결되며, 이 환경은 CLI에서 beta라고 부릅니다.

jv enable을 실행하면 다음과 같이 진행됩니다.

  1. CLI가 컴퓨터에서 새 개인 키를 무작위로 생성합니다. 이를 위임 키라고 합니다. 위임 키는 지갑 개인 키와 아무 관련이 없습니다.
  2. CLI가 URL을 제공합니다. 브라우저에서 열고 지갑을 연결한 뒤 권한 부여 메시지에 서명하면, 위임 키가 지갑의 승인된 서명자로 등록됩니다. 이 단계는 서명만 할 뿐 지갑에서 송금 트랜잭션이 발생하지 않으며, 지갑 개인 키도 항상 지갑 안에 남아 있습니다.
  3. 이후 포지션 오픈, 종료, 익절·손절 설정은 모두 위임 키가 이 컴퓨터에서 서명하므로 지갑 팝업이 더 이상 뜨지 않습니다.

CLI가 위임 키로 서명하는 작업은 다음과 같습니다.

  • 권한 부여 시 Jasper Vault 계정 생성
  • 포지션 오픈, 추가, 축소, 종료(지정가 주문과 익절·손절 주문 포함)
  • 포지션에 PPO 구매

컨트랙트가 위임 키의 서명을 받아들이는 범위는 CLI가 사용하는 범위보다 넓으며, 증거금 추가, PP 선불 잔액으로 자금 이체, 옵션 오퍼(offer) 생성 등의 작업도 포함됩니다.

이 작업들은 모두 계정의 자금을 사용하므로, 잘못되거나 악의적인 지시로 손실이 발생할 수 있습니다. 권한 부여가 만료되기 전까지는 이 키를 손에 넣은 사람이 해당 계정으로 이러한 작업을 할 수 있습니다. 계정 자금을 움직일 수 있는 자격 증명으로 여기고 보관하십시오.

위임 키로는 출금에 서명할 수 없습니다. 컨트랙트는 출금 서명이 지갑 본인에게서 나와야 한다고 요구하므로, 위임 키로 서명한 출금은 거부됩니다. jv withdraw 역시 웹 페이지를 열어 브라우저에서 지갑으로 서명하게 합니다.

  • 권한 부여에는 만료 시각이 있으며, 권한 부여 메시지의 deadline 필드에 적혀 있습니다. 서명하기 전에 지갑의 서명 요청에서 확인할 수 있습니다. 만료되면 컨트랙트가 이 키의 서명을 더 이상 받아들이지 않으므로 주문이 실패합니다. 현재는 서명 후 7일입니다.
  • 만료 후 jv enable을 다시 실행하고 지갑으로 다시 서명하면 갱신됩니다. CLI는 같은 키를 계속 사용합니다.
  • CLI에는 현재 권한 부여를 철회하는 명령이 없습니다. 로컬 키 파일이나 지갑 프로필을 삭제해도 이 컴퓨터의 파일만 지워질 뿐, 온체인 권한 부여는 무효화되지 않습니다.

위임 키는 ~/.jaspervault/profiles/<지갑프로필이름>/keys.json에 평문으로 저장됩니다. CLI는 이 파일의 권한을 현재 사용자만 읽고 쓸 수 있도록 설정하지만, Windows에서는 설정되지 않을 수 있습니다.

  • 이 파일이나 그 내용을 누구에게도 보내지 말고, AI 대화에도 붙여 넣지 마십시오.
  • ~/.jaspervault/를 Git 저장소, 클라우드 동기화 폴더 또는 공유 디스크에 두지 마십시오.
  • 파일이 유출되었다고 의심되면 가능한 한 빨리 웹에서 또는 jv withdraw로 자금을 Base로 출금하십시오. 출금에는 지갑 본인의 서명이 필요하며, 위임 키로는 서명할 수 없습니다.
  • Node.js 18 이상
  • 브라우저 지갑(예: MetaMask, Rabby)
  • 입금에 사용할 Base 체인의 자산과 gas 비용을 지불할 ETH

거래하기 전에 먼저 중요 위험 고지를 읽어 주십시오.

  1. jv CLI 설치 후 권한 부여 완료
  2. CLI로 입금 및 출금
  3. 명령줄로 거래하기 또는 AI 에이전트로 거래하기
  4. 프로그램 매매를 작성하기 전에 스크립트와 트레이딩 봇 작성을 먼저 읽고, 명령과 오류는 명령어 빠른 참조에서 확인하십시오