Tham khảo nhanh cho nhà phát triển

Truy cập tức thì vào các thông số thiết yếu, endpoint mạng lưới và các đoạn mã cần thiết để phát triển trên TRON. Tài liệu tham khảo nhanh này bao gồm các cấu hình Mainnet và Testnet, các địa chỉ TRC-20 đã được xác minh và các mẫu khởi tạo SDK cốt lõi để giữ cho quy trình làm việc của bạn nhanh chóng và hiệu quả.

Các endpoint của mạng lưới

Mainnet

Mainnet

# Task: Lưu ý các endpoint RPC và Chain ID chính thức của Mainnet.
HTTP API (TronGrid):   https://api.trongrid.io
JSON-RPC (EVM):        https://api.trongrid.io/jsonrpc
gRPC:                  grpc.trongrid.io:50051
EVM Chain ID:          728126428  (0x2B6653DC)

Nile Testnet

Nile Testnet

# Task: Lưu ý các endpoint RPC và Chain ID chính thức của Nile Testnet.
HTTP API:              https://nile.trongrid.io
JSON-RPC (EVM):        https://nile.trongrid.io/jsonrpc
EVM Chain ID:          3448148188  (0xcd8690dc)
Faucet:                https://nileex.io/join/getJoinPage
Explorer:              https://nile.tronscan.org

Shasta Testnet

Shasta Testnet

# Task: Lưu ý các endpoint RPC và Chain ID chính thức của Shasta Testnet.
HTTP API:              https://api.shasta.trongrid.io
EVM Chain ID:          2494104990  (0x94a9059e)
Faucet:                https://shasta.tronex.io
Explorer:              https://shasta.tronscan.org

Khóa API (API keys)

Việc truy cập Mainnet TronGrid sẽ tốt hơn nếu có khóa API (tiêu đề TRON-PRO-API-KEY). Đăng ký miễn phí tại trongrid.io. Các endpoint Testnet không yêu cầu khóa.

---

Các địa chỉ Hợp đồng đã xác minh (Mainnet)

Các Hợp đồng Mainnet

# Task: Sử dụng các địa chỉ TRC-20 đã được xác minh này để tích hợp Mainnet.
USDT (TRC-20):    TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDD (TRC-20):    TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn
stUSDT (TRC-20):  TThzxNRLrW2Brp9DcTQU8i4Wd9udCWEdZ3
wstUSDT (TRC-20): TGkxzkDKyMeq2T7edKnyjZoFypyzjkkssq
WTRX (TRC-20):    TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
SUN  (TRC-20):    TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
JST  (TRC-20):    TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
BTT  (TRC-20):    TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
WIN  (TRC-20):    TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7

Các địa chỉ USDT Testnet

USDT Testnet

# Task: Sử dụng các địa chỉ này để tích hợp USDT trên các mạng Testnet của TRON.
Nile Testnet:     TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf
Shasta Testnet:   TDZDd58a44n5Bvg7pfpcdWhZpv7XSt9PsU

---

Khởi tạo tronweb

Mainnet (có khóa API)

init_mainnet.js

// Task: Khởi tạo TronWeb cho Mainnet bằng Khóa Pro API.
import TronWeb from "tronweb"

const tronWeb = new TronWeb({
  fullHost: 'https://api.trongrid.io',
  headers: { 'TRON-PRO-API-KEY': 'your-api-key-here' },
  privateKey: 'your-private-key-here', // bỏ qua nếu chỉ để đọc
});

Nile Testnet

init_nile.js

// Task: Khởi tạo TronWeb cho mạng Nile Testnet.
const tronWeb = new TronWeb({
  fullHost: 'https://nile.trongrid.io',
  privateKey: 'your-private-key-here',
});

Chỉ đọc / trình duyệt (tiêm từ TronLink)

init_injected.js

// Task: Kết nối tới thể hiện window.tronWeb được tiêm bởi TronLink.
if (window.tronWeb && window.tronWeb.ready) {
  const tronWeb = window.tronWeb;
  const address = tronWeb.defaultAddress.base58; // ví dụ: TJY...
} else {
  console.warn('TronLink chưa được cài đặt hoặc đang bị khóa');
}

---

Các lệnh gọi HTTP API phổ biến

Terminal

# Task: Các truy vấn tài khoản và giao dịch phổ biến thông qua HTTP thô.
# Lấy thông tin tài khoản
curl https://api.trongrid.io/v1/accounts/{address}

# Lấy số dư TRX (trả về dưới dạng SUN)
curl https://api.trongrid.io/v1/accounts/{address} | jq '.data[0].balance'

# Lấy số dư token TRC-20
curl "https://api.trongrid.io/v1/accounts/{address}/tokens?token_id=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&token_type=trc20"

# Lấy khối mới nhất
curl https://api.trongrid.io/wallet/getnowblock

# Phát một giao dịch đã được ký lên mạng lưới
curl -X POST https://api.trongrid.io/wallet/broadcasttransaction \
  -H 'Content-Type: application/json' \
  -d '{"transaction": {...}}'

---

Tương tác Hợp đồng TRC-20 (tronweb)

trc20_ops.js

// Task: Tải một hợp đồng và thực hiện kiểm tra số dư/chuyển khoản TRC-20.
const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
const contract = await tronWeb.contract().at(USDT);

// Lấy số dư
const balance = await contract.balanceOf(address).call();
const usdtAmount = tronWeb.toBigNumber(balance).div(1e6).toFixed(6);

// Chuyển khoản
const amount = tronWeb.toSun(10);
await contract.transfer(recipientAddress, amount).send();

---

Các Tiện ích Địa chỉ

address_utils.js

// Task: Chuyển đổi và xác thực các địa chỉ TRON giữa Hex và Base58.
// Chuyển đổi hex sang Base58
const base58 = tronWeb.address.fromHex('0x41....');

// Chuyển đổi Base58 sang hex
const hex = tronWeb.address.toHex('TXXX...');

// Xác thực
const isValid = tronWeb.isAddress('TXXX...');

---

Các Tiện ích Bổ sung cho Nhà phát triển

Kiểm tra Metadata TRC-20

token_metadata.js

// Task: Lấy decimals và symbol cho bất kỳ token TRC-20 nào.
const contract = await tronWeb.contract().at('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');
const [symbol, decimals, name] = await Promise.all([
  contract.symbol().call(),
  contract.decimals().call(),
  contract.name().call()
]);
console.log(`${name} (${symbol}): ${decimals} số thập phân`);

Kích hoạt một Tài khoản Mới

Phí kích hoạt tài khoản

Các tài khoản mới phải được kích hoạt trước khi chúng có thể thực hiện giao dịch.

• Chuyển khoản TRX: ~1.1 TRX tổng cộng (1 TRX Phí mạng giao thức + ~0.1 TRX cho Băng thông).
• Chuyển khoản USDT: 13–15 TRX tổng cộng (cao hơn do chi phí Năng lượng để thực thi hợp đồng).

Theo lịch sử, phí là 0.1 TRX, nhưng đã được tăng lên 1 TRX thông qua Đề xuất #67 (Năm 2021) nhằm ngăn chặn thư rác tạo tài khoản hàng loạt.

---

Các điểm Khác biệt chính của TVM so với EVM

Hành vi	Ethereum / EVM	TRON / TVM
block.timestamp	Số giây tính từ kỷ nguyên (epoch)	Số mili-giây tính từ kỷ nguyên (epoch)
SELFDESTRUCT	EIP-6780 (Chỉ chuyển tài sản)	Căn chỉnh với EIP-6780 (Đề xuất 106)
Mã hóa địa chỉ	address = 20-byte hex	address = 20-byte, nhưng là Base58 trong các công cụ
Mô hình phí	Phí Gas (ETH trên mỗi đơn vị)	Năng lượng (từ việc Khóa TRX) + Băng thông (mỗi byte)
Precompiles	Tập hợp EVM đầy đủ	Một phần — một số precompiles hoạt động khác nhau
tx.origin	Được phép	Được phép nhưng có cùng cảnh báo như EVM

---

Các Thông số Mạng lưới

Thông số	Giá trị
Thời gian khối	~3 giây
Tính hữu hạn (Finality)	~19 khối (~57 giây)
Tỷ lệ đốt Năng lượng	100 SUN mỗi đơn vị Năng lượng
Tỷ lệ đốt Băng thông	1,000 Băng thông mỗi TRX
Băng thông miễn phí mỗi tài khoản/ngày	600 điểm
Chi phí Năng lượng chuyển USDT	~65,000 (tài khoản hiện có) – ~130,000 (tài khoản mới); Có thể lên tới 140k+ vào lúc tắc nghẽn đỉnh điểm
Phần thưởng khối	8 TRX (cho SR tạo khối)
Phần thưởng biểu quyết	128 TRX mỗi khối (được phân phối cho 127 SR hàng đầu)

---

Các Liên kết Hữu ích

Tài nguyên	URL
Tài liệu Nhà phát triển TRON	developers.tron.network
Khóa API TronGrid	trongrid.io
TRONSCAN (mainnet)	tronscan.org
TronBox (npm)	npm install -g tronbox
tronweb (npm)	npm install tronweb
Kho lưu trữ TIP	github.com/tronprotocol/tips
Node đầy đủ java-tron	github.com/tronprotocol/java-tron