xibot/hoodieswap-skill

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 交易。

交易工作流程

1. 依符號、名稱或合約地址解析請求的資產。
2. 確認兩個資產都在 Robinhood Chain 上，並辨識小數位數。將原生 ETH 視為 0x0000000000000000000000000000000000000000。
3. 將人類輸入轉換為原始整數數量，不使用浮點數算術。
4. 執行 node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...] 或直接呼叫 /quote。
5. 顯示所選提供者、輸入、預期輸出、價格影響（如有）、池限制（如有）以及任何警告。請勿將報價描述為保證。
6. 要求使用者明確核准準備動作。
7. 如果輸入為 ERC-20 且報價回報需要授權，準備必要的授權交易。請勿靜默授權無限額度。
8. 執行 node scripts/prepare-swap.mjs --quote-file quote.json 或以所選提供者報價呼叫 /swap/prepare。
9. 再次驗證鏈 ID、目標、數值、呼叫資料是否存在、代幣配對與數量。
10. 將未簽署的交易回傳給所選的簽署者適配器以供明確檢視。對於 och-hoodwallet，在驗證當前 Hoodie 所有權後，僅將準備好的目標、數值與呼叫資料包裹在 HoodWallet 執行呼叫中。
11. 除非使用者已單獨啟用授權的錢包工具或政策並核准確切動作，否則絕不從代理廣播交易。

發行工作流程

1. 收集所需的名稱、代號、描述、公開圖片 URL、創作者電子郵件、創作者錢包與配對模式。
2. 若與股票代幣配對，從 GET /stocks 解析地址；絕不接受任意股票配對地址。
3. 提交標準的預檢承載，其中 source: "launchpad"、mode: "preflight" 且 dryRun: true。
4. 呈現預測的代幣與池、總供應量、費用、完整受益分配、配對、安全屬性、Gas 估算與交易目標。
5. 停止以讓使用者檢視。預檢並非授權發行。
6. 只有創作者帳戶可以授權並發送回傳的 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 絕不取得託管權。