웹소켓 이벤트

QoreChain은 EVM 호환 웹소켓과 QoreChain 컨센서스 엔진 RPC 웹소켓, 두 가지 웹소켓 인터페이스를 통해 실시간 이벤트 스트리밍을 제공합니다.

노트

컨센서스 엔진 RPC 웹소켓은 qorechain-vladi 메인넷과 qorechain-diana 테스트넷 모두에서 공개적으로 사용할 수 있습니다. EVM 웹소켓은 테스트넷에서만 공개적으로 사용할 수 있습니다. 공개 메인넷 EVM 웹소켓은 없으며(wss://evm.qore.host와 wss://evm-ws.qore.host는 웹소켓 연결을 받지 않습니다), 따라서 메인넷에서 eth_subscribe를 사용하려면 직접 노드를 실행하십시오. 아래의 로컬 엔드포인트는 직접 실행하는 노드를 기준으로 합니다.

인터페이스	메인넷	테스트넷
RPC 웹소켓	`wss://rpc.qore.host/websocket`	`wss://rpc-testnet.qore.host/websocket`
EVM 웹소켓	없음 (자체 노드만 가능)	`wss://evm-ws-testnet.qore.host`

EVM 웹소켓

엔드포인트: 직접 실행하는 노드에서는 ws://localhost:8546, 공개 테스트넷은 wss://evm-ws-testnet.qore.host입니다. 공개 메인넷 EVM 웹소켓은 없습니다.

EVM 웹소켓은 이더리움 툴링과 호환되는 실시간 이벤트 스트리밍을 위해 표준 eth_subscribe 메서드를 지원합니다.

구독 유형

구독	설명
`newHeads`	새 블록이 추가될 때마다 헤더를 전송합니다
`logs`	선택적 필터와 일치하는 로그를 전송합니다
`newPendingTransactions`	멤풀에 들어오는 트랜잭션 해시를 전송합니다

syncing 구독은 구현되어 있지 않습니다. "syncing"을 사용한 eth_subscribe는 -32600 syncing subscription is not implemented를 반환합니다. 대신 HTTP로 eth_syncing을 폴링하십시오.

새 블록 구독하기

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

필터를 사용해 로그 구독하기

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

구독 취소하기

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

QoreChain RPC 웹소켓

엔드포인트: 직접 실행하는 노드에서는 ws://localhost:26657/websocket, 공개 엔드포인트는 wss://rpc.qore.host/websocket(메인넷)과 wss://rpc-testnet.qore.host/websocket(테스트넷)입니다.

RPC 웹소켓은 QoreChain 컨센서스 엔진의 이벤트 구독 시스템을 사용합니다. 클라이언트는 이벤트 유형과 속성으로 필터링하는 쿼리 문자열을 사용해 구독합니다.

모든 새 블록 구독하기

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

모든 트랜잭션 구독하기

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

모듈별 이벤트 구독하기

이벤트 유형으로 필터링하여 특정 모듈의 이벤트만 수신합니다.

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

구독 취소하기

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

모듈 이벤트 레퍼런스

이벤트는 표준 컨센서스 엔진 이벤트로 발생합니다. 이벤트 유형과 속성으로 필터링한 tm.event='Tx' 쿼리로 구독하십시오(예: tm.event='Tx' AND bridge_deposit.chain EXISTS). 블록 종료 로직에서 발생하는 블록 수준 이벤트(아래의 PRISM 이벤트 등)는 Tx가 아니라 tm.event='NewBlock'으로 전달됩니다. 아래의 이름과 속성은 체인 버전 v3.2.3(메인넷) 기준이며, v3.2.4 테스트넷에만 존재하는 이벤트는 따로 표시되어 있습니다.

실제로 볼 수 있는 이벤트

이 모듈 중 상당수는 공개 네트워크에서 유휴 상태입니다. 브리지는 아직 가동되지 않았고, 등록된 멀티레이어 레이어나 롤업도 아직 없으며, xQORE는 사용할 수 없습니다. 이들 이벤트는 정의되어 있지만 활동이 생기기 전까지는 발생하지 않습니다. PRISM 관찰 및 보상 이벤트(rl_observation_collected, rl_reward_computed)는 두 네트워크 모두에서 약 10블록마다 발생합니다.

PQC 모듈

이벤트 유형	주요 속성	설명
`pqc_verify`	`address`, `key_type`, `algorithm_id`, `hybrid_mode`, `status`	각 PQC 서명 검사 시 발생합니다
`pqc_hybrid_verify`	`address`, `algorithm_id`, `status`	각 하이브리드 서명 검증 시 발생합니다
`pqc_hybrid_classical_only`	`address`, `hybrid_mode`	현재 모드에서 클래식 전용 서명이 수락될 때 발생합니다
`pqc_key_registered`	`address`, `key_type`, `algorithm_id`	PQC 키가 등록될 때 발생합니다
`pqc_key_rotated`	`address`, `algorithm_id`	PQC 키가 교체될 때 발생합니다
`pqc_key_migrated`	`address`, `from_algorithm`, `to_algorithm`	키가 새 알고리즘으로 마이그레이션될 때 발생합니다
`pqc_evm_window_opened`	`address`, `expiry_height`, `max_txs`, `max_value`; 윈도우에 범위가 지정된 경우 `native_only`와 `allowed_targets`(v3.2.3)	EVM 레인 승인 윈도우가 열릴 때 발생합니다
`pqc_evm_window_closed`	`address`	EVM 레인 승인 윈도우가 닫힐 때 발생합니다
`pqc_evm_delegation_consent`	`address`, `delegate`, `expiry_height`	계정이 EIP-7702 위임에 대한 동의를 기록할 때 발생합니다(v3.2.2)
`pqc_evm_delegation_cleared`	`address`, `delegate`	계정의 EIP-7702 위임이 해제될 때 발생합니다(v3.2.2)
`pqc_algorithm_registered`, `pqc_algorithm_status_updated`, `pqc_algorithm_disabled`	`algorithm_id`, 그리고 `name`/`category`, `old_status`/`new_status` 또는 `reason`	거버넌스에 의한 알고리즘 레지스트리 변경

PQC 키는 등록 트랜잭션으로 명시적으로 등록됩니다. 자동 등록 이벤트는 없습니다.

브리지 모듈

이벤트 유형	주요 속성	설명
`bridge_deposit`	`operation_id`, `chain`, `asset`, `amount`, `sender`	인바운드 입금이 기록될 때 발생합니다
`bridge_withdraw`	`operation_id`, `chain`, `asset`, `amount`, `sender`, `receiver`	출금이 기록될 때 발생합니다
`bridge_attestation`	`operation_id`, `validator`, `chain`, `pqc_verified`, `attestations`	각 검증자 증명(attestation)마다 발생합니다
`bridge_operation_executed`	`operation_id`, `status`	작업이 완료될 때 발생합니다
`bridge_circuit_breaker_trip`	`chain`, `status`, `reason`	체인의 브리지 서킷 브레이커가 작동할 때 발생합니다

크로스VM 모듈

이벤트 유형	주요 속성	설명
`crossvm_request`	`message_id`, `source_vm`, `target_vm`, `target_contract`, `sender`	크로스VM 호출이 시작될 때 발생합니다
`crossvm_response`	`message_id`, `status`	크로스VM 호출이 완료될 때 발생합니다
`crossvm_timeout`	`message_id`	크로스VM 메시지가 대기열 제한 시간을 초과할 때 발생합니다

멀티레이어 모듈

이벤트 유형	주요 속성	설명
`state_anchored`	`layer_id`, `layer_height`, `state_root`, `main_chain_height`, `pqc_verified`, `transaction_count`	레이어 상태 앵커가 수락될 때 발생합니다
`anchor_challenged`	`layer_id`, `layer_height`, `challenger`, `challenge_reason`, `resolution`	앵커에 이의가 제기될 때 발생합니다
`layer_status_updated`	`layer_id`, `status`, `reason`	레이어 상태가 변경될 때 발생합니다
`sidechain_registered`, `paychain_registered`	`layer_id`, `layer_type`, `creator`, `status`	레이어가 등록될 때 발생합니다
`transaction_routed`	`selected_layer`, `routing_reason`, `gas_savings`, `latency_ms`, `sender`	트랜잭션이 레이어로 라우팅될 때 발생합니다

RDK 모듈

이벤트 유형	주요 속성	설명
`rollup_created`	`rollup_id`, `creator`, `profile`, `settlement_mode`	새 롤업이 등록될 때 발생합니다
`rollup_paused`, `rollup_resumed`, `rollup_stopped`	`rollup_id`와 주어진 경우 사유	롤업이 일시 중지, 재개 또는 중단될 때 발생합니다
`batch_challenged`, `challenge_resolved`, `batch_rejected`	`rollup_id`, `batch_index`(그리고 해결 시 `fraud_upheld`)	배치에 이의가 제기되거나, 이의가 해결되거나, 배치가 거부될 때 발생합니다
`batch_submitted`	`rollup_id`, `batch_index`, `tx_count`	정산 배치가 제출될 때 발생합니다
`batch_finalized`	`rollup_id`, `batch_index`	배치가 챌린지 기간을 통과할 때 발생합니다
`da_blob_stored`	`rollup_id`, `blob_index`, `backend`, `size`	DA 블롭이 저장될 때 발생합니다
`da_blob_pruned`	`rollup_id`, `blob_index`	보존 기간이 지난 후 DA 블롭이 정리(pruning)될 때 발생합니다

소각 모듈

이벤트 유형	주요 속성	설명
`burn`	`source`, `amount`	토큰이 영구적으로 소각될 때 발생합니다
`milestone_burn`	`tx_threshold`, `burn_amount`, `cumulative_tx_count`	트랜잭션 수 마일스톤 소각이 실행될 때 발생합니다
`burn_stranded_released`	`amount`, `destination`, `remaining`	거버넌스가 묶여 있던 스테이커 몫의 일부를 해제할 때 발생합니다

인플레이션, 가스 추상화, 라이선스, 라이트 노드 및 AI 모듈

이벤트 유형	주요 속성	설명
`inflation_params_updated`	`mode`, `fixed_epoch_emission`, `max_total_emission`	거버넌스가 발행 파라미터를 변경할 때 발생합니다
`gas_abstraction_conversion`, `gas_abstraction_refill`	`paid`, `native_equivalent`, `rate`, `price_source`, `result`	허용된 다른 토큰으로 지불된 수수료가 변환될 때, 그리고 플로트가 다시 채워질 때 발생합니다(`uqor`만 허용되는 동안에는 발생하지 않음)
`gas_abstraction_float_funded`, `gas_abstraction_config_updated`	`sender`, `amount`; `accepted_tokens`, `block_conversion_cap`	플로트에 자금이 공급될 때, 그리고 거버넌스가 구성을 업데이트할 때 발생합니다
`license_granted`, `license_revoked`, `license_suspended`, `license_resumed`, `license_expired`	피부여자와 기능	라이선스 수명 주기
`license_authority_updated`	`new_authority`	거버넌스가 라이선스 권한자를 교체할 때 발생합니다(v3.2.3)
`lightnode_register`, `lightnode_heartbeat`, `lightnode_claim_rewards`, `lightnode_deregister`, `lightnode_status_change`, `lightnode_reward_distribution`, `lightnode_reserve_release`	`address`, `node_type`, `status`, `reward_amount`, `destination`	라이트 노드 수명 주기 및 보상 이벤트
`ai_config_updated`	`max_tx_per_minute`, `max_evm_tx_per_minute`, `anomaly_action`, `anomaly_threshold`	거버넌스가 AI 스크리닝 구성을 업데이트할 때 발생합니다

스테이킹 티어 모듈 (v3.2.4)

이 이벤트들은 v3.2.4 릴리스와 함께 제공됩니다. qorechain-diana 테스트넷은 2026년 10월 19일부터 이를 발생시키고 있으며 메인넷은 높이 3,742,566부터 발생시킵니다(거버넌스 제안 13). 아직 v3.2.3인 메인넷 노드에는 스테이킹 티어 모듈이 없으므로 이 이벤트를 하나도 발생시키지 않습니다.

이벤트 유형	주요 속성	설명
`staking_tier_lock_created`	`lock_id`, `delegator`, `validator`, `amount`, `months`, `end_time`	위임 락이 생성되었습니다
`staking_tier_lock_unlocked_early`, `staking_tier_lock_released`	`lock_id`, `delegator`, `penalty_burned`, `bonus_forfeited`	락이 조기에 종료되었거나(페널티는 `staking_tier_penalty` 소각 소스로 소각됩니다) 만기에 도달했습니다
`staking_tier_bonus_claimed`, `staking_tier_bonus_settled`	`delegator`, `amount`; 정산 합계	보너스가 청구되었습니다. 풀이 정산되었습니다
`staking_tier_params_updated`	파라미터	거버넌스가 모듈 파라미터를 변경했습니다

xQORE 모듈

이 이벤트들은 아직 발생하지 않습니다. xQORE는 배포된 어떤 노드 빌드에서도 가동되지 않았습니다(xQORE 스테이킹 참조).

이벤트 유형	주요 속성	설명
`xqore_lock`	`owner`, `amount`	QOR이 xQORE로 잠길 때 발생합니다
`xqore_unlock`	`owner`, `amount`, `penalty`, `burned`, `redistributed`, `returned`	xQORE가 QOR로 잠금 해제될 때 발생합니다

PRISM 컨센서스(RL 컨센서스) 모듈

이들은 블록 종료 이벤트이며 NewBlock 스트림으로 전달됩니다.

이벤트 유형	주요 속성	설명
`rl_observation_collected`	`height`	PRISM 관찰이 수행될 때 발생합니다 (약 10블록마다)
`rl_reward_computed`	`height`, `reward`	PRISM 보상이 계산될 때 발생합니다
`rl_action_applied`	`height`, `agent_mode`	PRISM 에이전트가 파라미터 조정을 적용할 때 발생합니다
`rl_agent_mode_changed`	`height`, `agent_mode`	에이전트 모드가 변경될 때 발생합니다
`rl_circuit_breaker_triggered`	`height`	PRISM 서킷 브레이커가 작업을 차단할 때 발생합니다
`rl_circuit_breaker_recovered`	`height`	서킷 브레이커가 복구될 때 발생합니다

AI 모듈

이벤트 유형	주요 속성	설명
`ai_anomaly_check`	`score_millionths`, `action`, `is_anomalous`	이상 점수가 매겨진 각 트랜잭션마다 발생합니다

자바스크립트 클라이언트 예제

EVM 웹소켓 (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 웹소켓 (네이티브)

// 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);
  }
};

