Makers
AirSwap liquidity providers are makers, generally online and quoting, with takers on the other side of each trade. At the lower protocol level, where the software used by makers and takers interacts with Ethereum, there are signers, who set and cryptographically sign terms (an order), and senders who submit those terms for settlement on the Swap contract.
For the RFQ protocol, a server is always the signer and the client is always the sender. For LastLook, the client is always the signer and a server is always the sender.
- Nonces are unique identifiers for swaps and used for cancels. They should be generated incrementally but might execute out of order.
- URLs may be to either HTTP or WebSocket servers using
https
orwss
respectively. - Registry is used to signal that a server is available to trade specific tokens, including contact information (URL), without pricing.
If a URL is HTTPS, it implies that the server supports the latest RFQ protocol at that endpoint. If a URL is WebSocket (
wss
) then the server communicates its supported protocols upon connnection. See the setProtocols
method of the Request for Quote and LastLook protocols for details. WebSocket servers can support both RFQ and LastLook protocols.Getting started is as easy as standing up a JSON-RPC web server and adding its URL to the Registry.
When signing orders in RFQ, a protocol fee (in basis points) is hashed into the signature and verified during settlement. The value of this parameter must match its current value of
protocolFeeLight
on the SwapERC20 contract. The amount is transferred from the signerWallet
address upon settlement.100% of protocol fees go toward rewarding AirSwap governance participants and project contributors.
Provide descriptive errors where possible. In the case of a server side error, return a JSON-RPC error response.
{
"jsonrpc": "2.0",
"id": 123,
"error": { "code": -33605, "message": "Rate limit exceeded" }
}
-32700
Parse error-32600
Invalid Request-32601
Method not found-32602
Invalid params-32603
Internal error-32000 to -32099
(Reserved for implementation-defined server-errors)
The following are AirSwap specific errors:
-33600
Cannot provide the requested quote or order-33601
Not trading the requestedsignerToken
senderToken
pair-33602
The specifiedsenderAmount
orsignerAmount
is too low-33603
The specifiedsenderAmount
orsignerAmount
is too high-33604
Invalid request parameters-33605
Rate limit exceeded-33700 to -33799
(Reserved for implementation specific trading errors)
Ensure the AirSwap CLI is installed.
$ yarn global add airswap
In development, set the chain to
4
with the airswap chain
command. The following examples assume a local development server is running at http://localhost:3000
.Several useful commands can help you debug your server:
airswap rfq:get
to request an order directly from your server. (RFQ)airswap rfq:best
to request an order from servers supporting a specific token pair. Once your server is on the registry it will be queried with this command. (RFQ)airswap quote:stream
to subscribe to a pricing stream and make orders for your server. (LastLook)
Ensure the AirSwap CLI is installed.
$ yarn global add airswap
Once your server is up and running at a public URL, you're ready to add it to the Registry. First, ensure an account is set with the
airswap account:import
command. You can but are not required to use the same Ethereum account that your Server is using.Let's take a look at the available Registry commands.
$ airswap registry
AirSwap CLI 1.6.1 — https://airswap.io/
add and remove supported tokens
USAGE
$ airswap registry:COMMAND
COMMANDS
registry:add add supported tokens to the registry
registry:enable enable staking on the registry
registry:get get urls from the registry
registry:list list supported tokens from registry
registry:remove remove supported tokens from the registry
registry:url set server url on the registry
First run the following command to enable staking for your account.
$ airswap registry:enable
Now run the following command to set your server url on the registry.
$ airswap registry:url
Now run the following command to add tokens you support.
$ airswap registry:add
To ensure your configuration is correct, you can query tokens that you support on the registry.
$ airswap registry:get
AirSwap CLI 1.6.1 — https://airswap.io/
get urls from the registry RINKEBY
Registry 0xa77fbeD39D5128e1cA9795d68D73010851393BCc
Token pair (e.g. WETH/USDT): DAI/WETH
Server
----------------------------------------
https://maker.example.com/
Now that your server is running and has been added to the Registry, your quotes will be returned among results of the
airswap rfq:best
command and aggregators like MetaMask Swaps.$ airswap rfq:best
AirSwap CLI 4.0.6 — https://www.airswap.io/
get the best available order ETHEREUM
buy or sell: buy
amount: 0.1
of: weth
for: dai
Requesting from 7 peers... done
Quote from https://maker.example.com/
✨ Buy 0.1 WETH for 250 DAI
Price 0.0004 WETH/DAI (2500 DAI/WETH)
Last modified 4d ago