Abstractizarea Contului

QoreChain oferă abstractizare de cont la nivel de protocol prin modulul x/abstractaccount. Aceasta permite conturi programabile cu reguli de autentificare flexibile, chei de sesiune, limite de cheltuieli și recuperare socială — totul fără a necesita infrastructură externă de contracte inteligente.

notă

Comenzile de mai jos folosesc mainnet-ul qorechain-vladi, activ din 7 iunie 2026, rulând versiunea de chain v3.1.97. Înlocuiți cu --chain-id qorechain-diana pentru testnet.

Prezentare Generală

Conturile blockchain tradiționale sunt controlate de o singură cheie privată. Abstractizarea contului decuplează conceptul de „cine poate autoriza o tranzacție” de o singură cheie criptografică, permițând:

Conturi multisig cu semnare cu prag configurabil
Conturi cu recuperare socială cu recuperarea cheii pe baza gardienilor
Conturi bazate pe sesiune cu permisiuni granulare, limitate în timp, pentru dApp-uri

Modulul x/abstractaccount implementează aceste capabilități la nivelul protocolului, ceea ce înseamnă că funcționează pe toate cele trei VM-uri (EVM, CosmWasm, SVM) și beneficiază de eficiența nativă a gazului.

Un flux dApp bazat pe sesiune: o cheie de sesiune cu domeniu limitat semnează o tranzacție, modulul o validează în raport cu sesiunea și regulile de cheltuieli, apoi o execută.

Tipuri de Cont

Tip	Descriere	Caz de Utilizare
`multisig`	Semnare cu prag M-din-N	Trezorerii DAO, portofele partajate
`social_recovery`	Recuperarea cheii asistată de gardieni	Portofele pentru consumatori, onboarding
`session_based`	Chei de sesiune delegate cu restricții	Sesiuni dApp, portofele mobile

Crearea unui Cont Abstract

Cont Bazat pe Sesiune

qorechaind tx abstractaccount create \
  --account-type session_based \
  --from mykey \
  --gas auto \
  -y

Cont Multisig

qorechaind tx abstractaccount create \
  --account-type multisig \
  --signers qor1alice...,qor1bob...,qor1carol... \
  --threshold 2 \
  --from mykey \
  --gas auto \
  -y

Cont cu Recuperare Socială

qorechaind tx abstractaccount create \
  --account-type social_recovery \
  --guardians qor1guardian1...,qor1guardian2...,qor1guardian3... \
  --recovery-threshold 2 \
  --from mykey \
  --gas auto \
  -y

Chei de Sesiune

Cheile de sesiune sunt piatra de temelie a tipului de cont session_based. Acestea vă permit să acordați permisiuni temporare, cu domeniu limitat unei chei secundare — perfecte pentru interacțiunile cu dApp-uri în care nu doriți să vă expuneți cheia principală.

Proprietățile Cheii

Proprietate	Descriere
Permisiuni	Ce tipuri de mesaje poate semna cheia de sesiune
Expirare	Expirare automată după o durată configurabilă
Limite de cheltuieli	Sumele maxime pe care cheia de sesiune le poate cheltui
Contracte permise	Restricționează interacțiunile la adrese de contract specifice

Acordarea unei Chei de Sesiune

qorechaind tx abstractaccount grant-session \
  --session-key qor1sessionkey... \
  --permissions "bank/MsgSend,wasm/MsgExecuteContract" \
  --expiry "2026-03-01T00:00:00Z" \
  --allowed-contracts qor1contract1...,0x1234...abcd \
  --from mykey \
  -y

Revocarea unei Chei de Sesiune

qorechaind tx abstractaccount revoke-session \
  --session-key qor1sessionkey... \
  --from mykey \
  -y

Listarea Sesiunilor Active

qorechaind query abstractaccount sessions <account-address>

Reguli de Cheltuieli

Regulile de cheltuieli adaugă limite de siguranță financiară conturilor abstracte, indiferent de tipul de cont:

