Gabay sa Paglipat ng Polymarket pUSD: USDC.e patungong pUSD (Abril 2026)

Kabanata 36 ng 36

Maikling Bersyon

Noong Abril 28, 2026, inilipat ng Polymarket ang kolateral (collateral) para sa settlement nito sa Polygon mula sa USDC.e (ang naka-bridge na USDC token, contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) tungo sa pUSD, isang stablecoin (stablecoin) na inilabas ng Polymarket na maaring tubusin nang 1:1 para sa native USDC. Walang kinailangang gawin ang mga trader sa web app - awtomatikong na-convert ang mga balanse at posisyon sa snapshot block. Kailangang mag-update ang mga operator ng API at bot: nagbago ang asset address ng collateral sa loob ng bawat CLOB order signature, nakansela ang mga lumang order na nilagdaan laban sa USDC.e, at kinakailangan ang py-clob-client 0.40 o mas bago. Ipinapakita ng gabay na ito ang eksaktong code, contract, at mga pagbabagong kailangan sa approval para mapatakbo ang bot sa panahon at pagkatapos ng cutover.

Bahagi 1: Tatlong stablecoin (stablecoin), Isang Polygon

Bago ang paglipat, may tatlong USD stablecoin sa orbit ng Polymarket sa Polygon. Ang pag-alam sa pagkakaiba ng mga ito ang unang hakbang sa pag-unawa kung bakit lumipat ng venue ang Polymarket.

Sa simula, pinili ng Polymarket ang USDC.e dahil ito ang nangingibabaw na bersyon ng USDC sa Polygon noong ilunsad noong 2020. Kalaunan, naglabas ang Circle ng native na USDC nang direkta sa Polygon at nagpahiwatig ng kalaunang pag-phase out ng bridged na bersyon. Ang patuloy na pag-settle ng bawat market sa USDC.e ay naglantad sa Polymarket sa long-tail na panganib ng biglaang pagwawakas ng bridge. Ang paglipat sa stablecoin na kontrolado ng Polymarket ay lumulutas doon at nagbubukas ng mga hinaharap na feature ng produkto (hal., perps margin, mga deposit sa vault, cross-chain receipt) na gumagamit ng parehong yunit ng account.

Bahagi 2: Ano ang pUSD (at Ano ang Hindi Ito)

Ang pUSD ay isang karaniwang ERC-20 token sa Polygon (chain id 137) na may 6 na decimal, kapareho ng precision ng USDC. Maaari lamang itong i-mint ng Polymarket Treasury contract at puwedeng i-redeem nang 1:1 para sa native USDC anumang oras, nang walang fee sa conversion (mag-a-apply pa rin ang network gas). Ang reserve na sumusuporta sa pUSD ay iniingatan sa mga hiwalay na account at nirereport buwan-buwan na may third-party attestation.

Ang pUSD ay hindi algorithmic stablecoin (stablecoin), hindi ito over-collateralized gamit ang crypto, at hindi ito yield-bearing. Kung may hawak kang pUSD sa labas ng Polymarket, dapat mo itong ituring bilang IOU na inisyu ng Polymarket para sa native USDC - kapaki-pakinabang sa loob ng platform, puwedeng i-redeem kapag hinihingi, pero walang benepisyo ang paghawak nito nang pangmatagalan sa isang external wallet.

Bahagi 3: Ang Nakita ng mga Trader sa Web App

Kung sa polymarket.com ka lang nagte-trade, hindi napansin ang migration. Sa snapshot block noong Abril 28, 2026:

• Ang bawat USDC.e balance na hawak sa isang Polymarket proxy wallet ay awtomatikong kinonbert sa pUSD sa 1:1.
• Nanatili ang parehong dollar value, parehong odds ng kinalabasan, at parehong expiry ng mga bukas na posisyon. Hindi nagbago ang mga conditional token ID.
• Ang mga resting order na naka-denominate sa USDC.e ay kinansela sa snapshot. Ang mga bagong order pagkatapos ng migration ay awtomatikong pumipirma gamit ang pUSD.
• Ang mga withdrawal papunta sa mga external wallet ay nagpalit mula sa pagpapadala ng USDC.e patungo sa pagpapadala ng native USDC (o, kapag hiniling, raw pUSD - karamihan sa mga user ay hindi na kailangang gawin ito).

