Skip to content

Add read-only deployed-cluster swap readiness - #53

Closed
joshglogau wants to merge 12 commits into
masterfrom
feature/cluster-readiness
Closed

Add read-only deployed-cluster swap readiness#53
joshglogau wants to merge 12 commits into
masterfrom
feature/cluster-readiness

Conversation

@joshglogau

@joshglogau joshglogau commented Aug 4, 2026

Copy link
Copy Markdown

Summary

Adds a manual, read-only wire-cluster-tool readiness preflight for an already deployed Wire/Ethereum/Solana network group. It reuses existing Steps, PhaseGroups, Reports, and typed SDK clients; it is not wired into bootstrap, Hub, or CI.

Verdicts

  • Cluster liveness and identity are evaluated independently from swap preflight.
  • Transactional swap readiness remains false until funded settlement evidence exists.
  • Optional SDK Outpost/profile checks are reported in a separate non-gating section.
  • Epoch health uses the protocol extension allowance plus sequential envelope history; advancing blocks alone do not prove scheduler health.
  • Public reserves, custody, quotes, underwriter coverage, locks, and pending withdrawals remain visible.

Current state

This remains a draft local operator tool. The branch is clean and fully pushed, but current master reconciliation has real conflicts in readiness CLI/docs/tests and was intentionally left for a focused follow-up. The current PR review and CI blockers remain unresolved.

Run

corepack pnpm --filter @wireio/cluster-tool exec ./bin/wire-cluster-tool readiness \
  --feature swap \
  --wire-chain-id <wire-chain-id>

Add --outpost-deployment-profile-file <profile.json> only for the optional exact-deployment section.

@joshglogau joshglogau changed the title Add read-only cluster readiness checks and report bundles Add read-only cluster readiness checks and report archives Aug 4, 2026
@joshglogau
joshglogau marked this pull request as ready for review August 4, 2026 15:18
@joshglogau
joshglogau requested review from a team, bearcubsvet and jglanz August 4, 2026 15:18
@joshglogau joshglogau changed the title Add read-only cluster readiness checks and report archives Add SDK-aligned cluster readiness checks and portable reports Aug 4, 2026

@jglanz jglanz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

you are recreating functionality with your readiness tool, the correct approach is to add new Steps and PhaseGroups to cluster-tool and then refactor your tool into FlowScenario(s) which already have reports, tooling and infrastructure; this approach would mean that running e2e-tests includes you hub readiness data and validation.

@siliconswampio
siliconswampio force-pushed the feature/cluster-readiness branch from 0136a2e to 2db8ce4 Compare August 4, 2026 18:49
@joshglogau joshglogau changed the title Add SDK-aligned cluster readiness checks and portable reports Add cluster-tool-native swap readiness preflight Aug 4, 2026
@joshglogau

joshglogau commented Aug 4, 2026

Copy link
Copy Markdown
Author

Refactor complete:

  • Standalone readiness package and runner are removed
  • Readiness now consists of native cluster-tool Steps and PhaseGroups executed by ClusterBuild with the existing Report infrastructure
  • fail-fast remains the default and collect mode is opt-in for diagnostics.
  • The manual CLI is the MVP entrypoint, and future swap FlowScenario/GHA integration can compose the same PhaseGroups without duplicating checks.
  • The branch history was rewritten from current master into three cohesive commits.

@joshglogau joshglogau changed the title Add cluster-tool-native swap readiness preflight Add cluster-native swap and outpost deployment readiness Aug 5, 2026
@joshglogau

joshglogau commented Aug 5, 2026

Copy link
Copy Markdown
Author

Status: swap readiness and exact outpost deployment-profile verification are implemented. This PR consumes wire-libraries-ts#56; its final frozen dependency update follows that SDK publication.

Architecture: readiness stays read-only and uses the existing orchestration/Report system. It delegates ETH/SOL runtime identity checks to the SDK instead of duplicating verifier logic, keeps mutable endpoints separate from immutable deployment identity, and reports preflight readiness separately from a future funded transactional canary.

Producers: Ethereum artifacts #176 · Solana artifacts #414

@siliconswampio
siliconswampio force-pushed the feature/cluster-readiness branch from e16f086 to 879cd0e Compare August 13, 2026 16:25
@joshglogau joshglogau changed the title Add cluster-native swap and outpost deployment readiness Add read-only deployed-cluster swap readiness Aug 18, 2026
@joshglogau

Copy link
Copy Markdown
Author

Refactored into a FlowScenario here > #88

@joshglogau joshglogau closed this Sep 2, 2026
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.

2 participants