Em resumo
A API de Contratos Inteligentes da Blockradar permite que você interaja com qualquer contrato inteligente diretamente da sua carteira sem precisar gerenciar endpoints RPC, fluxos de assinatura ou implantações de contratos por conta própria.
A API de Contratos Inteligentes da Blockradar permite que você interaja com qualquer contrato inteligente diretamente da sua carteira sem precisar gerenciar endpoints RPC, fluxos de assinatura ou implantações de contratos por conta própria.

Pré-requisitos
Antes de usar a API de Contratos Inteligentes, certifique-se de ter:1
Chave API
Obtenha sua chave API no Painel da Blockradar. Navegue até Configurações → Chaves API para gerar uma.
2
Carteira Criada
Crie uma carteira via API Criar Carteira ou pelo painel. Você precisará do
walletId para todas as operações de contrato inteligente.3
Saldo em Token Nativo
Adicione fundos à sua carteira com moeda nativa (ETH, BNB, MATIC, etc.) para cobrir as taxas de gas. Use o endpoint de Taxa de Rede para estimar custos antes de executar.
Blockchains Suportadas
A API de Contratos Inteligentes suporta todas as blockchains compatíveis com EVM e Tron disponíveis na Blockradar. Consulte Integrações para a lista completa de redes suportadas e links de faucets.Introdução
A API de Contratos Inteligentes transforma a Blockradar de uma infraestrutura de carteira em uma camada de execução programável. Você pode ler o estado de contratos, executar funções de contratos, estimar taxas de gas e assinar transações—tudo através de uma superfície de API unificada.Operações de Leitura
Recupere dados de qualquer contrato inteligente nas blockchains suportadas.
Operações de Escrita
Execute funções de contrato inteligente com gerenciamento completo de transações.
Estimativa de Taxas
Calcule custos de gas antes da execução para garantir fundos suficientes.
Operações em Lote
Execute múltiplas chamadas de contrato em uma única requisição de API.
Casos de Uso
A API de Contratos Inteligentes desbloqueia capacidades poderosas para desenvolvedores fintech:- Integração DeFi: Conecte-se a protocolos como Uniswap, Aave ou Compound para gerenciamento de rendimento e liquidez
- Operações de Tesouraria: Automatize o gerenciamento de tesouraria dentro da sua plataforma fintech
- Ativos Tokenizados: Integre ativos do mundo real nos seus fluxos de produtos
- 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
Carteira Principal vs Endereço Filho
A API de Contratos Inteligentes está disponível em dois níveis:Carteira Principal
Execute operações de contrato diretamente da sua carteira principal. Ideal para operações de tesouraria e gerenciamento centralizado de fundos.
Endereço Filho
Execute operações de contrato a partir de endereços filhos individuais. Perfeito para operações específicas de usuários e gerenciamento segregado de fundos.
Endpoints da Carteira Principal
| Operação | Endpoint | Descrição |
|---|---|---|
| Leitura | POST /v1/wallets/{walletId}/contracts/read | Recuperar dados de contratos inteligentes |
| Escrita | POST /v1/wallets/{walletId}/contracts/write | Executar funções de contrato inteligente |
| Taxa de Rede | POST /v1/wallets/{walletId}/contracts/network-fee | Estimar custos de gas |
| Apenas Assinar | POST /v1/wallets/{walletId}/contracts/write/sign | Assinar sem transmitir |
Endpoints do Endereço Filho
| Operação | Endpoint | Descrição |
|---|---|---|
| Leitura | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/read | Recuperar dados de contratos inteligentes |
| Escrita | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write | Executar funções de contrato inteligente |
| Taxa de Rede | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/network-fee | Estimar custos de gas |
| Apenas Assinar | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write/sign | Assinar sem transmitir |
Estrutura da Requisição
Todas as requisições de contrato inteligente requerem estes parâmetros:| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
address | string | Sim | O endereço blockchain do contrato inteligente |
method | string | Sim | O nome da função a ser chamada |
parameters | array | Sim | Argumentos correspondentes à ordem do ABI da função |
abi | array | Sim | A Interface Binária de Aplicação do contrato |
reference | string | Não | Seu ID de rastreamento interno para a transação |
metadata | object | Não | Pares chave-valor personalizados para detalhes adicionais da transação |
Os campos
reference e metadata são aplicáveis apenas para operações de escrita. Operações de leitura não suportam esses campos.Entendendo ABIs
O ABI (Application Binary Interface) define como interagir com um contrato inteligente. Você pode obter ABIs de:- Exploradores de blocos: Etherscan, BscScan, PolygonScan (contratos verificados)
- Documentação de protocolos: Docs oficiais de protocolos DeFi
- Código fonte do contrato: Compilar 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 Carteira Principal
Exemplo de Leitura com Endereço Filho
Resposta de Leitura
Respostas de Erro de Leitura
Endereço de Contrato Inválido
Endereço de Contrato Inválido
Método Não Encontrado
Método Não Encontrado
Execução do Contrato Revertida
Execução do Contrato Revertida
Parâmetros Inválidos
Parâmetros Inválidos
Escrevendo em Contratos
Execute funções que alteram o estado em contratos inteligentes.Exemplo de Escrita com Carteira Principal
Exemplo de Escrita com Endereço Filho
Resposta de Escrita
Respostas de Erro de Escrita
Gas Insuficiente
Gas Insuficiente
Saldo de Token Insuficiente
Saldo de Token Insuficiente
Transação Revertida
Transação Revertida
ABI Inválido
ABI Inválido
Carteira Não Encontrada
Carteira Não Encontrada
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 Taxa com Carteira Principal
Estimativa de Taxa com Endereço Filho
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 (única chamada de API).Exemplo 1: Troca de Ativos SEM Operações em Lote
Esta abordagem faz chamadas de API individuais para cada etapa. Use quando você precisar de controle granular sobre cada transação ou quando as operações dependem dos resultados de chamadas anteriores.Etapa 1: Verificar Saldo de Ativos
Etapa 2: Aprovar Gasto de Ativos
Etapa 3: Estimar Taxas da Troca
Etapa 4: Executar Troca
Exemplo 2: Troca de Ativos COM Operações em Lote
Esta abordagem combina aprovar + trocar em uma única chamada de API usando o arraycalls. Use para eficiência quando quiser enfileirar múltiplas operações juntas.
As operações em lote são executadas sequencialmente. Cada operação é enviada como uma transação separada, mas você só precisa de uma chamada de API.
Requisição em Lote: Aprovar + Trocar em Uma Chamada
Resposta do Lote
Tratando Falhas Parciais em Lote
Regras de Operações em Lote
| Regra | Valor |
|---|---|
| Tamanho máximo do lote | 20 operações |
| Ordem de execução | Sequencial |
| Tratamento de erros | Sucesso parcial (falhas não param operações subsequentes) |
Quando Usar Cada Abordagem
| Cenário | Abordagem Recomendada |
|---|---|
| Precisa verificar resultados entre etapas | Sem Lote |
| Parâmetros dinâmicos baseados em resultados anteriores | Sem Lote |
| Padrões simples de aprovar + ação | Com Lote |
| Múltiplas operações independentes | Com Lote |
| Minimizar chamadas de API | Com Lote |
Eventos de Webhook
Operações de contrato inteligente disparam notificações de webhook:| Evento | Descrição |
|---|---|
custom-smart-contract.success | Operação de contrato concluída com sucesso |
custom-smart-contract.failed | Operação de contrato falhou |
Payload do Webhook
Melhores Práticas
Segurança
- Verifique endereços de contrato: Sempre verifique os endereços de contrato antes de interagir
- Use ABIs confiáveis: Obtenha ABIs de fontes verificadas como exploradores de blocos
- Defina limites razoáveis: Use proteção contra slippage e limites de valor para operações DeFi
Gerenciamento de Gas
- Estime antes de executar: Sempre chame o endpoint de taxa de rede primeiro
- Monitore o saldo nativo: Garanta ETH/BNB/MATIC suficiente para taxas de gas
- Use operações em lote: Reduza a sobrecarga agrupando operações relacionadas
Tratamento de Erros
- Implemente listeners de webhook: Não dependa apenas das respostas da API
- Trate falhas parciais: Verifique ambos os arrays
successeerrorsnas respostas de lote - Tente novamente com backoff: Implemente backoff exponencial para falhas transitórias
Referência da API
Endpoints da Carteira Principal
| Endpoint | Descrição |
|---|---|
| Ler Contrato | Ler estado do contrato |
| Escrever Contrato | Executar funções do contrato |
| Taxa de Rede | Estimar custos de gas |
| Apenas Assinar | Assinar sem transmitir |
Endpoints do Endereço Filho
| Endpoint | Descrição |
|---|---|
| Ler Contrato | Ler estado do contrato |
| Escrever Contrato | Executar funções do contrato |
| Taxa de Rede | Estimar custos de gas |
| Apenas Assinar | Assinar sem transmitir |
Suporte
- Email: [email protected]
- Documentação: Referência da API
- Blog: Como Interagir com Qualquer Contrato Inteligente
A API de Contratos Inteligentes permite que você construa integrações blockchain sofisticadas sem gerenciar a complexidade da infraestrutura. Comece com operações de leitura simples e gradualmente incorpore operações de escrita à medida que se familiarizar com o sistema.

