Passa al contenuto principale

Configurazione del wallet

QoreChain supporta diversi tipi di wallet nei suoi ambienti di esecuzione nativo, EVM e SVM. Scegli il wallet più adatto al tuo caso d'uso.

nota

I valori riportati di seguito coprono sia la mainnet qorechain-vladi (chain ID EVM 9801, attiva dal 7 giugno 2026) sia la testnet qorechain-diana (chain ID EVM 9800). Gli endpoint pubblici di entrambe le reti sono elencati in Reti.

Wallet Keplr​

Keplr è il wallet consigliato per le transazioni native su QoreChain, lo staking e la governance.

Aggiungere QoreChain come chain personalizzata​

Apri Keplr e vai su Settings > Add Custom Chain, quindi inserisci:

CampoMainnetTestnet
Nome della chainQoreChainQoreChain Diana Testnet
Chain IDqorechain-vladiqorechain-diana
URL RPChttps://rpc.qore.hosthttps://rpc-testnet.qore.host
URL RESThttps://api.qore.hosthttps://api-testnet.qore.host
Prefisso Bech32qorqor
Denominazione della monetaQORQOR
Denominazione minima della monetauqoruqor
Decimali66
Coin Type (BIP-44)118118

Dopo aver aggiunto la chain, Keplr genera un indirizzo qor1... per il tuo account.

Prezzo minimo del gas

Il prezzo minimo del gas della rete è 0.1uqor. Se configuri i livelli di prezzo del gas di Keplr (ad es. tramite suggestChain), usa valori pari o superiori a 0.1 (valori basso/medio/alto suggeriti: 0.1 / 0.15 / 0.25) — le transazioni firmate sotto la soglia minima vengono rifiutate.

MetaMask (EVM)​

MetaMask consente di interagire con l'ambiente di esecuzione EVM di QoreChain — distribuire contratti Solidity, gestire token ERC-20 e utilizzare i consueti strumenti Ethereum.

Aggiungere QoreChain come rete personalizzata​

Apri MetaMask e vai su Settings > Networks > Add Network, quindi inserisci:

CampoMainnetTestnet
Nome della reteQoreChainQoreChain Diana Testnet
URL RPChttps://evm.qore.hosthttps://evm-testnet.qore.host
Chain ID98019800
Simbolo della valutaQORQOR
URL del block explorerhttps://explore.qore.networkhttps://explore.qore.network

Il QOR nativo ha 18 decimali sull'interfaccia EVM (in stile wei). Una volta connesso, puoi usare MetaMask per firmare transazioni EVM, interagire con gli smart contract distribuiti e gestire token ERC-20 su QoreChain.

Registrazione della rete con una sola chiamata​

Per le dApp, i pacchetti @qorechain/wallet-adapter e @qorechain/connect (pubblicati su npm) registrano QoreChain nel wallet dell'utente con una sola chiamata — chiedendo a MetaMask di aggiungere la rete tramite EIP-3085 (con il QOR nativo corretto a 18 decimali sul binario EVM) e configurando il livello di prezzo del gas di Keplr:

npm install @qorechain/wallet-adapter @qorechain/connect
import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";

await addQoreEvmToWallet(); // prompts MetaMask with QoreChain's EVM network params

Un account, tre indirizzi (account unificati)​

A partire dalla versione della chain v3.1.83, un account QoreChain è un'unica identità a 20 byte con tre codifiche: qor1… (Native), 0x… (EVM) e una forma base58 (SVM). Possiede un unico saldo e — per gli account eth-native — firma su tutte e tre le corsie con un'unica chiave, inclusa la firma ibrida post-quantistica richiesta sul percorso Native.

Genera un wallet unificato in codice con @qorechain/wallet-adapter:

import { generateQoreWallet } from "@qorechain/wallet-adapter";

const w = await generateQoreWallet();          // or walletFromMnemonic(mnemonic)
console.log(w.addresses.cosmos);               // qor1...
console.log(w.addresses.evm);                  // 0x... (same identity)
console.log(w.addresses.svm);                  // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid).

I fondi inviati a una qualsiasi delle tre forme confluiscono nello stesso saldo.

Wallet collegati: Phantom e MetaMask come chiavi di spesa​

A partire dalla versione della chain v3.1.85, non è necessario esporre la propria chiave radice per spendere da un account QoreChain in una dApp. Una chiave Phantom (ed25519) o MetaMask (tramite il suo indirizzo Ethereum, via personal_sign) può essere registrata come authenticator sul tuo account — con permessi delimitati, limiti di spesa, una scadenza e revoca istantanea — e quindi autorizzare trasferimenti inoltrati dal backend della dApp. Consulta Linked Wallet Authenticators per il modello completo e il codice, e la guida agli authenticator dell'SDK per esempi end-to-end.

