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.
Real contracts, real V4 state, no invented deployment.
PermRouter v2
EIP-712 authorization, up to four continuous steps, pull-fee reserves, Permit2, recipient minimum, replay protection, pause guardian, and event-backed evidence.
Restricted V4 adapter
Immutable PoolManager, exact-input pool steps, full-spend verification, and runtime-codehash-pinned hooks with a distinct hook evidence identity.
Synthra V3 adapter
Immutable reviewed Router02 and WETH targets, native wrapping, approved fee tiers, exact allowances, codehash checks, and no arbitrary calldata.
Product decision
Hook-aware routing
Include Uniswap v4 Aggregator Hook candidates only where deployment, quote, and integration details are verified for the target chain.
Perm Fee Rebate
Reduce the Perm platform fee on eligible swaps through the Perm entry point, including valid V2, V3, or other venue routes.
Quote and execution flow
- IntentUser chooses pair, exact input, recipient, and slippage.
- CandidatesRouting requests baseline Perm adapters and verified Aggregator Hook providers.
- ValidateCheck chain, amount, token identity and decimals, freshness, spender, target, and minimum output.
- CompareUse the same quote window and fee policy. Compare known net output; convert gas only with a valid price.
- ConfirmShow the known venue or hook, output, fee, rebate, minimum received, and network fee before signing.
- SettleVerify actual recipient output and publish a receipt from transaction evidence.
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.
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,000Initial 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.
Minimum receipt schema
chainIdtxHash + log identityroute / provider IDstokenIn / tokenOutactual amountsgross feerebatenet feerecipientfee policy versionThe UI can summarize the receipt, but the indexer must retain enough transaction and log identity to support each route claim.
