WTF Solidity 极简入门：第 42 讲 分账合约 PaymentSplit 实战指南

WTF Solidity 极简入门：第 42 讲 分账合约 PaymentSplit 实战指南

【免费下载链接】WTF-SolidityWTF Solidity 极简入门教程，供小白们使用。Now supports English! 官网: https://wtf.academy项目地址: https://gitcode.com/GitHub_Trending/wt/WTF-Solidity

分账（Payment Split）是把收到的款项按事先约定的权重分配给一组受益人的典型链上业务场景。本讲基于 WTF-Solidity 仓库中的 42_PaymentSplit/PaymentSplit.sol 讲解一个由 OpenZeppelinPaymentSplitter合约简化而来的PaymentSplit分账合约，读完你将掌握：如何在合约部署时固化受益人名单与份额、合约如何按份额自动计算每位受益人应得的ETH，以及如何通过release()函数以Pull Payment模式安全地领取款项。

一、什么是分账

分账就是按照一定比例分配钱财。在现实世界中，合作项目、多人共创的收入分配经常出现"分赃不均"的纠纷；而在区块链世界里，Code is Law，我们可以把每个人应分的比例提前写死在智能合约中，合约收到收入后自动按既定比例进行分账，从机制上杜绝事后扯皮。

分账合约的用途非常广泛：多人联合创作的版权收入分成、团队/DAO 国库资金分配、项目方与多个合作方的销售分成等，都可以用同一套"份额 + 按比例提取"的模型来实现。

二、分账合约（PaymentSplit）的设计特点

PaymentSplit合约（源码见 42_PaymentSplit/PaymentSplit.sol）具有以下 4 个核心特点：

1. 部署时固化分账规则：在创建合约时定好分账受益人payees和每人的份额shares，初始化之后不可修改。
2. 份额比例任意：份额可以是相等的，也可以是任意其他比例（如1:3），totalShares是所有份额之和。
3. 按份额比例可提取：在该合约收到的所有ETH中，每个受益人能够提取与其所分配份额成比例的金额。
4. 遵循Pull Payment模式：付款不会自动打入受益人账户，而是先保存在分账合约中；受益人通过调用release()函数触发实际转账。这种"先入池、后提取"的模式与 41_WETH/WETH.sol 中 WETH 等资金的托管思路类似，把"入账"和"出账"分离，便于审计与重入防护。

合约整体骨架如下：

// SPDX-License-Identifier: MIT pragma solidity ^0.8.21; /** * 分账合约 * @dev 这个合约会把收到的ETH按事先定好的份额分给几个账户。收到ETH会存在分账合约中，需要每个受益人调用release()函数来领取。 */ contract PaymentSplit{ // ... }

仓库中的实际源码 42_PaymentSplit/PaymentSplit.sol 使用pragma solidity ^0.8.34;，而 Languages/en/42_PaymentSplit_en/PaymentSplit.sol 为英文版同名实现，逻辑完全一致，读者可按自身编译环境选择版本。

三、事件（Events）

分账合约中共有 3 个事件，用于链上记录分账全生命周期的关键动作：

事件	语义	参数
PayeeAdded	增加受益人事件	address account受益人地址，uint256 shares对应份额
PaymentReleased	受益人提款事件	address to收款地址，uint256 amount提取金额
PaymentReceived	合约收款事件	address from付款方，uint256 amount收款金额

// 事件 event PayeeAdded(address account, uint256 shares); // 增加受益人事件 event PaymentReleased(address to, uint256 amount); // 受益人提款事件 event PaymentReceived(address from, uint256 amount); // 合约收款事件

这三个事件分别对应"设立分账规则"、"执行分账"、"合约进账"三个阶段，前端与索引器（如 subgraph、区块浏览器）可依赖这些事件追踪每一笔资金的流向。

四、状态变量（State Variables）

分账合约中共有 5 个状态变量，用于记录受益地址、份额、以及已经支付出去的ETH：

变量	类型	说明
totalShares	uint256	总份额，为所有shares的和
totalReleased	uint256	从分账合约向受益人支付出去的ETH总量，为所有released的和
payees	address[]	受益人地址数组
shares	mapping(address => uint256)	记录每个受益人的份额
released	mapping(address => uint256)	记录分账合约支付给每个受益人的累计金额

