Passer au contenu principal
Addresses

​
Introduction

Les adresses dediees sont une fonctionnalite cruciale sur Blockradar qui vous permet de creer des adresses uniques pour vos clients. Ces adresses permettent a vos clients de deposer des stablecoins dans votre application fintech de maniere fluide. Lorsque vous creez une adresse dediee pour un client, il peut utiliser cette seule adresse pour deposer des stablecoins sur plusieurs blockchains compatibles EVM. Par exemple, si vous avez des portefeuilles principaux Ethereum, Binance Smart Chain, Polygon et Base crees, chaque adresse que vous generez via l’un de ces portefeuilles principaux peut etre utilisee pour recevoir des stablecoins sur n’importe laquelle des blockchains et actifs pris en charge. Cela garantit que vous n’avez pas a vous soucier que votre client envoie des stablecoins sur la mauvaise blockchain. De plus, lorsque des stablecoins sont deposes dans une adresse particuliere, les actifs sont automatiquement deplaces vers l’adresse du portefeuille principal de la chaine.
A part Tron et Solana, les adresses generees a partir d’un portefeuille peuvent etre utilisees pour deposer des stablecoins sur d’autres blockchains qui ont le parametre de blockchain isEvmCompatible: true.

​
Explication des Parametres d’Adresse

Lors de la creation ou de la mise a jour d’une adresse, vous pouvez utiliser les parametres optionnels suivants pour personnaliser son comportement :
ParametreTypeDefautDescription
disableAutoSweepBoolean (Optionnel)falseSi defini sur true, le balayage automatique des fonds depuis cette adresse est desactive.
enableGaslessWithdrawBoolean (Optionnel)falseSi defini sur true, permet les retraits sans que l’utilisateur ait a payer directement les frais de gas.
metadataObject (Optionnel)nullMetadonnees personnalisees que vous pouvez attacher a l’adresse pour votre propre reference ou suivi.
nameString (Optionnel)nullUn nom lisible pour l’adresse, utile pour l’identification dans votre tableau de bord ou logs.
showPrivateKeyBoolean (Optionnel)falseSi defini sur true, la cle privee de cette adresse sera retournee dans la reponse de l’API. A utiliser avec precaution.
Les parametres disableAutoSweep, enableGaslessWithdraw et showPrivateKey remplaceront les parametres correspondants dans la configuration du portefeuille principal pour cette adresse specifique. Cela permet un controle granulaire au niveau de l’adresse, independamment des parametres par defaut du portefeuille.
Notes :
  • Tous ces parametres sont optionnels ; vous n’avez besoin d’inclure que ceux pertinents pour votre cas d’utilisation.
  • L’activation de showPrivateKey peut exposer des informations sensibles. N’utilisez cela que dans des environnements securises et de confiance.
  • Soyez prudent avec showPrivateKey car l’exposition des cles privees peut compromettre la securite.

​
Creer une Adresse Dediee

Vous pouvez generer une adresse dediee pour votre client en utilisant soit le tableau de bord Blockradar, soit l’API, selon votre flux de travail et vos besoins d’integration.

​
1. Utilisation du Tableau de Bord

Le tableau de bord Blockradar fournit une interface simple et conviviale pour generer de nouvelles adresses. Generate address
Cette capture d’ecran demontre le processus de generation d’une nouvelle adresse 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.

​
2. Utilisation de l’API

Pour la generation d’adresses programmatique ou automatisee, vous pouvez utiliser l’API de Creation d’Adresse Dediee. Cela est utile pour integrer la creation d’adresses dans vos propres applications ou systemes backend. Pour creer une adresse dediee pour un client, envoyez une requete POST a notre API de Creation d’Adresse Dediee. 
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "disableAutoSweep": "OPTIONAL_BOOLEAN",
  "enableGaslessWithdraw": "OPTIONAL_BOOLEAN",
  "metadata": "OPTIONAL_METADATA",
  "name": "OPTIONAL_ADDRESS_NAME",
  "showPrivateKey": "OPTIONAL_BOOLEAN"
}'

​
Reponse

