Sari la conținutul principal

AMM și lichiditate on-chain

Modulul x/amm este market maker-ul automatizat (AMM) nativ, on-chain, al QoreChain. Permite oricui să creeze pool-uri de lichiditate, să furnizeze lichiditate și să schimbe între active native QoreChain direct la nivel de protocol — fără registru de ordine off-chain și fără un DEX bazat pe contracte inteligente externe. Este stratul de decontare on-chain din spatele experienței Trade / DEX din Dashboard.

Pool-urile urmează curbe de prețuri AMM familiare:

  • constant_product — curba x*y=k (perechi de uz general).
  • stable_swap — o curbă cu alunecare redusă pentru perechi strâns ancorate, ajustată printr-un coeficient de amplificare.

Toate sumele folosesc unitățile native ale QoreChain. Token-ul de staking și de taxe este QOR, al cărui denom de bază este uqor (1 QOR = 10^6 uqor). Participanții la pool și adresele folosesc prefixul bech32 qor.

notă

Comenzile de mai jos folosesc qorechaind. Adăugați flag-urile uzuale de tranzacție (--from, --chain-id, --gas, --fees, --node) pentru mediul dumneavoastră — de exemplu --chain-id qorechain-vladi --gas 400000 --fees 40000uqor pe mainnet (pragul minim de taxă al rețelei este 0,1 uqor per unitate de gas). Fiecare comandă tx amm este o tranzacție pe lane-ul Cosmos, deci necesită semnătura hibridă post-cuantică: adăugați --generate-only > tx.json, apoi rulați qorechaind tx pqc cosign tx.json --from <key> --pqc-key <name> --chain-id <id> (vedeți First Transaction).

Nu există încă pool-uri pe mainnet

Modulul AMM este activ pe mainnet și pe testnet (mainnet pe v3.2.7 din 12 noiembrie 2026; testnet-ul pe v3.2.8 din 12 noiembrie 2026). Pe mainnet nu a fost creat încă niciun pool (verificat pe 30 octombrie 2026 și din nou pe 4 noiembrie 2026: GET /qorechain/amm/v1/pools returnează acolo o listă goală). Testnet-ul are un pool (id 1, uqor contra unui token de test Fest; doar testnet, fără valoare). Denom-urile din exemplele de mai jos (uusdc, uusdt) sunt ilustrative: astăzi nu există astfel de active pe rețele. Până când există un pool, orice comandă de schimb sau de adăugare de lichiditate eșuează cu o eroare de tip pool negăsit.

Parametrii modulului​

Citiți valorile curente cu qorechaind query amm params sau GET /qorechain/amm/v1/params. Mainnet și testnet raportează în prezent aceleași valori:

ParametruValoareSemnificație
enabledtrueComutatorul modulului
swap_fee_bps30Taxa de schimb, 0,30 % din suma de intrare
protocol_fee_bps10Partea din taxa de schimb care părăsește pool-ul ca cotă a protocolului (0,10 % din intrare). Restul rămâne în pool pentru furnizorii de lichiditate
pool_creation_fee100000000100 QOR (în uqor), percepuți peste depozitele inițiale și arși la crearea unui pool
min_liquidity1000Cel mai mic dintre cele două depozite inițiale ale unui pool nou trebuie să fie de cel puțin atâtea unități de bază
max_pools_per_creator50Pool-uri pe care le poate crea un cont
max_swap_impact_bps500Cel mai mare impact asupra prețului pe care îl poate avea un schimb (5 %); vedeți Regulile de schimb
lp_token_decimals6Zecimale de afișare ale cotelor LP ale unui pool (cosmetic: cotele LP sunt înregistrări de registru, nu token-uri)

Regulile de schimb aplicate începând cu v3.2.2​

