首次交易前必做!rs-clob-client 如何设置 USDC 与条件代币的 Token Allowance 授权

原创2026-11-01 12:05:391,333 阅读

首次交易前必做!rs-clob-client 如何设置 USDC 与条件代币的 Token Allowance 授权

在 Polymarket 预测市场首次下单前,很多人都会遇到一个"卡住"的环节:Token Allowance(代币授权)没有设置。rs-clob-client 是 Polymarket 官方推出的 Rust CLOB Client(CLOB 交易 API 客户端),仓库里自带了现成的授权示例,帮你把 USDC(抵押代币)和 Conditional Tokens(条件代币)一次性授权给交易所合约。设置一次即可,之后就能自由交易。

Polymarket rs-clob-client Rust 客户端 Token Allowance 授权指南

什么是 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 市场的代币铸造/拆分

每个合约都需要完成两种授权:

  1. USDC 授权(ERC-20 approve)——用于存款与交易
  2. 条件代币授权(ERC-1155 setApprovalForAll)——用于结算你交易的结果代币

其中条件代币合约地址为 0x4D97DCd97eC945f40cF65F87097ACe5EA0476045,USDC 为 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174(见 src/lib.rs)。

最快配置方法:三步完成全部授权

仓库提供了两个示例脚本,覆盖"只读检查"和"执行授权"两个场景:

第 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):

  1. checking —— 查询每个合约当前的 USDC allowance 与 CTF 授权状态
  2. approving —— 对 USDC 执行 approve(spender, U256::MAX) 无限授权,对条件代币执行 setApprovalForAll(operator, true)
  3. 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 上的首次交易了。

登录后查看全文
rs-clob-client