본문으로 건너뛰기

CLI 명령어

create-volr 전체 명령어 레퍼런스입니다.

init (npx create-volr)​

설정 위저드입니다. Volr을 시작하는 권장 방법입니다.

npx create-volr

위저드가 다음 단계를 순서대로 실행합니다:

  1. 인증 — 이메일로 로그인 (OTP 인증)
  2. 지갑 — 브라우저에서 수신 지갑 연결
  3. 프로젝트 — 새 체크아웃 프로젝트 생성 또는 기존 프로젝트 선택
  4. 토큰 — 허용할 스테이블코인 선택 (USDC, USDT 등)

완료 후 생성되는 파일:

  • volr.json — 프로젝트 설정
  • .env의 VOLR_SERVER_KEY — 서버 API 키

auth​

인증을 관리합니다.

volr auth login      # Volr 계정에 로그인
volr auth logout     # 로그아웃 및 저장된 인증 정보 삭제
volr auth whoami     # 현재 인증된 사용자 표시

checkout​

체크아웃 설정 및 테스트를 관리합니다.

checkout setup​

체크아웃 설정 및 허용 토큰을 업데이트하는 인터랙티브 설정:

volr checkout setup

volr.json에 저장되는 설정:

  • 허용 토큰 및 체인
  • 웹훅 URL 및 시크릿
  • 성공/취소 리디렉트 URL

checkout doctor​

체크아웃 설정을 검증합니다:

volr checkout doctor

확인 항목:

  • 서버 API 키 유효성
  • 웹훅 URL 접근 가능 여부
  • 웹훅 시크릿 설정 여부
  • 가맹점 주소 설정 여부
  • 허용 토큰 설정 여부

출력 예시:

Volr Checkout Doctor
====================
✓ Server key is valid
✓ Webhook URL is reachable (https://mysite.com/webhooks/volr)
✓ Webhook secret is configured
✓ Merchant address is set (0x1234...abcd)
✓ Accepted tokens: USDC, USDT on Base

All checks passed! Your checkout integration is ready.

checkout create-test​

Base Sepolia에서 테스트 체크아웃을 생성합니다:

volr checkout create-test

테스트넷에서 소액 테스트 체크아웃을 생성합니다. 실제 자금 없이 웹훅 핸들러를 검증하는 데 유용합니다.

skill​

AI IDE 스킬을 관리합니다.

volr skill install    # AI IDE용 Volr 스킬 설치
volr skill list       # 사용 가능한 스킬 목록

skill install​

IDE를 감지하고 적절한 스킬 파일을 설치합니다:

  • Claude Code — .claude/skills/ 디렉토리
  • Cursor — .cursor/rules/ 디렉토리
  • Codex — AGENTS.md 파일
  • Windsurf — .windsurfrules 파일

글로벌 옵션​

플래그설명
--help모든 명령어의 도움말 표시
--versionCLI 버전 표시