UniswapX

UniswapX is an ERC20 swap settlement protocol that provides swappers with a gasless experience, MEV protection, and access to arbitrary liquidity sources. Swappers generate signed orders which specify the specification of their swap, and fillers compete using arbitrary fill strategies to satisfy these orders.

UniswapX Protocol Architecture

Reactors

Order Reactors settle UniswapX orders. They are responsible for validating orders of a specific type, resolving them into inputs and outputs, and executing them against the filler's strategy, and verifying that the order was successfully fulfilled.

Reactors process orders using the following steps:

• Validate the order
• Resolve the order into inputs and outputs
• Pull input tokens from the swapper to the fillContract using permit2 permitWitnessTransferFrom with the order as witness
• Call reactorCallback on the fillContract
• Transfer output tokens from the fillContract to the output recipients

Reactors implement the IReactor interface which abstracts the specifics of the order specification. This allows for different reactor implementations with different order formats to be used with the same interface, allowing for shared infrastructure and easy extension by fillers.

Current reactor implementations:

• LimitOrderReactor: A reactor that settles simple static limit orders
• DutchOrderReactor: A reactor that settles linear-decay dutch orders
• ExclusiveDutchOrderReactor: A reactor that settles linear-decay dutch orders with a period of exclusivity before decay begins

Fill Contracts

Order fillContracts fill UniswapX orders. They specify the filler's strategy for fulfilling orders and are called by the reactor with reactorCallback when using executeWithCallback or executeBatchWithCallback.

Some sample fillContract implementations are provided in this repository:

• SwapRouter02Executor: A fillContract that uses UniswapV2 and UniswapV3 via the SwapRouter02 router

Direct Fill

If a filler wants to simply fill orders using funds held by an address rather than using a fillContract strategy, they can do so gas efficiently by using execute or executeBatch. These functions cause the reactor to skip the reactorCallback and simply pull tokens from the filler using msg.sender.

Integrating with UniswapX

Jump to the docs for Creating a Filler Integration.

Deployment Addresses

Ethereum Mainnet

Contract	Address	Source
V2 Dutch Order Reactor	0x00000011F84B9aa48e5f8aA8B9897600006289Be	V2DutchOrderReactor
V3 Dutch Order Reactor	0x0000000015757c461808EA25Eb309638B62681cf	V3DutchOrderReactor
Exclusive Dutch Order Reactor	0x6000da47483062A0D734Ba3dc7576Ce6A0B645C4	ExclusiveDutchOrderReactor
OrderQuoter	0x54539967a06Fc0E3C3ED0ee320Eb67362D13C5fF	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Base

Contract	Address	Source
Priority Order Reactor	0x000000001Ec5656dcdB24D90DFa42742738De729	PriorityOrderReactor
OrderQuoter	0x88440407634f89873c5d9439987ac4be9725fea8	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Tempo

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000fc1E66C9f582566EAd00108e55F1c0C6	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Optimism

Contract	Address	Source
V3 Dutch Order Reactor	0x000000000923439A92daE8930613568824108631	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

BNB

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000a55e50C71b70Db3C8B58749cd1E18eB2	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Unichain

Contract	Address	Source
V3 Dutch Order Reactor	0x000000005aF66799D1a6317714D66800f9CA1406	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Polygon

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000bAB6E234db8AD638B6A6395b7c499Bc4	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Monad

Contract	Address	Source
V3 Dutch Order Reactor	0x000000000Ac008F7e07210CFb6648e40249232c2	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

XLayer

Contract	Address	Source
V3 Dutch Order Reactor	0x000000005aF66799D1a6317714D66800f9CA1406	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Worldchain

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000d714EA34028930b762E96bFBe50F42C2	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Soneium

Contract	Address	Source
V3 Dutch Order Reactor	0x000000005aF66799D1a6317714D66800f9CA1406	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Base (DutchV3)

Contract	Address	Source
V3 Dutch Order Reactor	0x000000008a8330B5d1F43A62Bf4C673A49f27ba0	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Arbitrum

Contract	Address	Source
V3 Dutch Order Reactor	0xB274d5F4b833b61B340b654d600A864fB604a87c	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Celo

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000B8077fdf2281A80bE96f6c282B5d943A	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Avalanche

Contract	Address	Source
V3 Dutch Order Reactor	0x00000000862cCF095823fc7576Fa6C7e6b7385ef	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Blast

Contract	Address	Source
V3 Dutch Order Reactor	0x0000000086f50C5E1a2500602183D4390A7FFc98	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Zora

Contract	Address	Source
V3 Dutch Order Reactor	0x000000002C9A3812e15cf233190992E9a57EDB56	V3DutchOrderReactor
OrderQuoter	0x00000000a3db63Df9078cBF3dF88B4CAdD5a7F58	OrderQuoter
Permit2	0x000000000022D473030F116dDEE9F6B43aC78BA3	Permit2

Usage

# install dependencies
forge install

# compile contracts
forge build

# run unit tests
forge test

# run integration tests
FOUNDRY_PROFILE=integration forge test

Fee-on-Transfer Disclaimer

Note that UniswapX handles fee-on-transfer tokens by transferring the amount specified to the recipient. This means that the actual amount received by the recipient will be after fees.

Version Log

Version Number	Commit	Contract Address
1.0	597cf617dd6d32b3f181edbc37aed11bc5648d93	Contract no longer in use. Read more about the bug here.
1.1	cf53fc7dd48029a9189d26812d676a4ea9d08d6c	0x6000da47483062A0D734Ba3dc7576Ce6A0B645C4
2.0	4bacf632512ec5c9504a78ad1b7e1aec7efc6767	0x00000011f84b9aa48e5f8aa8b9897600006289be

Audit

V1

• ABDK

V1.1

• ABDK
• OpenZeppelin

V2

• Spearbit

Bug Bounty

This repository is subject to the Uniswap Labs Bug Bounty program, per the terms defined here.