إنتقل إلى المحتوى الرئيسي

صانع السوق الآلي والسيولة على السلسلة

وحدة x/amm هي صانع السوق الآلي (AMM) الأصلي على السلسلة في QoreChain. تتيح لأي شخص إنشاء أحواض سيولة، وتقديم سيولة، والمبادلة بين أصول QoreChain الأصلية مباشرةً على مستوى البروتوكول — دون الحاجة إلى دفتر أوامر خارج السلسلة أو منصة تبادل لامركزية (DEX) خارجية تعتمد على عقود ذكية. وهي طبقة التسوية على السلسلة التي تقف خلف تجربة Trade / DEX في لوحة التحكم.

تتبع الأحواض منحنيات تسعير AMM المألوفة:

  • constant_product — منحنى x*y=k (للأزواج متعددة الأغراض).
  • stable_swap — منحنى منخفض الانزلاق للأزواج المربوطة بإحكام، مضبوط بمعامل تضخيم.

تستخدم جميع المبالغ وحدات QoreChain الأصلية. رمز التخزين والرسوم هو QOR، وفئته الأساسية هي uqor (1 QOR = 10^6 uqor). يستخدم المشاركون في الأحواض والعناوين بادئة bech32 وهي qor.

ملاحظة

تستخدم الأوامر أدناه qorechaind. أضف رايات المعاملات المعتادة (--from، --chain-id، --gas، --fees، --node) المناسبة لبيئتك — على سبيل المثال --chain-id qorechain-vladi --gas 400000 --fees 40000uqor مقابل الشبكة الرئيسية (الحد الأدنى لرسوم الشبكة هو 0.1 uqor لكل وحدة غاز). كل أمر tx amm هو معاملة في مسار Cosmos، ولذلك يحتاج إلى التوقيع الهجين ما بعد الكمي: أضف --generate-only > tx.json، ثم شغّل qorechaind tx pqc cosign tx.json --from <key> --pqc-key <name> --chain-id <id> (انظر أول معاملة).

لا توجد أحواض على الشبكة الرئيسية بعد

وحدة AMM تعمل على الشبكة الرئيسية وشبكة الاختبار (الشبكة الرئيسية على v3.2.7 منذ 12 نوفمبر 2026؛ وشبكة الاختبار على v3.2.8 منذ 12 نوفمبر 2026). لم يُنشأ أي حوض على الشبكة الرئيسية بعد (فُحص في 30 أكتوبر 2026 ومجددًا في 4 نوفمبر 2026: يعيد GET /qorechain/amm/v1/pools قائمة فارغة هناك). في شبكة الاختبار حوض واحد (المعرّف 1، uqor مقابل رمز اختبار Fest؛ لشبكة الاختبار فقط، بلا قيمة). والفئات في الأمثلة أدناه (uusdc وuusdt) توضيحية: لا توجد أصول كهذه على الشبكات اليوم. وإلى أن يوجد حوض، يفشل كل أمر مبادلة أو إضافة سيولة بخطأ حوض غير موجود.

معاملات الوحدة​

اقرأ القيم الحية عبر qorechaind query amm params أو GET /qorechain/amm/v1/params. تُبلغ الشبكة الرئيسية وشبكة الاختبار حاليًا عن القيم نفسها:

المعاملالقيمةالمعنى
enabledtrueمفتاح تشغيل الوحدة
swap_fee_bps30رسوم المبادلة، 0.30 % من مقدار المدخل
protocol_fee_bps10الجزء من رسوم المبادلة الذي يغادر الحوض كحصة للبروتوكول (0.10 % من المدخل). ويبقى الباقي في الحوض لمزودي السيولة
pool_creation_fee100000000100 QOR (بوحدة uqor)، تُحتسب إضافةً إلى الإيداعات الأولية وتُحرق عند إنشاء حوض
min_liquidity1000يجب ألا يقل الأصغر من الإيداعين الأوليين لحوض جديد عن هذا العدد من الوحدات الأساسية
max_pools_per_creator50عدد الأحواض التي يجوز لحساب واحد إنشاؤها
max_swap_impact_bps500أكبر أثر سعري يجوز لمبادلة أن تُحدثه (5 %)؛ انظر قواعد المبادلة
lp_token_decimals6المنازل العشرية لعرض حصص LP في الحوض (للعرض فقط: حصص LP قيود في دفتر الحسابات وليست رموزًا)

