Skip to content

Instantly share code, notes, and snippets.

@IzioDev
Last active March 3, 2026 00:33
Show Gist options
  • Select an option

  • Save IzioDev/b3fd0048d928675a50d50aad59afc4dd to your computer and use it in GitHub Desktop.

Select an option

Save IzioDev/b3fd0048d928675a50d50aad59afc4dd to your computer and use it in GitHub Desktop.
VSCP V2 - High level notes

Specifications

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.

RPC

Operation: GetVirtualChainFromBlockV2
Opcode: RpcApiOps::GetVirtualChainFromBlockV2 = 151

Input / Output

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[]

Types

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 GetVirtualChainFromBlock is unchanged.
  • Verbosity is incremental (Full includes High, Low, and None).
  • If dataVerbosityLevel is omitted, server defaults to Full.
  • minConfirmationCount filters returned added-chain blocks by confirmation distance from the virtual tip.

Proto

GetVirtualChainFromBlockV2RequestMessage getVirtualChainFromBlockV2Request = 1114; GetVirtualChainFromBlockV2ResponseMessage getVirtualChainFromBlockV2Response = 1115;

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment