콘텐츠로 이동

jv CLI 설치

Node.js 18 이상이 필요합니다.

npm i -g jaspervault_cli
jv --version

이후 최신 버전으로 업그레이드하려면 jv update를 실행하십시오. 이 명령은 npm update -g jaspervault_cli를 실행합니다.

jv update는 전역 설치에만 적용됩니다. 제거하려면 npm uninstall -g jaspervault_cli를 실행하십시오.

아래 두 명령은 권한 부여 없이 실행할 수 있습니다. 설치 후 먼저 실행해 Jasper Vault에 연결되는지 확인하십시오.

jv market list
jv price --symbol JVBTC

마켓 목록과 가격이 표시되면 설치와 네트워크가 정상입니다. 나머지 명령은 아래의 권한 부여를 먼저 완료해야 합니다.

jv enable과 jv withdraw를 사용하려면 환경 변수 BASE_HTTP_RPC_URL에 Base 메인넷 RPC 주소를 설정해야 합니다. 설정하지 않으면 두 명령은 바로 오류를 내고 종료됩니다. Base 공식 공개 노드를 사용해도 되고, 직접 이용하는 노드 제공업체의 주소를 사용해도 됩니다.

export BASE_HTTP_RPC_URL=https://mainnet.base.org

이 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하면 이후 여는 모든 터미널에 적용됩니다.

jv enable --pretty
  1. 명령은 먼저 JSON을 출력합니다. url은 권한 부여 페이지 주소이고, expiresAt은 페이지 만료 시각입니다.
  2. 브라우저에서 url을 열고 지갑을 연결한 뒤 페이지 안내에 따라 서명합니다. 이 권한 부여 메시지는 Base 체인(chainId 8453) 기준으로 서명되므로, 지갑이 네트워크 전환을 요청하면 Base로 전환하십시오. 서명하기 전에 두 필드를 확인할 수 있습니다. signer는 이 컴퓨터에서 방금 생성된 위임 키 주소이고, deadline은 권한 부여 만료 시각입니다. 권한 부여의 유효 기간은 현재 서명 시점부터 7일입니다.
  3. 명령은 완료될 때까지 기다리며, 기본 대기 시간은 최대 900초입니다. --timeout <초>로 조정할 수 있습니다. 대기하는 동안 stderr에 10초마다 대기 상태가 한 줄씩 출력됩니다. 권한 부여 페이지는 생성 후 15분이 지나면 만료됩니다(expiresAt이 그 시각입니다). --timeout을 늘려도 페이지의 유효 기간은 늘어나지 않습니다.
  4. 완료되면 결과를 출력합니다.
{
  "success": true,
  "message": "Vault setup completed",
  "walletAddress": "0x…",
  "delegationAddress": "0x…",
  "marginAccount": "0x…",
  "vaults": [ … ],
  "transactionHash": "0x…"
}
  • walletAddress: 지갑 주소입니다.
  • delegationAddress: 위임 키 주소입니다.
  • marginAccount: Jasper Vault의 증거금 계정으로, 입금은 이 주소로 전송됩니다.
  • vaults: 포지션을 보유하는 포지션 계정입니다. 주문할 때 CLI가 자동으로 선택하므로 직접 지정할 필요가 없습니다. 입금과 출금은 증거금 계정에만 관련됩니다.

페이지가 만료되었거나 서명을 완료하지 않으면 명령은 "success": false를 출력하고 종료 코드 3으로 끝납니다. 다시 실행하면 됩니다.

권한 부여가 만료되면 같은 지갑 프로필로 jv enable을 다시 실행해 갱신하십시오. 위임 키로 할 수 있는 일과 할 수 없는 일은 트레이더 연동 개요를 참고하십시오.

jv enable을 실행할 때마다 지갑 프로필이 하나씩 저장됩니다. 이름은 <이름>@beta이며 기본값은 default@beta입니다. 다른 지갑에 권한을 부여하려면 --name으로 새 이름을 지정하십시오.

jv enable --name hedge

이렇게 하면 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가 새 위임 키를 생성해 다시 권한을 부여하며, 이전 키의 권한 부여 역시 만료되어야 효력을 잃습니다.

~/.jaspervault/
├── active.json              현재 사용 중인 지갑 프로필 이름
├── update-check.json        새 버전 확인 캐시
└── profiles/
    └── default@beta/
        ├── keys.json        위임 key(개인 키 평문)
        └── profile.json     지갑 주소, 위임 key 주소, 증거금 계정 및 포지션 계정 주소

~는 $HOME을 가리키며, Windows에서는 %USERPROFILE%입니다. keys.json과 profile.json의 권한은 현재 사용자만 읽고 쓸 수 있도록 설정됩니다. keys.json은 비밀번호처럼 보관하십시오.

다음 단계: CLI로 입금 및 출금.