Corecțiile de integritate AMM de mai jos au fost aplicate pe mainnet cu v3.2.2 (înălțimea 3.556.788, 16 octombrie 2026) și rafinate în v3.2.3 (înălțimea 3.662.051, 20 octombrie 2026). Se aplică fiecărui schimb, indiferent de lane-ul din care sosește.

  • Ambele denominări sunt legate de pool. Un schimb trebuie să numească cele două denom-uri ale pool-ului vizat. Pool-urile stable-swap sunt evaluate cu curba stable-swap în ambele direcții (exact-in și exact-out).
  • Taxa de protocol. Cota de protocol din taxa de schimb părăsește pool-ul. Când este plătită în QOR, ajunge la colectorul de taxe și este împărțită cu celelalte taxe ale blocului (vedeți Tokenomics), iar partea arsă este înregistrată sub sursa de ardere amm; în orice altă denominare ajunge în community pool. Taxa de creare a pool-ului este arsă și înregistrată sub aceeași sursă amm.
  • Plafonul impactului asupra prețului. max_swap_impact_bps este aplicat: un schimb al cărui impact asupra prețului pool-ului depășește 5 % este refuzat. Un schimb care nu stabilește nicio limită de alunecare (min-out de 0 la exact-in, sau un max-in care acoperă întreaga rezervă de intrare la exact-out) este măsurat suplimentar față de prețul pool-ului de la începutul blocului și este refuzat dacă tranzacțiile anterioare din același bloc l-au mutat peste plafon. Setați un min-out / max-in real la fiecare schimb.
  • Muncă limitată la sfârșit de bloc (v3.2.3). La sfârșitul fiecărui bloc, modulul reîmprospătează prețul mediu ponderat curent al cel mult 100 de pool-uri, în rotație (round-robin). Cât timp există 100 de pool-uri sau mai puține, fiecare pool este reîmprospătat în fiecare bloc; peste acest număr, media unui pool se actualizează o dată la fiecare rundă de ceil(pools / 100) blocuri. Media este informativă (este returnată de interogările pool) și nu modifică prețul schimburilor.

Pool-uri și cote LP​

Un pool deține rezerve de două denom-uri (token_a, token_b, stocate în ordine sortată) și înregistrează cote LP care reprezintă o creanță proporțională asupra acelor rezerve. Fiecare pool are un id numeric, un type și un status (active sau paused). Când adăugați lichiditate, soldul dumneavoastră de cote LP din acel pool crește; când eliminați lichiditate, scade și primiți cota dumneavoastră din rezerve.

Cotele LP nu sunt token-uri

Cotele LP sunt intrări în registrul propriu al modulului AMM, ținut per pool și per cont (cheia internă este amm-lp/<pool id>). Ele nu sunt monede bank și nu sunt token-uri ERC-20, nu apar în soldul dumneavoastră bank și nu pot fi transferate, trimise către un alt cont sau tranzacționate. Citiți-vă cota cu interogarea lp-balance sau cu ruta /lp/{address} de mai jos.

Crearea unui pool​

create-pool primește un tip de pool și cele două depozite inițiale (sub formă de monede). Pentru o pereche stabilă, setați coeficientul de amplificare cu --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

Adăugarea de lichiditate​

add-liquidity depune ambele părți într-un pool și creditează soldul dumneavoastră de cote LP. Argumentul final este suma minimă de cote LP pe care o veți accepta — protecția dumneavoastră împotriva modificării raportului pool-ului înainte ca tranzacția să fie procesată.

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

Eliminarea de lichiditate​

remove-liquidity debitează cote LP din soldul dumneavoastră și retrage rezerve. Cele două argumente min setează suma minimă din fiecare parte pe care o veți accepta înapoi.

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

Schimburi​

AMM-ul suportă cele două direcții standard de schimb.

Exact-in​

swap-exact-in cheltuiește o sumă de intrare fixă și returnează oricât output produce curba, supus unui prag minim de ieșire (protecție la alunecare).

# 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 solicită o sumă de ieșire fixă și cheltuiește oricât input este necesar, supus unui plafon maxim de intrare.

# 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

Argumentul final min-out / max-in de la fiecare schimb este garanția împotriva alunecării: setați-l pe baza unei cotații proaspete (mai jos) plus toleranța dumneavoastră, iar tranzacția se anulează dacă prețul executat l-ar încălca.

Cotații (previzualizare preț)​

Cotațiile sunt doar pentru citire — previzualizează un schimb fără a-l trimite, astfel încât un client poate afișa un output și o taxă așteptate înainte ca utilizatorul să semneze. Sunt suportul natural pentru câmpul de preț al unei interfețe Trade.

# 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-ul returnat este taxa de schimb pe care AMM-ul o aplică tranzacției. Nivelurile de taxe și alunecare sunt determinate de pool/parametri; folosiți endpoint-urile de cotație pentru a vedea efectul lor concret asupra oricărei tranzacții date, în loc să le calculați manual.

