Máy ảo TRON (TVM) cung cấp một môi trường tương thích EVM hiệu suất cao để triển khai các Hợp đồng thông minh Solidity. Mặc dù chia sẻ phần lớn các công cụ với Ethereum, hướng dẫn này nhấn mạnh các hành vi cụ thể, quan trọng của TVM, bao gồm xử lý timestamp theo mili-giây và logic tự hủy (self-destruct) đã được cập nhật, để đảm bảo việc triển khai an toàn và tối ưu.
block.timestamp tính bằng Mili-giâyTrên Ethereum, block.timestamp trả về thời gian Unix tính bằng giây. Trên TVM, nó trả về thời gian Unix tính bằng mili-giây.
// Task: So sánh các timestamp (dấu thời gian) tính bằng mili-giây theo yêu cầu của TVM.// Phép so sánh này hoạt động trên Ethereum nhưng hoạt động sai trên TRON:require(block.timestamp > 1700000000); // kỳ vọng tính bằng giây
// Chính xác cho TVM — so sánh với mili-giây:require(block.timestamp > 1700000000000); // mili-giây
// Hoặc: sử dụng so sánh tương đối để tránh vấn đề giá trị tuyệt đối:uint256 private deployTime = block.timestamp;require(block.timestamp > deployTime + 30 days * 1000); // 30 ngày tính bằng msSELFDESTRUCT Đã được Cập nhật (Đề xuất 106)Theo lịch sử, opcode selfdestruct đã bị vô hiệu hóa trên TRON. Tuy nhiên, sau khi Đề xuất Quản trị TRON Số 106 được thông qua (Tháng 4 năm 2026), hành vi hiện nay đã căn chỉnh với Ethereum (EIP-6780) để cải thiện tính tương thích của TVM:
selfdestruct được thực thi trong cùng một giao dịch (transaction) mà nó tạo ra Hợp đồng đó.selfdestruct đã được điều chỉnh thành 5000.Hỗ trợ cho TSTORE, TLOAD (EIP-1153) và MCOPY (EIP-5656) đã được thêm vào TVM như một phần của bản nâng cấp GreatVoyage-v4.8.0 (Kant) (Tháng 6 năm 2025). Điều này đảm bảo các nhà phát triển có thể chuyển đổi các hợp đồng sử dụng các bản nâng cấp Cancun/Dencun của Ethereum mà không cần sửa đổi.
Các địa chỉ TRON có kích thước 21 byte ở dạng nội bộ (các địa chỉ Ethereum là 20 byte). Mã hóa ABI bổ sung khoảng trống (pad) thành 32 byte giống như trên EVM, do đó các lệnh gọi Hợp đồng được mã hóa bằng ABI hoạt động bình thường. Tuy nhiên, nếu bạn thực hiện việc thao tác byte thô trên các địa chỉ (ví dụ: trong assembly), hãy tính đến kích thước 21-byte này.
COINBASE Trả về Địa chỉ của SRTrên Ethereum, block.coinbase là địa chỉ của thợ đào/người xác thực. Trên TVM, nó là địa chỉ của Siêu Đại diện (Super Representative) đã tạo ra khối hiện tại. Không sử dụng block.coinbase làm nguồn sinh số ngẫu nhiên — nó có thể dự đoán được và dễ bị SR thao túng.
CREATE với EthereumOpcode CREATE dẫn xuất một địa chỉ Hợp đồng trên TRON theo cách khác với Ethereum. Nếu bạn đang triển khai các Hợp đồng phụ thuộc vào các địa chỉ CREATE mang tính tất định được tính toán off-chain, hãy tính toán lại chúng theo mô hình dẫn xuất địa chỉ của TRON. CREATE2 với một salt rõ ràng hoạt động chính xác cho các địa chỉ mang tính tất định.
transfer() và send() Sử dụng Năng lượngTrên Ethereum, address.transfer(amount) có hạn mức gas cố định là 2,300. Trên TVM, lệnh gọi này tiêu thụ Năng lượng. Các mẫu thiết kế Reentrancy vốn dựa vào giới hạn gas 2,300 để đảm bảo an toàn có thể hoạt động khác biệt. Hãy sử dụng mẫu thiết kế checks-effects-interactions bất kể trường hợp nào.
TronBox hỗ trợ Solidity lên đến phiên bản 0.8.x. Sử dụng pragma ^0.8.0 hoặc ghim vào một phiên bản cụ thể. Solidity 0.8 bao gồm các kiểm tra chống tràn (overflow) tích hợp sẵn, qua đó loại bỏ sự cần thiết của SafeMath.
// Task: Chỉ định phiên bản trình biên dịch Solidity cho TVM.pragma solidity ^0.8.18;TRC-20 có chức năng giống hệt như ERC-20. Toàn bộ tài liệu tham khảo về chữ ký hàm, định nghĩa Sự kiện và các địa chỉ Hợp đồng mainnet đã biết đều có trong Tiêu chuẩn Token. Dưới đây là một TRC-20 hoàn chỉnh, tối giản, có thể triển khai kèm theo các ghi chú dành riêng cho TVM ở bên trong code.
// Task: Đoạn mã này định nghĩa một Hợp đồng token TRC-20 tối giản.// SPDX-License-Identifier: MITpragma solidity ^0.8.18;
/** * @title SimpleTRC20 * @dev Token TRC-20 tối giản có thể triển khai trên TRON. */contract SimpleTRC20 { string public name; string public symbol; uint8 public decimals; uint256 public totalSupply;
mapping(address => uint256) private _balances; mapping(address => mapping(address => uint256)) private _allowances;
event Transfer(address indexed from, address indexed to, uint256 value); event Approval(address indexed owner, address indexed spender, uint256 value);
constructor( string memory _name, string memory _symbol, uint8 _decimals, uint256 _initialSupply ) { name = _name; symbol = _symbol; decimals = _decimals; totalSupply = _initialSupply * 10 ** uint256(_decimals); _balances[msg.sender] = totalSupply; emit Transfer(address(0), msg.sender, totalSupply); }
function balanceOf(address account) external view returns (uint256) { return _balances[account]; }
function transfer(address to, uint256 amount) external returns (bool) { _transfer(msg.sender, to, amount); return true; }
function allowance(address owner, address spender) external view returns (uint256) { return _allowances[owner][spender]; }
function approve(address spender, uint256 amount) external returns (bool) { _allowances[msg.sender][spender] = amount; // Task: Phát Sự kiện Approval (Phê duyệt) để tuân thủ tiêu chuẩn. emit Approval(msg.sender, spender, amount); return true; }
function transferFrom(address from, address to, uint256 amount) external returns (bool) { uint256 current = _allowances[from][msg.sender]; require(current >= amount, "TRC20: insufficient allowance"); unchecked { _allowances[from][msg.sender] = current - amount; } _transfer(from, to, amount); return true; }
// ── Nội bộ (Internal) ──────────────────────────────────────────────────────────
function _transfer(address from, address to, uint256 amount) internal { require(from != address(0), "TRC20: transfer from zero address"); require(to != address(0), "TRC20: transfer to zero address"); uint256 bal = _balances[from]; require(bal >= amount, "TRC20: insufficient balance"); unchecked { _balances[from] = bal - amount; _balances[to] += amount; } emit Transfer(from, to, amount); }}Triển khai bằng TronBox:
// Task: Sử dụng deployer (trình triển khai) của TronBox để di trú Hợp đồng token TRC-20.const SimpleTRC20 = artifacts.require("SimpleTRC20");
module.exports = function (deployer) { deployer.deploy( SimpleTRC20, "My Token", // tên "MTK", // ký hiệu 6, // số thập phân (6 khớp với quy ước USDT trên TRON) 1_000_000 // tổng cung khởi tạo );};Một Hợp đồng ERC-20 OpenZeppelin tiêu chuẩn cũng sẽ triển khai một cách chính xác trên TRON dưới dạng TRC-20. Chỉ cần xem xét lại hai thứ trước khi triển khai: mỗi phép so sánh block.timestamp (nhân ngưỡng với 1000) và cách bạn xử lý selfdestruct (vì hành vi xóa đã được cập nhật).
Mọi opcode đều tốn Năng lượng. Viết mã Solidity tối ưu gas cho Ethereum sẽ tạo ra các hợp đồng tối ưu Năng lượng trên TRON một cách tương tự — các nguyên lý là giống nhau. (Dành cho nhà phát triển Web2: Tối ưu hóa mức sử dụng gas giống như việc tối ưu hóa các truy vấn cơ sở dữ liệu đắt đỏ. Trên các máy chủ truyền thống, các truy vấn tồi chỉ làm chậm mọi thứ; trên các blockchain, chúng trực tiếp tiêu tốn tiền thật của người dùng của bạn).
Đọc và ghi vào bộ nhớ lưu trữ (storage) là các thao tác đắt đỏ nhất. Hãy tối thiểu hóa các lệnh gọi SSTORE:
// Task: Tránh nhiều lệnh gọi SSTORE vào các khe cắm (slots) khác nhau.// Không hiệu quả — ba lần ghi vào bộ nhớ riêng biệtfunction update(uint256 a, uint256 b, uint256 c) external { storedA = a; storedB = b; storedC = c;}// Task: Đóng gói các giá trị vào một cấu trúc (struct) duy nhất để tiết kiệm Năng lượng.struct Config { uint128 a; uint64 b; uint64 c;}Config private config;
function update(uint128 a, uint64 b, uint64 c) external { config = Config(a, b, c); // một lần gọi SSTORE duy nhất cho một khe cắm}Sử dụng các hàm view và pure để đọc dữ liệu. Các lệnh gọi View/pure không tốn Năng lượng khi được gọi off-chain (chúng miễn phí). Chỉ những lệnh gọi làm thay đổi trạng thái mới tốn Năng lượng.
Phát các Sự kiện (Events) thay vì ghi vào bộ nhớ cho các dữ liệu lịch sử. Các Sự kiện được lưu trữ trong nhật ký (rẻ) thay vì trong bộ nhớ hợp đồng (đắt).
Sử dụng calldata thay vì memory cho các tham số hàm khi dữ liệu chỉ để đọc và không bị thay đổi:
// Task: Tránh sao chép các mảng lớn vào bộ nhớ (memory) nếu chỉ để đọc.// Kém hiệu quảfunction process(uint256[] memory data) external { ... }// Task: Sử dụng calldata cho các tham số chỉ đọc để tiết kiệm Năng lượng.// Hiệu quả hơn — dữ liệu không bị sao chép vào bộ nhớfunction process(uint256[] calldata data) external { ... }Xác thực mã nguồn hợp đồng của bạn trên TRONSCAN cho phép người dùng và các nhà phát triển khác đọc logic của bạn, kiểm tra ABI và tương tác trực tiếp thông qua trình khám phá khối.
Các bước xác thực
Đối với các dự án có nhiều tệp (multi-file), hãy sử dụng phương pháp Standard JSON Input, chấp nhận đầu vào của trình biên dịch đầy đủ bao gồm tất cả các tệp được nhập (imported). Đầu ra build/contracts/*.json của TronBox chứa thông tin đầu vào trình biên dịch cần thiết.
Để biết thông tin phân tích đầy đủ về cách Năng lượng và Băng thông hoạt động, hệ số nhân của Mô hình Năng lượng Động (DEM), và cách triển khai ủy quyền phí để dApp của bạn trợ cấp chi phí cho người dùng, hãy xem Mô hình phí & Ủy quyền.
Mọi giao dịch gọi đến một Hợp đồng đều chỉ định một giới hạn phí (fee limit) — mức TRX tối đa mà người gửi sẵn sàng đốt nếu Năng lượng cạn kiệt. Nếu việc thực thi Hợp đồng vượt quá Năng lượng khả dụng và chạm đến giới hạn phí, giao dịch sẽ hoàn tác (reverts) và một phần của giới hạn phí bị tiêu thụ.
Trong tronweb, hãy đặt giới hạn phí cho mỗi lần gọi:
// Task: Chỉ định một giới hạn phí để bảo vệ khỏi các vòng lặp vô hạn/chi phí cao.await contract.someMethod().send({ feeLimit: 1_000_000_000, // Tối đa 1,000 TRX shouldPollResponse: true,});Hãy đặt một mức giới hạn phí rộng rãi trong quá trình phát triển và thắt chặt nó lại sau khi bạn biết chính xác chi phí Năng lượng thực tế từ lịch sử giao dịch TRONSCAN.
Đơn vị Timestamp không khớp
Tất cả các logic dựa trên thời gian đều phải sử dụng mili-giây, chứ không phải giây. Hãy kiểm toán mọi phép so sánh block.timestamp trong các Hợp đồng được di trú.
Hành vi SELFDESTRUCT
Cần lưu ý hành vi SELFDESTRUCT mới (Đề xuất 106): các Hợp đồng không còn bị xóa nữa trừ khi chúng bị hủy ngay trong giao dịch khởi tạo ra chúng. Điều chỉnh logic nâng cấp và dọn dẹp của bạn sao cho phù hợp.
Tính toán địa chỉ off-chain
Nếu các tập lệnh triển khai của bạn tính toán các địa chỉ hợp đồng off-chain (cho các CREATE factories), hãy tính toán lại theo sơ đồ dẫn xuất địa chỉ của TRON.
Đánh giá thấp Năng lượng
Luôn thử nghiệm mức tiêu thụ Năng lượng trên mạng Nile trước khi lên mainnet. Việc đánh giá thấp giới hạn phí sẽ gây ra các lần hoàn tác (reverts) vào những thời điểm tồi tệ nhất.