fortiblox/arc-mev-bot
Watch
3
0
Fork
You've already forked arc-mev-bot
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: architecture contract + status 2026-09-16 #4

Merged
buddysan merged 1 commit from pd/architecture-contract into main 2026-09-16 13:28:07 +00:00
Conversation 2 Commits 1 Files changed 3 +236 -1
buddysan commented 2026-09-16 13:25:02 +00:00
Owner
Copy link

What

  • docs/architecture.md (new, 206 lines): the cross-lane integration contract — module map + lane ownership + WP ids, data shapes (Pool, PoolState, Opportunity, Bid, SubmitResult), executor call boundary execute(Hop[],uint256,uint256) with exact ABI encoding rules, invariants, per-block sequence, verified/unverified fact table.
  • docs/plan.md: adds a "Status 2026-09-16" section (phase text untouched) with wave-1/wave-2 lane assignments.
  • README.md: status paragraph only.

Verified live (2026-09-16, rpc.testnet.arc.io + LXC 140)

  • Multicall3 0xcA11bde05977b3631167028862bE2a173976CA11 has code (3808 bytes); aggregate3 returned all 8 registry pools' reserves in one call.
  • All 8 pools: getReserves() -> 3 words (uint112,uint112,uint32), non-zero reserves.
  • cast sig "execute((address,uint8,address,address,uint256)[],uint256,uint256)" = 0x7328892b.
  • Public RPC returns -32005 rate limit exceeded on a 25-call batch.
  • Port 9109 free on LXC 140 (metrics).

Unverified items are marked in §7 with the lane that verifies them.

🤖 Generated with Claude Code

## What - `docs/architecture.md` (new, 206 lines): the cross-lane integration contract — module map + lane ownership + WP ids, data shapes (`Pool`, `PoolState`, `Opportunity`, `Bid`, `SubmitResult`), executor call boundary `execute(Hop[],uint256,uint256)` with exact ABI encoding rules, invariants, per-block sequence, verified/unverified fact table. - `docs/plan.md`: adds a "Status 2026-09-16" section (phase text untouched) with wave-1/wave-2 lane assignments. - `README.md`: status paragraph only. ## Verified live (2026-09-16, rpc.testnet.arc.io + LXC 140) - Multicall3 `0xcA11bde05977b3631167028862bE2a173976CA11` has code (3808 bytes); `aggregate3` returned all 8 registry pools' reserves in one call. - All 8 pools: `getReserves()` -> 3 words `(uint112,uint112,uint32)`, non-zero reserves. - `cast sig "execute((address,uint8,address,address,uint256)[],uint256,uint256)"` = `0x7328892b`. - Public RPC returns `-32005 rate limit exceeded` on a 25-call batch. - Port 9109 free on LXC 140 (metrics). Unverified items are marked in §7 with the lane that verifies them. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Add docs/architecture.md, the cross-lane integration contract for the
six parallel build lanes: bot/ module map with lane ownership and WP ids,
data shapes (Pool, PoolState, Opportunity, Bid, SubmitResult; ints only
for money), the executor call boundary execute(Hop[],uint256,uint256)
with exact ABI encoding rules, the invariants every lane must honour,
the per-block processing sequence, and a verified/unverified fact table.

Live-verified on Arc testnet 2026-09-16: Multicall3 has code at its
canonical address and aggregate3 batches all 8 registry pools'
getReserves(); every pool returns (uint112,uint112,uint32); executor
selector 0x7328892b (cast sig on LXC 140); public RPC rate-limits large
batches (-32005); metrics port 9109 free on LXC 140.

docs/plan.md gains a 'Status 2026-09-16' section (phases untouched)
with wave-1/wave-2 lane assignments; README status paragraph updated.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Signed-off-by: BuddySan <[email protected]>
fortiblox-dev approved these changes 2026-09-16 13:28:06 +00:00
fortiblox-dev left a comment
Copy link

automerger v2 auto-approved: all 7 gates pass. Approver: fortiblox-dev (opposite-identity rule). Gates: mergeable=true,label=auto-merge,author=buddysan,identity=ok,status_checks=lane_rb_empty_ci_soften,signatures=upstream_BP_only,opt_in=repo_marker.

automerger v2 auto-approved: all 7 gates pass. Approver: fortiblox-dev (opposite-identity rule). Gates: mergeable=true,label=auto-merge,author=buddysan,identity=ok,status_checks=lane_rb_empty_ci_soften,signatures=upstream_BP_only,opt_in=repo_marker.
buddysan deleted branch pd/architecture-contract 2026-09-16 13:28:07 +00:00
buddysan commented 2026-09-16 13:28:08 +00:00
Author
Owner
Copy link

Auto-merged by forgejo-automerger at 2026-09-16 13:28:07 UTC. Approver: fortiblox-dev (opposite-identity rule, Option C upgrade 2026-05-13). Merger: buddysan via fast-forward-only (NOT admin force_merge). Criteria passed: mergeable=true,label=auto-merge,author=buddysan,identity=ok,status_checks=lane_rb_empty_ci_soften,signatures=upstream_BP_only,opt_in=repo_marker. Branch fffd06b974 merged onto main and feature branch deleted. See project_forgejo_automerger memory for rationale.

Auto-merged by **forgejo-automerger** at 2026-09-16 13:28:07 UTC. **Approver:** `fortiblox-dev` (opposite-identity rule, Option C upgrade 2026-05-13). **Merger:** `buddysan` via `fast-forward-only` (NOT admin `force_merge`). **Criteria passed:** `mergeable=true,label=auto-merge,author=buddysan,identity=ok,status_checks=lane_rb_empty_ci_soften,signatures=upstream_BP_only,opt_in=repo_marker`. Branch `fffd06b974` merged onto `main` and feature branch deleted. See `project_forgejo_automerger` memory for rationale.
Sign in to join this conversation.
Reviewers
No reviewers
fortiblox-dev
Labels
Clear labels   
auto-merge
Opt-in: automerger will land this PR after CI green + all gates pass

  
auto-merge
Automerge when CI passes (set by webhook bridge)

No labels
auto-merge
auto-merge
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
fortiblox/arc-mev-bot!4
No description provided.