{
  "data": {
    "address": "0xe1037B45b48390285e5067424053fa35c478296b",
    "blockchain": {
      "createdAt": "2024-05-14T11:53:33.095Z",
      "derivationPath": "m/44'/60'/0'/0",
      "id": "85ffc132-3972-4c9e-99a5-5cf0ccb688bf",
      "isActive": true,
      "isEvmCompatible": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png",
      "name": "ethereum",
      "slug": "ethereum",
      "symbol": "eth",
      "tokenStandard": "ERC20",
      "updatedAt": "2024-06-14T22:32:11.983Z"
    },
    "configurations": {
      "aml": {
        "message": "Address is not sanctioned",
        "provider": "ofac",
        "status": "success"
      },
      "disableAutoSweep": false,
      "enableGaslessWithdraw": false,
      "showPrivateKey": false
    },
    "createdAt": "2024-10-23T11:13:40.446Z",
    "derivationPath": "m/44'/60'/0'/0/87",
    "id": "0a69c48a-6c6f-422c-bd6a-70de3306a3ac",
    "isActive": true,
    "metadata": {
      "user_id": 1
    },
    "name": "Customer 1",
    "network": "testnet",
    "type": "INTERNAL",
    "updatedAt": "2024-10-23T11:13:40.446Z"
  },
  "message": "Address generated successfully",
  "statusCode": 200
}

​
Liste Blanche d’Adresses

Cette fonctionnalite vous permet d’ajouter une adresse externe a la liste blanche pour etre surveillee en fonction des exigences du portefeuille. Cela signifie que si vous gerez votre propre generation d’adresses, vous pouvez toujours utiliser Blockradar pour surveiller les depots effectues sur cette adresse.

​
Parametres du Corps

CleRequisTypeDescription
namefalsestringLe nom de l’adresse.
addresstruestringL’adresse du portefeuille.
metadatafalseobjectMetadonnees supplementaires pour l’adresse. Cela fera partie de toute transaction liee a celle-ci.
showPrivateKeyfalsebooleanSi vous voulez que la cle privee de l’adresse fasse partie de la reponse.
disableAutoSweepfalsebooleanDesactiver le balayage automatique des actifs envoyes a l’adresse vers votre portefeuille principal.
enableGaslessWithdrawfalsebooleanActiver les transactions sans gas depuis cette adresse.
privateKeyfalsestringLa cle privee associee a l’adresse. Requise pour executer des actions de maniere securisee.
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses/whitelist \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "address": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
  "name": "Whitelisted Address",
  "metadata": {"purpose": "external_monitoring", "source": "manual"},
  "showPrivateKey": false,
  "disableAutoSweep": false,
  "enableGaslessWithdraw": true,
  "privateKey": "0x1234567890abcdef..."
}'

​
Reponse

{
  "data": {
    "address": "0x3375154fa32Cb434B044E73a2582C4D2E6518AE4",
    "blockchain": {
      "createdAt": "2024-05-27T08:31:14.966Z",
      "derivationPath": "m/44'/60'/0'/0",
      "id": "74733889-4ecd-403e-9840-94e87c043f24",
      "isActive": true,
      "isEvmCompatible": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/Base_Network_Logo_vqyh7r.png",
      "name": "base",
      "slug": "base",
      "symbol": "eth",
      "tokenStandard": null,
      "updatedAt": "2024-10-27T07:52:16.115Z"
    },
    "configurations": {
      "aml": {
        "message": "Address is not sanctioned",
        "provider": "ofac",
        "status": "success"
      }
    },
    "createdAt": "2024-11-11T16:57:19.160Z",
    "derivationPath": null,
    "id": "b87901a2-45c1-4d2d-8ee7-205ef0c4ddf1",
    "isActive": true,
    "metadata": null,
    "name": "External address",
    "network": "testnet",
    "type": "EXTERNAL",
    "updatedAt": "2024-11-11T16:57:19.160Z"
  },
  "message": "Address whitelisted successfully",
  "statusCode": 200
}

​
Tests

Les adresses generees via un portefeuille principal testnet ne peuvent recevoir des actifs que sur le testnet.
Voici une liste d’endroits ou vous pouvez obtenir des actifs testnet pour tester :
  • Ethereum - Obtenez des USDC de test ici : Circle
  • Binance Smart Chain - Obtenez des USDT de test ici : Binance
  • Polygon - Obtenez des USDC de test ici : Circle
  • Base - Obtenez des USDC de test ici : Circle
  • Tron - Obtenez des USDT de test ici : Nileex
  • Solana - Obtenez des USDC de test ici : Circle
  • Optimism - Obtenez des USDC de test ici : Circle
  • Arbitrum - Obtenez des USDC de test ici : Circle
  • Celo - Obtenez des USDC de test ici : Circle


Bon codage !