Saltar para o conteúdo principal
Em resumo
Para aproveitar a infraestrutura de carteiras da Blockradar e permitir depósitos e pagamentos perfeitos para seus clientes, você precisa criar pelo menos uma carteira mestra.
Wallets Home

​
Introdução

As carteiras mestras são a espinha dorsal da maioria das ações que você pode realizar com a API da Blockradar. Essas carteiras permitem que você gerencie depósitos de stablecoins em várias blockchains suportadas pela Blockradar. Para visualizar a lista de blockchains e ativos suportados na Blockradar. Quando você cria uma carteira mestra para uma blockchain específica, ela permite que você gerencie tudo relacionado a essa blockchain com a carteira mestra:
  1. Gerar endereços dedicados para seus clientes usarem para depositar stablecoins em várias blockchains.
  2. Adicionar à lista de permissões endereços gerenciados externamente para monitoramento de depósitos de stablecoins.
  3. Varredura automática: cada stablecoin depositada em qualquer um dos endereços dedicados é automaticamente transferida para a carteira mestra.
  4. Saques: você pode facilmente iniciar saques de stablecoins do endereço da carteira mestra para um endereço externo.

​
Criando uma Carteira

A criação de uma carteira mestra requer quatro etapas:
  1. Selecione a blockchain para a qual você deseja criar a carteira.
  2. Adicione as stablecoins que você precisa que esta carteira mestra suporte.
  3. Configure a URL do webhook da sua carteira. Isso será usado para notificações e sincronização de dados quando stablecoins forem depositadas em qualquer um dos endereços dedicados gerados através desta carteira.
  4. Financie a carteira mestra. Para habilitar a varredura automática de stablecoins dos endereços dedicados para a carteira mestra e saque para endereço externo, você precisa manter um saldo do ativo nativo da blockchain nesta carteira mestra.
Um endereço dedicado gerado através de qualquer uma dessas carteiras mestras pode ser usado para receber depósitos em todas as outras carteiras mestras de blockchain, desde que as blockchains tenham isEvmCompatible: true.Isso significa que você pode emitir para seus clientes um único endereço exclusivo que pode ser usado para depositar stablecoins em várias blockchains, sem se preocupar com o envio de stablecoins para a blockchain errada.

​
Criar uma Carteira Mestra

Para criar uma carteira mestra, vá ao painel, navegue até a seção de carteiras e crie uma carteira para começar a construir uma experiência perfeita para seus clientes. O painel da Blockradar fornece uma interface simples e amigável para gerar carteiras mestras. Create Wallet
Esta captura de tela demonstra o processo de geração de uma nova carteira mestra 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.
Ambiente
Carteiras criadas no ambiente de produção são isoladas para esse ambiente. O mesmo se aplica às carteiras criadas no ambiente de teste, incluindo os endereços dedicados criados para seus clientes.

​
Configurações da Carteira

As carteiras mestras da Blockradar suportam duas opções de configuração principais para ajudá-lo a gerenciar fundos e experiência do usuário: Varredura Automática e Transações sem Gas.

​
Varredura Automática

Habilitar Quando habilitado, os fundos depositados em endereços sob esta carteira serão automaticamente varridos (transferidos) para a carteira mestra. Isso ajuda a consolidar saldos, melhora a segurança e simplifica o gerenciamento de fundos. Limite Defina o saldo mínimo necessário para cada endereço filho acionar a varredura automática. Se deixado em branco, qualquer quantia recebida acionará uma varredura automática. Isso permite que você controle com que frequência a varredura ocorre e otimize as taxas de gas.
  • Configuração Padrão: Por padrão, a varredura automática está definida como verdadeira e o limite é 0
  • Substituição de Endereço: Ao gerar ou atualizar um endereço, você pode substituir as configurações de habilitação/desabilitação de varredura automática e limite para esse endereço específico.
As configurações de auto-sweeping e threshold no nível dos endereços substituirão a configuração da carteira mestra para esse endereço. Isso permite um controle granular sobre o comportamento da varredura automática por endereço.
Melhores Práticas: Habilite a varredura automática e defina um limite apropriado para equilibrar entre consolidação oportuna de fundos e minimização de taxas de transação. Auto Sweeping

​
Transações sem Gas

