Sviluppatori

La pagina Developers (/developers, barra laterale gruppo Build, voce Developers) è una pagina pubblica di strumenti per sviluppare su QoreChain. Non richiede un account. Ha sette schede: SDKs, Transaction inspector, PQ key status, Simulator, Signing playground, QoreX test wallet e AI agents (MCP). Insieme ti permettono di trovare e installare il pacchetto giusto, leggere qualsiasi transazione confermata e vedere se il suo livello post-quantistico si verifica, verificare quale chiave post-quantistica ha registrato un account e se la sua finestra di autorizzazione EVM è aperta, simulare a vuoto una transazione firmata, fare pratica con la firma ibrida usando una chiave usa e getta e mettere alla prova una dApp con un wallet QoreX fittizio, il tutto nel browser. È pensata per sviluppatori di dApp, wallet e backend. Per le librerie stesse vedi Pacchetti per sviluppatori, la Panoramica SDK e Installazione.

Innovazioni

• Un gateway di sola lettura verso la chain. Gli strumenti leggono dati pubblici della chain e simulano una transazione tramite un gateway di sola lettura sotto i percorsi di query cosmos/, cosmwasm/ e qorechain/ più la chiamata di simulazione. Nulla nella pagina può trasmettere una transazione. Il gateway esiste perché gli endpoint REST della chain non inviano intestazioni CORS per il browser.
• Chiavi che non lasciano mai il browser. Le chiavi del signing playground e del test wallet sono generate nel tuo browser e conservate solo in memoria. Non vengono mai salvate né inviate, e scompaiono al ricaricamento. Queste due schede sono solo testnet e rifiutano la mainnet.
• La libreria di firma di produzione, non una demo. Il playground usa QoreSign, la stessa libreria open source delle integrazioni in produzione. Produce e verifica firme ibride: una firma secp256k1 più una firma ML-DSA-87 sullo stesso messaggio.
• Un hub di pacchetti generato da dati testati. La scheda SDKs elenca 48 pacchetti da un unico manifest. Le versioni vengono lette live da ciascun registry (aggiornate ogni 10 minuti, con l'ultima versione verificata e la sua data se un registry non è raggiungibile), e ogni quickstart è stato eseguito dal team SDK sui registry pubblici, con l'output osservato mostrato accanto.
• Un verdetto riproducibile. Il Transaction inspector legge una transazione confermata e riporta se il suo livello ML-DSA-87 si verifica rispetto alla chiave che il firmatario ha registrato, con la versione dei sign-bytes e il motivo quando non si verifica, usando la funzione inspectTransaction di QoreSign 0.1.1, così lo stesso controllo gira nel tuo codice. È di sola lettura.
• Risposte della chain, non supposizioni. PQ key status legge la chiave ML-DSA-87 registrata e lo stato della finestra EVM dalle rotte di query del nodo stesso, così puoi vedere perché una transazione EVM verrebbe rifiutata prima di inviarla.

Come si usa

Apri dashboard.qorechain.io/developers. La pagina si apre su SDKs. Le schede PQ key status e Simulator mostrano un selettore Network (Testnet o Mainnet) locale alla pagina che per impostazione predefinita è su Testnet, qualunque cosa dica l'intestazione. È locale alla pagina di proposito: l'interruttore dell'intestazione ricarica la pagina, cosa che cancellerebbe le chiavi in memoria e il test wallet.

SDKs

Cosa fa. Elenca ogni libreria QoreChain, raggruppata per prodotto. Il manifest contiene 48 pacchetti tra TypeScript, Python, Go, Rust, Java, Kotlin e Swift. 46 sono stabili, 1 è deprecato e 1 non è ancora presente nel suo registry ed è contrassegnato Not published yet (QoreSeal per npm). I prodotti, nell'ordine mostrato, sono: QoreChain SDK (core, hook React, EVM, SVM, lo starter dApp e i port Python, Rust, Go e Java), QoreSign (incluso QoreSign per Python), QoreSeal (cifratura verso gli account con ML-KEM-1024, testnet; vedi QoreSeal, in Rust, Go, Python, Swift, Kotlin e Android), RDK (il kit di sviluppo dei rollup, il suo strumento a riga di comando, lo starter per rollup e i port Python, Rust, Go e Java), la libreria PQC, il wallet adapter, il chain bridge, Handles, le integrazioni QoreX e MCP e la CLI qore.

Come funziona. Ogni prodotto è una scheda. Se il prodotto è distribuito in più linguaggi, un selettore di linguaggio (pillole) cambia il pacchetto mostrato. Ogni pacchetto mostra:

• una pillola di stato (Stable, Not published yet o Deprecated);
• l'ultima versione, letta live dal suo registry (npm, PyPI, crates.io, il proxy Go, Maven Central o le release di GitHub) e aggiornata ogni 10 minuti. Se un registry non è raggiungibile, viene mostrata l'ultima versione verificata con la sua data e una nota che indica che non è stato possibile leggere le versioni live;
• Registry, Source (repository) e License (Apache-2.0), e i requisiti di runtime;
• il comando Install e la riga Import, ciascuno con un pulsante di copia, più dipendenze peer, subpath export, transport e un endpoint ospitato dove il pacchetto li prevede (per Maven viene mostrato un blocco pom.xml);
• il Quickstart: una pillola che riporta Tested con la data, Failed in testing o Not tested, il nome del file, il codice con un pulsante di copia, l'Observed output e How it was tested. Un quickstart fallito è nascosto dietro Show the quickstart con un avviso di leggere prima i problemi noti;
• Known issues e note, parola per parola dal team SDK.

Un pacchetto non pubblicato mostra "This package is not on its registry yet, so there is no install command." e nessuna riga di installazione. Il pacchetto deprecato (@qorechain/connect) è raccolto in fondo sotto Deprecated packages, con i suoi sostituti (i pacchetti @qorechain/qorex-*).

Passaggi.

1. Digita nel campo filtro ("Filter by name or language") per restringere l'elenco; Clear filter lo azzera. Quando più prodotti corrispondono, una riga Jump to collega a ciascuno.
2. Scegli il prodotto, poi la pillola del linguaggio.
3. Controlla la riga della versione ("latest on npm", oppure "checked" con una data), poi copia il comando Install.
4. Copia la riga Import, poi il quickstart nel file indicato sotto File name, ed eseguilo.
5. Apri Network endpoints per copiare gli id di chain e gli endpoint pubblici di testnet e mainnet. La nota sotto spiega le convenzioni dei quickstart: gli esempi si limitano a leggere e firmano con la frase di test pubblica, quindi non finanziare mai un account derivato da essa.

Esempio minimo. Digita python nel filtro, apri QoreChain SDK, scegli la pillola Python, copia il comando di installazione da Install, poi copia il quickstart ed eseguilo.

Rete. Elenco statico più letture live dei registry; non si applica alcuna scelta di rete.

Transaction inspector

Cosa fa. Legge una transazione confermata tramite il suo hash e spiega chi l'ha firmata, quanto è costata, se il suo livello post-quantistico si verifica e in quale livello di sicurezza rientra. È di sola lettura: nulla viene firmato né inviato.

Come funziona. La pagina chiede al gateway di sola lettura della Dashboard la transazione sulla rete che scegli ed esegue su di essa la funzione inspectTransaction di QoreSign 0.1.1 (vedi il quickstart di QoreSign per eseguire lo stesso controllo nel codice). Il livello post-quantistico viene controllato rispetto alla chiave ML-DSA-87 che il firmatario ha registrato adesso, quindi una successiva rotazione della chiave può far risultare non verificata una transazione più vecchia.

Passaggi.

1. Apri la scheda Transaction inspector (si trova subito dopo SDKs) e scegli Testnet o Mainnet con l'interruttore.
2. Incolla il Transaction hash: 64 caratteri esadecimali, con o senza 0x. Un hash malformato viene rifiutato prima che venga richiesto qualsiasi dato.
3. Seleziona Inspect.
4. Leggi il risultato:

   • Overview: Status (Success, oppure Failed con codespace e codice), Height, Chain id, Memo, Fee con il Gas limit (e il pagatore o il garante della commissione, se indicato) e Open in explorer. L'explorer segue la rete scelta nell'intestazione, quindi una nota ti invita a cambiarla quando la transazione si trova sull'altra rete.

   • Signer: Address, Key type, Sequence, Public key e Classical signature valid. Le transazioni della lane EVM qui non portano informazioni sul firmatario, e la scheda lo dice.

   • Post-quantum layer: Present, Count, Algorithm (ML-DSA-87), Verified (sì o no), Sign-bytes version e, quando non è verificato, il Reason.

   • Security tier, con queste definizioni:

     Livello	Significato
     PQC	Porta il livello ML-DSA-87: una firma ibrida.
     Enrollment	Registra o gestisce la chiave ML-DSA-87 dell'account, ed è firmata per scelta di progetto con la chiave classica.
     SHAKE	Una transazione della lane nativa senza il livello ML-DSA-87.
     Classical	Una transazione della lane EVM, firmata solo con secp256k1.

   • Messages: il type URL di ciascun messaggio e il suo valore grezzo (Show raw value (base64)), e il Raw JSON.

5. Un hash sconosciuto riporta "No transaction with this hash was found on ..." con il suggerimento di controllare l'hash o di cambiare rete. I nodi testnet eliminano la cronologia vecchia, quindi una vecchia transazione testnet può non esserci più.

Esempio minimo. Scegli Testnet e incolla 124E5B2B5B5A8AE7CBA254224CBA07F5014BD1B0014C164A8208E5D7EC0C664E: il livello riporta PQC e il livello post-quantistico riporta Verified (verificato il 27 ottobre 2026; se quella transazione nel frattempo è stata eliminata, usa l'hash di un trasferimento testnet recente).

Rete. Mainnet o testnet, tramite l'interruttore nella scheda (predefinito testnet).

PQ key status

Cosa fa. Mostra la chiave ML-DSA-87 che un account ha registrato on-chain e lo stato della sua finestra di autorizzazione EVM, su mainnet o testnet.

Come funziona. La pagina analizza il tuo input, lo converte in un account qor1... e pone al nodo due query: la chiave PQC registrata (tramite QoreSign) e la finestra EVM dell'account (GET /qorechain/pqc/v1/evm_window/{address}). Un indirizzo 0x... corrisponde agli stessi 20 byte della sua forma qor1..., e un indirizzo qorvaloper1... viene cercato come account proprio dell'operatore. I risultati appartengono a una rete: cambiare il selettore li cancella.

Passaggi.

1. Apri la scheda PQ key status e scegli la rete.
2. Inserisci un Account address (qor1..., 0x... o qorvaloper1...). La pagina controlla il formato e il checksum e segnala un errore di battitura.
3. Seleziona Check.
4. Leggi Registered PQC key: se è registrata una chiave, l'Algorithm (ML-DSA-87), il Key type (hybrid), la Proof of possession (con la nota che la chain la considera facoltativa) e la Public key (2592 byte, troncata, con un pulsante di copia). Un account senza chiave riporta "This account has no PQC key registered on this network."
5. Leggi EVM authorisation window: State (Open o Closed), Blocks left, Transactions used (nello stile "3 of 20"), Value used, Opened / expiry height, e se la finestra consente Native QOR transfers only, con eventuali destinazioni consentite. Un account che non ne ha mai aperta una riporta "No EVM authorisation window has been opened for this account."

La finestra viene aperta dalla lane nativa con la chiave ML-DSA-87 dell'account e si chiude quando raggiunge il limite di blocchi o di transazioni; vedi Finestra di autorizzazione EVM.

Esempio minimo. Scegli Testnet, incolla la forma 0x... di un indirizzo che usi con MetaMask, seleziona Check: se la finestra è Closed o assente, una transazione EVM da quell'account verrebbe rifiutata.

Simulator

Cosa fa. Simula a vuoto una transazione firmata sulla chain e riporta quanto costerebbe e cosa cambierebbe. Non viene trasmesso nulla.

Come funziona. La pagina decodifica il tuo input (base64 o esadecimale, fino a circa 180 KB), conta le firme e lo invia alla rotta di simulazione del nodo. La chiamata di simulazione è l'unica rotta di scrittura che il gateway consente.

Passaggi.

1. Apri Simulator e scegli la rete.
2. Incolla la transazione firmata (un TxRaw, base64 o esadecimale) in Signed TxRaw. La pagina mostra la dimensione decodificata e il numero di firme, e avvisa se non ce ne sono (la chain molto probabilmente rifiuterà di simulare una transazione non firmata).
3. Seleziona Simulate.
4. Leggi Gas used, il Suggested gas limit, i Balance changes (indirizzo, denominazione, variazione) e gli Events nell'elenco comprimibile.
5. Se la chain rifiuta, la pagina mostra il suo Code, Codespace e Log sotto "The chain refused the simulation".

Servono prima i byte firmati: costruisci e firma con un SDK o con qorechaind (vedi Firma post-quantistica). Esempio minimo: firma un piccolo trasferimento con l'SDK su testnet, incolla il TxRaw in base64, seleziona Simulate e controlla il limite di gas suggerito prima di trasmettere.

Signing playground (solo testnet)

Cosa fa. Ti permette di generare una chiave ibrida usa e getta e di firmare e verificare messaggi e richieste Sign In With QoreChain nel browser.

Come funziona. Una frase di 24 parole viene generata nella pagina e conservata solo in memoria. QoreSign ne deriva una chiave secp256k1 e una chiave ML-DSA-87. Le firme coprono lo stesso messaggio con entrambe le chiavi, per la chain qorechain-diana. Poiché una chiave usa e getta non è registrata on-chain, la verifica usa la chiave pubblica ML-DSA-87 di questa sessione.

Passaggi.

1. Apri Signing playground. Avvisa "Throwaway testnet key: never use it for real funds."
2. Seleziona Generate throwaway key. La pagina mostra l'indirizzo qor1..., la chiave pubblica secp256k1 (33 byte) e la chiave ML-DSA-87 (chiave pubblica 2592 byte, chiave segreta 4896 byte). New key la sostituisce.
3. Message: digita del testo, seleziona Sign; il risultato è una firma ibrida come JSON. Seleziona Verify: la pagina mostra "Valid signature", oppure "Invalid signature" con il codice di errore.
4. Sign In With QoreChain: seleziona Build message (un messaggio di accesso per questo sito con dominio, indirizzo, id di chain, un nonce casuale e orari di emissione e scadenza), poi Sign, poi Verify. Verify lo controlla come farebbe un server ed elenca i campi analizzati. Vedi la specifica SIWQ e la guida all'accesso.

Esempio minimo. Generate throwaway key, digita hello, Sign, Verify: la pagina mostra "Valid signature".

Rete. Solo testnet; la chiave non può essere usata per la mainnet e si perde al ricaricamento.

QoreX test wallet (solo testnet)

Cosa fa. Installa un mock del wallet QoreX nella scheda corrente così puoi provare i flussi di connessione e firma di una dApp senza un wallet reale.

Come funziona. Start test wallet crea un test wallet con una chiave usa e getta (il pacchetto pubblicato @qorechain/qorex-wallet-mock) e lo annuncia alle dApp nella pagina come "QoreX (mock)", tramite la scoperta standard dei wallet per browser (EIP-6963); espone anche window.qorex. Nulla viene approvato automaticamente. Non trasmette transazioni. Se nella scheda è presente un'estensione QoreX reale, il mock la sostituisce fino al ricaricamento.

Passaggi.

1. Apri QoreX test wallet e leggi l'avviso: a ogni avvio viene generata in memoria una chiave testnet usa e getta; non inviarle mai fondi reali.
2. Seleziona Start test wallet. La scheda Addresses elenca gli indirizzi QoreChain Native, EVM e SVM.
3. Connettiti da una dApp in esecuzione in questa scheda, oppure chiama window.qorex dalla console del browser.
4. Ogni richiesta appare sotto Waiting for approval; seleziona Approve o Reject. L'elenco Requests registra ogni richiesta con il suo stato di approvazione e il suo esito.
5. Seleziona Stop (reloads the page) per rimuovere il mock.

Esempio minimo. Avvia il test wallet, apri una dApp nella stessa scheda, scegli "QoreX (mock)" nella sua finestra di connessione e Approve la connessione.

Rete. Solo testnet.

AI agents (MCP)

Cosa fa. Mostra lo stato del server MCP di QoreChain (un server Model Context Protocol che permette a un client MCP di leggere i dati della chain QoreChain e di usare gli strumenti per sviluppatori) e come configurarlo in un client MCP.

Come funziona. Quando apri la scheda, la pagina interroga il registry dei pacchetti in tempo reale e mostra lo stato (Published) con la versione attuale (@qorechain/mcp, 0.1.0 al momento della stesura, disponibile anche su PyPI come qorechain-mcp). Poi mostra la configurazione per un client MCP, come blocchi copiabili:

• Locale (stdio), l'opzione principale. Aggiungi { "mcpServers": { "qorechain": { "command": "npx", "args": ["-y", "@qorechain/mcp"] } } } alla configurazione dei server del tuo client MCP. Non richiede alcuna chiave.
• Self-hosted (Streamable HTTP). Esegui qorechain-mcp serve --port 8787 e punta il client a http://localhost:8787/mcp.
• Endpoint ospitato. https://mcp.qorechain.io/mcp serve la testnet per impostazione predefinita. Ogni richiesta richiede una chiave API, inviata come header Authorization: Bearer <key>. Richiedine una dalla tua dashboard (vedi il flusso della chiave qui sotto). Per la maggior parte degli usi la configurazione locale non richiede alcuna chiave.

Chiave API per l'endpoint ospitato. Accedi, poi nella sezione API key della scheda:

1. Compila il nome o l'organizzazione, un contatto, l'uso previsto e il volume atteso, quindi premi Request API key. Lo stato indica "in attesa di approvazione".
2. Il team QoreChain approva o rifiuta la richiesta. Un rifiuto mostra la sua nota e puoi fare una nuova richiesta.
3. Dopo l'approvazione, premi Generate key. La chiave viene mostrata una sola volta, con un pulsante di copia e uno snippet di configurazione pronto, e diventa attiva entro un minuto o due. QoreChain non conserva alcuna copia della chiave, solo un'impronta (un hash), quindi una chiave persa non può essere mostrata di nuovo: revocala e richiedine una nuova.
4. Revoke key è disponibile in qualsiasi momento e ha effetto in circa un minuto.

Limiti: una chiave attiva per account, 10 richieste al secondo (burst 20) e 100.000 richieste al giorno.

Passaggi. Apri la scheda, copia la configurazione locale nel tuo client MCP, riavvialo e chiedigli di leggere un blocco o un account. Per i dettagli sugli strumenti e le opzioni vedi Server MCP di QoreChain. Esempio minimo: incolla il blocco stdio nel tuo client, riavvialo e chiedigli l'ultimo blocco.

Come accedere

• URL: dashboard.qorechain.io/developers, oppure Developers nel gruppo Build della barra laterale (e nel menu mobile).
• Accesso: nessuno per la pagina e i suoi strumenti. Richiedere una chiave API per l'endpoint MCP ospitato richiede l'accesso.
• Rete: Transaction inspector, PQ key status e Simulator funzionano su mainnet o testnet tramite il selettore nella scheda (predefinito testnet). Signing playground e QoreX test wallet sono solo testnet. SDKs e AI agents (MCP) non dipendono da una rete.
• Wallet: nessuno. Gli strumenti generano le proprie chiavi usa e getta.
• Costo: gratuito. Alla chain non viene inviato nulla se non query di lettura e chiamate di simulazione.
• Privacy: le chiavi usa e getta esistono solo nella memoria della pagina. Non incollare una frase di recupero reale in nessuno strumento.

Dove è pubblicato

Superficie	Indirizzo	Reti
Pagina Developers	dashboard.qorechain.io/developers	Strumenti di lettura su mainnet e testnet; strumenti di firma solo testnet
Libreria di firma	npm @qorechain/qoresign (0.1.1 aggiunge inspectTransaction), PyPI QoreSign per Python, sorgente github.com/qorechain/qoresign, vedi QoreSign	n/d
Pacchetto del test wallet	npm @qorechain/qorex-wallet-mock, sorgente github.com/qorechain/qorex-integrations	Testnet
Indice dei pacchetti	Pacchetti per sviluppatori	n/d
Server MCP	npm @qorechain/mcp 0.1.0 e @qorechain/qore-cli 0.1.0, PyPI qorechain-mcp 0.1.0; guida: Server MCP di QoreChain	Testnet per impostazione predefinita

Le versioni dei pacchetti cambiano; leggi quelle attuali nella scheda SDKs o sui registry.

Limiti e problemi noti

• L'inspector giudica rispetto alla chiave registrata adesso. Dopo una rotazione della chiave una transazione più vecchia può risultare non verificata. Legge solo transazioni confermate.
• L'endpoint MCP ospitato richiede una chiave API. Richiedila dalla tua dashboard (una chiave attiva per account, 10 richieste al secondo, 100.000 al giorno); la configurazione locale non ne richiede alcuna. Per la maggior parte del lavoro usa la configurazione locale.
• Due quickstart sono contrassegnati "Not tested": QoreSign per Android e QoreSeal per Android (lo stesso codice è stato eseguito sull'artefatto JVM, non su un dispositivo). Gli altri quickstart testati sono stati eseguiti e hanno superato la prova.
• Il simulatore richiede byte firmati. Non può firmare per te e non trasmette mai.
• Il playground e il test wallet sono solo testnet, usano chiavi usa e getta che scompaiono al ricaricamento e non possono detenere né spostare fondi reali.
• Un'estensione QoreX reale nella stessa scheda viene sostituita dal test wallet fino al ricaricamento.
• Le letture passano dal gateway della Dashboard. Dal tuo codice chiama direttamente gli endpoint pubblici: api.qore.host e api-testnet.qore.host.