合约间调用

📘

前置阅读

• TRON 上的 Solidity

合约间调用是指一个智能合约调用另一个智能合约中的方法。这在复用业务逻辑、获取外部数据以及实现多个去中心化协议的协同组合时非常关键。通过这种模式，开发者可以显著提升代码的可复用性，支持复杂的业务编排，并强化系统的模块化设计。在 TRON 网络中，主要有以下三种合约间调用方式，开发者可根据在编译时对目标合约的了解程度进行选择：

模式 1：通过接口调用（推荐）

当目标合约的接口定义已知时，为其声明一个 Solidity 接口并在其地址处进行实例化是最佳选择。该模式提供了编译时的类型安全检查，且代码最为精简，因此是官方推荐的默认调用方式。

// IContractB.sol
pragma solidity 0.8.0;

interface IContractB {
    function increment(uint256 value) external returns (uint256);
}

// ContractA.sol
pragma solidity 0.8.0;

import "./IContractB.sol";

contract ContractA {
    address public contractBAddress;

    constructor(address _contractBAddress) {
        contractBAddress = _contractBAddress;
    }

    function callIncrement(uint256 value) public returns (uint256) {
        IContractB contractB = IContractB(contractBAddress);
        uint256 newValue = contractB.increment(value);
        return newValue;
    }
}

模式 2：通过 address.call 进行底层调用

在无法获取目标合约接口的场景下（例如从链上注册表动态加载合约，或需要实现动态派发逻辑），可以通过底层的 address.call 直接与目标合约交互。此模式需要手动对函数选择器和参数进行 ABI 编码，并手动解码返回的字节数据。

pragma solidity 0.8.0;

contract ContractA {
    address public contractBAddress;

    constructor(address _contractBAddress) {
        contractBAddress = _contractBAddress;
    }

    function callIncrement(uint256 value) public returns (uint256) {
        (bool success, bytes memory result) = contractBAddress.call(
            abi.encodeWithSignature("increment(uint256)", value)
        );
        require(success, "Call failed");
        return abi.decode(result, (uint256));
    }
}

address.call 接口始终会返回一个 (bool, bytes) 类型的元组：其中 bool 变量表示调用是否成功执行（未被 revert），而 bytes 字节流则包含被调用合约返回的原始数据。在解析或使用 result 之前，务必先检查 success 的状态，否则极易因忽略调用失败而引入静默失败（Silent Failures）的安全漏洞。

如需了解如何对函数选择器和参数进行编码，请参阅参数编码与解码章节。

模式 3：直接向合约地址转账 TRX

直接向一个智能合约地址发送 TRX 会触发该合约的 receive 或 fallback 回调函数。如果跨合约调用的唯一目的就是注入或转移 TRX 资金，可以使用此模式。

pragma solidity 0.8.0;

contract ContractA {
    address public contractBAddress;

    constructor(address _contractBAddress) {
        contractBAddress = _contractBAddress;
    }

    function directTransfer() external payable {
        payable(contractBAddress).transfer(msg.value);
    }
}

📘

TRON 网络特有行为

在 TRON 网络中，通过系统合约直接发起的普通转账（即 TransferContract 交易）会完全绕过智能合约的 fallback 或 receive 函数。而在 Solidity 中使用 transfer() 方法进行的转账，其底层是发起了一笔将 callValue 设为非零值的 TriggerSmartContract 交易，这种交易会正常触发接收合约的 receive 或 fallback 函数。

这与以太坊的设计不同。在以太坊中，任何发送至合约的以太币转账都会触发 fallback 逻辑。关于 TRX 完整的转账路径与底层差异，请参阅 TVM 与 EVM 的区别。

跨合约调用的注意事项

• 能量消耗：每次执行跨合约调用时，都会在基本的交易能量开销之上产生额外的虚拟机指令执行损耗。在发起交易前，请确保账户已准备充足的能量资源，并合理设置交易的 fee_limit。具体的预估与校准方法请参考 FeeLimit 与能量成本 章节。
• 调用深度限制： TRON 网络对虚拟机的调用栈深度进行了硬性限制（当前最大深度为 64 层）。过深的嵌套调用或递归调用会导致栈溢出，进而触发交易失败。详情请参考 VM 异常处理 章节。
• 失败处理与异常冒泡：在使用底层的 address.call 方式时，必须手动捕获并检验 success 标识，并在必要时显式执行 revert 操作。而对于高层级的接口调用，被调用合约内抛出的任何异常都会自动向上冒泡，导致外层调用合约一同 revert。
• 重入攻击风险：发起跨合约调用意味着暂时让渡了交易的执行控制权。被调用的外部合约可能会在当前函数执行完毕前，重新调用（重入）您的合约。针对处理资产转移等敏感逻辑的方法，必须严格遵循“检查-生效-交互”（Checks-Effects-Interactions）设计模式，或使用 OpenZeppelin 的 ReentrancyGuard 防重入锁。详情请参考 最佳实践 章节。

完整示例：跨合约链式计数器

ContractB 用于实现一个累加计数器：

// ContractB.sol
pragma solidity 0.8.0;

contract ContractB {
    uint256 public counter;

    function increment(uint256 value) external returns (uint256) {
        counter += value;
        return counter;
    }
}

在上文定义的 ContractA（基于模式 1 的接口调用方式）中，我们调用了 ContractB.increment。每次执行调用都会将 ContractB 中的 counter 状态变量累加指定的 value 值，并向外返回更新后的数值。

部署与测试步骤

1. 部署 ContractB：首先将 ContractB 部署上链，并记录其生成的合约地址。
2. 部署 ContractA：在部署 ContractA 时，将上一步记录的 ContractB 合约地址作为构造函数参数传入。
3. 发起调用：调用 ContractA.callIncrement(value)。此时，ContractB 的 counter 将会增加 value，同时 ContractA.callIncrement 会正确返回累加后的最新计数值。

相关资源

• 参数编码与解码 —— 模式 2 中 abi.encodeWithSignature 的详细使用方法
• VM 异常处理 —— 了解调用深度、异常分类与 revert 的具体行为
• TVM 与 EVM 的区别 —— 深入剖析 TRX 转账的底层路由路径
• FeeLimit 与能量成本 —— 学习如何针对跨合约调用精准计算与设定 fee_limit
• 最佳实践 —— 针对重入漏洞等合约安全问题的防御指南