mcpField
O
oro-gold

oro-gold

github.com/behfar-devその他070 回インストール35 週間前に更新
リポジトリ

oro-gold について

oro-goldは、ORO GRAILのゴールド基盤を利用するエージェント構築向けのリファレンススキルです。インテグレーターや自動化開発者に、認証、取引API、ユーザー・残高の取得、売買のワークフローを示します。

主な機能

  1. 01ウォレット署名による認証とAPIキー取得の説明
  2. 02金価格と売買見積もりの取得
  3. 03ユーザーまたはパートナー向けの金売買
  4. 04ユーザー作成と詳細・残高の取得
  5. 05価格、残高、DCAの参考スクリプト

活用シーン

  1. 01金価格を監視してアラートを送信
  2. 02スケジュールに沿った金の自動購入
  3. 03ユーザーやエージェントの金保有量の追跡
  4. 04パートナーのトレジャリー経由でエージェントに報酬を付与

インストール

コマンドをコピーしてターミナルで実行します。

$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 のゴールドインフラストラクチャと連携するエージェントを構築するためのクイックリファレンスです。

ベース 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 - ドルコスト平均法エージェント

主な概念

  • カストディアル：ユーザーの金を保有し、ユーザーはブロックチェーンを意識しません
  • セルフカストディ：ユーザー自身のウォレットで GRAIL トークンを保有します
  • パートナー：連携用アカウント（ホワイトリストの承認が必要です）
  • PDA：Program Derived Address。オンチェーンで金が保管される場所です

エージェントのユースケース

  1. 価格エージェント - 金価格の変動を取得して通知
  2. DCA エージェント - スケジュールに従って金を自動購入
  3. 残高エージェント - エージェント／ユーザーの金保有量を追跡
  4. チップジャー - エージェント間の金による報酬（財務口座経由）

コメント

Markdown 対応