Interagir com Qualquer Contrato Inteligente

As APIs principais do Blockradar cobrem os fluxos fintech mais comuns: depósitos de stablecoins, pagamentos, swaps e liquidações. Mas e se você precisar ir além do que é suportado nativamente? E se precisar interagir com um protocolo DeFi, com o contrato do seu próprio token ou com um serviço on-chain exclusivo do seu negócio? É aí que entra a API de Contratos Inteligentes. Ela permite interagir com qualquer contrato inteligente diretamente da sua carteira Blockradar, sem gerenciar endpoints RPC, fluxos de assinatura ou infraestrutura de nós. Com ela, você pode:

Conectar-se a protocolos DeFi para gestão de rendimento ou liquidez
Automatizar empréstimos, staking ou operações de tesouraria com stablecoins
Integrar ativos do mundo real tokenizados (RWAs) aos fluxos do seu produto
Viabilizar liquidações, pagamentos ou verificações de conformidade programáveis com lógica on-chain
Ampliar sua plataforma com tokens personalizados, sistemas de recompensa ou regras de taxas

A API de Contratos Inteligentes oferece três capacidades: ler o estado de um contrato, escrever em contratos e estimar o gas antes da execução.

Pré-requisitos

Chave de API

Obtenha sua chave de API no painel do Blockradar. Acesse Developers para gerar uma.

Carteira criada

Você precisará de um walletId para todas as operações com contratos inteligentes.

ABI do contrato

Você precisa da ABI (interface binária de aplicação) da função do contrato que deseja chamar. Ela é pública para contratos verificados em exploradores de blocos como o Etherscan.

Endereço do contrato

O endereço on-chain do contrato inteligente com o qual você quer interagir.

Como funciona

Neste guia, percorreremos um exemplo real: trocar um token não suportado por USDT usando o Uniswap V2. O mesmo padrão vale para qualquer interação com contratos inteligentes. O fluxo:

Ler o saldo do token no contrato
Aprovar que o Uniswap gaste o token
Estimar a taxa de rede do swap
Executar o swap
Confirmar pelo webhook

Etapa 1: Entenda o contrato

Vamos usar o método swapExactTokensForTokens do roteador do Uniswap V2. Assinatura do método:

function swapExactTokensForTokens(
  uint amountIn,
  uint amountOutMin,
  address[] calldata path,
  address to,
  uint deadline
) external returns (uint[] memory amounts);

Parâmetro	Descrição
`amountIn`	Quantidade do token que você quer vender
`amountOutMin`	Quantidade mínima do token de saída que você aceita (proteção contra slippage)
`path`	Endereços dos tokens que formam a rota do swap
`to`	O endereço da sua carteira Blockradar (recebe o token de saída)
`deadline`	Timestamp Unix a partir do qual a transação expira

Etapa 2: Leia o saldo do token

Antes do swap, verifique quanto do token sua carteira possui usando contracts/read.

const res = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/read',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [{
        "constant": true,
        "inputs": [{ "name": "_owner", "type": "address" }],
        "name": "balanceOf",
        "outputs": [{ "name": "balance", "type": "uint256" }],
        "stateMutability": "view",
        "type": "function"
      }],
      address: "0xUnsupportedTokenAddress",
      method: "balanceOf",
      parameters: ["0xYourWalletAddress"]
    })
  }
).then(r => r.json());

// Response:
// { "data": "1000000000000000000", "message": "Contract read successfully" }

Parâmetro	Descrição
`abi`	A ABI da função do contrato que você está chamando
`address`	O endereço do contrato inteligente do token
`method`	O nome da função a ser chamada
`parameters`	Os argumentos da função

Use o saldo retornado aqui como valor de amountIn na sua chamada de swap.

Etapa 3: Autorize o contrato a gastar seu token

Antes que o Uniswap possa movimentar seu token, é preciso conceder permissão usando a função approve do contrato do token.

await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/write',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [{
        "inputs": [
          { "name": "_spender", "type": "address" },
          { "name": "_value", "type": "uint256" }
        ],
        "name": "approve",
        "outputs": [],
        "stateMutability": "nonpayable",
        "type": "function"
      }],
      address: "0xUnsupportedTokenAddress",
      method: "approve",
      parameters: ["0xUniswapRouterAddress", "1000000000000000000"]
    })
  }
);

Não avance para o swap logo após enviar a aprovação. Aguarde o webhook custom-smart-contract.success confirmando que a transação de aprovação foi minerada antes de seguir para a próxima etapa.

Payload do webhook de aprovação:

