دليل ترحيل pUSD على Polymarket: من USDC.e إلى pUSD (أبريل 2026)

الفصل 36 من 36

النسخة المختصرة

في 28 أبريل 2026، نقلت Polymarket أصل التسوية الخاص بها على Polygon من USDC.e (رمز USDC المُجَسَّر، العقد 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) إلى pUSD، وهي عملة مستقرة (stablecoin) أصدرتها Polymarket وقابلة للاسترداد بنسبة 1:1 مقابل USDC الأصلي. لم يكن على متداولي تطبيق الويب فعل أي شيء - فقد تحوّلت الأرصدة والمراكز تلقائياً عند بلوك اللقطة. أما مشغلو الـ API والبوتات فعليهم التحديث: عنوان أصل التسوية داخل كل توقيع أمر CLOB قد تغيّر، والأوامر القديمة الموقّعة مقابل USDC.e تم إلغاؤها، ويُشترط py-clob-client 0.40 أو أحدث. يرشدك هذا الدليل عبر التغييرات الدقيقة في الكود والعقد والتفويضات اللازمة لإبقاء البوت يعمل قبل وأثناء وبعد التحوّل.

الجزء 1: ثلاث عملات مستقرة، شبكة Polygon واحدة

قبل الترحيل، كانت هناك ثلاث عملات مستقرة مرتبطة بالدولار في مدار Polymarket على Polygon. معرفة الفرق بينها هي الخطوة الأولى لفهم سبب تبديل Polymarket لأصل التسوية.

اختارت Polymarket في الأصل USDC.e لأنه كان النوع المهيمن من USDC على Polygon عند الإطلاق في 2020. لاحقاً، أصدرت Circle USDC أصلي مباشرة على Polygon وأعلنت عن إيقاف تدريجي للنسخة المُجَسَّرة. الاستمرار بالتسوية بـ USDC.e كان سيُعرّض Polymarket لخطر ذيل بسبب انسحاب مفاجئ للجسر. الانتقال إلى عملة مستقرة (stablecoin) تسيطر عليها Polymarket يحل هذا، ويفتح الباب لميزات منتجات مستقبلية (مثل الهامش للعقود الدائمة، وودائع الخزائن، وإيصالات عبر السلاسل) التي تتشارك جميعها وحدة الحساب نفسها.

الجزء 2: ما هو pUSD (وما ليس به)

pUSD هو رمز ERC-20 قياسي على Polygon (chain id 137) بست خانات عشرية، بنفس دقة USDC. لا يُسَكّ إلا عند تغليف USDC عبر عقد الضمان الخاص بـ Polymarket، ويمكن استرداده 1:1 مقابل USDC الأصلي في أي وقت، دون رسوم على التحويل (تظل رسوم غاز الشبكة سارية). الدعم مُنفَّذ على السلسلة: عقد التغليف يحتفظ بـ USDC الأساسي وهو نفسه آلية الاسترداد. لا يوجد وصيّ خارج السلسلة، ولا ربط خوارزمي، ولا احتياطي جزئي.

pUSD ليس عملة مستقرة (stablecoin) خوارزمية، ولا مفرط الضمان بالعملات الرقمية، ولا يولّد عائداً. إذا احتفظت بـ pUSD خارج Polymarket، فيجب أن تفكر فيه على أنه سند دين أصدرته Polymarket مقابل USDC الأصلي - مفيد داخل المنصة، قابل للاسترداد عند الطلب، لكن لا فائدة حقيقية من الاحتفاظ به طويلاً في محفظة خارجية.

الجزء 3: ما رآه متداولو تطبيق الويب

إذا كنت تتداول فقط عبر polymarket.com، فقد كان الترحيل غير مرئي. عند بلوك اللقطة في 28 أبريل 2026:

