Întrebări frecvente și depanare
Este mainnet-ul activ?
Da. Mainnet-ul este activ (chain id qorechain-vladi, activ din 7 iunie 2026)
și rulează versiunea de chain v3.2.7 (aplicată la înălțimea 4.164.600 pe 12 noiembrie 2026, propunerea de guvernanță 16; v3.2.6 a fost aplicată la înălțimea 4.020.000 pe 4 noiembrie 2026, propunerea 15; v3.2.5 a fost aplicată la înălțimea 3.906.833 pe 29 octombrie 2026 și v3.2.4 la înălțimea 3.742.566 pe 23 octombrie 2026); testnet-ul rulează v3.2.6 din 27 octombrie 2026, v3.2.7 din 6 noiembrie și v3.2.8 din 12 noiembrie 2026 (înălțimea 9.929.500; mainnet-ul nu a aplicat-o). Presetul de testnet
(qorechain-diana) rămâne de asemenea disponibil. Începând cu SDK 0.12.0, ambele preseturi folosesc implicit
endpoint-urile publice; selectați rețeaua cu
createClient({ network: "mainnet" }) și suprascrieți endpoints doar pentru
propriul nod. Vedeți
Rețea și endpoint-uri.
De ce apelurile mele merg către localhost?
Folosiți un SDK anterior lui 0.12.0, ale cărui preseturi folosesc implicit endpoint-uri localhost:
actualizați-l sau transmiteți un obiect endpoints. Începând cu 0.12.0, createClient() și
createClient({ network: "mainnet" }) folosesc endpoint-urile publice, iar presetul
localnet este cel care folosește localhost.
const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});
Dacă în schimb primiți „endpoint ... is not configured for the mainnet preset”, apelul
are nevoie de un endpoint pe care presetările publice nu îl setează (gRPC, un RPC SVM, WebSocket-ul
EVM de mainnet); transmiteți-l în endpoints.
Calea de semnare (connectTx) are nevoie de endpoint-ul de consens rpc;
citirile QoreChain Native îl folosesc de asemenea. Citirile REST folosesc rest;
apelurile EVM folosesc evmRpc (la fel și apelurile qor_, pe un nod care
servește acel namespace). URL-urile de mainnet se găsesc în
referința de rețea.
„Cannot find module 'viem'" / „'@solana/web3.js'"
Acestea sunt peer dependencies pentru @qorechain/evm și respectiv
@qorechain/svm. Instalați-le în proiectul dvs.:
npm i @qorechain/evm viem
npm i @qorechain/svm @solana/web3.js
Un apel de precompile aruncă „returned no data" / „feature not present"
Precompile-urile EVM QoreChain sunt compilate în nod, dar nu sunt active
pe mainnet, iar pe testnet sunt active doar trei: răspund doar acolo unde
adresele lor sunt listate în parametrul active_static_precompiles al modulului
EVM. Lista aceea este goală pe mainnet; pe testnet conține precompile-urile PQC
verify (0x…0A01), PQC key status (0x…0A02) și consensus-parameters (0x…0C01)
(verificat la 27 octombrie 2026; lista testnet-ului conținea și puntea cross-VM 0x…0901 din 4 noiembrie și pe 7 noiembrie 2026, activă cu o listă de permisiuni (testată cu eth_call), iar lista mainnet-ului era în continuare goală), așa că perechea AI tot nu
răspunde nimic acolo. Acolo unde un precompile este inactiv, apelul returnează date
goale, așa că viem raportează returned no data ("0x"), iar funcția ajutătoare
aruncă o eroare (vedeți
Precompile-uri EVM: starea în rețea).
Pe un nod EVM obișnuit apelurile eșuează în același mod. Verificați
GET /cosmos/evm/vm/v1/params și înveliți fiecare apel de precompile pentru ca
eroarea să fie tratată per apel.
Apelul meu client.qor eșuează cu -32601
client.qor apelează namespace-ul JSON-RPC qor_, pe care nicio versiune
publicată a nodului nu îl servește; rpc_modules pe endpoint-urile EVM publice
listează doar eth, net, rpc, txpool și web3. Folosiți în schimb o rută
REST, de exemplu GET /qorechain/pqc/v1/account/{address} (starea cheii PQC) sau
GET /qorechain/burn/v1/stats, prin client.rest.get(...). Vedeți
namespace-ul qor_.
Sumele mele sunt greșite cu un factor de un milion
QOR are unități de bază uqor de 10^6. Folosiți toBase / fromBase și
faceți toate calculele în unități de bază:
toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"
Rețineți că runtime-ul EVM reprezintă QOR cu 18 zecimale (convenția EVM),
ceea ce este diferit de baza uqor Native de 10^6.
Ce pachete sunt publicate și unde?
Toate (verificat la 12 noiembrie 2026). Nucleul TypeScript (@qorechain/sdk, 0.14.0),
kitul React (@qorechain/react, 0.14.0), scaffolder-ul create-qorechain-dapp
(0.14.0, care poartă și corecțiile de șabloane din 0.13.1) și adaptoarele EVM/SVM (@qorechain/evm, @qorechain/svm, 0.14.0) sunt pe
npm; clientul Python este pe PyPI (pip install qorechain-sdk la 0.14.0, import
qorsdk); clientul Go este pe module proxy
(go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0); clientul Rust este
pe crates.io (cargo add qorechain-sdk, 0.14.0); iar clientul Java este pe Maven
Central (io.github.qorechain:qorechain-sdk, 0.14.0, JDK 17 sau mai nou). Vedeți Instalare pentru comenzile complete
pentru fiecare limbaj.
Mnemonicul meu este respins
SDK-ul validează atât lista de cuvinte BIP-39, cât și suma de control
înainte de a deriva orice cheie, astfel încât o frază cu greșeli de tastare
aruncă o eroare în loc să producă în tăcere contul greșit. Verificați din nou
cuvintele; folosiți validateMnemonic pentru a testa o frază.
Tranzacții hibride (PQC)
Trimiterea hibridă (clasic + ML-DSA-87) este activă și obligatorie pe calea
Native — tranzacțiile Native doar clasice sunt respinse on-chain (chain
v3.2.0). Înainte ca o tranzacție hibridă să treacă verificarea PQC, cheia
publică PQC a semnatarului trebuie să fie înregistrată explicit cu
MsgRegisterPQCKeyV2 (o tranzacție semnată clasic, exceptată de la cerința
hibridă); încorporarea cheii publice în extensie
(includePqcPublicKey: true) nu o înregistrează, iar lanțul nu înregistrează
o cheie la prima utilizare. În TypeScript, dați clientului perechea de chei
(client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 sau mai nou) și fiecare tranzacție pe
care o trimite este semnată hibrid.
Lanțul acceptă orice semnătură ML-DSA-87 validă conform FIPS-204, hedged sau
deterministă. SDK-ul semnează determinist în mod implicit (începând cu 0.5.1)
pentru ca o tranzacție să aibă mereu aceeași semnătură și același hash de tx.
Dacă o tx hibridă eșuează cu pqc cod 21 (hybrid_verify_failed), cauza este
versiunea sign-bytes, chain-id-ul, o bibliotecă PQC învechită sau o cheie
neînregistrată ori diferită, niciodată semnarea hedged.
Ambele rețele verifică forma v2 a sign-bytes, așa că folosiți SDK 0.8.1 sau
mai nou (0.14.0 este cel curent) și transmiteți rest (sau signBytesVersion):
builder-ele aruncă o eroare pe qorechain-vladi / qorechain-diana dacă lipsesc
amândouă. Vedeți
Depanarea codului 21 și
Conturi și semnare PQC.
Tranzacția mea EVM este refuzată cu „no open EVM authorisation window"
Începând cu chain v3.2.0, lane-ul EVM admite o tranzacție doar de la un cont care
are o cheie PQC înregistrată și o fereastră de autorizare deschisă. Înregistrați o
cheie, deschideți o fereastră, apoi trimiteți. Vedeți
Fereastra de autorizare EVM. Cu SDK-ul,
classifyEvmWindowRejection(err) returnează "no-pqc-key", "no-window",
"exhausted" sau "invalid".
Tranzacțiile mele hibride eșuează la CheckTx cu o eroare de parsare a tranzacției
Actualizați SDK-ul. Versiunile 0.6.0 și anterioare serializau în JSON
extensia de corp de tranzacție /qorechain.pqc.v1.PQCHybridSignature, pe care
decodorul de tranzacții al lanțului o respinge la CheckTx. Începând cu
0.6.1 extensia este codificată protobuf (valoarea începe cu 0x08) în
toate cele cinci limbaje — tranzacțiile hibride construite cu versiuni mai
vechi sunt respinse on-chain, pe fiecare cale (inclusiv eth-native).
Cu ce versiuni de chain funcționează SDK-ul?
SDK 0.12.0 este versiunea de client pentru chain v3.2.5 (mainnet din 29 octombrie
2026, la înălțimea 3.906.833; testnet din 26 octombrie). Mainnet-ul rulează v3.2.7
(din 12 noiembrie), iar testnet-ul v3.2.8 (din 12 noiembrie; v3.2.7 din 6 noiembrie, v3.2.6 din 27 octombrie); formatul de semnare nu s-a
schimbat până la v3.2.7, așa că 0.12.0 funcționează pe mainnet. 0.12.0 nu are constructori pentru adăugirile v3.2.7 (înregistrarea multisig PQC, modul de semnare textual, APR, identitatea clusterului și mesajele de cheie de verificare), care sunt pe mainnet din 12 noiembrie 2026, iar calea sa de semnare nu a fost reverificată față de v3.2.7; folosiți CLI-ul pentru ele. Adaugă regula exactă de gaz pentru
tranzacțiile hibride, constructorii și citirea registrului de chei ML-KEM, citirile
de cont abstract și constructorii verificați pentru parametrii de guvernanță (vedeți
Ce adaugă 0.12.0), peste ce a adăugat 0.10.0 pentru v3.2.4
(constructorii și citirile pentru staking-tier, fetchAuthNonce și citirile de
protocol-feature, vedeți Ce a adăugat 0.10.0) și 0.9.0 pentru
v3.2.2 și v3.2.3: constructori pentru dovada de
posesie opțională la înregistrare (atașată automat de ensurePqcRegistered odată ce
rețeaua a aplicat v3.2.3), pentru ferestrele EVM cu domeniu limitat și pentru mesajele
de consimțământ EIP-7702.
SDK 0.8.1 sau mai nou tranzacționează de asemenea pe ambele rețele (forma v2 a
sign-bytes hibride, înregistrarea, trimiterile hibride și fereastra EVM funcționează
neschimbat), dar nu are niciunul dintre acei constructori: folosiți CLI-ul pentru ei
(vedeți
Versiuni anterioare lui 0.9.0). Formatul de semnare nu s-a schimbat
în v3.2.4, v3.2.5 sau v3.2.6. Mainnet-ul rulează v3.2.7, iar testnet-ul v3.2.8 (testnet-ul a aplicat v3.2.5 pe 26 octombrie 2026,
v3.2.6 pe 27 octombrie, v3.2.7 pe 6 noiembrie și v3.2.8 pe 12 noiembrie; mainnet-ul a aplicat v3.2.5 pe 29 octombrie, v3.2.6 pe 4 noiembrie și v3.2.7 pe 12 noiembrie). SDK 0.10.0 și 0.9.0 continuă să funcționeze pe ele, dar nu au constructori pentru
adăugirile v3.2.5 (registrul de chei ML-KEM, regula exactă de gaz); cu acele versiuni folosiți CLI-ul sau actualizați la 0.14.0. 0.12.0 a fost construit și verificat împotriva v3.2.5.
Înregistrarea cheii mele PQC a fost refuzată, dar taxa a fost luată
O înregistrare pentru un cont care deține deja o cheie este refuzată de chain după
ce taxa a fost dedusă. ensurePqcRegistered din 0.9.0 și ulterior citește mai întâi
GET /qorechain/pqc/v1/account/{address} (transmiteți rest), omite înregistrarea
când cheia acestei perechi de chei este înregistrată și aruncă PqcKeyMismatchError
când este înregistrată alta. Versiunile anterioare nu verificau mai întâi, decât dacă
transmiteați dvs. status: { registered: found }, unde found provine din acea rută.
Începând cu v3.2.3, chain-ul refuză de asemenea cheile slabe, degenerate și
refolosite; cheile de la derivePqcCanonical sau tx pqc gen-key sunt în regulă.
create-qorechain-dapp instalează un SDK care nu poate semna
Doar versiunea 0.8.0 a scaffolder-ului: scria intervale ^0.3.0 pentru
@qorechain/sdk și @qorechain/evm, iar un interval caret pe o versiune 0.x rămâne
în interiorul lui 0.3. Versiunea 0.9.0 și cele ulterioare generează proiectul pe SDK-ul curent; dacă ați
folosit 0.8.0, rulați npm i @qorechain/sdk@latest (și @qorechain/evm@latest) după
generarea proiectului.
VERSION spune 0.8.0, dar am instalat 0.8.3
Constanta exportată VERSION din 0.8.3 nu a fost actualizată și raportează 0.8.0;
începând cu 0.9.0 corespunde pachetului. În versiunile anterioare, citiți versiunea
instalată din package.json.
Cheltuirea mea prin authenticator este respinsă cu authenticator_replay
(Modulul abstractaccount este dezactivat pe mainnet; acolo o cheltuire
este refuzată cu abstract account module is disabled înainte de verificarea
oricărui nonce. Este activat pe testnet. Vedeți Authenticators și cheltuire delegată.
Indicațiile de mai jos se aplică oriunde modulul este activat.)
Nonce-ul este greșit. Atât MsgExecuteEVM.nonce, cât și MsgExecuteCosmos.nonce
sunt secvența de authenticator a cheii legate pentru (account, pubkey): un
contor pe care chain-ul îl ține pentru fiecare cheie legată, pornind de la 0 și
incrementat la fiecare execuție reușită. Nu este nonce-ul EVM al contului. Citiți-l cu fetchAuthNonce (SDK 0.10.0 sau mai nou, chain
v3.2.4 sau mai nou) sau urmăriți-l pentru fiecare cheie legată pe versiunile mai vechi.
Începând cu v3.2.3, lane-ul EVM semnează și evmAuthSignBytesV2, care leagă limita
de gas a apelului (resolveEvmAuthDigestVersion alege forma). Folosiți contorul pe
care îl citiți (sau îl urmăriți) pentru acea cheie și semnați din nou.
Alte eșecuri ale authenticator-ului se decodează prin decodeTxError: codurile
abstractaccount 5 (spending_limit_exceeded), 6 (session_key_expired) și
10 (permission_denied). Vedeți
Authenticators și cheltuire delegată.