{
  "event": "custom-smart-contract.success",
  "data": {
    "status": "SUCCESS",
    "type": "CUSTOM_SMART_CONTRACT",
    "hash": "0xfedcba098765...",
    "tokenAddress": "0xUnsupportedTokenAddress"
  }
}

Etapa 4: Estime a taxa de rede

Antes de executar o swap, estime o custo de gas para garantir que sua carteira tenha token nativo suficiente para cobri-lo.

const fee = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/network-fee',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [ /* ABI of swapExactTokensForTokens */ ],
      address: "0xUniswapRouterAddress",
      method: "swapExactTokensForTokens",
      parameters: [
        "1000000000000000000",
        "990000",
        ["0xUnsupportedTokenAddress", "0xUSDTAddress"],
        "0xYourWalletAddress",
        Math.floor(Date.now() / 1000) + 60 * 20
      ]
    })
  }
).then(r => r.json());

// Response:
// { "data": { "balance": "1.0123", "fee": "0.00422" } }

Etapa 5: Execute o swap

Com a aprovação confirmada e a taxa revisada, execute o swap.

const swap = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/write',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [ /* ABI of swapExactTokensForTokens */ ],
      address: "0xUniswapRouterAddress",
      method: "swapExactTokensForTokens",
      parameters: [
        "1000000000000000000",
        "990000",
        ["0xUnsupportedTokenAddress", "0xUSDTAddress"],
        "0xYourWalletAddress",
        Math.floor(Date.now() / 1000) + 60 * 20
      ]
    })
  }
).then(r => r.json());

// Response:
// { "message": "Contract write initiated successfully", "data": { "status": "PENDING" } }

Escute o webhook para confirmar a conclusão:

{
  "event": "custom-smart-contract.success",
  "data": {
    "status": "SUCCESS",
    "type": "CUSTOM_SMART_CONTRACT",
    "hash": "0xfedcba098765...",
    "tokenAddress": "0xUniswapRouterAddress"
  }
}

Eventos de webhook

Evento	Descrição
`custom-smart-contract.success`	Escrita no contrato confirmada on-chain
`custom-smart-contract.failed`	A escrita no contrato falhou

Outros endpoints

Endpoint	Descrição
`POST /v1/wallets/{walletId}/contracts/read`	Ler o estado de qualquer contrato
`POST /v1/wallets/{walletId}/contracts/write`	Executar qualquer função de contrato
`POST /v1/wallets/{walletId}/contracts/network-fee`	Estimar o gas antes da execução
`POST /v1/wallets/{walletId}/contracts/write/sign`	Assinar uma transação sem transmiti-la

Notas de segurança

Todas as transações são assinadas e transmitidas pela infraestrutura do Blockradar — não é preciso gerenciar chaves privadas nem nós RPC
Verificações nativas de AML e conformidade são aplicadas sempre que possível
Cada interação com contrato é uma transação on-chain real e exige gas no token nativo da rede

Referência da API

Endpoint	Descrição
Master Wallet Read	Ler o estado de um contrato pela carteira principal
Master Wallet Write	Executar uma função de contrato pela carteira principal
Master Wallet Network Fee	Estimar o gas pela carteira principal
Child Address Read	Ler o estado de um contrato por um child address
Child Address Write	Executar uma função de contrato por um child address
Child Address Network Fee	Estimar o gas por um child address

Começar

Carteiras

Receber Pagamentos

Enviar Pagamentos

Converter e Gerenciar

Conformidade e Recuperação

Integrações

Interagir com Qualquer Contrato Inteligente

Pré-requisitos

Como funciona

Etapa 1: Entenda o contrato

Etapa 2: Leia o saldo do token

Etapa 3: Autorize o contrato a gastar seu token

Etapa 4: Estime a taxa de rede

Etapa 5: Execute o swap

Eventos de webhook

Outros endpoints

Notas de segurança

Referência da API

​Pré-requisitos

​Como funciona

​Etapa 1: Entenda o contrato

​Etapa 2: Leia o saldo do token

​Etapa 3: Autorize o contrato a gastar seu token

​Etapa 4: Estime a taxa de rede

​Etapa 5: Execute o swap

​Eventos de webhook

​Outros endpoints

​Notas de segurança

​Referência da API

Pré-requisitos

Como funciona

Etapa 1: Entenda o contrato

Etapa 2: Leia o saldo do token

Etapa 3: Autorize o contrato a gastar seu token

Etapa 4: Estime a taxa de rede

Etapa 5: Execute o swap

Eventos de webhook

Outros endpoints

Notas de segurança

Referência da API