1SHOT API INTEGRACIÓN n8n: SMART CONTRACTS Y WALLETS EN PILOTO AUTOMÁTICO

Esta acción te permite recuperar la lista completa de blockchains soportadas por tu cuenta 1Shot. Es el punto de partida ideal para cualquier workflow que necesite operar en múltiples redes, ya que te proporciona los identificadores necesarios para las demás acciones.

Parámetros de configuración: Credential to connect with: Selecciona las credenciales de tu cuenta 1Shot desde el menú desplegable. Este parámetro es requerido. Page Number: Número de página de resultados a recuperar. Acepta input numérico, valor por defecto: 1. Parámetro opcional. Page Size: Cantidad de resultados por página. Acepta input numérico, valor por defecto: 25. Parámetro opcional.

Casos de uso típicos: Obtener dinámicamente la lista de chains disponibles al inicio de un workflow multi-chain; validar que una chain específica está soportada antes de ejecutar operaciones; construir menús de selección dinámicos en formularios conectados a n8n.

Cuándo usarlo: Úsalo al principio de workflows que operan en múltiples blockchains o cuando necesites verificar la disponibilidad de una red específica antes de proceder.

Esta acción permite asegurar métodos de contrato basándose en un prompt predefinido. Es particularmente útil cuando trabajas con contratos complejos y quieres garantizar que los métodos necesarios están correctamente configurados antes de ejecutar operaciones.

Parámetros de configuración: Credential to connect with: Credenciales de autenticación 1Shot. Requerido. Chain Name or ID: Nombre o identificador de la blockchain donde reside el contrato. Acepta texto. Requerido. Contract Address: Dirección del smart contract a configurar. Acepta texto. Requerido. Prompt ID: Identificador único del prompt que define los métodos a asegurar. Acepta texto. Requerido. Wallet Name or ID: Nombre o ID del wallet asociado a las operaciones. Acepta texto. Requerido.

Casos de uso típicos: Preparar contratos para interacciones automatizadas asegurando que todos los métodos necesarios están disponibles; configurar nuevos contratos importados para workflows existentes; validar la configuración de métodos antes de desplegar automatizaciones en producción.

Cuándo usarlo: Ideal durante la fase de setup de nuevos contratos o cuando integras contratos de terceros en tus workflows automatizados.

La acción de codificación permite preparar los datos de una llamada a smart contract sin ejecutarla. Genera el calldata necesario que luego puede usarse en transacciones manuales o en otras herramientas de tu stack tecnológico.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot para autenticación. Requerido. Resource: Tipo de recurso, fijado en "Contract Method". Requerido. Operation: Operación a realizar, fijada en "Encode". Requerido. Contract Method Name or ID: Nombre o identificador del método del contrato a codificar. Acepta texto. Requerido. Parameters: Sección expandible para definir los parámetros del método. Permite añadir múltiples campos según los requisitos del contrato.

Casos de uso típicos: Generar calldata para transacciones que serán firmadas externamente (hardware wallets, multisig); preparar datos de transacción para análisis o debugging; integrar con sistemas de aprobación donde la codificación y ejecución están separadas.

Cuándo usarlo: Cuando necesitas separar la preparación de la transacción de su ejecución, especialmente en flujos con múltiples aprobadores o auditorías.

Antes de ejecutar cualquier transacción en blockchain, esta acción te permite estimar el coste de gas. Es esencial para workflows que necesitan validar costes antes de proceder o que operan con presupuestos de gas definidos.

Parámetros de configuración: Credential to connect with: Credenciales de autenticación. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Estimate". Requerido. Contract Method Name or ID: Identificador del método a estimar. Acepta texto. Requerido. Parameters: Parámetros adicionales para la estimación en formato JSON. Acepta texto. Opcional.

Casos de uso típicos: Validar que el coste de gas está dentro de un umbral aceptable antes de ejecutar; comparar costes de gas entre diferentes métodos o contratos; generar reportes de costes estimados para operaciones planificadas.

Cuándo usarlo: Siempre antes de ejecutar transacciones de alto valor o en workflows donde el coste de gas es un factor crítico de decisión.

