Sari la conținutul principal

Puncte finale REST / gRPC

QoreChain expune trei interfețe principale pentru acces programatic:

InterfațăPort implicitProtocolDescriere
REST1317HTTP/1.1Gateway REST (server API Cosmos SDK)
gRPC9090HTTP/2Serviciu gRPC codificat Protobuf
RPC26657HTTP + WSRPC al QoreChain Consensus Engine

Toate punctele finale REST returnează JSON. Punctele finale gRPC folosesc Protocol Buffers și pot fi consumate cu orice client gRPC. Interfața RPC oferă interogări la nivel de consens și difuzarea tranzacțiilor.

notă

Aceste interfețe sunt disponibile atât pe mainnet-ul qorechain-vladi (live din 7 iunie 2026), cât și pe testnet-ul qorechain-diana. Testnet-ul rulează versiunea de nod v3.2.8 (aplicată prin guvernanța testnet-ului la înălțimea 9.929.500, pe 12 noiembrie 2026, după v3.2.7 la înălțimea 9.594.600, pe 6 noiembrie 2026), iar mainnet-ul rulează v3.2.7, cu o versiune în urmă. Mainnet-ul a aplicat v3.2.7 la înălțimea 4.164.600, pe 12 noiembrie 2026 (propunerea de guvernanță 16, după v3.2.6 la înălțimea 4.020.000, pe 4 noiembrie 2026, propunerea de guvernanță 15, v3.2.5 la înălțimea 3.906.833, pe 29 octombrie 2026, propunerea 14, și v3.2.4 la înălțimea 3.742.566, pe 23 octombrie 2026); testnet-ul a aplicat v3.2.5 la înălțimea 8.890.800, pe 26 octombrie 2026, v3.2.6 la înălțimea 8.970.638, pe 27 octombrie 2026, v3.2.7 la înălțimea 9.594.600 și v3.2.8 la înălțimea 9.929.500. Mainnet-ul nu a aplicat v3.2.8. Rutele și câmpurile adăugate de o versiune apar pe o rețea abia după ce rețeaua respectivă a aplicat versiunea. Verificările de rute marcate cu 4 noiembrie 2026 mai jos au fost făcute pe gazda publică de mainnet după upgrade-ul v3.2.6; rutele marcate v3.2.7 au fost verificate pe gazda publică de testnet pe 7 noiembrie 2026 și pe gazda publică de mainnet pe 12 noiembrie 2026, după ce mainnet-ul a aplicat v3.2.7 (toate sunt rutate; vezi notele de la fiecare rută). URL-urile de bază de mai jos presupun un nod care rulează local. Punctele finale publice găzduite sunt https://api.qore.host / https://api-testnet.qore.host (REST) și https://rpc.qore.host / https://rpc-testnet.qore.host (RPC), listate în Rețele. Nu există un punct final gRPC public: numele de gazdă grpc.qore.host și grpc-testnet.qore.host nu există, așa că rulați propriul nod dacă aveți nevoie de gRPC.

URL-uri de bază​

REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657

Ce rute există​

Modulele specifice QoreChain sunt expuse prin REST sub prefixul /qorechain/<module>/v1/..., iar rute REST au doar modulele enumerate mai jos. Celelalte module sunt accesibile doar prin gRPC (vezi Module doar gRPC). Rutele standard Cosmos SDK, EVM și QoreChain Native sunt enumerate în Rute standard.

O rută care nu există răspunde cu HTTP 501 și {"code":12,"message":"Not Implemented"}. Asta înseamnă că ruta nu este servită, nu că interogarea a returnat un rezultat gol. Căile scurte fără prefixul /qorechain/ (de exemplu /bridge/v1/chains sau /pqc/v1/params) nu sunt servite. O înregistrare necunoscută pe o rută care există returnează HTTP 404 cu {"code":5,"message":"... not found"}.

Exemplele de mai jos folosesc gazda publică de mainnet; înlocuiți-o cu https://api-testnet.qore.host pentru testnet. Valorile din exemple au fost citite de pe rețelele live între 20 și 27 octombrie 2026 și se schimbă în timp; folosiți-le pentru forma unui răspuns. Versiunea v3.2.4 a adăugat câteva rute și câmpuri. Ele sunt marcate mai jos cu v3.2.4: testnet-ul le servește din 19 octombrie 2026, iar mainnet-ul din 23 octombrie 2026. Versiunea v3.2.5 (pe mainnet din 29 octombrie 2026, pe testnet din 26 octombrie) a adăugat rutele pentru parametrii și mesajele cross-VM și ruta registrului nativ de chei, marcate cu v3.2.5. Versiunea v3.2.6 (pe testnet din 27 octombrie 2026, pe mainnet din 4 noiembrie 2026) a adăugat altele, marcate cu v3.2.6: gazda de mainnet le-a răspuns cu 200 pe 4 noiembrie 2026 (o excepție este notată acolo unde se aplică). Un nod aflat încă pe o versiune mai veche răspunde la o rută nouă cu 501. Versiunea v3.2.7 (pe testnet din 6 noiembrie 2026, pe mainnet din 12 noiembrie 2026) a adăugat rutele marcate v3.2.7: multisig PQC și semnare textuală, APR de staking și identitatea clusterului SVM.

Modulul PQC​

MetodăPunct finalDescriere
GET/qorechain/pqc/v1/account/{address}Înregistrarea cheii post-cuantice pentru un cont (found, tip de cheie, algoritm)
GET/qorechain/pqc/v1/evm_window/{address}Fereastra de autorizare a benzii EVM a contului și ce a rămas din ea
GET/qorechain/pqc/v1/evm_limitsLimitele de gas EVM în vigoare (per tranzacție 30.000.000); doar pe testnet, începând cu v3.2.8; mainnet-ul nu a aplicat v3.2.8 și răspunde cu 501 (verificat pe 12 noiembrie 2026)
GET/qorechain/pqc/v1/evm_delegation_consent/{address}Consimțământul contului pentru delegarea EIP-7702, delegarea curentă și nonce-ul EVM (începând cu v3.2.2)
GET/qorechain/pqc/v1/protocol_featuresv3.2.4 (testnet din 19 octombrie 2026; mainnet din 23 octombrie 2026; 501 pe un nod mai vechi). Fiecare funcționalitate de protocol pe care o cunoaște binarul, cu indicatorii enabled, known și staged
GET/qorechain/pqc/v1/kem/{address}v3.2.5 (ambele rețele: pe mainnet din 29 octombrie 2026, pe testnet din 26 octombrie; 501 pe un nod mai vechi). Cheia de criptare ML-KEM înregistrată pentru o adresă în registrul nativ de chei: {"found":false,"key":null} când nu este înregistrată niciuna
GET/qorechain/pqc/v1/paramsv3.2.6 (testnet din 27 octombrie 2026, mainnet din 4 noiembrie 2026; 501 pe un nod mai vechi). Parametrii modulului
GET/qorechain/pqc/v1/multisig/{address}v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026; 501 pe un nod mai vechi). Înregistrarea multisig-ului hibrid post-cuantic al unei adrese: {"found":false,"multisig":null} când nu este înregistrat niciunul
POST/qorechain/pqc/v1/textual_sign_docv3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026; 501 pe un nod mai vechi; și un GET răspunde cu 501). Construiește documentul SIGN_MODE_TEXTUAL al unei tranzacții, pe care un wallet web îl afișează și îl semnează (vezi mai jos)

