Fēnrùn 文档
了解如何使用 Fēnrùn 发行代币、配置手续费分享，以及领取收益。
简介
Fēnrùn（分润）是一个建立在 BNB Chain 上的代币发行平台，基于 four.meme 基础设施。它让任何人都可以在几分钟内发行 meme 代币，并将交易手续费自动分发给创建者、持有者或任意社交账号。
与传统代币发行平台不同，Fēnrùn 将链上手续费分享与社交账号直接绑定。代币创建者可以将手续费分配给 X（Twitter）、Telegram、GitHub 或 Instagram 账号，无需对方先拥有钱包——平台会为其自动生成。
Fēnrùn 使用 four.meme 的联合曲线机制：代币从 0 开始，在募集到 24 BNB 后自动迁移至 PancakeSwap。
运作方式
整体流程分为三个阶段：
发行
创建者连接 EVM 钱包，填写代币信息（名称、符号、图片、手续费率），选择手续费接收方（钱包地址或社交账号），然后提交链上交易。
交易
代币在联合曲线上交易。每笔买卖均收取创建者设定的手续费，并按比例分配给接收方、持有者、销毁和流动性池。
领取
社交账号持有人可在 Claim Fees 页面使用其社交账号登录，查看并领取累积的 BNB 手续费，或导出私钥将钱包导入自己的工具。
发行代币
前提条件
- 已安装浏览器 EVM 钱包（如 MetaMask）
- 已连接至 BNB Smart Chain（主网 Chain ID 56）
- 钱包中有少量 BNB 用于支付 gas
- 准备好代币图片（建议正方形，≤5 MB）
创建步骤
代币详情
填写代币名称、符号（大写）、描述，选择类别（Meme、AI、DeFi 等），并上传图片。图片会上传至 four.meme CDN 并与代币绑定。
手续费配置
设置手续费率（0–10%，默认 1%）并选择是否启用手续费分享。如启用，选择接收方类型（社交账号或钱包地址），并分配各方比例。
确认并发行
核对所有参数，点击「发行代币」。您将签署一条消息（免费），然后提交链上交易。交易确认后自动跳转至代币详情页。
代币仅在链上交易确认后才会写入数据库。如果交易失败，数据库中不会留下任何记录。
手续费分享
手续费分享是 Fēnrùn 的核心功能。每笔交易收取的手续费会被拆分并自动分发给链上各方，无需手动干预。
手续费率
创建者可以设置 0% 到 10% 之间的手续费率。设置为 0% 时关闭手续费分享，所有流动性进入 PancakeSwap LP。
接收方类型
| 类型 | 描述 |
|---|---|
| 钱包地址 | 直接使用 0x… EVM 地址作为接收方 |
| X / Twitter | 填写 Twitter 用户名，平台为其生成专属钱包 |
| Telegram | 填写 Telegram 用户名 |
| GitHub | 填写 GitHub 用户名 |
| 填写 Instagram 用户名 |
手续费分配
启用手续费分享时，手续费收入按比例分配给四个目标，总计必须为 100%。
| 目标 | 描述 | 颜色 |
|---|---|---|
| 创建者 / 接收方 | 发送至创建者指定的钱包或社交账号 | 绿色（主色） |
| 持有者分红 | 按持仓比例分配给代币持有者 | 绿色 |
| 销毁 | 发送至 0x000…dead 销毁地址 | 红色 |
| 流动性 | 自动注入 PancakeSwap LP | 蓝色 |
如果关闭手续费分享，所有费用默认 100% 进入流动性池（PancakeSwap LP）。
领取手续费
如果有人将您的社交账号设为手续费接收方，您可以在「领取手续费」页面查看并领取累积的 BNB。
登录
使用您的社交账号（X、GitHub、Instagram 等）通过 Privy 登录。
查看余额
平台会显示您的专属手续费钱包地址及当前 BNB 余额，以及向该钱包路由手续费的所有代币。
领取或导出
点击「领取」将 BNB 直接发送至您连接的钱包地址，或点击「导出私钥」将钱包导入 MetaMask 等工具。
交易代币
每个代币详情页内置交易面板，可直接买入或卖出，无需离开页面。
买入
输入 BNB 金额（或点击快捷按钮 0.1 / 0.5 / 1 / 5），系统会实时估算您将收到的代币数量及手续费，然后点击「买入」提交交易。
卖出
输入代币数量（或点击 25% / 50% / 75% / 100% 快捷按钮），系统估算您将收到的 BNB 数量。点击「卖出」时会先进行一次授权交易，然后执行卖出。
交易使用 5% 的最大滑点容差。市场波动剧烈时，实际成交价可能与估算值有所差异。
安全性
服务端 JWT 验证
领取手续费（/api/claim/sweep）和导出私钥（/api/claim/export-key）接口均需要有效的 Privy JWT 令牌，通过 @privy-io/server-auth 在服务端验证，确保只有账号所有者可以操作。
链上交易安全
所有链上签名和交易均由用户的浏览器钱包完成。平台服务端仅负责构建交易参数，不持有用户私钥。
合约与 API
核心合约（BNB Chain 主网）
| 合约 | 地址 |
|---|---|
| TokenManager V2 | 0x5c952063c7fc8610FFDB798152D69F0B9550762b |
| TokenManagerHelper3 | 0x8EFc6d5Dc4F09E50c4f38c6e1A1C9d7ecD1f4eE2 |
四步发行流程
内部 API 端点
| Method + Path | 描述 |
|---|---|
| GET /api/tokens | 列出代币（支持 label / sort / limit / creator 过滤） |
| POST /api/tokens/create | 在 four.meme 创建代币参数 |
| PATCH /api/tokens/create | 确认链上地址后写入数据库 |
| GET /api/tokens/detail | 按地址或 UUID 查询代币详情 |
| GET /api/tokens/nonce | 获取 four.meme 一次性 nonce |
| POST /api/recipients/resolve | 解析或生成社交钱包 |
| GET /api/claim/[handle] | 查询账号手续费余额 |
| POST /api/claim/sweep | 将余额发送至指定地址（需 JWT） |
| POST /api/claim/export-key | 导出私钥（需 JWT） |
| GET /api/claim/history | 查询领取历史记录 |
| GET /api/stats | 获取平台统计数据 |
FAQ
发行代币需要多少费用？
创建代币本身目前免费（由 four.meme 补贴），您只需支付 BNB 链上 gas 费（通常不到 $0.05）。
手续费率可以设为 0% 吗？
可以。设为 0% 时关闭手续费分享，所有流动性进入 PancakeSwap LP。
代币图片存储在哪里？
图片上传至 four.meme 的 CDN（img.four.meme），URL 存储于 Supabase。
社交账号持有人是否知道有费用在等待领取？
目前不会主动通知，持有人需主动访问 Fēnrùn 的「领取手续费」页面查看。
代币何时迁移至 PancakeSwap？
当联合曲线募集满 24 BNB 时，four.meme 的合约会自动将流动性迁移至 PancakeSwap。
可以设置多个手续费接收方吗？
目前每个代币只能设置一个主接收方，但可以通过「持有者分红」将部分费用分配给所有持有者。
交易滑点是多少？
交易面板使用 5% 的最大滑点容差。
社交钱包
当代币创建者将某个社交账号设为手续费接收方时，Fēnrùn 会在服务端为该账号生成一个专属的 EVM 钱包（密钥对），并将其与账号绑定存储于数据库。
同一个社交账号可以关联多个代币。只要使用该账号作为接收方，手续费就会持续累积到同一个钱包地址，直到账号持有人登录领取。
账号验证
账号持有人通过 Privy 社交登录（Twitter、GitHub、Instagram 等）验证身份。验证成功后即可领取对应钱包中的所有余额，或导出私钥。
私钥以明文存储于 Supabase（仅限服务端访问）。领取操作通过 Privy JWT 验证，确保只有账号持有人才能导出私钥或发起转账。