Agent 指南

在 MurkFun 上，你只通过自己电脑上运行的 AI Agent 交易。本网站不能交易，不持有任何密钥，也从不要求你签名。

上面这句话会让你的 Agent 去读技能文件，它会带着 Agent 完成下面的所有步骤。想手动操作，或想核对 Agent 在做什么，就按下面的步骤来。

1. 安装 MCP 服务

在你自己的电脑上，需要 Node 20 或更新版本，从 MCP 服务器的 GitHub 发布版安装。npm 前缀设在用户目录下（例如用 nvm）就不需要 sudo；所有文件都放在 ~/.murkfun 下。murkfun-mcp init 会创建一个随机的保险库密码文件（已有的会保留），下载并校验 0xbow 电路，并打印你的 MCP 客户端配置。重复运行是安全的。

npm install -g https://github.com/murkfun/murkfun-mcp/releases/latest/download/murkfun-mcp.tgz
murkfun-mcp init

同一条命令也会把它更新到最新发布版。如果想从源码构建：

git clone https://github.com/murkfun/murkfun-mcp && cd murkfun-mcp && npm ci && npm run build && npm link

服务器把你的密钥和票据保存在你电脑上的加密保险库中，让你的钱包为每笔订单签名，在本地生成零知识证明，并只把已签名、已证明的订单发送给中继。把 ~/.murkfun/passphrase 离线保存一份：没有它，加密备份毫无用处。

2. 接入你的 Agent

随时可以重新打印配置：

murkfun-mcp config claude-code
murkfun-mcp config json

• Claude Code：运行打印出的 claude mcp add 命令。
• Cursor、Claude Desktop 等客户端：把 JSON 合并进它们的 mcpServers 配置（~/.cursor/mcp.json、claude_desktop_config.json）。
• Codex：把同样的值写进 ~/.codex/config.toml：

[mcp_servers.murkfun]
command = "murkfun-mcp"
args = []
env = { MURKFUN_PASSPHRASE_FILE = "<...>", MURKFUN_RELAYER_URL = "<...>", MURKFUN_DEPLOYMENT = "<...>" }

如果打印出的配置里有尖括号中的值（MURKFUN_RELAYER_URL、MURKFUN_DEPLOYMENT），把它换成真实的值。如果你的客户端找不到 murkfun-mcp（它启动服务器时不带你 shell 的 PATH，用 nvm 时常见），用 murkfun-mcp config json --absolute 打印配置。然后重启 Agent，让它加载 murkfun 工具。

你的 Agent 的客户端不支持 MCP？它可以把每个工具当作命令行命令来运行（你的 Agent 如何与 MurkFun 对接）。

3. 添加技能文件

SKILL.md 告诉你的 Agent 安装步骤、操作顺序和硬性规则。它是给 AI 读的文件：skill.md（也在 /skills/murkfun/SKILL.md）。Claude Code 用户：

mkdir -p ~/.claude/skills/murkfun
curl -fsSL https://murk.fun/skill.md -o ~/.claude/skills/murkfun/SKILL.md

4. 首次运行

1. MurkFun 需要 SPACE ID Agent ID：在 Binance Agentic Wallet 中领取一个（币安 App → 钱包 → AI agent / Agent ID）。然后安装它的命令行工具（npm install -g @binance/agentic-wallet，再运行 baw auth signin），在币安 App 中开启开发者模式，并在 MCP 配置中设置 MURKFUN_SIGNER=baw：之后由代理钱包为每笔订单签名（它没有可导出的私钥）。
2. setup 会创建保险库、显示你的钱包地址，并让钱包对 MurkFun 种子消息签名一次。这个钱包是公开的，与你关联；它从不发送 MurkFun 交易。你的化名来自这个签名：你的钱包就是你的备份。
3. 保护好钱包。如果是代理创建的，请立即用 export_recovery 保存它的私钥（一个明文文件；把它移到离线位置并从电脑上删除）。你也可以使用自己的钱包。
4. 等到 status 显示 holderSet.inAcceptedRoot: true。新的 Agent ID 持有者会分批加入 MurkFun 的持有者集合，无需你发送任何交易，并在其批次发布 1 小时后即可交易。
5. 用 Railgun（默认）时，钱包不需要 BNB：它只负责签名。用 0xbow 时，向钱包发送 BNB：你想存入的金额，外加约 0.003 BNB 的 gas。

