如何创建每月向持有者发放分红的ERC20代币

核心思路 #

实现分红型ERC20的核心是跟踪用户持仓比例，并在指定周期（每月）将分红资金按比例分配给持有者。实用的模式是累积提取型：记录每个用户的累积分红额度，用户可主动提取，这种方式能避免批量分发的高Gas成本，适合大规模持有者场景。

月度触发建议采用管理员手动触发+时间校验的方式，因为链上区块时间戳存在一定偏差，纯自动触发可能出现提前或延迟的问题。

具体实现步骤 #

1. 基于标准ERC20扩展合约，添加分红相关状态变量（用户分红余额、分红累积系数、上次分红时间等）
2. 实现分红计算的“懒加载”逻辑：在用户进行转账、提取分红等操作时，自动更新其累积分红额度，避免批量计算的高Gas开销
3. 实现分红触发函数：校验时间间隔（需超过30天），并根据当前总供应量计算每单位代币对应的分红额度
4. 实现用户提取分红的函数，允许用户将累积的分红转至自己的地址

关键代码示例（Solidity + OpenZeppelin） #

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

contract DividendERC20 is ERC20, Ownable {
    // 记录每个地址的可提取分红余额
    mapping(address => uint256) public dividendBalances;
    // 上次分红的区块时间戳
    uint256 public lastDividendTimestamp;
    // 每1e18份代币对应的累积分红（用于计算用户持仓应得分红）
    uint256 public dividendPerTokenStored;
    // 记录每个地址上次同步分红时的dividendPerTokenStored值
    mapping(address => uint256) public userLastDividendPerToken;

    // 月度分红间隔：30天（以秒为单位）
    uint256 public constant MONTHLY_INTERVAL = 30 days;

    constructor(string memory name, string memory symbol) ERC20(name, symbol) Ownable(msg.sender) {
        lastDividendTimestamp = block.timestamp;
    }

    // 内部函数：更新用户的累积分红
    function _syncDividend(address account) internal {
        if (account == address(0)) return;
        
        uint256 currentDividendPerToken = dividendPerTokenStored;
        uint256 userOwed = (balanceOf(account) * (currentDividendPerToken - userLastDividendPerToken[account])) / 1e18;
        
        dividendBalances[account] += userOwed;
        userLastDividendPerToken[account] = currentDividendPerToken;
    }

    // 重写转账函数，前后同步分红
    function transfer(address to, uint256 amount) public override returns (bool) {
        _syncDividend(msg.sender);
        _syncDividend(to);
        return super.transfer(to, amount);
    }

    // 重写授权转账函数
    function transferFrom(address from, address to, uint256 amount) public override returns (bool) {
        _syncDividend(from);
        _syncDividend(to);
        return super.transferFrom(from, to, amount);
    }

    // 触发月度分红（仅合约所有者可调用）
    function triggerMonthlyDividend() public onlyOwner {
        require(block.timestamp >= lastDividendTimestamp + MONTHLY_INTERVAL, "Dividend period not reached");
        require(address(this).balance > 0, "No funds available for dividend");

        uint256 dividendTotal = address(this).balance;
        // 更新每单位代币的分红累积系数
        dividendPerTokenStored += (dividendTotal * 1e18) / totalSupply();
        lastDividendTimestamp = block.timestamp;
    }

    // 用户提取分红
    function withdrawDividend() public {
        _syncDividend(msg.sender);
        uint256 withdrawAmount = dividendBalances[msg.sender];
        require(withdrawAmount > 0, "No dividend to withdraw");

        dividendBalances[msg.sender] = 0;
        // 转ETH给用户
        (bool success, ) = msg.sender.call{value: withdrawAmount}("");
        require(success, "Dividend transfer failed");
    }

    // 允许合约接收ETH作为分红资金
    receive() external payable {}
}

关键细节说明 #

• 懒加载机制：仅在用户执行转账、提取操作时更新分红，避免了遍历所有持有者的高Gas成本，适合大规模代币使用
• 权限控制：triggerMonthlyDividend 仅允许合约所有者调用，防止恶意触发分红
• 分红资金：合约需提前接收ETH（或其他代币，若要分发ERC20需修改代码逻辑）作为分红储备
• 时间校验：通过block.timestamp判断是否达到月度间隔，可根据实际需求调整天数

注意事项 #

1. 若需分发ERC20代币而非ETH，需将合约中的ETH转账逻辑替换为对应ERC20的transfer函数，并添加代币余额检查
2. 链上时间存在一定偏差，建议触发分红时允许±1天的误差，避免因区块时间延迟导致无法触发
3. 若代币总供应量会变化（如 mint/burn 功能），需在 mint/burn 时同步触发分红计算，避免分红比例错误

内容的提问来源于stack exchange，提问作者Fabiconcept