Documentation Index
Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
Use this file to discover all available pages before exploring further.
En resumen
La API de Smart Contracts de Blockradar le permite interactuar con cualquier smart contract directamente desde su billetera, sin necesidad de gestionar endpoints RPC, flujos de firma o despliegues de contratos por su cuenta.
La API de Smart Contracts de Blockradar le permite interactuar con cualquier smart contract directamente desde su billetera, sin necesidad de gestionar endpoints RPC, flujos de firma o despliegues de contratos por su cuenta.

Requisitos previos
Antes de utilizar la API de Smart Contracts, asegúrese de contar con:Clave de API
Obtenga su clave de API desde el Dashboard de Blockradar. Vaya a Developers para generar una.
Billetera creada
Cree una billetera mediante la API Create Wallet o el dashboard. Necesitará el
walletId para todas las operaciones de smart contracts.Saldo en moneda nativa
Financie su billetera con la moneda nativa (ETH, BNB, MATIC, etc.) para cubrir las tarifas de gas. Utilice el endpoint de Network Fee para estimar los costos antes de ejecutar.
Blockchains compatibles
La API de Smart Contracts admite todas las blockchains compatibles con EVM y Tron disponibles en Blockradar. Consulte Integrations para ver la lista completa de redes admitidas y enlaces a faucets.Introducción
La API de Smart Contracts transforma a Blockradar de una infraestructura de billeteras a una capa de ejecución programable. Puede leer el estado de un contrato, ejecutar funciones de contratos, estimar tarifas de gas y firmar transacciones, todo a través de una superficie API unificada.Operaciones de lectura
Recupere datos de cualquier smart contract en las blockchains compatibles.
Operaciones de escritura
Ejecute funciones de smart contracts con gestión completa de transacciones.
Estimación de tarifas
Calcule los costos de gas antes de ejecutar para asegurar fondos suficientes.
Operaciones por lotes
Ejecute múltiples llamadas a contratos en una sola solicitud API.
Casos de uso
La API de Smart Contracts habilita capacidades poderosas para los desarrolladores fintech:- Integración con DeFi: Conéctese a protocolos como Uniswap, Aave o Compound para gestión de rendimiento y liquidez
- Operaciones de tesorería: Automatice la gestión de tesorería dentro de su plataforma fintech
- Activos tokenizados: Integre activos del mundo real en sus flujos de producto
- Liquidaciones programables: Ejecute verificaciones de cumplimiento y liquidaciones automatizadas
- Activos personalizados: Gestione activos personalizados, sistemas de recompensas y programas de lealtad
Master Wallet vs Child Address
La API de Smart Contracts está disponible en dos niveles:Master Wallet
Ejecute operaciones de contratos directamente desde su master wallet. Ideal para operaciones de tesorería y gestión centralizada de fondos.
Child Address
Ejecute operaciones de contratos desde child addresses individuales. Perfecto para operaciones específicas de usuario y gestión segregada de fondos.
Endpoints de Master Wallet
| Operación | Endpoint | Descripción |
|---|---|---|
| Lectura | POST /v1/wallets/{walletId}/contracts/read | Recupera datos de smart contracts |
| Escritura | POST /v1/wallets/{walletId}/contracts/write | Ejecuta funciones de smart contracts |
| Network Fee | POST /v1/wallets/{walletId}/contracts/network-fee | Estima los costos de gas |
| Sign Only | POST /v1/wallets/{walletId}/contracts/write/sign | Firma sin transmitir |
Endpoints de Child Address
| Operación | Endpoint | Descripción |
|---|---|---|
| Lectura | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/read | Recupera datos de smart contracts |
| Escritura | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write | Ejecuta funciones de smart contracts |
| Network Fee | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/network-fee | Estima los costos de gas |
| Sign Only | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write/sign | Firma sin transmitir |
Estructura de la solicitud
Todas las solicitudes de smart contracts requieren estos parámetros:| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
address | string | Sí | La dirección del smart contract en la blockchain |
method | string | Sí | El nombre de la función a llamar |
parameters | array | Sí | Argumentos en el orden definido por el ABI de la función |
abi | array | Sí | La Application Binary Interface del contrato |
reference | string | No | Su ID interno de seguimiento para la transacción |
metadata | object | No | Pares clave-valor personalizados con detalles adicionales de la transacción |
Los campos
reference y metadata solo se aplican a operaciones de escritura. Las operaciones de lectura no admiten estos campos.Comprensión de los ABIs
El ABI (Application Binary Interface) define cómo interactuar con un smart contract. Puede obtener ABIs desde:- Exploradores de bloques: Etherscan, BscScan, PolygonScan (contratos verificados)
- Documentación de protocolos: Documentación oficial de los protocolos DeFi
- Código fuente del contrato: Compile a partir del código fuente Solidity
Lectura de datos del contrato
Utilice el endpoint de lectura para consultar el estado del contrato sin modificar la blockchain.Ejemplo de lectura con Master Wallet
Ejemplo de lectura con Child Address
Respuesta de lectura
Respuestas de error de lectura
Dirección de contrato inválida
Dirección de contrato inválida
Método no encontrado
Método no encontrado
Ejecución del contrato revertida
Ejecución del contrato revertida
Parámetros inválidos
Parámetros inválidos
Escritura en contratos
Ejecute funciones que modifican el estado de los smart contracts.Ejemplo de escritura con Master Wallet
Ejemplo de escritura con Child Address
Respuesta de escritura
Respuestas de error de escritura
Gas insuficiente
Gas insuficiente
Saldo insuficiente
Saldo insuficiente
Transacción revertida
Transacción revertida
ABI inválido
ABI inválido
Billetera no encontrada
Billetera no encontrada
Estimación de tarifas de red
Estime siempre las tarifas antes de ejecutar operaciones de escritura para asegurar que su billetera disponga de suficiente moneda nativa.Estimación de tarifas con Master Wallet
Estimación de tarifas con Child Address
Respuesta de tarifas
Ejemplo práctico: intercambio de activos en Uniswap
Esta sección demuestra dos enfoques para ejecutar un intercambio de activos: sin operaciones por lotes (llamadas secuenciales) y con operaciones por lotes (una sola llamada API).Ejemplo 1: intercambio de activos SIN operaciones por lotes
Este enfoque realiza llamadas API individuales para cada paso. Úselo cuando necesite control detallado sobre cada transacción o cuando las operaciones dependan de los resultados de llamadas anteriores.Paso 1: verificar el saldo del activo
Paso 2: aprobar el gasto del activo
Paso 3: estimar las tarifas del swap
Paso 4: ejecutar el swap
Ejemplo 2: intercambio de activos CON operaciones por lotes
Este enfoque combina approve + swap en una sola llamada API utilizando el arraycalls. Úselo para mayor eficiencia cuando desee encolar múltiples operaciones juntas.
Las operaciones por lotes se ejecutan secuencialmente. Cada operación se envía como una transacción independiente, pero solo necesita una llamada API.
Solicitud por lotes: approve + swap en una sola llamada
Respuesta del lote
Manejo de fallos parciales en lotes
Reglas de operaciones por lotes
| Regla | Valor |
|---|---|
| Tamaño máximo del lote | 20 operaciones |
| Orden de ejecución | Secuencial |
| Manejo de errores | Éxito parcial (los fallos no detienen las operaciones siguientes) |
Cuándo usar cada enfoque
| Escenario | Enfoque recomendado |
|---|---|
| Necesita verificar resultados entre pasos | Sin lotes |
| Parámetros dinámicos basados en resultados anteriores | Sin lotes |
| Patrones simples de approve + acción | Con lotes |
| Múltiples operaciones independientes | Con lotes |
| Minimizar llamadas API | Con lotes |
Eventos de Webhook
Las operaciones de smart contracts disparan notificaciones webhook:| Evento | Descripción |
|---|---|
custom-smart-contract.success | Operación de contrato completada con éxito |
custom-smart-contract.failed | Operación de contrato fallida |
Payload del Webhook
Mejores prácticas
Seguridad
- Verifique las direcciones de los contratos: Verifique siempre dos veces las direcciones de los contratos antes de interactuar
- Use ABIs confiables: Obtenga los ABIs de fuentes verificadas como exploradores de bloques
- Establezca límites razonables: Use protección de slippage y topes de monto para operaciones DeFi
Gestión de gas
- Estime antes de ejecutar: Llame siempre primero al endpoint network-fee
- Monitoree el saldo nativo: Asegúrese de tener suficiente ETH/BNB/MATIC para las tarifas de gas
- Use operaciones por lotes: Reduzca la sobrecarga agrupando operaciones relacionadas
Manejo de errores
- Implemente listeners de webhook: No dependa solo de las respuestas de la API
- Maneje fallos parciales: Verifique tanto los arrays
successcomoerrorsen respuestas por lotes - Reintente con backoff: Implemente backoff exponencial para fallos transitorios
Referencia API
Endpoints de Master Wallet
| Endpoint | Descripción |
|---|---|
| Read Contract | Lee el estado del contrato |
| Write Contract | Ejecuta funciones del contrato |
| Network Fee | Estima los costos de gas |
| Sign Only | Firma sin transmitir |
Endpoints de Child Address
| Endpoint | Descripción |
|---|---|
| Read Contract | Lee el estado del contrato |
| Write Contract | Ejecuta funciones del contrato |
| Network Fee | Estima los costos de gas |
| Sign Only | Firma sin transmitir |
Soporte
- Correo electrónico: [email protected]
- Documentación: API Reference
- Blog: How to Interact with Any Smart Contract
La API de Smart Contracts le permite construir integraciones blockchain sofisticadas sin gestionar la complejidad de la infraestructura. Comience con operaciones simples de lectura e incorpore progresivamente operaciones de escritura a medida que se familiarice con el sistema.

