En bref
L’API de Signature Blockradar vous permet de signer cryptographiquement des messages texte, des données structurées (données typées) et des transactions brutes à l’aide des clés privées de votre portefeuille. Signez des messages pour prouver la propriété du portefeuille. Signez des transactions construites en externe (par ex., des swaps Jupiter sur Solana) sans exposer vos clés privées, et diffusez-les optionnellement sur la chaîne.
L’API de Signature Blockradar vous permet de signer cryptographiquement des messages texte, des données structurées (données typées) et des transactions brutes à l’aide des clés privées de votre portefeuille. Signez des messages pour prouver la propriété du portefeuille. Signez des transactions construites en externe (par ex., des swaps Jupiter sur Solana) sans exposer vos clés privées, et diffusez-les optionnellement sur la chaîne.
Prérequis
Avant d’utiliser l’API de Signature, assurez-vous d’avoir :1
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Accédez à Developers pour en générer une.
2
Portefeuille créé
Créez un portefeuille principal depuis le Tableau de bord Blockradar. Accédez à Wallets et créez-en un pour la blockchain souhaitée. Vous aurez besoin du
walletId pour les opérations de signature.3
Environnement
Choisissez entre Testnet (pour le développement) ou Mainnet (pour la production). Les portefeuilles sont isolés par environnement.
Comment ça fonctionne
L’API de Signature produit une signature cryptographique qui prouve que vous contrôlez une adresse de portefeuille spécifique. Le résultat signé peut être vérifié par n’importe quel tiers sans accéder à vos clés privées.Signature de message
Signez des messages texte pour prouver la propriété du portefeuille. Fonctionne sur toutes les blockchains prises en charge : EVM, Tron et Solana.
Signature de données typées
Signez des données structurées selon le standard EIP-712. Utilisé pour les approbations sans gas (EIP-2612 Permit) et les transferts autorisés (EIP-3009). EVM uniquement.
Signature de transaction
Signez des transactions brutes construites en externe. Construisez un swap sur Jupiter, un appel de contrat via ethers.js ou un transfert TronWeb, puis envoyez la transaction non signée pour la faire signer sans exposer vos clés privées.
Broadcast de transaction
Signez et diffusez une transaction brute en une seule étape. Blockradar signe la transaction et la soumet sur la chaîne via une file d’attente fiable avec des tentatives automatiques.
Cas d’utilisation courants
- Inscription auprès d’un fournisseur tiers : prouvez que vous possédez une adresse lors de l’intégration avec des services comme Iron, Circle ou d’autres protocoles DeFi
- Approbations de tokens sans gas : signez des messages EIP-2612 Permit pour autoriser la dépense de tokens sans transaction on-chain
- Transferts autorisés : signez des messages EIP-3009 TransferWithAuthorization pour des transferts délégués
- Attestations hors chaîne : créez des preuves vérifiables d’intention ou d’accord liées à une adresse de portefeuille
- Exécution de swaps externes : construisez un swap Jupiter sur Solana, signez-le avec Blockradar et diffusez-le sur la chaîne
- Interactions personnalisées avec des contrats : construisez n’importe quelle transaction en externe et laissez Blockradar la signer et/ou la soumettre
Portefeuille principal vs Adresse enfant
L’API de Signature est disponible à deux niveaux :Portefeuille principal
Signez avec les clés du portefeuille principal. Idéal pour les opérations de trésorerie et les intégrations avec des fournisseurs.
Adresse enfant
Signez avec les clés d’une adresse enfant spécifique. À utiliser lorsque le tiers exige une signature provenant d’une adresse de dépôt.
Points de terminaison
Signature de message
Signez un message texte avec la clé privée de votre portefeuille. L’API signe le message, vérifie que la signature correspond à l’adresse du portefeuille et renvoie à la fois la signature et un enregistrement de transaction.Blockchains prises en charge
Paramètres de la requête
Exemple de signature de message
Réponse EVM
Réponse Tron / Solana
Pour Tron et Solana, l’objetsignedTransaction contient uniquement le champ signature (pas de composants r, s, v) :
Champs de la réponse
Signature de données typées (EVM uniquement)
Signez des données structurées selon le standard EIP-712. Ceci est utilisé pour les approbations sans gas, les transferts délégués et d’autres flux d’autorisation on-chain nécessitant une signature structurée.Standards pris en charge
Paramètres de la requête
Exemple EIP-2612 Permit
Réponse des données typées
Champs de l’objet domaine
Signature avec une adresse enfant
Signez des messages, des données typées, des transactions ou effectuez un broadcast en utilisant une adresse enfant spécifique au lieu du portefeuille principal. Les quatre opérations de signature sont disponibles pour les adresses enfant :Événements webhook
Les opérations de signature déclenchent un webhook avec l’enregistrement de transaction :Contenu du webhook (Signature de message ou données typées)
Contenu du webhook (Signature de transaction)
Pour la signature de transaction, le champsignedTransaction est une chaîne (et non un objet). Le format dépend de la blockchain.
Contenu du webhook (Broadcast réussi)
Après que la file de broadcast confirme la transaction sur la chaîne, vous recevez ce webhook. Le champhash est mis à jour avec le hash de transaction on-chain et confirmed passe à true.
Contenu du webhook (Broadcast échoué)
Si le broadcast échoue définitivement après toutes les tentatives, vous recevez ce webhook. Lestatus est FAILED et confirmed reste à false.
Signature de transaction
Signez une transaction brute non signée construite en externe. Vous construisez la transaction à l’aide de n’importe quel SDK (ethers.js, TronWeb, Solana web3.js, Jupiter API), puis vous envoyez la transaction non signée sérialisée à Blockradar pour signature et/ou diffusion, sans avoir besoin de construire ou gérer votre propre infrastructure ou nœuds blockchain.Blockchains et formats pris en charge
Paramètres de la requête
Exemple de signature de transaction (Solana + Jupiter)
Exemple de signature de transaction (EVM)
Réponse signature seule (EVM)
Réponse signature seule (Solana)
Réponse signature seule (Tron)
Pour la signature de transaction,
signedTransaction est une chaîne, et non un objet. Ceci diffère de la signature de message qui renvoie un objet avec les composants de signature comme r, s, v.Format de signedTransaction par chaîne
Champ hash par chaîne
Broadcast de transaction
Signez et diffusez une transaction brute en une seule étape. Blockradar signe la transaction, puis la soumet sur la chaîne via une file d’attente fiable avec des tentatives automatiques. L’API renvoie immédiatement un statutPENDING. Vous recevrez un webhook signed.success ou signed.failed lorsque le résultat on-chain sera confirmé.
Requête
Mêmes paramètres que la signature de transaction :Exemple de broadcast
Réponse du broadcast (exemple Solana, immédiate)
Cycle de vie du broadcast
La transaction passe par les états suivants :Exemple de flux complet
Voici une implémentation complète pour signer un message et soumettre la signature à un fournisseur tiers :Réponses d’erreur
Portefeuille non trouvé
Portefeuille non trouvé
walletId n’existe pas ou n’appartient pas à votre entreprise.Adresse non trouvée
Adresse non trouvée
addressId n’existe pas ou n’est pas associé au portefeuille spécifié.Blockchain non prise en charge (données typées)
Blockchain non prise en charge (données typées)
Incompatibilité du Chain ID
Incompatibilité du Chain ID
chainId dans votre objet domaine de données typées ne correspond pas au réseau blockchain du portefeuille.Échec de la vérification de la signature
Échec de la vérification de la signature
Format de transaction invalide (Solana)
Format de transaction invalide (Solana)
transaction n’est pas un base64 valide, ou les octets décodés ne constituent pas une VersionedTransaction Solana valide.Format de transaction invalide (EVM/Tron)
Format de transaction invalide (EVM/Tron)
transaction n’est pas un JSON valide. Les transactions EVM et Tron doivent être des objets sérialisés en JSON.Bonnes pratiques
Sécurité
- Utilisez des références : suivez les opérations de signature avec des identifiants de référence uniques pour les pistes d’audit et l’idempotence
- Vérifiez le message : avant de signer, confirmez que le contenu du message correspond à ce que le service tiers attend
- Limitez la longueur du message : les messages sont limités à 4 096 caractères. Gardez les messages concis et spécifiques
Intégration
- Pas de frais de gas : les opérations de signature sont hors chaîne et ne nécessitent pas de solde en tokens natifs
- Réponse immédiate : les signatures sont générées de manière synchrone. Aucun polling ou attente de webhook n’est nécessaire pour la signature elle-même
- Écoutez les webhooks : utilisez les webhooks pour maintenir une piste d’audit de tous les événements de signature
Données typées
- Faites correspondre les Chain IDs : le
chainIddans votre domaine doit correspondre au réseau du portefeuille. Utilisez les Chain IDs sandbox (testnet) pour les tests et les Chain IDs de production (mainnet) pour les opérations en direct - Vérifiez le contrat : le
verifyingContractdoit être le contrat qui vérifiera la signature on-chain
Signature de transaction
- Construisez la transaction avec le bon expéditeur : la transaction non signée doit utiliser la clé publique du portefeuille ou de l’adresse enfant comme payeur de frais (Solana) ou expéditeur (EVM/Tron). Si la clé ne correspond pas, la signature échouera.
- Les blockhashes Solana expirent rapidement : les blockhashes Solana sont valides pendant environ 60 à 90 secondes. Construisez la transaction et appelez le endpoint de signature rapidement. En cas de broadcast, les tentatives de la file d’attente ne seront pas efficaces une fois le blockhash expiré.
- Gestion du nonce EVM : définissez le nonce correctement. Si le nonce est déjà utilisé, le broadcast échouera. Interrogez le nonce depuis la chaîne juste avant de construire la transaction.
- Expiration Tron : les transactions Tron ont une fenêtre d’expiration de 24 heures définie lors de la construction. Cela laisse amplement le temps pour la signature et le broadcast.
- Signature seule vs broadcast : utilisez
/signing/transactionlorsque vous souhaitez diffuser la transaction vous-même ou via un autre service. Utilisez/signing/broadcastlorsque vous souhaitez que Blockradar gère la soumission avec des tentatives automatiques.

