- Accueil
- Ressources
- Intégrations
- 1Shot API
Intégration 1Shot API n8nAutomatiser 1Shot API avec n8n.
Signer une transaction blockchain depuis un workflow, sans jamais manipuler de clé privée ? C'est ce que permet l'intégration 1Shot API n8n. Le nœud expose 27 opérations réparties sur 7 ressources, des wallets aux méthodes de contrat, et son trigger webhook démarre le workflow dès que 1Shot envoie un événement.
Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-1shot) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Pourquoi monter l'intégration 1Shot API n8n ?
Une fois installé, le nœud transforme un appel de contrat EVM en étape de workflow ordinaire. Tu choisis un wallet géré par 1Shot, tu choisis une méthode de contrat, et n8n enchaîne comme avec n'importe quelle API.
Un trigger webhook complète le tableau : il écoute les événements que 1Shot envoie, comme la création ou la mise à jour d'un contract event, et les transmet directement à un workflow, sans aucun polling.
Premier usage, le reporting de trésorerie. wallets.list sort les wallets d'une chaîne, transactions.list sort ce qu'ils ont fait entre deux horodatages unix, et tout atterrit dans Google Sheets le vendredi matin. Rien de spectaculaire, juste un workflow planifié qui évite de recompiler les chiffres à la main.
Deuxième usage, la surveillance onchain. Tu déclares une fois ce qui t'intéresse avec contractEvents.create, puis contractEvents.search ramène les logs correspondants sur une plage de blocs. Un message part vers Slack quand un transfert dépasse le seuil que l'équipe finance a fixé, et l'historique complet se range dans MySQL.
Troisième usage, l'action déclenchée par un humain. Une demande arrive, contractMethods.simulate vérifie que l'appel passerait dans l'état actuel de la chaîne, et contractMethods.execute l'envoie pour de vrai. Si la simulation échoue, le workflow s'arrête avant d'avoir dépensé le moindre gas. C'est la différence entre une automatisation qui rate proprement et une qui brûle des frais pour rien.
Quand un endpoint de l'API 1Shot n'est pas couvert par le nœud, le nœud HTTP Request prend le relais. Il appelle n'importe quel endpoint en réutilisant le même credential via l'authentification prédéfinie, donc aucun secret n'est dupliqué dans le workflow.
Les limites, tout de suite. Les opérations de liste demandent Page Number et Page Size en champs obligatoires : pas de case Return All ici, un export complet se code avec une boucle sur les pages. Et le nœud reste sur le périmètre de l'API 1Shot, il ne lit pas la chaîne au-delà des méthodes et des événements que tu as déclarés. Si la partie n8n est encore nouvelle pour l'équipe, la Formation n8n couvre les notions utilisées ici.
Comment connecter 1Shot API à n8n ?
- 01
Installer le paquet communautaire
Sur une instance auto-hébergée, ouvre Settings, puis Community nodes, et installe
n8n-nodes-1shoten version1.0.35. n8n redémarre et le nœud 1Shot API apparaît dans le panneau comme un nœud livré d'origine. Sur n8n Cloud, seuls les nœuds communautaires vérifiés s'installent, à vérifier avant de bâtir un plan dessus. Côté n8n, l'installation ne coûte rien. - 02
Créer le credential une seule fois
Va dans le menu Credentials et crée le credential 1Shot avec les valeurs de ton compte. Un credential, dans n8n, c'est un jeu de secrets enregistré à part : tu le crées une fois, tous les workflows le réutilisent, et le nœud le propose dans sa liste déroulante. Ce que vaut chaque valeur et où la générer est documenté côté 1Shot, sur docs.1shotapi.com.
- 03
Tester avec une lecture avant tout le reste
Pose le nœud sur le canvas, prends la ressource Chain et l'opération List chains, mets Page Number à 1 et Page Size à une petite valeur, puis exécute l'étape. Si la liste des chaînes supportées revient, le credential fonctionne. Faire ça avant la première opération d'écriture évite de déboguer l'authentification et les paramètres de contrat en même temps.
Qu'est-ce qui déclenche un workflow depuis 1Shot API ?
1Shot API Webhook est le nœud qui démarre un workflow quand 1Shot API appelle n8n. Tu actives le workflow : n8n te donne l'URL du webhook à enregistrer dans 1Shot API, et chaque appel devient une exécution.
Ce que tu vois dans n8n
Notes de configuration
01Set up the 1Shot API Webhook trigger
Le trigger 1Shot API Webhook démarre le workflow quand 1Shot envoie une requête sur l'URL n8n et que cette requête passe la vérification. Un webhook, c'est une URL que l'outil appelle quand il se passe quelque chose : l'événement arrive en quelques secondes, sans que n8n aille interroger l'API à intervalle régulier. Le workflow doit être actif pour que l'URL soit enregistrée côté outil.
Paramètres clés
- Public Key : la clé publique ED-25519 fournie par 1Shot pour vérifier le webhook. Champ obligatoire, sans lui le nœud ne s'exécute pas.
- Webhook Type : choisit le type de vérification appliqué aux appels entrants.
- Tokens : obligatoire aussi, il contient les tokens acceptés en paiement.
02Shape the URL the trigger listens on
Deux paramètres décident de la tête que doit avoir la requête entrante. Ça compte dès que 1Shot n'est pas le seul appelant, ou quand tu préfères un workflow par contrat plutôt qu'un workflow fourre-tout.
Paramètres clés
- Path : le chemin écouté. Les valeurs dynamiques s'écrivent avec deux points, du type
your-path/:dynamic-value, et l'identifiant du webhook est alors ajouté devant le chemin. - HTTP Method : la méthode HTTP unique écoutée par le trigger.
- Allow Multiple HTTP Methods : à activer quand le webhook doit accepter plusieurs méthodes HTTP.
03Control what the trigger answers
L'appelant reçoit une réponse HTTP, et son contenu se règle ici. C'est ce qu'on ajuste quand 1Shot attend un code précis, ou quand le workflow prend plus de temps que l'appelant n'est prêt à patienter.
Paramètres clés
- Respond : définit quand et comment le webhook répond.
- Response Code : le code HTTP renvoyé à l'appelant.
- Response Data : renvoyer tous les items sous forme de tableau, ou seulement le premier sous forme d'objet.
- Options : la collection annexe du trigger, pour les réglages qui ne rentrent pas dans les champs ci-dessus.
Que sait faire le nœud 1Shot API ?
Le nœud 1Shot API expose 27 opérations sur 7 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | 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 | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
- 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 opérationX402 HTTP Request
x402Request.x402Ce que tu vois dans n8n
Notes & cas d'usage
L'opération envoie une requête HTTP vers un endpoint compatible x402 et règle les frais éventuels depuis un wallet 1Shot. L'appel se comporte comme une requête HTTP classique, le paiement se joue en dessous.
Paramètres clés
- Wallet Name or ID : le wallet qui paie, choisi dans la liste ou défini par expression.
- URL : l'adresse appelée, du type
http://example.com/index.html. - Credential Type et Generic Auth Type : la façon dont l'appel s'authentifie auprès de l'endpoint visé.
- Method : GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS.
Chain
1 opérationList chains
chains.listCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les chaînes prises en charge par 1Shot API, page par page. C'est l'appel le moins risqué pour confirmer qu'un credential fonctionne avant de toucher à quoi que ce soit qui consomme du gas.
Paramètres clés
- Page Number : la page voulue, la numérotation commence à 1.
- Page Size : le nombre de chaînes renvoyées dans cette page.
Contract Event
6 opérationsCreate a contract event
contractEvents.createCe que tu vois dans n8n
Notes & cas d'usage
Enregistre une nouvelle définition d'événement de contrat dans 1Shot. C'est cette définition que les autres opérations ciblent ensuite : tant qu'elle n'existe pas, rien n'est surveillé.
Paramètres clés
- Chain Name or ID : la chaîne sur laquelle vit le contrat.
- Contract Address : l'adresse du contrat à surveiller.
- Event Name : le nom exact de l'événement tel qu'il est défini dans l'ABI du contrat, casse comprise.
- Name et Description : un nom lisible et une description de ce que représente l'événement, les deux obligatoires.
Delete a contract event
contractEvents.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime une définition d'événement de contrat. Elle disparaît de 1Shot, et tout workflow qui pointe encore sur cet identifiant tombera en erreur à sa prochaine exécution.
Paramètres clés
- Contract Event Name or ID : la définition à supprimer, prise dans la liste ou fournie par une expression comme
{{ $json.contractEventId }}.
Get a contract event
contractEvents.getCe que tu vois dans n8n
Notes & cas d'usage
Récupère une seule définition d'événement avec ses détails enregistrés. Utile comme étape de contrôle plutôt que comme finalité.
Paramètres clés
- Contract Event Name or ID : l'identifiant de la définition à lire.
List all contract events
contractEvents.listCe que tu vois dans n8n
Notes & cas d'usage
Parcourt tes définitions d'événements page par page, avec des filtres pour réduire le lot. C'est la vue inventaire, pas les logs de la blockchain.
Paramètres clés
- Page Number et Page Size : obligatoires, et sans case Return All, donc une boucle si tu veux tout.
- Name, Contract Address, Event Name, Chain Name or ID : les filtres optionnels sur les définitions renvoyées.
Search contract event logs
contractEvents.searchCe que tu vois dans n8n
Notes & cas d'usage
Va chercher sur la blockchain les logs d'événements qui correspondent à une définition. C'est l'opération qui rapporte de la donnée, là où la liste ne rapporte que des définitions.
Paramètres clés
- Contract Event Name or ID : la définition utilisée pour la recherche.
- Start Block et End Block : le bloc de départ et le bloc de fin de la recherche.
- Topics : des paires nom et valeur qui filtrent sur les paramètres indexés de l'événement.
Update a contract event
contractEvents.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie une définition existante sans la remplacer. Seuls ses libellés changent, donc l'identifiant utilisé par tes autres workflows continue de fonctionner.
Paramètres clés
- Contract Event Name or ID : la définition à mettre à jour, obligatoire.
- Name et Description : le nom et la description actualisés, les deux optionnels.
Contract Method
11 opérationsAssure contract methods from prompt
contractMethods.assureContractMethodsFromPromptCe que tu vois dans n8n
Notes & cas d'usage
Garantit qu'un ensemble de méthodes de contrat est prêt à l'emploi à partir d'un Prompt choisi. Plutôt que de créer chaque méthode à la main, tu pointes un prompt et 1Shot prépare ce qui va avec.
Paramètres clés
- Prompt ID : l'identifiant du Prompt servant de base.
- Contract Address : obligatoire, et récupérable depuis le prompt si besoin.
- Chain Name or ID : la chaîne où se trouve le contrat.
- Wallet Name or ID : le wallet utilisé pour ces méthodes.
Encode a smart contract method call
contractMethods.encodeCe que tu vois dans n8n
Notes & cas d'usage
Produit le calldata d'une méthode de contrat sans rien envoyer. Certaines autres méthodes attendent ce calldata en entrée, et c'est précisément la raison d'être de l'opération.
Paramètres clés
- Contract Method Name or ID : la méthode à encoder.
- Parameters : un objet JSON avec les valeurs passées à la méthode, par exemple
{"amount": "10000"}. - Authorization List : liste optionnelle d'autorisations ERC-7702 pour la méthode.
Estimate the gas cost of a smart contract method
contractMethods.estimateCe que tu vois dans n8n
Notes & cas d'usage
Donne une estimation du coût en gas d'une méthode de contrat. Opération en lecture seule : elle ne change rien sur la chaîne et peut tourner aussi souvent que nécessaire.
Paramètres clés
- Contract Method Name or ID : la méthode dont on chiffre le coût.
- Parameters : l'objet JSON des valeurs, puisque le coût dépend de ce qu'on passe.
Execute a smart contract method
contractMethods.executeCe que tu vois dans n8n
Notes & cas d'usage
Envoie la transaction. C'est l'opération d'écriture du nœud, celle qu'on teste sur une chaîne de test avant de la laisser tourner dans un workflow planifié.
Paramètres clés
- Contract Method Name or ID et Parameters : quoi appeler, et avec quelles valeurs.
- Wallet ID : le wallet utilisé pour cette exécution, quand ce n'est pas celui par défaut.
- Value : le montant de token natif envoyé avec la méthode.
- Memo : un texte libre attaché à la transaction, précieux pour la réconciliation ensuite.
- Gas Limit : c'est la plus élevée entre cette valeur et l'estimation qui sera retenue.
Execute a smart contract method as delegator
contractMethods.executeAsDelegatorCe que tu vois dans n8n
Notes & cas d'usage
Exécute une méthode sur la blockchain via une délégation ERC-7710 enregistrée, donc pour le compte d'un autre wallet. C'est la délégation qui donne le droit, et elle se désigne d'une seule façon à la fois.
Paramètres clés
- Delegation ID : le moyen le plus sûr de viser la bonne délégation.
- Delegator Wallet Address : l'adresse du wallet délégant, au lieu d'un identifiant.
- Delegation Data : un objet JSON de délégation traité comme usage unique, non conservé par 1Shot. Un seul de ces trois champs peut être rempli.
- Contract Method Name or ID et Parameters : l'appel lui-même.
Execute multiple smart contract methods
contractMethods.executeBatchCe que tu vois dans n8n
Notes & cas d'usage
Regroupe plusieurs méthodes de contrat dans une seule transaction. Une soumission, un seul coût de gas, et un choix à faire sur ce qui arrive quand un des appels échoue.
Paramètres clés
- Contract Methods : la collection d'appels, chacun avec son Contract Method Name or ID et ses Parameters.
- Wallet Name or ID : le wallet utilisé pour tout le lot.
- Atomic : activé, toutes les transactions du lot doivent réussir sous peine d'annulation complète.
- Memo et Gas Limit : le texte attaché au lot, et le plancher de gas retenu.
Execute multiple smart contract methods as delegator
contractMethods.executeAsDelegatorBatchCe que tu vois dans n8n
Notes & cas d'usage
Même logique de lot, mais en tant que délégataire. Plusieurs appels partent dans une transaction unique, pour le compte d'une adresse qui a délégué le droit d'agir.
Paramètres clés
- Contract Methods et Wallet Name or ID : les appels, et le wallet qui les soumet.
- Delegator Address, Delegation ID ou Delegation Data : un seul des trois désigne la délégation.
- Atomic : décide si un échec unique annule tout le lot.
- Authorization List : les autorisations ERC-7702 pour l'exécution du lot.
Get a smart contract method
contractMethods.getCe que tu vois dans n8n
Notes & cas d'usage
Renvoie une méthode de contrat avec ses détails enregistrés. Particularité : aucun champ n'est obligatoire ici, ce qui est rare sur ce nœud.
Paramètres clés
- Contract Method ID : l'identifiant de la méthode voulue. Il est optionnel, donc une valeur vide ne renverra rien d'exploitable plutôt que de lever une erreur.
List all smart contract methods
contractMethods.listCe que tu vois dans n8n
Notes & cas d'usage
Parcourt les méthodes de contrat déclarées, avec des filtres qui rendent le résultat exploitable. Celui sur le type de méthode est le plus rentable.
Paramètres clés
- Page Number et Page Size : obligatoires à chaque appel.
- Method Type : Read, Write, ou None pour désactiver le filtre.
- Name, Contract Address, Prompt ID, Chain Name or ID : les autres filtres optionnels.
Read data from a smart contract function
contractMethods.readCe que tu vois dans n8n
Notes & cas d'usage
Lit une fonction view ou pure du contrat. Aucune transaction, aucun gas : juste une valeur qui revient dans le workflow.
Paramètres clés
- Contract Method Name or ID : la méthode de lecture appelée.
- Parameters : l'objet JSON des arguments attendus par la fonction.
Simulate a smart contract method call
contractMethods.simulateCe que tu vois dans n8n
Notes & cas d'usage
Rejoue l'appel dans l'état actuel de la chaîne et indique s'il réussirait. À voir comme le test à blanc qu'on place devant chaque exécution réelle.
Paramètres clés
- Contract Method Name or ID et Parameters : exactement ce que recevra l'étape d'exécution.
- Gas Limit : optionnel, la limite par défaut s'applique si le champ reste vide.
Prompt
1 opérationSearch prompts
prompts.searchCe que tu vois dans n8n
Notes & cas d'usage
Lance une recherche sémantique sur les Prompts 1Shot et renvoie les outils utilisables dans un workflow dynamique. Sémantique veut dire que tu décris ce que tu cherches avec des mots, pas par nom exact.
Paramètres clés
- Query : le texte de recherche, obligatoire.
- Chain Name or ID : un filtre optionnel si une seule chaîne t'intéresse.
Transaction
2 opérationsList transactions
transactions.listCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les transactions 1Shot API sur une fenêtre de temps, avec une longue liste de filtres optionnels. Chaque appel est borné dans le temps, ce qui rend la planification sans danger.
Paramètres clés
- After Time et Before Time : les horodatages unix qui encadrent la fenêtre, obligatoires tous les deux.
- Page Number et Page Size : obligatoires également.
- Status : Pending, Submitted, Completed, Retrying, Failed, ou None.
- Wallet ID, Contract Method ID, API Credential ID, User ID, Memo, Chain Name or ID : les filtres optionnels.
Get transaction
transactions.getCe que tu vois dans n8n
Notes & cas d'usage
Ramène une transaction précise. À combiner avec une attente ou une boucle quand tu veux suivre une soumission jusqu'à ce que son statut se stabilise.
Paramètres clés
- Transaction Name or ID : l'identifiant de la transaction voulue, souvent
{{ $json.id }}repris de l'étape d'exécution.
Wallet
5 opérationsCreate wallet
wallets.createCe que tu vois dans n8n
Notes & cas d'usage
Un nouveau Wallet est créé, et il reste vide tant que tu n'y envoies pas de fonds. Le nom compte : c'est lui qui apparaîtra dans les listes déroulantes des autres opérations.
Paramètres clés
- Chain Name or ID : la chaîne à laquelle le wallet appartient, choisie dans la liste ou posée par une expression.
- Name : le nom du wallet, obligatoire.
- Description : une description optionnelle du wallet.
Delete wallet
wallets.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un Wallet. Rien d'autre n'est demandé, donc l'étape est définitive et mérite un garde-fou juste avant elle. Une opération qui pointe encore sur cet identifiant échouera à son prochain passage, donc mieux vaut nettoyer les workflows concernés dans la foulée.
Paramètres clés
- Wallet Name or ID : le wallet à supprimer, pris dans la liste ou fourni par une expression du type
{{ $json.walletId }}.
Get wallet
wallets.getCe que tu vois dans n8n
Notes & cas d'usage
Va chercher un Wallet à partir de son identifiant et renvoie ce que 1Shot conserve à son sujet. Ici le champ est une simple chaîne de caractères, pas un menu déroulant.
Paramètres clés
- Wallet Name or ID : l'identifiant du Wallet à récupérer, modifier ou supprimer, saisi directement ou construit par une expression.
List wallets
wallets.listCe que tu vois dans n8n
Notes & cas d'usage
Parcourt les Wallets d'une chaîne, page par page. Le filtre de chaîne reste optionnel : le laisser vide élargit le résultat au lieu de casser l'appel.
Paramètres clés
- Page Number et Page Size : obligatoires tous les deux.
- Chain Name or ID : un filtre optionnel sur la chaîne.
- Name : filtre les wallets par nom.
Update wallet
wallets.updateCe que tu vois dans n8n
Notes & cas d'usage
Met à jour ce que 1Shot conserve d'un Wallet existant. L'identifiant ne bouge pas, les workflows qui le référencent continuent donc de tourner.
Paramètres clés
- Wallet Name or ID : le wallet à modifier, obligatoire.
- Name : le nom du wallet, obligatoire même pour une simple retouche.
- Chain Name or ID et Description : les deux champs optionnels.
Besoin d'aide pour automatiser 1Shot API avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


