Polymarket pUSD Geçiş Rehberi: USDC.e'den pUSD'ye (Nisan 2026)

36 bölümün 36'sı

Kısa Versiyon

28 Nisan 2026 tarihinde, Polymarket Polygon üzerindeki uzlaşma teminatını USDC.e’den (köprülenmiş USDC tokeni, sözleşme 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) pUSD’ye taşıdı; pUSD, 1:1 oranında yerel USDC ile geri alınabilen, Polymarket tarafından ihraç edilen bir stabil kripto para. Web uygulamasıyla işlem yapanlar hiçbir şey yapmadı - bakiyeler ve pozisyonlar anlık görüntü bloğunda otomatik olarak dönüştürüldü. API ve bot operatörlerinin güncelleme yapması gerekir: her CLOB emir imzasındaki teminat varlığı adresi değişti, USDC.e’ye karşı imzalanmış eski emirler iptal edildi ve py-clob-client 0.40 veya daha yenisi gerekiyor. Bu rehber, bir botun geçiş sırasında ve sonrasında çalışmaya devam etmesi için gereken tam kod, sözleşme ve onay değişikliklerini adım adım anlatır.

Bölüm 1: Üç stabil kripto varlık (stablecoin), Bir Polygon

Göçten önce, Polygon üzerinde Polymarket'in yörüngesinde üç ABD doları stablecoin'i vardı. Aralarındaki farkı bilmek, Polymarket'in neden platform değiştirdiğini anlamanın ilk adımıdır.

Polymarket başlangıçta USDC.e'yi seçti çünkü 2020'deki lansmanda Polygon üzerindeki baskın USDC varyantı buydu. Circle daha sonra native USDC'yi doğrudan Polygon üzerinde ihraç etti ve köprülenmiş varyantın zamanla kullanım dışı kalacağını işaret etti. Her piyasayı USDC.e ile uzlaştırmaya devam etmek, Polymarket'i köprünün aniden kapatılmasına ilişkin uzun kuyruk riskine maruz bırakıyordu. Polymarket tarafından kontrol edilen bir stablecoin'e geçiş, bunu çözer ve aynı hesap birimini paylaşan gelecekteki ürün özelliklerinin (örneğin sürekli vadeli işlem sözleşmeleri teminatı, kasa yatırımları, zincirler arası makbuzlar) önünü açar.

Bölüm 2: pUSD Nedir (ve Nedir Değildir)

pUSD, Polygon üzerindeki (chain id 137) 6 ondalıklı standart bir ERC-20 tokenıdır; USDC ile aynı hassasiyete sahiptir. Yalnızca Polymarket Treasury sözleşmesi tarafından basılabilir ve herhangi bir zamanda ağ ücreti dönüştürme işlemine yine de uygulanmak üzere, native USDC'ye 1:1 oranında geri çevrilebilir. pUSD'yi destekleyen rezerv ayrılmış hesaplarda tutulur ve üçüncü taraf bir tasdik ile aylık olarak raporlanır.

pUSD algoritmik bir stabil kripto para değildir, kripto ile aşırı teminatlandırılmış değildir ve getiri sağlamaz. pUSD'yi Polymarket dışında tutuyorsanız, onu native USDC için Polymarket tarafından çıkarılmış bir borç senedi olarak düşünmelisiniz - platform içinde kullanışlıdır, talep üzerine geri çevrilebilir, ancak harici bir cüzdanda uzun vadeli tutmanın hiçbir avantajı yoktur.

Bölüm 3: Web Uygulaması Tüccarları Ne Gördü

Yalnızca polymarket.com üzerinden işlem yapıyorsanız, geçiş görünmezdi. 28 Nisan 2026 tarihindeki anlık görüntü bloğunda:

• Polymarket proxy cüzdanında tutulan her USDC.e bakiyesi, 1:1 oranında atomik olarak pUSD'ye dönüştürüldü.
• Açık pozisyonlar aynı dolar değerini, aynı sonuç ihtimallerini ve aynı vade bitişini korudu. Koşullu token kimlikleri değişmedi.
• USDC.e cinsinden bekleyen emirler anlık görüntüde iptal edildi. Geçiş sonrası yeni emirler otomatik olarak pUSD üzerinden imzalanır.
• Dış cüzdanlara yapılan çekimler USDC.e göndermekten yerel USDC göndermeye geçti (veya talep üzerine ham pUSD - çoğu kullanıcının buna hiç ihtiyacı olmaz).

Herhangi bir imza, işlem veya ayar değişikliği gerekmedi. Sizin için önemli olan bekleyen limit emirler, geçişten sonra manuel olarak yeniden girilmelidir; iptal tek seferlik bir olaydı.

Bölüm 4: API ve Bot Operatörleri - Kritik Değişiklikler

Bu, harekete geçmezseniz bir botu bozacak kısımdır.

py-clob-client'i yükseltin

Polymarket, kesintiden iki hafta önce tam pUSD desteğiyle py-clob-client 0.40.0 sürümünü yayınladı. 0.34.x serisi, taşınmanın ertesi günü kullanımdan kaldırıldı.

# pUSD'yi tanıyan bir sürüme yükseltin
pip install --upgrade "py-clob-client>=0.40.0"

# Bağlı teminat varlığını doğrulayın
python -c "from py_clob_client.constants import POLYGON; \
print('pUSD address:', POLYGON.get('collateral'))"

Yeni SDK, teminat adresini başlangıçta zincir yapılandırmasından çeker, bu yüzden herhangi bir şeyi sabit kodlamanız gerekmez. Daha eski bir sürümü çatalladıysanız veya sabitlediyseniz, en güvenli yol kilit dosyasını silmek, en son constants modülüyle yeniden kurmak ve test paketini tekrar çalıştırmaktır.

İzinleri yeniden onaylayın

Polymarket proxy cüzdanınızın ticaret hesabınızdan → CTF Exchange sözleşmesine pUSD tokenı için bir ERC-20 iznine ihtiyacı vardır. USDC.e için eski izin hâlâ zincir üzerinde duruyor ancak tamamen işe yaramaz: CLOB bunu kullanmayacaktır. Yeni bir pUSD izni olmadan, her emir "INSUFFICIENT_ALLOWANCE" döndürür.

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,  # Magic-link hesapları için POLY_PROXY
)
client.set_api_creds(client.create_or_derive_api_creds())

# Bir defaya mahsus: CTF Exchange sözleşmesi için pUSD onaylayın
# (py-clob-client 0.40'da eklenen yardımcı)
client.update_balance_allowance(asset_type="COLLATERAL")

API kimlik bilgilerini yenileyin

Mevcut API anahtarları çalışmaya devam eder, ancak kimlik bilgilerini 1 Nisan'dan önce türettiyseniz, önlem olarak onları döndürmelisiniz: L1 ECDSA imzası artık yeni teminat adresini içeren bir domaine bağlanır. En basit yol:

creds = client.create_or_derive_api_creds()  # idempotent yeniden türetme
client.set_api_creds(creds)

# .env dosyanıza kaydedin
print(creds.api_key, creds.api_secret, creds.api_passphrase)

Bölüm 5: Botunuzu Göç Sonrası Doğrulama

Gerçek parayla herhangi bir boyutlandırma mantığını devreye almadan önce bu minimal duman testini çalıştırın:

# 1. Proxy cüzdandaki pUSD bakiyesini doğrulayın
from py_clob_client.client import ClobClient
client = ClobClient(...)  # yukarıdaki gibi
balance = client.get_balance_allowance(params={"asset_type": "COLLATERAL"})
print("pUSD bakiyesi (ham):", balance["balance"])
print("Borsaya izin:", balance["allowance"])