قواعد المبادلة المُنفَّذة منذ v3.2.2​

طُبِّقت إصلاحات سلامة AMM أدناه على الشبكة الرئيسية مع v3.2.2 (الارتفاع 3,556,788، في 16 أكتوبر 2026) وصُقلت في v3.2.3 (الارتفاع 3,662,051، في 20 أكتوبر 2026). وهي تسري على كل مبادلة، أيًّا كان المسار الذي تصل منه.

  • كلتا الفئتين مرتبطتان بالحوض. يجب أن تسمّي المبادلة فئتي الحوض الذي تستهدفه. وتُسعَّر أحواض stable-swap بمنحنى stable-swap في الاتجاهين (مدخل محدد ومخرج محدد).
  • رسوم البروتوكول. تغادر حصة البروتوكول من رسوم المبادلة الحوض. وعندما تُدفع بـ QOR تذهب إلى جامع الرسوم وتُقسَّم مع رسوم الكتلة الأخرى (انظر اقتصاد الرمز)، ويُسجَّل الجزء المحروق تحت مصدر الحرق amm؛ وبأي فئة أخرى تذهب إلى مجمّع المجتمع. وتُحرق رسوم إنشاء الحوض وتُسجَّل تحت المصدر amm نفسه.
  • سقف الأثر السعري. تُنفَّذ قيمة max_swap_impact_bps: تُرفض أي مبادلة يتجاوز أثرها السعري على سعر الحوض 5 %. وتُقاس المبادلة التي لا تحدد حدًّا للانزلاق (min-out بقيمة 0 في المدخل المحدد، أو max-in يغطي كامل احتياطي المدخل في المخرج المحدد) إضافةً إلى ذلك مقابل سعر الحوض في بداية الكتلة، وتُرفض إذا كانت صفقات سابقة في الكتلة نفسها قد حرّكته إلى ما بعد السقف. اضبط قيمة حقيقية لـ min-out / max-in في كل مبادلة.
  • عمل محدود في نهاية الكتلة (v3.2.3). في نهاية كل كتلة تحدّث الوحدة متوسط السعر الموزون الجاري لما لا يزيد على 100 حوض، بالتناوب الدوري. وما دام عدد الأحواض 100 أو أقل، يُحدَّث كل حوض في كل كتلة؛ وما زاد على ذلك، يُحدَّث متوسط الحوض مرة واحدة في كل دورة من ceil(pools / 100) كتلة. المتوسط معلوماتي (يُعاد ضمن استعلامات pool) ولا يغيّر تسعير المبادلة.

الأحواض وحصص مزودي السيولة (LP)​

يحتفظ الحوض باحتياطيات من فئتين (token_a، token_b، مخزَّنتين بترتيب مرتب) ويسجّل حصص LP التي تمثل مطالبة تناسبية بتلك الاحتياطيات. لكل حوض id رقمي، وtype، وstatus (active أو paused). عند إضافة سيولة يرتفع رصيد حصص LP الخاص بك في ذلك الحوض؛ وعند إزالة السيولة ينخفض وتتلقى حصتك من الاحتياطيات.

حصص LP ليست رموزًا

حصص LP قيود في دفتر حسابات وحدة AMM نفسها، تُحفظ لكل حوض ولكل حساب (المفتاح الداخلي هو amm-lp/<pool id>). وهي ليست عملات bank وليست رموز ERC-20، ولا تظهر في رصيد bank لديك، ولا يمكن تحويلها أو إرسالها إلى حساب آخر أو تداولها. اقرأ حصتك عبر الاستعلام lp-balance أو المسار /lp/{address} أدناه.

إنشاء حوض​

يأخذ create-pool نوع الحوض والإيداعين الأوليين (كعملات). بالنسبة للزوج المستقر، اضبط معامل التضخيم باستخدام --amp.