Configure quando a carteira mestra deve cobrir as taxas de gas para saques de endereços filhos. Habilitar Saques sem Gas Quando habilitado, as taxas de gas para saques qualificados serão pagas pela carteira mestra, proporcionando uma experiência perfeita para seus usuários. Configurações de Limite Defina o limite de valor para saques sem gas. Apenas transações que atendam a este limite terão suas taxas de gas cobertas pela carteira mestra. Você pode especificar a lógica de limite usando operadores aritméticos:
OperadorDescriçãoExemplo (Limite = 100)
gtMaior queApenas saques > 100
gteMaior ou igual aApenas saques ≥ 100
ltMenor queApenas saques < 100
lteMenor ou igual aApenas saques ≤ 100
eqIgual aApenas saques = 100
  • Configuração Padrão: Transação sem Gas está definida como false por padrão e as configurações de limite estão definidas como 0.
  • Substituição de Endereço: Ao gerar ou atualizar um endereço, você pode substituir as configurações de habilitação/desabilitação e limite de transações sem gas para esse endereço específico.
As configurações de habilitação de gasless transaction e threshold no nível dos endereços substituirão a configuração da carteira mestra para esse endereço. Isso permite um controle granular sobre o comportamento de saque sem gas por endereço.
Melhores Práticas: Habilite saques sem gas e defina a lógica de limite apropriada para equilibrar a experiência do usuário e os custos operacionais.
  • Defina configurações no nível da carteira de acordo com suas necessidades de negócios e requisitos de segurança.
  • Use substituições no nível do endereço apenas quando precisar de comportamento diferente para endereços específicos.
Gasless Transaction

​
Financiamento

Financiar uma carteira mestra é essencial para pagar as taxas de gas na blockchain ao fazer auto-sweeping de stablecoins dos endereços dedicados para a carteira mestra e para saques para carteiras externas.

​
Ambiente de Teste

  • Ethereum: Obtenha ETH de teste aqui: Alchemy ou Infura
  • Binance Smart Chain: Obtenha BNB de teste aqui: Faucet
  • Polygon: Obtenha MATIC de teste aqui: Polygon PoS (Amoy)
  • Base: Obtenha ETH de teste aqui: Alchemy
  • Optimism: Obtenha ETH de teste aqui: Alchemy
  • Arbitrum: Obtenha ETH de teste aqui: Alchemy
  • Tron: Obtenha TRX de teste aqui: Faucet
  • Solana: Obtenha SOL de teste aqui: Faucet
  • Celo: Obtenha CELO de teste aqui: Faucet

​
Ambiente de Produção

Para o ambiente de produção, você pode enviar ativos de qualquer carteira ou exchange que suporte os ativos nativos em cada uma das blockchains.
Varredura
Sempre certifique-se de ter saldo suficiente em sua carteira mestra para evitar atrasos na varredura automática ou saques. Nós o notificaremos quando o saldo da sua carteira mestra estiver baixo.

​
Taxas de Gas: Ambiente de Teste vs Produção

Compreender as diferenças nas taxas de gas entre ambientes de teste e produção é crucial para desenvolvimento e implantação eficientes.

​
Taxas de Gas de Teste

No ambiente de teste, as taxas de gas são mínimas. As testnets são projetadas para simular o ambiente da mainnet sem os custos associados do mundo real. Como resultado, pequenas quantidades de tokens de gas em uma testnet podem ser usadas por um período prolongado. Isso permite que os desenvolvedores testem e iterem sua integração sem incorrer em despesas significativas.

​
Taxas de Gas de Produção

Em um ambiente de teste, as taxas de gas representam despesas do mundo real. Esses custos podem variar significativamente com base na blockchain e no congestionamento da rede. Estimar e gerenciar adequadamente as taxas de gas é essencial para garantir a operação suave de seus aplicativos e evitar custos excessivos. Ao aproveitar as testnets para desenvolvimento e teste, você pode minimizar despesas e garantir que suas soluções sejam robustas antes de implantar na mainnet.

​
Localizador de Depósitos

Em casos raros, você pode não receber um webhook do nosso sistema depois que um cliente envia stablecoins para qualquer um dos endereços emitidos para eles. Temos um mecanismo de localizador de depósitos construído internamente, mas você também tem a capacidade de acionar uma nova verificação da blockchain para uma transação ausente usando a API do Localizador de Depósitos fornecendo o transactionHash 
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{id}/rescan/blocks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "transactionHash": "string<TRANSACTION_HASH_OPTIONAL>"
}'
Parâmetros do corpo
O parâmetro obrigatório é transactionHash, que pode ser obtido a partir do registro da transação original ou procurando a transação no explorador de blockchain.


Bons hacks! ❤️