Skip to content

rpcv2: align captive core meta flags with Galexie's - #1193

Merged
cjonas9 merged 3 commits into
mainfrom
align-meta-flags
Nov 16, 2026
Merged

cjonas9 merged 3 commits into
mainfrom
align-meta-flags

Conversation

@cjonas9

@cjonas9 cjonas9 commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Closes #1165.

What

RPC archive node now runs captive core with EmitVerboseMeta, the same setting galexie uses to write the data lake that RPC backfills from. That newly turns on EMIT_LEDGER_CLOSE_META_EXT_V1 and BACKFILL_STELLAR_ASSET_EVENTS. The flags v2 already set stay on.

Why

Ledger packs store meta exactly as core emits it, so a ledger ingested live from RPCv2's captive core had different bytes from the same ledger backfilled from the lake. Sharing galexie's setting keeps the two in step, which will be useful post-GA for data sharing. If they want to, an operator can still turn a flag off in their captive-core file.

Testing

Ran this change on a live pubnet RPC v2 archive node (core 30.0.0, protocol 29):

  • The generated captive-core config gains exactly two lines: EMIT_LEDGER_CLOSE_META_EXT_V1 = true and BACKFILL_STELLAR_ASSET_EVENTS = true.
  • Ledgers ingested after the restart carry the LedgerCloseMeta v1 extension. Those sampled against the data lake match its copy in fee value and length.
  • Ingestion kept pace, and responses over existing data were unchanged.

Note that the node ran this diff on top of 25c2eb0c rather than this branch, because its data predates #1082's index format change, though this should not be of any functional consequence.

Known limitations

This doesn't change that live and lake ledgers differ in several non-deterministic fields (e.g. invoke_time_nsecs within diagnostic events). Future work requiring determinism between ledger data should exclude such fields from verification.

🤖 Generated with Claude Code

@cjonas9
cjonas9 marked this pull request as ready for review November 13, 2026 19:00
@cjonas9
cjonas9 merged commit cacf185 into main Nov 16, 2026
18 checks passed
@cjonas9
cjonas9 deleted the align-meta-flags branch November 16, 2026 19:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Align the captive-core meta flags between RPC v2 and galexie

2 participants