Zum Hauptinhalt springen

WebSocket-Ereignisse

QoreChain bietet Echtzeit-Event-Streaming über zwei WebSocket-Schnittstellen: den EVM-kompatiblen WebSocket und den QoreChain-Consensus-Engine-RPC-WebSocket.

hinweis

Der RPC-WebSocket der Consensus Engine ist öffentlich sowohl im qorechain-vladi-Mainnet als auch im qorechain-diana-Testnet verfügbar. Der EVM-WebSocket ist öffentlich nur im Testnet verfügbar: Es gibt keinen öffentlichen Mainnet-EVM-WebSocket (wss://evm.qore.host und wss://evm-ws.qore.host akzeptieren keine WebSocket-Verbindungen). Betreiben Sie im Mainnet daher für eth_subscribe einen eigenen Node. Die folgenden lokalen Endpunkte setzen einen selbst betriebenen Node voraus.

SchnittstelleMainnetTestnet
RPC WebSocketwss://rpc.qore.host/websocketwss://rpc-testnet.qore.host/websocket
EVM WebSocketkeiner (nur eigener Node)wss://evm-ws-testnet.qore.host

EVM WebSocket​

Endpunkt: ws://localhost:8546 auf Ihrem eigenen Node; öffentliches Testnet: wss://evm-ws-testnet.qore.host. Es gibt keinen öffentlichen Mainnet-EVM-WebSocket.

Der EVM-WebSocket unterstützt die Standardmethode eth_subscribe für Echtzeit-Event-Streaming, das mit Ethereum-Tools kompatibel ist.

Subscription-Typen​

SubscriptionBeschreibung
newHeadsGibt einen Header aus, sobald ein neuer Block angehängt wird
logsGibt Logs aus, die einem optionalen Filter entsprechen
newPendingTransactionsGibt Transaktions-Hashes aus, die in den Mempool gelangen

Die Subscription syncing ist nicht implementiert: eth_subscribe mit "syncing" liefert -32600 syncing subscription is not implemented. Fragen Sie stattdessen eth_syncing über HTTP ab.

Neue Blöcke abonnieren​

{
  "jsonrpc": "2.0",
  "method": "eth_subscribe",
  "params": ["newHeads"],
  "id": 1
}

Logs mit Filter abonnieren​

{
  "jsonrpc": "2.0",
  "method": "eth_subscribe",
  "params": [
    "logs",
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }
  ],
  "id": 2
}

Abbestellen​

{
  "jsonrpc": "2.0",
  "method": "eth_unsubscribe",
  "params": ["0x1a2b3c..."],
  "id": 3
}

QoreChain RPC WebSocket​

Endpunkt: ws://localhost:26657/websocket auf Ihrem eigenen Node; öffentlich: wss://rpc.qore.host/websocket (Mainnet) und wss://rpc-testnet.qore.host/websocket (Testnet).

Der RPC-WebSocket nutzt das Event-Subscription-System der QoreChain Consensus Engine. Clients abonnieren mit einem Query-String, der Ereignisse nach Typ und Attributen filtert.

Alle neuen Blöcke abonnieren​

{
  "jsonrpc": "2.0",
  "method": "subscribe",
  "params": {
    "query": "tm.event='NewBlock'"
  },
  "id": 1
}

Alle Transaktionen abonnieren​

{
  "jsonrpc": "2.0",
  "method": "subscribe",
  "params": {
    "query": "tm.event='Tx'"
  },
  "id": 2
}

Modul-spezifische Ereignisse abonnieren​

Filtern Sie nach Ereignistyp, um nur Ereignisse eines bestimmten Moduls zu erhalten:

{
  "jsonrpc": "2.0",
  "method": "subscribe",
  "params": {
    "query": "tm.event='Tx' AND bridge_deposit.chain EXISTS"
  },
  "id": 3
}

Abbestellen​

{
  "jsonrpc": "2.0",
  "method": "unsubscribe",
  "params": {
    "query": "tm.event='NewBlock'"
  },
  "id": 4
}

Referenz der Modul-Ereignisse​

Ereignisse werden als Standard-Ereignisse der Consensus Engine ausgegeben. Abonnieren Sie mit einer tm.event='Tx'-Query, die nach Ereignistyp und Attribut gefiltert ist (zum Beispiel tm.event='Tx' AND bridge_deposit.chain EXISTS). Ereignisse auf Blockebene (also solche, die von der End-of-Block-Logik ausgegeben werden, wie die PRISM-Ereignisse unten) werden mit tm.event='NewBlock' zugestellt, nicht mit Tx. Die unten aufgeführten Namen und Attribute entsprechen der Chain-Version v3.2.3 (Mainnet); Ereignisse, die nur im Testnet v3.2.4 existieren, sind gekennzeichnet.

