The master branch contains the latest work-in-progress version of limit orders. It hasn't been audited and may contain severe security issues or may not work at all.
Please, use the commit tagged v2
(here) to get the latest production version that has passed through a series of security audits.
You can find general overview and docs on 1inch limit orders protocol here.
This repository contains a smart contract for EVM based blockchains (Ethereum, Binance Smart Chain, etc.), this contract is core part of 1inch limit order protocol.
Contract allows users to place limit orders, that later could be filled on-chain. Limit order itself is a data structure created off-chain and signed according to EIP-712.
Key features of the protocol is extreme flexibility and high gas efficiency that achieved by using following order types.
Extremely flexible limit order, can be configured with:
- Order execution predicate.
- Typical usage is checking that certain time stamp or block number. With this you can set certain expiration time.
- You can specify construct any predicate that you want, for example check that certain price is higher than oracle price, to implement stop loss or take profit strategies
- Helper function for asset price evaluation.
- Function that will allow to extract assets price from arbitrary on-chain source
- Callback, for to notify maker on order execution.
Gas optimized order with restricted capabilities suitable for market makers
- Support expiration time
- Support cancellation by order id
- RFQ Order could be filled only once
- Partial Fill is possible (once)
- ERC 20
- ERC 721
- ERC 1155
- Other token standards could be supported via external extension
You can find 1inch limit order protocol deployments here:
Ethereum mainnet: 0x119c71D3BbAC22029622cbaEc24854d3D32D2828
BSC mainnet: 0x1e38Eff998DF9d3669E32f4ff400031385Bf6362
Polygon mainnet: 0x94Bc2a1C732BcAd7343B25af48385Fe76E08734f
Optimism Mainnet: 0x11431a89893025D2a48dCA4EddC396f8C8117187
Arbitrun One: 0x7F069df72b7A39bCE9806e3AfaF579E54D8CF2b9
Gnosis Chain: 0x54431918cEC22932fCF97E54769F4E00f646690F
Avalanche: 0x0F85A912448279111694F4Ba4F85dC641c54b594
Kovan Testnet: 0xa218543cc21ee9388Fa1E509F950FD127Ca82155
Fantom Opera: 0x11DEE30E710B8d4a8630392781Cc3c0046365d4c
You can find audit reports on etherscan and in the separate audit repository.
Plenty of utils that helps create & sign orders are available in our typescript utils library: