Helius CLI

功能齐全的Helius命令行界面。95多个命令用于账户管理、区块链查询、交易发送、webhooks、流媒体、质押等。专为代理和自动化设计。

Helius CLI 是Helius平台的全功能命令行界面。它提供95多个命令用于账户管理、区块链数据查询、交易发送、webhooks、实时流媒体、质押、ZK压缩等，每个命令都有机器可读的JSON输出。

使用MCP兼容的AI工具？ Helius MCP服务器 是AI代理与Helius交互的推荐方式 —— 它提供60多个包含结构化输入/输出的工具，包括内置账户注册功能。当MCP不可用时，请将CLI用于shell脚本、CI/CD管道。

​

安装

npm install -g helius-cli

​

快速开始 — 已有用户

如果你已经有Helius API密钥，只需设置并开始：

helius config set-api-key YOUR_API_KEY

从dashboard.helius.dev获取你的密钥。就是这样 —— 跳过下面的注册步骤。

​

快速开始 — 新用户

1. 生成密钥对

   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
   
2. 为钱包充值

   将资金发送到上一步的钱包地址：

   资产	金额	用途
   SOL	~0.001	交易费用 + 租金
   USDC	1+	计划付款（见下文定价）

3. 创建账户

   helius signup
   

   这将检查余额、发送USDC付款，并创建你的Helius账户和项目。

4. 获取你的API密钥和端点

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

你的API密钥是敏感信息，授予对你Helius账户的访问权限。切勿在客户端代码、公共仓库或浏览器可访问区域中暴露它。

​

计划与定价

您可以直接通过 CLI 购买任何 Helius 共享计划。在注册时传递 --plan，或稍后使用 helius upgrade：

计划	价格	点数	--plan 值
Agent (基础)	$1 一次性	1,000,000	basic
Developer	每月 $49	10,000,000	developer
Business	每月 $499	100,000,000	business
Professional	每月 $999	200,000,000	professional

Agent 计划 (basic) 是默认选项。它花费 $1（以 USDC 支付）以防止滥用，并为您提供 1,000,000 点数。要获得更高的速率限制和更多点数，请注册付费计划或稍后升级。

​

使用特定计划注册

# Default: Agent plan ($1)
helius signup

# Developer plan ($49/mo)
helius signup --plan developer --email [e-mail] --first-name Jane --last-name Doe

# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email [e-mail] --first-name Jane --last-name Doe

​

升级现有账户

helius upgrade --plan developer --email [e-mail] --first-name Jane --last-name Doe

​

支付续订费用

当订阅续订到期（每月或每年）时，Helius 会创建一个 支付意图——带有唯一 ID、金额和过期的待定付款。您将通过电子邮件或仪表板收到支付意图 ID。

helius pay <payment-intent-id>

该命令获取意图详情，显示金额和过期时间，询问确认，然后从您的密钥对钱包发送 USDC 付款。

​

命令参考

CLI 提供了 95 个以上的命令，涵盖 14 个类别。每个命令都支持 --json 用于机器可读输出，以及 --api-key <key> / --network <net> 全局覆盖。

完整命令参考

所有 95 个以上的命令——账户管理、区块链查询、DAS API、钱包、webhooks、交易发送、WebSockets、staking、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 密钥按以下顺序解析：

1. --api-key <key> 标志（每命令覆盖）
2. HELIUS_API_KEY 环境变量
3. ~/.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: Fund wallet externally
# Send ~0.001 SOL + 1 USDC to the address

# Step 3: Create account
helius signup

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

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

# Step 6: 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 以获取实时帮助和社区支持

电子邮件支持

直接联系我们的支持团队