Skip to content

feat: verify --path from-home — the round-trip works-gate - #22

Merged
anil-rome merged 1 commit into
mainfrom
feat-verify-from-home
Jul 22, 2026
Merged

feat: verify --path from-home — the round-trip works-gate#22
anil-rome merged 1 commit into
mainfrom
feat-verify-from-home

Conversation

@anil-rome

Copy link
Copy Markdown
Contributor

Completes verify across all four builder paths (solidity · idea · solana-program · from-home).

What it does

rome verify <chain> --path from-home --from <src> --amount <usdc> proves the whole from-home journey with one command, three legs, failing fast:

  1. in — bridge USDC in as wUSDC (CCTP wrapper intent); waits through Circle attestation (~15–20 min) and asserts the wUSDC balance delta actually landed
  2. act — a real wUSDC transfer on Rome via submitRomeTx (the asset is usable)
  3. outbridge --to back to the source chain, asserted to attestation-ready + claim handle (the destination claim is the user's own step, per the locked design)

Activation is pre-checked before any spend — never bridge in and then strand on an unactivated burn. EVM key only. wUSDC resolves chain-first from the registry (spl_wrapper matched by the gas token's mint — getTokens drops assetRef).

Validation

  • Funded round trip GREEN on Hadrian (0.2 USDC): in 0xc60ca63b… (delta 200000) → act 0x9af1ebe4… → out 0x1f7e74b1… claim-ready → ok: true — run through this exact branch's build.
  • 97 unit tests (+5: leg order, fail-fast at each leg, delta-zero red, arg contract), typecheck/build/MCP smoke clean; verify stays off-MCP.

Docs

docs/GUIDES.md — "from-home: the round trip, proven" (legs, prereqs, durations) · docs/ARCHITECTURE.md catalog row.

Feature PR, no version bump — pinned in a later release.

Completes verify across all four builder paths. from-home composes the
shipped bridge engines into one asserted round trip: bridge USDC in as
wUSDC (CCTP wrapper intent, waits through Circle attestation and asserts
the wUSDC balance delta) -> act with it on Rome (a real wUSDC transfer
via submitRomeTx) -> bridge back out to attestation-ready + claim handle.
Legs run in order and fail fast. Activation is pre-checked BEFORE any
spend (never bridge in and strand); the destination claim stays the
user's own step. EVM key only. wUSDC resolves chain-first from the
registry (spl_wrapper matched by the gas token's mint - getTokens drops
assetRef).

Funded-verified on Hadrian (0.2 USDC round trip): in 0xc60ca63b (delta
200000) -> act 0x9af1ebe4 -> out 0x1f7e74b1 claim-ready, ok:true.
97 unit tests; GUIDES round-trip section + ARCHITECTURE row.
@anil-rome
anil-rome merged commit cea5f6d into main Jul 22, 2026
6 checks passed
anil-rome added a commit that referenced this pull request Jul 22, 2026
Pins the released surface to main. Since v0.7.0: verify --path from-home
(#22) — the round-trip works-gate (bridge in → act → bridge out), funded-
GREEN on Hadrian; verify now covers all four builder paths. Also fixes
the GUIDES MCP blurb (actions list was missing activate). Bumps
package.json and the github install pins 0.7.0 -> 0.8.0.
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.

1 participant