Passer au contenu principal
En resume
Pour exploiter l’infrastructure de portefeuilles de Blockradar et permettre des depots et paiements fluides pour vos clients, vous devez creer au moins un portefeuille principal.
Wallets Home

​
Introduction

Les portefeuilles principaux sont le pilier de la plupart des actions que vous pouvez effectuer avec l’API Blockradar. Ces portefeuilles vous permettent de gerer les depots de stablecoins sur plusieurs blockchains prises en charge par Blockradar. Pour consulter la liste des blockchains et actifs pris en charge sur Blockradar. Lorsque vous creez un portefeuille principal pour une blockchain specifique, il vous permet de gerer tout ce qui concerne cette blockchain avec le portefeuille principal :
  1. Generer des adresses dediees pour que vos clients les utilisent pour deposer des stablecoins sur plusieurs blockchains.
  2. Ajouter a la liste blanche des adresses gerees en externe pour la surveillance des depots de stablecoins.
  3. Balayage automatique : chaque stablecoin depose dans l’une des adresses dediees est automatiquement balaye vers le portefeuille principal.
  4. Retraits : vous pouvez facilement initier des retraits de stablecoins depuis l’adresse du portefeuille principal vers une adresse externe.

​
Creer un Portefeuille

La creation d’un portefeuille principal necessite quatre etapes :
  1. Selectionnez la blockchain pour laquelle vous souhaitez creer le portefeuille.
  2. Ajoutez les stablecoins que vous souhaitez que ce portefeuille principal prenne en charge.
  3. Configurez l’URL du webhook de votre portefeuille. Cela sera utilise pour les notifications et la synchronisation des donnees lorsque des stablecoins sont deposes dans l’une des adresses dediees generees via ce portefeuille.
  4. Alimentez le portefeuille principal. Pour activer le balayage automatique des stablecoins des adresses dediees vers le portefeuille principal et les retraits vers des adresses externes, vous devez maintenir un solde de l’actif natif sur la blockchain dans ce portefeuille principal.
Une adresse dediee generee via l’un de ces portefeuilles principaux peut etre utilisee pour recevoir des depots sur tous les autres portefeuilles principaux de blockchain, a condition que les blockchains aient isEvmCompatible: true.Cela signifie que vous pouvez attribuer a vos clients une seule adresse unique qui peut etre utilisee pour deposer des stablecoins sur plusieurs blockchains, sans vous soucier qu’ils envoient des stablecoins sur la mauvaise blockchain.

​
Creer un Portefeuille Principal

Pour creer un portefeuille principal, allez sur le tableau de bord, naviguez vers la section des portefeuilles et creez un portefeuille pour commencer a construire une experience fluide pour vos clients. Le tableau de bord Blockradar fournit une interface simple et conviviale pour generer des portefeuilles principaux. Create Wallet
Cette capture d’ecran demontre le processus de generation d’un nouveau portefeuille principal via le tableau de bord Blockradar. Cette methode est ideale pour la creation manuelle d’adresses ou pour les equipes qui preferent une interface graphique.
Environnement
Les portefeuilles crees dans l’environnement de production sont isoles de cet environnement. Il en va de meme pour les portefeuilles crees dans l’environnement de test, y compris les adresses dediees creees pour vos clients.

​
Configurations du Portefeuille

Les portefeuilles principaux Blockradar prennent en charge deux options de configuration cles pour vous aider a gerer les fonds et l’experience utilisateur : Balayage Automatique et Transactions Sans Gas.

​
Balayage Automatique

Activer Lorsqu’il est active, les fonds deposes aux adresses sous ce portefeuille seront automatiquement balayes (transferes) vers le portefeuille principal. Cela aide a consolider les soldes, ameliore la securite et simplifie la gestion des fonds. Seuil Definissez le solde minimum requis pour chaque adresse enfant afin de declencher le balayage automatique. Si laisse vide, tout montant recu declenchera un balayage automatique. Cela vous permet de controler la frequence du balayage et d’optimiser les frais de gas.
  • Parametre par defaut : Par defaut, le balayage automatique est defini sur true et le seuil est 0
  • Remplacement d’adresse : Lors de la generation ou de la mise a jour d’une adresse, vous pouvez remplacer a la fois le parametre d’activation/desactivation du balayage automatique et le seuil pour cette adresse specifique.
Les parametres auto-sweeping et threshold au niveau des adresses remplaceront la configuration du portefeuille principal pour cette adresse. Cela permet un controle granulaire du comportement du balayage automatique par adresse.
Bonne Pratique : Activez le balayage automatique et definissez un seuil approprie pour equilibrer entre la consolidation opportune des fonds et la minimisation des frais de transaction. Auto Sweeping

​
Transactions Sans Gas

