Epic: Build and launch Setwise Router

[stxphxn]

Objective

Track delivery of the complete Setwise Router program: preserve ZFi routing, add signed Setwise liquidity, and launch safe same-chain deployments on Ethereum, BSC, Base, and Robinhood Chain.

Foundation

• Import the ZFi router stack with license and upstream provenance #1 Import the ZFi router stack with license and upstream provenance
• Establish repository layout and unified developer commands #2 Establish repository layout and unified developer commands
• Create deployment manifests and on-chain address verification tooling #3 Create deployment manifests and on-chain address verification tooling
• Design and implement the typed multi-chain configuration registry #4 Design and implement the typed multi-chain configuration registry
• Capture the Ethereum ZFi compatibility and ABI baseline #5 Capture the Ethereum ZFi compatibility and ABI baseline
• Add continuous integration for contracts, services, linting, and bytecode size #6 Add continuous integration for contracts, services, linting, and bytecode size

Mvp

• Define Setwise pool interfaces and fixed swap data types #7 Define Setwise pool interfaces and fixed swap data types
• Implement the governed Setwise pool registry #8 Implement the governed Setwise pool registry
• Refactor native and wrapped-native handling for all target chains #9 Refactor native and wrapped-native handling for all target chains
• Implement router-specific EIP-712 authorization with ERC-1271 support #10 Implement router-specific EIP-712 authorization with ERC-1271 support
• Capability-gate Ethereum-only ZFi extensions #11 Capability-gate Ethereum-only ZFi extensions
• Refactor V2, V3, and V4 integrations into chain-aware adapters #12 Refactor V2, V3, and V4 integrations into chain-aware adapters
• Implement Setwise native input and native output execution #13 Implement Setwise native input and native output execution
• Eliminate persistent Setwise allowances and residual router balances #14 Eliminate persistent Setwise allowances and residual router balances
• Implement Setwise ERC-20 to ERC-20 execution #15 Implement Setwise ERC-20 to ERC-20 execution
• Build Ethereum differential tests against the ZFi baseline #16 Build Ethereum differential tests against the ZFi baseline
• Add Setwise transient-credit and future composition support #17 Add Setwise transient-credit and future composition support
• Build the pluggable quote-source adapter framework #18 Build the pluggable quote-source adapter framework
• Integrate Setwise indicative pricing as a route source #19 Integrate Setwise indicative pricing as a route source
• Define the chain-aware unified quote schema #20 Define the chain-aware unified quote schema
• Port the ZFi on-chain quoter into a chain-aware source adapter #21 Port the ZFi on-chain quoter into a chain-aware source adapter
• Implement a multi-chain 0x quote adapter #22 Implement a multi-chain 0x quote adapter
• Implement Setwise indicative-to-firm selection, simulation, and fallback #23 Implement Setwise indicative-to-firm selection, simulation, and fallback
• Complete exact-input, exact-output, and route-evidence API coverage #24 Complete exact-input, exact-output, and route-evidence API coverage
• Add source caching, circuit breakers, observability, and structured errors #25 Add source caching, circuit breakers, observability, and structured errors
• Implement gas- and fee-adjusted route ranking #26 Implement gas- and fee-adjusted route ranking
• cenodev/setwise-rfq-api#5 Extend the Setwise RFQ API for router execution authorizations
• Add chain selection and chain-scoped token discovery to the dapp #29 Add chain selection and chain-scoped token discovery to the dapp
• Present route provenance, Setwise quote details, and execution warnings #31 Present route provenance, Setwise quote details, and execution warnings
• Implement approval, preflight revalidation, and transaction submission UX #32 Implement approval, preflight revalidation, and transaction submission UX

Rollout

• Complete BSC testnet end-to-end integration #28 Complete BSC testnet end-to-end integration
• Complete Robinhood Chain testnet integration #30 Complete Robinhood Chain testnet integration
• Rehearse Ethereum deployment and parity on a pinned mainnet fork #33 Rehearse Ethereum deployment and parity on a pinned mainnet fork
• Complete Base Sepolia integration and fork-style venue tests #34 Complete Base Sepolia integration and fork-style venue tests
• Prepare and execute the Ethereum mainnet release #35 Prepare and execute the Ethereum mainnet release
• cenodev/setwise-rfq-api#6 Harden the firm-quote signer with authentication and strong reservations
• Implement governance, timelocks, per-source kill switches, and emergency controls #37 Implement governance, timelocks, per-source kill switches, and emergency controls
• Prepare and execute the BSC mainnet release #38 Prepare and execute the BSC mainnet release
• Prepare and execute the Base mainnet release #39 Prepare and execute the Base mainnet release
• Prepare and execute the Robinhood Chain mainnet release #40 Prepare and execute the Robinhood Chain mainnet release
• Build comprehensive fuzz, invariant, and malicious-integration test suites #41 Build comprehensive fuzz, invariant, and malicious-integration test suites
• Define router production SLOs, monitoring dashboards, and incident runbooks #42 Define production SLOs, monitoring dashboards, and incident runbooks
• Publish Setwise Router architecture, integration, deployment, and contributor documentation #43 Publish architecture, integration, deployment, and contributor documentation
• Threat-model inherited ZFi behavior and resolve audit findings #44 Threat-model inherited ZFi behavior and resolve audit findings
• Coordinate independent Setwise Router system audits and remediation #45 Commission independent audits and track remediation to closure

Program acceptance criteria

• Ethereum ZFi compatibility is proven by differential tests.
• Setwise direct routes support ERC-20 and native asset modes.
• All four chains have verified configuration and reproducible deployments.
• Firm quotes bind chain, router, pool, funder, recipient, amounts, quote ID, and expiry.
• No unintended router balances or allowances remain.
• Independent audits are remediated and production operations are rehearsed.

Difficulty

Expert — multi-chain, security-critical program spanning contracts, pricing, signing, frontend, and operations.