🚀 Spiro-Cronos

Cronos x402 Paytech 超快速 CLI 代理 - AI 驱动的链上支付

一个由 Crypto.com Developer Platform SDK 驱动的超快速命令行界面，支持与 Cronos EVM 进行自然语言交互，用于支付、代币转账和 DeFi 操作。包含 x402 无 Gas 支付和智能区块链交互。

🌍 语言 / Languages / Idiomas: 中文 | English | Español

⚡ 快速开始

# 全局安装
npm install -g spiro-cronos

# 运行设置向导以配置 API 密钥并生成钱包
spiro setup

# 检查要求
spiro check
# 或：npm run check（如果本地安装）

# 开始使用
spiro --help
spiro network

本地开发：

# 克隆并安装依赖
git clone <repo-url>
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 功能的可选备用方案
• 快速且轻量：针对速度和最小依赖进行了优化

📦 安装

全局安装（推荐）

npm install -g spiro-cronos
spiro --help

本地安装

npm install spiro-cronos
npx spiro --help

开发设置

# 克隆仓库
git clone <repo-url>
cd spiro-cronos

# 安装依赖
npm install

# 链接以进行本地开发
npm link
# 现在 'spiro' 命令全局可用

# 或直接运行
node bin/spiro.js --help

🚀 使用

基本命令

# 查看钱包余额（包括 USDC.e 代币余额）
spiro balance [address]        # 查看余额
spiro tx <hash>                 # 查询交易
spiro wallet                    # 显示钱包信息
spiro network                   # 显示网络信息
spiro config                    # 显示配置

x402 支付命令

# 创建 x402 支付授权
spiro pay --amount 10 --token USDC --to <address>

# 验证 x402 支付头
spiro verify --header <base64>

# 在链上结算 x402 支付
spiro settle --header <base64>

设置和实用工具

# 运行设置向导以配置 API 密钥和钱包
spiro setup

# 生成新钱包
spiro generate-wallet

# 设置 CLI 语言（en, es, zh）
spiro language zh
# 或
spiro lang en

# 启动交互模式
spiro interactive

自然语言查询

# 使用自然语言提问
spiro "我的余额是多少？"
spiro "向 0x... 支付 10 USDC"

交互模式

启动交互模式以进行持续对话：

spiro interactive
# 或
spiro i

然后自然地输入命令：

spiro> balance
spiro> 我的余额是多少？
spiro> network
spiro> help
spiro> exit

交互模式会保持活动状态，直到您输入 exit 或 quit。

🛠️ 配置

快速设置（推荐）

运行设置向导：

spiro setup

这将引导您完成：

• 设置 Crypto.com API 密钥（推荐 - 为 AI 功能提供支持）
  • 在 https://developer.crypto.com/auth 注册
  • 创建项目（选择 CRONOS EVM TESTNET）
  • 从仪表板获取您的 API 密钥
• 设置 EmbedAPI 密钥（可选备用）
• 选择网络（测试网/主网）
• 生成或输入钱包地址（最后显示用于水龙头）
• 可选保存私钥以用于支付功能

设置后，将显示您的钱包地址 - 使用它从水龙头获取测试网代币！

✨ Crypto.com AI Agent SDK

Spiro-Cronos 由 Crypto.com 的 AI Agent SDK 提供支持，提供：

• 🤖 自然语言区块链交互
• 💬 智能查询理解
• 🔗 与 Cronos EVM 的无缝集成
• 🚀 生产就绪的 AI 功能

获取您的 API 密钥：https://developer.crypto.com/auth

手动配置

或者，在您的主目录中创建一个 .spirorc 文件：

{
  "apiKey": "您的-crypto-com-api-密钥",
  "network": "testnet",
  "defaultWallet": "0x您的地址",
  "embedApiKey": "您的-embedapi-密钥-可选",
  "privateKey": "0x您的私钥"
}

或设置环境变量：

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 会自动检测您的系统语言。您也可以手动设置：

spiro language zh  # 设置为中文
spiro language es  # 设置为西班牙语
spiro language en  # 设置为英语
spiro language     # 显示当前语言

支持的语言：英语 (en)、西班牙语 (es)、中文 (zh)

安全提示：永远不要将私钥提交到版本控制。使用环境变量或具有适当权限的 .spirorc 文件（chmod 600 ~/.spirorc）。

✨ 获取您的 Crypto.com API 密钥

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 的无缝集成

📚 示例

x402 支付流程

# 1. 查看余额
spiro balance 0x您的地址

# 2. 创建支付授权（生成 Base64 支付头）
spiro pay --amount 100 --token USDC --to 0x卖方地址 --private-key 0x您的私钥

# 3. 验证支付头（结算前）
spiro verify --header <base64-支付头>

# 4. 在链上结算支付（执行交易）
spiro settle --header <base64-支付头>

注意：x402 支付使用 EIP-3009 transferWithAuthorization 进行无 Gas 代币转账。Facilitator 代表您支付 Gas 费用。

DeFi 操作

# 交换代币
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：带有旋转器的美观终端输出

🔧 技术细节

x402 支付流程

1. 授权：用户签署 EIP-712 类型数据，授权代币转账
2. 支付头：包含签名和支付详情的 Base64 编码 JSON
3. 验证：Facilitator 验证支付头而不执行交易
4. 结算：Facilitator 在链上执行 transferWithAuthorization，支付 Gas 费用

支持的网络

• 测试网：cronos-testnet（链 ID：338）
• 主网：cronos-mainnet（链 ID：25）

支持的代币

• USDC.e（通过 Stargate 桥接的 USDC）- 6 位小数
  • 测试网：0xc01efAaF7C5C61bEbFAeb358E1161b537b8bC0e0
  • 主网：0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C

📝 要求

• 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 构建

此项目为 Cronos x402 Paytech Hackathon 构建，结合了 AI 代理、x402 支付和开发工具。Spiro-Cronos 使开发人员能够使用自然语言与 Cronos EVM 交互，由 Crypto.com 的 AI Agent SDK 提供支持。