• أي رصيد USDC.e موجود في محفظة وكيل Polymarket تحوّل ذرّياً إلى pUSD بنسبة 1:1.
• احتفظت المراكز المفتوحة بنفس القيمة الدولارية، ونفس احتمالات النتائج، ونفس تاريخ الانتهاء. لم تتغيّر معرّفات الرموز الشرطية.
• أُلغيت الأوامر المعلّقة المسعّرة بـ USDC.e عند اللقطة. تُوقَّع الأوامر الجديدة بعد الترحيل تلقائياً بـ pUSD.
• تحوّلت عمليات السحب إلى محافظ خارجية من إرسال USDC.e إلى إرسال USDC أصلي (أو، إذا طُلب صراحة، pUSD خام - معظم المستخدمين لن يحتاجوا لذلك أبداً).

لم تكن هناك حاجة لأي توقيعات أو معاملات أو تغييرات في الإعدادات. الأوامر المحدّدة المعلّقة التي تهمك يجب إعادة وضعها يدوياً بعد الترحيل؛ كان الإلغاء حدثاً لمرة واحدة.

الجزء 4: مشغلو API والبوتات - التغييرات الحرجة

هذا هو الجزء الذي سيُعطّل بوتاً إن لم تتصرّف.

ترقية py-clob-client

أصدرت Polymarket py-clob-client 0.40.0 قبل أسبوعين من التبديل بدعم كامل لـ pUSD. أُهملت سلسلة 0.34.x في اليوم التالي للترحيل.

# الترقية إلى إصدار متوافق مع pUSD
pip install --upgrade "py-clob-client>=0.40.0"

# تحقق من أصل التسوية المُكوَّن
python -c "from py_clob_client.constants import POLYGON; \
print('عنوان pUSD:', POLYGON.get('collateral'))"

الـ SDK الجديد يسحب عنوان أصل التسوية من تكوين الشبكة عند البدء، فلا حاجة لتثبيت أي شيء في الكود. إذا قمت بفصل النسخة (fork) أو تثبيت إصدار قديم، فأسلم طريق هو حذف ملف القفل (lockfile)، وإعادة التثبيت بأحدث وحدة constants، وإعادة تشغيل مجموعة اختباراتك.

إعادة منح أذونات الإنفاق

تحتاج محفظة وكيل Polymarket إلى تفويض ERC-20 من حساب التداول الخاص بك إلى عقد CTF Exchange لرمز pUSD. التفويض القديم لـ USDC.e ما زال مسجلاً على السلسلة لكنه عديم الفائدة تماماً: لن يستهلكه CLOB. بدون تفويض جديد لـ pUSD، كل أمر يُرجِع "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 لحسابات Magic-link
)
client.set_api_creds(client.create_or_derive_api_creds())

# مرة واحدة: السماح لـ pUSD بعقد CTF Exchange
# (دالة مساعدة أُضيفت في py-clob-client 0.40)
client.update_balance_allowance(asset_type="COLLATERAL")

تحديث أوراق اعتماد الـ API

تستمر مفاتيح الـ API الحالية بالعمل، لكن إذا اشتققت أوراق الاعتماد قبل 1 أبريل فعليك تدويرها كإجراء احترازي: توقيع ECDSA للطبقة الأولى مرتبط الآن بمجال يتضمّن عنوان أصل التسوية الجديد. أبسط مسار:

creds = client.create_or_derive_api_creds()  # إعادة اشتقاق idempotent
client.set_api_creds(creds)

# احفظها في ملف .env الخاص بك
print(creds.api_key, creds.api_secret, creds.api_passphrase)

الجزء 5: التحقق من البوت بعد الترحيل

شغّل اختبار الدخان الأدنى هذا قبل أن تسمح لأي منطق تحديد حجم بالعمل بأموال حقيقية:

# 1. تأكيد رصيد pUSD في محفظة الوكيل
from py_clob_client.client import ClobClient
client = ClobClient(...)  # كما أعلاه
balance = client.get_balance_allowance(params={"asset_type": "COLLATERAL"})
print("رصيد pUSD (خام):", balance["balance"])
print("التفويض للـ exchange:", balance["allowance"])

