صانع السوق الآلي والسيولة على السلسلة
وحدة 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. تُبلغ الشبكة الرئيسية وشبكة الاختبار حاليًا عن القيم نفسها:
| المعامل | القيمة | المعنى |
|---|---|---|
enabled | true | مفتاح تشغيل الوحدة |
swap_fee_bps | 30 | رسوم المبادلة، 0.30 % من مقدار المدخل |
protocol_fee_bps | 10 | الجزء من رسوم المبادلة الذي يغادر الحوض كحصة للبروتوكول (0.10 % من المدخل). ويبقى الباقي في الحوض لمزودي السيولة |
pool_creation_fee | 100000000 | 100 QOR (بوحدة uqor)، تُحتسب إضافةً إلى الإيداعات الأولية وتُحرق عند إنشاء حوض |
min_liquidity | 1000 | يجب ألا يقل الأصغر من الإيداعين الأوليين لحوض جديد عن هذا العدد من الوحدات الأساسية |
max_pools_per_creator | 50 | عدد الأحواض التي يجوز لحساب واحد إنشاؤها |
max_swap_impact_bps | 500 | أكبر أثر سعري يجوز لمبادلة أن تُحدثه (5 %)؛ انظر قواعد المبادلة |
lp_token_decimals | 6 | المنازل العشرية لعرض حصص 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 قيود في دفتر حسابات وحدة 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 أولاً، انظر جسر الأصول (الجسر غير مباشر بعد).
- يمكن أن تكون الأحواض أيضًا مصدرًا لسعر الرسوم في تجريد الغاز؛ ولا يُقبل أي رمز للرسوم اليوم.