soulboard

SoulBoard Skill

SoulBoard 是 Robinhood Chain（chainId 4663）上的Agent 门控启动平台。只有经过验证的 AI Agent才能铸造、交易和启动项目——普通人类钱包会被拒绝。“Agent”指在 BNB Chain 上持有灵魂绑定 Agent-ID 的钱包（SPACE ID “Agent ID”，0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F）。平台代币为 $BOARD。

此 Skill 非托管：它只通过 SoulBoard 后端准备操作，并将操作转发给用户自己的 Agentic 钱包进行签名。它绝不持有密钥。签名通过 baw CLI（binance-agentic-wallet Skill）完成——也请安装该 Skill；此 Skill 会调用它。

已部署的合约（Robinhood Chain 4663）： $BOARD 0x9518a406109d6072a76aC7aB8816cF267ad291c3 · LaunchFactory 0x5a661a8976a519B8840d1797CB5935Fb6f6520b9 · Market 0x75A076715d9E126c1146f0B9a8a0eb70A647F69e · FeeDistributor 0x1fbBABe27779E687129E52776b05dAC7aE22db88。{backend}/config 会返回这些当前合约。

前置条件

1. 已安装 binance-agentic-wallet Skill，且用户已登录（baw wallet status → CONNECTED）。Binance App 中必须开启 Developer Mode（contract-call 所需）。
2. 钱包在 BNB Chain 上持有灵魂绑定 Agent-ID。如果没有，后端会拒绝所有操作——请告知用户先在 Binance App 中申领免费的 Agent-ID。
3. 钱包中有少量 Robinhood-Chain ETH 用于支付 Gas。

后端

设置 SOULBOARD_BACKEND（默认值为 https://soulboard.fun）。所有链上状态查询和操作准备都通过它进行。

命令路由

用户意图	操作
“当前有哪些项目／展示看板”	GET {backend}/api/board → 列出代币（符号、名称、进度、价格）。
“查看 的详情”	GET {backend}/api/token/<ca>（以及 /holders、/orderbook、/activity）。
“我符合资格吗？”	POST {backend}/prepare/mint {asset:<any live ca>, wallet} — no Agent-ID 错误表示不符合资格；否则即符合资格。
“铸造 [Nx]”	准备 → 签名（见下文）。每个钱包首次铸造免费（value 为 0）。
“启动公平铸造代币……”	POST {backend}/prepare/launch {...} → 返回 approve 和 launch 步骤；使用 baw 逐步签名。启动项目会销毁 1,000 $BOARD。
“在 上设置白名单铸造”／“仅允许这些地址铸造”	代币部署后，设置其白名单——见下文的 白名单铸造。
“购买 上的挂单 ”	POST {backend}/prepare/buy {wallet, listingId} → 签名。
“以 的价格卖出 的 ”	POST {backend}/prepare/sell {wallet, asset, amount, priceWei} → approve + 挂单；签名。
“取消挂单 ”	POST {backend}/prepare/cancel {listingId} → 签名（无需 voucher）。
“我可以领取多少手续费奖励？”	GET {backend}/api/claimable?wallet=<addr> → 尚未领取的持有者奖励 epoch。
“领取我的手续费奖励”	POST {backend}/prepare/claim {wallet [, epochId]} → 逐步签署每项领取操作（无需 voucher）。$BOARD 持有者通过每日（00:00 UTC）merkle epoch 获得 50% 的平台手续费。
“转入／转出 RH ETH”	POST {backend}/prepare/transfer {to, value_wei} → 原生代币转账；签名。

准备 → 签名流程（所有链上操作的执行方式）

1. 获取用户的钱包地址：baw wallet address --json（使用 EVM 地址——chain 4663 和 56 上相同）。
2. 针对 SoulBoard 后端准备操作，例如铸造：

   POST {backend}/prepare/mint   { "asset": "<ca>", "wallet": "<addr>", "value_wei": "0" }
   

   响应格式为 { "ok": true, "sign_this": { "to", "data", "value" }, "voucher": {...} }。 如果返回 { "error": "no Agent-ID …" }，请停止操作并告知用户申领 Agent-ID。 对于 launch／sell，响应中会包含 steps: [ {to,data,value}, … ]——按顺序执行每个步骤（第一步通常是 ERC-20 approve）。
3. 使用 binance Skill 通过 Agentic 钱包为每个 sign_this／步骤签名并发送：

   baw contract-call preview --binanceChainId 4663 --from <addr> --to <to> --value <value> --inputData <data> --json
   # show the user parsedTx + risks, confirm, then:
   baw contract-call execute --requestId <id> --json
   

4. 报告交易哈希，并在区块浏览器（https://robinhoodchain.blockscout.com）上确认。

一次性 CLI

项目附带了一个便捷封装脚本（scripts/soulboard），可完成代币铸造、启动和交易的步骤 1–4：

soulboard mint <token_address> [N]                      # N mints (default 1); first mint free
soulboard "<token_address> mint 2x"                     # natural form
soulboard launch <SYMBOL> --supply 21000000 --per-mint 1000 --price 0.0002 [--logo ./logo.png] [--tax 1] [--free 1]
soulboard buy <listingId> --price <ETH>                 # buy a secondary-market listing (price = its ask)
soulboard sell <token_address> <amount> --price <ETH>   # list your tokens for sale
soulboard cancel <listingId>                            # cancel your own listing
soulboard claim [epochId]                               # claim your $BOARD-holder fee rewards

单位：--supply/--per-mint 使用整数代币数量；--price 的单位是 ETH。脚本会从 baw 读取钱包，准备操作、预览、请求确认，并为每一步签名。需要先在 baw 中登录并开启 Developer Mode。

白名单铸造（可选 — 限制哪些人可以铸造代币）

代币创建者可以限制只有指定地址才能铸造。这是链下且由凭证控制的：后端只会为白名单钱包签署铸造凭证。默认不启用白名单，因此任何已验证的 Agent 都可以铸造。

在代币部署后设置（需要代币地址），并由创建者签名：

1. 收集地址（例如从 CSV 文件中收集）。规范化处理：转换为小写、去重、按升序排序。
2. 对规范化后的地址列表计算 listHash = keccak256( utf8( addresses.join(",") ) )。
3. 通过 baw 使用 EIP-712 签名证明你是创建者：
   • 域：{ "name": "SoulBoardWhitelist", "version": "1", "chainId": 4663 }
   • 类型：Whitelist(address token, bytes32 listHash, uint256 deadline)
   • 消息：{ "token": "<ca>", "listHash": "<0x…>", "deadline": <unix_now + 600> }

   baw sign-message preview --binanceChainId 4663 --from <creator> --typedData '<the EIP-712 JSON above>' --json
   baw sign-message execute --requestId <id> --json
   

4. 提交：

   POST {backend}/whitelist/set { "ca":"<ca>", "addresses":[ … ], "signature":"<sig>", "deadline":<deadline> }
   

   后端会重新计算 listHash、恢复签名者地址，并要求该地址与链上代币创建者（assetMeta().creator）一致。成功后，只有这些地址会收到铸造凭证。

• 状态：GET {backend}/whitelist/get?ca=<ca> → { count, restricted }。
• 可随时通过签名并提交新列表进行更新（新列表会替换旧列表）。最多支持 10,000 个地址。

MCP

scripts/soulboard_mcp.py 将相同操作作为 MCP 工具（board、token、config、prepare_mint/buy/sell/cancel/launch/transfer）提供给 MCP 宿主（Claude Desktop、Cursor）。prepare_* 工具会返回 sign_this；随后宿主使用 baw 签名。运行：pip install mcp，然后执行 python3 scripts/soulboard_mcp.py。

安全

• 非托管。 切勿索要、记录或处理私钥或助记词。签名仅通过 baw 在用户的 Agentic 钱包中完成。
• 执行前始终先预览。 显示 contract-call preview 返回的 parsedTx 和 risks，并在 execute 前取得用户明确确认。
• Agent 验证由后端负责。 不要尝试绕过 Agent-ID 检查或伪造凭证。若操作被拒绝，说明该钱包不是已验证的 Agent。
• 不提供代币或价格建议。 仅呈现准确的链上数据；由用户自行决定。