FTC Chain Developer & User Guide

Hướng dẫn FTC Chain & dApp

Tài liệu hướng dẫn chi tiết cách kết nối ví MetaMask và xây dựng, triển khai dApp trên nền tảng Blockchain FiotechChain (FTC Chain).

1. Kết nối MetaMask với FTC Chain

Thông số RPC, Chain ID, và nút bấm 1-click tự động thêm mạng FTC Chain vào ví.

2. Xây dựng dApp trên FTC Chain

Hướng dẫn viết Smart Contract Solidity, deploy bằng Hardhat và kết nối frontend Ethers.js.

Phần 1: Hướng dẫn kết nối ví MetaMask với FTC Chain

Mạng **FiotechChain (FTC Chain)** tương thích 100% với Ethereum Virtual Machine (EVM), cho phép bạn sử dụng ví MetaMask, Trust Wallet hoặc Coinbase Wallet một cách mượt mà.

Thêm nhanh mạng vào MetaMask (1-Click)

Nhấn nút bên cạnh để tự động cấu hình RPC & Chain ID vào ví của bạn.

Thông số mạng cấu hình thủ công

Network Name (Tên mạng)

FiotechChain Mainnet

RPC URL (Địa chỉ RPC)

https://rpc.fiotech.org

Chain ID (Mã chuỗi)

9999 (Hex: 0x270F)

Currency Symbol (Ký hiệu)

FTC

Block Explorer URL

https://scan.fiotech.org

Network Type

EVM Compatible PoS + BFT

Các bước cấu hình thủ công trên tiện ích MetaMask:

Mở tiện ích mở rộng **MetaMask** trên trình duyệt, nhấn vào menu chọn mạng ở góc trên cùng bên trái.

Chọn **"Add Network" (Thêm mạng)**, sau đó cuộn xuống chọn **"Add a network manually" (Thêm mạng thủ công)**.

Nhập chính xác các thông số mạng: RPC: https://rpc.fiotech.org, Chain ID: 9999, Symbol: FTC.

Nhấn **"Save" (Lưu)**. Ví của bạn đã sẵn sàng giao dịch và tương tác với hệ sinh thái FTC Chain!

Phần 2: Hướng dẫn tạo dApp trên Blockchain FTC Chain

Xây dựng ứng dụng phi tập trung (dApp) trên FTC Chain rất đơn giản vì nền tảng hỗ trợ 100% Solidity, EVM Tooling (Hardhat, Foundry, Remix, Truffle) và thư viện Web3 tiêu chuẩn (`ethers.js`, `viem`, `web3.js`).

B1Viết Smart Contract (Solidity)

Tạo tệp hợp đồng thông minh contracts/FTCSimpleStorage.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

/**
 * @title FTCSimpleStorage
 * @dev Smart contract mẫu trên FiotechChain (FTC)
 */
contract FTCSimpleStorage {
    string private message;
    address public owner;

    event MessageUpdated(address indexed updatedBy, string newMessage);

    constructor(string memory initialMessage) {
        owner = msg.sender;
        message = initialMessage;
    }

    function setMessage(string memory newMessage) public {
        message = newMessage;
        emit MessageUpdated(msg.sender, newMessage);
    }

    function getMessage() public view returns (string memory) {
        return message;
    }
}

B2Cấu hình Hardhat để Deploy lên FTC Chain

Cập nhật cấu hình RPC và Chain ID 9999 trong hardhat.config.js:

// hardhat.config.js
require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: "0.8.20",
  networks: {
    ftcChain: {
      url: "https://rpc.fiotech.org",
      chainId: 9999,
      accounts: [process.env.PRIVATE_KEY] // 0x...
    }
  }
};

$ npx hardhat run scripts/deploy.js --network ftcChain

B3Tích hợp Frontend dApp với Smart Contract (Ethers.js)

Gọi hàm đọc dữ liệu (view) và gửi giao dịch (transaction) từ giao diện React/Next.js:

import { ethers } from "ethers";

// 1. Kết nối với MetaMask
const provider = new ethers.BrowserProvider(window.ethereum);
const signer = await provider.getSigner();

// 2. Địa chỉ & ABI của Contract đã deploy trên FTC Chain
const contractAddress = "0xYourContractAddressHere";
const contractABI = [
  "function getMessage() view returns (string)",
  "function setMessage(string memory newMessage)"
];

const contract = new ethers.Contract(contractAddress, contractABI, signer);

// 3. Đọc dữ liệu từ Blockchain FTC
const currentMessage = await contract.getMessage();
console.log("Current Message:", currentMessage);

// 4. Ghi dữ liệu (Gửi Transaction)
const tx = await contract.setMessage("Hello FTC Chain!");
await tx.wait(); // Chờ xác thực khối (khoảng 2s)

Cần hỗ trợ kỹ thuật hoặc cấp phát Token Testnet?

Sử dụng FiotechChain Faucet hoặc tham gia nhóm hỗ trợ kỹ thuật nhà phát triển.

Block Explorer Cloud Dashboard