--- title: "Mạng lưới" description: "Hướng dẫn này giải thích cách truy xuất và quản lý các mạng lưới blockchain bằng Fystack API." url: https://docs.fystack.io/vi/networks last_updated: 2026-11-13 --- > ## Documentation index > Fetch the complete documentation index at: https://docs.fystack.io/llms.txt > Use it to discover all available pages before exploring further. # 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` | > **Info.** 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 **Endpoint:** `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ố - `search` (string): 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 - `success` (boolean): Cho biết request có thành công hay không. - `message` (string): Thông điệp mô tả kết quả của thao tác. - `code` (integer): Mã số cho biết trạng thái kết quả (0 nghĩa là thành công). - `data` (array): Một mảng các đối tượng mạng lưới. - `id` (string): UUID của mạng lưới. - `created_at` (string): Thời điểm mạng lưới được thêm vào hệ thống. - `updated_at` (string): Thời điểm cấu hình mạng lưới được cập nhật gần nhất. - `name` (string): Tên hiển thị của mạng lưới. - `description` (string): Mô tả ngắn gọn về mạng lưới. - `is_evm` (boolean): Mạng lưới có tương thích với Ethereum Virtual Machine hay không. - `chain_id` (integer): Định danh chuỗi duy nhất của mạng lưới. - `native_currency` (string): Ký hiệu của tiền tệ native của mạng lưới. - `is_testnet` (boolean): Đây có phải là mạng thử nghiệm hay không. - `internal_code` (string): Mã định danh nội bộ của mạng lưới. - `explorer_tx` (string): 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. - `explorer_address` (string): Mẫu URL cho liên kết explorer của địa chỉ. Dùng `%s` làm placeholder cho địa chỉ. - `explorer_token` (string): Mẫu URL cho liên kết explorer của token. Dùng `%s` làm placeholder cho địa chỉ token. - `confirmation_blocks` (integer): Số block xác nhận cần thiết để một giao dịch được coi là hoàn tất. - `block_interval_in_seconds` (integer): Thời gian trung bình giữa các block, tính bằng giây. - `disabled` (boolean): Mạng lưới hiện có đang bị vô hiệu hóa hay không. - `logo_url` (string): URL dẫn đến hình ảnh logo của mạng lưới. - `is_rpc_active` (boolean): RPC endpoint hiện có đang hoạt động hay không. - `rpc_health_status` (string): Tình trạng hiện tại của RPC endpoint. Có thể là `healthy`, `degraded` hoặc `null`. - `pending_block_count` (integer): Số block đang chờ xử lý. > **Info.** 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` ```bash curl -X GET https://api.fystack.io/api/v1/networks ``` ```bash curl -X GET "https://api.fystack.io/api/v1/networks?search=Base" ``` ```json { "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 **Endpoint:** `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 đó. > **Warning.** 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ố - `tx_hash` (string, required): Hash của giao dịch cần quét lại. - `network_id` (string, required): UUID của mạng lưới nơi giao dịch diễn ra. ### Response - `success` (boolean): Cho biết yêu cầu quét lại có thành công hay không. - `message` (string): Thông điệp mô tả kết quả của thao tác. - `code` (integer): 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` ```typescript 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' }) ``` ```bash curl -X POST https://api.fystack.io/api/v1/networks/rescan-transaction \ -H "Authorization: Bearer your_access_token" \ -H "Content-Type: application/json" \ -d '{ "tx_hash": "a6ec569aa7db70433e9012eb456cd24156d33c1748825f0d868d2d4e2595cb06", "network_id": "c5725221-fa98-4d6c-a6ca-8c5cd65cd884" }' ``` ```json { "success": true, "message": "success", "code": 0, "data": { "message": "Transaction block added to rescan queue successfully" } } ```