Regulă	Descriere
`daily_limit`	Cheltuiala totală maximă într-o fereastră glisantă de 24 de ore
`per_tx_limit`	Cheltuiala maximă per tranzacție individuală
`allowed_denoms`	Restricționează denominările de token care pot fi cheltuite

Setarea Regulilor de Cheltuieli

qorechaind tx abstractaccount update-spending-rules \
  --daily-limit 1000000000uqor \
  --per-tx-limit 100000000uqor \
  --allowed-denoms uqor \
  --from mykey \
  -y

Interogarea Regulilor Curente

qorechaind query abstractaccount spending-rules <account-address>

Exemplu de Răspuns

{
  "daily_limit": {
    "denom": "uqor",
    "amount": "1000000000"
  },
  "per_tx_limit": {
    "denom": "uqor",
    "amount": "100000000"
  },
  "allowed_denoms": ["uqor"],
  "daily_spent": {
    "denom": "uqor",
    "amount": "250000000"
  },
  "window_reset": "2026-02-27T00:00:00Z"
}

Autentificatori de Portofel Conectat — Cheltuieli Delegate

Începând cu versiunea de chain v3.1.85 (bazată pe modelul de permisiuni v3.1.84), o cheie de portofel extern conectată — o cheie Phantom (ed25519) sau un cont MetaMask (secp256k1) — poate cheltui din contul canonic post-cuantic în condiții de privilegiu minim, cu limite de cheltuieli și revocabile. Cheia externă nu produce niciodată o semnătură ML-DSA; un releu (relayer) trimite și plătește plicul tranzacției (semnătura hibridă PQC proprie a releului satisface cerințele de semnare ale chain-ului), în timp ce semnătura autentificatorului asupra octeților de semnare separați pe domeniu, legați de protecția anti-replay reprezintă autorizarea.

Înregistrarea unui autentificator

Proprietarul contului înregistrează cheia externă cu MsgRegisterAuthenticator (o tranzacție obișnuită cu cheia rădăcină), acordându-i o schemă, permisiuni, o expirare și limite de cheltuieli opționale:

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

// Link a MetaMask account by its 20-byte address (EIP-191 verification):
const msg = registerEthAuthenticatorMsg({
  account: "qor1owner...",            // the canonical account
  ethAddress: "0xAbC...123",          // the MetaMask address to link
  permissions: ["evm"],               // least privilege — see the taxonomy below
  expirySeconds: 30 * 24 * 3600,      // ≤ 30 days recommended
  spendingRule: { perTxLimit: "100000000uqor", dailyLimit: "1000000000uqor" },
});
// Sign & broadcast this msg with the OWNER's normal hybrid-PQC signer.

O cheie Phantom este înregistrată în același mod, cu scheme: "ed25519" și cheia publică Phantom. Revocarea este instantanee prin MsgRevokeAuthenticator.

Taxonomia permisiunilor

Unsprezece permisiuni canonice controlează ce poate face un autentificator înregistrat. Maparea este fail-closed (implicit blocată): un tip de mesaj fără mapare este refuzat.

Permisiune	Acordă
`send`	Transferuri bancare pe lane-ul nativ
`delegate` / `withdraw` / `vote`	Staking, retragerea recompenselor, guvernanță
`evm` / `wasm` / `svm`	Execuție pe lane-ul VM respectiv
`amm` / `ibc` / `deploy`	Operațiuni AMM, transferuri IBC, desfășurare de contracte
`all`	Orice mesaj delegabil

Mesajele de gestionare a cheilor nu sunt niciodată delegabile — MsgRegisterAuthenticator, MsgRevokeAuthenticator, înregistrarea/migrarea cheii PQC și MsgRotatePQCKey necesită întotdeauna cheia rădăcină, astfel încât o cheie conectată nu își poate escalada niciodată propriile privilegii.

Citiți taxonomia live (cu schema_version pentru detectarea derivei) în loc să o codificați static:

curl -s https://api.qore.host/qorechain/abstractaccount/v1/permission_schema | jq
# or: qorechaind query abstractaccount permission-schema

Cheltuirea printr-o cheie conectată