# Constant-product pool seeded with QOR and a bridged USD asset
qorechaind tx amm create-pool constant_product 1000000000uqor 1000000000uusdc \
--from qor1youraddr... --chain-id qorechain-vladi

# Stable-swap pool with an amplification coefficient
qorechaind tx amm create-pool stable_swap 1000000000uusdc 1000000000uusdt \
--amp 200 --from qor1youraddr... --chain-id qorechain-vladi

إضافة سيولة​

يودِع add-liquidity كلا الجانبين في الحوض ويضيف إلى رصيد حصص LP الخاص بك. الوسيط الأخير هو الحد الأدنى لمقدار حصص LP الذي ستقبله — وهو حمايتك من تغيّر نسبة الحوض قبل تنفيذ معاملتك.

qorechaind tx amm add-liquidity 1 500000000uqor 500000000uusdc 100000 \
--from qor1youraddr... --chain-id qorechain-vladi

إزالة سيولة​

يخصم remove-liquidity حصص LP من رصيدك ويسحب الاحتياطيات. يحدد وسيطا min الحد الأدنى لمقدار كل جانب الذي ستقبل استرداده.

qorechaind tx amm remove-liquidity 1 100000 490000000 490000000 \
--from qor1youraddr... --chain-id qorechain-vladi

المبادلات​

يدعم AMM اتجاهي المبادلة القياسيين.

مدخل محدد (Exact-in)​

ينفق swap-exact-in مقدار مدخل ثابت ويعيد المخرج الذي يولّده المنحنى مهما كان، مع حد أدنى للمخرج (حماية من الانزلاق).

# Spend exactly 1,000,000 uqor for uusdc, refusing anything below 990,000 uusdc out
qorechaind tx amm swap-exact-in 1 1000000uqor uusdc 990000 \
--from qor1youraddr... --chain-id qorechain-vladi

مخرج محدد (Exact-out)​

يطلب swap-exact-out مقدار مخرج ثابت وينفق أي مدخل مطلوب مهما كان، مع حد أقصى للمدخل.

# Receive exactly 1,000,000 uusdc, spending at most 1,010,000 uqor
qorechaind tx amm swap-exact-out 1 uqor 1000000uusdc 1010000 \
--from qor1youraddr... --chain-id qorechain-vladi

وسيط min-out / max-in الأخير في كل مبادلة هو واقي الانزلاق: اضبطه من عرض سعر جديد (أدناه) بالإضافة إلى هامش التحمّل لديك، وتتراجع المعاملة إذا كان السعر المنفَّذ سيتجاوزه.

عروض الأسعار (معاينة السعر)​

عروض الأسعار للقراءة فقط — تعاين مبادلة دون تقديمها، بحيث يمكن للعميل إظهار المخرج المتوقع والرسوم قبل توقيع المستخدم. وهي الأساس الطبيعي لحقل السعر في واجهة التداول.

# Preview the output of spending 1,000,000 uqor into pool 1
qorechaind query amm quote-exact-in 1 uqor 1000000
# -> returns amount_out and fee

# Preview the input needed to receive 1,000,000 uusdc from pool 1
qorechaind query amm quote-exact-out 1 uusdc 1000000
# -> returns amount_in and fee

fee المعادة هي رسوم المبادلة التي يطبّقها AMM على الصفقة. تُحدَّد مستويات الرسوم والانزلاق بواسطة الحوض/المعاملات؛ استخدم نقاط نهاية عرض الأسعار لرؤية أثرها الملموس على أي صفقة بدلاً من حسابها يدوياً.

فحص الأحواض والأرصدة​

كل هذه استعلامات للقراءة فقط يمكن لأي شخص تشغيلها.

# Module parameters
qorechaind query amm params

# A single pool by ID
qorechaind query amm pool 1

# Every pool
qorechaind query amm pools

# Resolve a pool from its denom pair (order-independent)
qorechaind query amm pool-by-denoms uqor uusdc

# An account's LP balance in a pool
qorechaind query amm lp-balance 1 qor1youraddr...

يعيد pool احتياطيات الحوض، ومعروض LP، والنوع، والحالة، ومتوسط سعر موزون جارٍ. ويعيد lp-balance رصيد حصص LP balance الذي يحتفظ به حساب لذلك الحوض.