Rețineți că segmentul de cale este account, la singular. Nu există ruta /qorechain/pqc/v1/stats (folosiți qorechaind query pqc stats). /qorechain/pqc/v1/params este servită începând cu v3.2.6 și a răspuns cu 200 pe ambele rețele la 4 noiembrie 2026 (pe mainnet: pqc_primary true, allow_classical_fallback false, min_security_level 5, default_signature_algo_name dilithium5, hybrid_signature_mode_name required). Pe un nod mai vechi decât v3.2.6 folosiți în schimb qorechaind query pqc params.

Multisig PQC și semnare textuală (v3.2.7)​

Începând cu v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026, unde funcția de protocol pqc-multisig este activă de la înălțimea 4.164.600), un cont poate avea un multisig hibrid post-cuantic k-din-n. Mesajul este /qorechain.pqc.v1.MsgRegisterPQCMultisig; setul post-cuantic urmează membrii și cheile multisig-ului clasic curent al contului. GET /qorechain/pqc/v1/multisig/{address} returnează înregistrarea. Pe 7 noiembrie 2026 a răspuns cu 200 și {"found":false,"multisig":null} pentru un cont fără multisig (ruta cere o adresă qor1... validă; una malformată răspunde cu 400). Pe mainnet ruta este servită din 12 noiembrie 2026 (o cerere cu o adresă invalidă a răspuns cu 400, ceea ce arată că ruta este montată). Câmpurile înregistrării unui multisig înregistrat nu au fost citite aici, pentru că pe testnet nu este încă înregistrat niciun multisig.

POST /qorechain/pqc/v1/textual_sign_doc deservește wallet-urile hardware și web care semnează cu SIGN_MODE_TEXTUAL. Corpul JSON conține tx_json (tranzacția nesemnată ca șir JSON) sau tx_bytes (base64), plus chain_id, account_number, sequence și public_key (un Any cu @type și key). Răspunsul conține sign_bytes (base64, documentul de semnat) și screens, lista de linii pe care le afișează un dispozitiv (title, content, indent, expert). Pe mainnet, un corp JSON gol a răspuns cu 400 pe 12 noiembrie 2026, deci ruta este montată acolo. Un corp fără tranzacție răspunde cu 400 (tx_bytes or tx_json is required), iar o tranzacție fără niciun mesaj sau cu mai mult de 32 de mesaje este refuzată. În linia de comandă, qorechaind tx pqc cosign suportă modul de semnare textual începând cu v3.2.7 (vezi Comenzi de tranzacție).

curl -s https://api.qore.host/qorechain/pqc/v1/multisig/qor1... # or api-testnet.qore.host
curl -s -X POST https://api.qore.host/qorechain/pqc/v1/textual_sign_doc \
-H 'content-type: application/json' -d @request.json

Gazul perceput pentru verificarea unei semnături post-cuantice este de 2.000 de gaz fix per verificare începând cu v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026, comutatorul pqc-verify-gas-calibrated); vezi Istoricul versiunilor.

curl -s https://api.qore.host/qorechain/pqc/v1/account/qor1...
{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": null,
"key_type": "hybrid",
"created_at_height": "209015",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account"
}
}

classical_key_source spune de unde provine ecdsa_pubkey: stored (cheia furnizată la înregistrare), auth_account (nu a fost stocat nimic, deci este cheia publică on-chain proprie a contului) sau none. Începând cu v3.2.4 (pe testnet din 19 octombrie 2026; pe mainnet din 23 octombrie 2026) înregistrarea poartă și "possession_proven": false, care devine true odată ce o cheie a fost înregistrată cu o dovadă de posesie verificată; un nod aflat pe o versiune mai veche nu raportează acest câmp.

Un cont fără cheie înregistrată returnează {"found": false, "account": null}. Folosiți found pentru a decide dacă un cont trebuie să înregistreze o cheie înainte de a putea trimite.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_window/qor1...
{
"found": false,
"live": false,
"opened_height": "0",
"expiry_height": "0",
"max_txs": "0",
"used_txs": "0",
"max_value": "",
"used_value": "",
"remaining_blocks": "0",
"remaining_txs": "0",
"remaining_value": "",
"native_only": false,
"allowed_targets": []
}

Această rută nu eșuează niciodată pentru o adresă fără fereastră; returnează found: false. Începând cu v3.2.0, banda EVM admite o tranzacție doar de la un cont care are o cheie PQC înregistrată și o fereastră deschisă. live este true cât timp fereastra admite cel puțin încă o tranzacție la înălțimea curentă. remaining_blocks, remaining_txs și remaining_value arată care limită este cea mai aproape de epuizare; valorile sunt numere întregi uqor returnate ca șiruri de caractere. Începând cu v3.2.3, o fereastră poate purta un domeniu de aplicare: native_only (doar transferuri simple de QOR) și allowed_targets (doar destinatarii listați; limitează ce contracte și tokenuri pot fi atinse, nu cât). Vezi Dezvoltare EVM pentru modul în care funcționează banda EVM.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_delegation_consent/qor1...
{
"found": false,
"live": false,
"delegate": "",
"granted_height": "0",
"expiry_height": "0",
"current_delegate": "",
"nonce": "0"
}

O delegare EIP-7702 a unui cont intră în vigoare doar cu consimțământul post-cuantic propriu al contului (MsgAuthorizeEVMDelegation). found și live raportează un consimțământ înregistrat și încă utilizabil pentru delegate; current_delegate este delegarea pe care contul a setat-o acum, iar nonce este nonce-ul său EVM.

Modulul Bridge​

Starea read-only a modulului bridge este expusă prin REST sub /qorechain/bridge/v1/... (servește JSON on-chain real începând cu versiunea de chain v3.1.77). config-ul bridge raportează de ex. min_validators=10 și attestation_threshold=7.

