Sviluppo QoreChain Native
QoreChain supporta gli smart contract QoreChain Native. QoreChain Native è il nome che QoreChain dà al proprio runtime CosmWasm: gli sviluppatori scrivono programmi sicuri e isolati (sandboxed) in Rust, basati sulle librerie CosmWasm standard (cosmwasm-std), e li compilano in WebAssembly. I contratti QoreChain Native vengono eseguiti insieme ai programmi EVM e SVM all'interno dell'architettura tripla-VM di QoreChain.
I comandi seguenti utilizzano la mainnet qorechain-vladi (attiva dal 7 giugno 2026), che esegue la release di nodo v3.2.7 dal 12 novembre 2026 (proposta di governance 16, altezza 4.164.600; la v3.2.6 dal 4 novembre 2026; la v3.2.5 dal 29 ottobre 2026, la v3.2.4 dal 23 ottobre 2026). Sostituisci con --chain-id qorechain-diana per la testnet, che esegue la v3.2.7 (dal 6 novembre 2026; la v3.2.4 dal 19 ottobre 2026).
Al momento della stesura (verificato il 27 ottobre 2026), code_upload_access e instantiate_default_permission sono entrambi impostati su Nobody sulla mainnet, il che significa che MsgStoreCode e MsgInstantiateContract non sono aperti ad account arbitrari, in seguito a un avviso di sicurezza valido per l'intero settore riguardante CosmWasm, il runtime su cui si basa QoreChain Native. Sulla testnet qorechain-diana le impostazioni sono diverse: code_upload_access è ancora Nobody (il codice viene archiviato solo tramite la governance), ma instantiate_default_permission è Everybody, impostato dalla governance della testnet il 27 ottobre 2026, quindi qualsiasi account può istanziare un codice archiviato il cui permesso lo consenta. Sulla mainnet sarà necessario che la governance conceda al tuo account (o a un elenco specifico di indirizzi) il permesso di caricamento/istanziazione prima che i passaggi seguenti possano avere successo. Verifica prima i parametri live, poiché questo è esattamente il tipo di impostazione che la governance può modificare (la mainnet al momento non ha alcun codice di contratto archiviato):
qorechaind query wasm params
# or: curl -s https://api.qore.host/cosmwasm/wasm/v1/codes/params (substitute api-testnet.qore.host for testnet)
Il circuit breaker della chain disattiva inoltre dei tipi di messaggio a livello di rete (qorechaind query circuit disabled-list). Sulla mainnet MsgStoreCode, MsgInstantiateContract e MsgInstantiateContract2 sono nell'elenco, quindi alzare il solo permesso non basta finché quelle voci non vengono rimosse. Sulla testnet nell'elenco c'è solo MsgStoreCode: l'istanziazione è aperta, il caricamento no.
Testnet: contratti verificati archiviati dalla governance. Poiché gli account ordinari non possono caricare codice sulla testnet, la governance ha archiviato cinque contratti verificati che chiunque può istanziare (instantiate_permission Everybody): cw20-base (token), cw721-base (collezione NFT), cw4-group, cw3-fixed-multisig e un piccolo contratto contatore. Al momento della stesura sono i code id da 859 a 863, in quest'ordine, elencati da GET /cosmwasm/wasm/v1/code con l'account del modulo di governance come creatore e identificati dal loro data_hash; leggi gli id dall'elenco live invece di scriverli nel codice. Esistono solo sulla testnet. La mainnet non ha alcun codice archiviato.
Questa restrizione non riguarda i contratti già istanziati — execute e query su un contratto esistente funzionano normalmente indipendentemente da questa impostazione.
tx pqc cosignMainnet e testnet richiedono una firma post-quantistica ibrida su ogni transazione della corsia Cosmos, quindi i comandi tx di questa pagina non vengono trasmessi così come sono scritti. Costruiscono la transazione con --generate-only > tx.json; poi firmala e trasmettila con qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id <chain-id> (il binario di release dal manifest di download include il firmatario; una build dal sorgente pubblico no). La soglia minima delle commissioni di rete è di 0,1 uqor per unità di gas, ed è ciò che esprime --gas-prices 0.1uqor; la firma ibrida aggiunge circa 47.000 gas che una simulazione non include, da cui l'aggiustamento di 1.5. (Dalla v3.2.7, sulla testnet dal 6 novembre 2026 e sulla mainnet dal 12 novembre 2026, il costo di verifica post-quantistica è fisso a 2.000 gas.) Vedi Firma post-quantistica.
Prerequisiti
| Dipendenza | Versione | Scopo |
|---|---|---|
| Rust | Ultima stabile | Compilazione del contratto |
| wasm32-unknown-unknown | target | Target di compilazione WebAssembly |
| cargo-generate | Ultima | Scaffolding del progetto |
| cosmwasm-std | 1.5+ | Libreria standard CosmWasm |
Installa il target Wasm:
rustup target add wasm32-unknown-unknown
Ciclo di vita del contratto
I contratti QoreChain Native seguono un ciclo di vita in cinque fasi: Build (compilazione), Store (archiviazione), Instantiate (istanziazione), Execute (esecuzione) e Query (interrogazione).
-
Build — Compila il tuo contratto in WebAssembly ottimizzato:
cd my-contract# Standard buildcargo build --release --target wasm32-unknown-unknown# Optimized build (recommended for deployment)docker run --rm -v "$(pwd)":/code \cosmwasm/rust-optimizer:0.15.0Il file
.wasmottimizzato si troverà nella directoryartifacts/. -
Store — Carica il contratto compilato sulla chain:
qorechaind tx wasm store contract.wasm \--from mykey \--gas auto --gas-adjustment 1.5 --gas-prices 0.1uqor \--generate-only > tx.jsonDopo la conferma della transazione (firma e trasmetti
tx.jsoncontx pqc cosigncome descritto sopra), interroga il code ID archiviato:qorechaind query wasm list-code -
Instantiate — Crea una nuova istanza del contratto a partire da un code ID archiviato:
qorechaind tx wasm instantiate <code-id> \'{"count": 0, "owner": "qor1..."}' \--label "my-counter-contract" \--from mykey \--no-admin \--gas auto --gas-adjustment 1.5 --gas-prices 0.1uqor \--generate-only > tx.jsonFlag Descrizione <code-id>ID numerico restituito dalla transazione di archiviazione --labelEtichetta leggibile per questa istanza --no-adminNessun indirizzo admin (il contratto è immutabile) --admin <address>Imposta un admin che può migrare il contratto Recupera l'indirizzo del contratto:
qorechaind query wasm list-contract-by-code <code-id> -
Execute — Chiama l'entry point execute di un contratto per modificarne lo stato:
qorechaind tx wasm execute <contract-addr> \'{"increment": {}}' \--from mykey \--gas auto --gas-adjustment 1.5 --gas-prices 0.1uqor \--generate-only > tx.jsonEsecuzione con fondi allegati:
qorechaind tx wasm execute <contract-addr> \'{"deposit": {}}' \--amount 1000000uqor \--from mykey \--gas auto --gas-adjustment 1.5 --gas-prices 0.1uqor \--generate-only > tx.json -
Query — Leggi lo stato del contratto senza inviare una transazione:
qorechaind query wasm contract-state smart <contract-addr> \'{"get_count": {}}'Le risposte alle query vengono restituite in formato JSON.
Gas e limiti di upload (v3.2.8)
Dalla release v3.2.8 (solo testnet fino a un successivo upgrade della mainnet):
- Il gas di esecuzione è ridefinito. La prima chiamata di un codice di contratto in un blocco paga un costo di caricamento (un trasferimento cw20 costa circa 533.000 gas la prima volta in un blocco e circa 84.000 per le ripetizioni), vengono addebitati l'avvio della chiamata e la crescita della memoria, e un fattore di congestione scala il prezzo da 1x fino a 20x per impostazione predefinita. Simula sempre e aggiungi almeno il 30%; non scrivere mai il gas di una chiamata a un contratto in modo fisso. Vedi Gas per le chiamate ai contratti.
- Gli upload sono limitati e restano sotto il controllo della governance. L'accesso viene verificato per primo e il mempool ammette un upload solo da un mittente autorizzato. L'upload paga in anticipo il gas per la dimensione dichiarata (circa 9,9 milioni di gas per cw20, circa 22,8 milioni per cw721). Un modulo può avere al massimo 4.096 funzioni e compilarsi in al massimo 32 MiB, e le istruzioni in virgola mobile sono rifiutate, sia all'upload sia alla chiamata per il codice già memorizzato.
Query utili
# List all stored code
qorechaind query wasm list-code
# List all instances of a specific code ID
qorechaind query wasm list-contract-by-code <code-id>
# Get contract info (code ID, admin, label)
qorechaind query wasm contract <contract-addr>
# Get raw contract state by key
qorechaind query wasm contract-state raw <contract-addr> <key-hex>
# Get full contract state (all keys)
qorechaind query wasm contract-state all <contract-addr>
# Get contract history (instantiate/migrate events)
qorechaind query wasm contract-history <contract-addr>
Struttura del contratto
Un tipico contratto QoreChain Native ha tre entry point:
use cosmwasm_std::{
entry_point, Binary, Deps, DepsMut, Env, MessageInfo,
Response, StdResult,
};
#[entry_point]
pub fn instantiate(
deps: DepsMut,
_env: Env,
info: MessageInfo,
msg: InstantiateMsg,
) -> StdResult<Response> {
// Initialize contract state
Ok(Response::new().add_attribute("method", "instantiate"))
}
#[entry_point]
pub fn execute(
deps: DepsMut,
env: Env,
info: MessageInfo,
msg: ExecuteMsg,
) -> StdResult<Response> {
// Handle state-changing operations
Ok(Response::new().add_attribute("method", "execute"))
}
#[entry_point]
pub fn query(
deps: Deps,
_env: Env,
msg: QueryMsg,
) -> StdResult<Binary> {
// Handle read-only queries
Ok(Binary::default())
}
Chiamate Cross-VM
Le chiamate cross-VM vengono inviate come transazioni MsgCrossVMCall attraverso il modulo x/crossvm; consulta Interoperabilità Cross-VM per il ciclo di vita del messaggio. I contratti QoreChain Native oggi non dispongono di un binding lato contratto per avviare una chiamata cross-VM (non esiste alcun messaggio personalizzato QoreChainMsg che i contratti possano emettere), quindi un contratto non può chiamare un contratto EVM o SVM dall'interno del proprio entry point execute. Dalla v3.2.3 una chiamata verso la corsia del chiamante stesso viene rifiutata e una chiamata in coda che fallisce non lascia effetti collaterali.
MsgCrossVMCall si trova nell'elenco del circuit breaker della mainnet (qorechaind query circuit disabled-list) e la corsia SVM è disattivata su entrambe le reti, quindi il percorso cross-VM oggi non è utilizzabile per le transazioni ordinarie.
Integrazione dei moduli
I contratti QoreChain Native possono interagire con i moduli del Cosmos SDK tramite il passaggio di messaggi standard:
// Send native tokens via the bank module
let send_msg = BankMsg::Send {
to_address: "qor1recipient...".to_string(),
amount: vec![Coin {
denom: "uqor".to_string(),
amount: Uint128::new(1_000_000),
}],
};
// Delegate to a validator via the staking module
let delegate_msg = StakingMsg::Delegate {
validator: "qorvaloper1...".to_string(),
amount: Coin {
denom: "uqor".to_string(),
amount: Uint128::new(1_000_000),
},
};
Migrazione del contratto
Se il contratto è stato istanziato con un indirizzo --admin, l'admin può migrarlo verso un nuovo code ID:
qorechaind tx wasm migrate <contract-addr> <new-code-id> \
'{"migrate_msg": {}}' \
--from admin-key \
--gas auto --gas-adjustment 1.5 --gas-prices 0.1uqor \
--generate-only > tx.json
Questo richiama l'entry point migrate sul nuovo codice utilizzando lo stato esistente del contratto.
Prossimi passi
- Interoperabilità Cross-VM — Chiama contratti EVM e SVM da QoreChain Native
- Sviluppo SVM — Distribuisci programmi BPF su QoreChain
- Precompilati EVM — Riferimento per i precompilati Solidity (nessuno è attivo sulla mainnet; tre sono attivi sulla testnet)