Gloam

---

稳定币正逐渐成为企业和 AI Agent 彼此支付的方式，而每一笔支付都是公开的。Gloam 让支付变得私密，并允许付款方准确证明对方需要查看的信息：余额高于某个数额、已完成一笔支付，或工资总额；证明仅面向一位指定的查看者，并设有有效期。Gloam 已在 Robinhood Chain 和 Tempo 主网上线，目前处于测试阶段，并设有存款限额。你可以私密地向任何人付款、通过认领链接汇款、发放工资、直接从私密余额兑换（兑换者身份保持私密；代币和金额公开，与任何 DEX 交易一样），也可以一次性提现，或在一段时间内分批私密提现。

为什么一个所有者很重要。 隐私有两类任务。共享秘密（密封拍卖、订单簿、借贷池）需要有人对多人的隐藏数据进行计算，因此 Zama 和 Arcium 等 FHE 与 MPC 网络会使用持有密钥的委员会。支付只有一个所有者，因此所有者可在自己的设备上使用零知识证明进行证明，无人会持有密钥。如果委员会或运营者遭到入侵，所有人都可能暴露，包括过去的支付记录。如果一个所有者的设备遭到入侵，受影响的只有一个人。Gloam 并未发明新的密码学技术：它采用 Zcash 系列经验证的 ZK 数学，并在此基础上构建支付产品。有关与 Zama、Arcium、Tempo Zones、Helius Privacy 和 Railgun 的完整对比，请参阅：gloam.trade/docs/compare。

新内容

Gloam 并非新的密码学技术，而是金融领域的全新构件：可证明的私密支付。据我们研究所知，以下三个部分是新的：

