Repo is ready for the Polymarket V2 cutover (2026-04-28 11:00 UTC)

[smypmsa]

Polymarket flips from V1 (USDC.e) to V2 (pUSD) tomorrow at ~11:00 UTC per the official V2 migration guide. This repo is ready.

Core backend

• V1/V2 paths gated by a single source of truth: core/feature_flags.v2_enabled()
• py-clob-client-v2==1.0.0 wired in backend/core/trading/clob_client.py (options-object constructor, no tickSizeTtlMs, V2 order args without feeRateBps / nonce / taker)
• V2 Exchange addresses registered in backend/core/wallet/contracts.py:
  • Standard 0xE111180000d2663C0091e4f400237545B87B996B
  • NegRisk 0xe2222d279d744050d28e00520010520000310F59
• pUSD collateral + Collateral Onramp/Offramp wired through wallet/manager.py, trading/executor.py, positions/manager.py
• Dynamic per-market fees acknowledged in backend/core/fees.py (display-only V1 estimate; V2 computed server-side)
• No POLY_BUILDER_* HMAC remnants

Cutover mechanics

• PR feat(v2): flip POLYMARKET_V2_ENABLED default to true (Phase 2 — DO NOT MERGE BEFORE 2026-04-28 11:00 UTC) #49 (feat/v2-flip-default) flips POLYMARKET_V2_ENABLED default from unset → true. Held intentionally until 11:00 UTC because V2 books are empty pre-cutover.
• Operator post-flip: re-run WalletManager.set_approvals() once (approvals are mode-gated). USDC.e holders wrap to pUSD via experiments/trading/02_wrap_to_pusd.py.
• V1 retirement (chore(v2): retire V1 paths post-cutover #37) queued for ~2026-05-05 after a 1-week soak. Permanent legacy reference: git tag v1-final at 94e89ce.

Experiments / scripts

• experiments/trading/03_buy_position.py and 02_wrap_to_pusd.py are V2-aware.
• 01_setup_wallet.py, 04_transfer_tokens.py, and experiments/onchain-otc/* remain V1 / USDC.e-only and are not gated — use them only as historical references post-cutover.

Will post a follow-up after the flag flip with smoke-test results from the post-cutover validation runbook.

[smypmsa]

Update — experiment scripts are now V2-aware too (commit 0208a79)

• experiments/trading/01_setup_wallet.py: docstring + first-run prompt now name the active collateral (USDC.e under V1, pUSD under V2). Approval targets were already gated via _v2_enabled().
• experiments/trading/04_transfer_tokens.py: token list now includes pUSD when V2 is enabled, so transfers actually move V2 collateral instead of just displaying it.

Remaining V1-only scripts that are intentionally not gated and should be treated as historical references after cutover: experiments/onchain-otc/* (hardcoded V1 EIP-712 domain + V1 exchange addresses) and experiments/trading/02_swap_to_usdc_e.py (legacy stepping-stone, already documented as such).

[smypmsa]

Update: V1 retired post-cutover — PR #51 squash-merged into main as c4491d0 on 2026-04-28 14:39 UTC. Polymarket V1 paths, the POLYMARKET_V2_ENABLED flag, and the py-clob-client dep are all gone. The repo runs V2-only against clob.polymarket.com with pUSD collateral; archaeology lives at the v1-final git tag.