MetodăPunct finalDescriere
GET/qorechain/bridge/v1/configConfigurația curentă a modulului bridge
GET/qorechain/bridge/v1/chainsListează toate chain-urile bridge înregistrate
GET/qorechain/bridge/v1/chains/{chain_id}Detalii pentru un anumit chain conectat prin bridge
GET/qorechain/bridge/v1/validatorsListează validatorii bridge înregistrați
GET/qorechain/bridge/v1/validators/{address}Detalii pentru un anumit validator bridge
GET/qorechain/bridge/v1/operationsListează operațiunile bridge
GET/qorechain/bridge/v1/operations/{id}Detalii pentru o anumită operațiune bridge
curl -s https://api.qore.host/qorechain/bridge/v1/config
{
"config": {
"min_validators": 10,
"attestation_threshold": 7,
"challenge_period_secs": "86400",
"large_transfer_threshold": "100000000000",
"enabled": true
}
}

chains/{chain_id} returnează o singură intrare, cum ar fi {"chain": {"chain_id": "ethereum", "name": "Ethereum", "chain_type": "evm", "bridge_contract": "0x000…0", "status": "pending", "min_confirmations": 12, ...}}.

Bridge-ul nu este încă live

Toate cele 37 de chain-uri bridge configurate raportează "status": "pending" pe ambele rețele, iar validators și operations sunt liste goale. Aceste rute arată configurația modulului; nu înseamnă că activele pot fi transferate prin bridge astăzi. Vezi Arhitectura Bridge.

Modulul Multilayer​

Serviciul complet de interogare al modulului multilayer este expus prin REST sub /qorechain/multilayer/v1/... (începând cu versiunea de chain v3.1.80), incluzând două interogări de citire a ancorelor de stare: anchor/{layer_id} returnează cea mai recentă ancoră de decontare pentru un layer, iar anchors/{layer_id} returnează istoricul ancorelor acestuia. Fiecare ancoră poartă o semnătură ML-DSA-87 (Dilithium-5) peste câmpurile sale canonice, astfel încât un client poate prelua o ancoră și o poate verifica independent — baza on-chain pentru chitanțele de decontare ale Rollup Development Kit-ului.

MetodăPunct finalDescriere
GET/qorechain/multilayer/v1/paramsParametrii curenți ai modulului Multilayer
GET/qorechain/multilayer/v1/layersListează toate layer-ele înregistrate
GET/qorechain/multilayer/v1/layers/{layer_id}Detalii pentru un anumit layer
GET/qorechain/multilayer/v1/anchor/{layer_id}Cea mai recentă ancoră de stare pentru un layer
GET/qorechain/multilayer/v1/anchors/{layer_id}Istoricul ancorelor de stare pentru un layer
GET/qorechain/multilayer/v1/routing-statsStatistici de rutare a tranzacțiilor între layere

Un StateAnchorView conține layer_id, layer_height, state_root, validator_set_hash, main_chain_height, anchored_at, pqc_aggregate_signature, transaction_count și compressed_state_proof. Începând cu v3.2.2, mesajul semnat este mesajul de ancoră v2: eticheta de domeniu qorechain-multilayer-anchor-v2, apoi id-ul chain-ului, id-ul layer-ului, înălțimea layer-ului, rădăcina stării, hash-ul setului de validatori, numărul de tranzacții și dovada de stare comprimată, fiecare câmp de lungime variabilă fiind prefixat cu lungimea sa pe 8 octeți big-endian (mesajul v1 anterior nu avea id de chain și nici prefixe de lungime, așa că o semnătură era validă pe orice chain). Este verificat față de cheia PQC înregistrată a creatorului layer-ului. qorechaind query rdk anchor-sign-bytes afișează octeții pentru un batch de rollup. Un layer fără ancoră returnează HTTP 404 (no anchor for layer ...) de la anchor/{layer_id} și o listă goală ({"anchors": []}) de la anchors/{layer_id}.

curl -s https://api.qore.host/qorechain/multilayer/v1/params
{
"params": {
"max_sidechains": "10",
"max_paychains": "50",
"min_anchor_interval": "100",
"max_anchor_interval": "1000",
"default_challenge_period": "86400",
"min_sidechain_stake": "1000000000",
"min_paychain_stake": "100000000",
"routing_enabled": true,
"routing_confidence_threshold": "0.6",
"cross_layer_fee_bundling": true
}
}

La momentul scrierii, layers este o listă goală pe ambele rețele. Exemplul este răspunsul de pe mainnet; pe testnet max_sidechains este 64 (mărit prin propunerea de guvernanță 16, aprobată la 25 octombrie 2026, pentru evenimentul builderilor).

Modulul Burn​

Starea read-only a modulului burn este expusă prin REST sub /qorechain/burn/v1/.... params-urile de burn includ de ex. gas_burn_rate=0.30.

MetodăPunct finalDescriere
GET/qorechain/burn/v1/paramsParametrii curenți ai modulului Burn
GET/qorechain/burn/v1/statsTotalul cumulat ars, defalcat pe sursă
GET/qorechain/burn/v1/recordsListează înregistrările recente de burn
GET/qorechain/burn/v1/milestoneProgresul milestone-ului de burn (numărul cumulat de tranzacții)
GET/qorechain/burn/v1/stranded_rewardsPartea stakerilor pusă deoparte și încă neeliberată de guvernanță
curl -s https://api.qore.host/qorechain/burn/v1/stats
{
"stats": {
"total_burned": "31574710367921",
"burns_by_source": {
"gas_fee": "31574710282421",
"failed_tx": "85500",
"milestone": "0",
"amm": "0",
"xqore_penalty": "0"
},
"last_burn_height": "3666968"
}
}

Răspunsul real listează fiecare sursă de burn (ai_service, amm, auto_buyback, bridge_fee, contract_create, failed_tx, gas_fee, milestone, rollup_create, tge, treasury_buyback, xqore_penalty și, începând cu v3.2.4, staking_tier_penalty, penalizarea de deblocare anticipată a unei blocări de staking-tier, care este arsă); exemplul este redus. Sumele sunt în uqor. failed_tx este nenul de la upgrade-ul v3.2.2, când burn-ul tranzacțiilor eșuate a început să se aplice taxei efectiv percepute. Începând cu v3.2.3, vechile records per burn sunt șterse (pruned), așa că records este o fereastră recentă, nu istoricul complet; totalurile din stats sunt cumulate.

curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
{ "reserved": "0", "released": "10500542706858", "initialized": true, "snapshot_height": "2981742" }

reserved este ce a mai rămas de eliberat, released este cât a mutat deja guvernanța, iar snapshot_height este înălțimea upgrade-ului v3.2.0 care a înregistrat rezerva. Valorile de mai sus sunt cele citite la 23 octombrie 2026: guvernanța a eliberat prima sumă (6.693.045,921330 QOR) la 19 octombrie 2026, upgrade-ul v3.2.3 a recalculat rezerva rămasă la înălțimea sa (3.807.496,785528 QOR), iar propunerea de guvernanță 12 a eliberat acea sumă (aprobată, votul s-a încheiat la 21 octombrie 2026), deci rezerva este acum goală, iar released totalizează 10.500.542,706858 QOR. Citiți valorile live. Vezi Tokenomics.

