feat(fees): mirror the swap-fee split and cover it end-to-end

[heifner]

Harness + flow side of the swap-fee change that pays the winning underwriter and each participating reserve owner out of the WIRE leg.

Harness

• WireReserveTool.splitWireFee mirrors sysio::opp::amm::split_wire_fee exactly — five shares (underwriter / rewards / emissions / src reserve / dst reserve), every rate off the same gross leg, exact conservation.
• SwapScenarioContext.reserveOwnerFee reads a reserve's rate and earned amounts through the typed table accessor.
• Steps.contracts.sysio.reserv gains planSetrsvfee / planClaimrsvfee (owner-signed — the owner isn't in the action data, so it rides the step input) and planSetconfig.
• The bootstrap seeds sysio.reserv::setconfig with a zero emissions share, so no swap fee leaves custody at settlement by default.

Flow coverage

flow-swap-private-reserves was the right home: one account owns both private reserves, so a single swap charges it twice — the per-reserve rule gets exercised, not just asserted.

• New ReserveOwnerFees phase — the owner prices the ETH reserve at 1% and the SOL reserve at 2%. Deliberately different rates, so a swapped or double-counted side can't hide behind equal numbers.
• PhaseA / PhaseB now assert each reserve accrued its own rate off the same leg. PhaseB runs the inverse direction, which proves the rate follows the reserve rather than its source/destination role.
• New ClaimReserveOwnerFees phase — owner claims each accrual; both sweep to zero, lifetime totals survive, and the owner's WIRE rises by exactly what the pair earned.
• The swap-from-wire / swap-to-wire / with-underwriting custody assertions now expect only the drained rewards half to leave custody — the underwriter half stays as a uwfees accrual until claimed.

Verification

[flow-swap-private-reserves] SUCCEEDED against a live cluster — exit 0, every Report step ok, including all six new fee steps.

Against a 99,009,900 gross WIRE leg the on-chain split was exact:

Fee	Rate	On chain
Source reserve owner	100 bps	990,099
Destination reserve owner	200 bps	1,980,198
Underwriter	30 bps × 50%	148,514
Batch-op rewards	remainder	148,515
Emissions	0 bps (default)	0

Destination gained precisely the 95,742,574 remainder. The one-subunit asymmetry between rewards and the underwriter is the remainder-taking design working — nothing leaks.

Also: pnpm build + pnpm lint clean; 125 tests pass across the touched suites.

Known gap

SwapScenarioContext.test.ts cannot execute on Node 22 — it imports the flow barrel → FlowCLI → yargs@18 (ESM-only), and jest's require(ESM) needs Node ≥24.9. Its new reserveOwnerFee cases type-check but I have not seen them go green locally; they'll run in CI. This is the same pre-existing cause as the other env-blocked suites on this host, not something this PR introduces.

Note on the rebase

Branched off fresh origin/master, which already carried the SEC-129 uwreq lifecycle fix (PR #38). I had made the same fix independently while chasing a compile error from the regenerated types — that duplicate was dropped in favour of upstream's, and the tree was rebuilt, re-linted, and re-tested against the current base.

---

Related PRs — one change across four repos

Land in this order; the first three are coupled:

1. feat(fees): pay underwriters and reserve owners out of the swap fee wire-sysio#546 — contracts: the fee split, accruals, and claim actions
2. chore(sdk-core): regenerate SysioContractTypes for the swap-fee surface wire-libraries-ts#60 — regenerated SysioContractTypes from those ABIs
3. feat(fees): mirror the swap-fee split and cover it end-to-end #54 — harness mirror + e2e flow coverage ← this PR
4. Wire-Network/wire-platform-manifest#5 — bootstrap-doc corrections

wire-libraries-ts#60 must merge before wire-tools-ts#54 (the harness builds against the committed SysioContractTypes), and both need wire-sysio#546's ABIs first. The manifest PR is doc-only and independent.

Running the e2e gate on this set needs all three code branches passed explicitly:
BRANCH_WIRE_SYSIO=feat/swap-fee-distribution, BRANCH_WIRE_LIBRARIES_TS=feat/swap-fee-distribution, BRANCH_WIRE_TOOLS_TS=feat/swap-fee-distribution.

The tools-ts override is not optional — without it the gate discovers and runs master's flows, so none of the new fee coverage executes. wire-ethereum / wire-solana stay on their manifest defaults (next); neither repo is touched by this change.

Gate run: all 13 flows passed (2026-08-05) — resolved wire-sysio@f982725a, wire-libraries-ts@ab92a844, wire-tools-ts@74b2f092; wire-ethereum / wire-solana on manifest default next.