راهنمای مهاجرت
این راهنما توضیح می‌دهد هنگام راه‌اندازی پشته غیرامانی OrcaRail چه باید بکنید و چه انتظاری داشته باشید. راه‌اندازی مرحله‌ای و برای هر زنجیره اختیاری است؛ هیچ لینک یا اشتراک موجودی مجبور به مهاجرت نمی‌شود.
برای پذیرندگان
چه چیزی در یکپارچه‌سازی شما تغییر می‌کند
هیچ کاری لازم نیست. ساختار پاسخ API برای لینک‌های پرداخت و اشتراک‌ها در طول گذار افزایشی است:
- لینک‌های پرداخت فیلد جدید
receiver.contract_addressرا می‌گیرند (برای لینک‌های دارای گیرنده آن‌چین، همان مقدار آدرس واریز فعلی). - اشتراک‌ها
auto_charge.approval_spender_addressرا می‌گیرند که به جای کیف پول داغ بهSubscriptionHubآن‌چین اشاره می‌کند. این فیلد از قبل در برداشت خودکار وجود دارد؛ فقط مقدارش تغییر می‌کند. - وبهوک‌ها در همان لحظه‌ها ارسال می‌شوند (
payment.succeeded،subscription.charge.*و غیره).
چه چیزی در داشبورد تغییر می‌کند
- نشان «غیرامانی» روی لینک‌های پرداخت و اشتراک‌هایی که از پشته جدید استفاده می‌کنند نمایش داده می‌شود.
- بنری روی اشتراک‌های فعال موجود از شما می‌خواهد در تمدید بعدی، مهاجرت را به پرداخت‌کننده پیشنهاد دهید.
- یک کلید برای هر زنجیره در تنظیمات به شما امکان می‌دهد پس از سالم بودن canary روی آن زنجیره (اول Base)، گیرنده‌های غیرامانی را زنجیره به زنجیره فعال کنید.
چه زمانی اقدام کنید
- فاز ۱ (Base): هیچ کاری لازم نیست. لینک‌های جدید روی Base پس از فعال شدن پرچم سازمان شما خودکار از گیرنده جدید استفاده می‌کنند.
- فاز ۲: وقتی بنر ظاهر شد، اعلان تمدید را برای مشترکان بفرستید تا دوباره
approveرا برایSubscriptionHubجدید امضا کنند. قالب ایمیل از پیش پر شده است. - فاز ۳ (سایر زنجیره‌های EVM): همان الگوی Base، برای هر زنجیره.
- فاز ۴ (سولانا): همان الگو، که در چرخه بعدی اشتراک SOL پذیرنده فعال می‌شود.
- فاز ۵ (بیت‌کوین): یک امضاکننده BTC (xpub) در داشبورد ثبت کنید تا لینک‌های BTC جدید بتوانند از مولتی‌سیگ دو از دو استفاده کنند. ملاحظات بیت‌کوین را ببینید.
- فاز ۷: اگر هنوز مشترکی روی مسیر امانی قدیمی دارید، با اعلان نهایی ۳۰ روزه‌ای که ارائه می‌کنیم با او تماس بگیرید.
مسیرهای قدیمی
لینک‌های پرداخت قدیمی موجود تا زمان انقضا مثل قبل تسویه می‌شوند. اشتراک‌های قدیمی موجود تا مهاجرت یا لغو همچنان از کیف پول داغ امانی برداشت می‌کنند. مهاجرت اجباری در کار نیست.
برای پرداخت‌کنندگان
پرداخت‌های یک‌باره
هیچ چیز تغییر نمی‌کند. همان لینک پرداخت، همان آدرس و همان رابط کیف پول را می‌بینید. در پشت صحنه، گیرنده به جای کیف پولی روی سرور یک قرارداد هوشمند است؛ اما جریان شما دقیقاً همان است.
اشتراک‌ها
جریان راه‌اندازی همان جریان امروز است: کیف پول را وصل کنید، approve (EVM) یا Approve در SPL (سولانا) را امضا کنید و تمام. تنها تفاوت قابل مشاهده این است که گیرنده مجوز به جای کیف پول داغ OrcaRail یک آدرس قرارداد (SubscriptionHub) است. کیف پول شما به‌روشنی نشان می‌دهد که گیرنده مجوز یک قرارداد است.
هر زمان می‌توانید لغو کنید؛ کافی است allowance را در بخش تأییدهای توکن کیف پول خود لغو کنید. پس از لغو، برداشت زمان‌بندی‌شده بعدی ناموفق می‌شود و ایمیلی دریافت می‌کنید. با امضای approve جدید می‌توانید دوباره شروع کنید.
اگر مشترک فعلی هستید
وقتی بنر مهاجرت در صفحه مدیریت اشتراکتان ظاهر شود، پیشنهاد مهاجرت را می‌بینید. با کلیک روی آن:
- از شما خواسته می‌شود allowance قدیمی را لغو کنید (اختیاری؛ پس از مهاجرت بی‌اثر می‌شود).
- از شما خواسته می‌شود
approveجدیدی برای قراردادSubscriptionHubامضا کنید.
همین. اشتراک شما بدون وقفه ادامه می‌یابد.
اگر مهاجرت نکنید، اشتراک شما تا زمان لغو یا تا پایان پنجره نهایی مهاجرت که در فاز ۷ اعلام می‌شود روی مسیر قدیمی ادامه می‌یابد.
برای یکپارچه‌سازان (کاربران SDK)
فیلدهای افزوده
ساختار پاسخ API کاملاً با نسخه‌های قبلی سازگار است. فیلدهای جدید:
payment_intent.receiver.contract_addresssubscription.auto_charge.approval_spender_address(ممکن است مقدارش به آدرس قرارداد تغییر کند)subscription.on_chain.*(آدرس هاب اشتراک، chain id، شناسهbytes32اشتراک)- وبهوک‌ها در موارد لازم پرچم
non_custodial: trueرا اضافه می‌کنند.
منسوخ‌سازی‌ها
در طول گذار هیچ فیلدی حذف نمی‌شود. در فاز ۷، فیلدهایی که آدرس امضاکنندگان امانی را توصیف می‌کنند در مرجع API منسوخ علامت می‌خورند و در نسخه اصلی بعدی SDK (@orcarail/[email protected]) با ۹۰ روز اطلاع قبلی حذف می‌شوند.
سازگاری وبهوک
نوع رویدادها و ساختار payload برای payment.*، subscription.* و webhook.* تغییری نمی‌کند. مسیر غیرامانی همان رویدادها را در همان لحظه‌ها منتشر می‌کند.
لغو در میانه چرخه
اگر پرداخت‌کننده‌ای allowance خود را بین دو چرخه لغو کند:
charge()بعدی رویدادChargeSkipped(InsufficientAllowance)را آن‌چین منتشر می‌کند.- ایندکسر اشتراک را به
past_dueتغییر می‌دهد. - قالب ایمیل موجود
subscription-insufficient-allowance.hbsبرای پرداخت‌کننده ارسال می‌شود. - وبهوک
subscription.payment_failedبرای پذیرنده ارسال می‌شود. - پرداخت‌کننده می‌تواند با تأیید دوباره از صفحه مدیریت اشتراک، اشتراک را از نو شروع کند.
رفتار همان چیزی است که امروز در برداشت خودکار دارید. فقط لوله‌کشی تغییر کرده است.
ملاحظات بین‌زنجیره‌ای
اگر پرداخت‌کننده روی زنجیره‌ای غیر از زنجیره تسویه پذیرنده پرداخت کند، Relay پل را مدیریت می‌کند (استراتژی برداشت را ببینید). پشته غیرامانی فراخواننده Relay را تغییر می‌دهد (گیرنده یا EOA keeper، نه امضاکننده امانی) بدون آنکه خود مسیر پل تغییر کند.
مرجع زمان‌بندی
برای وضعیت زنده نقشه راه را ببینید. تاریخ‌ها هدف‌اند، نه تعهد.
| فاز | چه انتظاری داشته باشید |
|---|---|
| ۱ | لینک‌های پرداخت Base غیرامانی می‌شوند (ابتدا canary اختیاری، سپس پیش‌فرض) |
| ۲ | اشتراک‌های EVM هنگام تمدید مهاجرت می‌کنند |
| ۳ | Ethereum، Arbitrum، Optimism و Polygon فعال می‌شوند |
| ۴ | لینک‌های پرداخت و اشتراک‌های سولانا مهاجرت می‌کنند |
| ۵ | بیت‌کوین به مولتی‌سیگ دو از دو منتقل می‌شود (اشتراک BTC همچنان پشتیبانی نمی‌شود) |
| ۶ | اختیاری: keeper غیرمتمرکز. تغییری برای پذیرندگان/پرداخت‌کنندگان نیست. |
| ۷ | مسیرهای امانی قدیمی حذف می‌شوند؛ اعلان نهایی مهاجرت برای باقی‌مانده‌ها |