Passer au contenu principal
Auto Settlements

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.

Comment Fonctionnent les Reglements Automatiques

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 :
ComposantDescriptionExemple
Nom de la RegleNom descriptif pour votre regle de reglement”Swap from USDC to Optimism USDC”
OrdrePreference de priorite d’executionFASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE
Tolerance au SlippageDeviation de prix maximum acceptable (%)5
Actifs SourcesTableau d’actifs a regler automatiquement[“USDC”, “USDT”]
Montant Min/Max SourceControler la taille du depot qui declenche le reglementMin: 1,Max:1, Max: 1,000
Blockchain de DestinationReseau blockchain cibleoptimism, base, ethereum
Actif de DestinationActif cible pour la conversionUSDC, USDT, cNGN, DAI
Adresse de DestinationAdresse specifique pour recevoir les actifs convertis0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22
Is GatewayActiver la fonctionnalite gateway pour la reglefalse

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

  1. Regles d’Adresse Enfant : Appliquees en premier si elles existent
  2. Regles du Portefeuille Principal : Appliquees en secours si pas de regles d’adresse enfant
  3. 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

  1. Naviguez vers la section Reglements Automatiques de votre portefeuille
  2. Cliquez sur “Creer une Nouvelle Regle”
  3. Configurez les parametres de la regle
  4. Definissez les seuils de montant et la tolerance au slippage
  5. Choisissez les actifs/chaines source et destination
  6. 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 :
EvenementDescription
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 :
ChampDescription
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

ChampDescription
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

EndpointMethodeDescriptionReference API
/v1/wallets/{walletId}/auto-settlements/rulesGETLister toutes les regles de reglement pour le portefeuille principalObtenir Toutes les Regles
/v1/wallets/{walletId}/auto-settlements/rulesPOSTCreer une nouvelle regle de reglement pour le portefeuille principalCreer une Regle
/v1/wallets/{walletId}/auto-settlements/rules/{id}GETObtenir les details d’une regle specifique du portefeuille principalObtenir une Regle
/v1/wallets/{walletId}/auto-settlements/rules/{id}PATCHMettre a jour une regle existante du portefeuille principalMettre a Jour une Regle
/v1/wallets/{walletId}/auto-settlements/rules/{id}DELETESupprimer une regle de reglement du portefeuille principalSupprimer une Regle
/v1/wallets/{walletId}/auto-settlementsGETObtenir l’historique des reglements du portefeuille principalObtenir le Reglement
/v1/wallets/{walletId}/auto-settlementsPATCHMettre a jour les parametres de reglement du portefeuille principalMettre a Jour le Reglement

Reglements Automatiques de l’Adresse Enfant

EndpointMethodeDescriptionReference API
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesGETLister toutes les regles de reglement pour une adresse specifiqueObtenir Toutes les Regles
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesPOSTCreer une nouvelle regle de reglement pour une adresse specifiqueCreer une Regle
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}GETObtenir les details d’une regle specifique d’adresseObtenir une Regle
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}PATCHMettre a jour une regle existante d’adresseMettre a Jour une Regle
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}DELETESupprimer une regle de reglement d’adresseSupprimer une Regle
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsGETObtenir l’historique des reglements d’adresseObtenir le Reglement
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsPATCHMettre a jour les parametres de reglement d’adresseMettre a Jour le Reglement

Parametres de Regle

ParametreTypeRequisDescription
namestringOuiNom de la regle pour l’identification
orderstringOuiPriorite d’execution (FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE)
slippageTolerancenumberOuiSlippage maximum acceptable (%)
isGatewaybooleanfalseActiver la fonctionnalite gateway pour la regle
source.assetsarrayOuiTableau d’actifs source a regler automatiquement
source.minAmountstringNonMontant minimum pour declencher le reglement
source.maxAmountstringNonMontant maximum par reglement
destination.blockchainstringOuiReseau blockchain cible
destination.assetstringOuiActif cible pour la conversion
destination.addressstringOuiAdresse 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.