Welche Ereignisse Sie tatsächlich sehen werden

Viele dieser Module sind in den öffentlichen Netzwerken inaktiv: Die Bridge ist nicht live, es sind noch keine Multilayer-Layer oder Rollups registriert, und xQORE ist nicht nutzbar. Ihre Ereignisse sind zwar definiert, werden aber erst ausgelöst, wenn es Aktivität gibt. Die PRISM-Beobachtungs- und Belohnungsereignisse (rl_observation_collected, rl_reward_computed) werden in beiden Netzwerken etwa alle 10 Blöcke ausgegeben.

PQC-Modul​

EreignistypSchlüsselattributeBeschreibung
pqc_verifyaddress, key_type, algorithm_id, hybrid_mode, statusWird bei jeder PQC-Signaturprüfung ausgegeben
pqc_hybrid_verifyaddress, algorithm_id, statusWird bei jeder Hybrid-Signaturverifizierung ausgegeben
pqc_hybrid_classical_onlyaddress, hybrid_modeWird ausgegeben, wenn eine rein klassische Signatur vom aktuellen Modus akzeptiert wird
pqc_key_registeredaddress, key_type, algorithm_idWird ausgegeben, wenn ein PQC-Schlüssel registriert wird
pqc_key_rotatedaddress, algorithm_idWird ausgegeben, wenn ein PQC-Schlüssel rotiert wird
pqc_key_migratedaddress, from_algorithm, to_algorithmWird ausgegeben, wenn ein Schlüssel auf einen neuen Algorithmus migriert wird
pqc_evm_window_openedaddress, expiry_height, max_txs, max_value; native_only und allowed_targets, wenn das Fenster einen Scope hat (v3.2.3)Wird ausgegeben, wenn sich ein Autorisierungsfenster der EVM-Lane öffnet
pqc_evm_window_closedaddressWird ausgegeben, wenn sich ein Autorisierungsfenster der EVM-Lane schließt
pqc_evm_delegation_consentaddress, delegate, expiry_heightWird ausgegeben, wenn ein Konto seine Einwilligung zu einer EIP-7702-Delegation erfasst (v3.2.2)
pqc_evm_delegation_clearedaddress, delegateWird ausgegeben, wenn die EIP-7702-Delegation eines Kontos aufgehoben wird (v3.2.2)
pqc_algorithm_registered, pqc_algorithm_status_updated, pqc_algorithm_disabledalgorithm_id sowie name/category, old_status/new_status oder reasonÄnderungen an der Algorithmus-Registry durch die Governance

PQC-Schlüssel werden explizit mit einer Registrierungstransaktion registriert; es gibt kein Ereignis für eine automatische Registrierung.

Bridge-Modul​

EreignistypSchlüsselattributeBeschreibung
bridge_depositoperation_id, chain, asset, amount, senderWird ausgegeben, wenn eine eingehende Einzahlung erfasst wird
bridge_withdrawoperation_id, chain, asset, amount, sender, receiverWird ausgegeben, wenn eine Auszahlung erfasst wird
bridge_attestationoperation_id, validator, chain, pqc_verified, attestationsWird für jede Validator-Attestierung ausgegeben
bridge_operation_executedoperation_id, statusWird ausgegeben, wenn eine Operation abgeschlossen wird
bridge_circuit_breaker_tripchain, status, reasonWird ausgegeben, wenn der Bridge-Circuit-Breaker einer Chain auslöst

Cross-VM-Modul​

EreignistypSchlüsselattributeBeschreibung
crossvm_requestmessage_id, source_vm, target_vm, target_contract, senderWird ausgegeben, wenn ein Cross-VM-Aufruf initiiert wird
crossvm_responsemessage_id, statusWird ausgegeben, wenn ein Cross-VM-Aufruf abgeschlossen wird
crossvm_timeoutmessage_idWird ausgegeben, wenn eine Cross-VM-Nachricht das Warteschlangen-Timeout überschreitet

Multilayer-Modul​