1. 工资总额证明。 payroll_total 可证明最多 32 笔支付的总额恰好等于指定数额，且所有款项均由证明者提供资金，而不透露每个人收到多少。我们没有发现类似方案。
2. 限定给单个查看者的证明。 标签（证明的指定对象）、有效期、链和资金池都会被哈希为公开的 context 输入，并绑定到 solvency、receipt 和 payroll_total 证明中。更改标签，证明就会失效。任何人都可以在浏览器中验证证明，无需钱包，访问 /verify 即可。常见的替代方案是查看密钥，它会显示完整历史记录，而且无法撤销。
3. 面向 AI Agent 的私密支付。 为 Tempo 和 Stripe 提出的 Machine Payments Protocol 提供一种私密支付方式 (tempoxyz/mpp-specs#376；MPP 此前没有私密支付方式)，提供私密的 x402 支付，以及一个 MCP 服务，让 Agent 使用句柄而不是秘密信息，并设有支出限额。

并非新内容：私密资金池设计（2016 年起的 Zcash 系列，以及 Tornado、Railgun、Cloak）和选择性披露这一理念（Zcash 和 Railgun 的查看密钥、Privacy Pools、Zama 的解密权限）。有一项需要坦诚说明的限制：查看者仍可以转发证明。证明会说明其指定对象和到期时间，下一步将推出指定验证者模式。

三个入口，共享一个私有核心

保险库应用是参考实现，但并非产品的全部。

入口	说明	软件包
SDK	将屏蔽余额、私密转账和选择性披露集成到任意链上应用或 Agent 中，支持 Robinhood Chain 或 Tempo。使用未签名意图 + 客户端证明。	@gloamtrade/sdk
Agents	一个 MCP 服务 + 参考封装，供 AI Agent 在策略约束下通过 x402 或 MPP 私密地屏蔽资产、转移价值并支付工具费用。	@gloamtrade/mcp · @gloamtrade/mppx-gloam · examples/
Vault	两个主网上运行的应用，用于证明整个流程可行。	app/
Partner API	应用使用 API 密钥添加私密支付，设置自己的费用（每笔私密支付收取固定费用，提现和存款按比例收费），并在合作伙伴门户中实时查看归因交易量和预计费用。目前尚未收取合作伙伴费用，主网上也一样：每个响应都会显示 "charged": false，门户会显示该设置预计产生的收益。主网上仅收取 Gloam 自身 0.25% 的提现费用。实时密钥（gloam_live_）用于主网，测试密钥（gloam_test_）用于测试网。	/partners · /docs/partners · GloamApiClient

三者共享同一个核心：Poseidon 笔记方案、深度为 20 的增量 Merkle 树、circom 见证构建器、真实的 Groth16 验证，以及统一的规范意图结构。

主网 Beta

Gloam 自 2026 年 10 月 21 日星期三 13:00 UTC 起，已在 Robinhood Chain 主网（4663）和 Tempo 主网（4217）上线。这是 Beta 软件。上线前已进行内部审查（2026 年 10 月 20 日，没有尚未解决的严重或高危问题）；10 月 23 日的独立审查未发现新的可利用合约漏洞，并发现 8 个应用问题，目前正在合并相关修复。计划进行外部审计，但尚未完成。

	Robinhood Chain 4663	Tempo 4217
资金池	ShieldPoolPayments，仅支持支付	ShieldPoolPayments，仅支持支付
资产	USDG、$GLOAM	USDC.e、pathUSD、USDT0、OUSD
Gas	ETH（不是资金池资产）	以稳定币支付
密钥	来自可信设置的最终密钥	来自可信设置的最终密钥
私密兑换	在 Uniswap v4 上兑换 USDG 和 $GLOAM（GloamVaultSwapV4）。路由器 v2（GloamVaultSwapV4b，支持任意允许列表中的资金池，以及通过 WETH 兑换 ETH）已部署；待 10 月 26 日执行另外 28 种代币的排队存款限额后，即可在应用中启用	在 Tempo 的稳定币交易所兑换 USDC.e、pathUSD、USDT0、OUSD（GloamVaultSwapTempo）

• 费用。 存款和私密支付免费。提现收取 0.25%。私密兑换按兑换金额收取同样的 0.25%，另加价格缓冲（Robinhood Chain 为 0.5%，Tempo 为 0.1%），未使用部分将转入金库。自 10 月 24 日起，费用转入独立的金库钱包（0xB390…30B8）；其中一半将用于回购 $GLOAM，回购的代币一半销毁，一半保留。
• Beta 存款限额。 每笔存款限额为 500，每种稳定币的总限额为 25,000；$GLOAM 每笔存款限额为 25,000，总限额为 250,000。提现和私密支付始终不限额。提高限额或添加资产需等待公开的 3 天时间锁；所有者可以立即降低限额或关闭存款。
• 密钥。 主网证明使用来自 13 位贡献者参与的可信设置的最终密钥（drand 轮次 6561386，发布版本 ceremony-final）。
• 合作伙伴。 Raeto 使用 Gloam 私密余额为 AI Agent 提供资金；Agent Wormhole 会在付款前检查 Agent 的付款请求（MCP 0.4.0，可选）。

地址见下文的合约。

当前可用功能（真实 ZK 证明）

除非表格行另有说明，以下所有功能均在两个主网上运行。

路径	状态	可执行的操作
Shield	已上线，需提供证明	在 Robinhood Chain 上存入 USDG（Paxos Global Dollar）和 $GLOAM，在 Tempo 上存入 USDC.e、pathUSD、USDT0 和 OUSD，且须遵守 Beta 阶段的存款限额。资金池会强制执行 shieldBound()，要求存款证明满足 commitment == Poseidon(secret, amount, asset)（审计 C1）
Private send	已上线	在金库内向 Gloam 地址转账。收款人可通过各链支付公告板上的加密提醒（GloamPayMemo）找到这笔款项；公告板绝不会记录发布者身份。Gloam 中继会发布提醒，因此你的钱包也不会成为发送方
Private payroll	已上线	上传 CSV，一次性向整个团队支付任意金库稳定币。Gloam 地址的收款人会直接收到款项和加密提醒；其他人则会收到领取链接。支持崩溃安全恢复和导出结果。文档
Scheduled payroll	已上线	将付款名单保存为计划（每月、每两周、每周或一次性），并设置每次执行的上限和结束日期。出现“Payroll due”提醒后，点击一次即可执行。计划在浏览器中运行，因为只有你持有密钥；计划会以加密形式静态存储
Payment requests	已上线	分享链接或二维码，打开后会进入 Pay，且自动填入你的 Gloam 地址、金额、资产和备注。详情位于 # 之后，因此不会发送到服务器，付款请求的任何信息也不会上链
Claim links	已上线	通过链接向任何人付款。免费领取：无需 Gas、助记词或购买任何东西。领取时，付款会转入一笔只有领取者知道的新票据，因此发送方无法将其花回
Gloam relay	已上线	代表 Gloam 账户提交已验证的转账、提现、隐私兑换和付款备注，因此用户的钱包不会出现。每次仅处理一笔支出，每次备注内容很短，且不能提现到金库本身。每笔付款都会先在资金池中进行模拟运行；提现收款人会绑定在证明中，因此中继只能提交或拒绝。主网启动时由 Gloam 团队运行中继器：中继器支付 Gas，且无法转移或改派资金。SDK relayIntent，MCP GLOAM_USE_RELAY=1
Passkey lock	已上线，可选	在浏览器中使用通行密钥（Face ID、Touch ID、安全密钥）保护私有余额。WebAuthn PRF 输出会封装用于静态加密票据的密钥，因此应用只能通过通行密钥解锁。即使没有通行密钥，备份仍可恢复。不支持 PRF 的浏览器会使用设备密钥。文档
Sanctions screening	已上线	根据随软件提供的 OFAC 受制裁地址列表快照（EVM）进行检查：应用中在签名前以及 /api/screen 会检查存款钱包；中继在提交前会检查每个提现地址。仅检查公开地址；被拦截的钱包只会看到一条中性提示。使用 node app/scripts/refresh-ofac-list.mjs 刷新；可选通过 CHAINALYSIS_API_KEY 进行 Chainalysis 检查
Issuer policies (Tempo)	已上线	Tempo 上的存款和提现还会遵守稳定币的 TIP-403 转账政策：存款时，钱包必须获准发送且金库必须获准接收；提现时，金库必须获准发送且收款人必须获准接收。应用、/api/screen 和中继会在制裁筛查旁进行只读检查，并在发行方政策或暂停机制会阻止金库自身操作时发出警告。无需运营方即可实现合规隐私
Cash out	已上线，需提供证明	使用真实的浏览器生成 Groth16 证明解除屏蔽，将资金提至公开余额。立即会一次性发送。隐私模式会将金额拆分成 2 到 4 笔看似普通的款项，并在你选择的时间窗口内通过中继分别发送，因此提取金额不会与存入金额对应。资金池收取 0.25%；提现从不设限
Exact balance	已上线，新格式	精确证明一个私有余额，不透露其他信息。gloambal1 证明由设备根据显示金额的收据电路生成，带有标签和有效期，且绝不上链。旧版 gloamdisc1 披露已弃用：任何人都能复制公开存款中的披露，因此 /verify 不再接受它
Proof of funds	已上线，新电路	证明你在最多四笔私有余额中持有至少指定金额，而不显示余额。gloamfunds1 证明带有标签（指明证明对象）和有效期，二者均绑定在证明中；在 /verify 上离链验证时，会在浏览器中对照实时金库进行检查，包括确认对应余额仍未花费。文档
Proof of payment	已上线，新电路	gloampay1 收据用于证明已完成一笔私密付款（付款双方任一方都可生成；目前不会显示付款方或收款方）：可显示金额，也可仅证明金额至少达到某个数值，并将证明锚定到金库中的真实付款。使用相同的标签和有效期，在 /verify 上离链验证。验证器采用失败关闭策略：无法在链上确认的付款、找零输出或存款均无法通过
Payroll total proof	已上线，新电路	gloamroll1 证明可证明某次工资发放通过指定数量的私密付款恰好支付了指定总额，而不显示任何单笔金额。使用相同的标签和有效期，在 /verify 上离链验证
Private agent payments (x402)	SDK 和 MCP 已上线	Agent 通过 HTTP 402 使用私密转账为工具付款。付款票据会加密至收款人的接收标签，收款人会先将其转入一笔新票据，再提供服务，因此付款方无法将其花回。MCP 0.4.0 中可选进行 Agent Wormhole 检查（GLOAM_WORMHOLE_KEY）：在生成任何证明前检查付款请求，只有获准的付款才会支付。SDK 中的 settleGloamPayment，MCP 服务中的 gloam_fetch_paid / gloam_verify_payment
Agent spending limits	已上线（MCP）	所有者可为每个 Agent 设置资产、单笔和每日上限、允许的收款人、工具及有效期。每笔支出都会在生成证明或签名前检查并记录；未设置限额即禁止支出。票据机密信息保存在服务内部的加密存储中，Agent 只能看到句柄。由 MCP 服务在链下强制执行。gloam_get_limits、gloam_get_spending_report。配置
Hosted MCP server	已上线	将 https://www.gloam.trade/mcp 粘贴到 Claude（Settings、Connectors、Add custom connector）、ChatGPT、Cursor 或任何 MCP 客户端中，无需安装。仅支持读取和规划：网络和资产、金库统计、付款请求链接、证明检查、存款计划及 MPP 使用说明。不会签名，并会拒绝任何看起来像密钥或票据机密信息的内容；如需签名，请使用本地服务（npx -y @gloamtrade/mcp）。文档
Transparency page	已上线	/transparency 展示任何人都能查看的各网络金库信息：持有资产、存款、私密转账、提现和付款消息的数量，以及近期公开活动；数据直接读取自公共节点
Private swaps	已上线	在 Vault > Swap 中直接使用私有余额兑换：Robinhood Chain 上的 USDG 和 $GLOAM（Uniswap v4），以及 Tempo 上的 USDC.e、pathUSD、USDT0 和 OUSD（Tempo 的稳定币交易所）。一笔中继交易会将一张票据解除屏蔽到一次性 CREATE2 托管合约（SwapEscrow），买入确切数量的目标资产，再将其重新屏蔽为一张新票据。兑换者身份、支付所用的票据以及输出资金接下来的去向均保持私密；代币和金额公开。如果有人单独发送解除屏蔽步骤，兑换会安全失败，并退回 99% 的票据金额作为退款票据。v1 路由器没有所有者、管理员或升级机制。Robinhood Chain 上的路由器 v2 会在存款限额生效后添加 ETH、股票代币及其他代币（10 月 26 日）；其所有者只能在公开延迟 3 天后添加资金池，或移除资金池。文档
Sealed trade	已弃用	sealedSwap 是首个私密交易设计。审计 H1（偿付能力）以及 2026-10-11 发现的速率溢出问题（ZK-1）之后，该功能在所有网络上均保持关闭（主网资金池完全没有兑换代码）。它已被 Private swaps 取代
每项私密操作都必须通过链上证明验证。没有模拟成交，也没有作秀式隐私。如果某条路径目前无法同时做到隐私和偿付能力，就暂不开放。请参阅 contracts/audit/H1-SWAP-SOLVENCY.md。

选择性披露：默认私密，按需证明

这是对“暗池”质疑的回应。持有人只向一位阅读者证明一项关于其资金的事实，不透露其他信息。共有四种证明：gloambal1（精确余额）、gloamfunds1（余额至少达到某个金额）、gloampay1（已完成一笔付款）和 gloamroll1（薪资总额）。每种证明都包含一个标明接收对象的标签和有效期，两者都会绑定到证明中；无需钱包，即可在 /verify 根据实时金库进行链下验证。请在 /app/disclose 生成证明。

验证页面会明确说明这些证明无法证明什么：付款证明只能表明发生过一笔付款，无法说明持有人是付款方还是收款方，因为票据目前尚未绑定接收方密钥。原始 gloamdisc1 格式复用了存款声明，因此任何人都能从公开存款数据中复制一份；该格式已弃用，且永远不会通过验证。

原生支持 Robinhood Chain

Robinhood Chain 是一条 Arbitrum Orbit L2（Nitro，主网自 2026 年 7 月起上线），使用 ETH 支付 Gas，并采用 Ethereum Blob DA。Gloam 针对该链实际提供的功能进行适配：

• 从区块零开始支持 Chainlink 预言机。 RH Chain 通过标准的 AggregatorV3 喂价在链上为代币化股票定价。Gloam 的 OracleRates 模块将密封交易汇率绑定到实时喂价，并加入 L2 排序器运行状态、数据过期时间和正值检查，以及比率容差检查；后者同时也是链上滑点保护。该模块是为密封交易构建并测试的（contracts/src/lib/OracleRates.sol），但密封交易已弃用。私密兑换使用 DEX 池自身的价格。
• 代币化股票是 ERC-20（18 位小数，采用 ERC-8056 Total-Return 值）。股票代币及其他流动性较高的 Robinhood Chain 代币的存款限额已排入 3 天时间锁队列；限额生效后，私密兑换即可将这些代币买入金库。
• Groth16 可原生运行。 bn254 配对预编译合约已部署，96 KB 的代码大小上限也足以容纳大型验证器合约，因此无需特殊基础设施即可验证 shield / unshield / transfer 证明。
• 一等公民 ERC-4337 为免 Gas 私密交易打开了大门。

已在 Tempo 上线

同一套私密核心也运行于 Tempo 主网（4217）上。这是一条以支付为先的稳定币 L1，Gloam 在其上为个人和 Agent 提供私密稳定币支付。Tempo 自带由运营方管理的隐私功能（Zones）；Gloam 则是可自托管、无需许可的补充方案，用户可选择性披露信息并交给发行方或审计员。Shield USDC.e、pathUSD、USDT0 或 OUSD，即可发送、兑换和提现，全程由证明验证。由于 Tempo 禁止使用原生 msg.value，并以稳定币支付 Gas，Gloam 在该链上 shield 的是 ERC-20 稳定币，而非原生资产。设计与限制：TEMPO_EXPANSION.md。

Base：测试网已上线，主网即将推出

Base（基于 OP Stack 的 Ethereum L2）是第三条链。自 2026 年 10 月 24 日起，Base Sepolia（84532）作为测试网已上线；在 Base Sepolia 完成端到端测试后，Base 主网（8453）将使用相同代码上线。两者都运行主网金库（最终密钥上的 ShieldPoolPayments、Beta 存款限额、0.25% 取现手续费），因此 Base Sepolia 是运行在主网合约和密钥上的测试网。

• 资产。 两者均支持 USDC、EURC 和 ETH；仅主网支持 USDT（从 Ethereum 桥接而来的 Tether），因为 Base Sepolia 上没有 USDT。每种稳定币每笔存款限额为 500，总限额为 25,000；ETH 每笔存款限额为 0.2，总限额为 10。
• Base Sepolia。 金库地址为 0x39e28cde55cab798874746ac52cb4b5cc99a0194（部署区块 49802958），付款消息板地址为 0x01B3172d9900Cb26d57E986429b9b23854c74598，与其他链上的地址相同；所有合约源代码均已在 Sourcify 上验证。可从 faucet.circle.com 获取测试 USDC 和 EURC，从 Base Sepolia 水龙头获取测试 ETH。地址：contracts/deployments/base-sepolia.json。
• Base 主网。 尚未部署。填入其资金池后，应用、SDK（0.3.0）和 MCP 服务（0.5.0）中就会显示；在此之前，它在任何地方都不存在。
• 后续计划。 在 Base 上进行私密兑换（Uniswap v4 上的 router v2），以及将资金转入 Base（Relay 桥）。

部署手册：DEPLOY-BASE.md。

下一步：Ethereum

Ethereum 主网（1）是第四条链，使用相同的主网金库（ShieldPoolPayments、最终密钥、Beta 存款限额、0.25% 取现手续费）。其测试网是下文所述的 Ethereum Sepolia，使用相同的合约和密钥。

• 资产。 支持 USDC、USDT、USDG、PYUSD 和 EURC，每种每笔存款限额为 500，总限额为 25,000；还支持 ETH，每笔存款限额为 0.2，总限额为 10。
• Gas。 仅当 Gas 低于上限（默认为 3 gwei）时，Gloam 中继器才会为中继的私密转账和取现支付 Ethereum Gas；超过上限时，中继器会等待，应用也会显示相应提示；稍后处理的取现会等待 Gas 费下降。
• 状态。 尚未部署。填入其资金池后，应用、SDK（0.4.0）和 MCP 服务（0.6.0）中就会显示；在此之前，它在任何地方都不存在。

部署手册：DEPLOY-ETHEREUM.md。

Ethereum Sepolia：测试网已上线

Ethereum Sepolia（11155111）与 Base Sepolia 一样运行主网金库：最终密钥上的 ShieldPoolPayments、Beta 存款限额、0.25% 取现手续费。支持测试 USDC 和 EURC（Circle）、测试 USDG 和 PYUSD（Paxos），以及 ETH；每种稳定币每笔存款限额为 500，总限额为 25,000；ETH 限额为 0.2 和 10。该测试网自 2026 年 10 月 25 日起已上线：金库地址为 0x465EbfcdE1e384C7B1e8388E1aFEA95438c7A0ef（部署区块 11992914），付款消息板地址为 0x8699D015087dE6D25d55d5ceB63b34b9d773f135（区块 11992942）；目前已在应用中提供，SDK 和 MCP 服务将在下一版本中提供。地址：contracts/deployments/ethereum-sepolia.json。部署手册：DEPLOY-ETHEREUM-SEPOLIA.md。

值得信赖，经得起验证

在主网运行之前，隐私保护必须可核查且正确。主网软件仍处于 Beta 阶段，以下是当前情况。

• 审核进展。 主网前的内部审核已于 2026 年 10 月 20 日结束，没有尚未解决的严重或高危问题。10 月 23 日的独立审核未发现新的可利用合约漏洞，但发现了应用中的 8 个问题（金额输入、保存备注、工资发放恢复与地址、API 密钥轮换，以及两个显示数字）；修复正在合并。外部审计已列入计划，但尚未完成。在此之前，Beta 存款限额会限制每个资金池可接收的金额。
• 早期审核。 Kensho 对合约的审核以及对电路的独立审核（最近一次于 2026-10-11）均未发现窃取、增发、双花或转移资金池资金的方法。发现的问题已修复或停用：早期首个密封资金池中的严重资金抽干漏洞（资金已被抽走，资金池已下架）、存款时的价值绑定问题（C1）、兑换偿付能力问题（H1，已停用密封交易）、过度认领的证明检查器，以及可被复制的旧版披露方式。所有发现及其状态见：contracts/audit/REMEDIATION.md。
• 没有管理员提款功能，规则变更设有时间锁。 团队无法调用任何函数提取资金池中的资金，备注也只能通过解除屏蔽证明离开资金池。主网资金池会在创建它们的同一次部署中结束设置（endSetup()），因此，新增验证器、提高存款限额、新增资产或提高费用，都必须在链上排队，并等待公开的 3 天延迟后才能执行（queueChange）。降低限额或关闭存款则可立即生效。请在下方列出的资金池上验证 setupMode() == false。
• 选择性披露，而非混币器。 无需披露所有信息，即可向交易对手方或审计员证明余额或付款。对于由受监管机构赞助的链，这是合适的做法。
• 快速同步资金库，隐私不变。 应用通过一次请求从 /api/vault-leaves 加载资金库的公开叶子列表（按顺序排列的每个承诺），而非遍历区块链；随后在浏览器中重建 Merkle 树，并且仅当根哈希与资金池的链上根哈希匹配时才使用，否则会直接读取区块链。该请求只标明网络，且对所有人都相同，因此服务器无法获知哪些备注属于你。
• 如实设置安全门槛。 主网使用多方可信设置生成的最终密钥运行（13 位贡献者，drand 轮次 6561386，发布版本 ceremony-final）：部署脚本会拒绝创建不满足以下条件的资金池：链上验证器接受最终密钥证明，并拒绝开发密钥证明。自 10 月 24 日起，提现费用会进入专用金库钱包（此变更经过了时间锁等待期）；所有者是一个钱包，多签计划正在制定中。Gloam 团队运行中继器：它只提交已经证明的交易并支付 Gas，无法转移或重定向资金。备注密钥和接收密钥在静态存储时均已加密（使用不可导出的设备密钥执行 AES-GCM 加密，或由通行密钥 PRF 封装），审计编号 M-1。有人向你付款时，款项会在你领取时转入一条只有你知道的新备注，因此发送方无法再次花费这笔款项。

使用 SDK

只需几行代码，即可向池中进行私密存款。SDK 会铸造票据并生成屏蔽证明；你只需签署解析后的调用。本示例将 USDC.e 存入 Tempo 主网（@gloamtrade/sdk 0.2.2）：

import { mainnetNetwork, buildShieldBoundIntent, artifactProver, circuitArtifactUrls, TEMPO_USDCE } from "@gloamtrade/sdk";

const net = mainnetNetwork("tempo")!;
const intent = await buildShieldBoundIntent({
  chainId: net.chainId,
  poolAddress: net.pool,
  asset: TEMPO_USDCE,
  amountWei: 25_000_000n,                    // 25 USDC.e (6 decimals); beta cap is 500 per deposit
  prover: artifactProver(circuitArtifactUrls("shield", net.chainId)),
});

// intent.exec is the resolved shieldBound(asset, amount, commitment, proof) call.
// The wallet approves the pool for the amount first (the pool pulls the token with transferFrom).
// Persist intent.note.secret to spend the balance later.
await wallet.writeContract({ ...intent.exec, abi: shieldPoolAbi });

• 显式传入主网网络：为保持向后兼容，SDK 仍默认使用测试网。getGloamNetwork(key) 接受 "robinhood-mainnet" 或 "tempo-mainnet"，而 circuitArtifactUrls 会为主网链选择最终密钥。
• 如需收款，scanIncomingPayments 会读取付款公告板，查找发送至你的 Gloam 地址的款项；sweepReceivedNote 会将每笔款项转入一张新票据，以防付款方将其取回。参见 packages/sdk/examples/receive-and-credit.ts。
• cashOutFee(amount) 返回主网提现时池子收取的费用（CASH_OUT_FEE_BPS = 25，即 0.25%）。

可运行的示例位于 examples/：用于屏蔽资金的 Agent（agent-shield）、支付机器人、私密 x402 和 MPP 付款，以及网页屏蔽工具。使用 npx create-gloam-app 启动新应用。

架构

gloam/
  packages/sdk/          @gloamtrade/sdk  the private path as a reusable package
  packages/mppx-gloam/   private payment method for the Machine Payments Protocol
  packages/create-gloam-app/  starter for a new app on the SDK
  mcp/                   @gloamtrade/mcp  agent server (plan + signed execution)
  examples/              agent-shield, pay-bot, pay-x402, mpp-gloam, web-shield
  app/                   Next.js reference app + docs → Vercel root: app
  contracts/             Foundry · ShieldPoolPayments (mainnet) and ShieldPoolPoseidon (testnet) vaults, verifiers, circuits, audit

合约：Robinhood Chain 主网 4663

角色	地址
付款金库 ShieldPoolPayments（仅用于付款，无管理员提现功能；规则变更设有 3 天时间锁）	0x39e28cde55cab798874746ac52cb4b5cc99a0194
部署区块	94194599
PoseidonT3	0x1a32…9Cb4
所有者（一个钱包；计划采用多签）	0x76b7…D4D8
中继器（由 Gloam 团队运行；提交已证明的交易并支付 Gas，无法转移或改道资金）	0xb1E9…512e
私密兑换路由器 GloamVaultSwapV4（Uniswap v4，部署时固定三个池；无所有者、管理员或升级机制）	0x34AB…c52d
私密兑换路由器 v2 GloamVaultSwapV4b（允许列表中的 Uniswap v4 池，通过 WETH 处理 ETH，最多 3 跳；仅在 3 天延迟后添加池；排队的存款限额执行后，即可在应用中使用）	0xfCa1…F2DC
付款公告板 GloamPayMemo（加密通知；无所有者，绝不记录发布者）	0x01B3…4598
金库（自 10 月 24 日起收取的提现费用，以及兑换未用完的输入资产；由路由器固定）	0xB390…30B8

资产	地址	Beta 限额（单笔存款 / 总额）
USDG（6 位小数）	0x5fc5…d168	500 / 25,000
$GLOAM（18 位小数）	0xDcD8…724d	25,000 / 250,000

合约：Tempo 主网 4217

角色	地址
支付金库 ShieldPoolPayments（仅用于支付，不支持管理员提现；规则变更有 3 天时间锁）	0x39e28cde55cab798874746ac52cb4b5cc99a0194
部署区块	45172561
PoseidonT3	0x1a32…9Cb4
所有者（一个钱包；计划改用多签）	0x76b7…D4D8
中继器（由 Gloam 团队运行；提交已证明的交易并支付 Gas，无法转移或重定向资金）	0xb1E9…512e
私密兑换路由器 GloamVaultSwapTempo（Tempo 的稳定币交易所；无所有者、管理员或升级机制）	0xfCa1…F2DC
支付公告板 GloamPayMemo（加密的提示；无所有者，绝不记录发布者）	0x342E…C1c4
国库（自 10 月 24 日起收取的提现手续费，以及兑换未用完的输入资金去向；由路由器固定）	0xB390…30B8

资产（TIP-20，6 位小数）	地址	Beta 限额（单笔存款 / 总额）
USDC.e	0x20c0…8b50	500 / 25,000
pathUSD	0x20c0…0000	500 / 25,000
USDT0	0x20c0…eb73	500 / 25,000
OUSD	0x20c0…74be	500 / 25,000

在两个主网上：存款和私密支付均免费，提现费用为 0.25%。资金池使用可信设置的最终密钥；请从资金池读取验证器（verifier()、shieldVerifier()）。

电路（Groth16，基于 BN254；Circom 2.1.6；Poseidon；深度为 20 的 Merkle 成员证明）：资金池使用 shield、transfer、unshield 和 sealedSwap（已弃用），链下证明使用 solvency、receipt 和 payroll_total。约束数量和密钥集见 contracts/circuits/README.md。

本地运行

pnpm install
pnpm --filter @gloamtrade/sdk build        # build the SDK
cd contracts && forge test            # contracts
pnpm --filter @gloamtrade/sdk test         # SDK core self-tests

从 app/ 运行参考应用（next dev），或打开 gloam.trade/app。

测试网

Robinhood Chain 测试网（46630）和 Tempo Moderato（42431）会继续作为测试网运行：使用同一个应用（在应用中切换网络），并通过水龙头获取测试资金。通过 faucet.testnet.chain.robinhood.com 获取测试网 ETH 和股票代币；通过 Tempo 水龙头（tempo_fundAddress）获取测试稳定币（PathUSD 等）。这些测试网使用单一贡献者的开发密钥运行，仅适用于测试资金。在 Robinhood Chain 测试网上，你还可以将 ETH 存入隐私池，并私密持有和发送股票代币（TSLA、AMZN、PLTR、NFLX、AMD）；这两者都不是主网池资产。为保持向后兼容，SDK 和 MCP 默认使用 Robinhood Chain 测试网（GLOAM_NETWORKS.robinhood 和 .tempo 都是测试网）。Base Sepolia（84532）和 Ethereum Sepolia（11155111）也是测试网（参见 Base 和 Ethereum Sepolia）；与另外两个测试网不同，它们运行主网金库并使用最终密钥，测试稳定币可从 Circle 的水龙头获取（Ethereum Sepolia 上也可从 Paxos 获取）。

合约：Robinhood Chain 测试网 46630

角色	地址
密封金库 ShieldPoolPoseidon（无管理员提款功能，规则变更设有 3 天时间锁）	0x7240…d740
双重证明验证器 DualProofVerifier	0xB077…f7eF
支付备注 GloamPayMemo（首次部署，会为发布者建立索引）	0x689e…5DCE

合约：Tempo Moderato 测试网 42431

角色	地址
密封金库 ShieldPoolPoseidon（无管理员提款功能，规则变更设有 3 天时间锁）	0x841D…d5eb
双重证明验证器 DualProofVerifier	0x82F4…03A2
支付备注 GloamPayMemo（事件中不包含发布者）	0x3ca8…b4E3

更早的测试网池已被取代，相关列表见 contracts/ARCHITECTURE.md；C1 之前的 Robinhood Chain 池 0x4F38… 已清空并退役，切勿使用。

防护原则

• 主网处于 beta 阶段：已启用存款限额，已通过内部审核，计划进行外部审计。请明确说明这一点。
• 密封交易功能仍已退役。私密兑换已在主网上线：务必说明代币和金额是公开的。
• 只提供真正的隐私保护。切勿伪造或模拟私密操作成功。
• 选择性披露，而非不透明。应可验证，而不只是隐藏。
• 品牌风格：带绿色调的单色系（浅色模式为 #2e7d53，深色模式为 #8fd3ad）、Aeonik 字体、浅色和深色模式。风格沉稳、宽松、直白易懂。

---

仓库中不存放私钥。仅使用 DEPLOYER_PK 环境变量进行部署。主网使用可信设置的最终密钥（app/public/circuits/final）；较早测试网的密钥是开发产物。参见 SECURITY.md。

联系方式：[email protected] · @gloamtrade · Telegram t.me/gloamhq。发现安全问题？请参见 SECURITY.md。