Skip to content

Refactor instance tests around a network harness - #508

Open
samliok wants to merge 24 commits into
mainfrom
instance-test-refactor
Open

Refactor instance tests around a network harness#508
samliok wants to merge 24 commits into
mainfrom
instance-test-refactor

Conversation

@samliok

@samliok samliok commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

Final PR of the cleanup-instance stack (4/4), on top of the transition listener PR.

  • All scaffolding moves to instance_testhelpers_test.go, rebuilt around a network harness: addNode, acceptNewBlock, waitUntilSealingBlock. The queue-based inMemNetwork is replaced by instanceComm, which delivers messages directly and re-parses blocks so recipients do not share mutable canoto state.
  • instance_test.go becomes short scenario tests. Epoch sealing tests now rely on production approval/aux info dissemination instead of hand-injecting approvals (removing the old TODO).
  • New coverage: validator set unchanged/decreased, a validator skipping an epoch, and signer-set assertions proving a promoted non-validator contributes its approval.
  • TestParseBlockSizeMatchesBytes moves verbatim to external_test.go next to external.go.
  • TestNonValidator_StaysNonValidator (replacing TestInstanceNonValidatorBootstraps) is skipped pending offline-node timeouts, and TestInstanceRestartAcrossEpochs is dropped (the node.restart() helper remains unused).

@samliok
samliok force-pushed the instance-test-refactor branch from 97c53ab to d147e3d Compare August 19, 2026 18:25
@samliok
samliok marked this pull request as ready for review August 20, 2026 21:53
@samliok samliok closed this Aug 21, 2026
@samliok
samliok force-pushed the instance-test-refactor branch from 4bb3bc9 to 5040547 Compare August 21, 2026 15:15
@samliok samliok reopened this Aug 21, 2026
Comment thread instance_test.go Outdated
// order to do so.
// We then check does so by checking they participated in signing
// Equivalent test as the previous TestInstanceMixedNodeType.
func TestNonValidator_BecomesValidator(t *testing.T) {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

equivalent to the previous: TestInstanceMixedNodeType

Comment thread instance_test.go Outdated
// TestNonValidator_StaysNonValidator ensures that a non-validator does not restart when it is processing
// previous epoch changes.
// Equivalent to TestInstanceNonValidatorBootstraps
func TestNonValidator_StaysNonValidator(t *testing.T) {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

previously was TestInstanceNonValidatorBootstraps

Comment thread instance_test.go
// then it is no longer a validator, and finally it is
// Equivalent to: TestInstanceValidatorSkipsAnEpoch. This also starts a validator when the tip is a sealing block so it covers an edge
// case previously caught from the logging test.
func TestInstanceValidatorSkipsAnEpoch(t *testing.T) {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Equivalent to: TestInstanceValidatorSkipsAnEpoch. This also starts a validator when the tip is a sealing block so it covers an edge case previously caught from the logging test.

@samliok
samliok force-pushed the instance-test-refactor branch 2 times, most recently from 7ff7591 to ed0e6d5 Compare August 21, 2026 15:43
@samliok
samliok force-pushed the instance-test-refactor branch from ed0e6d5 to ac05817 Compare August 21, 2026 15:56
@samliok
samliok force-pushed the instance-test-refactor branch from ac05817 to 070a524 Compare August 21, 2026 16:01
@samliok samliok linked an issue Aug 21, 2026 that may be closed by this pull request
@samliok
samliok force-pushed the instance-test-refactor branch from 070a524 to 4ac8236 Compare August 24, 2026 21:33
@samliok
samliok force-pushed the instance-test-refactor branch from 4ac8236 to 569e39c Compare August 26, 2026 14:13
@samliok
samliok force-pushed the instance-test-refactor branch from 569e39c to 274e913 Compare August 26, 2026 14:20
@samliok
samliok force-pushed the instance-test-refactor branch from dbea945 to 6287af1 Compare August 26, 2026 21:17
@samliok
samliok force-pushed the instance-test-refactor branch from 6287af1 to f933854 Compare August 27, 2026 20:09
@samliok
samliok force-pushed the instance-test-refactor branch from f933854 to d4522b2 Compare August 31, 2026 14:04
Comment thread instance_test.go Outdated
Comment thread instance_test.go Outdated
Comment thread instance_test.go
@samliok
samliok force-pushed the instance-test-refactor branch 2 times, most recently from d9552c3 to e86e081 Compare September 3, 2026 22:51
The test covers ParsedBlock's Size and Bytes, which live in external.go, so it
belongs beside them rather than in the instance tests. The body is unchanged.
Every one of them is rewritten against the network harness that follows, so
they come out wholesale rather than being edited in place. The file is left
holding only the helpers.
The per-test instance constructors, the storage polling helpers, testVM, the
inMemNetwork message router and its networkSender all go away with the tests
that used them. Trims the imports that went unused with them.
The file now holds only helpers. The new instance tests land in a fresh
instance_test.go later in the series.
MockStorage parses stored blocks through an injected testInnerBlockDeserializer
instead of the package level parseTestInnerBlock, and hands its WAL bookkeeping
to a standalone walCreator. testPlatformChain wakes WaitForProgress waiters over
a channel rather than a sync.Cond, looks up validator sets by exact height, and
lets a test install a set at a height. reparseBlock inlines toRawBlock.
A network drives a set of nodes over an instanceComm that hands each message
straight to the destination instance, and steps the chain one block at a time
through a blockBuilderVM gated by a controlled block builder. Nodes start from
a storage seeded with genesis, or from newChainStorage when a test needs the
epoch defining block at the tip.
Each test builds a network and steps it a block at a time. Covers the epoch
transition paths the old tests skipped: a non validator that becomes a
validator, a validator dropped from the set, a node offline across a
transition, and a validator that misses an epoch entirely.
adapters_test.go builds its node through the network harness instead of wiring
an instance by hand, util_test.go follows the newTestPChain rename, and the
instance logs the validator set it is notified of on an epoch change.
@samliok
samliok force-pushed the instance-test-refactor branch from e86e081 to 48563fc Compare September 3, 2026 23:02
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.

Test flake in TestInstanceRestartAcrossEpochs

2 participants