Saltearse al contenido

Redes blockchain y testnets compatibles

Chaingateway admite siete blockchains: Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum y Solana. Cada una tiene mainnet y testnet. Usted elige la red en cada solicitud con la cabecera X-Network, que toma el valor mainnet o testnet, y el segmento de la ruta selecciona la blockchain, por ejemplo /api/v2/tron/....

Selección de red: el segmento de la ruta elige la blockchain y la cabecera X-Network elige mainnet o testnet Solicitud a /api/v2/{chain}/... chain: ethereum, tron, bsc, bitcoin, polygon,arbitrum o solana Cabecera X-Network testnet, o mainnet (el valor por defecto sifalta la cabecera) Responde la red p. ej. Ethereum Sepolia o Ethereum mainnet
Dos datos seleccionan la red: la ruta y la cabecera.

Todas las solicitudes van a https://app.chaingateway.io/api/v2/{chain}/.... La tabla lista la red que corresponde a cada combinación de blockchain y valor de X-Network.

Tipo de redBlockchainRedValor de la cabecera X-Network
MainnetEthereummainnetmainnet
TestnetEthereumsepoliatestnet
MainnetTronmainnetmainnet
TestnetTronniletestnet
MainnetBinance Smart Chainmainnetmainnet
TestnetBinance Smart Chaintestnettestnet
MainnetBitcoinmainnetmainnet
TestnetBitcointestnet3testnet
MainnetPolygonmainnetmainnet
TestnetPolygonamoytestnet
MainnetArbitrummainnetmainnet
TestnetArbitrumarbitrum sepoliatestnet
MainnetSolanamainnetmainnet
TestnetSolanadevnettestnet

Añada la cabecera X-Network: testnet para ejecutar una solicitud en la red de pruebas. Elimine la cabecera, o envíe mainnet, para usar la red principal. El archivo OpenAPI define la cabecera como opcional con el valor por defecto mainnet, así que una solicitud sin ella se ejecuta en la red principal. La llamada siguiente lee el último bloque de Ethereum Sepolia.

Ventana de terminal
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'X-Network: testnet'

Las listas de notificaciones de webhook se limitan a una blockchain y una red, así que envíe el mismo valor de X-Network al leerlas que al crear el webhook. Use un solo token de API para ambas redes y fije la cabecera en la configuración del cliente, de modo que un entorno de pruebas no llegue a mainnet por error.

¿Qué diferencia a las blockchains entre sí?

Sección titulada «¿Qué diferencia a las blockchains entre sí?»

Las familias de endpoints se parecen, pero cada blockchain tiene su propio modelo de transacciones, así que algunos parámetros cambian. La tabla resume lo que define el archivo OpenAPI para cada una.

BlockchainMoneda nativa en la APIEstándares de tokenWebhooksNotas
EthereumETHERC20, ERC721sígasprice y consultas del propietario y la URI de NFT
Binance Smart ChainBNBBEP20, BEP721síel mismo conjunto de endpoints que Ethereum, bajo /bsc
PolygonMATICERC20, ERC721síel mismo conjunto de endpoints que Ethereum, bajo /polygon
ArbitrumETHERC20, ERC721síel mismo conjunto de endpoints que Ethereum, bajo /arbitrum
TronTRXTRC10, TRC20, TRC721sístaking, delegación de recursos, construcción y difusión de transacciones firmadas por usted
BitcoinBTCningunosílos wallets contienen direcciones; una transacción indica el wallet y una speed de fast, medium o slow
SolanaSOLSPLnola clave privada va en cada solicitud de transacción

Solana no tiene endpoints de webhook. Para detectar un ingreso en Solana, consulte el saldo a intervalos o liste las transacciones. En las cadenas EVM y en Tron puede crear en su lugar un webhook.

¿Qué formato tienen las direcciones en cada blockchain?

Sección titulada «¿Qué formato tienen las direcciones en cada blockchain?»

La API valida el formato de cada dirección antes de procesar una solicitud, y responde con el estado 422 y el nombre del campo en errors cuando un formato es incorrecto. Los formatos siguientes son los patrones que define el archivo OpenAPI.

BlockchainFormato de dirección
Ethereum, BNB Smart Chain, Polygon, Arbitrum0x seguido de 40 caracteres hexadecimales
TronT seguido de 33 caracteres alfanuméricos
Bitcoinempieza por bc1, tb1, 1 o 3, y sigue con 25 a 39 caracteres
Solanade 32 a 44 caracteres base58

¿Cómo compruebo que una red está accesible?

Sección titulada «¿Cómo compruebo que una red está accesible?»

Llame a GET /api/v2/{chain}/blocks/number para la blockchain y la red que quiera probar. El endpoint existe en las siete blockchains y devuelve el número del último bloque. Una respuesta con ok: true indica que su token, la ruta y la cabecera X-Network son correctos. Una respuesta 401 con Unauthenticated. apunta al token, y un 404 apunta a una ruta equivocada. Ejecute la llamada una vez para mainnet y otra con X-Network: testnet después de cambiar la configuración.

¿Dónde consigo monedas de testnet y exploradores?

Sección titulada «¿Dónde consigo monedas de testnet y exploradores?»

Las monedas de testnet vienen de faucets que mantienen las comunidades de cada blockchain, no Chaingateway. La documentación para desarrolladores de cada blockchain lista los faucets, exploradores y parámetros de red actuales. Consulte esas páginas antes de probar, porque las testnets se reinician o se sustituyen de vez en cuando.

El inicio rápido muestra una primera solicitud completa. La referencia de la API lista cada endpoint por blockchain, y Gestión de wallets explica cómo se gestionan las direcciones y las claves en cada red.