Walang kinakailangang signature, transaction, o pagbabago sa settings. Ang mga resting limit na order na mahalaga sa iyo ay dapat muling ilagay nang manu-mano pagkatapos ng migration; ang pagkansela ay isang beses lang na pangyayari.

Bahagi 4: Mga Operator ng API at Bot - Mga Kritikal na Pagbabago

Ito ang bahaging sisira sa isang bot kung hindi ka kikilos.

I-upgrade ang py-clob-client

Inilabas ng Polymarket ang py-clob-client 0.40.0 dalawang linggo bago ang cutover na may buong suporta sa pUSD. Ang linya ng 0.34.x ay itinigil kinabukasan pagkatapos ng migration.

# I-upgrade sa isang release na aware sa pUSD
pip install --upgrade "py-clob-client>=0.40.0"

# I-verify ang naka-wire na collateral asset
python -c "from py_clob_client.constants import POLYGON; \
print('pUSD address:', POLYGON.get('collateral'))"

Kinukuha ng bagong SDK ang address ng collateral mula sa configuration ng chain sa pagsisimula, kaya hindi mo kailangang mag-hard-code ng anuman. Kung nag-fork ka o nag-pin ng mas lumang bersyon, ang pinakaligtas na hakbang ay burahin ang lockfile, mag-install muli gamit ang pinakabagong constants module, at patakbuhin muli ang iyong test suite.

Muling i-approve ang mga allowance

Kailangan ng iyong Polymarket proxy wallet ng ERC-20 allowance mula sa iyong trading account → kontrata ng CTF Exchange para sa token na pUSD. Ang lumang allowance para sa USDC.e ay nandoon pa rin sa chain pero wala nang silbi: hindi ito gagamitin ng CLOB. Kung walang bagong pUSD allowance, magbabalik ang bawat order ng "INSUFFICIENT_ALLOWANCE".

from py_clob_client.client import ClobClient

client = ClobClient(
    host="https://clob.polymarket.com",
    chain_id=137,
    key=os.environ["POLY_PRIVATE_KEY"],
    funder=os.environ["POLY_FUNDER"],
    signature_type=1,  # POLY_PROXY para sa Magic-link accounts
)
client.set_api_creds(client.create_or_derive_api_creds())

# Isang beses lang: i-approve ang pUSD para sa kontrata ng CTF Exchange
# (Helper na idinagdag sa py-clob-client 0.40)
client.update_balance_allowance(asset_type="COLLATERAL")

I-refresh ang mga kredensyal ng API

Patuloy na gagana ang mga umiiral na API key, pero kung nag-derive ka ng mga kredensyal bago ang Abril 1, dapat mo silang i-rotate bilang pag-iingat: ang L1 ECDSA signature ay naka-bind na ngayon sa isang domain na kasama ang bagong collateral address. Ang pinakasimpleng paraan:

creds = client.create_or_derive_api_creds()  # idempotent na muling pag-derive
client.set_api_creds(creds)

# I-save sa iyong .env
print(creds.api_key, creds.api_secret, creds.api_passphrase)

Bahagi 5: Pagberipika sa Iyong Bot Pagkatapos ng Migrasyon

Patakbuhin ang minimal na smoke test na ito bago pahintulutang gumana ang anumang sizing logic gamit ang totoong pera:

# 1. Kumpirmahin ang pUSD balance sa proxy wallet
from py_clob_client.client import ClobClient
client = ClobClient(...)  # gaya sa itaas
balance = client.get_balance_allowance(params={"asset_type": "COLLATERAL"})
print("pUSD balance (raw):", balance["balance"])
print("Allowance to exchange:", balance["allowance"])