Esta es la acción principal para interactuar con smart contracts. Ejecuta un método específico del contrato, enviando la transacción a la blockchain y devolviendo el resultado de la operación.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Execute". Requerido. Contract Method Name or ID: Método del contrato a ejecutar. Acepta texto. Requerido. Parameters: Parámetros para la ejecución en formato JSON. Opcional. Additional Fields: Sección para configuraciones adicionales específicas de la transacción.

Casos de uso típicos: Automatizar operaciones DeFi recurrentes (staking, harvesting, swaps); ejecutar funciones administrativas de contratos propios; integrar operaciones blockchain en flujos de negocio más amplios.

Cuándo usarlo: Para cualquier interacción directa con smart contracts donde tu wallet tiene los permisos necesarios.

Variante de la ejecución estándar que permite operar como delegador. Útil en arquitecturas donde un contrato ejecuta acciones en nombre de otro, o en sistemas de gobernanza delegada.

Parámetros de configuración: Credential to connect with: Credenciales de autenticación. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Execute as Delegator". Requerido. Contract Method Name or ID: Método a ejecutar. Acepta texto. Requerido. Parameters: Parámetros del método en formato objeto. Permite múltiples entradas. Delegator Wallet Address: Dirección del wallet delegador. Acepta texto. Requerido. Additional Fields: Configuraciones adicionales opcionales.

Casos de uso típicos: Ejecutar operaciones en protocolos de gobernanza como delegado; automatizar acciones en sistemas de meta-transacciones; gestionar operaciones en arquitecturas de contratos proxy.

Cuándo usarlo: En escenarios de delegación de autoridad o cuando operas contratos que implementan patrones de delegación.

Permite ejecutar operaciones en batch sobre múltiples métodos de contrato en una sola acción. Ideal para workflows que necesitan realizar varias operaciones relacionadas de forma atómica o secuencial.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Execute Batch". Requerido. Contract Methods: Selector de métodos de contrato a ejecutar. Permite selección múltiple. Requerido. Wallet Name or ID: Wallet a utilizar para las ejecuciones. Acepta texto. Opcional. Additional Fields: Configuraciones extra para el batch.

Casos de uso típicos: Ejecutar estrategias DeFi multi-paso en una sola operación; realizar mantenimiento en múltiples contratos simultáneamente; implementar flujos de aprobación + ejecución combinados.

Cuándo usarlo: Cuando necesitas atomicidad entre operaciones o quieres optimizar el número de transacciones en un workflow complejo.

Combina la capacidad de ejecución batch con el modo delegador, permitiendo ejecutar múltiples operaciones de contrato en nombre de otro wallet o entidad.

Parámetros de configuración: Credential to connect with: Autenticación 1Shot. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Execute Batch as Delegator". Requerido. Contract Methods: Métodos a ejecutar en batch. Requerido. Wallet Name or ID: Identificador del wallet. Acepta texto. Requerido. Additional Fields: Parámetros opcionales adicionales.

Casos de uso típicos: Gestionar operaciones delegadas en protocolos de gobernanza complejos; automatizar estrategias que requieren delegación en múltiples contratos; implementar sistemas de gestión de tesorería automatizados.

Cuándo usarlo: En escenarios avanzados que combinan delegación y operaciones múltiples.

Recupera información detallada sobre un método específico de smart contract, incluyendo sus parámetros, tipos y configuración actual en el sistema 1Shot.

Parámetros de configuración: Credential to connect with: Credenciales de cuenta. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Get". Requerido. Contract Method ID: Identificador único del método a consultar. Acepta texto. Requerido.

Casos de uso típicos: Verificar la configuración de un método antes de usarlo en automatizaciones; obtener información de parámetros para construir llamadas dinámicas; debugging de workflows que fallan en métodos específicos.

Cuándo usarlo: Para inspección y validación de métodos de contrato durante el desarrollo o troubleshooting.

Proporciona una vista completa de todos los métodos de smart contract configurados en tu cuenta, con opciones de filtrado avanzadas para encontrar exactamente lo que necesitas.

Parámetros de configuración: Credential to connect with: Autenticación. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "List". Requerido. Name: Filtrar por nombre del método. Acepta texto. Opcional. Contract Address: Filtrar por dirección de contrato. Acepta texto. Opcional. Prompt ID: Filtrar por ID de prompt asociado. Acepta texto. Opcional. Method Type: Tipo de método a listar (dropdown, por defecto "None"). Opcional. Chain Name or ID: Filtrar por blockchain. Acepta texto. Opcional. Page Number: Página de resultados (por defecto: 1). Opcional. Page Size: Resultados por página (por defecto: 25). Opcional.

