Mwongozo wa Uhamiaji wa Polymarket pUSD: USDC.e hadi pUSD (Aprili 2026)

Sura ya 36 kati ya 36

Toleo Fupi

Mnamo Aprili 28, 2026, Polymarket ilihamisha dhamana yake ya malipo kwenye Polygon kutoka USDC.e (tokeni ya USDC iliyounganishwa kutoka chain nyingine, mkataba 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) kwenda pUSD, sarafu thabiti (stablecoin) iliyotolewa na Polymarket inayoweza kukombolewa kwa uwiano wa 1:1 kwa native USDC. Wafanyabiashara wa programu ya wavuti hawakufanya chochote - salio na nafasi zilibadilishwa kiotomatiki katika block ya snapshot. Waendeshaji wa API na bot lazima wasasishe: anwani ya kipengee cha dhamana ndani ya kila saini ya oda ya CLOB ilibadilika, oda za zamani zilizosainiwa dhidi ya USDC.e zilifutwa, na py-clob-client 0.40 au mpya zaidi inahitajika. Mwongozo huu unapitia msimbo halisi, mkataba, na mabadiliko ya idhini yanayohitajika ili kuendelea kuendesha bot wakati wa na baada ya mabadiliko haya.

Sehemu ya 1: sarafu thabiti (stablecoin) Tatu, Polygon Moja

Kabla ya uhamiaji, stablecoin tatu za USD zilikuwepo katika mzunguko wa Polymarket kwenye Polygon. Kujua tofauti ni hatua ya kwanza kuelewa kwa nini Polymarket ilibadilisha eneo la shughuli.

Hapo awali Polymarket ilichagua USDC.e kwa sababu ilikuwa toleo linalotumika zaidi la USDC kwenye Polygon wakati wa kuzinduliwa mwaka 2020. Baadaye Circle ilitoa USDC asilia moja kwa moja kwenye Polygon na ikaashiria kuwa toleo lililohamishwa lingekomeshwa hatimaye. Kuendelea kusawazisha kila soko kwa USDC.e kuliweka Polymarket kwenye hatari ya muda mrefu ya kuondolewa ghafla kwa daraja. Kuhamia kwenye stablecoin inayodhibitiwa na Polymarket kunatatua hilo na kufungua vipengele vya bidhaa vya baadaye (kwa mfano, margin ya perps, amana za vault, risiti za cross-chain) vinavyoshiriki kitengo kilekile cha hesabu.

Sehemu ya 2: pUSD Ni Nini (na Sio Nini)

pUSD ni token ya kawaida ya ERC-20 kwenye Polygon (chain id 137) yenye desimali 6, usahihi uleule kama USDC. Inaweza kutengenezwa tu na mkataba wa hazina wa Polymarket na inaweza kukombolewa kwa uwiano wa 1:1 kwa USDC asilia wakati wowote, bila ada yoyote kwenye ubadilishaji (ada ya gas ya mtandao bado inatumika). Akiba inayoiunga mkono pUSD inashikiliwa katika akaunti zilizotengwa na huripotiwa kila mwezi kwa uthibitisho wa mhusika wa tatu.

pUSD sio sarafu thabiti (stablecoin) ya kiualgorithimu, haijawekewa dhamana kupita kiasi kwa crypto, na haizalishi faida. Ukiishikilia pUSD nje ya Polymarket, unapaswa kuiona kama deni la kulipwa la USDC asilia lililotolewa na Polymarket - linafaa ndani ya jukwaa, linaweza kukombolewa ukihitaji, lakini halina faida ya kulishikilia kwa muda mrefu kwenye pochi ya nje.

Sehemu ya 3: Wafanyabiashara wa Programu-tovuti Walichoona

Ukiuza kupitia polymarket.com pekee, uhamiaji haukuonekana. Katika blok ya snapshot tarehe 28 Aprili 2026:

• Kila salio la USDC.e lililoshikiliwa kwenye pochi wakala ya Polymarket lilibadilishwa kiotomatiki kuwa pUSD kwa uwiano wa 1:1.
• Funguzi za nafasi zilihifadhi thamani ileile ya dola, odds za matokeo zilezile, na muda uleule wa kuisha. Vitambulisho vya tokeni vya masharti havikubadilika.
• Oda zilizokuwa zimesimama zilizoainishwa kwa USDC.e zilifutwa kwenye snapshot. Oda mpya baada ya uhamiaji zinaingia saini dhidi ya pUSD kiotomatiki.
• Utoaji kwenda kwenye pochi za nje ulibadilika kutoka kutuma USDC.e hadi kutuma USDC asilia (au, ukihitaji, pUSD ghafi - watumiaji wengi hawahitaji kamwe).

Hakukuwa na haja ya sahihi, miamala, au mabadiliko ya mipangilio. Oda za bei-kikomo zilizokuwa zimesimama ambazo zilikuwa muhimu kwako zinapaswa kuwekwa tena kwa mikono baada ya uhamiaji; ufutaji huo ulikuwa tukio la mara moja.

Sehemu ya 4: Waendeshaji wa API na Bot - Mabadiliko Muhimu

Hii ndiyo sehemu ambayo itavunja bot kama hautachukua hatua.

Pandisha toleo la py-clob-client

Polymarket ilichapisha py-clob-client 0.40.0 wiki mbili kabla ya mabadiliko ya mfumo ikiwa na msaada kamili wa pUSD. Tawi la 0.34.x liliastaafishwa siku iliyofuata baada ya uhamiaji.

# Pandisha hadi toleo linalofahamu pUSD
pip install --upgrade "py-clob-client>=0.40.0"

# Hakiki anwani ya dhamana iliyounganishwa
python -c "from py_clob_client.constants import POLYGON; \
print('Anwani ya pUSD:', POLYGON.get('collateral'))"

SDK mpya huvuta anwani ya dhamana kutoka kwenye usanidi wa chain wakati wa kuwashwa, hivyo huhitaji kuweka kitu chochote kwa kuweka moja kwa moja kwenye msimbo. Ikiwa uliforka au kuunganisha toleo la zamani, hatua salama zaidi ni kufuta lockfile, kusakinisha upya kwa kutumia moduli ya hivi karibuni ya constants, na kuendesha tena seti yako ya majaribio.

Fanya tena uidhinishaji wa allowances

Pochi wako wakala wa Polymarket unahitaji ERC-20 allowance kutoka akaunti yako ya biashara - mkataba wa CTF Exchange kwa tokeni ya pUSD. Allowance ya zamani ya USDC.e bado ipo kwenye chain lakini haina matumizi kabisa: CLOB haitaitumia. Bila allowance mpya ya pUSD, kila oda hurudisha "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 for Magic-link accounts
)
client.set_api_creds(client.create_or_derive_api_creds())

# Mara moja tu: idhinisha pUSD kwa mkataba wa CTF Exchange
# (Msaidizi umeongezwa kwenye py-clob-client 0.40)
client.update_balance_allowance(asset_type="COLLATERAL")

Boresha upya vitambulisho vya API

Vifunguo vilivyopo vya API vinaendelea kufanya kazi, lakini ikiwa ulitengeneza vitambulisho kabla ya Aprili 1 unapaswa kuvibadilisha kama tahadhari: sahihi ya ECDSA ya L1 sasa inafungwa kwenye domain inayojumuisha anwani mpya ya dhamana. Njia rahisi zaidi:

creds = client.create_or_derive_api_creds()  # re-derive ya idempotent
client.set_api_creds(creds)

# Hifadhi kwenye .env yako
print(creds.api_key, creds.api_secret, creds.api_passphrase)

Sehemu ya 5: Kuthibitisha Bot Yako Baada ya Uhamiaji

Endesha jaribio hili dogo la haraka kabla ya kuruhusu mantiki yoyote ya ukubwa ifanye kazi na fedha halisi:

# 1. Thibitisha salio la pUSD kwenye pochi wakala
from py_clob_client.client import ClobClient
client = ClobClient(...)  # kama ilivyo hapo juu
balance = client.get_balance_allowance(params={"asset_type": "COLLATERAL"})
print("Salio la pUSD (raw):", balance["balance"])
print("Kikomo cha ruhusa kwa soko la ubashiri:", balance["allowance"])

