Skip to content

feat(bridge): add Verulink ALEO-BSC support - #88

Merged
iamalwaysuncomfortable merged 2 commits into
masterfrom
verulink-bsc
Nov 16, 2026
Merged

iamalwaysuncomfortable merged 2 commits into
masterfrom
verulink-bsc

Conversation

@iamalwaysuncomfortable

@iamalwaysuncomfortable iamalwaysuncomfortable commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

Public ALEO can now move between Aleo and wrapped ALEO on BSC through the existing Bridge lifecycle. This ports Veil PR #217 at a2071c0b2731f58ad7ed1487369cdd57dab18264, including quotes, source submission, destination claims, and checkpoint recovery.

  • Add both Verulink routes, BSC connection support, live fee/pause/peer checks, and local packet and attestor-signature verification.
  • Integrate with the shared pause gate: quotes, execution, and resumption check both chains; claims check the destination so a source pause cannot strand a confirmed transfer. Unreadable pause state blocks submission.
  • Verify source and recipient-delivery evidence, preserve prepared Aleo transactions and held-transfer checkpoints, and refuse ambiguous EVM source resubmission. Existing route checkpoint fingerprints remain compatible.
  • Expose the routes through the agent/MCP tools and ship a checkpointed round-trip example with submission markers, a process lock, and recovery bound to the intended leg.

Validation: 1,326 offline bridge tests passed; Pyright reports zero errors or warnings; generated docs and diff checks passed. The wheel was built, installed into a temporary target, and checked for imports, routes, pause-tool schema, and example CLI help. Keyless live quotes passed in both directions (20 ALEO → 19.98 ALEO at the time of verification). No funded transactions were submitted; funded live coverage is opt-in.

… approval timeouts, and outside claims

- A reverted or rejected claim no longer ends the transfer: an unconsumed
  packet returns to next == "complete", a consumed one to DELIVERY_PENDING.
  A BSC revert is only believed at the confirmation depth.
- resume() sends the BSC burn while the confirmed approval is unspent; a
  spent approval still requires the source transaction hash.
- recover(checkpoint, destination_tx_id=...) adopts and verifies a claim
  the checkpoint never recorded.
- A receipt visible before its transaction reads as pending, not a mismatch.
- Held checkpoints persist held + destinationError, so pending() lists them
  as failed offline.
- The route-active check applies to quote/execute/resume only, so in-flight
  transfers stay observable and claimable after a route is parked.
- assert_active delegates to the shared pause reader.
- Polling reuses the packet verified earlier in the process; complete()
  still re-reads the source.
- An account with no public credits reports an insufficient balance.
- The round-trip example clears its attempt marker when the SDK refused
  before sending, and a claim that would revert raises before submission.
@iamalwaysuncomfortable
iamalwaysuncomfortable merged commit 3684cf2 into master Nov 16, 2026
15 of 16 checks passed
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