Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 2.09 KB

File metadata and controls

46 lines (31 loc) · 2.09 KB

Bridge CLI Agent Notes

Start with README.md for public CLI behavior.

Use TESTING.md for the maintainer/operator live-validation procedure and exact command shape.

Default Path

  • Use zeko-bridge bridge by default.
  • Treat deposit, withdrawal, operation, and tui as advanced/debug/recovery tools.
  • Keep README.md public-facing. Agent-only workflow guidance belongs here, not in the public package README.
  • Keep TESTING.md procedure-focused. Do not duplicate the full validation checklist here; reference it and add only agent-specific constraints.

Manual Validation

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.md and the repo skills.

Parallel Subagents

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-submission after submitDeposit is usually Mina L1 visibility/finality delay
    • waiting-finalization before any finalize transaction exists can still be normal sequencer commit delay from canFinalizeDeposit / canCancelDeposit
    • do not infer proof-request eviction risk until after finalizeDeposit has actually been submitted

Code Landmarks

  • 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