Flapskill

蝴蝶技能：创建代币、买入/卖出代币（USDT）

用户说「蝴蝶技能」即触发本技能。通过 FlapSkill 合约可创建 V5 代币（0 税或税收；税收时代币可分配营销/持币分红/回购销毁/LP回流 四档税点，受益人 feeTo），或用 USDT 买入/卖出指定代币；买卖经 Portal 或 PancakeSwap 兑换，代币/USDT 转给调用者。

USDT 合约地址（BSC）：0x55d398326f99059fF775485246999027B3197955。

前置条件： 用户需已配置 BNB Chain MCP（如已安装 bnbchain-mcp-skill），且 MCP 的 env 中已设置 PRIVATE_KEY，否则无法发送交易。

1. 合约接口

合约地址：0x482970490d06fc3a480bfd0e9e58141667cffedc。

创建代币 createToken

• 方法：createToken(string _name, string _symbol, string _meta, address _feeTo, bytes32 _salt, uint16 _taxRate, uint16 _mktBps, uint16 _dividendBps, uint16 _deflationBps, uint16 _lpBps, uint256 _minimumShareBalance) external returns (address token)
• 含义：经 Portal 创建 V5 代币。0 税代币：_taxRate=0，不校验四档分配，合约使用 V3_MIGRATOR；salt 须用尾号 8888（脚本：node scripts/find-vanity-salt.js 8888）。税收代币：_taxRate 1–1000（如 300=3%），_mktBps（营销）、_dividendBps（持币分红）、_deflationBps（回购销毁）、_lpBps（LP 回流）四者之和须为 10000；salt 须用尾号 7777（全营销用 find-vanity-salt.js 7777，四档分配用 find-vanity-salt.js 7777 v2）。若 _dividendBps > 0，_minimumShareBalance 须 ≥ 10_000 ether；用户未说时 Agent 默认 10_000 ether。详见 Flap Portal 与 部署地址（standard:8888，Tax:7777）。无需 approve。
• 约束：_salt 为 bytes32（0x+64 位十六进制），每次创建用不同 salt；必须按税点选对尾号（0 税→8888，有税→7777）及对应脚本 impl（7777 四档时加 v2）。
• 何时用：0 税：用户说「蝴蝶技能 创建代币 名称：… 符号：…」即可，可选官网、简介、代币图片；不需说税点、税收地址，Agent 自动 taxRate=0、feeTo=调用者地址、salt 用 8888。有税：用户说「蝴蝶技能 创建代币 名称：… 符号：…，税点：…% 税收地址：0x…」并可选四档分配、官网、简介、图片；有税且未指定四档时默认全部归营销；启用持币分红时用户可说「最低持币数量：1 万」等，不说则默认 10_000 ether。_meta、_salt 由 Agent 跑脚本填入；官网、简介须传入 upload 脚本。

买入 buyTokens

• 方法：buyTokens(address _token, uint256 _usdtAmount) external
• 含义：从调用者转入 _usdtAmount（18 位小数）的 USDT，向 Portal 兑换 _token 代币，代币转给调用者。
• 约束：调用前须对 FlapSkill 合约 approve 至少 _usdtAmount 的 USDT。

卖出（按数量）sellTokens

• 方法：sellTokens(address _token, uint256 _tokenAmount) external
• 含义：从调用者转入指定数量 _tokenAmount 的代币，向 Portal 兑换为 USDT，USDT 转给调用者。无滑点保护。
• 约束：调用前须对 FlapSkill 合约 approve 至少 _tokenAmount 的该代币。_tokenAmount 为该代币最小单位。
• 何时用：用户说「蝴蝶技能卖出 X 个 0x…」「卖出100个的0x…」等具体数量时，用本方法。

卖出（按仓位比例）sellTokensByPercent

• 方法：sellTokensByPercent(address _token, uint256 _percentBps) external
• 含义：按调用者当前该代币持仓的 比例 卖出。合约内读取 balanceOf(msg.sender)，卖出数量 = 余额 × _percentBps / 10000。无滑点保护。
• 约束：调用前须对 FlapSkill 合约 approve 至少「该比例对应的数量」（建议直接 approve 全部仓位或足够大的数）。
• 何时用：用户说「蝴蝶技能卖出50%的0x…」「卖出一半 0x…」等比例时，用本方法。_percentBps 为基点：10000=100%，5000=50%，1000=10%。

2. 创建代币：使用 BNB Chain MCP 调用

2.1 _meta 与 _salt 由 Agent 直接填写（脚本已打包在本技能内）

• _meta 和 _salt 不由用户提供，由 Agent 在技能目录下执行本技能自带的脚本得到并直接填入 createToken 的 args。
• 脚本位置：本技能目录下的 scripts/（upload-token-meta.js、find-vanity-salt.js）。安装后技能目录通常为 .agents/skills/flap-skills（项目）或 ~/.cursor/skills/flap-skills（全局），本仓库内为 skills/flap-skills。Agent 须先 cd 到该技能目录，若未安装依赖则先执行 npm install，再执行下面两步。
• 上传 meta 时须带上官网和简介（见 Flap 文档）：用户创建代币时可选提供「官网：…」「简介：…」，Agent 传入脚本，格式为 node scripts/upload-token-meta.js <图片路径> "<简介>" "<官网>" [twitter] [telegram]，脚本将简介写入 meta.description、官网写入 meta.website。
• Salt 尾号与脚本（见 Flap 文档、部署地址）：0 税（税点 0%）→ 地址尾号 8888，执行 node scripts/find-vanity-salt.js 8888；有税→ 地址尾号 7777，全营销执行 node scripts/find-vanity-salt.js 7777，四档分配执行 node scripts/find-vanity-salt.js 7777 v2。
• 流程：0 税：用户只说「蝴蝶技能 创建代币 名称：… 符号：…」（可选官网、简介、图片）。Agent 在技能目录下：① 上传 meta（有图/官网/简介时跑 upload 脚本，否则可用占位 CID 或简单 meta）；② 执行 node scripts/find-vanity-salt.js 8888 得 _salt；③ _feeTo = 调用者地址（发送交易的钱包），_taxRate=0，四档与 minimumShareBalance 均 0；④ write_contract createToken(…)。有税：用户说「名称：… 符号：…，税点：…% 税收地址：0x…」并可选四档、官网、简介、图片。Agent：① 跑 upload 脚本得 _meta；② 按税点跑 salt（全营销 7777，四档 7777 v2）；③ 确定四档与 minimumShareBalance；④ write_contract createToken(…)。
• 用户无需写 meta、salt；0 税无需说税点、税收地址，Agent 用调用者地址作 feeTo。

2.2 调用 createToken

无需 approve，直接 write_contract：

3. 买入：使用 BNB Chain MCP 调用

3.1 先授权 USDT（approve）

3.2 再调用 buyTokens

4. 卖出（按数量）：使用 BNB Chain MCP 调用

用户说具体数量（如「蝴蝶技能卖出100个的0x…」）时用此流程。

4.1 先授权要卖出的代币（approve）

4.2 再调用 sellTokens

注意：_tokenAmount 须按该代币 decimals 换算为最小单位（如 18 位小数，1 个 = "1000000000000000000"）。

5. 卖出（按仓位比例）：使用 BNB Chain MCP 调用

用户说比例（如「蝴蝶技能卖出50%的0x…」「卖出一半0x…」）时用此流程。

5.1 可选：查询用户该代币余额

用 get_erc20_balance（tokenAddress=代币，address=用户）得到余额，便于确认或向用户展示。合约内部会再次按当前区块状态计算比例，无需用此结果参与合约参数。

5.2 授权代币（approve）

建议对 FlapSkill approve 至少对应比例的数量，或直接 approve 全部仓位（如 amount 用很大或「max」）。例如卖 50% 时，approve 至少当前余额的 50% 或全部。

5.3 调用 sellTokensByPercent

比例换算：用户说 50% → _percentBps = "5000"；10% → "1000"；100% → "10000"。

6. 做市/刷量（与创建代币、买卖一致：用户说一句，Agent 自主执行）

做市与创建代币、买卖相同：用户只需说一句自然语言，Agent 自主用 MCP 钱包完成链上授权与登记并启动做市脚本，无需用户再手动发交易或跑命令。