참고 사항

연결 제한: 직접 실행하는 노드에서는 웹소켓 연결의 기본 최대 개수가 무제한입니다 (max-open-connections = 0). 프로덕션 배포 시에는 app.toml에서 제한을 설정하십시오. 공개 엔드포인트에는 자체 제한이 적용됩니다.
이벤트 버퍼: RPC 웹소켓은 구독당 제한된 수의 이벤트를 버퍼링합니다 (자체 호스팅 노드의 기본값은 200개). 클라이언트가 처리 속도를 따라가지 못하면 오래된 이벤트부터 삭제됩니다.
재연결: 노드 재시작이나 업그레이드 중 웹소켓 연결이 끊길 수 있으므로, 클라이언트는 지수 백오프를 적용한 자동 재연결을 구현해야 합니다.

EVM 웹소켓​

구독 유형​

새 블록 구독하기​

필터를 사용해 로그 구독하기​

구독 취소하기​

QoreChain RPC 웹소켓​

모든 새 블록 구독하기​

모든 트랜잭션 구독하기​

모듈별 이벤트 구독하기​

구독 취소하기​

모듈 이벤트 레퍼런스​

PQC 모듈​

브리지 모듈​

크로스VM 모듈​

멀티레이어 모듈​

RDK 모듈​

소각 모듈​

