Hoodieswap Skill (Habilidad de Hoodieswap)

Habilidad de Hoodieswap

Utiliza Hoodieswap como una capa de preparación de ejecución no custodial en Robinhood Chain (ID de cadena 4663). Descubre activos y rutas, muestra al usuario los términos materiales y luego prepara transacciones sin firmar para la billetera conectada. Nunca solicites, almacenes ni uses una clave privada.

Elige el flujo de trabajo

• Para búsqueda de activos o descubrimiento de mercado, llama a GET /tokens o GET /stocks.
• Para una vista previa de intercambio, llama a POST /quote. Una billetera es opcional para cotizaciones de vista previa.
• Para una entrada ERC-20, llama a POST /approval después de que el usuario seleccione una ruta y una billetera.
• Para obtener el payload de intercambio sin firmar final, llama a POST /swap/prepare.
• Para un lanzamiento de token, llama a POST /launch/preflight con dryRun: true. Detente después de devolver la simulación y la transacción Airlock sin firmar.
• Lee references/safety.md antes de preparar cualquier transacción.
• Lee references/schemas.md para los campos de solicitud y respuesta.
• Lee references/robinhood-chain.md para los valores canónicos de la red.
• Lee references/hoodwallet.md cuando la cuenta firmante sea un HoodWallet ERC-6551 de OnChainHoodies.

Elige el perfil del firmante

• eoa: prepara la transacción para una billetera externa convencional.
• och-hoodwallet: resuelve el propietario del Hoodie y la cuenta ERC-6551 determinista a través de OnChainHoodies, cotiza con la dirección de HoodWallet como swapper, luego pasa la llamada preparada al método de ejecución autorizado de la HoodWallet.
• Nunca trates una cuenta vinculada a un token como si tuviera una clave privada independiente. Su propietario actual del NFT u otro controlador explícitamente autorizado debe aprobar y ejecutar la llamada.
• La API pública de OnChainHoodies proporciona identidad, propiedad y contexto de billetera. No autoriza ni firma por sí misma una transacción de HoodWallet.

Flujo de trabajo de intercambio

1. Resuelve los activos solicitados por símbolo, nombre o dirección de contrato.
2. Confirma que ambos activos están en Robinhood Chain e identifica los decimales. Trata ETH nativo como 0x0000000000000000000000000000000000000000.
3. Convierte la entrada humana a una cantidad entera sin procesar sin usar aritmética de punto flotante.
4. Ejecuta node scripts/quote.mjs --token-in ... --token-out ... --amount ... --decimals ... [--swapper ...] o llama a /quote directamente.
5. Muestra el proveedor seleccionado, entrada, salida esperada, impacto en el precio si está presente, restricción del pool si está presente, y cualquier advertencia. No describas una cotización como garantizada.
6. Exige que el usuario apruebe explícitamente la preparación.
7. Si la entrada es ERC-20 y la cotización informa una aprobación, prepara la(s) transacción(es) de aprobación requerida(s). No apruebes en silencio un gasto ilimitado.
8. Ejecuta node scripts/prepare-swap.mjs --quote-file quote.json o llama a /swap/prepare con la cotización del proveedor seleccionado.
9. Verifica nuevamente el ID de cadena, destino, valor, presencia de calldata, par de tokens y monto.
10. Devuelve la transacción sin firmar al adaptador de firmante seleccionado para revisión explícita. Para och-hoodwallet, envuelve solo el destino, valor y calldata exactos preparados en la llamada de ejecución de HoodWallet después de verificar la propiedad actual del Hoodie.
11. Nunca la transmitas desde el agente a menos que el usuario haya habilitado por separado una herramienta o política de billetera autorizada y haya aprobado la acción exacta.

Flujo de trabajo de lanzamiento

1. Recopila el nombre, ticker, descripción, URL de imagen pública, correo electrónico del creador, billetera del creador y modo de par requeridos.
2. Si se empareja con un token de stock, resuelve la dirección desde GET /stocks; nunca aceptes una dirección de par de stock arbitraria.
3. Envía el payload de preventa canónico con source: "launchpad", mode: "preflight" y dryRun: true.
4. Presenta el token y pool predichos, suministro total, tarifa, división completa del beneficiario, par, propiedades de seguridad, estimación de gas y destino de la transacción.
5. Detente para revisión del usuario. La preventa no es una autorización para lanzar.
6. Solo la cuenta del creador puede autorizar y enviar la transacción Airlock devuelta. Un creador de HoodWallet debe ejecutarla a través de la ruta de cuenta ERC-6551 autorizada.

Determinismo y manejo de errores

• Usa cantidades enteras sin procesar en las llamadas a la API y consérvalas como cadenas.
• No inventes decimales de tokens, direcciones, IDs de pool, cotizaciones, saldos ni disponibilidad de rutas.
• Un 404 de /quote significa que no se encontró una ruta ejecutable; no fabriques una alternativa.
• Un proveedor marcado como NO ROUTE o NOT CONFIGURED no está disponible para esa solicitud.
• Vuelve a cotizar inmediatamente antes de la preparación de la transacción si la cotización anterior está desactualizada o el monto cambia.
• Trata todas las transacciones preparadas como vencidas cuando su cotización o plazo haya expirado.
• Presenta el rechazo del usuario como cancelación, no como fallo de transacción.

API y cliente

• URL base de producción: https://hoodieswap.xyz/api/v1
• OpenAPI: https://hoodieswap.xyz/api/v1/openapi.json
• Especificación del repositorio: openapi/hoodieswap-v1.yaml
• Cliente TypeScript: src/client.ts
• Descubrimiento de capacidades: GET /capabilities

Hoodieswap prepara rutas y transacciones. La billetera sigue siendo el límite de firma y Hoodieswap nunca toma custodia.