xibot/hoodieswap-skill

Hoodieswap Skill

Utilisez Hoodieswap comme une couche de préparation d'exécution non-custodiale sur la Robinhood Chain (ID de chaîne 4663). Découvrez des actifs et des routes, montrez à l'utilisateur les conditions matérielles, puis préparez des transactions non signées pour le portefeuille connecté. Ne demandez, ne stockez et n'utilisez jamais de clé privée.

Choisissez le workflow

• Pour la consultation d'actifs ou la découverte du marché, appelez GET /tokens ou GET /stocks.
• Pour un aperçu de transaction, appelez POST /quote. Un portefeuille est optionnel pour les devis d'aperçu.
• Pour une entrée ERC-20, appelez POST /approval après que l'utilisateur a sélectionné une route et un portefeuille.
• Pour obtenir la charge utile finale de swap non signée, appelez POST /swap/prepare.
• Pour un lancement de token, appelez POST /launch/preflight avec dryRun: true. Arrêtez-vous après avoir renvoyé la simulation et la transaction Airlock non signée.
• Lisez references/safety.md avant de préparer toute transaction.
• Lisez references/schemas.md pour les champs de requête et de réponse.
• Lisez references/robinhood-chain.md pour les valeurs réseau canoniques.
• Lisez references/hoodwallet.md lorsque le compte signataire est un HoodWallet OnChainHoodies ERC-6551.

Choisissez le profil de signataire

• eoa : préparez la transaction pour un portefeuille externe classique.
• och-hoodwallet : résolvez le propriétaire du Hoodie et le compte ERC-6551 déterministe via OnChainHoodies, faites un devis avec l'adresse HoodWallet comme swapper, puis passez l'appel préparé à la méthode d'exécution autorisée du HoodWallet.
• Ne traitez jamais un compte lié à un token comme ayant une clé privée autonome. Son propriétaire actuel du NFT ou un autre contrôleur explicitement autorisé doit approuver et exécuter l'appel.
• L'API publique OnChainHoodies fournit le contexte d'identité, de propriété et de portefeuille. Elle n'autorise ni ne signe elle-même une transaction HoodWallet.

Workflow de trading

1. Résolvez les actifs demandés par symbole, nom ou adresse de contrat.
2. Confirmez que les deux actifs sont sur la Robinhood Chain et identifiez leurs décimales. Traitez l'ETH natif comme 0x0000000000000000000000000000000000000000.
3. Convertissez l'entrée humaine en un montant entier brut sans utiliser d'arithmétique à virgule flottante.
4. Exécutez node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...] ou appelez /quote directement.
5. Affichez le fournisseur sélectionné, l'entrée, la sortie attendue, l'impact sur le prix s'il est présent, la contrainte de pool si présente, et tout avertissement. Ne décrivez pas un devis comme garanti.
6. Exigez que l'utilisateur approuve explicitement la préparation.
7. Si l'entrée est un ERC-20 et que le devis signale une approbation, préparez la ou les transactions d'approbation nécessaires. N'approuvez pas silencieusement des dépenses illimitées.
8. Exécutez node scripts/prepare-swap.mjs --quote-file quote.json ou appelez /swap/prepare avec le devis du fournisseur sélectionné.
9. Vérifiez à nouveau l'ID de chaîne, la cible, la valeur, la présence de calldata, la paire de tokens et le montant.
10. Renvoyez la transaction non signée à l'adaptateur de signataire sélectionné pour une revue explicite. Pour och-hoodwallet, encapsulez uniquement la cible, la valeur et le calldata préparés exacts dans l'appel d'exécution du HoodWallet après avoir vérifié la propriété actuelle du Hoodie.
11. Ne la diffusez jamais depuis l'agent à moins que l'utilisateur n'ait activé séparément un outil ou une politique de portefeuille autorisé et approuvé l'action exacte.

Workflow de lancement

1. Collectez le nom, le ticker, la description, l'URL de l'image publique, l'email du créateur, le portefeuille du créateur et le mode de paire requis.
2. Si vous associez avec un token d'action, résolvez l'adresse depuis GET /stocks ; n'acceptez jamais une adresse de paire d'actions arbitraire.
3. Soumettez la charge utile canonique de prévol avec source: "launchpad", mode: "preflight" et dryRun: true.
4. Présentez le token et le pool prédits, l'offre totale, les frais, la répartition complète des bénéficiaires, la paire, les propriétés de sécurité, l'estimation de gaz et la cible de la transaction.
5. Arrêtez-vous pour la revue de l'utilisateur. Le prévol n'est pas une autorisation de lancement.
6. Seul le compte créateur peut autoriser et envoyer la transaction Airlock renvoyée. Un créateur HoodWallet doit l'exécuter via le chemin de compte ERC-6551 autorisé.

Déterminisme et gestion des erreurs

• Utilisez des montants entiers bruts dans les appels API et conservez-les sous forme de chaînes.
• N'inventez pas de décimales de tokens, d'adresses, d'ID de pool, de devis, de soldes ou de disponibilité de routes.
• Un 404 de /quote signifie qu'aucune route exécutable n'a été trouvée ; ne fabriquez pas de solution de repli.
• Un fournisseur marqué NO ROUTE ou NOT CONFIGURED est indisponible pour cette requête.
• Refaites un devis immédiatement avant la préparation de la transaction si le devis précédent est périmé ou si le montant change.
• Traitez toutes les transactions préparées comme expirées lorsque leur devis ou leur échéance expire.
• Signalez le rejet par l'utilisateur comme une annulation, pas comme un échec de transaction.

API et client

• URL de base de production : https://hoodieswap.xyz/api/v1
• OpenAPI : https://hoodieswap.xyz/api/v1/openapi.json
• Spécification du dépôt : openapi/hoodieswap-v1.yaml
• Client TypeScript : src/client.ts
• Découverte des capacités : GET /capabilities

Hoodieswap prépare les routes et les transactions. Le portefeuille reste la frontière de signature et Hoodieswap ne prend jamais la garde.