Modulul Abstract Account​

Serviciul de interogare abstract-account este expus prin REST sub /qorechain/abstractaccount/v1/... (începând cu versiunea de chain v3.1.85), incluzând schema de permisiuni folosită pentru a valida scopurile autentificatorilor fără hardcodare.

MetodăPunct finalDescriere
GET/qorechain/abstractaccount/v1/configConfigurația modulului (feature-probe: enabled)
GET/qorechain/abstractaccount/v1/accountsListează conturile abstracte
GET/qorechain/abstractaccount/v1/accounts/{address}Starea contului abstract pentru o adresă (404 dacă nu există)
GET/qorechain/abstractaccount/v1/permission_schemaschema_version, permissions, msg_permissions, key_management_msgs, lane_rules
GET/qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}v3.2.4 (testnet din 19 octombrie 2026; mainnet din 23 octombrie 2026; 501 pe un nod mai vechi). Secvența pe care o cheie de autentificator conectată trebuie să o semneze următoarea (nonce, linked)
curl -s https://api.qore.host/qorechain/abstractaccount/v1/config
{ "config": { "enabled": false, "max_session_keys": 10, "max_spending_rules": 5, "default_session_ttl": "86400" } }
Dezactivat pe mainnet, activat pe testnet

Exemplul de mai sus este răspunsul de pe mainnet: acolo enabled este false (iar accounts este o listă goală), deci funcții abstract-account precum cheltuirea din portofele conectate nu sunt disponibile pe mainnet. Pe testnet enabled este true începând cu propunerea de guvernanță 18 (aprobată la 27 octombrie 2026), iar accounts listează conturile create până acum (verificat la 27 octombrie 2026). Folosiți config.enabled ca feature-probe înainte de a vă baza pe acest modul. Vezi Abstractizarea contului.

Modulul AMM​

MetodăPunct finalDescriere
GET/qorechain/amm/v1/paramsParametrii curenți AMM (taxe în puncte de bază, limite)
GET/qorechain/amm/v1/poolsListează pool-urile
GET/qorechain/amm/v1/pools/{pool_id}Un pool (404 dacă este necunoscut)
GET/qorechain/amm/v1/pools/{pool_id}/lp/{address}Soldul de tokeni LP al unei adrese într-un pool
GET/qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b=Găsește pool-ul pentru o pereche de denominații (404 dacă nu există)
GET/qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in=Cotație: ieșirea pentru o intrare exactă
GET/qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out=Cotație: intrarea necesară pentru o ieșire exactă
curl -s https://api.qore.host/qorechain/amm/v1/params
{
"params": {
"swap_fee_bps": 30,
"protocol_fee_bps": 10,
"min_liquidity": "1000",
"max_pools_per_creator": 50,
"lp_token_decimals": 6,
"pool_creation_fee": "100000000",
"max_swap_impact_bps": 500,
"enabled": true
}
}

Toate cele șapte rute AMM răspund pe ambele rețele (verificat la 27 octombrie 2026). La momentul scrierii nu există pool-uri pe nicio rețea ({"pools": []}). Răspunsurile pentru intrări care nu se potrivesc cu nimic: pools/{pool_id} cu un id necunoscut returnează HTTP 404 ({"code":5,"message":"pool 1 not found"}); pool_by_denoms fără pool pentru pereche returnează 404 (no pool for uqor/foo); o cotație pentru un pool necunoscut returnează HTTP 400 cu {"code":3,"message":"pool not found"}; pools/{pool_id}/lp/{address} returnează {"balance":"0"} pentru o adresă fără poziție LP (adresa trebuie să fie o adresă bech32 qor1 validă, altfel 400). Cele două rute de cotație și pool_by_denoms își citesc intrarea din query string, deci au nevoie de parametri: fără amount_in / amount_out răspund 400 (invalid amount_in / invalid amount_out).

Pe testnet, a doua denominație de care are nevoie un pool este disponibilă: trei tokenuri de test înregistrate prin guvernanță, vezi Tokenuri de test pe testnet (Fest). Nu există un echivalent pe mainnet, a cărui singură denominație bancară este uqor.

Modulul Licence​

MetodăPunct finalDescriere
GET/qorechain/license/v1/check/{grantee}/{feature_id}Dacă grantee deține o acordare activă pentru funcționalitate (404 dacă nu)
GET/qorechain/license/v1/holders/{feature_id}Toate acordările pentru o funcționalitate
GET/qorechain/license/v1/list/{grantee}Toate acordările deținute de o adresă

O acordare (LicenseView) are grantee, feature_id, expires_at, granted_at, granted_by, suspended și metadata. check returnează și active. O interogare list sau holders fără rezultate returnează {"licenses": []}; check pentru o adresă fără acordare returnează HTTP 404 cu {"code":5,"message":"no license for <grantee>/<feature_id>"}.

curl -s https://api.qore.host/qorechain/license/v1/holders/lightnode_operator
{
"licenses": [
{
"grantee": "qor1...",
"feature_id": "lightnode_operator",
"expires_at": "0",
"granted_at": "3536305",
"granted_by": "qor1...",
"suspended": false,
"metadata": "",
"active": true
}
]
}

expires_at: "0" înseamnă că acordarea nu expiră. Începând cu v3.2.3, guvernanța poate înlocui autoritatea de licențiere care acordă aceste licențe (MsgUpdateAuthority); acordările deja făcute rămân în vigoare.

Modulul Light Node​

MetodăPunct finalDescriere
GET/qorechain/lightnode/v1/paramsParametrii de înregistrare, heartbeat și recompense
GET/qorechain/lightnode/v1/statstotal_registered, total_active, total_rewards, last_reward_height
GET/qorechain/lightnode/v1/nodesListează nodurile light înregistrate
GET/qorechain/lightnode/v1/node/{address}Un nod ({"node": null, "found": false} dacă nu este înregistrat)
GET/qorechain/lightnode/v1/rewards/{address}Recompensele acumulate pentru o adresă de operator (accumulated_rewards)
GET/qorechain/lightnode/v1/reward_poolContabilitatea pool-ului de recompense (balance, reserved, outstanding, payable, distributable, max_reward_per_block_per_node, max_reward_per_month_per_node, initialized)
curl -s https://api.qore.host/qorechain/lightnode/v1/params
{
"registration_fee": "1000000",
"heartbeat_interval": "1000",
"min_delegated_stake": "1000000000",
"reward_share": "0.030000000000000000",
"min_uptime_for_rewards": "0.800000000000000000",
"max_light_nodes": "10000",
"heartbeat_grace_period": "100"
}
curl -s https://api.qore.host/qorechain/lightnode/v1/reward_pool
{
"balance": "5645408555",
"reserved": "5645276228",
"outstanding": "130077",
"payable": "0",
"max_reward_per_block_per_node": "1713",
"distributable": "2250",
"initialized": true,
"max_reward_per_month_per_node": "2000000000",
"monthly_cap_active": true,
"last_distribution_time": "1792775155",
"last_distribution_height": "3744000"
}

