Godex Router Asset (GRA)
Overview
The GoDex Router Asset (GRA) is designed as a safety wrapper around contract operations, which helps facilitate effective token swaps in the world of decentralized finance (DeFi). The Router safeguards user approvals, making sure tokens are only moved from the user in the right amount when the user is performing a swap. The goal is that the user receives at least the minimum amount they were expecting. The router can handle different kinds of swaps, as well as various approval mechanisms. Also, the router is responsible for collecting and holding revenue, which comes from positive slippage and/or fees, from the swap activities.
Key Features
Single and Multi-input/output Swapping
The main operations of the router are swap functions that aid users in exchanging tokens. The router can handle multi-input and multi-output swaps efficiently through its _swapMulti
function, and single to single swaps via the _swap
function. These two functions also have different methods for collecting revenue. The _swap
function collects any positive slippage, which is the surplus between the quoted and actual output when the actual output is higher. Meanwhile, the _swapMulti
function charges a flat fee on all swaps, but doesnβt collect any positive slippage.
Both _swap
and _swapMulti
have various externally callable functions. For accessing the userβs ERC20 tokens, both methods allow for standard approvals made directly to the router, as well as the use of Uniswapβs Permit2 contract. Both methods also have a compact
version that reduces the amount of calldata needed to describe the swap.
Compact Swaps
The compact swap function variants aim to use as little calldata as possible, removing padding and compressing the data needed to define a swap path without compromising on complexity and accessible liquidity. This leads to gas savings across the board on all chains, but the savings are particularly large for optimistic rollups that post their calldata to Mainnet Ethereum like Arbitrum, Optimism, and Base. On these rollups, gas costs for swapping will be well over 50% cheaper than V1 in many cases, depending on network conditions and details of the swap. Compact swaps are enabled by default, but swaps encoded via the native solidity ABI are still available as well by setting the βcompactβ flag to false in the API.
Max Balance Swapping
Godex Router Asset also allows the user to specify that their entire balance at the time of the swap to be used by passing in a 0 as the input amount. This is particularly useful for rebasing tokens whose balance can change slightly between the time of the path computation and the time of transaction execution. Typically these will be tokens that accumulate yield via rebasing, like Aave wrapped tokens and Overnight Finance wrapped stablecoins.
Referrals
The router has a feature for referral codes to keep track of usage. Optionally, an extra fee can be charged in conjunction with this referral code. New referral codes can be registered freely with the registerReferralCode
function. Once registered, the referral code information cannot be changed - if a change is needed, a new referral code will need to be registered.
When executing a swap, a referral code can be used by passing it into the swap function. The swap will then charge the referral fee (if applicable) on the output(s) of the swap and send 80% of the fee to the specified beneficiary instantly, holding back the other 20% of the additional fee as router revenue.
For more information on how to use referral codes, check out our referral code documentation.
Owner Controls
The router collects and holds revenue generated from swap fees through positive slippage and swap fees. These funds are held in the router to avoid extra gas fees during the userβs swap for additional transfers. The router provides several owner
protected functions to manage this revenue. The owner can also use certain functions to access the collected revenue, for instance, to transfer out revenue in a single denomination (like USDC) despite it originally being collected in many denominations.
Revenue Streams
The router generates income through three methods:
Normal Swaps: Revenue is generated from positive slippage, which is the difference between the quoted amount and the actual amount received when the latter is higher. Negative slippage is not revenue for the router.
SwapMulti: Instead of positive slippage, a fixed fee is deducted from the output tokens for transactions using the SwapMulti function. (Refer to the specific section for fee details.)
Referral Fees: When swaps include a partnerβs referral code, an added fee is charged. Of this fee, 20% is kept by the router as its earnings, while the remaining 80% is paid to the referring partner.
Positive Slippage
In single token swaps, the router collects revenue through a process called positive slippage. Positive slippage occurs when the router executes a swap that is better than initially predicted. This can happen due to fluctuations in the market between the time an order is placed and when itβs fulfilled.
The router ensures the returned token amount falls within a range between the minimum amount outputMin
to a projected amount outputQuote
. If the final trade is more favorable than initially anticipated, demonstrating positive slippage, the router retains the additional amount as its revenue.
No / Non-fee Referral
When using the router without a referral code or with a referral code that does not charge an extra fee.
Referral Fee
When using the router with a referral code that charges an extra fee.
Audit
Godex Router Asset was audited by Zellic in June 2023. A link to the report can be found in the Zellic Publications GitHub Repository.
Deployments
Each of these addresses can be retrieved from the GoDex API using the /info/router/GRA/{chain_id}
endpoint.
Last updated