zeus-proof-and-analysis-toolkit

Proves Zeus wallet changes correct via interleaving tables, migration matrices, and test vectors.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-proof-and-analysis-toolkit-aswin-dev-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zeus-proof-and-analysis-toolkit
Source: https://github.com/aswin-dev-debug/Ai-Finance-analyzer/tree/main/lib/zeus-contrib/zeus/.claude/skills/zeus-proof-and-analysis-toolkit
Command: npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-proof-and-analysis-toolkit-aswin-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a Bitcoin/Lightning wallet like Zeus, shipping a fix without proof risks losing user funds. This Skill replaces "it seems to work" with evidence: enumerated state spaces, interleaving tables, unit traces, and failing-test-first regression tests, so every correctness claim about races, migrations, backend dispatch, amounts, or decoders is backed by a check that would have caught the bug. ## Core Features & Use Cases - Race and interleaving analysis: Enumerate trigger events (wallet focus, app foreground, create/delete) against shared mutable state to classify every unsafe cell as serialized, tolerated, or unreachable — e.g., proving the LDK Node delete crash fix closed the Tokio thread-affinity cell. - Migration correctness proofs: Build a persisted-state matrix (fresh install, legacy blob, zeus-settings-v2, iCloud restore) against actual migration execution order, with idempotency arguments for one-shot MOD_KEY flags. - Dispatch, amount, and conformance audits: Verify BackendUtils methods across all 7 backends for inherited-leak, unit-trace sat/msat arithmetic with BigNumber, and pin BOLT11/TLV/key-derivation spec vectors. - Use Case: Before merging a fix for a settings migration bug, produce the 6-row state table showing which cell the bug lived in, plus a jest test in MigrationUtils.test.ts that fails on pre-fix code. ## Quick Start Ask the assistant to prove that a race condition fix in the Zeus wallet is correct using the interleaving analysis recipe.

Frequently Asked Questions about zeus-proof-and-analysis-toolkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prove a race condition fix is correct in a React Native app?

Enumerate every trigger event (screen focus, app foreground, wallet create/delete) and every piece of shared mutable state, then build an interleaving table of operation steps versus concurrent events. Classify each cell as serialized, tolerated with a named retryable error, or unreachable with a named guard, and reproduce the bad interleaving before the fix.

How to verify a settings migration works for all users?

Build a matrix of persisted states (fresh install, legacy blob, v2 keychain blob, iCloud-restored device) against each migration in actual execution order read from the code. Prove every cell terminates validly, prove one-shot flags are idempotent even if the app is killed mid-migration, and cover both legacy and v2 load paths.

Why does a BackendUtils method silently return false in Zeus?

BackendUtils.call returns false synchronously when the active backend class lacks the method, with no throw. Because EmbeddedLND and LndHub extend LND, a missing override means the method is inherited from LND rather than absent, which can leak unsupported capabilities like supportsChannelFundMax on LndHub.

How should satoshi and millisatoshi conversions be tested?

Unit-trace every variable in the amount path, confining each x1000 or /1000 conversion to a named wire boundary, and use BigNumber instead of floats. Test boundary values 0, 1, 999, 1000, 1001 sats, msat remainders, and fee-equals-amount cases, since Zeus's routing fee rule switches behavior at 1000 sats.

When should I not use this proof toolkit?

Do not use it for change-control rules, PR gating, migration authoring mechanics, backend capability matrices, historical incident timelines, jest configuration, runtime log capture, or Lightning protocol theory. Those belong to sibling Zeus skills; this toolkit owns only the analysis methods that produce correctness evidence.