reserved este partea din pool care este ținută deoparte și poate fi mutată doar printr-un vot de guvernanță. Limitele per nod sunt în uqor: max_reward_per_block_per_node este plafonul per bloc și, începând cu v3.2.3, max_reward_per_month_per_node (2000000000 uqor = 2.000 QOR pe 30 de zile) este plafonul lunar, calculat proporțional cu timpul de bloc și cu uptime-ul, astfel încât nu mai depinde de cât de repede vin blocurile. Un plafon nu este o sumă promisă. Exemplul este răspunsul live de pe mainnet citit la 23 octombrie 2026, după ce guvernanța a eliberat rezerva anterioară (propunerea 8, 19 octombrie 2026). Începând cu v3.2.4 (pe testnet din 19 octombrie 2026; pe mainnet din 23 octombrie 2026) răspunsul are în plus monthly_cap_active, last_distribution_time și last_distribution_height, iar limita unui nod începe de la propria sa înregistrare.

Înregistrarea necesită o licență

Chain-ul refuză o înregistrare de nod light fără o acordare activă a licenței lightnode_operator (holders/lightnode_operator listează acordările). La 27 octombrie 2026, stats raportează "total_registered": "1" atât pe mainnet, cât și pe testnet. Vezi Noduri Light pentru starea programului.

Modulul RDK​

Serviciul de interogare al Rollup Development Kit este expus prin REST sub /qorechain/rdk/v1/... (începând cu versiunea de chain v3.2.2; pe v3.2.0 și v3.2.1 era doar gRPC).

MetodăPunct finalDescriere
GET/qorechain/rdk/v1/paramsParametrii modulului
GET/qorechain/rdk/v1/rollupsListează rollup-urile
GET/qorechain/rdk/v1/rollup/{rollup_id}Un rollup (404 dacă este necunoscut)
GET/qorechain/rdk/v1/latest_batch/{rollup_id}Ultimul batch de decontare al rollup-ului
GET/qorechain/rdk/v1/batch/{rollup_id}/{batch_index}Un batch de decontare
GET/qorechain/rdk/v1/batches/{rollup_id}Batch-urile rollup-ului în ordinea indexului (paginat)
GET/qorechain/rdk/v1/blob/{rollup_id}/{blob_index}O înregistrare de blob de disponibilitate a datelor
curl -s https://api.qore.host/qorechain/rdk/v1/params
{
"params": {
"max_rollups": 100,
"min_stake_for_rollup": "10000000000",
"rollup_creation_burn_rate": "0.01",
"default_challenge_window": "604800",
"max_da_blob_size": "2097152",
"blob_retention_blocks": "432000",
"max_batches_per_block": 10
}
}

La momentul scrierii, rollups este o listă goală pe ambele rețele, deci rutele per rollup răspund cu 404 (de exemplu {"code":5,"message":"rollup foo not found"}). default_challenge_window este exprimat în secunde (604800). Începând cu v3.2.4, fereastra de contestare optimistă a unui lot nou trimis este măsurată în timp de bloc: pe testnet de la înălțimea 8.337.253 (19 octombrie 2026), pe mainnet de la înălțimea 3.742.566 (23 octombrie 2026). Înainte de upgrade, lanțul convertea valoarea în secunde în blocuri la un ritm fix de 6 secunde pe bloc. Pe testnet, propunerea de guvernanță 17 (aprobată la 27 octombrie 2026) a setat default_challenge_window la 3600 (o oră) și max_rollups la 200 pentru evenimentul builderilor, deci exemplul de mai sus (mainnet) diferă de testnet în această privință; rollups este în continuare goală pe testnet la momentul scrierii.

v3.2.7 (testnet din 6 noiembrie 2026; comutatorul rdk-zk-verification-key este activ pe mainnet din 12 noiembrie 2026): un rollup ZK își poate înregistra cheia de verificare cu MsgSetVerificationKey (și o poate schimba ulterior cu MsgUpdateVerificationKey), iar un lot ZK pentru un rollup fără cheie este refuzat înainte de plata taxei. Acestea sunt mesaje, nu interogări: nicio rută REST nu citește o cheie înregistrată (căile evidente au răspuns cu 501 pe 7 noiembrie 2026), iar pe testnet nu este înregistrat niciun rollup ZK (rollups este goală; nici mainnet-ul nu avea niciunul la ultima verificare, din 4 noiembrie 2026), deci înregistrarea nu a fost exersată cap-coadă aici. Vezi Istoricul versiunilor.

Modulul Inflation​

Setările de emisie și progresul sunt expuse prin REST sub /qorechain/inflation/v1/... (începând cu versiunea de chain v3.2.2). Nu sunt disponibile printr-o comandă CLI.

MetodăPunct finalDescriere
GET/qorechain/inflation/v1/paramsParametrii de emisie: emission_mode, fixed_epoch_emission, max_total_emission, epoch_length, enabled
GET/qorechain/inflation/v1/epoch_infoProgres: current_epoch, block_start, next_epoch_height, total_minted, max_total_emission, remaining_emission
curl -s https://api.qore.host/qorechain/inflation/v1/params
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info

Pe mainnet, emission_mode este "fixed", fixed_epoch_emission este "86000000000" (86.000 QOR pe epocă), epoch_length este "43200" blocuri, iar max_total_emission este "590000000000000" (590.000.000 QOR, plafonul cumulat). Acestea au fost stabilite prin propunerea de guvernanță 10 (aprobată la 19 octombrie 2026); prima epocă care folosește noua sumă fixă începe la blocul 3.672.000, iar epoch_info arată epoca în desfășurare și suma emisă până acum. Lista schedule din răspuns aparține modului inițial schedule; ea nu descrie ce emite o epocă în modul fixed. Toate sumele sunt în uqor. Testnet-ul raportează propriile valori, diferite. Începând cu v3.2.4 există un al treilea mod, target_apy, cu un câmp target_apy_bps (pe testnet din 19 octombrie 2026; pe mainnet din 23 octombrie 2026). O rețea trece la el doar printr-un vot propriu de guvernanță, deci mainnet-ul rămâne pe fixed până când un astfel de vot este aprobat (verificat la 27 octombrie 2026: încă fixed). Testnet-ul a trecut la target_apy prin propria guvernanță (propunerea 14, aprobată la 20 octombrie 2026) și raportează "emission_mode": "target_apy" la momentul scrierii, iar epoch_info arată plafonul cumulat deja atins (remaining_emission 0).