Inspectarea pool-urilor și a soldurilor​

Toate acestea sunt interogări doar pentru citire pe care oricine le poate rula.

# 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 returnează rezervele pool-ului, oferta de LP, tipul, statusul și un preț mediu ponderat curent. lp-balance returnează balance-ul de cote LP pe care un cont îl deține pentru acel pool.

Rute REST​

Aceleași citiri sunt servite prin REST pe ambele rețele, mainnet (https://api.qore.host) și testnet (https://api-testnet.qore.host); au fost verificate pe ambele la 27 octombrie 2026:

RutăReturnează
GET /qorechain/amm/v1/paramsParametrii modulului
GET /qorechain/amm/v1/poolsToate pool-urile (o listă goală cât timp nu există niciunul)
GET /qorechain/amm/v1/pools/{pool_id}Un pool (404 dacă nu este cunoscut)
GET /qorechain/amm/v1/pools/{pool_id}/lp/{address}Soldul LP al unei adrese în pool ({address} este o adresă bech32 qor1...)
GET /qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b=Pool-ul pentru o pereche de denom-uri (404 dacă nu există)
GET /qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in=Ieșirea și taxa pentru o intrare exactă
GET /qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out=Intrarea și taxa pentru o ieșire exactă

O cotație față de un pool care nu există răspunde cu o eroare de tip pool negăsit.

Tokenurile Fest de pe testnet​

Guvernanța testnet-ului a înregistrat trei contracte ERC-20 de test, fUSD (6 zecimale), fETH (18) și fBTC (8), astfel încât să existe ca monede bank cu denominațiile sensibile la majuscule erc20:<EIP-55 contract address> (listate pe pagina Faucet). Deținătorii obțin moneda bank cu MsgConvertERC20 (expeditorul trebuie să fie o adresă bech32 qor1...) și pot crea un pool față de uqor cu comanda obișnuită create-pool și taxa de creare de 100 QOR. Sunt tokenuri de test doar pentru testnet, fără valoare, și încă nu există niciun pool pentru ele (verificat la 27 octombrie 2026). Mainnet-ul nu are astfel de tokenuri.

Suspendarea și reluarea unui pool​

Pool-urile pot fi suspendate și reluate de către autoritatea de guvernanță. Pe mainnet, aceste două mesaje sunt în prezent dezactivate de întrerupătorul de circuit (circuit breaker); pe testnet nu sunt dezactivate. Un pool suspendat respinge schimburile și modificările de lichiditate până când este reluat — util pentru răspunsul la incidente sau pentru mentenanță coordonată.

Rezumatul comenzilor​

Tranzacții (qorechaind tx amm …):

ComandăScop
create-poolCreează un pool constant_product sau stable_swap
add-liquidityDepune rezerve și creditează cote LP
remove-liquidityDebitează cote LP și retrage rezerve
swap-exact-inSchimbă o sumă de intrare fixă
swap-exact-outSchimbă către o sumă de ieșire fixă
pause-poolSuspendă un pool (autoritate de guvernanță; dezactivat pe mainnet)
resume-poolReia un pool suspendat (autoritate de guvernanță; dezactivat pe mainnet)

Interogări (qorechaind query amm …):

ComandăScop
paramsAfișează parametrii modulului
poolAfișează un pool după ID
poolsListează toate pool-urile
pool-by-denomsRezolvă un pool din perechea sa de denom-uri
lp-balanceSoldul LP al unui cont într-un pool
quote-exact-inPrevizualizează output-ul pentru un schimb cu intrare fixă
quote-exact-outPrevizualizează input-ul pentru un schimb cu ieșire fixă

Conexe​

  • Trade / DEX din Dashboard expune aceste pool-uri, cotații și schimburi într-o interfață grafică pentru utilizatorii de zi cu zi.
  • Pentru modul în care oferta de QOR, taxele și valoarea circulă prin lanț, vedeți Tokenomics.
  • Încercați singur schimburile în interfața Trade / DEX.
  • Pentru a aduce mai întâi active pe QoreChain, vedeți Transferul de active prin punte (bridge-ul nu este încă activ).
  • Pool-urile pot fi, de asemenea, o sursă de preț pentru taxe în Abstractizarea gazului; în prezent nu este acceptat niciun token pentru taxe.