智能合约简介

📘

前置阅读

• 智能合约概览

什么是智能合约

智能合约是部署在 TRON 区块链上的应用软件。合约一旦成功部署，其代码便无法篡改（采用可升级模式的合约除外）。网络所有节点以一致方式执行该合约，产生可信、可验证的状态转换。智能合约本质上是一种特殊的 TRON 账户：有独立地址和余额，在被外部账户调用时可执行内部转账或跨合约调用。但它不受任何用户的直接控制，而是完全按照预先编写的代码逻辑运行。普通用户账户可以通过提交“调用合约特定函数”的交易与智能合约进行交互，这些交互操作一旦在区块链上确认，便不可逆转。

在 TRON 网络中，智能合约在 TRON 虚拟机（TVM） 内运行。TVM 是一个确定性的、基于栈的运行环境，在大多数 opcode 上与以太坊 EVM 兼容，并增加了 TRC-10、质押、投票等 TRON 专有指令。因此，绝大多数为以太坊编写的 Solidity 合约，只需针对 TRON 的少数特性（地址格式、用能量代替 Gas 等）做少量修改，即可部署到 TRON 上。有关如何将以太坊合约移植到 TRON 的详细指南，请参阅从以太坊迁移。

智能合约可以类比为自动售货机：输入正确，输出确定。自动售货机的核心逻辑是 投币 + 选择商品 = 自动出货。智能合约也是如此——代码中预先编写好运行逻辑，用户发送的交易作为输入，最终执行并产出可验证的链上状态变更。

示例：一个简单的自动售货机合约

pragma solidity 0.8.7;

contract VendingMachine {

    // Declare state variables of the contract
    address public owner;
    mapping (address => uint) public cupcakeBalances;

    // When 'VendingMachine' contract is deployed:
    // 1. set the deploying address as the owner of the contract
    // 2. set the deployed smart contract's cupcake balance to 100
    constructor() {
        owner = msg.sender;
        cupcakeBalances[address(this)] = 100;
    }

    // Allow the owner to increase the smart contract's cupcake balance
    function refill(uint amount) public {
        require(msg.sender == owner, "Only the owner can refill.");
        cupcakeBalances[address(this)] += amount;
    }

    // Allow anyone to purchase cupcakes
    function purchase(uint amount) public payable {
        require(msg.value >= amount * 1 trx, "You must pay at least 1 TRX per cupcake");
        require(cupcakeBalances[address(this)] >= amount, "Not enough cupcakes in stock to complete this purchase");
        cupcakeBalances[address(this)] -= amount;
        cupcakeBalances[msg.sender] += amount;
    }
}

正如自动售货机免去了人工售货员一样，智能合约网络能够在许多行业和场景中帮助人们省去对中间信用机构的依赖。

智能合约的特性

无需许可

TRON 网络是一个无需许可的开放平台，任何人都可以编写并部署智能合约。部署前需要掌握智能合约编程语言，并确保账户内有足够的 TRX 或资源。部署智能合约本质上是一笔特殊交易（CreateSmartContract 类型）：交易大小会消耗带宽，在链上存储字节码和运行构造函数会消耗能量。有关如何预估部署能耗与费用的详细说明，请参阅 FeeLimit 与能量成本。

TRON 为开发者提供了主流且友好的智能合约编程语言 Solidity。在将合约部署上链前，必须先将其编译为 TVM 字节码。部署成功后，这些字节码将被存储在合约的链上地址中。每当有用户或合约调用该地址时，TVM 便会读取并执行这些字节码指令。

可组合性

部署在 TRON 网络上的所有智能合约都是公开可见的，可以视为开放 API。应用可以在自己的智能合约中直接调用其他已部署合约，扩展业务能力；一个合约也可以动态创建并部署另一个合约。DApp 开发者无需每次都从零开始，可以组合和复用链上现有合约。例如，应用可以直接整合现有的 SunSwap 合约，处理 Token 兑换的底层逻辑。

智能合约的局限性

智能合约无法直接与外部世界通信

智能合约无法直接与链外的外部系统进行通信，因此它们无法自主获取现实世界中的实时数据。虽然这种限制使得合约的使用场景受到一定局限，但这属于区块链的核心安全设计——直接依赖外部不确定性数据会破坏区块链节点的共识机制，而共识是保障网络安全和去中心化的基石。为了解决这一痛点，通常需要借助“预言机”（Oracle）将经过签名的外部数据安全地上链，供智能合约读取。

最大执行时间

为了确保网络的高吞吐量与稳定运行， TRON 对单笔交易的 CPU 执行时间设定了上限，当前主网值为 80 毫秒。由于 TRON 的出块时间仅为 3 秒，因此这一时长限制对于保障出块稳定性至关重要。该限制受链参数 #13（API 键为 getMaxCpuTimeOfOneTx）控制，超级代表（SR）委员会可以通过发起提案并投票来动态调整。编写合约时应调用 /wallet/getchainparameters 查 getMaxCpuTimeOfOneTx 获取最新值，不要硬编码。

对于复杂合约，执行过程中如果超出时限，会触发 OUT_OF_TIME 异常。一旦发生该错误，无论交易执行到了哪个阶段，调用者账户中为该笔交易设置的 fee_limit 额度都将被扣除。为了规避此风险，建议将大型合约拆解为“主合约 + 多个小型辅助合约”的架构（例如模块化合约中介绍的“卫星模式”），同时注意防范无限循环和递归调用等常见问题。详情请参考智能合约错误以及 VM 异常处理。

TRON 特有背景

与以太坊相比， TRON 智能合约在以下几个核心维度上有所区别：

• 资源模型 — TRON 使用独有的 Energy（代表 CPU 和存储开销）来评估交易执行，而非采用以太坊的单一 Gas 计费模式。你可以通过质押 TRX 获得 Energy 配额，该配额按 24 小时滚动窗口线性恢复，也可以在额度不足时直接燃烧 TRX 支付资源成本。详情请参阅资源模型。
• 部署费用 — 部署智能合约时，会将字节码写入区块链并运行构造函数。此过程需要消耗大量的能量与带宽，用户可通过预先质押获取资源，或直接在部署交易中通过燃烧 TRX 支付。详情请参阅 FeeLimit 与能量成本管理。
• 地址格式 — TRON 地址在钱包、RPC 与 Base58Check 外部表示中为 21 字节：首字节是 0x41 前缀，后接 20 字节 Keccak-256 哈希（算法与以太坊相同）。在用户界面及 API 交互中， TRON 统一采用 Base58Check 编码（呈现为以字母 T 开头的地址格式），而非以太坊式的十六进制（0x...）。不过在 TVM 内部运算时，TRON 使用去掉前缀后的 20 字节地址数据。详情请参阅账户与密钥。

后续步骤

• 编写与编译 —— 学习如何在 TRON 上编写并编译首个 Solidity 智能合约
• TVM 底层原理 —— 深入了解虚拟机的底层执行环境与架构
• TRON 上的 Solidity —— 掌握受支持的 Solidity 版本及其独有的语言特性

相关资源

• 快速通道 —— 体验 10 分钟快速部署“Hello World”合约
• 从以太坊迁移至 TRON —— 查看以太坊合约的一键移植与改造细节
• Opcodes —— 查询 TVM 字节码指令集参考