Redes
Las redes representan las redes blockchain compatibles con Fystack. Puedes obtener información sobre las redes disponibles, incluidas cadenas EVM y no EVM, junto con sus detalles de configuración y su estado de salud.
Redes compatibles
La siguiente tabla lista las redes mainnet que Fystack admite actualmente junto con su identificador network_code. Usa el valor de network_code para hacer referencia a una red en las solicitudes a la API, los webhooks o las llamadas al SDK.
| Red | Código de red |
|---|---|
| Ethereum | ETHEREUM_MAINNET |
| Base | BASE_MAINNET |
| Solana | SOL_MAINNET |
| Polygon | POLYGON_MAINNET |
| BNB Smart Chain | BSC_MAINNET |
| Lisk | LISK_MAINNET |
| Bitcoin | BTC_MAINNET |
| Tron | TRON_MAINNET |
¿Necesitas una red que no aparece aquí? Contacta al equipo de Fystack y podemos priorizar su incorporación.
Información de las redes
Cada red en Fystack contiene información completa sobre la blockchain:
Propiedades de la red
- Identificación de la cadena: chain ID único y código interno de cada red
- Tipo de red: compatibilidad con redes EVM y no EVM
- Moneda nativa: el token nativo de cada red (por ejemplo, ETH, SOL)
- Exploradores de bloques: URLs de exploradores preconfiguradas para transacciones, direcciones y tokens
- Estado de la red: estado de salud y disponibilidad del RPC en tiempo real
- Configuración de bloques: requisitos de confirmación e intervalo entre bloques
- Soporte de testnets: redes de prueba claramente identificadas para desarrollo
Obtener redes
Este endpoint te permite obtener las redes blockchain disponibles. Es un endpoint público que no requiere autenticación.
Parámetros
- Name
- search
- Type
- string
- Description
Filtra las redes por nombre. Por ejemplo,
?search=Basedevolverá las redes que coincidan con "Base".
Respuesta
- Name
- success
- Type
- boolean
- Description
Indica si la solicitud se realizó correctamente.
- Name
- message
- Type
- string
- Description
Un mensaje que describe el resultado de la operación.
- Name
- code
- Type
- integer
- Description
Un código numérico que indica el estado del resultado (0 si fue exitoso).
- Name
- data
- Type
- array
- Description
Un array de objetos de red.
- Name
- id
- Type
- string
- Description
El UUID de la red.
- Name
- created_at
- Type
- string
- Description
Marca de tiempo en que la red se agregó al sistema.
- Name
- updated_at
- Type
- string
- Description
Marca de tiempo de la última actualización de la configuración de la red.
- Name
- name
- Type
- string
- Description
El nombre visible de la red.
- Name
- description
- Type
- string
- Description
Una breve descripción de la red.
- Name
- is_evm
- Type
- boolean
- Description
Indica si es una red compatible con la Ethereum Virtual Machine.
- Name
- chain_id
- Type
- integer
- Description
El identificador único de cadena de la red.
- Name
- native_currency
- Type
- string
- Description
El símbolo de la moneda nativa de la red.
- Name
- is_testnet
- Type
- boolean
- Description
Indica si es una red de prueba.
- Name
- internal_code
- Type
- string
- Description
Código identificador interno de la red.
- Name
- explorer_tx
- Type
- string
- Description
Plantilla de URL para los enlaces del explorador de transacciones. Usa
%scomo marcador del hash de la transacción.
- Name
- explorer_address
- Type
- string
- Description
Plantilla de URL para los enlaces del explorador de direcciones. Usa
%scomo marcador de la dirección.
- Name
- explorer_token
- Type
- string
- Description
Plantilla de URL para los enlaces del explorador de tokens. Usa
%scomo marcador de la dirección del token.
- Name
- confirmation_blocks
- Type
- integer
- Description
Número de confirmaciones de bloque necesarias para considerar final una transacción.
- Name
- block_interval_in_seconds
- Type
- integer
- Description
Tiempo promedio entre bloques, en segundos.
- Name
- disabled
- Type
- boolean
- Description
Indica si la red está desactivada actualmente.
- Name
- logo_url
- Type
- string
- Description
URL de la imagen del logo de la red.
- Name
- is_rpc_active
- Type
- boolean
- Description
Indica si el endpoint RPC está activo actualmente.
- Name
- rpc_health_status
- Type
- string
- Description
Estado de salud actual del endpoint RPC. Puede ser
healthy,degradedonull.
- Name
- pending_block_count
- Type
- integer
- Description
Número de bloques pendientes en procesamiento.
Este endpoint es público y no requiere autenticación. Puedes usarlo para obtener información de las redes sin credenciales de API.
Request
curl -X GET https://api.fystack.io/api/v1/networks
Response
200{
"success": true,
"message": "success",
"code": 0,
"data": [
{
"id": "23d13c03-1f3c-4e2a-9aef-1771a244b7f6",
"created_at": "2024-01-05T09:05:25.629202+07:00",
"updated_at": "2025-07-18T12:34:07.91766+07:00",
"name": "Sepolia Ethereum Testnet",
"description": "Sepolia testnet",
"is_evm": true,
"chain_id": 11155111,
"native_currency": "ETH",
"is_testnet": true,
"internal_code": "ETHER_SEPOLIA_TESTNET",
"explorer_tx": "https://sepolia.etherscan.io/tx/%s",
"explorer_address": "https://sepolia.etherscan.io/address/%s",
"explorer_token": "https://sepolia.etherscan.io/token/%s",
"confirmation_blocks": 1,
"block_interval_in_seconds": 15,
"disabled": false,
"logo_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-lzp6jMVVHdxHiK4q5Xy2FbJIrC-GPmTREA&s",
"is_rpc_active": true,
"rpc_health_status": "healthy",
"pending_block_count": 8
},
{
"id": "f8d7d8b9-3466-405c-a8c9-542366f95f39",
"created_at": "2025-03-01T22:21:44.604716+07:00",
"updated_at": "2025-08-03T21:47:21.917315+07:00",
"name": "Base mainnet",
"description": "Base mainnets",
"is_evm": true,
"chain_id": 8453,
"native_currency": "ETH",
"internal_code": "BASE_MAINNET",
"explorer_tx": "https://basescan.org/tx/%s",
"explorer_address": "https://basescan.org/address/%s",
"explorer_token": "https://basescan.org/token/%s",
"confirmation_blocks": 20,
"block_interval_in_seconds": 2,
"disabled": false,
"logo_url": "https://avatars.githubusercontent.com/u/108554348?v=4",
"is_rpc_active": false,
"rpc_health_status": null,
"pending_block_count": 25438
}
]
}
Reescanear una transacción
Este endpoint te permite iniciar manualmente el reescaneo de una transacción específica en una red. Es útil cuando una transacción no se indexa después de cierto tiempo debido a caídas del RPC. Puedes iniciar manualmente un reescaneo para que el sistema indexe la transacción.
Este endpoint requiere un token de acceso de usuario y permisos de administrador del sistema.
Parámetros
- Name
- tx_hash
- Type
- string
- Required
- required
- Description
El hash de la transacción que se va a reescanear.
- Name
- network_id
- Type
- string
- Required
- required
- Description
El UUID de la red en la que ocurrió la transacción.
Respuesta
- Name
- success
- Type
- boolean
- Description
Indica si la solicitud de reescaneo se realizó correctamente.
- Name
- message
- Type
- string
- Description
Un mensaje que describe el resultado de la operación.
- Name
- code
- Type
- integer
- Description
Un código numérico que indica el estado del resultado (0 si fue exitoso).
Request
import { FystackSDK, Environment } from "@fystack/sdk"const apiCredentials = {apiKey: process.env.API_KEY,apiSecret: process.env.API_SECRET}const sdk = new FystackSDK({credentials: apiCredentials,environment: Environment.Sandbox,logger: true})await sdk.rescanTransaction({txHash: 'a6ec569aa7db70433e9012eb456cd24156d33c1748825f0d868d2d4e2595cb06',networkId: 'c5725221-fa98-4d6c-a6ca-8c5cd65cd884'})
Response
200{
"success": true,
"message": "success",
"code": 0,
"data": {
"message": "Transaction block added to rescan queue successfully"
}
}