{ "$schema": "https://hookforge.pages.dev/schema/hook-manifest.json", "slug": "priority-fee-tax", "name": "PriorityFeeTax", "contract": "PriorityFeeTaxHook", "version": "1.0.0", "family": "Order flow and MEV", "summary": "Charges a swap in proportion to what it paid the block producer to get where it is in the block.", "description": "Position in a block is worth something only to flow that is racing: an arbitrageur closing a gap against a centralized venue, a liquidator, a sandwicher. A person swapping a hundred dollars of one token for another does not care whether they land at index 3 or index 30, and does not bid for it. So the priority fee a transaction attaches is a revealed measure of how much the trade is worth to the trader beyond the trade itself, and that surplus is value the pool's liquidity providers are the counterparty to. The hook reads `tx.gasprice - block.basefee`, the priority fee per unit of gas actually paid, and adds a surcharge along a saturating curve: surcharge(priority) = maxSurcharge * priority / (priority + halfPriority) At `priority == halfPriority` the swap pays half the cap. The surcharge is an LP fee, so it goes to in-range liquidity; the hook takes nothing and holds nothing. The trader cannot dodge it by bidding low, because bidding low is exactly the concession the hook is asking for: a searcher who drops their priority fee to avoid the surcharge loses the race that made the trade profitable. That is the point. The hook prices the option to be early rather than trying to detect who is early. Prior art: fee mechanisms keyed on realized volatility, on price movement and on swap size are all well covered. The idea that priority fees reveal flow toxicity is discussed in the ordering-fee literature and in Uniswap's own research on priority-ordering auctions, but the surcharge itself has been implemented at the sequencer or the router, never inside the pool where the liquidity providers who bear the cost can be paid directly. Chain support, stated plainly. This works where there is a real priority-fee market: Ethereum, Base, Unichain, Optimism, Blast and other OP-stack chains. On Arbitrum One transactions are ordered first-come-first-served and the priority fee is normally zero, so on that chain the hook charges `baseFee` and nothing more. It is safe there, it is simply inert, and a pool on Arbitrum should use {ArbTaxDecayHook} instead.", "priorArt": "Fee mechanisms keyed on realized volatility, on price movement and on swap size are all well covered. That priority fees reveal flow toxicity is discussed in the ordering-fee literature and in Uniswap research on priority-ordering auctions, but the surcharge has only ever been implemented at the sequencer or the router, never inside the pool where the liquidity providers who bear the cost can be paid directly.", "limitation": "Needs a real priority-fee market. On Arbitrum One, where ordering is first-come-first-served and the priority fee is normally zero, the hook is safe but inert and a pool there should use ArbTaxDecay instead.", "tags": [ "mev", "dynamic-fee", "order-flow", "oracle-free" ], "recommendedChains": [ "base", "unichain", "ethereum", "optimism", "robinhood" ], "source": "contracts/src/hooks/PriorityFeeTaxHook.sol", "docs": "https://hookforge.pages.dev/hooks/priority-fee-tax", "repo": "https://github.com/nirholas/priority-fee-tax", "site": "https://priority-fee-tax.pages.dev", "permissions": { "afterRemoveLiquidityReturnsDelta": false, "afterAddLiquidityReturnsDelta": false, "afterSwapReturnsDelta": false, "beforeSwapReturnsDelta": false, "afterDonate": false, "beforeDonate": false, "afterSwap": false, "beforeSwap": true, "afterRemoveLiquidity": false, "beforeRemoveLiquidity": false, "afterAddLiquidity": false, "beforeAddLiquidity": false, "afterInitialize": true, "beforeInitialize": false }, "permissionsSource": "address", "properties": { "dynamicFee": true, "upgradeable": false, "requiresCustomSwapData": false, "vanillaSwap": true, "swapAccess": "none" }, "configure": { "signature": "configure((address,address,uint24,int24,address),(uint24,uint24,uint128))", "fields": [ { "name": "baseFee", "type": "uint24" }, { "name": "maxSurcharge", "type": "uint24" }, { "name": "halfPriorityWei", "type": "uint128" } ] }, "errors": [ { "signature": "FeeTooLarge(uint24)", "notice": "A fee was configured above the protocol maximum of 100%." }, { "signature": "HookNotImplemented()", "notice": "The hook function is not implemented." }, { "signature": "InvalidHalfPriority()", "notice": "`halfPriorityWei` was zero, which would make every non-zero priority fee pay the full surcharge." }, { "signature": "InvalidPool()", "notice": "The pool is not configured to use this hook." }, { "signature": "NotDynamicFee()", "notice": "The hook was attempted to be initialized with a non-dynamic fee." }, { "signature": "PoolAlreadyInitialized()", "notice": "The pool already exists, so its configuration is final." }, { "signature": "PoolNotConfigured()", "notice": "The pool was initialized without a configuration for this hook." }, { "signature": "SurchargeTooLarge()", "notice": "`baseFee + maxSurcharge` must leave room under the 100% protocol maximum." } ], "deployments": [ { "chain": "unichain", "chainId": 130, "address": "0xE1cbeD2C3A27dE98202ac5EA439fc8Cb06a71080", "status": "deterministic" }, { "chain": "robinhood", "chainId": 4663, "address": "0x9ae664D21C02e33658A608AF6A5fE8cC1fDE9080", "status": "deterministic" }, { "chain": "base", "chainId": 8453, "address": "0x782f29DCa46C5b5d6D9321A824aAf901e18B5080", "status": "deterministic" }, { "chain": "arbitrum", "chainId": 42161, "address": "0x8092f20876753cb41A4CCEA20665288C58af1080", "status": "deterministic" } ], "abi": [ { "type": "constructor", "inputs": [ { "name": "_poolManager", "type": "address", "internalType": "contract IPoolManager" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "afterAddLiquidity", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct ModifyLiquidityParams", "components": [ { "name": "tickLower", "type": "int24", "internalType": "int24" }, { "name": "tickUpper", "type": "int24", "internalType": "int24" }, { "name": "liquidityDelta", "type": "int256", "internalType": "int256" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" } ] }, { "name": "delta0", "type": "int256", "internalType": "BalanceDelta" }, { "name": "delta1", "type": "int256", "internalType": "BalanceDelta" }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" }, { "name": "", "type": "int256", "internalType": "BalanceDelta" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "afterDonate", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "amount0", "type": "uint256", "internalType": "uint256" }, { "name": "amount1", "type": "uint256", "internalType": "uint256" }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "afterInitialize", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "sqrtPriceX96", "type": "uint160", "internalType": "uint160" }, { "name": "tick", "type": "int24", "internalType": "int24" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "afterRemoveLiquidity", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct ModifyLiquidityParams", "components": [ { "name": "tickLower", "type": "int24", "internalType": "int24" }, { "name": "tickUpper", "type": "int24", "internalType": "int24" }, { "name": "liquidityDelta", "type": "int256", "internalType": "int256" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" } ] }, { "name": "delta0", "type": "int256", "internalType": "BalanceDelta" }, { "name": "delta1", "type": "int256", "internalType": "BalanceDelta" }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" }, { "name": "", "type": "int256", "internalType": "BalanceDelta" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "afterSwap", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct SwapParams", "components": [ { "name": "zeroForOne", "type": "bool", "internalType": "bool" }, { "name": "amountSpecified", "type": "int256", "internalType": "int256" }, { "name": "sqrtPriceLimitX96", "type": "uint160", "internalType": "uint160" } ] }, { "name": "delta", "type": "int256", "internalType": "BalanceDelta" }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" }, { "name": "", "type": "int128", "internalType": "int128" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "beforeAddLiquidity", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct ModifyLiquidityParams", "components": [ { "name": "tickLower", "type": "int24", "internalType": "int24" }, { "name": "tickUpper", "type": "int24", "internalType": "int24" }, { "name": "liquidityDelta", "type": "int256", "internalType": "int256" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" } ] }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "beforeDonate", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "amount0", "type": "uint256", "internalType": "uint256" }, { "name": "amount1", "type": "uint256", "internalType": "uint256" }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "beforeInitialize", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "sqrtPriceX96", "type": "uint160", "internalType": "uint160" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "beforeRemoveLiquidity", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct ModifyLiquidityParams", "components": [ { "name": "tickLower", "type": "int24", "internalType": "int24" }, { "name": "tickUpper", "type": "int24", "internalType": "int24" }, { "name": "liquidityDelta", "type": "int256", "internalType": "int256" }, { "name": "salt", "type": "bytes32", "internalType": "bytes32" } ] }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "beforeSwap", "inputs": [ { "name": "sender", "type": "address", "internalType": "address" }, { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "params", "type": "tuple", "internalType": "struct SwapParams", "components": [ { "name": "zeroForOne", "type": "bool", "internalType": "bool" }, { "name": "amountSpecified", "type": "int256", "internalType": "int256" }, { "name": "sqrtPriceLimitX96", "type": "uint160", "internalType": "uint160" } ] }, { "name": "hookData", "type": "bytes", "internalType": "bytes" } ], "outputs": [ { "name": "", "type": "bytes4", "internalType": "bytes4" }, { "name": "", "type": "int256", "internalType": "BeforeSwapDelta" }, { "name": "", "type": "uint24", "internalType": "uint24" } ], "stateMutability": "nonpayable" }, { "type": "function", "name": "configOf", "inputs": [ { "name": "", "type": "bytes32", "internalType": "PoolId" } ], "outputs": [ { "name": "baseFee", "type": "uint24", "internalType": "uint24" }, { "name": "maxSurcharge", "type": "uint24", "internalType": "uint24" }, { "name": "halfPriorityWei", "type": "uint128", "internalType": "uint128" } ], "stateMutability": "view" }, { "type": "function", "name": "configure", "inputs": [ { "name": "key", "type": "tuple", "internalType": "struct PoolKey", "components": [ { "name": "currency0", "type": "address", "internalType": "Currency" }, { "name": "currency1", "type": "address", "internalType": "Currency" }, { "name": "fee", "type": "uint24", "internalType": "uint24" }, { "name": "tickSpacing", "type": "int24", "internalType": "int24" }, { "name": "hooks", "type": "address", "internalType": "contract IHooks" } ] }, { "name": "cfg", "type": "tuple", "internalType": "struct PriorityFeeTaxHook.Config", "components": [ { "name": "baseFee", "type": "uint24", "internalType": "uint24" }, { "name": "maxSurcharge", "type": "uint24", "internalType": "uint24" }, { "name": "halfPriorityWei", "type": "uint128", "internalType": "uint128" } ] } ], "outputs": [], "stateMutability": "nonpayable" }, { "type": "function", "name": "currentPriorityFee", "inputs": [], "outputs": [ { "name": "", "type": "uint256", "internalType": "uint256" } ], "stateMutability": "view" }, { "type": "function", "name": "getHookPermissions", "inputs": [], "outputs": [ { "name": "permissions", "type": "tuple", "internalType": "struct Hooks.Permissions", "components": [ { "name": "beforeInitialize", "type": "bool", "internalType": "bool" }, { "name": "afterInitialize", "type": "bool", "internalType": "bool" }, { "name": "beforeAddLiquidity", "type": "bool", "internalType": "bool" }, { "name": "afterAddLiquidity", "type": "bool", "internalType": "bool" }, { "name": "beforeRemoveLiquidity", "type": "bool", "internalType": "bool" }, { "name": "afterRemoveLiquidity", "type": "bool", "internalType": "bool" }, { "name": "beforeSwap", "type": "bool", "internalType": "bool" }, { "name": "afterSwap", "type": "bool", "internalType": "bool" }, { "name": "beforeDonate", "type": "bool", "internalType": "bool" }, { "name": "afterDonate", "type": "bool", "internalType": "bool" }, { "name": "beforeSwapReturnDelta", "type": "bool", "internalType": "bool" }, { "name": "afterSwapReturnDelta", "type": "bool", "internalType": "bool" }, { "name": "afterAddLiquidityReturnDelta", "type": "bool", "internalType": "bool" }, { "name": "afterRemoveLiquidityReturnDelta", "type": "bool", "internalType": "bool" } ] } ], "stateMutability": "pure" }, { "type": "function", "name": "hookName", "inputs": [], "outputs": [ { "name": "", "type": "string", "internalType": "string" } ], "stateMutability": "pure" }, { "type": "function", "name": "hookTags", "inputs": [], "outputs": [ { "name": "tags", "type": "string[]", "internalType": "string[]" } ], "stateMutability": "pure" }, { "type": "function", "name": "hookVersion", "inputs": [], "outputs": [ { "name": "", "type": "string", "internalType": "string" } ], "stateMutability": "view" }, { "type": "function", "name": "isPoolInitialized", "inputs": [ { "name": "id", "type": "bytes32", "internalType": "PoolId" } ], "outputs": [ { "name": "", "type": "bool", "internalType": "bool" } ], "stateMutability": "view" }, { "type": "function", "name": "poolManager", "inputs": [], "outputs": [ { "name": "", "type": "address", "internalType": "contract IPoolManager" } ], "stateMutability": "view" }, { "type": "function", "name": "quoteFee", "inputs": [ { "name": "id", "type": "bytes32", "internalType": "PoolId" } ], "outputs": [ { "name": "", "type": "uint24", "internalType": "uint24" } ], "stateMutability": "view" }, { "type": "function", "name": "specURI", "inputs": [], "outputs": [ { "name": "", "type": "string", "internalType": "string" } ], "stateMutability": "pure" }, { "type": "function", "name": "supportsInterface", "inputs": [ { "name": "interfaceId", "type": "bytes4", "internalType": "bytes4" } ], "outputs": [ { "name": "", "type": "bool", "internalType": "bool" } ], "stateMutability": "view" }, { "type": "event", "name": "PoolConfigured", "inputs": [ { "name": "id", "type": "bytes32", "indexed": true, "internalType": "PoolId" }, { "name": "baseFee", "type": "uint24", "indexed": false, "internalType": "uint24" }, { "name": "maxSurcharge", "type": "uint24", "indexed": false, "internalType": "uint24" }, { "name": "halfPriorityWei", "type": "uint128", "indexed": false, "internalType": "uint128" } ], "anonymous": false }, { "type": "event", "name": "PriorityPriced", "inputs": [ { "name": "id", "type": "bytes32", "indexed": true, "internalType": "PoolId" }, { "name": "priorityFeeWei", "type": "uint256", "indexed": false, "internalType": "uint256" }, { "name": "fee", "type": "uint24", "indexed": false, "internalType": "uint24" } ], "anonymous": false }, { "type": "error", "name": "FeeTooLarge", "inputs": [ { "name": "fee", "type": "uint24", "internalType": "uint24" } ] }, { "type": "error", "name": "HookNotImplemented", "inputs": [] }, { "type": "error", "name": "InvalidHalfPriority", "inputs": [] }, { "type": "error", "name": "InvalidPool", "inputs": [] }, { "type": "error", "name": "NotDynamicFee", "inputs": [] }, { "type": "error", "name": "NotPoolManager", "inputs": [] }, { "type": "error", "name": "PoolAlreadyInitialized", "inputs": [] }, { "type": "error", "name": "PoolNotConfigured", "inputs": [] }, { "type": "error", "name": "SurchargeTooLarge", "inputs": [] } ] }