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/....
¿A qué redes puedo acceder con la API?
Sección titulada «¿A qué redes puedo acceder con la API?»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 red | Blockchain | Red | Valor de la cabecera X-Network |
|---|---|---|---|
| Mainnet | Ethereum | mainnet | mainnet |
| Testnet | Ethereum | sepolia | testnet |
| Mainnet | Tron | mainnet | mainnet |
| Testnet | Tron | nile | testnet |
| Mainnet | Binance Smart Chain | mainnet | mainnet |
| Testnet | Binance Smart Chain | testnet | testnet |
| Mainnet | Bitcoin | mainnet | mainnet |
| Testnet | Bitcoin | testnet3 | testnet |
| Mainnet | Polygon | mainnet | mainnet |
| Testnet | Polygon | amoy | testnet |
| Mainnet | Arbitrum | mainnet | mainnet |
| Testnet | Arbitrum | arbitrum sepolia | testnet |
| Mainnet | Solana | mainnet | mainnet |
| Testnet | Solana | devnet | testnet |
¿Cómo cambio entre mainnet y testnet?
Sección titulada «¿Cómo cambio entre mainnet y testnet?»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.
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.
| Blockchain | Moneda nativa en la API | Estándares de token | Webhooks | Notas |
|---|---|---|---|---|
| Ethereum | ETH | ERC20, ERC721 | sí | gasprice y consultas del propietario y la URI de NFT |
| Binance Smart Chain | BNB | BEP20, BEP721 | sí | el mismo conjunto de endpoints que Ethereum, bajo /bsc |
| Polygon | MATIC | ERC20, ERC721 | sí | el mismo conjunto de endpoints que Ethereum, bajo /polygon |
| Arbitrum | ETH | ERC20, ERC721 | sí | el mismo conjunto de endpoints que Ethereum, bajo /arbitrum |
| Tron | TRX | TRC10, TRC20, TRC721 | sí | staking, delegación de recursos, construcción y difusión de transacciones firmadas por usted |
| Bitcoin | BTC | ninguno | sí | los wallets contienen direcciones; una transacción indica el wallet y una speed de fast, medium o slow |
| Solana | SOL | SPL | no | la 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.
| Blockchain | Formato de dirección |
|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | 0x seguido de 40 caracteres hexadecimales |
| Tron | T seguido de 33 caracteres alfanuméricos |
| Bitcoin | empieza por bc1, tb1, 1 o 3, y sigue con 25 a 39 caracteres |
| Solana | de 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.
- Ethereum: resumen de redes con testnets y faucets.
- TRON: documentación de redes para mainnet y la testnet Nile.
- BNB Smart Chain: documentación para desarrolladores y la lista de endpoints JSON-RPC.
- Polygon: referencia de endpoints RPC para Amoy.
- Arbitrum: información de las cadenas para Arbitrum One y Arbitrum Sepolia.
- Bitcoin: guía de pruebas para testnet y regtest.
- Solana: documentación de clústeres para devnet.
¿Dónde puedo leer más?
Sección titulada «¿Dónde puedo leer más?»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.