Super-fast CLI agent for Cronos x402 Paytech - Powered by Crypto.com Developer Platform SDK for AI-powered on-chain payments
npm install spiro-cronosCronos x402 Paytech 超快速 CLI 代理 - AI 驱动的链上支付
一个由 Crypto.com Developer Platform SDK 驱动的超快速命令行界面，支持与 Cronos EVM 进行自然语言交互，用于支付、代币转账和 DeFi 操作。包含 x402 无 Gas 支付和智能区块链交互。
🌍 语言 / Languages / Idiomas: 中文 | English | Español
``bash全局安装
npm install -g spiro-cronos
本地开发：
bash
克隆并安装依赖
git clone
cd spiro-cronos
npm install链接以进行本地测试
npm link
现在 'spiro' 命令全局可用
或直接运行
npm start -- --help
`🎯 特性
- 自然语言命令：使用自然语言与 Cronos 交互
- x402 支付：通过 x402 协议进行无 Gas 稳定币支付
- ✨ 由 Crypto.com Developer Platform SDK 提供支持：具有生产就绪 AI 功能的智能区块链交互
- Crypto.com AI Agent 集成：与 Cronos EVM 生态系统的无缝集成
- EmbedAPI 备用：AI 功能的可选备用方案
- 快速且轻量：针对速度和最小依赖进行了优化
📦 安装
$3
bash
npm install -g spiro-cronos
spiro --help
`$3
bash
npm install spiro-cronos
npx spiro --help
`$3
bash
克隆仓库
git clone
cd spiro-cronos安装依赖
npm install链接以进行本地开发
npm link
现在 'spiro' 命令全局可用
或直接运行
node bin/spiro.js --help
`🚀 使用
$3
bash
查看钱包余额（包括 USDC.e 代币余额）
spiro balance [address] # 查看余额
spiro tx # 查询交易
spiro wallet # 显示钱包信息
spiro network # 显示网络信息
spiro config # 显示配置
`$3
bash
创建 x402 支付授权
spiro pay --amount 10 --token USDC --to 验证 x402 支付头
spiro verify --header 在链上结算 x402 支付
spiro settle --header
`$3
bash
运行设置向导以配置 API 密钥和钱包
spiro setup生成新钱包
spiro generate-wallet设置 CLI 语言（en, es, zh）
spiro language zh
或
spiro lang en启动交互模式
spiro interactive
`$3
bash
使用自然语言提问
spiro "我的余额是多少？"
spiro "向 0x... 支付 10 USDC"
`$3
启动交互模式以进行持续对话：
bash
spiro interactive
或
spiro i
`然后自然地输入命令：
spiro> balance
spiro> 我的余额是多少？
spiro> network
spiro> help
spiro> exit
交互模式会保持活动状态，直到您输入
或 quit。🛠️ 配置
$3
运行设置向导：
`bash
spiro setup
`这将引导您完成：
- 设置 Crypto.com API 密钥（推荐 - 为 AI 功能提供支持）
- 在 https://developer.crypto.com/auth 注册
- 创建项目（选择 CRONOS EVM TESTNET）
- 从仪表板获取您的 API 密钥
- 设置 EmbedAPI 密钥（可选备用）
- 选择网络（测试网/主网）
- 生成或输入钱包地址（最后显示用于水龙头）
- 可选保存私钥以用于支付功能
设置后，将显示您的钱包地址 - 使用它从水龙头获取测试网代币！
$3
Spiro-Cronos 由 Crypto.com 的 AI Agent SDK 提供支持，提供：
- 🤖 自然语言区块链交互
- 💬 智能查询理解
- 🔗 与 Cronos EVM 的无缝集成
- 🚀 生产就绪的 AI 功能
获取您的 API 密钥：https://developer.crypto.com/auth
$3
或者，在您的主目录中创建一个
文件：`json
{
"apiKey": "您的-crypto-com-api-密钥",
"network": "testnet",
"defaultWallet": "0x您的地址",
"embedApiKey": "您的-embedapi-密钥-可选",
"privateKey": "0x您的私钥"
}
`或设置环境变量：
bash
export SPIRO_API_KEY=您的-crypto-com-api-密钥
export SPIRO_NETWORK=testnet
export SPIRO_EMBED_API_KEY=您的-embedapi-密钥-可选
export SPIRO_PRIVATE_KEY=0x您的私钥
export SPIRO_DEFAULT_WALLET=0x您的地址
export SPIRO_LANGUAGE=zh # 可选：en（默认）、es 或 zh
`语言设置：CLI 会自动检测您的系统语言。您也可以手动设置：
bash
spiro language zh # 设置为中文
spiro language es # 设置为西班牙语
spiro language en # 设置为英语
spiro language # 显示当前语言
`支持的语言：英语 (en)、西班牙语 (es)、中文 (zh)
安全提示：永远不要将私钥提交到版本控制。使用环境变量或具有适当权限的
文件（chmod 600 ~/.spirorc）。$3
1. 注册：访问 https://developer.crypto.com/auth
2. 创建项目：
- 点击 "New Project"
- 名称："Spiro Cronos"（或您的选择）
- 选择 CRONOS EVM TESTNET 作为链
- 点击 "Create Project"
3. 获取 API 密钥：从项目仪表板复制您的 API 密钥
4. 配置：运行
spiro setup 并粘贴您的 API 密钥为什么选择 Crypto.com AI Agent SDK？
- 🎯 专为 Cronos 区块链构建
- 🤖 面向 Web3 的高级 AI 功能
- 🔒 安全且生产就绪
- 🚀 与 Cronos EVM 的无缝集成
📚 示例
$3
`bash
1. 查看余额
spiro balance 0x您的地址2. 创建支付授权（生成 Base64 支付头）
spiro pay --amount 100 --token USDC --to 0x卖方地址 --private-key 0x您的私钥3. 验证支付头（结算前）
spiro verify --header 4. 在链上结算支付（执行交易）
spiro settle --header
`注意：x402 支付使用 EIP-3009
进行无 Gas 代币转账。Facilitator 代表您支付 Gas 费用。$3
`bash
交换代币
spiro "将 50 CRO 交换为 USDC"查看流动性池
spiro "显示 VVS 池"质押代币
spiro "在 VVS 中质押 100 CRO"
`🏗️ 架构
- Crypto.com AI Agent SDK（主要）：✨ 由 Crypto.com 的尖端 AI Agent SDK 提供支持，用于智能区块链交互
- Crypto.com Developer Platform Client：与 Cronos EVM 和生态系统服务的无缝集成
- x402 Facilitator API：使用 EIP-3009 进行无 Gas 支付结算
- EmbedAPI（可选备用）：用于自然语言查询的替代 AI 提供商
- Ethers.js：区块链交互和 EIP-712 签名
- Commander.js：CLI 框架
- Chalk & Ora：带有旋转器的美观终端输出
🔧 技术细节
$3
1. 授权：用户签署 EIP-712 类型数据，授权代币转账
2. 支付头：包含签名和支付详情的 Base64 编码 JSON
3. 验证：Facilitator 验证支付头而不执行交易
4. 结算：Facilitator 在链上执行
，支付 Gas 费用$3
- 测试网：
cronos-testnet（链 ID：338）
- 主网：cronos-mainnet（链 ID：25）$3
- USDC.e（通过 Stargate 桥接的 USDC）- 6 位小数
- 测试网：
0xc01efAaF7C5C61bEbFAeb358E1161b537b8bC0e0
- 主网：- Node.js 20+
- Cronos EVM 钱包（用于交易）
- Crypto.com Developer Platform 的 API 密钥
- NPM 包：https://www.npmjs.com/package/spiro-cronos
- Crypto.com AI Agent SDK 文档
- Crypto.com Developer Platform
- x402 Facilitator 文档
- Cronos EVM 文档
- Cronos 测试网水龙头
- EmbedAPI（可选备用）
MIT
此项目为 Cronos x402 Paytech Hackathon 构建，结合了 AI 代理、x402 支付和开发工具。Spiro-Cronos 使开发人员能够使用自然语言与 Cronos EVM 交互，由 Crypto.com 的 AI Agent SDK 提供支持。