mcpField
O
oro-gold

oro-gold

github.com/behfar-dev其他070 次安装35 周前更新
代码仓库

关于 oro-gold

oro-gold 是帮助构建接入 ORO GRAIL 黄金基础设施的 Agent 的参考技能，面向集成方和自动化流程开发者。它整理认证步骤、交易 API、用户与余额接口，以及买卖黄金的常见 Agent 场景。

主要功能

  1. 01说明钱包签名认证与 API 密钥获取
  2. 02查询黄金价格及买卖估算
  3. 03执行用户或合作方黄金买卖
  4. 04创建用户并查询详情与余额
  5. 05提供价格、余额、定投等参考脚本

适用场景

  1. 01监控黄金价格并发送提醒
  2. 02按计划自动购买黄金
  3. 03跟踪用户或 Agent 的黄金持有量
  4. 04通过合作方金库发放 Agent 奖励

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/behfar-dev/oro-agent-skill --skill oro-gold

安装后在 Claude Code 中输入/oro-gold确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
README.md
LICENSE
.vscode/
settings.json
tasks.json
references/
dca-agent.md
balance-checker.md
price-checker.md
buy-gold.md
sell-gold.md
references/public/fonts/
README.md
scripts/
oro_dca.py
__init__.py
oro_gold.py

详细介绍

ORO Gold Agent Skill

构建与 ORO GRAIL 黄金基础设施交互的 Agent 快速参考。

Base URL

https://oro-tradebook-devnet.up.railway.app/api

身份验证

  1. 请求质询 → 2. 使用钱包签名 → 3. 获取 API 密钥
// Step 1: Request challenge
POST /auth/challenge
{ "walletAddress": "...", "keyType": "PARTNER", "partnerId": "1" }

// Step 2: Sign message with Ed25519 (nacl.sign.detached)
// Step 3: Exchange for API key
POST /auth/api-key
{ "challengeId": "...", "signature": "...", "keyName": "..." }

在请求头中传入 API 密钥：x-api-key: your-key

核心端点

端点方法用途
/trading/gold-priceGET获取当前黄金价格（Pyth 预言机）
/trading/estimate/buyPOST计算购买指定数量黄金所需的 USDC
/trading/estimate/sellPOST计算出售黄金可获得的 USDC
/trading/purchases/userPOST为用户购买黄金
/trading/purchases/partnerPOST将黄金买入合作伙伴金库
/trading/sales/userPOST出售用户的黄金
/trading/sales/partnerPOST出售合作伙伴的黄金储备
/usersPOST创建用户（已完成 KYC）
/users/{id}GET获取用户详情和余额
/distribution/partner/meGET获取合作伙伴详情

快速脚本

详细用法请参阅 references/：

  • references/price-checker.md - 获取黄金价格
  • references/balance-checker.md - 检查用户黄金余额
  • references/buy-gold.md - 购买黄金流程
  • references/sell-gold.md - 出售黄金流程
  • references/dca-agent.md - 定期定额投资 Agent

核心概念

  • 托管式：你持有用户的黄金，用户无需查看区块链
  • 自托管：用户在自己的钱包中持有 GRAIL 代币
  • 合作伙伴：你的集成账户（需通过白名单审批）
  • PDA：程序派生地址（Program Derived Address），即黄金在链上的存储位置

Agent 用例

  1. 价格 Agent - 获取黄金价格，并在价格波动时发出提醒
  2. 定期定额投资 Agent - 按计划自动购买黄金
  3. 余额 Agent - 跟踪 Agent/用户持有的黄金
  4. 打赏罐 - Agent 间黄金奖励（通过金库）

评论

支持 Markdown