首次交易前必做!rs-clob-client 如何设置 USDC 与条件代币的 Token Allowance 授权
首次交易前必做!rs-clob-client 如何设置 USDC 与条件代币的 Token Allowance 授权
在 Polymarket 预测市场首次下单前,很多人都会遇到一个"卡住"的环节:Token Allowance(代币授权)没有设置。rs-clob-client 是 Polymarket 官方推出的 Rust CLOB Client(CLOB 交易 API 客户端),仓库里自带了现成的授权示例,帮你把 USDC(抵押代币)和 Conditional Tokens(条件代币)一次性授权给交易所合约。设置一次即可,之后就能自由交易。
什么是 Token Allowance?为什么必须先设置?
可以把 Allowance 理解为**"钥匙授权"**:在 Polymarket 上,你的 USDC 和条件代币都存放在链上钱包里,交易所合约需要你的明确许可才能代为划转这些代币来执行成交。
- 没授权 → 下单、撮合失败(这是新手最常见的报错来源)
- 已授权 → 交易所合约可以直接帮你存取 USDC / 结算条件代币
💡 简单规则:使用 MetaMask 等 EOA 钱包(直接管私钥的钱包)必须先设置授权;使用 Polymarket 网站的 Proxy / Gnosis Safe 钱包则不需要,因为平台已替你完成。
需要授权哪些合约?
rs-clob-client 在 src/lib.rs 中内置了 Polygon 主网的合约地址配置,完整清单如下:
| 合约 | 作用 |
|---|---|
| CTF Exchange | 普通市场交易 |
| Neg Risk CTF Exchange | Neg-risk 市场交易 |
| Neg Risk Adapter | Neg-risk 市场的代币铸造/拆分 |
每个合约都需要完成两种授权:
- USDC 授权(ERC-20
approve)——用于存款与交易 - 条件代币授权(ERC-1155
setApprovalForAll)——用于结算你交易的结果代币
其中条件代币合约地址为 0x4D97DCd97eC945f40cF65F87097ACe5EA0476045,USDC 为 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174(见 src/lib.rs)。
最快配置方法:三步完成全部授权
仓库提供了两个示例脚本,覆盖"只读检查"和"执行授权"两个场景:
- examples/approvals.rs:执行授权(会发链上交易)
- examples/check_approvals.rs:只读检查当前授权状态(不需要私钥、不花 Gas)
第 1 步:设置私钥环境变量
export POLYMARKET_PRIVATE_KEY="你的私钥"
环境变量名来自 src/lib.rs 中定义的 PRIVATE_KEY_VAR 常量。
第 2 步:先做一次 Dry Run(不发交易)
RUST_LOG=info cargo run --example approvals --all-features -- --dry-run
--dry-run 模式只打印"将要授权哪些合约",适合先确认目标合约地址是否正确。
第 3 步:正式执行授权
RUST_LOG=info cargo run --example approvals --all-features
脚本会自动完成三个阶段(见 examples/approvals.rs):
- checking —— 查询每个合约当前的 USDC allowance 与 CTF 授权状态
- approving —— 对 USDC 执行
approve(spender, U256::MAX)无限授权,对条件代币执行setApprovalForAll(operator, true) - verifying —— 再次链上查询,确认全部生效
控制台会输出类似 USDC approved、CTF approved、all approvals complete 的日志,看到最后一句就说明全部搞定 ✅。
授权后如何验证?不花 Gas 的只读检查
授权完成后(或者怀疑之前的授权失效时),可以直接跑只读检查:
RUST_LOG=info cargo run --example check_approvals --all-features -- <你的钱包地址>
例如:
cargo run --example check_approvals --all-features -- 0x1234...abcd
该示例会依次查询 CTF Exchange、Neg Risk CTF Exchange、Neg Risk Adapter 三个合约的 USDC allowance 是否为 0 以及 CTF 是否已 setApprovalForAll,全部通过则说明你的钱包已具备完整交易条件(实现见 examples/check_approvals.rs)。
授权完成后:开始你的首次交易
授权只是前置动作,接下来用认证客户端连接 CLOB 即可下单:
let signer = LocalSigner::from_str(&private_key)?.with_chain_id(Some(POLYGON));
let client = Client::new("https://clob.polymarket.com", Config::default())?
.authentication_builder(&signer)
.authenticate()
.await?;
完整可运行的代码参见 examples/clob/authenticated.rs,订单构造逻辑在 src/clob/order_builder.rs。
常见问题(FAQ)
Q1:授权需要花多少 Gas? 每个合约两笔交易(USDC approve + CTF setApprovalForAll),最多 3 个合约,Polygon 上单次交易 Gas 通常不到 $0.01,总成本可以忽略。
Q2:需要重复授权吗?
不需要。approve 设置为 U256::MAX(无限额度)且 ERC-1155 是全量授权,每个钱包只需设置一次,之后长期有效。
Q3:我用 Polymarket 网页版钱包,需要授权吗? 不需要。Proxy / Gnosis Safe 钱包由平台托管授权流程,直接交易即可;只有 EOA(MetaMask、硬件钱包、私钥直连)用户才需要本文的步骤。
Q4:想记录日志排查问题?
所有示例都支持 LOG_FILE 环境变量写日志文件,例如:
LOG_FILE=approvals.log RUST_LOG=info cargo run --example approvals --all-features
总结
| 步骤 | 命令 / 文件 | 是否花 Gas |
|---|---|---|
| 设置私钥 | export POLYMARKET_PRIVATE_KEY=... |
❌ |
| 预演检查 | cargo run --example approvals -- --dry-run |
❌ |
| 执行授权 | examples/approvals.rs | ✅ 一次性 |
| 只读验证 | examples/check_approvals.rs | ❌ |
| 认证交易 | examples/clob/authenticated.rs | ❌(下单才有) |
记住这个口诀:EOA 用户先授权、Dry Run 先预览、一个钱包只需一次。设置完成后,rs-clob-client 就能顺畅地帮你完成在 Polymarket 上的首次交易了。
