xibot/hoodieswap-skill

Skill Hoodieswap

Use o Hoodieswap como uma camada de preparação de execução não custodial na Robinhood Chain (chain ID 4663). Descubra ativos e rotas, mostre ao usuário os termos materiais e, em seguida, prepare transações não assinadas para a carteira conectada. Nunca solicite, armazene ou use uma chave privada.

Escolha o fluxo de trabalho

• Para consulta de ativos ou descoberta de mercado, chame GET /tokens ou GET /stocks.
• Para uma prévia de negociação, chame POST /quote. Uma carteira é opcional para cotações de prévia.
• Para uma entrada ERC-20, chame POST /approval após o usuário selecionar uma rota e carteira.
• Para obter o payload final de swap não assinado, chame POST /swap/prepare.
• Para um lançamento de token, chame POST /launch/preflight com dryRun: true. Pare após retornar a simulação e a transação Airlock não assinada.
• Leia references/safety.md antes de preparar qualquer transação.
• Leia references/schemas.md para campos de requisição e resposta.
• Leia references/robinhood-chain.md para valores de rede canônicos.
• Leia references/hoodwallet.md quando a conta signatária for uma OnChainHoodies ERC-6551 HoodWallet.

Escolha o perfil do signatário

• eoa: prepare a transação para uma carteira externa convencional.
• och-hoodwallet: resolva o proprietário do Hoodie e a conta ERC-6551 determinística através do OnChainHoodies, faça a cotação com o endereço HoodWallet como swapper, e então passe a chamada preparada para o método de execução autorizado da HoodWallet.
• Nunca trate uma conta vinculada a token como tendo uma chave privada independente. O proprietário atual do NFT ou outro controlador explicitamente autorizado deve aprovar e executar a chamada.
• A API pública do OnChainHoodies fornece identidade, propriedade e contexto de carteira. Ela mesma não autoriza ou assina uma transação HoodWallet.

Fluxo de trabalho de negociação

1. Resolva os ativos solicitados por símbolo, nome ou endereço do contrato.
2. Confirme que ambos os ativos estão na Robinhood Chain e identifique as casas decimais. Trate ETH nativo como 0x0000000000000000000000000000000000000000.
3. Converta a entrada humana para um valor inteiro bruto sem aritmética de ponto flutuante.
4. Execute node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...] ou chame /quote diretamente.
5. Mostre o provedor selecionado, entrada, saída esperada, impacto de preço se presente, restrição de pool se presente e quaisquer avisos. Não descreva uma cotação como garantida.
6. Exija que o usuário aprove explicitamente a preparação.
7. Se a entrada for ERC-20 e a cotação relatar uma aprovação, prepare a(s) transação(ões) de aprovação necessária(s). Não aprove silenciosamente gastos ilimitados.
8. Execute node scripts/prepare-swap.mjs --quote-file quote.json ou chame /swap/prepare com a cotação do provedor selecionado.
9. Verifique novamente chain ID, destino, valor, presença de calldata, par de tokens e quantidade.
10. Retorne a transação não assinada para o adaptador de signatário selecionado para revisão explícita. Para och-hoodwallet, envolva apenas o destino, valor e calldata exatos preparados na chamada de execução HoodWallet após verificar a propriedade atual do Hoodie.
11. Nunca transmita a partir do agente, a menos que o usuário tenha ativado separadamente uma ferramenta ou política de carteira autorizada e aprovado a ação exata.

Fluxo de trabalho de lançamento

1. Colete o nome, ticker, descrição, URL de imagem pública, e-mail do criador, carteira do criador e modo de par necessários.
2. Se estiver emparelhando com um token de ação, resolva o endereço a partir de GET /stocks; nunca aceite um endereço de par de ações arbitrário.
3. Envie o payload de pré-verificação canônico com source: "launchpad", mode: "preflight" e dryRun: true.
4. Apresente o token e pool previstos, suprimento total, taxa, divisão completa do beneficiário, par, propriedades de segurança, estimativa de gás e destino da transação.
5. Pare para revisão do usuário. A pré-verificação não é autorização para lançar.
6. Apenas a conta do criador pode autorizar e enviar a transação Airlock retornada. Um criador HoodWallet deve executá-la através do caminho de conta ERC-6551 autorizada.

Determinismo e tratamento de erros

• Use quantidades inteiras brutas em chamadas de API e preserve-as como strings.
• Não invente casas decimais de token, endereços, IDs de pool, cotações, saldos ou disponibilidade de rota.
• Um 404 de /quote significa que nenhuma rota executável foi encontrada; não fabrique um fallback.
• Um provedor marcado como NO ROUTE ou NOT CONFIGURED está indisponível para essa solicitação.
• Refaça a cotação imediatamente antes da preparação da transação se a cotação anterior estiver obsoleta ou o valor mudar.
• Trate todas as transações preparadas como expiradas quando sua cotação ou prazo expirar.
• Trate a rejeição do usuário como cancelamento, não como falha de transação.

API e cliente

• URL base de produção: https://hoodieswap.xyz/api/v1
• OpenAPI: https://hoodieswap.xyz/api/v1/openapi.json
• Especificação do repositório: openapi/hoodieswap-v1.yaml
• Cliente TypeScript: src/client.ts
• Descoberta de capacidades: GET /capabilities

O Hoodieswap prepara rotas e transações. A carteira permanece como o limite de assinatura e o Hoodieswap nunca assume custódia.