Modulul Gas Abstraction​

MetodăPunct finalDescriere
GET/qorechain/gasabstraction/v1/configTokenii de taxă acceptați, prima, plafonul de conversie per bloc
GET/qorechain/gasabstraction/v1/conversion_rate?denom=Cât valorează o unitate dintr-un token de taxă în uqor și dacă este usable
GET/qorechain/gasabstraction/v1/floatAdresa float-ului de conversie, soldurile sale și utilizarea din acest bloc
curl -s https://api.qore.host/qorechain/gasabstraction/v1/config
{
"config": {
"enabled": true,
"native_denom": "uqor",
"accepted_tokens": [
{ "denom": "uqor", "conversion_rate": "1.0", "price_source": "", "rate_expiry_height": "0",
"pool_id": "0", "min_liquidity": "", "max_deviation_bps": 0 }
],
"premium_bps": 300,
"max_tip_multiplier": 3,
"float_min": "0",
"block_conversion_cap": "0"
}
}

Lista acceptată conține doar uqor nativ pe ambele rețele, deci taxele se plătesc în uqor și nu are loc nicio conversie. Guvernanța adaugă un token (cu un pool, o lichiditate minimă și o deviație maximă între prețul mediat în timp și cel spot); o taxă plătită într-un astfel de token este convertită printr-un float de QOR și reumplută printr-un pool AMM. conversion_rate fără ?denom= răspunde cu 500 (denom is required).

Modulul RL Consensus (v3.2.6)​

Servit pe ambele rețele începând cu v3.2.6

Gateway-ul REST al modulului rlconsensus a apărut cu v3.2.6, pe care testnet-ul qorechain-diana a aplicat-o la înălțimea 8.970.638, pe 27 octombrie 2026, iar mainnet-ul la înălțimea 4.020.000, pe 4 noiembrie 2026. Pe 4 noiembrie 2026, toate cele șapte rute de mai jos au răspuns cu HTTP 200 atât pe gazda publică de mainnet, cât și pe testnet; niciuna nu are nevoie de parametri. Înainte de v3.2.6 răspundeau cu 501 ({"code":12,"message":"Not Implemented"}), iar modulul putea fi accesat doar prin gRPC.

MetodăPunct finalDescriere
GET/qorechain/rlconsensus/v1/agentStarea agentului: mode, current_epoch, total_steps, last_observation_at, last_action_at, circuit_breaker_active, blocks_since_revert
GET/qorechain/rlconsensus/v1/paramsParametrii modulului: intervalul de observare, modul agentului, limitele pașilor, fereastra și pragul circuit breaker-ului, ponderile recompensei, timpul de bloc implicit, prețul gazului și dimensiunea setului de validatori
GET/qorechain/rlconsensus/v1/observationCel mai recent vector de observație (height și 25 values)
GET/qorechain/rlconsensus/v1/rewardCel mai recent semnal de recompensă și componentele sale
GET/qorechain/rlconsensus/v1/policyRețeaua de politică stocată: epoch, updated_at, weight_count (ponderile în sine nu sunt returnate)
GET/qorechain/rlconsensus/v1/applied_paramsValorile pe care agentul le consideră aplicate: block_time_ms, gas_limit, gas_price_floor, pool_weight_rpos, pool_weight_dpos
GET/qorechain/rlconsensus/v1/last_actionAcțiunea propusă de agent la ultimul pas: height, mode, cinci values și applied
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/agent
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/last_action
{ "mode": "shadow", "current_epoch": "1", "total_steps": "209", "last_observation_at": "8975660",
"last_action_at": "8975660", "circuit_breaker_active": false, "blocks_since_revert": "0" }
{ "height": "8975660", "mode": "shadow", "values": ["-0.334711810000000000", "-0.500000000000000000",
"0.000000000000000000", "0.000000000000000000", "0.000000000000000000"], "applied": false }

Exemplele de mai sus sunt de pe testnet. Pe mainnet (verificat la 4 noiembrie 2026) agentul este în modul conservative, cu current_epoch 0, total_steps 0 și circuit_breaker_active false, policy raportează weight_count 0 (nicio politică stocată), last_action este gol (height 0, applied false), iar applied_params conține valorile implicite. Agentul face un pas la fiecare observation_interval blocuri (10). În modul shadow calculează o acțiune și o înregistrează fără să aplice nimic, deci applied este false, iar applied_params rămâne la valorile implicite (block_time_ms 5000, gas_price_floor 100, ponderile pool-urilor 0.40 și 0.35). Pe testnet, agentul a fost pornit în modul shadow, cu o politică stocată, prin propunerea de guvernanță 29 (aprobată la 27 octombrie 2026); circuit_breaker_active este false. Mainnet-ul nu a pornit agentul. Sumele și valorile sunt șiruri de caractere. Valorile aplicate sunt doar informative în această versiune: singurul cititor on-chain este precompilarea rlConsensusParams, doar pentru citire. Metodele gRPC corespunzătoare sunt AgentStatus, Params, Observation, Reward, Policy, AppliedParams și LastAction (serviciul qorechain.rlconsensus.v1.Query), iar comenzile CLI sunt în Comenzi de interogare.

Modulul Staking Tiers (v3.2.4)​

Disponibil începând cu v3.2.4

Modulul staking-tiers face parte din v3.2.4. Aceste rute sunt servite de testnet din 19 octombrie 2026 și de mainnet din 23 octombrie 2026 (propunerea de guvernanță 13, înălțimea 3.742.566). Un nod aflat pe o versiune mai veche le răspunde cu 501.

MetodăPunct finalDescriere
GET/qorechain/stakingtier/v1/paramsNivelurile de blocare, suma minimă de blocare, penalizarea pentru deblocare anticipată
GET/qorechain/stakingtier/v1/locks/{holder}Blocările unui deținător, ce acumulează fiecare în prezent și ce poate fi revendicat
GET/qorechain/stakingtier/v1/poolPool-ul de bonus: sold, sume restante, excedent și ultima decontare
GET/qorechain/stakingtier/v1/aprv3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026; 501 pe un nod mai vechi). Rata de bază de staking și bonusurile pe niveluri
GET/qorechain/stakingtier/v1/apr/{delegator}v3.2.7 (aceeași disponibilitate). La fel pentru un singur delegator: starea bonusului de nod light, delegările și rata efectivă

params listează cele trei durate de blocare (3, 6 și 12 luni) cu parametrii lor și min_lock_amount ("10000000" uqor, 10 QOR). Blocările se fac cu tx stakingtier lock (vezi Comenzi de tranzacție).

