تعليمات التوجيه

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

ملخص التعليمات

• الدقيق: أي مبلغ يتم تحديده من قبل المتصل (الإدخال = إدخال دقيق amount_in؛ الإخراج = إخراج دقيق amount_out).
• المتغير: التعليمات القديمة تتطلب طابور limit_prices غير فارغ حتى لو لم يكن هناك أي قفزة CLMM في المسار. التعليمات الحالية (8 / 9) تتعامل مع طابور limit_prices الفارغ كـ “بدون فحوصات”، وهو المسار الموصى به للكود الجديد.

​

تعليمات المبادلة الحالية (موصى بها)

​

SwapBaseIn (العلامة 8)

amount_in:            u64
minimum_amount_out:   u64
limit_prices:         VecDeque<u128>  // اختياري؛ طابور فارغ يعني بدون فحص سعر CLMM لكل قفزة

[
  <user_input_ata> W S,         // موقّع؛ الرصيد >= amount_in
  <user_intermediate_ata_1> W,  // واحد لكل قفزة وسيطة
  ... <user_intermediate_ata_N> W,
  <user_output_ata> W,
  <token_program>,

  <pool_program_hop_1>,         // يحدد أي عائلة AMM هي القفزة 1
  <pool_state_hop_1> W,
  ... <other accounts required by hop 1's program>,

  <pool_program_hop_2>,
  <pool_state_hop_2> W,
  ... <hop 2 accounts>,

  ... [كرّر لكل قفزة]
]

• المتصل يوقّع باستخدام user_input_ata.
• user_input_ata.amount >= amount_in.
• كل ATA وسيط للمستخدم موجود ويملكه المتصل.
• إذا كانت أي قفزة هي CLMM وكنت تريد فرض سعر محدود، قدّم إدخالة واحدة limit_prices لكل قفزة CLMM.

• رصيد user_input_ata انخفض بمقدار amount_in.
• رصيد user_output_ata زاد بمقدار ≥ minimum_amount_out.
• كل ATA وسيط يُترك بدون تغيير صافي (المسار يستهلك ما أنتجته القفزة السابقة).

• ExceededSlippage — الإخراج النهائي < minimum_amount_out.
• InvalidInput — مسار فارغ أو حسابات سيئة التشكيل أو pool_program غير مدعوم.
• SqrtPriceX64 — سعر قفزة CLMM تحرك خارج حد limit_prices المُوفّر (فقط عند عدم كون limit_prices فارغًا).

​

SwapBaseOut (العلامة 9)

maximum_amount_in:   u64
amount_out:          u64
limit_prices:        VecDeque<u128>  // اختياري؛ طابور فارغ يعني بدون فحص سعر CLMM لكل قفزة

• المتصل يوقّع باستخدام user_input_ata؛ الرصيد >= maximum_amount_in (الحالة الأسوأ).
• كل ATA وسيط و ATA الإخراج موجود.

• user_input_ata انخفض بالمبلغ الفعلي المطلوب (≤ maximum_amount_in).
• user_output_ata زاد بمقدار amount_out بالضبط.

• ExceededSlippage — الإدخال المطلوب يتجاوز maximum_amount_in.
• InvalidInput و SqrtPriceX64 — كما هو الحال بالنسبة للعلامة 8.

​

تعليمات المبادلة القديمة

​

SwapBaseInWithUserAccount (العلامة 0)

amount_in:           u64
minimum_amount_out:  u64
limit_prices:        VecDeque<u128>  // مطلوب، غير فارغ

• المتصل يوقّع باستخدام user_input_ata.
• user_input_ata.amount >= amount_in.
• جميع ATAs الوسيطة للمستخدم موجودة ويملكها المتصل.
• limit_prices غير فارغ (إدخال واحد لكل قفزة CLMM؛ ملء بقيم نائبة إذا لم تكن هناك قفزة CLMM).

• رصيد user_input_ata انخفض بمقدار amount_in.
• رصيد user_output_ata زاد بمقدار ≥ minimum_amount_out.

• ExceededSlippage.
• InvalidInput — limit_prices الفارغ مرفوض في هذا المتغير القديم.
• SqrtPriceX64.

​

SwapBaseOutWithUserAccount (العلامة 1)

maximum_amount_in:   u64
amount_out:          u64
limit_prices:        VecDeque<u128>  // مطلوب، غير فارغ

• المتصل يوقّع باستخدام user_input_ata.
• user_input_ata.amount >= maximum_amount_in.
• جميع ATAs الوسيطة للمستخدم موجودة ويملكها المتصل.
• limit_prices غير فارغ.

• user_input_ata انخفض بالمبلغ الفعلي المطلوب (≤ maximum_amount_in).
• user_output_ata زاد بمقدار amount_out بالضبط.

• ExceededSlippage.
• InvalidInput.
• SqrtPriceX64.

​

تعليمات الأدوات

​

CreateSyncNative (العلامة 5)

amount: u64    // SOL للتغليف (لامبورتات)

[
  <user_wsol_ata> W,            // ATA لـ wSOL؛ يُنشأ إذا كان مفقودًا
  <user_native_account> W S,    // موقّع؛ يتم خصم SOL من هنا
  <wsol_mint>,
  <system_program>,
  <token_program>,
  <associated_token_program>,
]

• ينشئ user_wsol_ata إذا لم يكن موجودًا بعد.
• ينقل amount لامبورتات من رصيد SOL الأصلي للموقّع إلى ATA.
• يستدعي SyncNative على ATA بحيث يعكس رصيد الرمز المميز اللامبورتات الجديدة.

• InvalidOwner — مالك user_wsol_ata ليس الموقّع.

​

CloseTokenAccount (العلامة 6)

[
  <token_account_to_close> W,
  <destination_for_rent> W,
  <owner> S,
  <token_program>,
]

• يغلق token_account_to_close.
• ينقل رصيد لامبورتات معفي الإيجار (~0.00203928 SOL على الشبكة الرئيسية لحساب SPL Token عادي) إلى destination_for_rent.
• يجب أن يكون رصيد حساب الرمز صفرًا.

• InvalidOwner — المتصل ليس مالك ATA.
• رصيد حساب الرمز غير صفري.

​

ما يلي

• products/routing/code-demos — بناء كل من هذه التعليمات في TypeScript.
• products/routing/accounts — مفاتيح التوزيع حسب كل AMM وتخطيط الحسابات لكل قفزة.
• reference/error-codes — قائمة RouteError الكاملة.