Mạng lưới

Mạng lưới đại diện cho các mạng blockchain được Fystack hỗ trợ. Bạn có thể truy xuất thông tin về các mạng lưới hiện có, bao gồm cả chuỗi EVM và không phải EVM, cùng với thông tin cấu hình và tình trạng hoạt động của chúng.

Mạng lưới được hỗ trợ

Bảng dưới đây liệt kê các mạng lưới mainnet mà Fystack hiện hỗ trợ cùng với định danh network_code của chúng. Hãy dùng giá trị network_code khi tham chiếu đến một mạng lưới trong request API, webhook hoặc lời gọi SDK.

Mạng lưới	Mã mạng lưới
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`

Bạn cần một mạng lưới không có trong danh sách này? Hãy liên hệ đội ngũ Fystack và chúng tôi có thể ưu tiên bổ sung.

Thông tin mạng lưới

Mỗi mạng lưới trong Fystack chứa thông tin đầy đủ về blockchain:

Thuộc tính mạng lưới

Định danh chuỗi: Chain ID duy nhất và mã nội bộ cho từng mạng lưới
Loại mạng lưới: Hỗ trợ cả mạng lưới EVM và không phải EVM
Tiền tệ native: Token native của từng mạng lưới (ví dụ: ETH, SOL)
Block explorer: URL explorer được cấu hình sẵn cho giao dịch, địa chỉ và token
Trạng thái mạng lưới: Tình trạng RPC và tính sẵn sàng theo thời gian thực
Cấu hình block: Yêu cầu số xác nhận và khoảng thời gian giữa các block
Hỗ trợ testnet: Các mạng thử nghiệm được nhận diện rõ ràng phục vụ phát triển

Lấy danh sách mạng lưới

GET

/networks

Endpoint này cho phép bạn truy xuất các mạng lưới blockchain hiện có. Đây là endpoint công khai, không yêu cầu xác thực.

Tham số

Name
search
Type
string
Description
Lọc mạng lưới theo tên. Ví dụ, ?search=Base sẽ trả về các mạng lưới khớp với "Base".

Response

Name
success
Type
boolean
Description
Cho biết request có thành công hay không.
Name
message
Type
string
Description
Thông điệp mô tả kết quả của thao tác.
Name
code
Type
integer
Description
Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).
Name
data
Type
array
Description
Một mảng các đối tượng mạng lưới.

Name: id
Type: string
Description: UUID của mạng lưới.

Name: created_at
Type: string
Description: Thời điểm mạng lưới được thêm vào hệ thống.

Name: updated_at
Type: string
Description: Thời điểm cấu hình mạng lưới được cập nhật gần nhất.

Name: name
Type: string
Description: Tên hiển thị của mạng lưới.

Name: description
Type: string
Description: Mô tả ngắn gọn về mạng lưới.

Name: is_evm
Type: boolean
Description: Mạng lưới có tương thích với Ethereum Virtual Machine hay không.

Name: chain_id
Type: integer
Description: Định danh chuỗi duy nhất của mạng lưới.

Name: native_currency
Type: string
Description: Ký hiệu của tiền tệ native của mạng lưới.

Name: is_testnet
Type: boolean
Description: Đây có phải là mạng thử nghiệm hay không.

Name: internal_code
Type: string
Description: Mã định danh nội bộ của mạng lưới.

Name: explorer_tx
Type: string
Description: Mẫu URL cho liên kết explorer của giao dịch. Dùng %s làm placeholder cho hash giao dịch.

Name: explorer_address
Type: string
Description: Mẫu URL cho liên kết explorer của địa chỉ. Dùng %s làm placeholder cho địa chỉ.

Name: explorer_token
Type: string
Description: Mẫu URL cho liên kết explorer của token. Dùng %s làm placeholder cho địa chỉ token.

Name: confirmation_blocks
Type: integer
Description: Số block xác nhận cần thiết để một giao dịch được coi là hoàn tất.

Name: block_interval_in_seconds
Type: integer
Description: Thời gian trung bình giữa các block, tính bằng giây.

Name: disabled
Type: boolean
Description: Mạng lưới hiện có đang bị vô hiệu hóa hay không.

Name: logo_url
Type: string
Description: URL dẫn đến hình ảnh logo của mạng lưới.

Name: is_rpc_active
Type: boolean
Description: RPC endpoint hiện có đang hoạt động hay không.

Name: rpc_health_status
Type: string
Description: Tình trạng hiện tại của RPC endpoint. Có thể là healthy, degraded hoặc null.

Name: pending_block_count
Type: integer
Description: Số block đang chờ xử lý.

Endpoint này là công khai và không yêu cầu xác thực. Bạn có thể dùng nó để truy xuất thông tin mạng lưới mà không cần thông tin xác thực 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
    }
  ]
}

Quét lại giao dịch

POST

/networks/rescan-transaction

Endpoint này cho phép bạn kích hoạt thủ công việc quét lại một giao dịch cụ thể trên một mạng lưới. Điều này hữu ích trong trường hợp một giao dịch chưa được lập chỉ mục sau một khoảng thời gian do RPC gặp sự cố. Bạn có thể kích hoạt quét lại thủ công để hệ thống lập chỉ mục giao dịch đó.

Endpoint này yêu cầu access token của người dùng và quyền quản trị viên hệ thống.

Tham số

Name
tx_hash
Type
string
Required
required
Description
Hash của giao dịch cần quét lại.
Name
network_id
Type
string
Required
required
Description
UUID của mạng lưới nơi giao dịch diễn ra.

Response

Name
success
Type
boolean
Description
Cho biết yêu cầu quét lại có thành công hay không.
Name
message
Type
string
Description
Thông điệp mô tả kết quả của thao tác.
Name
code
Type
integer
Description
Mã số cho biết trạng thái kết quả (0 nghĩa là thành công).

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"
  }
}