Rute APR (v3.2.7). Pe 12 noiembrie 2026, ruta de mainnet a răspuns cu 200, cu source emission, bonus_enabled true și max_total_apy_bps 2500, iar ruta delegatorului a răspuns cu 400 pentru o adresă invalidă. GET /qorechain/stakingtier/v1/apr returnează base (gross_base_apr_bps, source, computed_height, bonus_enabled, max_total_apy_bps), base_apr_bps, o listă tiers (pentru 3, 6 și 12 luni: bonus_bps 150, 300 și 500, cu valorile efective) și bonusurile de nod light și de validator (light_node_bonus_bps 200, validator_bonus_bps 300). Pe 7 noiembrie 2026, rata de bază de pe testnet era 0 (source fees_only), deci doar bonusurile pe niveluri erau nenule; ruta pool raportează pool-ul de bonus. Pentru o adresă fără delegări, ruta delegatorului răspunde cu 200, cu o listă delegations goală și o rată efectivă de 0. Fiecare cifră este o citire în puncte de bază a ceea ce a calculat lanțul la ultima decontare. Nu este garantată, se schimbă odată cu taxele și finanțarea și nu este o promisiune de randament de niciun fel.

Modulul Reputation​

Rutele REST ale modulului reputation au apărut cu chain v3.2.6 și sunt servite de ambele rețele (testnet din 27 octombrie 2026, mainnet din 4 noiembrie 2026). Verificat pe gazda publică de mainnet la 4 noiembrie 2026: /qorechain/reputation/v1/params, /validators și /validator/{address} au răspuns toate cu 200. Înainte de v3.2.6 fiecare rută răspundea cu HTTP 501 ({"code":12,"message":"Not Implemented"}), iar modulul putea fi accesat doar prin gRPC.

MetodăPunct finalDescriere
GET/qorechain/reputation/v1/paramsPonderile scorului (alpha, beta, gamma, delta), lambda și min_score
GET/qorechain/reputation/v1/validator/{address}Înregistrarea unui validator. {address} este o adresă de operator qorvaloper1... sau o adresă de consens qorvalcons1.... Câmpurile includ composite_score, stake_score, performance_score, contribution_score, time_score, uptime_blocks, missed_blocks și last_updated_height. 404 înseamnă că validatorul nu are încă un scor; un șir care nu este nici adresă de operator, nici adresă de consens răspunde cu 400
GET/qorechain/reputation/v1/validatorsÎnregistrările tuturor validatorilor cu scor (reputations)

Scorurile sunt șiruri zecimale între 0 și 1. Nodul light citește ruta per validator pentru a avertiza când un validator delegat se află sub min_reputation (vezi Recompense și monitorizare). Aceleași rute funcționează pe ambele gazde publice.

Identitatea clusterului SVM (v3.2.7)​

MetodăPunct finalDescriere
GET/qorechain/svm/v1/cluster_infov3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026; 501 pe un nod mai vechi). Identitatea clusterului SVM: chain_id, genesis_hash, caip2_chain_id (ID-ul de lanț Wallet Standard), derivation și execution_enabled

Pe 7 noiembrie 2026, testnet-ul a răspuns cu genesis_hash 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj, caip2_chain_id solana:6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zR și execution_enabled false. Genesis hash-ul este derivat din chain ID (SHA-256 al unei etichete fixe și al chain ID-ului, codat base58), deci este stabil. Aceleași valori se găsesc în getGenesisHash și getVersion din JSON-RPC SVM (vezi JSON-RPC compatibil Solana). SVM rămâne dezactivat: execution_enabled este false. Pe 12 noiembrie 2026, mainnet-ul a răspuns cu 200, cu chain_id qorechain-vladi, genesis_hash 4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSiFN9YGJNwu3er, caip2_chain_id solana:4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSi și execution_enabled false; lane-ul SVM este încă dezactivat pe mainnet.

Module doar gRPC​

Pe mainnet (versiunea de nod v3.2.7 din 12 noiembrie 2026; lista de module a fost verificată pe 4 noiembrie 2026, pe v3.2.6, cu excepția rândului svm) aceste module au un serviciu gRPC Query, dar nicio rută REST, cu excepțiile din tabel. Numele serviciilor urmează forma qorechain.<module>.v1.Query.

ModulMetode de interogare gRPC (mainnet, versiunea de chain v3.2.7)
aiConfig, Stats
crossvmPendingMessages (prin REST începând cu v3.2.5: Params la /qorechain/crossvm/v1/params și Message la /qorechain/crossvm/v1/message/{id})
reputationParams (și prin REST începând cu v3.2.6, vezi Modulul Reputation)
rlconsensusAgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction (și prin REST începând cu v3.2.6)
svmSlot, Account, Program (v3.2.7 adaugă ClusterInfo pe ambele rețele, și prin REST, vezi Identitatea clusterului SVM)
qcaConfig

Interogările rlconsensus sunt servite prin REST pe ambele rețele începând cu v3.2.6 (cu încă două metode, AppliedParams și LastAction); vezi Modulul RL Consensus. Folosiți grpcurl împotriva propriului nod sau comenzile CLI de interogare. Interogările rdk sunt disponibile și prin REST (vezi Modulul RDK); înainte de v3.2.2 erau doar gRPC.

Modulele xQORE, BTC-restaking (Babylon) și FairBlock nu au deloc serviciu de interogare în versiunea curentă, nici prin REST, nici prin gRPC. Modulele inflation și gas-abstraction, care nu aveau niciunul înainte de v3.2.2, sunt servite prin REST (vezi Modulul Inflation și Modulul Gas Abstraction).

Rute standard​

Sunt servite și rutele REST standard Cosmos SDK, IBC, EVM și QoreChain Native. Exemple verificate pe ambele rețele:

Punct finalDescriere
/cosmos/bank/v1beta1/supplyAprovizionarea totală
/cosmos/bank/v1beta1/balances/{address}Soldurile unui cont
/cosmos/staking/v1beta1/validatorsValidatori
/cosmos/staking/v1beta1/paramsParametrii de staking
/cosmos/distribution/v1beta1/paramsParametrii de distribuție
/cosmos/gov/v1/params/votingParametrii de guvernanță
/cosmos/slashing/v1beta1/paramsParametrii de slashing
/cosmos/upgrade/v1beta1/current_plan, /applied_plan/{name}Upgrade-uri în așteptare / aplicate (applied_plan/v3.2.3 returnează {"height":"3662051"} pe mainnet)
/cosmos/circuit/v1/disable_listTipurile de mesaje dezactivate la nivelul întregii rețele
/cosmos/base/node/v1beta1/configPrețul minim de gas al nodului (0.1uqor pe ambele rețele)
/cosmos/base/tendermint/v1beta1/blocks/latestUltimul bloc
/cosmos/tx/v1beta1/txs, /txs/{hash}, /txs/block/{height}Căutare / consultare tranzacții / după bloc
/cosmos/evm/vm/v1/paramsParametrii modulului EVM
/cosmos/evm/feemarket/v1/paramsParametrii pieței de taxe EVM
/cosmwasm/wasm/v1/codes/paramsPermisiunile de încărcare/instanțiere QoreChain Native
/ibc/apps/transfer/v1/paramsParametrii transferului IBC
/ibc/core/client/v2/counterparty_info/{client_id}v3.2.6. Contrapartea IBC v2 înregistrată pentru un client (404 dacă nu există)
/ibc/core/client/v2/config/{client_id}v3.2.6. Configurația clientului IBC v2 (allowed_relayers)
/cosmos/evm/erc20/v1/token_pairs, /token_pairs/{token}Perechi de tokenuri ERC20 (testnet: cele trei tokenuri de test Fest și un token IBC; mainnet: niciuna)

