Saltar para o conteúdo principal
Addresses

​
Introdução

Endereços Dedicados é um recurso crucial na Blockradar que permite criar endereços exclusivos para seus clientes. Esses endereços permitem que seus clientes depositem stablecoins em seu aplicativo fintech perfeitamente. Quando você cria um endereço dedicado para um cliente, ele pode usar esse único endereço para depositar stablecoins em várias blockchains compatíveis com EVM. Por exemplo, se você tiver carteiras mestras Ethereum, Binance Smart Chain, Polygon e Base criadas, cada endereço que você gerar através de qualquer uma dessas carteiras mestras pode ser usado para receber stablecoins em qualquer uma das blockchains e ativos suportados. Isso garante que você não precise se preocupar com seu cliente enviando stablecoins para a blockchain errada. Além disso, quando stablecoins são depositadas em um endereço específico, os ativos são automaticamente movidos para o endereço da carteira mestra da chain.
Exceto para Tron e Solana, endereços gerados de uma carteira podem ser usados para depositar stablecoins em outras blockchains que tenham o parâmetro de blockchain isEvmCompatible: true.

​
Parâmetros de Endereço Explicados

Ao criar ou atualizar um endereço, você pode usar os seguintes parâmetros opcionais para personalizar seu comportamento:
ParâmetroTipoPadrãoDescrição
disableAutoSweepBoolean (Opcional)falseSe definido como true, a varredura automática de fundos deste endereço é desabilitada.
enableGaslessWithdrawBoolean (Opcional)falseSe definido como true, permite saques sem exigir que o usuário pague taxas de gas diretamente.
metadataObject (Opcional)nullMetadados personalizados que você pode anexar ao endereço para sua própria referência ou finalidades de rastreamento.
nameString (Opcional)nullUm nome legível para o endereço, útil para identificação no seu painel ou logs.
showPrivateKeyBoolean (Opcional)falseSe definido como true, a chave privada para este endereço será retornada na resposta da API. Use com cautela.
Os parâmetros disableAutoSweep, enableGaslessWithdraw e showPrivateKey substituirão as configurações correspondentes na configuração da carteira mestra para este endereço específico. Isso permite um controle granular no nível do endereço, independentemente das configurações padrão da carteira.
Notas:
  • Todos esses parâmetros são opcionais; você só precisa incluir aqueles relevantes para seu caso de uso.
  • Habilitar showPrivateKey pode expor informações sensíveis. Use isso apenas em ambientes seguros e confiáveis.
  • Tenha cuidado com showPrivateKey, expor chaves privadas pode comprometer a segurança.

​
Criar um Endereço Dedicado

Você pode gerar um endereço dedicado para seu cliente usando o painel da Blockradar ou a API, dependendo do seu fluxo de trabalho e necessidades de integração.

​
1. Usando o Painel

O painel da Blockradar fornece uma interface simples e amigável para gerar novos endereços. Generate address
Esta captura de tela demonstra o processo de geração de um novo endereço através do painel da Blockradar. Este método é ideal para criação manual de endereços ou para equipes que preferem uma interface gráfica.

​
2. Usando a API

Para geração de endereços programática ou automatizada, você pode usar a API de Criar Endereço Dedicado. Isso é útil para integrar a criação de endereços em seus próprios aplicativos ou sistemas backend. Para criar um endereço dedicado para um cliente, envie uma solicitação POST para nossa API de Criar Endereço Dedicado. 
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"
}'

​
Resposta

{
  "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 de Permissões de Endereços

Este recurso permite que você adicione à lista de permissões um endereço externo para ser monitorado com base nos requisitos da carteira. Isso significa que se você gerenciar sua própria geração de endereços, ainda pode usar a Blockradar para monitorar depósitos feitos nesse endereço.

​
Parâmetros do Corpo

ChaveObrigatórioTipoDescrição
namefalsestringO nome do endereço.
addresstruestringO endereço da carteira.
metadatafalseobjectMetadados adicionais para o endereço. Isso fará parte de qualquer transação vinculada a isso.
showPrivateKeyfalsebooleanSe você deseja que a chave privada do endereço faça parte da resposta.
disableAutoSweepfalsebooleanDesabilitar varredura automática de ativos enviados para o endereço em sua carteira mestra.
enableGaslessWithdrawfalsebooleanHabilitar transações sem gas a partir deste endereço.
privateKeyfalsestringA chave privada associada ao endereço. Necessária para executar ações com segurança.
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..."
}'

​
Resposta

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

​
Testes

Endereços gerados através de uma carteira mestra de testnet só podem receber ativos na testnet.
Aqui está uma lista de lugares onde você pode obter ativos de testnet para testar:
  • Ethereum - Obtenha USDC de teste aqui: Circle
  • Binance Smart Chain - Obtenha USDT de teste aqui: Binance
  • Polygon - Obtenha USDC de teste aqui: Circle
  • Base - Obtenha USDC de teste aqui: Circle
  • Tron - Obtenha USDT de teste aqui: Nileex
  • Solana - Obtenha USDC de teste aqui: Circle
  • Optimism - Obtenha USDC de teste aqui: Circle
  • Arbitrum - Obtenha USDC de teste aqui: Circle
  • Celo - Obtenha USDC de teste aqui: Circle


Bons hacks! ❤️