Implementation dated 17 November 2026 · contracts compiled, unit-tested, and exercised against a Robinhood testnet fork
PERM · DIFFERENTIATION V4

Routing that can use verified hooks. A platform fee that visibly comes down.

Perm keeps the multi-venue router baseline, then adds hook-aware route candidates and a settlement-time rebate funded from Perm's own platform fee.

IMPLEMENTED TESTNET PATH

Real contracts, real V4 state, no invented deployment.

01

PermRouter v2

EIP-712 authorization, up to four continuous steps, pull-fee reserves, Permit2, recipient minimum, replay protection, pause guardian, and event-backed evidence.

02

Restricted V4 adapter

Immutable PoolManager, exact-input pool steps, full-spend verification, and runtime-codehash-pinned hooks with a distinct hook evidence identity.

03

Synthra V3 adapter

Immutable reviewed Router02 and WETH targets, native wrapping, approved fee tiers, exact allowances, codehash checks, and no arbitrary calldata.

Verified against live fork state: tests execute both directions through the real v4 PoolManager and Synthra v3 router, including an actual Permit2 signature transfer.
Release boundary: the shared manifest still points to Router v1, so v2 quotes remain read-only until candidate verification, governance acceptance, and explicit promotion. No Aggregator Hook deployment has been established on chain 46630.

Product decision

01

Hook-aware routing

Include Uniswap v4 Aggregator Hook candidates only where deployment, quote, and integration details are verified for the target chain.

02

Perm Fee Rebate

Reduce the Perm platform fee on eligible swaps through the Perm entry point, including valid V2, V3, or other venue routes.

Not the default: forcing every trade through a custom Perm hook. The router still compares valid net results and exposes gas separately.
A · HOOK-AWARE ROUTING

Quote and execution flow

  1. IntentUser chooses pair, exact input, recipient, and slippage.
  2. CandidatesRouting requests baseline Perm adapters and verified Aggregator Hook providers.
  3. ValidateCheck chain, amount, token identity and decimals, freshness, spender, target, and minimum output.
  4. CompareUse the same quote window and fee policy. Compare known net output; convert gas only with a valid price.
  5. ConfirmShow the known venue or hook, output, fee, rebate, minimum received, and network fee before signing.
  6. SettleVerify actual recipient output and publish a receipt from transaction evidence.
Phase one can compare complete candidates. Cross-provider split routing requires separate implementation and testing; it should not be advertised early.
TECHNICAL BOUNDARY

A router is not a hook

A v4 hook is attached to a pool through its PoolKey. Its callbacks run only when that pool is used and the callback permission exists. Changing the router does not attach a new Perm hook to an existing pool.

RESPONSIBILITYPERM ROUTER / SETTLEMENTSPECIFIC V4 HOOK POOL
User boundsRecipient, minimum output, deadlineNot the only global enforcement
Fee rebateGross fee, rebate, net feeOnly if that pool explicitly implements it
ProofRouter event and indexerCallback detail when available
AMM behaviorDoes not alter external venuesMay implement dynamic LP fee or curve logic
Never infer that a custom Perm callback ran only because a transaction touched v4.
B · PERM FEE REBATE

One versioned discount, settled instantly

The user rebate is an immediate reduction of Perm's own fee, so it needs no user claim, campaign points, staking, or second transaction. Treasury and referral fees use separate pull-payment reserves so a failing beneficiary cannot block the swap.

grossPermFee = floor(feeBasisAmount × platformFeeBps / 10,000)
rebate      = floor(grossPermFee × rebateShareBps / 10,000)
netPermFee  = grossPermFee − rebate

0 ≤ rebateShareBps ≤ 10,000
INPUT FIXTURE100 USDG
→
GROSS PERM FEE0.20 USDG
−
REBATE0.05 USDG
=
NET PERM FEE0.15 USDG

Initial policy v1 uses a 0.20% gross Perm fee and a 25% rebate share of that fee, producing a 0.15% net Perm fee. The quote signs the exact immutable policy version read from chain.

  • Rebate cannot exceed the gross Perm fee. A zero gross fee creates a zero rebate in this design.
  • Referral, integrator, treasury, and rebate shares cannot spend the same portion twice.
  • A reverted transaction creates no rebate or volume reward; gas spent on the revert is not refunded automatically.
  • The quote binds fee policy version, recipient, chain, amount, deadline, and minimum output.
EVIDENCE

Minimum receipt schema

chainIdtxHash + log identityroute / provider IDstokenIn / tokenOutactual amountsgross feerebatenet feerecipientfee policy version

The UI can summarize the receipt, but the indexer must retain enough transaction and log identity to support each route claim.

RELEASE GATE

Acceptance checklist

Positioning after implementation: “Compare routes. See every fee. Keep more of your swap.” Avoid guarantees of cheapest execution, profit, MEV immunity, or universal hook coverage.
PRIMARY REFERENCES

Sources used by the brief

Uniswap v4 hooks ↗Uniswap v4 dynamic fees ↗Aggregator Hooks announcement ↗Full Perm addendum on GitHub ↗