# 2. Maglagay ng limit na order na $1 na malayo sa touch
from py_clob_client.clob_types import OrderArgs
order = client.create_order(OrderArgs(
    token_id=test_token_id,
    price=0.05,        # malayo sa market
    size=20,           # $1 na notional sa $0.05
    side="BUY",
))
resp = client.post_order(order)
print(resp)

# 3. Kanselahin at kumpirmahin
client.cancel(order_id=resp["orderID"])

Kung matagumpay ang lahat ng tatlong tawag, maayos ang iyong koneksyon: pumirma ang SDK laban sa pUSD, kinikilala ang allowance, at konsistent ang order ledger. Unti-unting taasan muli ang sukat.

Bahagi 6: Mga Karaniwang Pagkakamali at mga Ayos

Bahagi 7: Mga Conditional Token, Order ID, at Iba Pang Mga Bagay na Hindi Nagbago

Para mapanatiling tapat ang saklaw ng refactor, narito ang listahan ng mga identifier na matatag sa buong migration:

• Conditional Token contract (CTF): kaparehong address. Hindi nagalaw ang iyong mga YES / NO na posisyon sa ERC-1155.
• condition_id at question_id: deterministiko mula sa mga parameter ng market; hindi naapektuhan ng pagpapalit ng kolateral (collateral).
• token_id (kinalabasan): hinango mula sa condition_id + index ng kinalabasan; walang pagbabago.
• Polymarket proxy wallet address: parehong address; parehong code na gaya ng Gnosis Safe.
• API key, API secret, API passphrase: valid pa rin (inirerekomendang i-rotate; hindi kailangan).
• WebSocket schemas: kapareho; ang bagong asset field ay nagbabasa ng "pUSD" sa halip na "USDC.e" sa mga fill event.
• Gamma at Data APIs: hindi nangangailangan ng authentication, walang pagbabago. Hindi nila kailanman direktang tinukoy ang collateral token.

Bahagi 8: Mga Implikasyon sa Buwis at Bookkeeping

Para sa karamihan ng mga hurisdiksiyon, ang awtomatikong pag-convert ng USDC.e sa pUSD ay isang like-kind swap ng mga stablecoin (stablecoin) na naka-peg sa USD sa 1:1 at hindi lumilikha ng anumang taxable event. Ang iyong cost basis at holding period ay magpapatuloy.

Gayunman, may dalawang usapin sa bookkeeping na dapat bigyang-pansin:

1. I-update ang iyong ledger schema. Anumang tax tool, SQLite ledger, o export para sa accountant na nagfi-filter ng mga transaksyon sa Polygon ayon sa contract ng USDC.e ay tahimik na makakaligtaan ang bawat transaksyon pagkatapos ng migration. Idagdag ang address ng contract ng pUSD bilang alias.
2. I-annotate ang snapshot conversion. Kahit na hindi ito taxable sa karamihan ng mga regime, itala nang malinaw ang conversion sa iyong mga record: halaga, block, timestamp, at isang tala na ito ay 1:1 stablecoin migration. Kung tanungin ito ng iyong hurisdiksiyon sa hinaharap, gusto mong may malinis na audit trail.

Dapat kumonsulta ang mga trader sa Israel sa Tax Guide para sa report na partikular sa ITA; hindi binabago ng migration mismo ang karaniwang pagtrato ngunit mahalaga ang pagbabago ng address ng contract para sa mga automated na tool sa pag-uulat.

Bahagi 9: Mga Pro Tip Mula sa mga Operator na Nakaabot sa Switch

Ano ang Susunod?

• Patnubay sa Polymarket API - ang buong patnubay sa API, na inupdate para sa pUSD
• Patnubay sa Pagdeposito - pagdedeposito ng USDC at pagtanggap ng pUSD sa loob ng app
• Patnubay sa Pag-withdraw - pagwi-withdraw ng pUSD bilang native USDC patungo sa panlabas na wallet
• Mga Kasangkapan at Mga Mapagkukunan - mga third-party dashboard na inupdate na ngayon para sa pUSD
• Glossary - mga depinisyon sa payak na Ingles para sa bawat terminong ginamit dito