Helius CLI - Helius Docs

Helius CLI는 Helius 플랫폼을 위한 완전한 기능의 명령줄 인터페이스입니다. 계정 관리, 블록체인 데이터 쿼리, 트랜잭션 전송, 웹훅, 실시간 스트리밍, 스테이킹, ZK Compression 등을 위한 95개 이상의 명령어를 제공하며, 모든 명령에 기계 판독 가능한 JSON 출력을 제공합니다.

MCP 호환 AI 도구를 사용 중인가요? Helius MCP 서버는 AI 에이전트가 Helius와 상호 작용하는 데 권장되는 방법입니다. 구조화된 입력/출력을 갖춘 10개의 라우팅 도구를 제공하며, 계정 등록이 내장되어 있습니다. MCP를 사용할 수 없을 때는 셸 스크립트, CI/CD 파이프라인 등을 위해 CLI를 사용하십시오.

설치

npm install -g helius-cli

빠른 시작 — 기존 사용자

이미 Helius API 키가 있다면 설정하고 시작하십시오:

helius config set-api-key YOUR_API_KEY

키는 dashboard.helius.dev에서 가져오십시오. 그것으로 끝입니다 — 아래의 가입 단계를 건너뛰십시오.

빠른 시작 — 신규 사용자

계정을 생성하는 helius signup 호출에는 Agent 플랜을 포함하여 --email, --first-name 및 --last-name이 필요합니다. 지갑은 결제에만 사용되며 연락처 정보를 대체하지 않습니다. 호스팅된 링크를 통해 결제한 후 기존 가입을 완료하는 helius signup --resume에는 다른 플래그가 필요하지 않습니다.

키페어 생성

helius keygen

출력:

✓ Keypair generated
  Path:    ~/.helius/keypair.json
  Address: 7xKp...3nQm

To use this wallet, fund it with:
  - ~0.001 SOL for transaction fees
  - USDC for your chosen plan:
      agent          $10 (one-time)
      developer      $49/mo
      business       $499/mo
      professional   $999/mo

Then run: helius signup --email <email> --first-name <name> --last-name <name>
  Options: --plan <plan> --period monthly|yearly --coupon <code> --pay

위의 자금 조언은 자동 결제를 사용할 경우에만 적용됩니다 — 호스팅된 링크를 통해 결제할 계획이라면 자금을 건너뛰십시오.

계정 생성

두 가지 결제 방식: 호스팅된 링크로 결제(지갑으로 결제, 자금 필요 없음) 또는 자동 결제(로컬 키페어에서 USDC 결제, 약 0.001 SOL + 계획 금액이 있어야 함).

# Default: print a hosted payment link, pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe

# After paying via link, finalize the account
helius signup --resume

# Or autopay from the local keypair
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

API 키 및 엔드포인트 가져오기

helius projects
helius apikeys <project-id>
helius rpc <project-id>

API 키는 Helius 계정에 대한 액세스를 부여하는 민감한 정보입니다. 클라이언트 측 코드, 공개 저장소 또는 브라우저에서 접근 가능한 영역에 노출하지 마십시오.

요금제 및 가격

CLI를 통해 Helius 공유 요금제를 직접 구매할 수 있습니다. 가입 중 --plan를 전달하거나 나중에 helius upgrade를 사용하십시오:

달러로 표시된 모든 가격은 미국 달러(USD) 기준입니다.

플랜	가격	크레딧	`--plan` 값
Agent	$10 일회성 결제	1,000,000	`agent`
Developer	$49/월	10,000,000	`developer`
Business	$499/월	100,000,000	`business`
Professional	$999/월	200,000,000	`professional`

Agent 플랜(agent)이 기본값입니다. 악용을 방지하기 위해 $10(USDC로 결제)의 비용이 부과되며 1,000,000 크레딧이 제공됩니다. 더 높은 사용량 제한과 더 많은 크레딧이 필요하면 유료 플랜으로 가입하거나 나중에 업그레이드하세요.

특정 플랜으로 가입하기

# Default: Agent plan ($10)
helius signup --email you@example.com --first-name Jane --last-name Doe

# Developer plan ($49/mo)
helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe

# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe

기존 계정 업그레이드하기

helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe

갱신 요금 결제하기

구독 갱신 시점(매월 또는 매년)이 되면 Helius는 고유 ID, 금액, 만료 시간이 포함된 대기 중인 결제인 결제 인텐트를 생성합니다. 결제 인텐트 ID는 이메일 또는 대시보드를 통해 받을 수 있습니다.

helius pay <payment-intent-id>

이 명령어는 인텐트 세부 정보를 가져와 금액과 만료 시간을 표시하고 확인을 요청한 다음, 키페어 지갑에서 USDC 결제를 전송합니다.

명령어 레퍼런스

CLI는 14개 카테고리에 걸쳐 95개 이상의 명령어를 제공합니다. 모든 명령어는 머신 리더블 출력을 위한 --json와 --api-key <key> / --network <net> 전역 재정의를 지원합니다.

Full Command Reference

계정 관리, 블록체인 쿼리, DAS API, 지갑, 웹훅, 트랜잭션 전송, WebSocket, 스테이킹, ZK 압축 등을 포함한 95개 이상의 모든 명령어

JSON 출력 모드

머신 리더블 출력을 사용하려면 명령어에 --json를 추가하세요.

helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json

예시:

{
  "projects": [
    {
      "id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
      "name": "My Project",
      "plan": "free"
    }
  ]
}

종료 코드

에이전트가 안정적으로 자동화 작업을 수행하려면 종료 코드를 확인해야 합니다.

코드	의미
0	성공
1	일반 오류
10	로그인되지 않음
11	키페어를 찾을 수 없음
20	SOL 부족
21	USDC 부족
30	프로젝트를 찾을 수 없음
31	프로젝트를 찾을 수 없음
40	API 오류

구성

구성은 ~/.helius/에 저장됩니다.

~/.helius/
├── config.json    # JWT token, API key, network, default project
└── keypair.json   # Solana keypair (if generated with keygen)

다음 명령어로 구성을 관리하세요.

helius config show              # View current config
helius config set-api-key <key> # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project <id>  # Set default project
helius config clear             # Reset everything

API 키 확인 순서

API 키는 다음 순서로 확인됩니다.

--api-key <key> 플래그(명령어별 재정의)
HELIUS_API_KEY 환경 변수
~/.helius/config.json(helius config set-api-key를 통해 설정)

전역 옵션

모든 명령어에서 다음 플래그를 사용할 수 있습니다.

플래그	설명
`--api-key <key>`	구성된 API 키 재정의
`--network <net>`	네트워크 재정의(`mainnet` 또는 `devnet`)
`--json`	JSON 형식으로 출력
`-k, --keypair <path>`	키페어 파일 경로(서명이 필요한 명령어)

전체 에이전트 워크플로

# Step 1: Generate keypair
helius keygen

# Step 2: Create account (default: hosted payment link, pay from any wallet)
helius signup --email you@example.com --first-name Jane --last-name Doe
helius signup --resume   # Finalize after paying via link
# Or autopay from the local keypair (requires ~0.001 SOL + plan USDC):
# helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

# Step 3: Get API keys
helius projects
helius apikeys <project-id>

# Step 4: Get RPC endpoints
helius rpc <project-id>

# Step 5: Start querying
helius balance <address>
helius asset owner <wallet-address>
helius tx history <address> --limit 10

다음 단계

Agents Overview

에이전트를 위한 API 가이드, 워크플로 및 오류 처리

Helius MCP

AI 도구를 Helius API에 직접 연결하세요

View Plans

Helius 플랜과 업그레이드 옵션을 확인하세요

Dashboard

API 사용량을 모니터링하고 키를 관리하세요

지원

Discord Community

실시간 도움과 커뮤니티 지원을 받으려면 Discord에 참여하세요

Email Support

지원팀에 직접 문의하세요

​설치

​빠른 시작 — 기존 사용자

​빠른 시작 — 신규 사용자

​요금제 및 가격

​특정 플랜으로 가입하기

​기존 계정 업그레이드하기

​갱신 요금 결제하기

​명령어 레퍼런스

Full Command Reference

​JSON 출력 모드

​종료 코드

​구성

​API 키 확인 순서

​전역 옵션

​전체 에이전트 워크플로

​다음 단계

Agents Overview

Helius MCP

View Plans

Dashboard

​지원

Discord Community

Email Support

설치

빠른 시작 — 기존 사용자

빠른 시작 — 신규 사용자

요금제 및 가격

특정 플랜으로 가입하기

기존 계정 업그레이드하기

갱신 요금 결제하기

명령어 레퍼런스

JSON 출력 모드

종료 코드

구성

API 키 확인 순서

전역 옵션

전체 에이전트 워크플로

다음 단계

지원