Saltar al contenido principal
Addresses

​
Introducción

Las Direcciones Dedicadas es una característica crucial en Blockradar que te permite crear direcciones únicas para tus clientes. Estas direcciones permiten a tus clientes depositar stablecoins en tu aplicación fintech sin problemas. Cuando creas una dirección dedicada para un cliente, pueden usar esa única dirección para depositar stablecoins en múltiples blockchains compatibles con EVM. Por ejemplo, si tienes billeteras principales de Ethereum, Binance Smart Chain, Polygon y Base creadas, cada dirección que generes a través de cualquiera de estas billeteras principales se puede usar para recibir stablecoins en cualquiera de las blockchains y activos compatibles. Esto garantiza que no tengas que preocuparte de que tu cliente envíe stablecoins a la blockchain incorrecta. Además, cuando se depositan stablecoins en una dirección particular, los activos se mueven automáticamente a la dirección de la billetera principal de la cadena.
Aparte de Tron y Solana, las direcciones generadas desde una billetera se pueden usar para depositar stablecoins en otras blockchains que tengan el parámetro de blockchain isEvmCompatible: true.

​
Parámetros de Dirección Explicados

Al crear o actualizar una dirección, puedes usar los siguientes parámetros opcionales para personalizar su comportamiento:
ParámetroTipoPredeterminadoDescripción
disableAutoSweepBoolean (Opcional)falseSi se establece en true, el barrido automático de fondos desde esta dirección está deshabilitado.
enableGaslessWithdrawBoolean (Opcional)falseSi se establece en true, permite retiros sin que el usuario tenga que pagar tarifas de gas directamente.
metadataObject (Opcional)nullMetadatos personalizados que puedes adjuntar a la dirección para tu propia referencia o fines de seguimiento.
nameString (Opcional)nullUn nombre legible para la dirección, útil para identificación en tu panel de control o registros.
showPrivateKeyBoolean (Opcional)falseSi se establece en true, la clave privada para esta dirección se devolverá en la respuesta de la API. Usar con precaución.
Los parámetros disableAutoSweep, enableGaslessWithdraw y showPrivateKey anularán las configuraciones correspondientes en la configuración de la billetera principal para esta dirección específica. Esto permite un control granular a nivel de dirección, independientemente de la configuración predeterminada de la billetera.
Notas:
  • Todos estos parámetros son opcionales; solo necesitas incluir aquellos relevantes para tu caso de uso.
  • Habilitar showPrivateKey puede exponer información sensible. Solo usa esto en entornos seguros y confiables.
  • Ten cuidado con showPrivateKey, exponer claves privadas puede comprometer la seguridad.

​
Crear una Dirección Dedicada

Puedes generar una dirección dedicada para tu cliente usando el panel de control de Blockradar o la API, dependiendo de tu flujo de trabajo y necesidades de integración.

​
1. Usando el Panel de Control

El panel de control de Blockradar proporciona una interfaz simple y fácil de usar para generar nuevas direcciones. Generate address
Esta captura de pantalla demuestra el proceso de generar una nueva dirección a través del panel de control de Blockradar. Este método es ideal para la creación manual de direcciones o para equipos que prefieren una interfaz gráfica.

​
2. Usando la API

Para la generación de direcciones programática o automatizada, puedes usar la API de Crear Dirección Dedicada. Esto es útil para integrar la creación de direcciones en tus propias aplicaciones o sistemas backend. Para crear una dirección dedicada para un cliente, envía una solicitud POST a nuestra API de Crear Dirección Dedicada. 
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"
}'

​
Respuesta

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

​
Lista Blanca de Direcciones

Esta característica te permite agregar una dirección externa a la lista blanca para ser monitoreada según los requisitos de la billetera. Esto significa que si gestionas tu propia generación de direcciones, aún puedes usar Blockradar para monitorear depósitos realizados en esa dirección.

​
Parámetros del Cuerpo

ClaveRequeridoTipoDescripción
namefalsestringEl nombre de la dirección.
addresstruestringLa dirección de la billetera.
metadatafalseobjectMetadatos adicionales para la dirección. Esto formará parte de cualquier transacción vinculada a esto.
showPrivateKeyfalsebooleanSi deseas que la clave privada de la dirección forme parte de la respuesta.
disableAutoSweepfalsebooleanDeshabilita el barrido automático de activos enviados a la dirección en tu billetera principal.
enableGaslessWithdrawfalsebooleanHabilita transacciones sin gas desde esta dirección.
privateKeyfalsestringLa clave privada asociada con la dirección. Requerida para ejecutar acciones de forma segura.
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..."
}'

​
Respuesta

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

​
Pruebas

Las direcciones generadas a través de una billetera principal de testnet solo pueden recibir activos en la testnet.
Aquí hay una lista de lugares donde puedes obtener activos de testnet para probar:
  • Ethereum - Obtén USDC de prueba aquí: Circle
  • Binance Smart Chain - Obtén USDT de prueba aquí: Binance
  • Polygon - Obtén USDC de prueba aquí: Circle
  • Base - Obtén USDC de prueba aquí: Circle
  • Tron - Obtén USDT de prueba aquí: Nileex
  • Solana - Obtén USDC de prueba aquí: Circle
  • Optimism - Obtén USDC de prueba aquí: Circle
  • Arbitrum - Obtén USDC de prueba aquí: Circle
  • Celo - Obtén USDC de prueba aquí: Circle


¡Feliz programación! ❤️