Introduction
Les Reglements Automatiques vous permettent de convertir automatiquement les depots entrants en n’importe quel actif de destination sur n’importe quel reseau blockchain en fonction de vos regles configurees. Cela elimine le besoin d’echanger ou de bridger manuellement les actifs, garantissant que votre tresorerie peut etre automatiquement convertie vers vos actifs preferes sur plusieurs chaines.
Gestion des Regles Creez et gerez des regles de reglement automatique pour automatiser les conversions d’actifs.
Conversion d'Actifs Convertissez automatiquement n’importe quel stablecoin en n’importe quel autre actif en fonction de vos regles.
Cross-Chain Reglez les actifs vers n’importe quel reseau blockchain de maniere fluide.
Gestion des Risques Appliquez une tolerance au slippage et des regles pour vous proteger contre les mauvaises executions.
1. Creation de Regle
Definissez des regles de reglement qui specifient quand et comment les depots doivent etre automatiquement convertis.
2. Detection de Depot
Lorsque des fonds arrivent a vos adresses, Blockradar detecte automatiquement les depots correspondant a vos regles.
3. Conversion d’Actifs
Les depots sont automatiquement echanges vers votre actif de destination (typiquement USDC) sur la chaine de votre choix.
4. Unification du Solde
Tous les actifs convertis sont consolides dans un solde unique et unifie sur votre chaine de destination.
Regles de Reglement Automatique
Composants de Regle
Chaque regle de reglement automatique definit les parametres suivants :
Composant Description Exemple Nom de la Regle Nom descriptif pour votre regle de reglement ”Swap from USDC to Optimism USDC” Ordre Preference de priorite d’execution FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE Tolerance au Slippage Deviation de prix maximum acceptable (%) 5 Actifs Sources Tableau d’actifs a regler automatiquement [“USDC”, “USDT”] Montant Min/Max Source Controler la taille du depot qui declenche le reglement Min: 1 , M a x : 1, Max: 1 , M a x : 1,000 Blockchain de Destination Reseau blockchain cible optimism, base, ethereum Actif de Destination Actif cible pour la conversion USDC, USDT, cNGN, DAI Adresse de Destination Adresse specifique pour recevoir les actifs convertis 0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22 Is Gateway Activer la fonctionnalite gateway pour la regle false
Options de Configuration des Regles
Seuils de Montant
Montant Minimum : Regler uniquement les depots au-dessus de ce seuil
Montant Maximum : Plafonner la taille des reglements individuels
Traitement par Lots : Regrouper plusieurs petits depots pour l’efficacite
Protection contre le Slippage
Conservateur : 0.1% - 0.5% (impact de prix minimal)
Modere : 0.5% - 1.0% (approche equilibree)
Agressif : 1.0% - 2.0% (execution plus rapide)
Preferences d’Execution
Plus rapide : Prioriser la vitesse sur le cout
Moins cher : Optimiser pour les frais les plus bas
Recommande : Equilibrer vitesse et cout avec fiabilite
Sans Slippage : Executer uniquement lorsqu’aucune deviation de prix ne se produit
Hierarchie et Precedence des Regles
Ordre d’Application des Regles
Regles d’Adresse Enfant : Appliquees en premier si elles existent
Regles du Portefeuille Principal : Appliquees en secours si pas de regles d’adresse enfant
Comportement par Defaut : Pas de reglement automatique si aucune regle n’est configuree
Comportement de Remplacement
Remplacement Adresse Enfant : Les regles specifiques a l’adresse remplacent completement les regles du portefeuille principal
Pas d’Heritage : Les adresses enfants n’heritent pas des regles du portefeuille principal quand elles ont les leurs
Configuration Independante : Chaque niveau peut avoir des strategies de reglement completement differentes
Cas d’Utilisation pour Chaque Niveau
Regles du Portefeuille Principal
Strategie Coherente : Meme comportement de reglement sur toutes les adresses
Gestion Simplifiee : Un seul endroit pour configurer le comportement par defaut
Operations en Masse : Appliquer des regles a plusieurs adresses a la fois
Standardisation : Assurer la conformite et la coherence
Regles d’Adresse Enfant
Tests : Essayer differentes strategies de reglement sur des adresses specifiques
Exigences Personnalisees : Besoins de reglement specifiques a l’adresse
Remplacer les Defauts : Modifier le comportement pour des cas d’utilisation particuliers
Controle Granulaire : Affiner le reglement pour des adresses specifiques
Creation des Regles de Reglement Automatique
Via le Tableau de Bord
Naviguez vers la section Reglements Automatiques de votre portefeuille
Cliquez sur “Creer une Nouvelle Regle”
Configurez les parametres de la regle
Definissez les seuils de montant et la tolerance au slippage
Choisissez les actifs/chaines source et destination
Sauvegardez et activez la regle
Via l’API
Creez des regles de reglement de maniere programmatique en utilisant l’API des Regles de Reglement Automatique :
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"name": "Swap from USDC to Optimism USDC",
"order": "FASTEST",
"slippageTolerance": "5",
"source": {
"assets": [
"USDC",
"USDT"
],
"minAmount": "1",
"maxAmount": "1000"
},
"destination": {
"blockchain": "optimism",
"asset": "USDC",
"address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
}
}'
Cas d’Utilisation
Gestion de Tresorerie
Conversion d’Actifs Flexible : Convertir vers n’importe quel actif prefere (USDC, ETH, USDT, etc.)
Operations Cross-Chain : Maintenir des soldes sur plusieurs reseaux
Consolidation Automatisee : Aucune intervention manuelle requise
Strategie Multi-Actifs : Supporter diverses preferences et strategies d’actifs
Operations Commerciales
Traitement des Paiements : Regler automatiquement les paiements entrants vers les actifs preferes
Gestion des Revenus : Convertir divers stablecoins vers votre actif de destination choisi
Attenuation des Risques : Appliquer automatiquement la protection contre le slippage
Diversification des Actifs : Maintenir automatiquement les allocations d’actifs cibles
Integration DeFi
Yield Farming : Regler automatiquement les recompenses vers l’actif prefere
Gestion de Liquidite : Consolider les recompenses et frais LP
Reequilibrage de Portefeuille : Maintenir les allocations d’actifs cibles
Bonnes Pratiques
Configuration des Regles
Commencez Conservateur : Commencez avec une faible tolerance au slippage
Surveillez les Performances : Suivez les taux de succes des reglements
Ajustez Graduellement : Affinez les regles en fonction des conditions du marche
Testez sur Testnet : Validez les regles avant le deploiement mainnet
Gestion des Risques
Limites de Slippage : Definissez des niveaux de tolerance appropries
Plafonds de Montant : Limitez les tailles maximales de reglement
Selection de Reseau : Choisissez des chaines de destination fiables
Regles de Secours : Creez des options de reglement de secours
Efficacite Operationnelle
Traitement par Lots : Regroupez les petits depots pour l’efficacite
Optimisation du Timing : Considerez les modeles de congestion du reseau
Analyse des Couts : Equilibrez les preferences vitesse vs cout
Surveillance : Configurez des alertes pour les reglements echoues
Surveillance et Alertes
Surveillance du Tableau de Bord
Statut des Regles : Indicateurs de regles actives/inactives
Historique des Reglements : Suivez les reglements reussis et echoues
Metriques de Performance : Taux de succes et temps d’execution
Soldes des Actifs : Surveillez la croissance du solde unifie
Notifications Webhook
Les reglements automatiques declenchent des evenements webhook lorsque les reglements sont executes :
Evenement Description swap.successLe swap de reglement automatique a ete execute avec succes swap.failedLe swap de reglement automatique a echoue
Exemple de Payload Webhook
{
"event" : "swap.success" ,
"data" : {
"id" : "99a2b490-0798-460b-9265-4d99f182fe52" ,
"reference" : "ZMxcorDGtf" ,
"senderAddress" : "0xAA2d5fd5e7bE97E214f8565DCf3a4862719960b5" ,
"recipientAddress" : "0xb55c054D8eE75224E1033e6eC775B4F62D942b43" ,
"amount" : "5" ,
"status" : "SUCCESS" ,
"type" : "SWAP" ,
"network" : "mainnet" ,
"toAmount" : "4.965398" ,
"rate" : "0.9930796000000001" ,
"asset" : {
"name" : "USD Coin" ,
"symbol" : "USDC" ,
"network" : "mainnet"
},
"toAsset" : {
"name" : "Tether USD" ,
"symbol" : "USDT" ,
"network" : "mainnet"
},
"toBlockchain" : {
"name" : "optimism" ,
"slug" : "optimism"
},
"toWallet" : {
"name" : "Optimism Mainnet Wallet" ,
"address" : "0xb55c054D8eE75224E1033e6eC775B4F62D942b43"
},
"metadata" : {
"swapAutoSettlement" : {
"rule" : {
"id" : "rule-id-123" ,
"name" : "USDT to USDC on Base" ,
"order" : "RECOMMENDED" ,
"slippageTolerance" : 5 ,
"source" : {
"assets" : [ "USDC" , "USDT" ],
"minAmount" : "1" ,
"maxAmount" : "1000"
},
"destination" : {
"blockchain" : "optimism" ,
"asset" : "USDC" ,
"address" : "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
}
},
"settleAmount" : "5"
},
"transactionId" : "transaction-id"
}
}
}
Distinguer les Reglements Automatiques des Swaps Reguliers
Le payload webhook inclut des metadonnees qui aident a identifier les transactions de reglement automatique :
Champ Description metadata.swapAutoSettlement.rulePayload complet de la regle de reglement automatique qui a declenche ce swap metadata.swapAutoSettlement.settleAmountMontant qui a ete regle selon la regle metadata.transactionIdID de transaction interne pour le suivi
Lorsque metadata.swapAutoSettlement est present, le swap a ete declenche par une regle de reglement automatique. Le champ rule contient la configuration complete de la regle, pas seulement un ID.
Champs Cles des Donnees Webhook
Champ Description toAmountMontant final recu apres le swap (tenant compte des frais et du slippage) rateTaux de change utilise pour le swap toAssetDetails de l’actif de destination (USDT dans cet exemple) toBlockchainReseau blockchain de destination (Optimism dans cet exemple) toWalletPortefeuille de destination qui a recu les actifs convertis assetSweptSi les actifs originaux ont ete balayes apres la conversion
Reference API
Endpoints
Reglements Automatiques du Portefeuille Principal
Endpoint Methode Description Reference API /v1/wallets/{walletId}/auto-settlements/rulesGET Lister toutes les regles de reglement pour le portefeuille principal Obtenir Toutes les Regles /v1/wallets/{walletId}/auto-settlements/rulesPOST Creer une nouvelle regle de reglement pour le portefeuille principal Creer une Regle /v1/wallets/{walletId}/auto-settlements/rules/{id}GET Obtenir les details d’une regle specifique du portefeuille principal Obtenir une Regle /v1/wallets/{walletId}/auto-settlements/rules/{id}PATCH Mettre a jour une regle existante du portefeuille principal Mettre a Jour une Regle /v1/wallets/{walletId}/auto-settlements/rules/{id}DELETE Supprimer une regle de reglement du portefeuille principal Supprimer une Regle /v1/wallets/{walletId}/auto-settlementsGET Obtenir l’historique des reglements du portefeuille principal Obtenir le Reglement /v1/wallets/{walletId}/auto-settlementsPATCH Mettre a jour les parametres de reglement du portefeuille principal Mettre a Jour le Reglement
Reglements Automatiques de l’Adresse Enfant
Endpoint Methode Description Reference API /v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesGET Lister toutes les regles de reglement pour une adresse specifique Obtenir Toutes les Regles /v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesPOST Creer une nouvelle regle de reglement pour une adresse specifique Creer une Regle /v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}GET Obtenir les details d’une regle specifique d’adresse Obtenir une Regle /v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}PATCH Mettre a jour une regle existante d’adresse Mettre a Jour une Regle /v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}DELETE Supprimer une regle de reglement d’adresse Supprimer une Regle /v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsGET Obtenir l’historique des reglements d’adresse Obtenir le Reglement /v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsPATCH Mettre a jour les parametres de reglement d’adresse Mettre a Jour le Reglement
Parametres de Regle
Parametre Type Requis Description namestring Oui Nom de la regle pour l’identification orderstring Oui Priorite d’execution (FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE) slippageTolerancenumber Oui Slippage maximum acceptable (%) isGatewayboolean false Activer la fonctionnalite gateway pour la regle source.assetsarray Oui Tableau d’actifs source a regler automatiquement source.minAmountstring Non Montant minimum pour declencher le reglement source.maxAmountstring Non Montant maximum par reglement destination.blockchainstring Oui Reseau blockchain cible destination.assetstring Oui Actif cible pour la conversion destination.addressstring Oui Adresse de destination pour recevoir les actifs convertis
Pour Commencer
1. Activer les Reglements Automatiques
Naviguez vers les parametres de votre portefeuille
Activez la fonctionnalite de reglement automatique
Configurez les preferences par defaut
2. Creez Votre Premiere Regle
Commencez avec une simple regle USDT vers ETH (ou n’importe quel actif que vous preferez)
Definissez une tolerance au slippage conservatrice
Choisissez votre chaine et actif de destination preferes
3. Testez et Surveillez
Deployez d’abord sur testnet
Surveillez les taux de succes des reglements
Ajustez les parametres selon les besoins
4. Evoluez Graduellement
Ajoutez des regles pour des actifs supplementaires
Implementez le traitement par lots
Optimisez pour votre cas d’utilisation
Support et Ressources
Obtenir de l’Aide
Les reglements automatiques sont un moyen puissant d’automatiser la gestion de votre tresorerie. Commencez avec des regles simples et ajoutez progressivement de la complexite a mesure que vous vous familiarisez avec le systeme.