Interactuar con Cualquier Contrato Inteligente

Las APIs principales de Blockradar cubren los flujos fintech más habituales: depósitos de stablecoins, pagos, swaps y liquidaciones. Pero ¿qué pasa si necesitas ir más allá de lo que se soporta de forma nativa? ¿Y si necesitas interactuar con un protocolo DeFi, con tu propio contrato de token o con un servicio on-chain propio de tu negocio? Ahí entra en juego la API de Contratos Inteligentes. Te permite interactuar con cualquier contrato inteligente directamente desde tu billetera de Blockradar, sin gestionar endpoints RPC, flujos de firma ni infraestructura de nodos. Con ella puedes:

Conectarte a protocolos DeFi para gestionar rendimiento o liquidez
Automatizar préstamos, staking u operaciones de tesorería con stablecoins
Integrar activos del mundo real tokenizados (RWA) en los flujos de tu producto
Impulsar liquidaciones, pagos o comprobaciones de cumplimiento programables con lógica on-chain
Ampliar tu plataforma con tokens personalizados, sistemas de recompensas o reglas de comisiones

La API de Contratos Inteligentes te ofrece tres capacidades: leer el estado de un contrato, escribir en contratos y estimar el gas antes de ejecutar.

Requisitos previos

Clave de API

Obtén tu clave de API en el panel de Blockradar. Ve a Developers para generar una.

Billetera creada

Necesitarás un walletId para todas las operaciones con contratos inteligentes.

ABI del contrato

Necesitas la ABI (interfaz binaria de aplicación) de la función del contrato que quieres llamar. Está disponible públicamente para los contratos verificados en exploradores de bloques como Etherscan.

Dirección del contrato

La dirección on-chain del contrato inteligente con el que quieres interactuar.

Cómo funciona

En esta guía recorreremos un ejemplo real: intercambiar un token no soportado por USDT usando Uniswap V2. El mismo patrón sirve para cualquier interacción con contratos inteligentes. El flujo:

Leer el saldo del token desde el contrato
Aprobar que Uniswap gaste el token
Estimar la comisión de red del swap
Ejecutar el swap
Confirmar mediante webhook

Paso 1: Entiende el contrato

Usaremos el método swapExactTokensForTokens del router de Uniswap V2. Firma del método:

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

Parámetro	Descripción
`amountIn`	Cantidad del token que quieres vender
`amountOutMin`	Cantidad mínima del token de salida que aceptarás (protección frente al slippage)
`path`	Direcciones de los tokens que forman la ruta del swap
`to`	La dirección de tu billetera de Blockradar (recibe el token de salida)
`deadline`	Marca de tiempo Unix a partir de la cual la transacción expira

Paso 2: Lee el saldo del token

Antes de hacer el swap, consulta cuánto token tiene tu billetera 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	Descripción
`abi`	La ABI de la función del contrato que estás llamando
`address`	La dirección del contrato inteligente del token
`method`	El nombre de la función que se va a llamar
`parameters`	Los argumentos de la función

Usa el saldo devuelto aquí como valor de amountIn en tu llamada de swap.

Paso 3: Aprueba que el contrato gaste tu token

Antes de que Uniswap pueda mover tu token, debes concederle permiso con la función approve del contrato del 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"]
    })
  }
);

No pases al swap inmediatamente después de enviar la aprobación. Espera al webhook custom-smart-contract.success que confirma que la transacción de aprobación se ha minado antes de continuar con el siguiente paso.

Payload del webhook de aprobación:

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

Paso 4: Estima la comisión de red

Antes de ejecutar el swap, estima el coste de gas para asegurarte de que tu billetera tiene suficiente token nativo para cubrirlo.

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

Paso 5: Ejecuta el swap

Cuando la aprobación esté confirmada y hayas revisado la comisión, ejecuta el 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" } }

Escucha el webhook para confirmar que se ha completado:

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

Eventos de webhook

Evento	Descripción
`custom-smart-contract.success`	Escritura en el contrato confirmada on-chain
`custom-smart-contract.failed`	La escritura en el contrato falló

Otros endpoints

Endpoint	Descripción
`POST /v1/wallets/{walletId}/contracts/read`	Leer el estado de cualquier contrato
`POST /v1/wallets/{walletId}/contracts/write`	Ejecutar cualquier función de un contrato
`POST /v1/wallets/{walletId}/contracts/network-fee`	Estimar el gas antes de ejecutar
`POST /v1/wallets/{walletId}/contracts/write/sign`	Firmar una transacción sin transmitirla

Notas de seguridad

Todas las transacciones se firman y transmiten a través de la infraestructura de Blockradar: no necesitas gestionar claves privadas ni nodos RPC
Se aplican comprobaciones nativas de AML y cumplimiento siempre que es posible
Cada interacción con un contrato es una transacción on-chain real y requiere gas en el token nativo de la cadena

Referencia de la API

Endpoint	Descripción
Master Wallet Read	Leer el estado de un contrato desde la billetera principal
Master Wallet Write	Ejecutar una función de contrato desde la billetera principal
Master Wallet Network Fee	Estimar el gas desde la billetera principal
Child Address Read	Leer el estado de un contrato desde una dirección hija
Child Address Write	Ejecutar una función de contrato desde una dirección hija
Child Address Network Fee	Estimar el gas desde una dirección hija

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Interactuar con Cualquier Contrato Inteligente

Requisitos previos

Cómo funciona

Paso 1: Entiende el contrato

Paso 2: Lee el saldo del token

Paso 3: Aprueba que el contrato gaste tu token

Paso 4: Estima la comisión de red

Paso 5: Ejecuta el swap

Eventos de webhook

Otros endpoints

Notas de seguridad

Referencia de la API

​Requisitos previos

​Cómo funciona

​Paso 1: Entiende el contrato

​Paso 2: Lee el saldo del token

​Paso 3: Aprueba que el contrato gaste tu token

​Paso 4: Estima la comisión de red

​Paso 5: Ejecuta el swap

​Eventos de webhook

​Otros endpoints

​Notas de seguridad

​Referencia de la API

Requisitos previos

Cómo funciona

Paso 1: Entiende el contrato

Paso 2: Lee el saldo del token

Paso 3: Aprueba que el contrato gaste tu token

Paso 4: Estima la comisión de red

Paso 5: Ejecuta el swap

Eventos de webhook

Otros endpoints

Notas de seguridad

Referencia de la API