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

GET
/networks

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=Base devolverá 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 %s como marcador del hash de la transacción.

  • Name
    explorer_address
    Type
    string
    Description

    Plantilla de URL para los enlaces del explorador de direcciones. Usa %s como marcador de la dirección.

  • Name
    explorer_token
    Type
    string
    Description

    Plantilla de URL para los enlaces del explorador de tokens. Usa %s como 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, degraded o null.

  • 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

GET
/networks
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

POST
/networks/rescan-transaction

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

POST
/networks/rescan-transaction
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"
  }
}