EreignistypSchlüsselattributeBeschreibung
state_anchoredlayer_id, layer_height, state_root, main_chain_height, pqc_verified, transaction_countWird ausgegeben, wenn ein Layer-State-Anker akzeptiert wird
anchor_challengedlayer_id, layer_height, challenger, challenge_reason, resolutionWird ausgegeben, wenn ein Anker angefochten wird
layer_status_updatedlayer_id, status, reasonWird ausgegeben, wenn ein Layer seinen Status ändert
sidechain_registered, paychain_registeredlayer_id, layer_type, creator, statusWird ausgegeben, wenn ein Layer registriert wird
transaction_routedselected_layer, routing_reason, gas_savings, latency_ms, senderWird ausgegeben, wenn eine Transaktion an einen Layer geroutet wird

RDK-Modul​

EreignistypSchlüsselattributeBeschreibung
rollup_createdrollup_id, creator, profile, settlement_modeWird ausgegeben, wenn ein neuer Rollup registriert wird
rollup_paused, rollup_resumed, rollup_stoppedrollup_id und, wo angegeben, ein GrundWird ausgegeben, wenn ein Rollup pausiert, fortgesetzt oder gestoppt wird
batch_challenged, challenge_resolved, batch_rejectedrollup_id, batch_index (und fraud_upheld bei einer Auflösung)Wird ausgegeben, wenn ein Batch angefochten wird, die Anfechtung aufgelöst wird oder ein Batch abgelehnt wird
batch_submittedrollup_id, batch_index, tx_countWird ausgegeben, wenn ein Abwicklungs-Batch übermittelt wird
batch_finalizedrollup_id, batch_indexWird ausgegeben, wenn ein Batch sein Challenge-Fenster erfolgreich durchläuft
da_blob_storedrollup_id, blob_index, backend, sizeWird ausgegeben, wenn ein DA-Blob gespeichert wird
da_blob_prunedrollup_id, blob_indexWird ausgegeben, wenn ein DA-Blob nach Ablauf der Aufbewahrungsfrist entfernt wird

Burn-Modul​

EreignistypSchlüsselattributeBeschreibung
burnsource, amountWird ausgegeben, wenn Tokens dauerhaft verbrannt werden
milestone_burntx_threshold, burn_amount, cumulative_tx_countWird ausgegeben, wenn ein Meilenstein-Burn für die Transaktionsanzahl ausgeführt wird
burn_stranded_releasedamount, destination, remainingWird ausgegeben, wenn die Governance einen Teil des gestrandeten Staker-Anteils freigibt

Inflations-, Gas-Abstraction-, Lizenz-, Light-Node- und KI-Module​

EreignistypSchlüsselattributeBeschreibung
inflation_params_updatedmode, fixed_epoch_emission, max_total_emissionWird ausgegeben, wenn die Governance die Emissionsparameter ändert
gas_abstraction_conversion, gas_abstraction_refillpaid, native_equivalent, rate, price_source, resultWird ausgegeben, wenn eine Gebühr in einem anderen akzeptierten Token konvertiert wird und wenn der Float wieder aufgefüllt wird (keines davon wird ausgelöst, solange nur uqor akzeptiert wird)
gas_abstraction_float_funded, gas_abstraction_config_updatedsender, amount; accepted_tokens, block_conversion_capWird ausgegeben, wenn der Float finanziert wird und wenn die Governance die Konfiguration aktualisiert
license_granted, license_revoked, license_suspended, license_resumed, license_expiredBerechtigter und FeatureLizenz-Lebenszyklus
license_authority_updatednew_authorityWird ausgegeben, wenn die Governance die Lizenzautorität ersetzt (v3.2.3)
lightnode_register, lightnode_heartbeat, lightnode_claim_rewards, lightnode_deregister, lightnode_status_change, lightnode_reward_distribution, lightnode_reserve_releaseaddress, node_type, status, reward_amount, destinationEreignisse zu Lebenszyklus und Belohnungen von Light Nodes
ai_config_updatedmax_tx_per_minute, max_evm_tx_per_minute, anomaly_action, anomaly_thresholdWird ausgegeben, wenn die Governance die KI-Screening-Konfiguration aktualisiert

Staking-Tiers-Modul (v3.2.4)​

Diese Ereignisse gehören zum Release v3.2.4: Das qorechain-diana-Testnet gibt sie seit dem 19. Oktober 2026 aus, und das Mainnet gibt sie ab Höhe 3.742.566 aus (Governance-Vorschlag 13). Ein Mainnet-Node, der noch auf v3.2.3 läuft, hat kein Staking-Tiers-Modul und gibt keines davon aus.

