트레이더 연동 개요
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 |
두 가지 사용 방법
섹션 제목: “두 가지 사용 방법”- 명령줄: 터미널이나 스크립트에서
jv를 직접 실행합니다. 결과는 JSON으로 출력되어 프로그램에서 처리하기 쉽습니다. 명령줄로 거래하기와 스크립트와 트레이딩 봇 작성을 참고하십시오. - AI 에이전트:
jv mcp는 MCP 서버입니다. Claude Code, Cursor 등 AI 클라이언트를 연결하면 자연어로 주문할 수 있습니다. AI 에이전트로 거래하기를 참고하십시오.
두 방법은 같은 로컬 권한 부여를 공유하므로 한 번만 권한을 부여하면 됩니다. CLI는 기본적으로 Jasper Vault 정식 환경에 연결되며, 이 환경은 CLI에서 beta라고 부릅니다.
신뢰 모델
섹션 제목: “신뢰 모델”한 번만 권한 부여
섹션 제목: “한 번만 권한 부여”jv enable을 실행하면 다음과 같이 진행됩니다.
- CLI가 컴퓨터에서 새 개인 키를 무작위로 생성합니다. 이를 위임 키라고 합니다. 위임 키는 지갑 개인 키와 아무 관련이 없습니다.
- CLI가 URL을 제공합니다. 브라우저에서 열고 지갑을 연결한 뒤 권한 부여 메시지에 서명하면, 위임 키가 지갑의 승인된 서명자로 등록됩니다. 이 단계는 서명만 할 뿐 지갑에서 송금 트랜잭션이 발생하지 않으며, 지갑 개인 키도 항상 지갑 안에 남아 있습니다.
- 이후 포지션 오픈, 종료, 익절·손절 설정은 모두 위임 키가 이 컴퓨터에서 서명하므로 지갑 팝업이 더 이상 뜨지 않습니다.
위임 키로 할 수 있는 일
섹션 제목: “위임 키로 할 수 있는 일”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
거래하기 전에 먼저 중요 위험 고지를 읽어 주십시오.
다음 단계
섹션 제목: “다음 단계”- jv CLI 설치 후 권한 부여 완료
- CLI로 입금 및 출금
- 명령줄로 거래하기 또는 AI 에이전트로 거래하기
- 프로그램 매매를 작성하기 전에 스크립트와 트레이딩 봇 작성을 먼저 읽고, 명령과 오류는 명령어 빠른 참조에서 확인하십시오