- Inicio
- Recursos
- Integraciones
- 1Shot API
Integración 1Shot API n8nAutomatiza 1Shot API con n8n.
¿Se puede enviar una transacción onchain desde un flujo de trabajo sin tocar nunca una clave privada? Para eso está la integración 1Shot API n8n. El nodo expone 27 operaciones repartidas en 7 recursos, de los wallets a los métodos de contrato, y su trigger webhook arranca el flujo en cuanto 1Shot envía un evento.
Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (n8n-nodes-1shot) que instalas desde Settings › Community nodes en una instancia autoalojada. npm
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve la integración 1Shot API n8n?
Una vez instalado, el nodo convierte una llamada a un contrato EVM en un paso más del flujo. Eliges un wallet gestionado por 1Shot, eliges un método de contrato, y n8n lo encadena como con cualquier otra API.
Un trigger webhook completa el cuadro: escucha los eventos que 1Shot envía, como la creación o actualización de un contract event, y los entrega directamente a un flujo, sin ningún polling.
Empieza por la vigilancia onchain, que es donde el nodo aporta antes de escribir nada. Declaras una vez lo que te interesa con contractEvents.create y luego contractEvents.search devuelve los logs correspondientes en un rango de bloques. El histórico se guarda en Postgres y las alertas salen por Gmail cuando una transferencia pasa el umbral que fijó el equipo financiero.
El segundo caso es la acción que pide una persona. Llega la solicitud, contractMethods.simulate comprueba si la llamada saldría bien con el estado actual de la cadena y contractMethods.execute la envía de verdad. Si la simulación falla, el flujo se detiene antes de gastar gas. Esa es la diferencia entre una automatización que falla limpio y otra que quema comisiones sin resultado.
El tercero es el informe de tesorería. wallets.list saca los wallets de una cadena, transactions.list saca lo que hicieron entre dos marcas de tiempo unix, y un nodo Code les da el formato que espera el informe del viernes. Nada exótico, solo un flujo programado que evita rehacer las cuentas a mano.
Cuando un endpoint de la API de 1Shot no está cubierto por el nodo, entra el nodo HTTP Request. Llama a cualquier endpoint reutilizando el mismo credential mediante la autenticación predefinida, así que no duplicas secretos por el flujo.
Los límites, cuanto antes mejor. Las operaciones de listado piden Page Number y Page Size como campos obligatorios: aquí no hay casilla Return All, y una exportación completa se resuelve recorriendo las páginas. Además el nodo se queda en el perímetro de la API de 1Shot, no lee la cadena más allá de los métodos y los eventos que hayas declarado. Si quieres una opinión sobre la plataforma antes de montar nada, la Reseña n8n explica dónde encaja y dónde no.
¿Cómo se conecta 1Shot API con n8n?
- 01
Instalar el paquete comunitario
En una instancia autoalojada, abre Settings, luego Community nodes, e instala
n8n-nodes-1shoten versión1.0.35. n8n reinicia y el nodo 1Shot API aparece en el panel como cualquier nodo incluido de serie. En n8n Cloud solo se instalan nodos comunitarios verificados, conviene confirmarlo antes de contar con ello. Del lado de n8n, la instalación no cuesta nada. - 02
Crear el credential una sola vez
Entra en el menú Credentials y crea el credential de 1Shot con los valores de tu cuenta. Un credential, en n8n, es un conjunto de secretos guardado aparte: lo creas una vez, todos los flujos lo reutilizan y el nodo te lo ofrece en su desplegable. Qué significa cada valor y dónde generarlo está documentado del lado de 1Shot, en docs.1shotapi.com.
- 03
Probar con una lectura antes que nada
Pon el nodo en el lienzo, elige el recurso Chain y la operación List chains, deja Page Number en 1 y Page Size en un valor pequeño, y ejecuta el paso. Si vuelve la lista de cadenas soportadas, el credential funciona. Hacerlo antes de la primera operación de escritura te ahorra depurar la autenticación y los parámetros del contrato a la vez.
¿Qué arranca un flujo desde 1Shot API ?
1Shot API Webhook es el nodo que arranca un workflow cuando 1Shot API llama a n8n. Activas el workflow: n8n te da la URL del webhook que registras en 1Shot API, y cada llamada se convierte en una ejecución.
Lo que ves en n8n
Notas de configuración
01Set up the 1Shot API Webhook trigger
El trigger 1Shot API Webhook arranca el flujo cuando 1Shot envía una petición a la URL de n8n y esa petición pasa la verificación. Un webhook es una URL que la herramienta llama cuando ocurre algo: el evento llega en unos segundos, sin que n8n tenga que preguntar cada cierto tiempo.
Parámetros clave
- Public Key: la clave pública ED-25519 que facilita 1Shot para verificar el webhook. Campo obligatorio, sin él el nodo no se ejecuta.
- Webhook Type: elige el tipo de verificación que se aplica a las llamadas entrantes.
- Tokens: también obligatorio, contiene los tokens que se aceptan como pago.
02Shape the URL the trigger listens on
Dos parámetros deciden qué aspecto debe tener la petición entrante. Importan en cuanto 1Shot no es el único que llama, o cuando prefieres un flujo por contrato en lugar de uno que lo hace todo.
Parámetros clave
- Path: la ruta escuchada. Los valores dinámicos se escriben con dos puntos, del tipo
your-path/:dynamic-value, y entonces el identificador del webhook se antepone a la ruta. - HTTP Method: el método HTTP único que escucha el trigger.
- Allow Multiple HTTP Methods: actívalo cuando el webhook deba aceptar varios métodos HTTP.
03Control what the trigger answers
Quien llama recibe una respuesta HTTP, y su contenido se ajusta aquí. Es lo que tocas cuando 1Shot espera un código concreto, o cuando el flujo tarda más de lo que el llamante está dispuesto a esperar.
Parámetros clave
- Respond: define cuándo y cómo responde el webhook.
- Response Code: el código HTTP devuelto.
- Response Data: devolver todos los items como array, o solo el primero como objeto.
- Options: la colección adicional del trigger, para los ajustes que no caben en los campos anteriores.
¿Qué sabe hacer el nodo 1Shot API ?
El nodo 1Shot API expone 27 operaciones en 7 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Update | Delete | Assure Contract Methods From Prompt | Encode | Estimate | Execute | Execute as Delegator | Execute Batch as Delegator | Execute Batch | List Chains | Read | Search | Simulate | X402 HTTP Request |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| X402 Request | ✓ | |||||||||||||||
| Chain | ✓ | |||||||||||||||
| Contract Event | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||||||
| Contract Method | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Prompt | ✓ | |||||||||||||||
| Transaction | ✓ | ✓ | ||||||||||||||
| Wallet | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
- Assure contract methods from prompt
- Encode a smart contract method call
- Estimate the gas cost of a smart contract method
- Execute a smart contract method
- Execute a smart contract method as delegator
- Execute multiple smart contract methods
- Execute multiple smart contract methods as delegator
- Get a smart contract method
- List all smart contract methods
- Read data from a smart contract function
- Simulate a smart contract method call
X402 Request
1 operaciónX402 HTTP Request
x402Request.x402Lo que ves en n8n
Notas y casos de uso
Esta operación lanza una petición HTTP a un endpoint compatible con x402 y paga la comisión que haya desde un wallet de 1Shot. La llamada se comporta como una petición HTTP normal, el pago ocurre por debajo.
Parámetros clave
- Wallet Name or ID: el wallet que paga, elegido de la lista o definido con una expresión.
- URL: la dirección a la que se llama, del tipo
http://example.com/index.html. - Credential Type y Generic Auth Type: cómo se autentica la llamada ante el endpoint de destino.
- Method: GET, POST, PUT, PATCH, DELETE, HEAD u OPTIONS.
Chain
1 operaciónList chains
chains.listLo que ves en n8n
Notas y casos de uso
Devuelve las cadenas soportadas por 1Shot API, página a página. Es la llamada con menos riesgo para confirmar que un credential funciona antes de tocar nada que consuma gas.
Parámetros clave
- Page Number: la página que quieres, la numeración empieza en 1.
- Page Size: cuántas cadenas vuelven en esa página.
Contract Event
6 operacionesCreate a contract event
contractEvents.createLo que ves en n8n
Notas y casos de uso
Registra una definición nueva de evento de contrato en 1Shot. Es esa definición la que apuntan las demás operaciones: mientras no exista, no se vigila nada.
Parámetros clave
- Chain Name or ID: la cadena donde vive el contrato.
- Contract Address: la dirección del contrato que hay que vigilar.
- Event Name: el nombre exacto del evento tal como está en la ABI del contrato, mayúsculas incluidas.
- Name y Description: un nombre legible y una descripción de lo que representa el evento, ambos obligatorios.
Delete a contract event
contractEvents.deleteLo que ves en n8n
Notas y casos de uso
Elimina una definición de evento de contrato. Desaparece de 1Shot, y cualquier flujo que siga apuntando a ese identificador fallará en su siguiente ejecución.
Parámetros clave
- Contract Event Name or ID: la definición que se borra, tomada de la lista o pasada con una expresión como
{{ $json.contractEventId }}.
Get a contract event
contractEvents.getLo que ves en n8n
Notas y casos de uso
Recupera una sola definición de evento con sus datos guardados. Sirve más como paso de control que como fin en sí mismo.
Parámetros clave
- Contract Event Name or ID: el identificador de la definición que quieres leer.
List all contract events
contractEvents.listLo que ves en n8n
Notas y casos de uso
Recorre tus definiciones de eventos página a página, con filtros para acotar el conjunto. Es la vista de inventario, no los logs de la blockchain.
Parámetros clave
- Page Number y Page Size: obligatorios, y sin casilla Return All, así que toca recorrer si lo quieres todo.
- Name, Contract Address, Event Name, Chain Name or ID: los filtros opcionales sobre las definiciones devueltas.
Search contract event logs
contractEvents.searchLo que ves en n8n
Notas y casos de uso
Va a la blockchain y trae los logs de eventos que encajan con una definición. Es la operación que devuelve datos, mientras que el listado solo devuelve definiciones.
Parámetros clave
- Contract Event Name or ID: la definición con la que se busca.
- Start Block y End Block: el bloque de inicio y el de fin de la búsqueda.
- Topics: pares de nombre y valor que filtran por los parámetros indexados del evento.
Update a contract event
contractEvents.updateLo que ves en n8n
Notas y casos de uso
Modifica una definición existente sin sustituirla. Solo cambian sus etiquetas, así que el identificador que usan tus otros flujos sigue funcionando.
Parámetros clave
- Contract Event Name or ID: la definición que se actualiza, obligatorio.
- Name y Description: el nombre y la descripción actualizados, ambos opcionales.
Contract Method
11 operacionesAssure contract methods from prompt
contractMethods.assureContractMethodsFromPromptLo que ves en n8n
Notas y casos de uso
Garantiza que un conjunto de métodos de contrato está listo para usarse a partir de un Prompt elegido. En lugar de crear cada método a mano, apuntas a un prompt y 1Shot prepara lo que va con él.
Parámetros clave
- Prompt ID: el identificador del Prompt que sirve de base.
- Contract Address: obligatorio, y se puede sacar del propio prompt si hace falta.
- Chain Name or ID: la cadena donde está el contrato.
- Wallet Name or ID: el wallet que se usa para esos métodos.
Encode a smart contract method call
contractMethods.encodeLo que ves en n8n
Notas y casos de uso
Produce el calldata de un método de contrato sin enviar nada. Otros métodos esperan ese calldata como entrada, y esa es justo la razón de ser de la operación.
Parámetros clave
- Contract Method Name or ID: el método que se codifica.
- Parameters: un objeto JSON con los valores que se pasan al método, por ejemplo
{"amount": "10000"}. - Authorization List: lista opcional de autorizaciones ERC-7702 para el método.
Estimate the gas cost of a smart contract method
contractMethods.estimateLo que ves en n8n
Notas y casos de uso
Da una estimación de lo que costaría en gas un método de contrato. Es una operación de solo lectura: no cambia nada en la cadena y puede repetirse tantas veces como quieras.
Parámetros clave
- Contract Method Name or ID: el método cuyo coste se calcula.
- Parameters: el objeto JSON de valores, porque el coste depende de lo que se pase.
Execute a smart contract method
contractMethods.executeLo que ves en n8n
Notas y casos de uso
Envía la transacción. Es la operación de escritura del nodo, la que conviene probar en una cadena de pruebas antes de dejarla en un flujo programado.
Parámetros clave
- Contract Method Name or ID y Parameters: qué se llama, y con qué valores.
- Wallet ID: el wallet de esta ejecución, cuando no es el que se usa por defecto.
- Value: la cantidad de token nativo que se envía con el método.
- Memo: un texto libre que acompaña a la transacción, muy útil después para cuadrar cuentas.
- Gas Limit: se aplica el mayor entre este valor y la estimación.
Execute a smart contract method as delegator
contractMethods.executeAsDelegatorLo que ves en n8n
Notas y casos de uso
Ejecuta un método en la blockchain usando una delegación ERC-7710 guardada, es decir por cuenta de otro wallet. La delegación es lo que da el derecho, y se indica de una sola manera cada vez.
Parámetros clave
- Delegation ID: la forma más segura de apuntar a la delegación correcta.
- Delegator Wallet Address: la dirección del wallet delegante, en lugar de un identificador.
- Delegation Data: un objeto JSON de delegación tratado como de un solo uso y que 1Shot no guarda. Solo uno de estos tres campos puede rellenarse.
- Contract Method Name or ID y Parameters: la llamada en sí.
Execute multiple smart contract methods
contractMethods.executeBatchLo que ves en n8n
Notas y casos de uso
Agrupa varios métodos de contrato en una sola transacción. Un envío, un único coste de gas, y una decisión sobre qué pasa si una de las llamadas falla.
Parámetros clave
- Contract Methods: la colección de llamadas, cada una con su Contract Method Name or ID y sus Parameters.
- Wallet Name or ID: el wallet que se usa para todo el lote.
- Atomic: activado, todas las transacciones del lote deben salir bien o se revierte el lote entero.
- Memo y Gas Limit: el texto que acompaña al lote, y el suelo de gas aplicado.
Execute multiple smart contract methods as delegator
contractMethods.executeAsDelegatorBatchLo que ves en n8n
Notas y casos de uso
La misma lógica de lote, pero actuando como delegado. Varias llamadas salen en una transacción única, por cuenta de una dirección que delegó el derecho de actuar.
Parámetros clave
- Contract Methods y Wallet Name or ID: las llamadas, y el wallet que las envía.
- Delegator Address, Delegation ID o Delegation Data: solo uno de los tres identifica la delegación.
- Atomic: decide si un fallo aislado revierte todo el lote.
- Authorization List: las autorizaciones ERC-7702 para la ejecución del lote.
Get a smart contract method
contractMethods.getLo que ves en n8n
Notas y casos de uso
Devuelve un método de contrato con sus datos guardados. Particularidad: aquí ningún campo es obligatorio, algo poco habitual en este nodo.
Parámetros clave
- Contract Method ID: el identificador del método que quieres. Es opcional, así que un valor vacío no devuelve nada aprovechable en lugar de lanzar un error.
List all smart contract methods
contractMethods.listLo que ves en n8n
Notas y casos de uso
Recorre los métodos de contrato declarados, con filtros que hacen el resultado usable. El del tipo de método es el que más tiempo ahorra.
Parámetros clave
- Page Number y Page Size: obligatorios en cada llamada.
- Method Type: Read, Write, o None para desactivar el filtro.
- Name, Contract Address, Prompt ID, Chain Name or ID: los demás filtros opcionales.
Read data from a smart contract function
contractMethods.readLo que ves en n8n
Notas y casos de uso
Lee una función view o pure del contrato. Ninguna transacción, ningún gas: solo un valor que vuelve al flujo.
Parámetros clave
- Contract Method Name or ID: el método de lectura que se llama.
- Parameters: el objeto JSON con los argumentos que espera la función.
Simulate a smart contract method call
contractMethods.simulateLo que ves en n8n
Notas y casos de uso
Reproduce la llamada con el estado actual de la cadena e indica si saldría bien. Piénsalo como el ensayo que se pone delante de cada ejecución real.
Parámetros clave
- Contract Method Name or ID y Parameters: exactamente lo que recibirá el paso de ejecución.
- Gas Limit: opcional, si lo dejas vacío se aplica el límite por defecto.
Prompt
1 operaciónSearch prompts
prompts.searchLo que ves en n8n
Notas y casos de uso
Lanza una búsqueda semántica sobre los Prompts de 1Shot y devuelve las herramientas utilizables en un flujo dinámico. Semántica quiere decir que describes lo que buscas con palabras, no por nombre exacto.
Parámetros clave
- Query: el texto de búsqueda, obligatorio.
- Chain Name or ID: un filtro opcional cuando solo te interesa una cadena.
Transaction
2 operacionesList transactions
transactions.listLo que ves en n8n
Notas y casos de uso
Devuelve las transacciones de 1Shot API en una ventana de tiempo, con una lista larga de filtros opcionales. Cada llamada está acotada en el tiempo, y eso es lo que hace segura su programación.
Parámetros clave
- After Time y Before Time: las marcas de tiempo unix que enmarcan la ventana, ambas obligatorias.
- Page Number y Page Size: también obligatorias.
- Status: Pending, Submitted, Completed, Retrying, Failed, o None.
- Wallet ID, Contract Method ID, API Credential ID, User ID, Memo, Chain Name or ID: los filtros opcionales.
Get transaction
transactions.getLo que ves en n8n
Notas y casos de uso
Trae una transacción concreta. Combínala con una espera o un bucle cuando quieras seguir un envío hasta que su estado se estabilice.
Parámetros clave
- Transaction Name or ID: el identificador de la transacción que quieres, a menudo
{{ $json.id }}heredado del paso de ejecución.
Wallet
5 operacionesCreate wallet
wallets.createLo que ves en n8n
Notas y casos de uso
Se crea un Wallet nuevo que queda vacío hasta que le envías fondos. El nombre importa, porque es el que aparece en los desplegables del resto de operaciones.
Parámetros clave
- Chain Name or ID: la cadena a la que pertenece el wallet, elegida en la lista o puesta con una expresión.
- Name: el nombre del wallet, obligatorio.
- Description: una descripción opcional del wallet.
Delete wallet
wallets.deleteLo que ves en n8n
Notas y casos de uso
Borra un Wallet. No pide nada más, así que el paso es definitivo y conviene ponerle delante la comprobación que necesites.
Parámetros clave
- Wallet Name or ID: el wallet que se borra, elegido en la lista o indicado con una expresión como
{{ $json.walletId }}.
Get wallet
wallets.getLo que ves en n8n
Notas y casos de uso
Consulta un Wallet por su identificador y muestra lo que 1Shot guarda de él. Aquí el campo es una cadena de texto, no un desplegable.
Parámetros clave
- Wallet Name or ID: el ID del Wallet que quieres obtener, actualizar o borrar, escrito tal cual o construido con una expresión.
List wallets
wallets.listLo que ves en n8n
Notas y casos de uso
Recorre los Wallets de una cadena, página a página. El filtro de cadena es opcional: dejarlo vacío amplía el resultado en lugar de romper la llamada.
Parámetros clave
- Page Number y Page Size: obligatorios los dos.
- Chain Name or ID: un filtro opcional por cadena.
- Name: filtra los wallets por nombre.
Update wallet
wallets.updateLo que ves en n8n
Notas y casos de uso
Actualiza lo que 1Shot guarda de un Wallet existente. El identificador no cambia, así que los flujos que lo referencian siguen funcionando.
Parámetros clave
- Wallet Name or ID: el wallet que se modifica, obligatorio.
- Name: el nombre del wallet, obligatorio incluso para un retoque menor.
- Chain Name or ID y Description: los dos campos opcionales.
¿Necesitas ayuda para automatizar 1Shot API con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