# 2. Weka oda ya bei-kikomo ya $1 mbali sana na bei ya sasa
from py_clob_client.clob_types import OrderArgs
order = client.create_order(OrderArgs(
    token_id=test_token_id,
    price=0.05,        # hakuna karibu na soko
    size=20,           # notional ya $1 kwa $0.05
    side="BUY",
))
resp = client.post_order(order)
print(resp)

# 3. Futa na thibitisha
client.cancel(order_id=resp["orderID"])

Kama simu zote tatu zitafaulu, muunganisho wako uko sawa: SDK ilisaini dhidi ya pUSD, ruhusa imetambuliwa, na daftari la oda ni thabiti. Ongeza ukubwa tena taratibu.

Sehemu ya 6: Makosa ya Kawaida na Marekebisho

Sehemu ya 7: Tokeni za Masharti, Vitambulisho vya Oda, na Mambo Mengine Ambayo Hayakubadilika

Ili kuweka upeo wa urekebishaji kuwa wa kweli, hapa kuna orodha ya vitambulisho ambavyo ni thabiti katika mabadiliko haya:

• Mkataba wa Conditional Token (CTF): anwani ile ile. Nafasi zako za YES / NO za ERC-1155 hazijaguswa.
• condition_id na question_id: hutokana kwa njia ya kubainika kutoka kwa vigezo vya soko; hazijaathiriwa na kubadilishwa kwa dhamana (collateral).
• token_id (matokeo): hutokana na condition_id + faharasa ya matokeo; haijabadilika.
• Anwani ya pochi wakala ya Polymarket: anwani ile ile; msimbo ule ule wa mtindo wa Gnosis Safe.
• Funguo ya API, siri ya API, kaulisiri ya API: bado ni halali (tunapendekeza kuzungusha; si lazima).
• Skima za WebSocket: zile zile; uga mpya wa asset unasoma "pUSD" badala ya "USDC.e" katika matukio ya fill.
• API za Gamma na Data: bila uthibitishaji, hazijabadilika. Hazikuwahi kurejelea tokeni ya collateral moja kwa moja.

Sehemu ya 8: Athari za Kodi na Uwekaji Hesabu

Kwa mamlaka nyingi, ubadilishaji otomatiki wa USDC.e kuwa pUSD ni ubadilishaji wa aina moja wa sarafu thabiti (stablecoin) zilizounganishwa na USD kwa 1:1 na hausababishi tukio la kodi. Gharama yako ya msingi na muda wa umiliki vinaendelea kama vilivyo.

Hata hivyo, kuna mambo mawili ya uwekaji hesabu yanayostahili kuzingatiwa:

1. Sasisha skimu yako ya leja. Kila zana ya kodi, leja ya SQLite, au uhamishaji wa mhasibu unaochuja miamala ya Polygon kwa mkataba wa USDC.e utaukosa kimya kimya kila muamala wa baada ya uhamiaji. Ongeza anwani ya mkataba wa pUSD kama jina lingine.
2. Andika ubadilishaji wa snapshot. Ingawa si wa kodi katika mifumo mingi, rekodi ubadilishaji huo kwa wazi katika kumbukumbu zako: kiasi, block, muda, na dokezo kwamba ni uhamiaji wa stablecoin wa 1:1. Ikiwa mamlaka yako itauliza baadaye, utataka njia safi ya ukaguzi.

Wafanyabiashara wa Israel wanapaswa kushauriana na Mwongozo wa Kodi kwa taarifa mahususi za ITA; uhamiaji wenyewe haubadilishi matibabu ya kawaida lakini mabadiliko ya anwani ya mkataba ni muhimu kwa zana za utoaji taarifa otomatiki.

Sehemu ya 9: Vidokezo vya kitaalamu kutoka kwa waendeshaji waliopitia mabadiliko

What's Next?

• Polymarket API Guide - mwongozo kamili wa API, uliosasishwa kwa pUSD
• Deposit Guide - kuweka USDC na kupokea pUSD ndani ya programu
• Withdraw Guide - kutoa pUSD kama USDC asili kwenda pochi ya nje
• Tools & Resources - dashibodi za wahusika wengine sasa zimesasishwa kwa pUSD
• Glossary - fasili kwa lugha rahisi ya Kiingereza kwa kila istilahi iliyotumiwa hapa