uint256 public totalShares; // 总份额 uint256 public totalReleased; // 总支付 mapping(address => uint256) public shares; // 每个受益人的份额 mapping(address => uint256) public released; // 支付给每个受益人的金额 address[] public payees; // 受益人数组

注意payees是公开数组，Solc 会自动为其生成按索引取值的 getter；shares、released是公开映射，自动生成以地址为参数的 getter。totalShares与totalReleased都是public，任何账户都可以直接链上查询分账进度。

五、函数详解（Functions）

分账合约中共有 6 个函数，承担从"初始化受益人"到"受益人领取款项"的完整闭环。

1. 构造函数（constructor）

构造函数初始化受益人数组_payees和分账份额数组_shares，并带有一系列严谨的校验：

• 两个数组长度必须相等（payees and shares length mismatch）；
• 数组长度不能为 0（no payees）；
• _shares中的每个元素必须大于 0；
• _payees中的地址不能是 0 地址、且不能有重复地址（这些校验在_addPayee()中完成）。

constructor(address[] memory _payees, uint256[] memory _shares) payable { // 检查_payees和_shares数组长度相同，且不为0 require(_payees.length == _shares.length, "PaymentSplitter: payees and shares length mismatch"); require(_payees.length > 0, "PaymentSplitter: no payees"); // 调用_addPayee，更新受益人地址payees、受益人份额shares和总份额totalShares for (uint256 i = 0; i < _payees.length; i++) { _addPayee(_payees[i], _shares[i]); } }

构造函数被标记为payable，意味着部署合约的同时可以一次性打入首笔待分账的资金，例如后续 Remix 演示中部署时即转入1 ETH。

2. receive() 回调函数

receive()是 Solidity 的收款回调：分账合约收到普通ETH转账时自动执行，并释放PaymentReceived事件记录付款方与金额。

receive() external payable virtual { emit PaymentReceived(msg.sender, msg.value); }

函数被声明为virtual，便于子合约在继承时覆写（例如加白名单、加限额等自定义逻辑）。

3. release() 分账函数

release()为有效受益人地址_account分配相应的ETH。任何人都可以触发这个函数，但ETH只会转给受益人地址_account——这大大降低了单点依赖，即使受益人本人不上链，第三方（如服务商）也可以代劳触发。

function release(address payable _account) public virtual { // account必须是有效受益人 require(shares[_account] > 0, "PaymentSplitter: account has no shares"); // 计算account应得的eth uint256 payment = releasable(_account); // 应得的eth不能为0 require(payment != 0, "PaymentSplitter: account is not due payment"); // 更新总支付totalReleased和支付给每个受益人的金额released totalReleased += payment; released[_account] += payment; // 转账 _account.transfer(payment); emit PaymentReleased(_account, payment); }

执行流程为：先校验_account是有效受益人（份额大于 0）→ 调用releasable()计算本次应得金额 → 校验金额不为 0 → 更新totalReleased与released（先记账后转账，防止重入）→ 使用transfer()转账 → 释放PaymentReleased事件。

4. releasable() 计算可领取金额

releasable()计算一个受益人地址当前可领取的ETH：

function releasable(address _account) public view returns (uint256) { // 计算分账合约总收入totalReceived uint256 totalReceived = address(this).balance + totalReleased; // 调用_pendingPayment计算account应得的ETH return pendingPayment(_account, totalReceived, released[_account]); }

关键技巧在于"总收入"的计算：totalReceived = address(this).balance + totalReleased。因为已经发放出去的totalReleased不再在合约余额里，要把它们加回来，才能还原分账合约的累计总收入，从而保证新转入的每一笔ETH都能按份额重新摊分。

5. pendingPayment() 计算应分金额

pendingPayment()是分账的核心数学函数：根据受益人地址_account、分账合约总收入_totalReceived和该地址已领取的金额_alreadyReleased，计算该受益人当前应分的ETH：

function pendingPayment( address _account, uint256 _totalReceived, uint256 _alreadyReleased ) public view returns (uint256) { // account应得的ETH = 总应得ETH - 已领到的ETH return (_totalReceived * shares[_account]) / totalShares - _alreadyReleased; }

其公式为：

应分金额 = (累计总收入 × 该受益人份额) / 总份额 − 该受益人已领取金额

其中(_totalReceived * shares[_account]) / totalShares是该受益人按份额应得的累计总金额，减去已领取的_alreadyReleased即为本次可提取的增量。注意这里使用整数除法向下取整，因此少量 dust（余数）会保留在合约中，这正是分账合约的常见行为。

6. _addPayee() 新增受益人

_addPayee()是新增受益人及其份额的私有函数，只在构造函数初始化时被调用，之后不可修改，从机制上保证分账规则不可篡改：

function _addPayee(address _account, uint256 _accountShares) private { // 检查_account不为0地址 require(_account != address(0), "PaymentSplitter: account is the zero address"); // 检查_accountShares不为0 require(_accountShares > 0, "PaymentSplitter: shares are 0"); // 检查_account不重复 require(shares[_account] == 0, "PaymentSplitter: account already has shares"); // 更新payees，shares和totalShares payees.push(_account); shares[_account] = _accountShares; totalShares += _accountShares; // 释放增加受益人事件 emit PayeeAdded(_account, _accountShares); }

三重校验（非 0 地址、份额大于 0、地址不重复）确保初始化数据的合法性；写入顺序为先更新存储、后释放事件。

六、Remix 演示：部署、入账与领款

1. 部署 PaymentSplit 合约，并转入 1 ETH

在 Remix 中编译部署PaymentSplit，构造函数输入两个受益人地址，份额分别为1和3（即分成比例为 1:3，totalShares = 4），同时在Value处填入1 ETH随部署一并转入合约：

2. 查看受益人地址、份额、应分到的 ETH

部署完成后，依次查看状态变量：

• payees(0)/payees(1)：查看两个受益人地址；
• shares(受益人A)=1，shares(受益人B)=3；
• totalShares=4；
• 调用releasable(受益人A)、releasable(受益人B)可查看各自当前应分的ETH（合约内共1 ETH，A 应得0.25 ETH，B 应得0.75 ETH）。

3. 调用 release 函数领取 ETH

调用release(受益人地址)触发实际分账：合约按份额计算应得金额并transfer到受益人账户。注意该函数不要求必须是受益人本人调用，任何地址都可以代为触发，但钱只会打给参数中指定的受益人地址。

4. 查看总支出、受益人余额与应分金额的变化

领取后再次查询：

• totalReleased增加为已发放总额；
• released(受益人)记录该受益人累计已领金额；
• 再次调用releasable()时，由于已领取金额被扣除，返回值归零或相应减少；
• 受益人账户余额增加相应ETH。

七、安全性与设计要点总结

最后梳理一下PaymentSplit在安全与工程实践上的几个关键设计，这也是面试与审计中常见的考察点：

1. Pull Payment 模式：资金先沉淀在合约中，受益人主动release()领取，避免向不可信地址主动 push 转账带来的重入与 gas 风险。
2. 先记账后转账：release()中先更新totalReleased/released再执行transfer()，天然防止重入攻击；transfer()仅发送 2300 gas，进一步限制恶意接收者的可执行逻辑。
3. 份额固化：受益人与份额只在构造函数中通过_addPayee()设定，private可见性 + 无更新函数保证规则一经部署即不可变，体现Code is Law。
4. 累计摊分设计：releasable()用"合约当前余额 + 已发放总额"还原累计总收入，使后期新转入的ETH也能按原份额持续、公平地摊分给所有受益人。
5. 无权限触发：release()无onlyOwner限制，任何人均可代为触发，避免受益人离线导致资金永久锁定。

通过本讲的分账合约，我们可以看到：区块链上的"分账"本质是把信任从人际协商转移到可验证的代码规则上——事先定好份额，收入入池，各受益人按比例自行领取，从根源上规避"分赃不均"的争议。若需深入，可对照英文版教程 Languages/en/42_PaymentSplit_en/readme.md 与完整源码 42_PaymentSplit/PaymentSplit.sol 继续学习。

【免费下载链接】WTF-SolidityWTF Solidity 极简入门教程，供小白们使用。Now supports English! 官网: https://wtf.academy项目地址: https://gitcode.com/GitHub_Trending/wt/WTF-Solidity