Description
Adds GetVirtualChainFromBlockV2, a non-breaking virtual-chain RPC that returns chain updates together with per-chain-block accepted transaction data, controlled by an optional incremental verbosity level.
Operation: GetVirtualChainFromBlockV2
Opcode: RpcApiOps::GetVirtualChainFromBlockV2 = 151
| Direction | Field | Type | Notes |
|---|---|---|---|
| In | startHash |
Hash |
Required |
| In | dataVerbosityLevel? |
None | Low | High | Full |
Optional; incremental |
| In | minConfirmationCount? |
u64 |
Optional; filters added-chain blocks |
| Out | removedChainBlockHashes |
Hash[] |
|
| Out | addedChainBlockHashes |
Hash[] |
|
| Out | chainBlockAcceptedTransactions |
RpcChainBlockAcceptedTransactions[] |
RpcChainBlockAcceptedTransactions {
chainBlockHeader: RpcOptionalHeader, // accepting chain block header (verbosity-gated)
acceptedTransactions: RpcOptionalTransaction[], // transactions accepted by that chain block (verbosity-gated)
}Notes
- Non-breaking addition: existing
GetVirtualChainFromBlockis unchanged. - Verbosity is incremental (
FullincludesHigh,Low, andNone). - If
dataVerbosityLevelis omitted, server defaults toFull. minConfirmationCountfilters returned added-chain blocks by confirmation distance from the virtual tip.
Proto
GetVirtualChainFromBlockV2RequestMessage getVirtualChainFromBlockV2Request = 1114;
GetVirtualChainFromBlockV2ResponseMessage getVirtualChainFromBlockV2Response = 1115;