xibot/hoodieswap-skill

Hoodieswap-Fähigkeit

Nutzen Sie Hoodieswap als nicht-verwahrende Ausführungsvorbereitungsschicht auf der Robinhood Chain (Chain-ID 4663). Entdecken Sie Assets und Routen, zeigen Sie dem Benutzer die wesentlichen Konditionen und bereiten Sie unsigned Transaktionen für die verbundene Wallet vor. Fordern Sie niemals einen privaten Schlüssel an, speichern Sie ihn nicht und verwenden Sie ihn nie.

Wählen Sie den Workflow

• Für die Asset-Suche oder Markterkundung rufen Sie GET /tokens oder GET /stocks auf.
• Für eine Handelsvorschau rufen Sie POST /quote auf. Für Vorschau-Angebote ist eine Wallet optional.
• Für einen ERC-20-Input rufen Sie POST /approval auf, nachdem der Benutzer eine Route und Wallet ausgewählt hat.
• Um das finale unsigned Swap-Payload zu erhalten, rufen Sie POST /swap/prepare auf.
• Für einen Token-Launch rufen Sie POST /launch/preflight mit dryRun: true auf. Brechen Sie nach der Rückgabe der Simulation und der unsigned Airlock-Transaktion ab.
• Lesen Sie references/safety.md, bevor Sie eine Transaktion vorbereiten.
• Lesen Sie references/schemas.md für Anfrage- und Antwortfelder.
• Lesen Sie references/robinhood-chain.md für kanonische Netzwerkinformationen.
• Lesen Sie references/hoodwallet.md, wenn das signierende Konto ein OnChainHoodies ERC-6551 HoodWallet ist.

Wählen Sie das Signierprofil

• eoa: Bereiten Sie die Transaktion für eine konventionelle extern besessene Wallet vor.
• och-hoodwallet: Lösen Sie den Hoodie-Besitzer und das deterministische ERC-6551-Konto über OnChainHoodies auf, erstellen Sie ein Angebot mit der HoodWallet-Adresse als swapper und übergeben Sie den vorbereiteten Aufruf an die autorisierte Ausführungsmethode der HoodWallet.
• Behandeln Sie ein Token-gebundenes Konto niemals so, als hätte es einen eigenständigen privaten Schlüssel. Sein aktueller NFT-Besitzer oder ein anderer explizit autorisierter Kontrolleur muss den Aufruf genehmigen und ausführen.
• Die öffentliche API von OnChainHoodies bietet Identitäts-, Besitz- und Wallet-Kontext. Sie autorisiert oder signiert selbst keine HoodWallet-Transaktion.

Handels-Workflow

1. Lösen Sie die angeforderten Assets nach Symbol, Namen oder Vertragsadresse auf.
2. Bestätigen Sie, dass beide Assets auf der Robinhood Chain sind, und ermitteln Sie die Dezimalstellen. Behandeln Sie natives ETH als 0x0000000000000000000000000000000000000000.
3. Konvertieren Sie die menschliche Eingabe ohne Gleitkommaarithmetik in einen rohen Integer-Betrag.
4. Führen Sie node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...] aus oder rufen Sie /quote direkt auf.
5. Zeigen Sie den ausgewählten Anbieter, die Eingabe, die erwartete Ausgabe, den Preisaufschlag (falls vorhanden), die Pool-Beschränkung (falls vorhanden) sowie alle Warnhinweise an. Beschreiben Sie ein Angebot nicht als garantiert.
6. Fordern Sie den Benutzer auf, die Vorbereitung explizit zu genehmigen.
7. Wenn die Eingabe ERC-20 ist und das Angebot eine Genehmigung meldet, bereiten Sie die erforderliche(n) Genehmigungstransaktion(en) vor. Genehmigen Sie nicht stillschweigend unbegrenzte Ausgaben.
8. Führen Sie node scripts/prepare-swap.mjs --quote-file quote.json aus oder rufen Sie /swap/prepare mit dem ausgewählten Anbieterangebot auf.
9. Überprüfen Sie nochmals Chain-ID, Ziel, Wert, Calldata-Vorhandensein, Token-Paar und Betrag.
10. Geben Sie die unsigned Transaktion an den ausgewählten Signier-Adapter zur expliziten Überprüfung zurück. Wickeln Sie bei och-hoodwallet nur das exakt vorbereitete Ziel, den Wert und das Calldata in den HoodWallet-Ausführungsaufruf ein, nachdem Sie den aktuellen Hoodie-Besitz überprüft haben.
11. Senden Sie sie niemals vom Agenten aus, es sei denn, der Benutzer hat separat ein autorisiertes Wallet-Tool oder eine Richtlinie aktiviert und die genaue Aktion genehmigt.

Launch-Workflow

1. Sammeln Sie den erforderlichen Namen, Ticker, Beschreibung, öffentliche Bild-URL, Ersteller-E-Mail, Ersteller-Wallet und den Paar-Modus.
2. Wenn Sie mit einem Aktien-Token paaren, lösen Sie die Adresse von GET /stocks auf; akzeptieren Sie niemals eine willkürliche Aktien-Paar-Adresse.
3. Senden Sie das kanonische Preflight-Payload mit source: "launchpad", mode: "preflight" und dryRun: true.
4. Präsentieren Sie den vorhergesagten Token und Pool, das Gesamtangebot, die Gebühr, die vollständige Begünstigtenaufteilung, das Paar, Sicherheitseigenschaften, die Gas-Schätzung und das Transaktionsziel.
5. Stoppen Sie für die Benutzerüberprüfung. Das Preflight ist keine Autorisierung zum Starten.
6. Nur das Ersteller-Konto darf die zurückgegebene Airlock-Transaktion autorisieren und senden. Ein HoodWallet-Ersteller muss sie über den autorisierten ERC-6551-Kontopfad ausführen.

Determinismus und Fehlerbehandlung

• Verwenden Sie rohe Integer-Beträge in API-Aufrufen und bewahren Sie sie als Zeichenketten auf.
• Erfinden Sie keine Token-Dezimalstellen, Adressen, Pool-IDs, Angebote, Guthaben oder Routenverfügbarkeiten.
• Ein 404 von /quote bedeutet, dass keine ausführbare Route gefunden wurde; erfinden Sie keinen Rückfall.
• Ein mit NO ROUTE oder NOT CONFIGURED gekennzeichneter Anbieter ist für diese Anfrage nicht verfügbar.
• Erstellen Sie sofort vor der Transaktionsvorbereitung ein neues Angebot, wenn das vorherige Angebot veraltet ist oder sich der Betrag ändert.
• Behandeln Sie alle vorbereiteten Transaktionen als abgelaufen, wenn das Angebot oder die Frist abläuft.
• Zeigen Sie die Ablehnung durch den Benutzer als Abbruch an, nicht als Transaktionsfehler.

API und Client

• Produktions-Basis-URL: https://hoodieswap.xyz/api/v1
• OpenAPI: https://hoodieswap.xyz/api/v1/openapi.json
• Repository-Spezifikation: openapi/hoodieswap-v1.yaml
• TypeScript-Client: src/client.ts
• Fähigkeitserkennung: GET /capabilities

Hoodieswap bereitet Routen und Transaktionen vor. Die Wallet bleibt die Signiergrenze und Hoodieswap übernimmt niemals die Verwahrung.