Prefixul QoreChain Native este /cosmwasm/wasm/v1/...; /cosmos/wasm/v1/... nu este servit.

Rutele clientului IBC v2 (v3.2.6)​

Serviciul de interogare al clientului IBC v2 era servit anterior prin gRPC, dar îi lipseau rutele REST; v3.2.6 le montează. Un relayer citește de aici contrapartea unui client. Ambele rute primesc ID-ul clientului în cale (de exemplu 07-<type>-0); un ID gol răspunde 400. Verificat pe testnet la 27 octombrie 2026 și pe mainnet la 4 noiembrie 2026:

RutăTestnetMainnet (v3.2.6)
/ibc/core/client/v2/counterparty_info/{client_id}200 cu contrapartea, sau 404 (client 07-<type>-0 counterparty not found) pentru un client fără contraparte înregistrată; un ID gol răspunde 400aceleași forme: 404 (client 07-tendermint-0 counterparty not found) pentru un client fără contraparte (mainnet-ul nu are încă niciun client IBC)
/ibc/core/client/v2/config/{client_id}200, {"config":{"allowed_relayers":[]}} (o listă goală înseamnă orice relayer)200, {"config":{"allowed_relayers":[]}}
/ibc/core/channel/v2/clients/{client_id}/next_sequence_send, /packet_commitments și celelalte rute de canal IBC v2răspund (404 când nu este înregistrat nimic pentru client, 200 cu o listă goală pentru commitments)răspund, aceleași forme (verificat la 4 noiembrie 2026)

Rutele IBC v1 (/ibc/core/client/v1/..., /ibc/core/channel/v1/...) răspund pe ambele rețele. La momentul scrierii, testnet-ul are un client IBC și un canal de transfer deschis (channel-0, cu un token denominat IBC), iar mainnet-ul nu are niciun client IBC, canal sau token denominat IBC. Modulul de rate-limit răspunde la /Stride-Labs/ibc-rate-limiting/ratelimit/ratelimits, iar lista de checksum-uri 08-wasm la /ibc/lightclients/wasm/v1/checksums: pe ambele rețele prima returnează o listă rate_limits goală (nu este setată nicio limită), iar a doua o listă checksums goală. Mainnet-ul a răspuns la ambele cu 200 pe 4 noiembrie 2026 (înainte de v3.2.6 răspundea cu 501). Ruta de interogare packet-forward /ibc/apps/packetforward/v1/params a răspuns 501 pe mainnet; nu s-a găsit nicio rută publică pentru ea, deci setările sale nu pot fi citite prin REST acolo.

Tokenuri de test pe testnet (Fest)​

Doar pe testnet, fără valoare

Cele trei tokenuri de mai jos există doar pe testnet-ul qorechain-diana. Sunt tokenuri de test pentru builderi: nu au valoare, iar mainnet-ul nu are nicio pereche de tokenuri ERC20 (verificat la 27 octombrie 2026: token_pairs este goală, iar aprovizionarea bancară conține doar uqor). Guvernanța le-a înregistrat ca perechi de tokenuri ERC20 la 27 octombrie 2026 (propunerea 26).

Pe testnet, un token ERC20 înregistrat există și ca monedă bancară, deci poate fi deținut, trimis și folosit ca a doua denominație a unui pool AMM. Denominația bancară este erc20: urmat de adresa contractului în forma checksum EIP-55 cu majuscule și minuscule mixte, iar șirul denom este sensibil la majuscule: scrierea integral cu minuscule este un alt șir și nu este găsită.

TokenAdresa contractuluiDenom bancarZecimale
fUSD (FestUSD)0x97143B771D34ddb9130b807b135Ae675A5a963CAerc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA6
fETH (FestETH)0x02292293c13880a26242690eb70a0e42B8E91c28erc20:0x02292293c13880a26242690eb70a0e42B8E91c2818
fBTC (FestBTC)0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451Aerc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A8
# the three tokens and their display names / decimals
curl -s https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata
# one denom: the case matters (this returns the metadata, the lowercase spelling returns 404)
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata/erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
# the ERC20 token pairs, and the supply of one denom
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/supply/by_denom?denom=erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"

denoms_metadata listează fiecare token cu symbol fUSD / fETH / fBTC, display FestUSD / FestETH / FestBTC și zecimalele ca exponent al unității de afișare. O interogare de sold (/cosmos/bank/v1beta1/balances/{address}) arată partea convertită din soldul unui deținător sub denom-ul erc20:...; tokenurile încă deținute pe partea EVM apar în balanceOf al contractului ERC20 însuși. Conversia între cele două forme se face cu MsgConvertERC20 (EVM către bank) și MsgConvertCoin (bank către EVM); expeditorul lui MsgConvertERC20 trebuie scris ca adresă bech32 qor1. Vezi Dezvoltare EVM.

Reflecție gRPC​

Un nod pe care îl rulați singur servește gRPC pe portul 9090. Acolo unde reflecția serverului este activată, unelte precum grpcurl pot descoperi serviciile disponibile:

grpcurl -plaintext localhost:9090 list

Pentru a interoga un anumit serviciu:

grpcurl -plaintext -d '{"address":"qor1..."}' localhost:9090 qorechain.pqc.v1.Query/Account

qorechain.pqc.v1.Query are trei metode pe un nod v3.2.3, Account, EVMWindow și EVMDelegationConsent, și o a patra începând cu v3.2.4 (testnet din 19 octombrie 2026, mainnet din 23 octombrie 2026), ProtocolFeatures. O metodă Params este adăugată în v3.2.6 (testnet din 27 octombrie 2026, mainnet din 4 noiembrie 2026); un nod mai vechi decât v3.2.6 nu are metoda Params. Versiunea v3.2.7 (pe ambele rețele) adaugă rutele pentru multisig și documentul textual descrise în Multisig PQC și semnare textuală.

Autentificare​

Toate punctele finale REST și gRPC sunt neautentificate implicit. Pentru implementările de producție, plasați un reverse proxy (de ex. Nginx sau Caddy) în fața nodului pentru a gestiona terminarea TLS și controlul accesului.