Start with README.md for public CLI behavior.
Use TESTING.md for the maintainer/operator live-validation procedure and exact command shape.
- Use
zeko-bridge bridgeby default. - Treat
deposit,withdrawal,operation, andtuias advanced/debug/recovery tools. - Keep
README.mdpublic-facing. Agent-only workflow guidance belongs here, not in the public package README. - Keep
TESTING.mdprocedure-focused. Do not duplicate the full validation checklist here; reference it and add only agent-specific constraints.
Follow TESTING.md exactly for live bridge validation.
Agent-specific rules on top of that procedure:
- Do not add the live-validation tasks to CI or any automatic local workflow.
- Do not copy release/publish workflow detail into the package README. Internal release guidance already lives in
RELEASE.mdand the repo skills.
If you split work across subagents:
- one subagent owns
mina:testnet -> zeko:testnet - one subagent owns
zeko:testnet -> mina:testnet
For real network validation:
- prefer separate funded wallets per direction when you need isolation
- if subagents share a wallet, expect queued-claim ordering behavior and read the streamed progress carefully
- always capture
operation_id,log_path, and final transaction hash from each run - follow the one-command validation contract in TESTING.md without adding sidecar polling commands
- read long deposit waits correctly:
waiting-submissionaftersubmitDepositis usually Mina L1 visibility/finality delaywaiting-finalizationbefore any finalize transaction exists can still be normal sequencer commit delay fromcanFinalizeDeposit/canCancelDeposit- do not infer proof-request eviction risk until after
finalizeDeposithas actually been submitted
- durable bridge flow:
src/commands/bridge.ts - phase model:
src/core/operation-machine.ts - reporter/log rendering:
src/core/reporter.ts - manual validation entrypoints:
moon.yml