# 2. ضع أمر limit بقيمة دولار واحد بعيداً عن سعر اللمس
from py_clob_client.clob_types import OrderArgs
order = client.create_order(OrderArgs(
    token_id=test_token_id,
    price=0.05,        # ليس قريباً من السوق إطلاقاً
    size=20,           # قيمة اسمية بدولار واحد عند 0.05
    side="BUY",
))
resp = client.post_order(order)
print(resp)

# 3. ألغِ وأكِّد
client.cancel(order_id=resp["orderID"])

إذا نجحت الاستدعاءات الثلاثة، فالاتصال سليم: وقّع الـ SDK مقابل pUSD، التفويض معترَف به، وكتاب الأوامر متّسق. الآن قم بالتوسعة تدريجياً.

الجزء 6: الأخطاء الشائعة والحلول

الجزء 7: الرموز الشرطية، معرّفات الأوامر، وأشياء أخرى لم تتغيّر

للحفاظ على نطاق إعادة الهيكلة صادقاً، إليك قائمة المعرّفات التي تظل مستقرة عبر الترحيل:

• عقد Conditional Token (CTF): العنوان نفسه. مراكز ERC-1155 YES / NO لم تُمَس.
• condition_id و question_id: حتميان من معاملات السوق؛ لم يتأثرا بتبديل أصل التسوية.
• token_id (النتيجة): مشتق من condition_id + فهرس النتيجة؛ لا تغيير.
• عنوان محفظة وكيل Polymarket: العنوان نفسه؛ نفس كود نمط Gnosis Safe.
• مفتاح API، سرّ API، عبارة مرور API: تبقى صالحة (يُنصح بتدويرها؛ ليس إلزامياً).
• مخططات WebSocket: متطابقة؛ يعرض حقل asset الجديد "pUSD" بدلاً من "USDC.e" في أحداث التنفيذ.
• واجهتا Gamma و Data: بلا مصادقة، بلا تغيير. لم يشيرا أبداً مباشرة إلى رمز أصل التسوية.

الجزء 8: التداعيات الضريبية والمحاسبية

في معظم الولايات القضائية، التحويل التلقائي من USDC.e إلى pUSD هو مبادلة عملات مستقرة مرتبطة بالدولار من نفس النوع 1:1 ولا يولّد حدثاً ضريبياً. تبقى قاعدة تكلفتك وفترة احتفاظك كما هي.

ومع ذلك، هناك جانبان محاسبيان يستحقان الانتباه:

1. حدِّث مخطط دفتر الأستاذ. أي أداة ضريبية، أو دفتر SQLite، أو تصدير لمحاسب يفلتر معاملات Polygon بعقد USDC.e سيتجاهل بصمت كل المعاملات التي تلت الترحيل. أضف عنوان عقد pUSD كاسم بديل.
2. سجِّل تحويل اللقطة. رغم أنه ليس خاضعاً للضريبة في معظم الأنظمة، سجّل التحويل بوضوح في سجلاتك: المبلغ، البلوك، الطابع الزمني، وملاحظة بأنه ترحيل عملة مستقرة (stablecoin) 1:1. إذا راجعت سلطتك الضريبية الأمر لاحقاً، ستحتاج لمسار تدقيق نظيف.

على المتداولين في إسرائيل مراجعة دليل الضرائب للتقارير الخاصة بسلطة الضرائب؛ الترحيل نفسه لا يغيّر المعاملة القياسية، لكن تغيير عنوان العقد يهمّ لأدوات الإبلاغ الآلية.

الجزء 9: نصائح احترافية من مشغلين عاشوا التحوّل

ما التالي؟

• دليل API لـ Polymarket - الدليل الكامل للـ API، محدَّث لـ pUSD
• دليل الإيداع - إيداع USDC واستلام pUSD داخل التطبيق
• دليل السحب - سحب pUSD كـ USDC أصلي إلى محفظة خارجية
• الأدوات والموارد - لوحات الطرف الثالث المحدَّثة الآن لـ pUSD
• المعجم - تعريفات بلغة بسيطة لكل مصطلح مذكور هنا