← Blog
10 min de lectura
|
Publicado
|
Actualizado

API de BNB Smart Chain: qué puede construir

Qué ofrece una API de BNB Smart Chain (BSC): wallets, transferencias BNB y BEP-20, saldos y webhooks, con ejemplos de peticiones y los límites del RPC público.

Capítulos
C
Chaingateway Team
Expertos en blockchain

Revisado por Maurice Sobiera

Una API de BNB Smart Chain es una interfaz web para BNB Smart Chain (BSC), antes Binance Smart Chain. Permite a una aplicación crear wallets, enviar BNB y tokens BEP-20, leer saldos y recibir notificaciones de depósitos sin ejecutar un nodo de BSC. Su backend envía peticiones HTTPS, y el proveedor se encarga de la firma, la difusión y el acceso a la cadena.

Este artículo enumera lo que cubre una API de este tipo, muestra dos peticiones contra los endpoints de BSC de Chaingateway y explica cuándo bastan los endpoints RPC públicos.

¿Qué cubre una API de BSC?

Una API de BSC cubre las operaciones que necesita un backend de pagos o de wallets. Los endpoints de Chaingateway, tal como figuran en el archivo OpenAPI, se agrupan en cinco bloques:

BloqueEndpoints
DireccionesPOST /api/v2/bsc/addresses crea una wallet, GET lista las wallets, POST /api/v2/bsc/addresses/import importa una clave privada
SaldosGET /api/v2/bsc/balances/{address} para BNB, GET /api/v2/bsc/balances/{address}/bep20/{contract_address} para un token BEP-20
TransferenciasPOST /api/v2/bsc/transactions para BNB, POST /api/v2/bsc/transactions/bep20 para tokens BEP-20, POST /api/v2/bsc/transactions/bep721 para NFT
Datos de la cadenaÚltimo bloque, bloque por número o hash, transacción, recibo, precio del gas, propietario de un NFT y URI del token
WebhooksCrear, actualizar y eliminar webhooks, listar notificaciones, listar notificaciones fallidas y reintentarlas

Todas las peticiones usan un token bearer en la cabecera Authorization. Envíe X-Network: testnet para usar la red de pruebas. Sin la cabecera, la petición va a la mainnet.

¿Cómo se consulta un saldo y se envía BNB?

Consulte el saldo con una petición GET y envíe BNB con una petición POST. Ambos ejemplos usan la URL base https://app.chaingateway.io y un token de su panel.

Terminal window
curl https://app.chaingateway.io/api/v2/bsc/balances/0x0000000000000000000000000000000000001000 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet"

La respuesta contiene el saldo como cadena decimal:

{"status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}

Para enviar BNB desde una wallet que creó con la API, envíe el remitente, el destinatario, el importe y la contraseña de la wallet. Los campos de gas son opcionales.

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/bsc/transactions \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet" \
-H "Content-Type: application/json" \
-d '{"from": "0x...", "to": "0x...", "amount": "0.001", "password": "wallet-password"}'

Si el remitente tiene muy poco BNB para el importe más el gas, la API devuelve el estado 422 con el mensaje insufficient funds del nodo. Una contraseña de wallet incorrecta devuelve 401.

¿Cómo se lee el saldo de un token y una transacción?

Lea el saldo de un token BEP-20 con la dirección de la wallet y la del contrato del token en la ruta. Lea una transacción con su hash. Ambas son peticiones GET con las mismas cabeceras de antes.

Terminal window
# BEP-20 token balance
curl https://app.chaingateway.io/api/v2/bsc/balances/0xWalletAddress/bep20/0xTokenContract \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Transaction with decoded data
curl https://app.chaingateway.io/api/v2/bsc/transactions/0xTransactionHash/decoded \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Current gas price
curl https://app.chaingateway.io/api/v2/bsc/gasprice \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"

El endpoint de saldos devuelve el importe del token como cadena decimal, así que usted no tiene que escalarlo por los decimales del token. El endpoint de transacciones decodificadas devuelve una transacción en campos legibles en lugar de datos hexadecimales en bruto. Un hash desconocido devuelve una respuesta 422 con el mensaje transaction not found.

GET /api/v2/bsc/transactions lista el historial de transacciones propio. Solo incluye las transacciones hechas con la API de Chaingateway, porque Chaingateway no indexa por su cuenta sus direcciones. Para ver las transferencias entrantes, use un webhook.

Si ya tiene una wallet, POST /api/v2/bsc/addresses/import importa su clave privada. Las wallets importadas y las nuevas usan los mismos endpoints de envío y de webhooks.

¿Cómo se recibe aviso de los depósitos?

Cree un webhook con POST /api/v2/bsc/webhooks. El campo url es obligatorio. Filtre por to (una dirección receptora), por from o por contractaddress para un token, y fije type en BNB, BEP20 o BEP721. Cuando se detecta una transacción que coincide, Chaingateway envía los datos de la transacción a su URL.

Los webhooks no se reintentan automáticamente. Una entrega fallida aparece en GET /api/v2/bsc/webhooks/notifications/failed, y POST /api/v2/bsc/webhooks/notifications/{id}/retry la vuelve a enviar. Haga que su endpoint receptor sea idempotente, con clave en el ID de la transacción, para que un reintento no acredite una cuenta dos veces.

¿Qué es BEP-20?

BEP-20 es el estándar de token de BNB Smart Chain. Según su especificación, deriva del ERC-20 de Ethereum y exige las funciones symbol(), decimals(), totalSupply(), balanceOf(), transfer(), transferFrom(), approve() y allowance(). Por eso el mismo código de wallet funciona para tokens en BSC y en Ethereum, y por eso los endpoints de BSC de Chaingateway reflejan los de Ethereum.

¿Cuándo bastan los endpoints RPC públicos?

BNB Chain publica endpoints JSON-RPC públicos para la mainnet y la testnet. La documentación de BNB Chain indica un límite de 10.000 peticiones cada 5 minutos, y señala que eth_getLogs está desactivado en los endpoints públicos de la mainnet.

Para prototipos y lecturas ocasionales, eso basta. Para un servicio que vigila muchas direcciones, necesita un nodo propio, un proveedor o una API que le envíe los eventos. Para la vía del nodo, consulte cómo comunicarse con un nodo mediante JSON-RPC. Más información sobre el lado de Chaingateway está en la página de la API de BSC.

Cómo escribimos estos artículos

¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API de Binance Smart Chain para la referencia completa de los endpoints.

C
Chaingateway Team
Expertos en blockchain

El equipo de Chaingateway se dedica a simplificar la integración blockchain para desarrolladores de todo el mundo.