Hoodieswap スキル
HoodieswapをRobinhood Chain（チェーンID 4663）上の非カストディアルな実行準備レイヤーとして使用します。アセットとルートを発見し、ユーザーに取引条件を提示した上で、接続されたウォレット用の未署名トランザクションを準備します。秘密鍵を要求、保存、または使用することは決してありません。
ワークフローの選択
- アセットの検索や市場の発見には、
GET /tokensまたはGET /stocksを呼び出します。 - 取引のプレビューには、
POST /quoteを呼び出します。プレビュー用の見積もりではウォレットはオプションです。 - ERC-20入力の場合、ユーザーがルートとウォレットを選択した後に
POST /approvalを呼び出します。 - 最終的な未署名スワップペイロードを取得するには、
POST /swap/prepareを呼び出します。 - トークンローンチの場合、
dryRun: trueを指定してPOST /launch/preflightを呼び出します。シミュレーションと未署名のAirlockトランザクションを返したらそこで停止します。 - トランザクションを準備する前に、references/safety.md を読んでください。
- リクエストフィールドとレスポンスフィールドについては、references/schemas.md を読んでください。
- 正規のネットワーク値については、references/robinhood-chain.md を読んでください。
- 署名アカウントがOnChainHoodies ERC-6551 HoodWalletである場合、references/hoodwallet.md を読んでください。
署名者プロファイルの選択
eoa: 従来の外部所有ウォレット用にトランザクションを準備します。och-hoodwallet: OnChainHoodiesを通じてHoodieの所有者と決定論的なERC-6551アカウントを解決し、HoodWalletアドレスをswapperとして見積もりを取得し、準備された呼び出しをHoodWalletの承認された実行メソッドに渡します。- トークンバウンドアカウントを、独立した秘密鍵を持つものとして扱わないでください。現在のNFT所有者または明示的に承認された別のコントローラが、その呼び出しを承認し実行する必要があります。
- OnChainHoodiesの公開APIは、アイデンティティ、所有権、ウォレットコンテキストを提供します。それ自体がHoodWalletトランザクションを承認したり署名したりすることはありません。
スワップワークフロー
- シンボル、名前、またはコントラクトアドレスによって要求されたアセットを解決します。
- 両方のアセットがRobinhood Chain上にあることを確認し、デシマルを特定します。ネイティブETHは
0x0000000000000000000000000000000000000000として扱います。 - 人間の入力を浮動小数点演算なしで生の整数額に変換します。
node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...]を実行するか、直接/quoteを呼び出します。- 選択されたプロバイダー、入力、期待される出力、存在する場合は価格影響、存在する場合はプール制約、およびすべての警告を表示します。見積もりを保証されたものとして説明しないでください。
- ユーザーが明示的に準備を承認するよう要求します。
- 入力がERC-20で、見積もりが承認を報告している場合、必要な承認トランザクションを準備します。無制限の使用を黙って承認しないでください。
node scripts/prepare-swap.mjs --quote-file quote.jsonを実行するか、選択したプロバイダーの見積もりを指定して/swap/prepareを呼び出します。- チェーンID、ターゲット、値、calldataの存在、トークンペア、および金額を再度確認します。
- 未署名のトランザクションを選択した署名者アダプターに返し、明示的なレビューを求めます。
och-hoodwalletの場合、現在のHoodie所有権を確認した後、準備された正確なターゲット、値、およびcalldataのみをHoodWallet実行呼び出しにラップします。 - ユーザーが別途承認されたウォレットツールやポリシーを有効にし、正確なアクションを承認しない限り、エージェントからブロードキャストしないでください。
ローンチワークフロー
- 必要な名前、ティッカー、説明、公開画像URL、作成者メール、作成者ウォレット、ペアモードを収集します。
- 株式トークンとペアリングする場合、
GET /stocksからアドレスを解決します。任意の株式ペアアドレスを受け入れないでください。 source: "launchpad"、mode: "preflight"、dryRun: trueを指定して、正規のプリフライトペイロードを送信します。- 予測されたトークンとプール、総供給量、手数料、完全な受益者の配分、ペア、安全性プロパティ、ガス推定、およびトランザクションターゲットを提示します。
- ユーザーレビューのために停止します。プリフライトはローンチの承認ではありません。
- 作成者アカウントのみが、返されたAirlockトランザクションを承認し送信できます。HoodWallet作成者は、承認されたERC-6551アカウントパスを通じてそれを実行する必要があります。
決定性とエラーハンドリング
- API呼び出しでは生の整数額を使用し、文字列として保持します。
- トークンのデシマル、アドレス、プールID、見積もり、残高、またはルートの可用性をでっち上げないでください。
/quoteからの404は、実行可能なルートが見つからなかったことを意味します。フォールバックをでっち上げないでください。NO ROUTEまたはNOT CONFIGUREDとマークされたプロバイダーは、そのリクエストでは利用できません。- 以前の見積もりが古くなったり、金額が変更された場合は、トランザクション準備の直前に再見積もりを行ってください。
- すべての準備済みトランザクションは、その見積もりまたは期限が切れたときに期限切れとして扱います。
- ユーザーの拒否は、トランザクションの失敗ではなく、キャンセルとして表面化します。
APIとクライアント
- プロダクションのベースURL:
https://hoodieswap.xyz/api/v1 - OpenAPI:
https://hoodieswap.xyz/api/v1/openapi.json - リポジトリ仕様: openapi/hoodieswap-v1.yaml
- TypeScriptクライアント: src/client.ts
- 機能発見:
GET /capabilities
Hoodieswapはルートとトランザクションを準備します。ウォレットは署名の境界であり、Hoodieswapがカストディを取ることは決してありません。