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 호출은 --email, --first-name, --last-name가 필요합니다 — 에이전트 플랜을 포함하여.

키페어 생성

helius keygen

출력:

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

To use this wallet, fund it with:
  • ~0.001 SOL for transaction fees
  • 1 USDC for Helius signup

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

계정 생성

두 가지 결제 방식: 호스팅된 링크로 결제(지갑으로 결제, 자금 필요 없음) 또는 자동 결제(로컬 키페어에서 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를 사용하십시오:

플랜	가격	크레딧	`--plan` 값
에이전트	$1 일회성	1,000,000	`agent`
개발자	$49/월	10,000,000	`developer`
비즈니스	$499/월	100,000,000	`business`
프로페셔널	$999/월	200,000,000	`professional`

에이전트 플랜 (agent)은 기본 설정입니다. 남용을 방지하기 위해 $1(USDC로 지불)을 필요로 하며, 1,000,000 크레딧을 제공합니다. 높은 속도 제한과 더 많은 크레딧을 위해 유료 요금제에 가입하거나 나중에 업그레이드하십시오.

특정 요금제로 가입

# Default: Agent plan ($1)
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개 이상의 명령어를 제공합니다. 모든 명령은 기계 판독 가능한 출력과 --api-key <key> / --network <net> 전역 재정의를 지원합니다.

전체 명령어 참조

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

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

다음 단계

에이전트 개요

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

Helius MCP

AI 도구를 Helius API에 직접 연결

요금제 보기

Helius 요금제 이해 및 업그레이드 옵션

대시보드

API 사용량 모니터링 및 키 관리

지원

Discord 커뮤니티

실시간 도움말 및 커뮤니티 지원을 위해 Discord에 참여하십시오

이메일 지원

지원 팀에 직접 연락하십시오

​설치

​빠른 시작 — 기존 사용자

​빠른 시작 — 신규 사용자

​요금제 및 가격

​특정 요금제로 가입

​기존 계정 업그레이드

​갱신 결제

​명령어 참조

전체 명령어 참조

​JSON 출력 모드

​종료 코드

​설정

​API 키 해결 순서

​전역 옵션

​전체 에이전트 워크플로우

​다음 단계

에이전트 개요

Helius MCP

요금제 보기

대시보드

​지원

Discord 커뮤니티

이메일 지원

설치

빠른 시작 — 기존 사용자

빠른 시작 — 신규 사용자

요금제 및 가격

특정 요금제로 가입

기존 계정 업그레이드

갱신 결제

명령어 참조

JSON 출력 모드

종료 코드

설정

API 키 해결 순서

전역 옵션

전체 에이전트 워크플로우

다음 단계

지원