Adresses

En resume
Les adresses dediees vous permettent de creer des adresses blockchain uniques pour chaque client. Ces adresses peuvent recevoir des stablecoins sur plusieurs chaines compatibles EVM, avec des depots automatiquement balayes vers votre portefeuille principal.

Prerequis

Avant de generer des adresses, assurez-vous d’avoir :

Cle API

Obtenez votre cle API depuis le Tableau de bord Blockradar. Naviguez vers Developers pour en generer une.

Portefeuille Principal Cree

Creez au moins un portefeuille principal via l’API Creer Portefeuille ou le tableau de bord. Vous aurez besoin du walletId pour generer des adresses.

Portefeuille Finance

Financez votre portefeuille principal avec des tokens natifs (ETH, BNB, MATIC, etc.) pour couvrir les frais de gas des operations de balayage automatique.

Webhook Configure

Configurez votre URL de webhook sur le portefeuille principal pour recevoir les notifications de depot. Voir Webhooks pour les details de configuration.

Comment Ca Fonctionne

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 :

Parametre	Type	Defaut	Description
`disableAutoSweep`	Boolean (Optionnel)	`false`	Si defini sur `true`, le balayage automatique des fonds depuis cette adresse est desactive.
`enableGaslessWithdraw`	Boolean (Optionnel)	`false`	Si defini sur `true`, permet les retraits sans que l’utilisateur ait a payer directement les frais de gas.
`metadata`	Object (Optionnel)	`null`	Metadonnees personnalisees que vous pouvez attacher a l’adresse pour votre propre reference ou suivi.
`name`	String (Optionnel)	`null`	Un nom lisible pour l’adresse, utile pour l’identification dans votre tableau de bord ou logs.
`showPrivateKey`	Boolean (Optionnel)	`false`	Si 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.

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"
}'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: '{"metadata":"OPTIONAL_METADATA","name":"OPTIONAL_ADDRESS_NAME"}'
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/addresses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"metadata\": \"OPTIONAL_METADATA\",\n  \"name\": \"OPTIONAL_ADDRESS_NAME\"\n}",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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
}

Emission et Indexation des Adresses

Blockradar separe deux choses qui se produisaient auparavant ensemble lors de la creation d’une adresse :

Emettre (issue) une adresse est peu couteux. Cela derive une nouvelle adresse de votre master wallet et la stocke, afin que vous puissiez la remettre a un client immediatement.
Indexer une adresse est la partie couteuse. Cela place l’adresse sous surveillance on-chain pour que les depots soient detectes en temps reel, et l’indexation est la base de la facturation.

Cela vous permet d’emettre une adresse par client a l’avance et d’activer l’indexation uniquement lorsqu’un client montre une intention de depot, de sorte que vous ne payez que pour les adresses que vous surveillez reellement.

Deux interrupteurs independants

Chaque adresse possede deux parametres qui controlent son etat :

Parametre	Valeurs	Controle
`isActive`	`true` / `false`	L’interrupteur principal marche/arret. `false` desactive entierement l’adresse.
`indexingStatus`	`ACTIVE` / `INACTIVE`	L’interrupteur de surveillance et de facturation. `INACTIVE` signifie dormante : ni surveillee ni facturee.

Une adresse est surveillee on-chain et comptee pour la facturation uniquement lorsque les deux sont actives : isActive: true et indexingStatus: ACTIVE.

Les adresses existantes ne sont pas affectees. indexingStatus prend la valeur ACTIVE par defaut, de sorte que chaque adresse que vous avez deja creee, et chaque adresse que vous creez sans opter pour le contraire, se comporte exactement comme avant.

Emettre une adresse dormante

Lors de la generation d’une adresse, passez enableIndexing: false pour creer une adresse dormante qui n’est ni surveillee ni facturee. Omettez le champ ou passez true pour le comportement par defaut (indexee immediatement). Une adresse dormante renvoie "indexingStatus": "INACTIVE" dans la reponse.

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "name": "Customer 123",
  "metadata": { "customerId": "123" },
  "enableIndexing": false
}'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: '{"name":"Customer 123","metadata":{"customerId":"123"},"enableIndexing":false}'
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/addresses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"name\": \"Customer 123\",\n  \"metadata\": { \"customerId\": \"123\" },\n  \"enableIndexing\": false\n}",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Activer l’indexation

Activez l’indexation lorsque le client montre une intention de depot. Cela abonne l’adresse, demarre la surveillance en temps reel et l’inclut dans la facturation. L’appel n’a pas de corps et est idempotent (sans effet si l’indexation est deja activee). Le parametre de chemin addressId accepte soit l’UUID de l’adresse, soit la chaine de l’adresse on-chain. La reponse affiche "indexingStatus": "ACTIVE". Elle renvoie 400 si l’adresse a ete desactivee (isActive: false).

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/enable \
  --header 'x-api-key: <api-key>'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>'}
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/enable', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/enable",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["x-api-key: <api-key>"],
]);

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Desactiver l’indexation

