Helius CLI 使 AI 代理能够自主创建 Helius 账户并获取 API 密钥，无需人工干预。通过 Helius MCP 服务器，AI 工具可以指导代理完成整个注册流程。
| 功能 | 描述 |
|---|
| 生成密钥对 | 通过 helius keygen 编程生成 Solana 钱包 |
| 自助注册 | 通过 helius signup 支付 1 USDC 创建 Helius 账户 |
| 管理项目 | 通过 helius projects 列出并查看项目详情 |
| 访问 API 密钥 | 通过 helius apikeys 检索和创建 API 密钥 |
| 监控使用情况 | 通过 helius usage 检查信用消耗 |
| 获取 RPC 端点 | 通过 helius rpc 显示 mainnet 和 devnet URLs |
| JSON 输出模式 | 使用 --json 标志获得机器可读输出 |
代理的关键信息
命令参考
| 命令 | 描述 |
|---|
helius keygen | 生成新的 Solana 密钥对 |
helius signup | 支付 1 USDC + 创建账户 + 项目 |
helius login | 使用现有钱包进行身份验证 |
helius projects | 列出所有项目 |
helius project [id] | 获取项目详情 |
helius apikeys [project-id] | 列出项目的 API 密钥 |
helius apikeys create [project-id] | 创建新的 API 密钥 |
helius usage [project-id] | 显示信用使用情况 |
helius rpc [project-id] | 显示 RPC 端点 |
退出代码
| 代码 | 含义 | 代理操作 |
|---|
| 0 | 成功 | 继续下一步 |
| 1 | 通用错误 | 记录错误并通知用户 |
| 10 | 未登录 | 运行 helius login |
| 11 | 未找到密钥对 | 运行 helius keygen |
| 20 | SOL 不足 | 请求 0.001 SOL 到钱包 |
| 21 | USDC 不足 | 请求 1 USDC 到钱包 |
| 30 | 未找到项目 | 项目列表为空 |
| 31 | 未找到项目 | 项目 ID 无效 |
| 40 | API 错误 | 重试加倍等待 |
完整代理流程
# 1. Generate keypair
helius keygen
# Save the wallet address from the output
# 2. Wait for user to fund wallet (1 USDC + ~0.001 SOL)
# 3. Signup and create account
helius signup --json
# 4. Get projects and API keys
helius projects --json
helius apikeys <project-id> --json
# 5. Get RPC endpoints
helius rpc <project-id> --json
在以编程方式调用命令时始终使用 --json 标志。解析 JSON 响应以可靠地提取数据。
密钥对管理
CLI 存储文件在 ~/.helius-cli/：
~/.helius-cli/
├── config.json # JWT authentication token
└── keypair.json # Solana keypair (if generated)
-k 覆盖默认密钥对路径：
helius login -k /path/to/custom/keypair.json
helius signup -k /path/to/custom/keypair.json
示例代理提示
使用这些提示与连接到 Helius MCP 服务器的 AI 工具：
- “帮助我使用 CLI 设置新的 Helius 账户”
- “获取我的代理 API 密钥需要哪些命令？”
- “展示自主 Helius 注册的完整流程”
- “如何使用 Helius CLI 查看我的剩余积分？”
- “使用 helius signup 时应处理哪些退出代码？”
相关页面
