curate-version-fixtures

Curate FilePlugin fixtures for a poktroll version from the Hetzner archeology bucket — download, scan, select per spec §8.1, generate expected.json, enroll in the golden walker. Use when a new version's tarball lands in the bucket (v0.1.30 / v0.1.31 / v0.1.33 pending as of 2026-06-10) or when refreshing an era's coverage.

Jump to install

Repository: pokt-network/pocket-scribe
Last source activity: June 10, 2026 at 21:49
Detected SKILL.md language: English
Stars: 0
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/pokt-network/pocket-scribe --skill curate-version-fixtures

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

add-decoder-version

Onboard a new poktroll chain version — vendor protos, codegen, scaffold decoder, register in router, add CI matrix. Use when poktroll publishes a new release that introduces protobuf changes.

2026-06-10

add-aggregate

Scaffold a new continuous aggregate (rewards_hourly, claims_daily, etc.) following PocketScribe's registry-driven pattern with bucket sealing. Generates migration, registry entry, sealing test, and late-arrival test.

2026-06-08

add-consumer

Scaffold a new consumer module (supplier, application, gateway, etc.) following PocketScribe patterns — generates the consumer Go code, SQL migration, tests, and CLI registration. Enforces TDD by generating tests first.

2026-06-08

View all from this repository

Curate version fixtures

When

A new poktroll version's <ver>-h<H>-fileplugin.tar.xz appears in pocketscribe-hetzner:pocketscribe-mainnet-archeology/mainnet/<ver>/ (check: rclone lsf pocketscribe-hetzner:pocketscribe-mainnet-archeology/mainnet/). As of 2026-06-10 the archeology run on multi-1 has not yet uploaded v0.1.30, v0.1.31, v0.1.33.

Steps

scripts/curate_fixtures.sh <ver> — downloads (sha256-verified), extracts to /tmp/fixtures-/, prints the per-height activity index.

Select ~3 heights per spec §8.1 (docs/superpowers/specs/2026-06-08-slice-1-design.md:356): boundary block (applied_height — confirm against the upgrades table or internal/fixturereport/mainnet.go), max supplier activity, quiet block.

Era dir: the decoder version DecoderFor(H) resolves to — confirm with the stderr decoder: line in step 4. New break version → new era dir AND follow .claude/rules/decoders.md rules 9–10 FIRST (machine-derived closure diff; never assume stability).

Per height H: cp /tmp/fixtures-/block--{meta,data} test/fixtures// go run ./tools/fixtureextract test/fixtures/ \

test/fixtures//block--expected.json

If the version is NOT yet in internal/fixturereport/mainnet.go: add it (Name dotted, AppliedAtHeight from ps sync-upgrades / the chain, DecoderVersion underscored) and extend internal/router/mainnet_boundaries_test.go with the new boundary row. Remember: consumer wakeup is restart-based — after ps sync-upgrades lands a version that wakes a dormant consumer, restart that consumer.

go test ./internal/fixturereport/ -run TestGoldenWalk — must pass.

Update test/fixtures/README.md matrix row (PENDING → covered).

Optionally add a full-stack row in test/integration/ (see supplier_consumer_test.go cases table) for new eras.

rm -rf /tmp/fixtures-<ver>; commit test(fixtures): curate <ver> fixtures (spec §8.1).