jv CLI 설치
Node.js 18 이상이 필요합니다.
이후 최신 버전으로 업그레이드하려면 jv update를 실행하십시오. 이 명령은 npm update -g jaspervault_cli를 실행합니다.
jv update는 전역 설치에만 적용됩니다. 제거하려면 npm uninstall -g jaspervault_cli를 실행하십시오.
먼저 연결 확인하기
섹션 제목: “먼저 연결 확인하기”아래 두 명령은 권한 부여 없이 실행할 수 있습니다. 설치 후 먼저 실행해 Jasper Vault에 연결되는지 확인하십시오.
마켓 목록과 가격이 표시되면 설치와 네트워크가 정상입니다. 나머지 명령은 아래의 권한 부여를 먼저 완료해야 합니다.
BASE_HTTP_RPC_URL 설정
섹션 제목: “BASE_HTTP_RPC_URL 설정”jv enable과 jv withdraw를 사용하려면 환경 변수 BASE_HTTP_RPC_URL에 Base 메인넷 RPC 주소를 설정해야 합니다. 설정하지 않으면 두 명령은 바로 오류를 내고 종료됩니다. Base 공식 공개 노드를 사용해도 되고, 직접 이용하는 노드 제공업체의 주소를 사용해도 됩니다.
이 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하면 이후 여는 모든 터미널에 적용됩니다.
권한 부여: jv enable
섹션 제목: “권한 부여: jv enable”- 명령은 먼저 JSON을 출력합니다.
url은 권한 부여 페이지 주소이고,expiresAt은 페이지 만료 시각입니다. - 브라우저에서
url을 열고 지갑을 연결한 뒤 페이지 안내에 따라 서명합니다. 이 권한 부여 메시지는 Base 체인(chainId 8453) 기준으로 서명되므로, 지갑이 네트워크 전환을 요청하면 Base로 전환하십시오. 서명하기 전에 두 필드를 확인할 수 있습니다.signer는 이 컴퓨터에서 방금 생성된 위임 키 주소이고,deadline은 권한 부여 만료 시각입니다. 권한 부여의 유효 기간은 현재 서명 시점부터 7일입니다. - 명령은 완료될 때까지 기다리며, 기본 대기 시간은 최대 900초입니다.
--timeout <초>로 조정할 수 있습니다. 대기하는 동안 stderr에 10초마다 대기 상태가 한 줄씩 출력됩니다. 권한 부여 페이지는 생성 후 15분이 지나면 만료됩니다(expiresAt이 그 시각입니다).--timeout을 늘려도 페이지의 유효 기간은 늘어나지 않습니다. - 완료되면 결과를 출력합니다.
walletAddress: 지갑 주소입니다.delegationAddress: 위임 키 주소입니다.marginAccount: Jasper Vault의 증거금 계정으로, 입금은 이 주소로 전송됩니다.vaults: 포지션을 보유하는 포지션 계정입니다. 주문할 때 CLI가 자동으로 선택하므로 직접 지정할 필요가 없습니다. 입금과 출금은 증거금 계정에만 관련됩니다.
페이지가 만료되었거나 서명을 완료하지 않으면 명령은 "success": false를 출력하고 종료 코드 3으로 끝납니다. 다시 실행하면 됩니다.
권한 부여가 만료되면 같은 지갑 프로필로 jv enable을 다시 실행해 갱신하십시오. 위임 키로 할 수 있는 일과 할 수 없는 일은 트레이더 연동 개요를 참고하십시오.
여러 지갑: jv wallet
섹션 제목: “여러 지갑: jv wallet”jv enable을 실행할 때마다 지갑 프로필이 하나씩 저장됩니다. 이름은 <이름>@beta이며 기본값은 default@beta입니다. 다른 지갑에 권한을 부여하려면 --name으로 새 이름을 지정하십시오.
이렇게 하면 hedge@beta가 생성되고 현재 사용 중인 지갑 프로필로 설정됩니다. 모든 거래 및 조회 명령은 현재 지갑 프로필을 사용합니다. beta는 CLI에서 Jasper Vault 정식 환경을 부르는 이름입니다.
| 명령 | 기능 |
|---|---|
jv wallet list |
모든 지갑 프로필을 나열합니다. active가 *인 것이 현재 사용 중인 프로필입니다 |
jv wallet info |
현재 지갑 프로필의 지갑 주소(eoa), 위임 키 주소, 증거금 계정 및 포지션 계정 |
jv wallet switch <이름> |
현재 지갑 프로필을 전환합니다. 이름을 지정하지 않으면 대화형으로 선택하므로, 스크립트에서는 이름을 지정하십시오 |
jv wallet rename <이전이름> <새이름> |
이름을 변경합니다. 새 이름에 @beta 접미사가 없으면 다음 실행 시 자동으로 붙습니다 |
jv wallet remove <이름> |
지갑 프로필과 해당 로컬 키 파일을 삭제합니다. 현재 사용 중인 프로필은 삭제할 수 없습니다 |
지갑 프로필을 삭제하면 이 컴퓨터의 파일만 삭제되며, 온체인 권한 부여는 만료될 때까지 계속 유효합니다. 키 파일을 잃어버린 뒤 jv enable을 다시 실행하면 CLI가 새 위임 키를 생성해 다시 권한을 부여하며, 이전 키의 권한 부여 역시 만료되어야 효력을 잃습니다.
로컬 파일
섹션 제목: “로컬 파일”~는 $HOME을 가리키며, Windows에서는 %USERPROFILE%입니다. keys.json과 profile.json의 권한은 현재 사용자만 읽고 쓸 수 있도록 설정됩니다. keys.json은 비밀번호처럼 보관하십시오.
다음 단계: CLI로 입금 및 출금.