Skip to main content
Em resumo
A API de Smart Contracts da Blockradar permite que você interaja com qualquer smart contract diretamente da sua carteira, sem precisar gerenciar endpoints RPC, fluxos de assinatura ou implantações de contratos por conta própria.
Smart Contracts

Pré-requisitos

Antes de usar a API de Smart Contracts, certifique-se de ter:
1

Chave de API

Obtenha sua chave de API no Dashboard da Blockradar. Acesse Developers para gerar uma.
2

Carteira criada

Crie uma carteira via Create Wallet API ou pelo dashboard. Você precisará do walletId para todas as operações de smart contracts.
3

Saldo em moeda nativa

Abasteça sua carteira com a moeda nativa (ETH, BNB, MATIC, etc.) para cobrir as taxas de gas. Use o endpoint de Network Fee para estimar os custos antes de executar.

Blockchains suportadas

A API de Smart Contracts suporta todas as blockchains compatíveis com EVM e Tron disponíveis na Blockradar. Consulte Integrations para a lista completa de redes suportadas e links de faucets.
Solana não é suportada para interações com smart contracts. A API de Smart Contracts funciona apenas com cadeias compatíveis com EVM e Tron.
Comece com testnets durante o desenvolvimento para evitar gastar fundos reais.

Introdução

A API de Smart Contracts transforma a Blockradar de uma infraestrutura de carteiras em uma camada de execução programável. Você pode ler o estado do contrato, executar funções de contratos, estimar taxas de gas e assinar transações — tudo por meio de uma superfície API unificada.

Operações de leitura

Recupere dados de qualquer smart contract nas blockchains suportadas.

Operações de escrita

Execute funções de smart contracts com gerenciamento completo de transações.

Estimativa de taxas

Calcule os custos de gas antes da execução para garantir fundos suficientes.

Operações em lote

Execute várias chamadas a contratos em uma única requisição API.

Casos de uso

A API de Smart Contracts desbloqueia recursos poderosos para desenvolvedores fintech:
  • Integração com DeFi: Conecte-se a protocolos como Uniswap, Aave ou Compound para gerenciamento de rendimento e liquidez
  • Operações de tesouraria: Automatize a gestão de tesouraria dentro da sua plataforma fintech
  • Ativos tokenizados: Integre ativos do mundo real aos seus fluxos de produto
  • Liquidações programáveis: Execute verificações de conformidade e liquidações automatizadas
  • Ativos personalizados: Gerencie ativos personalizados, sistemas de recompensas e programas de fidelidade

Master Wallet vs Child Address

A API de Smart Contracts está disponível em dois níveis:

Master Wallet

Execute operações de contrato diretamente da sua master wallet. Ideal para operações de tesouraria e gerenciamento centralizado de fundos.

Child Address

Execute operações de contrato a partir de child addresses individuais. Perfeito para operações específicas de usuário e gerenciamento segregado de fundos.

Endpoints de Master Wallet

Endpoints de Child Address

Estrutura da requisição

Todas as requisições de smart contracts exigem estes parâmetros:
Os campos reference e metadata aplicam-se apenas a operações de escrita. Operações de leitura não suportam esses campos.

Entendendo os ABIs

O ABI (Application Binary Interface) define como interagir com um smart contract. Você pode obter ABIs de:
  • Block explorers: Etherscan, BscScan, PolygonScan (contratos verificados)
  • Documentação dos protocolos: Documentação oficial dos protocolos DeFi
  • Código-fonte do contrato: Compile a partir do código-fonte Solidity

Lendo dados do contrato

Use o endpoint de leitura para consultar o estado do contrato sem modificar a blockchain.

Exemplo de leitura com Master Wallet

Exemplo de leitura com Child Address

Resposta de leitura

Respostas de erro de leitura

Escrevendo em contratos

Execute funções que alteram o estado de smart contracts.

Exemplo de escrita com Master Wallet

Exemplo de escrita com Child Address

Resposta de escrita

As operações de escrita são assíncronas. A resposta inicial mostra o status PENDING. Escute o webhook custom-smart-contract.success para confirmar a conclusão da transação.

Respostas de erro de escrita

Estimando taxas de rede

Sempre estime as taxas antes de executar operações de escrita para garantir que sua carteira tenha moeda nativa suficiente.

Estimativa de taxas com Master Wallet

Estimativa de taxas com Child Address

Resposta de taxa


Exemplo prático: troca de ativos no Uniswap

Esta seção demonstra duas abordagens para executar uma troca de ativos: sem operações em lote (chamadas sequenciais) e com operações em lote (chamada API única).

Exemplo 1: troca de ativos SEM operações em lote

Esta abordagem faz chamadas API individuais para cada etapa. Use-a quando precisar de controle detalhado sobre cada transação ou quando as operações dependerem dos resultados de chamadas anteriores.

Etapa 1: verificar o saldo do ativo

Etapa 2: aprovar o gasto do ativo

Sempre aguarde o webhook custom-smart-contract.success confirmando que a transação de aprovação foi minerada antes de executar o swap.

Etapa 3: estimar as taxas do swap

Etapa 4: executar o swap


Exemplo 2: troca de ativos COM operações em lote

Esta abordagem combina approve + swap em uma única chamada API usando o array calls. Use-a para maior eficiência quando quiser enfileirar múltiplas operações juntas.
As operações em lote são executadas sequencialmente. Cada operação é submetida como uma transação separada, mas você só precisa de uma chamada API.

Requisição em lote: approve + swap em uma única chamada

Resposta do lote

Tratamento de falhas parciais em lote

Regras das operações em lote

Quando usar cada abordagem


Eventos de Webhook

As operações de smart contracts disparam notificações webhook:

Payload do Webhook

Boas práticas

Segurança

  • Verifique os endereços dos contratos: Sempre confira duas vezes os endereços dos contratos antes de interagir
  • Use ABIs confiáveis: Obtenha ABIs de fontes verificadas, como block explorers
  • Defina limites razoáveis: Use proteção contra slippage e tetos de valor para operações DeFi

Gerenciamento de gas

  • Estime antes de executar: Sempre chame primeiro o endpoint network-fee
  • Monitore o saldo nativo: Garanta ETH/BNB/MATIC suficientes para as taxas de gas
  • Use operações em lote: Reduza o overhead agrupando operações relacionadas

Tratamento de erros

  • Implemente listeners de webhook: Não dependa apenas das respostas da API
  • Lide com falhas parciais: Verifique tanto os arrays success quanto errors em respostas de lote
  • Repita com backoff: Implemente backoff exponencial para falhas transitórias

Referência da API

Endpoints de Master Wallet

Endpoints de Child Address

Suporte

A API de Smart Contracts permite criar integrações blockchain sofisticadas sem gerenciar a complexidade da infraestrutura. Comece com operações simples de leitura e incorpore gradualmente operações de escrita à medida que se familiarizar com o sistema.