인플레이션, 가스 추상화, 라이선스, 라이트 노드 및 AI 모듈​

스테이킹 티어 모듈 (v3.2.4)​

xQORE 모듈​

PRISM 컨센서스(RL 컨센서스) 모듈​

AI 모듈​

자바스크립트 클라이언트 예제​

EVM 웹소켓 (ethers.js)​

QoreChain RPC 웹소켓 (네이티브)​

참고 사항​

EVM 웹소켓

구독 유형

새 블록 구독하기

필터를 사용해 로그 구독하기

구독 취소하기

QoreChain RPC 웹소켓

모든 새 블록 구독하기

모든 트랜잭션 구독하기

모듈별 이벤트 구독하기

구독 취소하기

모듈 이벤트 레퍼런스

PQC 모듈

브리지 모듈

크로스VM 모듈

멀티레이어 모듈

RDK 모듈

소각 모듈

인플레이션, 가스 추상화, 라이선스, 라이트 노드 및 AI 모듈

스테이킹 티어 모듈 (v3.2.4)

xQORE 모듈

PRISM 컨센서스(RL 컨센서스) 모듈

AI 모듈

자바스크립트 클라이언트 예제

EVM 웹소켓 (ethers.js)

QoreChain RPC 웹소켓 (네이티브)

참고 사항