Două mesaje transportă acțiuni autorizate de autentificator. În ambele cazuri, releul este semnatarul/plătitorul de taxe al tranzacției; semnătura autentificatorului călătorește în interiorul mesajului.

MsgExecuteEVM — un apel sau transfer EVM de la adresa 0x… a contului canonic. Autentificatorul semnează sha256("qorechain-evm-auth-v1" ‖ chainId ‖ account ‖ pubkey ‖ to ‖ value ‖ data ‖ nonce) (toate câmpurile prefixate cu lungime). Protecția anti-replay este nonce-ul EVM propriu al contului.

MsgExecuteCosmos — un transfer bancar pe lane-ul nativ din contul canonic. Autentificatorul semnează sha256("qorechain-cosmos-auth-v1" ‖ chainId ‖ account ‖ pubkey ‖ to ‖ amount ‖ nonce). Protecția anti-replay este o secvență per-autentificator păstrată de modul (un transfer bancar nu incrementează nonce-ul contului). Auto-trimiterile sunt respinse.

Reguli privind nonce-ul

MsgExecuteEVM.nonce = nonce-ul EVM curent al contului (eth_getTransactionCount(account0x, "latest")). În producție releul este un cont diferit, deci nu adăugați +1. Semnarea unui nonce învechit returnează codul 11.
MsgExecuteCosmos.nonce = secvența per-autentificator (interogați starea autentificatorului contului), nu secvența Cosmos a contului.

Exemplu Phantom (browser: Phantom semnează, backend-ul dvs. transmite):

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

// In the dApp: Phantom signs the digest with ed25519 signMessage.
const msg = await buildPhantomExecuteCosmos({
  provider: window.solana,            // Phantom
  chainId: "qorechain-vladi",
  account: "qor1owner...",            // canonical account being spent from
  to: "qor1recipient...",
  amount: { denom: "uqor", amount: "900000" },
  nonce: authSequence,                // per-authenticator sequence
});
// Send `msg` to your relayer; the relayer wraps it in a tx it signs
// (hybrid PQC) and broadcasts. The transfer moves the OWNER's funds.

Exemplu MetaMask (EIP-191 personal_sign de la adresa de 20 de octeți conectată):

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

const msg = await buildMetaMaskExecuteEvm({
  provider: window.ethereum,          // MetaMask (EIP-1193)
  chainId: "qorechain-vladi",
  account: "qor1owner...",
  to: "0xRecipient...",
  valueWei: 10n ** 16n,               // 0.01 QOR (18-dec EVM view)
  nonce: currentEvmNonce,             // eth_getTransactionCount(owner0x, "latest")
});
// Relay as above. The chain verifies the signature via EIP-191 + ecrecover
// against the registered 20-byte address.

Aceleași funcții constructor există în SDK-ul QoreChain pentru toate cele cinci limbaje, plus echivalente CLI:

# Produce the exact sign bytes the chain verifies (for custom signers):
qorechaind query abstractaccount auth-sign-cosmos <account> <to> <amount> <nonce>
qorechaind query abstractaccount auth-sign-evm <account> <to> <value> <data-hex> <nonce>

# Relay a pre-signed authorization:
qorechaind tx abstractaccount execute-cosmos <account> <to> <amount> <auth-pubkey> <auth-sig> <nonce> --from relayer -y
qorechaind tx abstractaccount execute-evm    <account> <to> <value> <data-hex> <auth-pubkey> <auth-sig> <nonce> --from relayer -y

Coduri de eroare

Eșecurile de aplicare a regulilor returnează coduri distincte (codespace abstractaccount) astfel încât portofelele să poată afișa mesajul corect:

Cod	Semnificație	UX Portofel
`5`	Limită de cheltuieli depășită (per tranzacție sau zilnică)	Afișați alocarea rămasă
`6`	Autentificator expirat	„Expirat — reconectați portofelul”
`10`	Permisiune refuzată (domeniu sau mesaj nedelegabil)	Afișați permisiunea lipsă
`11`	Replay respins (nonce/secvență învechită)	Reinterogați nonce-ul și resemnați