Desactivez l’indexation pour les clients inactifs ou partis afin de cesser de facturer les adresses que vous ne surveillez plus. Cela arrete la surveillance et retire l’adresse de la facturation au cycle suivant. L’appel n’a pas de corps et est idempotent. Les fonds deja recus restent en securite on-chain, et vous pouvez reactiver l’indexation plus tard sans cout supplementaire au-dela de la facturation normale. La reponse affiche "indexingStatus": "INACTIVE".

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/disable \
  --header 'x-api-key: <api-key>'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>'}
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/disable', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/indexing/disable",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["x-api-key: <api-key>"],
]);

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Facturation

La facturation des adresses est un comptage en direct effectue a chaque renouvellement, et non un frais par adresse. A chaque cycle, Blockradar compte les adresses actives et indexees sur le mainnet et facture l’utilisation au-dela de la limite de votre forfait.

Etat de l’adresse	Comptee pour la facturation	Surveillee on-chain
Dormante (`indexingStatus: INACTIVE`)	Non — gratuite	Non
Indexee (`indexingStatus: ACTIVE`)	Oui	Oui
Desactivee en cours de cycle	Sort du comptage suivant	Non

Generer des adresses dormantes ne facture rien, et desactiver l’indexation libere cette place au cycle suivant.

Bonnes pratiques

Emettez une adresse dormante lorsque vous l’attribuez a un client. Cela ne coute rien.
Activez l’indexation lorsque le client montre une intention de depot (KYC valide, checkout ouvert, ecran de depot consulte).
Activez toujours l’indexation avant de partager une adresse pour un depot reel, afin que le depot soit detecte en temps reel.
Desactivez l’indexation pour les clients inactifs ou partis, puis reactivez-la plus tard si necessaire.

Les depots effectues vers une adresse dormante ne sont pas detectes en temps reel. Si un client depose sur une adresse avant que l’indexation soit activee, les fonds sont en securite on-chain mais ne sont pas enregistres automatiquement. Activez l’indexation et declenchez la Recherche de Depots pour les recuperer. Activez toujours l’indexation avant de partager une adresse pour eviter cela.

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. Vous avez deja des portefeuilles emis par un autre fournisseur ? Vous pouvez toujours les connecter a Blockradar et surveiller les depots sans modifier votre configuration existante.

Parametres du Corps

Cle	Requis	Type	Description
`name`	false	string	Le nom de l’adresse.
`address`	true	string	L’adresse du portefeuille.
`metadata`	false	object	Metadonnees supplementaires pour l’adresse. Cela fera partie de toute transaction liee a celle-ci.
`showPrivateKey`	false	boolean	Si vous voulez que la cle privee de l’adresse fasse partie de la reponse.
`disableAutoSweep`	false	boolean	Desactiver le balayage automatique des actifs envoyes a l’adresse vers votre portefeuille principal.
`enableGaslessWithdraw`	false	boolean	Activer les transactions sans gas depuis cette adresse.
`privateKey`	false	string	La 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..."
}'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: '{"address":"ADDRESS_TO_WHITELIST","metadata":"OPTIONAL_METADATA","name":"OPTIONAL_ADDRESS_NAME"}'
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses/whitelist', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/addresses/whitelist",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"address\": \"ADDRESS_TO_WHITELIST\",\n  \"metadata\": \"OPTIONAL_METADATA\",\n  \"name\": \"OPTIONAL_ADDRESS_NAME\"\n}",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key": <api-key>
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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

Happy hacking! 💚

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Prerequis

Comment Ca Fonctionne

Explication des Parametres d’Adresse

Creer une Adresse Dediee

1. Utilisation du Tableau de Bord

2. Utilisation de l’API

Reponse

Emission et Indexation des Adresses

Deux interrupteurs independants

Emettre une adresse dormante

Activer l’indexation

Desactiver l’indexation

Facturation

Bonnes pratiques

Liste Blanche d’Adresses

Parametres du Corps

Reponse

Tests

​Prerequis

​Comment Ca Fonctionne

​Explication des Parametres d’Adresse

​Creer une Adresse Dediee

​1. Utilisation du Tableau de Bord

​2. Utilisation de l’API

​Reponse

​Emission et Indexation des Adresses

​Deux interrupteurs independants

​Emettre une adresse dormante

​Activer l’indexation

​Desactiver l’indexation

​Facturation

​Bonnes pratiques

​Liste Blanche d’Adresses

​Parametres du Corps

​Reponse

​Tests

Prerequis

Comment Ca Fonctionne

Explication des Parametres d’Adresse

Creer une Adresse Dediee

1. Utilisation du Tableau de Bord

2. Utilisation de l’API

Reponse

Emission et Indexation des Adresses

Deux interrupteurs independants

Emettre une adresse dormante

Activer l’indexation

Desactiver l’indexation

Facturation

Bonnes pratiques

Liste Blanche d’Adresses

Parametres du Corps

Reponse

Tests