مسارات REST​

تُخدَّم القراءات نفسها عبر REST على كل من الشبكة الرئيسية (https://api.qore.host) وشبكة الاختبار (https://api-testnet.qore.host)؛ وقد فُحصت على الشبكتين في 27 أكتوبر 2026:

المسارما يعيده
GET /qorechain/amm/v1/paramsمعاملات الوحدة
GET /qorechain/amm/v1/poolsكل الأحواض (قائمة فارغة ما دام لا يوجد أي حوض)
GET /qorechain/amm/v1/pools/{pool_id}حوض واحد (404 إن كان غير معروف)
GET /qorechain/amm/v1/pools/{pool_id}/lp/{address}رصيد LP لعنوان في الحوض ({address} عنوان bech32 من الشكل qor1...)
GET /qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b=الحوض الخاص بزوج من الفئات (404 إن لم يوجد)
GET /qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in=المخرج والرسوم لمدخل محدد
GET /qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out=المدخل والرسوم لمخرج محدد

يردّ عرض السعر على حوض غير موجود بخطأ حوض غير موجود.

رموز Fest على شبكة الاختبار​

سجّلت حوكمة شبكة الاختبار ثلاثة عقود ERC-20 تجريبية، هي fUSD (6 منازل عشرية) وfETH (18) وfBTC (8)، لتوجد كعملات في وحدة bank بفئات حساسة لحالة الأحرف من الشكل erc20:<EIP-55 contract address> (مدرجة في صفحة الصنبور). يحصل الحائزون على عملة bank عبر MsgConvertERC20 (ويجب أن يكون المُرسِل عنوان bech32 من الشكل qor1...)، ويمكنهم إنشاء حوض مقابل uqor بأمر create-pool المعتاد ورسوم الإنشاء البالغة 100 QOR. وهي رموز اختبار خاصة بشبكة الاختبار فقط ولا قيمة لها، ولا يوجد حتى الآن أي حوض لها (فُحص في 27 أكتوبر 2026). ولا توجد هذه الرموز على الشبكة الرئيسية.

إيقاف الحوض واستئنافه مؤقتاً​

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

ملخص الأوامر​

المعاملات (qorechaind tx amm …):

الأمرالغرض
create-poolإنشاء حوض constant_product أو stable_swap
add-liquidityإيداع احتياطيات وإضافة حصص LP
remove-liquidityخصم حصص LP وسحب الاحتياطيات
swap-exact-inمبادلة مقدار مدخل ثابت
swap-exact-outمبادلة إلى مقدار مخرج ثابت
pause-poolإيقاف حوض مؤقتاً (سلطة الحوكمة؛ معطّل على الشبكة الرئيسية)
resume-poolاستئناف حوض موقوف (سلطة الحوكمة؛ معطّل على الشبكة الرئيسية)

الاستعلامات (qorechaind query amm …):

الأمرالغرض
paramsإظهار معاملات الوحدة
poolإظهار حوض واحد حسب المعرّف
poolsسرد جميع الأحواض
pool-by-denomsحلّ حوض من زوج فئاته
lp-balanceرصيد LP لحساب في حوض
quote-exact-inمعاينة المخرج لمبادلة بمدخل ثابت
quote-exact-outمعاينة المدخل لمبادلة بمخرج ثابت

ذات صلة​

  • تعرض واجهة Trade / DEX في لوحة التحكم هذه الأحواض وعروض الأسعار والمبادلات في واجهة رسومية للمستخدمين اليوميين.
  • لمعرفة كيفية تدفق معروض QOR والرسوم والقيمة عبر السلسلة، انظر اقتصاد الرمز.
  • جرّب المبادلات بنفسك في واجهة Trade / DEX.
  • لإحضار الأصول إلى QoreChain أولاً، انظر جسر الأصول (الجسر غير مباشر بعد).
  • يمكن أن تكون الأحواض أيضًا مصدرًا لسعر الرسوم في تجريد الغاز؛ ولا يُقبل أي رمز للرسوم اليوم.