Wallet Solana (SVM)​

L'ambiente di esecuzione SVM di QoreChain è compatibile con gli strumenti Solana standard, e il saldo di QOR nativo dell'account è visibile direttamente sull'interfaccia SVM (in lamports, 9 decimali; 1 uqor = 1.000 lamports). Connetti qualsiasi wallet o libreria compatibile con Solana.

Usare @solana/web3.js​

import { Connection } from "@solana/web3.js";

// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);

Gli endpoint SVM pubblici sono di sola lettura; l'invio di transazioni richiede un nodo proprio. Consulta SVM Development per i dettagli.

Wallet con supporto PQC (obbligatorio sul percorso Cosmos)​

QoreChain richiede la crittografia ibrida post-quantistica (PQC) sul percorso di transazione cosmos. A partire dalla versione attuale della chain (v3.1.82), il valore predefinito della rete è hybrid_signature_mode = required con allow_classical_fallback = false — quindi ogni transazione sul percorso cosmos deve includere una firma ML-DSA-87 (Dilithium-5) accanto alla firma standard secp256k1 (ECDSA). Le transazioni cosmos con la sola firma classica provenienti da un account PQC vengono rifiutate.

Le tx Cosmos richiedono l'estensione ibrida PQC

L'invio di una semplice transazione classica sul percorso cosmos verrà rifiutato. Devi allegare la firma Dilithium-5 come estensione di transazione PQCHybridSignature. Gli strumenti standard CosmJS / Keplr non producono questa estensione da soli — usa il comando CLI qorechaind tx pqc cosign, la firma ibrida dell'SDK QoreChain (vedi sotto) oppure, per costruirla tu stesso in codice, la libreria open source qorechain-pqc (hybridSignBytes). Le uniche esenzioni sono le gentx di genesi e le transazioni di registrazione/migrazione delle chiavi PQC.

Come funziona​

I wallet allegano una firma PQC ML-DSA-87 come estensione di transazione accanto alla firma standard secp256k1 (ECDSA). La firma classica viene calcolata su sign bytes che escludono l'estensione, così rimane valida per la verifica classica mentre la firma PQC fornisce la resistenza quantistica.

Generare una chiave Dilithium-5​

Genera una chiave post-quantistica per la firma ibrida:

qorechaind tx pqc gen-key

Registrazione automatica​

Quando includi una chiave pubblica PQC nella tua prima transazione, QoreChain la registra automaticamente on-chain. Non è necessario alcun passaggio di registrazione separato. (Le transazioni di registrazione/migrazione delle chiavi PQC sono a loro volta esenti dal requisito ibrido, così un account può inizializzare la sua prima chiave.)

Firma ibrida con l'SDK​

L'SDK QoreChain produce transazioni cosmos conformi tramite buildHybridTx con includePqcPublicKey: true, che allega l'estensione Dilithium-5 e incorpora la chiave pubblica per la registrazione automatica. Consulta SDK Accounts & PQC signing.

Modalità PQC​

Le tre modalità di applicazione restano controllate dalla governance; il valore predefinito attuale della rete è Required:

ModalitàDescrizione
DisabledLa verifica PQC è disattivata. Solo firme standard.
OptionalLe transazioni possono includere firme PQC. Se presenti, vengono verificate.
Required (predefinita)Tutte le transazioni sul percorso cosmos devono includere una firma PQC valida.

La modalità attiva è configurata a livello di chain e può essere aggiornata tramite governance.

EVM / MetaMask non interessati

Il flusso MetaMask (EVM) descritto sopra non è interessato dal requisito ibrido. Le transazioni EVM usano un percorso ante eth_secp256k1 separato e non hanno mai bisogno dell'estensione PQC.

Wallet da CLI​

Il binario qorechaind include un sistema integrato di gestione delle chiavi per l'uso da riga di comando.

Creare una nuova chiave​

qorechaind keys add mykey

Questo comando genera una nuova coppia di chiavi e mostra la frase mnemonica. Conserva la mnemonica in modo sicuro — è l'unico modo per recuperare questa chiave.

Visualizzare il tuo indirizzo​

qorechaind keys show mykey -a

Questo comando restituisce il tuo indirizzo bech32 qor1....

Elencare tutte le chiavi​

qorechaind keys list

Importare una chiave esistente​

qorechaind keys add mykey --recover

Ti verrà chiesto di inserire la tua frase mnemonica.

Prossimi passi​