约定：资金方（funder）= MCP 当前发交易的钱包（即 MCP 中 PRIVATE_KEY 对应地址）。做市由 MCP 授权给技能合约（对 FlapSkill approve USDT + setAllowedCallers 登记 worker），由 worker 调用合约 buyForCaller/sellForCaller 完成买卖，不是 MCP 直接买卖。做市 只有启动与停止，不设磨损上限。Agent 在技能目录执行 node scripts/mm-generate-workers.js 生成 2～20 个随机 worker 密钥并按生成时间命名导出到本地（mm-workers-<YYYYMMDD>-<HHmmss>.json），自主通过 MCP 的 transfer_native_token 向每个 worker 地址逐笔转 0.001 BNB 作 Gas（由 Agent 自主完成，用户无需手动转 BNB），然后 MCP 对 FlapSkill approve USDT、setAllowedCallers，并启动 mm-bot（worker 私钥从该文件读取，由 worker 调用合约买卖）。用户无需提供 worker 地址、私钥或手动转 BNB，只说一句即可刷量。做市过程中若某 worker 出现 Gas 不足，Agent 自主使用 MCP transfer_native_token 向该 worker（或 mm-bot 日志中提示的 buyer/seller 地址）转 0.001 BNB 补 gas，无需主人批准，视为做市授权的一部分。

6.1 自然语言示例（做市/刷量）

用户说一句，Agent 自主解析并依次执行：生成 worker → Agent 自主用 MCP transfer_native_token 向每个 worker 发 0.001 BNB 作 Gas → MCP 对 FlapSkill 合约 approve USDT（授权合约可划转 funder 的 USDT）、setAllowedCallers 登记 worker → 在技能目录启动 mm-bot.js（由 worker 调用合约 buyForCaller/sellForCaller 买卖，不是 MCP 直接买卖）。做市只有启动与停止，不会因磨损自动停止。

示例：

使用蝴蝶技能对 0xe139ca52ffd33d7cbb0dfeaf075f943c13937777 进行做市刷量，随机范围：1-10U，资金归集地址：0x62F5cCb8b1744A427b7511374F4eb33114217199

参数对应：

做市时 MCP（funder）对 FlapSkill 合约 的 USDT 授权采用无限授权：amount = max uint256，即 "115792089237316195423570985008687907853269984665640564039457584007913129639935"。若当前 MCP/viem 传该值时报溢出（如内部按 10^18 换算导致超范围），可改用大数值如 "1000000000000000000000000000"（10^27）作为回退。避免 worker 调用 buyForCaller 时因额度用尽报 TRANSFER_FROM_FAILED。资金归集地址为必填：用户必须提供「资金归集地址：0x…」，否则 Agent 不启动 mm-bot 并提示用户补充。不设磨损上限：合约已去掉磨损逻辑，做市只有启动与停止。未说「随机范围」/「成交金额」时用脚本默认（如 0.005～0.02 U）。未说「提供资金」时由 Agent 询问或按常见值（如 100 U）建议。worker 由 Agent 自动生成，无需用户配置。

6.2 合约接口（skill.sol）

• setAllowedCallers(address _token, address[] _callers)：由 funder 调用，登记对该 _token 允许调用 buyForCaller/sellForCaller 的地址（做市脚本的 worker 地址）。调用时合约会从 funder 划转 5 万枚该代币到 0x0000…dEaD 销毁，故调用前 funder 须对该 _token 向 FlapSkill approve 至少 5 万枚（"50000"）。小明对 0x0123 刷量前，小明须先 approve 0x0123 代币 5 万枚再调用 setAllowedCallers(0x0123, [小明的 worker 地址...])。
• buyForCaller(address _token, uint256 _usdtAmount, address _funder)：仅当 msg.sender 已被 _funder 对该 _token 登记时可调用；用 _funder 的 USDT 买入，代币转给调用者。调用前 _funder 须对 FlapSkill approve USDT。
• sellForCaller(address _token, uint256 _tokenAmount, address _funder)：仅当 msg.sender 已被 _funder 对该 _token 登记时可调用；调用者交出代币卖出，所得 USDT 转给 _funder。
• removeAllowedCallers(address _token, address[] _callers)：funder 取消某 token 下部分地址的调用权限。

ABI 见 references/contract-abi.md。