Configurez quand le portefeuille principal doit couvrir les frais de gas pour les retraits depuis les adresses enfants. Activer les Retraits Sans Gas Lorsqu’ils sont actives, les frais de gas pour les retraits qualifies seront payes par le portefeuille principal, offrant une experience fluide a vos utilisateurs. Parametres de Seuil Definissez le seuil de montant pour les retraits sans gas. Seules les transactions qui atteignent ce seuil auront leurs frais de gas couverts par le portefeuille principal. Vous pouvez specifier la logique de seuil en utilisant des operateurs arithmetiques :
OperateurDescriptionExemple (Seuil = 100)
gtSuperieur aUniquement les retraits > 100
gteSuperieur ou egal aUniquement les retraits >= 100
ltInferieur aUniquement les retraits < 100
lteInferieur ou egal aUniquement les retraits <= 100
eqEgal aUniquement les retraits = 100
  • Parametre par defaut : La transaction sans gas est definie sur false par defaut et les parametres de seuil sont definis sur 0.
  • Remplacement d’adresse : Lors de la generation ou de la mise a jour d’une adresse, vous pouvez remplacer a la fois les parametres d’activation/desactivation et de seuil pour les transactions sans gas pour cette adresse specifique.
Les parametres d’activation de transaction sans gas et de seuil au niveau des adresses remplaceront la configuration du portefeuille principal pour cette adresse. Cela permet un controle granulaire du comportement des retraits sans gas par adresse.
Bonne Pratique : Activez les retraits sans gas et definissez une logique de seuil appropriee pour equilibrer l’experience utilisateur et les couts operationnels.
  • Definissez les configurations au niveau du portefeuille selon vos besoins commerciaux et vos exigences de securite.
  • Utilisez les remplacements au niveau de l’adresse uniquement lorsque vous avez besoin d’un comportement different pour des adresses specifiques.
Gasless Transaction

​
Financement

Le financement d’un portefeuille principal est essentiel pour payer les frais de gas sur la blockchain lors du balayage automatique des stablecoins des adresses dediees vers le portefeuille principal et pour les retraits vers des portefeuilles externes.

​
Environnement de Test

  • Ethereum : Obtenez des ETH de test ici : Alchemy ou Infura
  • Binance Smart Chain : Obtenez des BNB de test ici : Faucet
  • Polygon : Obtenez des MATIC de test ici : Polygon PoS (Amoy)
  • Base : Obtenez des ETH de test ici : Alchemy
  • Optimism : Obtenez des ETH de test ici : Alchemy
  • Arbitrum : Obtenez des ETH de test ici : Alchemy
  • Tron : Obtenez des TRX de test ici : Faucet
  • Solana : Obtenez des SOL de test ici : Faucet
  • Celo : Obtenez des CELO de test ici : Faucet

​
Environnement de Production

Pour l’environnement de production, vous pouvez envoyer des actifs depuis n’importe quel portefeuille ou exchange qui prend en charge les actifs natifs sur chacune des blockchains.
Balayage
Assurez-vous toujours d’avoir suffisamment de solde dans votre portefeuille principal pour eviter les retards dans le balayage automatique ou les retraits. Nous vous avertirons lorsque le solde de votre portefeuille principal est faible.

​
Frais de Gas : Environnement de Test vs Production

Comprendre les differences de frais de gas entre les environnements de test et de production est crucial pour un developpement et un deploiement efficaces.

​
Frais de Gas de Test

Dans l’environnement de test, les frais de gas sont minimes. Les testnets sont concus pour simuler l’environnement mainnet sans les couts reels associes. Par consequent, de petites quantites de jetons de gas dans un testnet peuvent etre utilisees pendant une periode prolongee. Cela permet aux developpeurs de tester et d’iterer leur integration sans engager de depenses significatives.

​
Frais de Gas de Production

Dans un environnement de production, les frais de gas representent des depenses reelles. Ces couts peuvent varier considerablement en fonction de la blockchain et de la congestion du reseau. Estimer et gerer correctement les frais de gas est essentiel pour assurer le bon fonctionnement de vos applications et eviter des couts excessifs. En exploitant les testnets pour le developpement et les tests, vous pouvez minimiser les depenses et vous assurer que vos solutions sont robustes avant de les deployer sur le mainnet.

​
Recherche de Depots

Dans de rares cas, vous pourriez ne pas recevoir de webhook de notre systeme apres qu’un client a envoye des stablecoins a l’une des adresses qui lui ont ete attribuees. Nous avons un mecanisme de recherche de depots integre en interne, mais vous avez egalement la possibilite de declencher une nouvelle analyse de la blockchain pour une transaction manquante en utilisant l’API de Recherche de Depots en fournissant le transactionHash 
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{id}/rescan/blocks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "transactionHash": "string<TRANSACTION_HASH_OPTIONAL>"
}'
Parametres du corps
Le parametre requis est transactionHash, qui peut etre obtenu soit a partir de l’enregistrement de transaction original, soit en recherchant la transaction sur l’explorateur de blockchain.


Bon codage !