(Codespace pqc cod 21 = verificarea semnăturii hibride a eșuat — o problemă de semnare pe partea releului, nu una de autorizare.)

Interogări REST

Începând cu v3.1.85, interogările de citire ale modulului sunt de asemenea servite prin REST:

GET /qorechain/abstractaccount/v1/config
GET /qorechain/abstractaccount/v1/accounts
GET /qorechain/abstractaccount/v1/accounts/{address}
GET /qorechain/abstractaccount/v1/permission_schema

Interogarea Conturilor Abstracte

CLI

# Get full account configuration
qorechaind query abstractaccount account <address>

# List all abstract accounts (paginated)
qorechaind query abstractaccount list --limit 10

JSON-RPC

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qor_getAbstractAccount",
    "params": ["0xYourAddress"],
    "id": 1
  }'

Exemplu de Răspuns pentru Cont

{
  "address": "qor1myaccount...",
  "account_type": "session_based",
  "owner": "qor1owner...",
  "active_sessions": 2,
  "spending_rules": {
    "daily_limit": "1000000000uqor",
    "per_tx_limit": "100000000uqor",
    "allowed_denoms": ["uqor"]
  },
  "created_at_height": 54321
}

Fluxul de Recuperare Socială

Dacă proprietarul contului pierde accesul la cheia sa principală, gardienii pot autoriza o rotație a cheii.

Proprietarul raportează pierderea cheii (sau un gardian inițiază):

qorechaind tx abstractaccount initiate-recovery \
  --account <account-address> \
  --new-owner qor1newkey... \
  --from guardian1 \
  -y

Gardienii suplimentari aprobă (trebuie să atingă recovery_threshold):

qorechaind tx abstractaccount approve-recovery \
  --account <account-address> \
  --recovery-id <recovery-id> \
  --from guardian2 \
  -y

Recuperarea se execută automat odată ce pragul este atins. O perioadă de blocare temporală (implicit: 48 de ore) oferă proprietarului original șansa de a anula o încercare de recuperare frauduloasă.

Integrare cu dApp-uri

Cheile de sesiune permit experiențe dApp fluide:

Utilizatorul conectează portofelul și creează o cheie de sesiune limitată la contractul dApp-ului
dApp-ul folosește cheia de sesiune pentru a trimite tranzacții în numele utilizatorului
Fără semnare repetată — cheia de sesiune gestionează autorizarea în limitele permisiunilor sale
Sesiunea expiră automat, sau utilizatorul o poate revoca oricând

Acest model este deosebit de util pentru:

Portofele mobile unde solicitările biometrice repetate sunt deranjante
dApp-uri de gaming care necesită semnarea rapidă a tranzacțiilor
Protocoale DeFi care execută mai multe operațiuni secvențiale

Pașii Următori

Rularea unui Validator — Configurați și operați un nod validator
Dezvoltare EVM — Integrați conturi abstracte cu dApp-uri Solidity
Interoperabilitate Cross-VM — Mesagerie cross-VM cu conturi abstracte

Prezentare Generală​

Tipuri de Cont​

Crearea unui Cont Abstract​

Cont Bazat pe Sesiune​

Cont Multisig​

Cont cu Recuperare Socială​

Chei de Sesiune​

Proprietățile Cheii​

Acordarea unei Chei de Sesiune​

Revocarea unei Chei de Sesiune​

Listarea Sesiunilor Active​

Reguli de Cheltuieli​

Setarea Regulilor de Cheltuieli​

Interogarea Regulilor Curente​

Exemplu de Răspuns​

Autentificatori de Portofel Conectat — Cheltuieli Delegate​

Înregistrarea unui autentificator​

Taxonomia permisiunilor​

Cheltuirea printr-o cheie conectată​

Coduri de eroare​

Interogări REST​

Interogarea Conturilor Abstracte​

CLI​

JSON-RPC​

Exemplu de Răspuns pentru Cont​

Fluxul de Recuperare Socială​

Integrare cu dApp-uri​

Pașii Următori​