5. 买入：两个隐私池

两种方式下，卖出、提现、上限和费用都一样。详见如何运作和隐私。

6. 交易和提现

• 每次买入或卖出前，你的 Agent 会告诉你金额、预计成交、滑点上限（默认 3%）和中继费，等你确认后再执行。
• 代币在曲线阶段时，一个代号最多持有 1% 的供应量。卖光曲线的那笔买入正好拿到剩下的部分，并在同一笔交易里完成毕业；用不完的 BNB 留在该代币的余额里。如果毕业失败，买入要等到有人用 graduate 重试；市场未暂停时，卖出和提取照常可用（一笔卖出会让曲线重新开放）。
• 卖出所得留在 MurkFun 里，作为该代币的 BNB 余额。withdraw_bnb 除市场暂停期间外随时把它付到你给的地址；withdraw_token 毕业后可用。用新地址更隐私。请使用你控制的地址：合约只拒绝部分会让资金丢失的目标地址（MurkFun 合约或代币、WBNB），并非全部（例如销毁地址），所以工具会拒绝所有这类地址；对其他任何合约地址（例如 Safe），工具会先请你确认。

你的 Agent 遵守的安全规则

• 它从不索要、打印或发送种子、钱包私钥、MurkFun 消息的签名、口令、恢复文件或保险库。没有任何 MurkFun 工具会返回它们。切勿在其他任何地方签署“MurkFun seed”消息：那个签名就是你的 MurkFun 密钥。
• 每次存入、买入、卖出、提现或发币前，它都会确认金额、代币和目标地址；不经你同意绝不调高滑点。
• 它绝不覆盖已有的保险库，每次只执行一个 MurkFun 操作。
• 它只提现到你给的地址，绝不提到 MurkFun 合约、MurkFun 代币或 WBNB；只有在你确认某个合约地址属于你之后才会发往该合约，并提醒你：存入、提现地址和时间都是公开的。

MCP 工具

排错

大多数报错并不是 MurkFun 的服务器出了问题。它们来自五个地方：你自己的配置、你的钱包、MurkFun 的中继、链上 MurkFun 的合约，以及隐私池。

如果某个工具中途失败，Agent 会先调用 status 再重试：票据和余额都从链上读取。

备份与恢复

你的钱包就是你的备份：所有机密都派生自它对一条固定消息的签名。在新电脑上，按上述步骤安装并运行 recover_from_wallet：同一个钱包再次签名，你的化名、余额和 0xbow 票据就会从链上恢复。保护好这个钱包；持有其私钥的人可以签署订单，掌控你在 MurkFun 的资金。

你的 Agent 如何与 MurkFun 对接

1. MCP 工具（首选）。你电脑上的 MurkFun MCP 服务为你的 Agent 提供上面这些工具。它把你的秘密保存在加密保险库里，所有证明都在本地生成，只发送已证明的订单。
2. 同样的工具也能作为命令行命令使用，适合客户端不支持 MCP 的 Agent（Codex、Cursor、OpenClaw、脚本）：murkfun-mcp <tool> --arg value 或 --json '{…}'。同样的代码、同样的环境变量、同样的保险库、同样的 JSON 输出；出错时信息写到 stderr，退出码为 1。murkfun-mcp tools 列出每个工具及其 JSON Schema。安全规则也一样：任何工具都不输出秘密，秘密只以文件路径传入、绝不写在命令行上，export_recovery 仍然需要 --confirm。同一个保险库上的调用一次只运行一个。
3. 底层的 HTTP API。读取 API（https://api.murk.fun/v1/launches?sort=new、/tokens/<address>、/tokens/<address>/trades）不需要任何密钥：行情数据可以直接从这里读。中继 API 只接受带有用你保险库生成的证明的订单：只能通过会生成证明的客户端使用，比如 MCP 服务。两者都在 API 页面里说明。

export MURKFUN_PASSPHRASE_FILE=~/.murkfun/passphrase
murkfun-mcp status
murkfun-mcp buy --token 0x… --bnbAmount 0.1
murkfun-mcp order_status --id …

接口地址

行情数据：只读 API，不需要密钥，只有 GET，返回 JSON。基础地址 https://api.murk.fun/v1：

curl -s 'https://api.murk.fun/v1/launches?sort=new&limit=20'
curl -s https://api.murk.fun/v1/tokens/<address>
curl -s 'https://api.murk.fun/v1/tokens/<address>/trades?limit=50'
curl -s https://api.murk.fun/v1/tokens/<address>/holders
curl -s 'https://api.murk.fun/v1/tokens/<address>/candles?interval=5m'
curl -s https://api.murk.fun/v1/tokens/<address>/graduation
curl -s https://api.murk.fun/v1/stats
curl -s https://api.murk.fun/v1/params

上传接口在同一个主机上：POST /v1/ipfs/image 和 POST /v1/ipfs/metadata 把代币的图片和元数据放到 IPFS（upload_token_metadata 会用到）。

中继：中继地址上的 GET /v1/info、GET /v1/quote、POST /v1/orders、GET /v1/orders/:id。每个订单都带有在你电脑上用你的保险库生成的零知识证明，所以下单要通过 MCP 工具（或对应的命令行），绝不是手写 HTTP 请求。

MCP 服务器使用的地址随软件包一起发布，在其 networks/bsc.json 中；murkfun-mcp network 会打印出来。全部路由和字段：见 API 页面。

BNB Chain 上的合约

BSC 主网（链 ID 56），部署于区块 132262524。源码已在 Sourcify 验证；链接打开 BscScan。

• MurkFunFactory0x11e02275559FEDd72a0B578cc5b4c0F766aCa25ASourcify
• MurkFunMarket0x9717126512c5a4D3b5c0E13421639ea80DACaa91Sourcify
• MurkFunOrders0xCc09A7772aDAf0586040a933b70B1248F432eb87Sourcify
• OrderVerifier0xfA99009F7c850294aDd481cD6764f60F547076b7Sourcify
• MurkFunDex0x69d0B74c1b6C835e212E6EDe9AfB1e7286DD3FF4Sourcify
• MurkFunInfinityHook0x833eAEe7102Ea77C5Bb0C6B2Fb3F64F9032B45e6Sourcify
• MurkFunLocker0xFD25D90f151193A795E4a9De6F0bBB9dD5AA32A8Sourcify
• MurkFunPrivacyPoolAdapter0x0242771ba1758554fa6C806d9219c7dF891c9879Sourcify
• MurkFunRailgunAdapter0x2ba9978Ba84dB605c1b6a7F0885f84Af340Ad249Sourcify
• MurkFunHolderRoots0xD59867DADC96202284Fa54d016C6d66a0adBaE24Sourcify
• BatchVerifier0x3BA574b3d102800c3E08E2F978A4d802C15b8C9ESourcify

自己核验

每笔订单都要证明自己属于的持有者集合，任何人只凭链上数据就能核对：github.com/murkfun/holder-roots 从合约的 Batch 事件重建整棵树，把每个根与 MurkFunHolderRoots 比对，按 SPACE ID 注册表审计整个集合，检查已部署的字节码就是它的源码，并能发送欺诈证明。按下面的命令安装并重建这棵树，或在持有者页面浏览这个集合。

npm install -g https://github.com/murkfun/holder-roots/releases/latest/download/murkfun-holders.tgz
murkfun-holders tree