EreignistypSchlüsselattributeBeschreibung
staking_tier_lock_createdlock_id, delegator, validator, amount, months, end_timeEin Delegations-Lock wurde erstellt
staking_tier_lock_unlocked_early, staking_tier_lock_releasedlock_id, delegator, penalty_burned, bonus_forfeitedEin Lock wurde vorzeitig beendet (die Strafe wird unter der Burn-Quelle staking_tier_penalty verbrannt) oder hat sein Ende erreicht
staking_tier_bonus_claimed, staking_tier_bonus_settleddelegator, amount; AbrechnungssummenEin Bonus wurde beansprucht; der Pool wurde abgerechnet
staking_tier_params_updatedParameterDie Governance hat die Modulparameter geändert

xQORE-Modul​

Diese Ereignisse werden noch nicht ausgegeben: xQORE ist in keinem veröffentlichten Node-Build live (siehe xQORE Staking).

EreignistypSchlüsselattributeBeschreibung
xqore_lockowner, amountWird ausgegeben, wenn QOR in xQORE gesperrt wird
xqore_unlockowner, amount, penalty, burned, redistributed, returnedWird ausgegeben, wenn xQORE zurück in QOR entsperrt wird

PRISM-Konsens-Modul (RL-Konsens)​

Dies sind End-of-Block-Ereignisse, die über den NewBlock-Stream zugestellt werden.

EreignistypSchlüsselattributeBeschreibung
rl_observation_collectedheightWird ausgegeben, wenn eine PRISM-Beobachtung erfasst wird (etwa alle 10 Blöcke)
rl_reward_computedheight, rewardWird ausgegeben, wenn die PRISM-Belohnung berechnet wird
rl_action_appliedheight, agent_modeWird ausgegeben, wenn der PRISM-Agent eine Parameteranpassung vornimmt
rl_agent_mode_changedheight, agent_modeWird ausgegeben, wenn sich der Agentenmodus ändert
rl_circuit_breaker_triggeredheightWird ausgegeben, wenn der PRISM-Circuit-Breaker eine Aktion blockiert
rl_circuit_breaker_recoveredheightWird ausgegeben, wenn sich der Circuit-Breaker erholt

KI-Modul​

EreignistypSchlüsselattributeBeschreibung
ai_anomaly_checkscore_millionths, action, is_anomalousWird für jede auf Anomalien bewertete Transaktion ausgegeben

JavaScript-Client-Beispiel​

EVM WebSocket (ethers.js)​

import { ethers } from "ethers";

// Own node: ws://localhost:8546. Public testnet: wss://evm-ws-testnet.qore.host
const provider = new ethers.WebSocketProvider("ws://localhost:8546");

// Subscribe to new blocks
provider.on("block", (blockNumber) => {
  console.log("New block:", blockNumber);
});

// Subscribe to contract events
const filter = {
  address: "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
  topics: [ethers.id("Transfer(address,address,uint256)")],
};
provider.on(filter, (log) => {
  console.log("Transfer event:", log);
});

QoreChain RPC WebSocket (Native)​

// Own node: ws://localhost:26657/websocket. Public: wss://rpc.qore.host/websocket
const ws = new WebSocket("ws://localhost:26657/websocket");

ws.onopen = () => {
  // Subscribe to bridge deposits
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    method: "subscribe",
    params: { query: "tm.event='Tx' AND bridge_deposit.chain EXISTS" },
    id: 1,
  }));

  // Subscribe to rollup batch submissions
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    method: "subscribe",
    params: { query: "tm.event='Tx' AND batch_submitted.rollup_id EXISTS" },
    id: 2,
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.result && data.result.events) {
    console.log("Event received:", data.result.events);
  }
};

Hinweise​

  • Verbindungslimits: Auf einem selbst betriebenen Node ist die standardmäßige maximale Anzahl an WebSocket-Verbindungen unbegrenzt (max-open-connections = 0). Legen Sie für Produktionsumgebungen ein Limit in app.toml fest. Die öffentlichen Endpunkte wenden eigene Limits an.
  • Ereignispuffer: Der RPC-WebSocket puffert pro Subscription eine begrenzte Anzahl von Ereignissen (Standard sind 200 auf einem selbst gehosteten Node). Wenn der Client in Rückstand gerät, werden ältere Ereignisse verworfen.
  • Wiederverbindung: Clients sollten eine automatische Wiederverbindung mit exponentiellem Backoff implementieren, da WebSocket-Verbindungen bei Node-Neustarts oder -Upgrades unterbrochen werden können.