Reglements Automatiques

​

Prerequis

​

Comment Ca Fonctionne

​

Comment Fonctionnent les Reglements Automatiques

​

1. Creation de Regle

​

2. Detection de Depot

​

3. Conversion d’Actifs

​

4. Unification du Solde

​

Regles de Reglement Automatique

​

Composants de Regle

​

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

• Illimite : -1 (pas de limite de slippage - comportement par defaut)
• Conservateur : 0.1% - 0.5% (impact de prix minimal)
• Modere : 0.5% - 1.0% (approche equilibree)
• Agressif : 1.0% - 2.0% (execution plus rapide)

​

Adresse de Destination (Optionnel)

​

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

​

Comment les Regles s’Appliquent

​

Ordre d’Application des Regles

1. Verifier les Regles d’Adresse Enfant : Si l’adresse receptrice a ses propres regles, utiliser celles-ci exclusivement
2. Se Rabattre sur les Regles du Portefeuille Principal : Si aucune regle d’adresse enfant n’existe, appliquer les regles du portefeuille principal
3. Pas de Regles : Si aucun niveau n’a de regles configurees, aucun reglement automatique ne se produit

​

Regles Specifiques par Blockchain

• Vous devez creer des regles separees pour chaque blockchain source que vous souhaitez regler automatiquement
• Une regle pour “USDC sur Ethereum” ne se declenchera pas pour “USDC sur Base”
• Cela permet un controle granulaire sur le comportement de reglement par chaine

1. Regle pour Ethereum USDC → Optimism USDC
2. Regle pour Base USDC → Optimism USDC

​

Cas d’Utilisation pour Chaque Niveau

​

Regles du Portefeuille Principal

• Strategie Coherente : Meme comportement de reglement sur toutes les adresses enfants
• 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

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": "-1",
    "source": {
        "assets": [
            "USDC",
            "USDT"
        ],
        "minAmount": "1",
        "maxAmount": "1000"
    },
    "destination": {
        "blockchain": "optimism",
        "asset": "USDC"
    }
}'

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

​

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

​

Champs Cles des Donnees Webhook

​

Reference API

​

Endpoints

​

Reglements Automatiques du Portefeuille Principal

​

Reglements Automatiques de l’Adresse Enfant

​

Parametres de Regle

​

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

• Email : [email protected]
• Reference API : Regles de Reglement Automatique
• Documentation : Configuration Gateway