# 2. Touch'tan oldukça uzakta 1 dolarlık bir limit emir verin
from py_clob_client.clob_types import OrderArgs
order = client.create_order(OrderArgs(
    token_id=test_token_id,
    price=0.05,        # piyasaya hiç yakın değil
    size=20,           # 0.05 dolarda 1 dolarlık nominal değer
    side="BUY",
))
resp = client.post_order(order)
print(resp)

# 3. İptal edin ve doğrulayın
client.cancel(order_id=resp["orderID"])

Üç çağrının da başarılı olması halinde bağlantınız düzgündür: SDK pUSD karşısında imzaladı, izin tanınıyor ve emir defteri tutarlı. Kademeli olarak tekrar ölçeklendirin.

Bölüm 6: Yaygın Hatalar ve Çözümleri

Bölüm 7: Koşullu Tokenlar, Emir Kimlikleri ve Değişmeyen Diğer Şeyler

Refaktör kapsamını dürüst tutmak için, işte geçiş boyunca sabit kalan tanımlayıcıların listesi:

• Koşullu Token sözleşmesi (CTF): adresi aynıdır. YES / NO ERC-1155 pozisyonlarınız etkilenmez.
• condition_id ve question_id: piyasa parametrelerinden deterministiktir; teminat değişiminden etkilenmez.
• token_id (sonuç): condition_id + sonuç indeksinden türetilir; değişmemiştir.
• Polymarket proxy cüzdan adresi: aynı adres; aynı Gnosis Safe tarzı kod.
• API anahtarı, API gizli anahtarı, API parolası: hâlâ geçerli (döndürmeniz önerilir; zorunlu değil).
• WebSocket şemaları: aynıdır; yeni asset alanı fill etkinliklerinde "USDC.e" yerine "pUSD" okur.
• Gamma ve Veri API'leri: kimlik doğrulaması gerektirmez, değişmedi. Teminat tokenını doğrudan hiç referans etmediler.

Bölüm 8: Vergi ve Muhasebe Etkileri

Çoğu yargı alanında USDC.e'nin pUSD'ye otomatik dönüşümü, 1:1 oranında USD'ye sabitlenmiş stabil kripto paralar arasında aynı türden bir swap olarak değerlendirilir ve vergilendirilebilir bir olay oluşturmaz. Maliyet esasınız ve elde tutma süreniz aynen devam eder.

Bununla birlikte, iki muhasebe kalemi dikkat edilmeyi hak eder:

1. Defter şemanızı güncelleyin. Polygon işlemlerini USDC.e sözleşmesine göre filtreleyen herhangi bir vergi aracı, SQLite defteri veya muhasebeci dışa aktarımı, göç sonrası işlemlerin tamamını sessizce atlayacaktır. pUSD sözleşme adresini bir takma ad olarak ekleyin.
2. Anlık görüntü dönüşümünü notlandırın. Çoğu rejimde vergilendirilebilir olmasa da, dönüşümü kayıtlarınızda açıkça kaydedin: tutar, blok, zaman damgası ve bunun 1:1 stabil kripto para göçü olduğuna dair bir not. Yargı alanınız daha sonra bunu sorgularsa, temiz bir denetim izi istersiniz.

İsrailli işlemciler, ITA'ya özgü raporlama için Vergi Rehberi ile görüşmelidir; göçün kendisi standart muameleyi değiştirmez ancak sözleşme adresi değişikliği otomatik raporlama araçları için önemlidir.

Bölüm 9: Değişimi Yaşayan Operatörlerden Profesyonel İpuçları

Sırada ne var?

• Polymarket API Kılavuzu - pUSD için güncellenmiş tam API kılavuzu
• Yatırma Kılavuzu - uygulama içinde USDC yatırma ve pUSD alma
• Çekme Kılavuzu - pUSD'yi harici bir cüzdana yerel USDC olarak çekme
• Araçlar & Kaynaklar - üçüncü taraf panolar artık pUSD için güncellendi
• Sözlük - burada kullanılan her terim için sade İngilizce tanımlar