Ability to create generic forked state and run network using prepared state

[MrWad3r]

Pull Request Checklist

NODE CONFIGURATION MODEL CHANGES

[None]

BLOCKCHAIN CONFIGURATION MODEL CHANGES

[None]

---

COMPATIBILITY

Fully compatible

Affected features:

• [State]
• [Persistent State]
• [Queue. Diff]
• [Collator]

Removed hardcoded checks for seqno == 0 in the collator and message queue logic. These checks were replaced with comparisons against zerostate_id.seqno, ensuring correct behavior when starting execution from a non-zero zerostate sequence number.

SPECIAL DEPLOYMENT ACTIONS

[Not Required]

---

PERFORMANCE IMPACT

[No impact expected]

---

TESTS

Unit Tests

[Covered by:]

Previous existing collator and queue tests

Network Tests

[No coverage]

Manual Tests

1. Start a local network consisting of three validator nodes. Allow the network to run until multiple masterchain and shard blocks are produced.
2. Stop the network. Using the new CLI command, generate zerostate files corresponding to a specified masterchain block.
3. Decompress the generated zerostate files using zstd.
4. Restart the network using the decompressed zerostate files as the initial state. The network must resume execution starting from the specified masterchain zerostate block.

Additionally, a Python virtual environment (venv) was used to set up tooling for token transfers from the giver account to a generic account. All transfer operations completed successfully, confirming correct network behavior.

[github-actions]

🧪 Network Tests

To run network tests for this PR, use:

gh workflow run network-tests.yml -f pr_number=975

Available test options:

• Run all tests: gh workflow run network-tests.yml -f pr_number=975
• Run specific test: gh workflow run network-tests.yml -f pr_number=975 -f test_selection=ping-pong

Test types: destroyable, ping-pong, one-to-many-internal-messages, fq-deploy, nft-index, persistent-sync

Results will be posted as workflow runs in the Actions tab.

[codecov]

Codecov Report

❌ Patch coverage is 24.15254% with 537 lines in your changes missing coverage. Please review.
✅ Project coverage is 46.06%. Comparing base (4e0f1cc) to head (baaec66).
⚠️ Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
cli/src/cmd/tools/hardfork.rs	0.00%	196 Missing ⚠️
core/src/block_strider/starter/cold_boot.rs	0.00%	125 Missing ⚠️
core/src/storage/node_state/mod.rs	24.56%	38 Missing and 5 partials ⚠️
...src/storage/persistent_state/shard_state/writer.rs	66.66%	16 Missing and 7 partials ⚠️
block-util/src/block/block_proof_stuff.rs	0.00%	15 Missing ⚠️
core/src/storage/shard_state/mod.rs	0.00%	15 Missing ⚠️
cli/src/node/mod.rs	0.00%	14 Missing ⚠️
core/src/storage/persistent_state/mod.rs	13.33%	13 Missing ⚠️
collator/src/manager/mod.rs	58.33%	10 Missing ⚠️
core/src/block_strider/provider/mod.rs	73.68%	7 Missing and 3 partials ⚠️
... and 17 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #975      +/-   ##
==========================================
- Coverage   46.30%   46.06%   -0.25%     
==========================================
  Files         357      361       +4     
  Lines       62235    63049     +814     
  Branches    62235    63049     +814     
==========================================
+ Hits        28820    29044     +224     
- Misses      31914    32482     +568     
- Partials     1501     1523      +22     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

❌ CLI reference check failed in CI.

Please run just update_cli_reference, add the updated docs/cli-reference.md, and push the changes.

[0xdeafbeef]

tycho/collator/src/collator/do_collate/finalize.rs

Lines 102 to 105 in 9680b4d

	for top_block_id in top_other_updated_shard_blocks_ids.iter() {
	if top_block_id.seqno == 0 {
	continue;
	}

Should this be also checked?

[github-actions]

❌ CLI reference check failed in CI.

Please run just update_cli_reference, add the updated docs/cli-reference.md, and push the changes.

[github-actions]

❌ CLI reference check failed in CI.

Please run just update_cli_reference, add the updated docs/cli-reference.md, and push the changes.