Casos de uso típicos: Auditar todos los métodos configurados en tu cuenta; buscar métodos específicos por contrato o tipo; generar documentación automática de tu configuración 1Shot.

Cuándo usarlo: Para gestión y auditoría de tu biblioteca de métodos de contrato.

La simulación te permite ejecutar un método de contrato "en seco", viendo exactamente qué pasaría sin comprometer fondos ni modificar el estado de la blockchain. Esencial para testing y validación.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Simulate". Requerido. Contract Method Name or ID: Método a simular. Acepta texto. Requerido. Parameters: Parámetros de la simulación en formato JSON. Opcional. Gas Limit: Límite de gas para la simulación. Acepta input numérico. Opcional.

Casos de uso típicos: Probar transacciones complejas antes de ejecutarlas en producción; validar que los parámetros producen el resultado esperado; detectar posibles errores o reverts antes de gastar gas.

Cuándo usarlo: Siempre antes de ejecutar operaciones de alto riesgo o cuando estás desarrollando nuevas automatizaciones.

Permite leer datos de un smart contract sin modificar su estado. Ideal para consultas de saldos, configuraciones o cualquier información almacenada en la blockchain.

Parámetros de configuración: Credential to connect with: Autenticación requerida. Requerido. Resource: Fijado en "Contract Method". Requerido. Operation: Fijado en "Read". Requerido. Contract Method Name or ID: Método de lectura a ejecutar. Acepta texto. Requerido. Parameters: Parámetros adicionales en formato JSON. Opcional.

Casos de uso típicos: Consultar saldos de tokens antes de ejecutar transferencias; leer configuraciones de contratos para toma de decisiones en workflows; monitorear estados de contratos y generar alertas basadas en cambios.

Cuándo usarlo: Para cualquier consulta de datos que no requiera modificar el estado del contrato.

Recupera información detallada sobre una transacción específica, incluyendo su estado, datos de la operación y metadatos asociados.

Parámetros de configuración: Credential to connect with: Credenciales de autenticación. Requerido. Resource: Fijado en "Transaction". Requerido. Operation: Fijado en "Get Transaction". Requerido. Transaction Name or ID: Identificador único de la transacción. Acepta texto. Requerido.

Casos de uso típicos: Verificar el estado de una transacción ejecutada previamente; obtener detalles para logging o auditoría; debugging de transacciones fallidas.

Cuándo usarlo: Para seguimiento y verificación de transacciones individuales.

Proporciona un listado completo de transacciones con múltiples opciones de filtrado, permitiendo auditorías detalladas y seguimiento histórico de operaciones.

Parámetros de configuración: Credential to connect with: Autenticación. Requerido. Resource: Fijado en "Transaction". Requerido. Operation: Fijado en "List Transactions". Requerido. Status: Filtrar por estado de transacción (dropdown). Opcional. Wallet ID: Filtrar por wallet específico. Acepta texto. Opcional. Contract Method ID: Filtrar por método de contrato. Acepta texto. Opcional. API Credential ID: Filtrar por credencial API. Acepta texto. Opcional. User ID: Filtrar por usuario. Acepta texto. Opcional. Memo: Filtrar por memo/nota. Acepta texto. Opcional. After Time: Transacciones después de timestamp (por defecto: 0). Opcional. Before Time: Transacciones antes de timestamp (por defecto: 0). Opcional. Page Number: Página de resultados. Opcional.

Casos de uso típicos: Generar reportes de actividad por período o wallet; monitorear transacciones pendientes o fallidas; auditar operaciones por usuario o método de contrato.

Cuándo usarlo: Para monitoreo, reporting y auditoría de actividad transaccional.

Crea un nuevo wallet en tu cuenta 1Shot, asociado a una blockchain específica. Fundamental para workflows que necesitan gestionar múltiples wallets programáticamente.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot. Requerido. Resource: Fijado en "Wallet". Requerido. Operation: Fijado en "Create Wallet". Requerido. Chain Name or ID: Blockchain donde crear el wallet. Acepta texto. Requerido. Name: Nombre para el nuevo wallet. Acepta texto. Requerido. Description: Descripción opcional del wallet. Acepta texto. Opcional.

Casos de uso típicos: Crear automáticamente wallets para nuevos usuarios de tu aplicación; provisionar wallets para diferentes propósitos (operaciones, tesorería, testing); implementar sistemas de gestión de wallets multi-tenant.

Cuándo usarlo: Cuando necesitas crear wallets de forma programática como parte de flujos de onboarding o gestión.

Permite buscar entre los prompts disponibles en tu cuenta 1Shot, útil para encontrar configuraciones predefinidas para interacciones con contratos.

Parámetros de configuración: Credential to connect with: Autenticación. Requerido. Resource: Fijado en "Prompt". Requerido. Operation: Fijado en "Search Prompts". Requerido. Query: Texto de búsqueda para filtrar prompts. Acepta texto. Opcional. Chain Name or ID: Filtrar por blockchain. Acepta texto. Opcional.

Casos de uso típicos: Encontrar prompts específicos para tipos de contratos; explorar prompts disponibles por blockchain; integrar selección dinámica de prompts en workflows.

Cuándo usarlo: Cuando trabajas con la funcionalidad de prompts de 1Shot y necesitas buscar o seleccionar configuraciones específicas.

Elimina un wallet de tu cuenta 1Shot. Usar con precaución ya que esta operación puede ser irreversible.

Parámetros de configuración: Credential to connect with: Autenticación. Requerido. Resource: Fijado en "Wallet". Requerido. Operation: Fijado en "Delete Wallet". Requerido. Wallet Name or ID: Identificador del wallet a eliminar. Acepta texto. Requerido.

Casos de uso típicos: Limpieza de wallets de testing después de pruebas; offboarding de usuarios con eliminación de recursos asociados; gestión de ciclo de vida de wallets temporales.

Cuándo usarlo: Para gestión de ciclo de vida de wallets, especialmente en entornos de testing o sistemas con wallets efímeros.

Recupera la lista de wallets configurados en tu cuenta con opciones de filtrado por blockchain y nombre.

Parámetros de configuración: Credential to connect with: Credenciales. Requerido. Resource: Fijado en "Wallet". Requerido. Operation: Fijado en "List Wallets". Requerido. Chain Name or ID: Filtrar por blockchain. Acepta texto. Opcional. Name: Buscar por nombre de wallet. Acepta texto. Opcional. Page Number: Página de resultados (por defecto: 1). Opcional. Page Size: Resultados por página (por defecto: 25). Opcional.

Casos de uso típicos: Inventariar wallets disponibles al inicio de workflows; buscar wallets específicos para operaciones; generar reportes de wallets por blockchain.

Cuándo usarlo: Para consulta y gestión de tu portfolio de wallets.

Obtiene información detallada de un wallet específico, incluyendo su configuración, dirección y metadatos asociados.

Parámetros de configuración: Credential to connect with: Autenticación. Requerido. Resource: Fijado en "Wallet". Requerido. Operation: Fijado en "Get Wallet". Requerido. Wallet Name or ID: Identificador del wallet a consultar. Acepta texto. Requerido.

Casos de uso típicos: Verificar la configuración de un wallet antes de usarlo; obtener la dirección del wallet para operaciones externas; debugging de problemas relacionados con wallets específicos.

Cuándo usarlo: Para inspección detallada de wallets individuales.

Modifica la configuración de un wallet existente, permitiendo actualizar su nombre, descripción u otros metadatos.

Parámetros de configuración: Credential to connect with: Credenciales 1Shot. Requerido. Resource: Fijado en "Wallet". Requerido. Operation: Fijado en "Update Wallet". Requerido. Chain Name or ID: Blockchain del wallet. Acepta texto. Requerido. Wallet Name or ID: Identificador del wallet a actualizar. Acepta texto. Requerido. Name: Nuevo nombre para el wallet. Acepta texto. Opcional. Description: Nueva descripción. Acepta texto. Opcional.

Casos de uso típicos: Actualizar nombres de wallets para mejor organización; añadir descripciones después de asignar propósitos específicos; mantener metadatos actualizados en sistemas automatizados.

Cuándo usarlo: Para gestión y mantenimiento de la información de wallets.