Providing liquidity on v4
Your own pool, your own fee, and a certificate that proves you own it.
In shortYou open your own pool, set its fee and own it through a certificate. The fees are yours to claim and the pool is yours to remove.
- Fee range
- 0.3% to 30%
- Your slice of each fee
- 10% claimable, 60% into the pool
- Creating a pool
- about 2,500 KCAL gas
- Ownership
- SATURN certificate
On Saturn v4 you do not add money to a shared pot. You open a pool of your own for a pair of tokens, you choose the fee it charges, and you are its only provider. The chain mints an ownership certificate, a SATURN NFT, to your wallet. Several pools can exist for the same pair with different fees, and the swap router picks whichever pays traders the most, so pools compete.
Creating a pool
- Go to Liquidity, Create pool. Enter the two tokens and how much of each you deposit. The ratio you deposit sets the opening price, so check it against the market.
- Set the fee per 10,000. 30 means 0.30 percent. The allowed range runs from 0.3 to 30 percent.
- Sign. Expect about 2,500 KCAL of gas on mainnet for this one action, because the certificate series is minted here. The app refuses to sign if the wallet cannot cover it.
Adding to a pool
In Positions, pick the pool, enter the amount of the first token and a maximum for the second. The pool takes whatever second-side amount the current ratio needs, up to your maximum. That maximum is your slippage guard, not what you spend.
Where each fee goes
Every swap pays your pool's fee, taken out of the token the trader sends in. The chain then splits that fee four ways. The split is one setting shared by every v4 pool, and these are the mainnet values today.
| Slice | Mainnet today | Who gets it | How it arrives |
|---|---|---|---|
| Reinvest | 60% | The pool | Stays inside the reserves. The pool grows, so it is yours when you remove. |
| Provider | 10% | You, the pool owner | Set aside as a claimable balance in both tokens. Claim it any time from Positions. It sits outside the reserves, so claiming never weakens the pool. |
| Treasury | 20% | Saturn | Sent to the Saturn treasury as the swap happens. |
| Holders | 10% | Stakers of the input token | Credited to that token's vault in Holder rewards and split among its stakers by stake. They claim it from Rewards, Holder rewards. |
Worked example on a 0.30 percent pool: a trader swaps 1,000 KCAL for TAZ. The fee is 3 KCAL. 1.8 KCAL joins the KCAL reserve, 0.3 KCAL becomes claimable for you, 0.6 KCAL goes to the treasury, 0.3 KCAL is credited to the people staking KCAL, and the trader's TAZ is priced on the remaining 997 KCAL. Swaps in the other direction pay the same slices in TAZ, which is why your claimable balance builds up in both tokens.
Figures on the Liquidity page are shown on the chain's 8-decimal scale; hover a figure for the exact value.
Who collects the provider slice while a product runs
Products only ever touch the provider slice. The reinvest slice keeps growing your pool, and the treasury and holder slices keep going to Saturn and to stakers whatever is running.
| Pool state | The provider slice goes to |
|---|---|
| Nothing running | You. Claim whenever you like. |
| Loan collateral | You. Lending never touches fees; the lender's return is the interest. From saturnloans 1.0.3, fees still unclaimed go to the lender with the pool if the loan is liquidated or defaults. |
| Reward campaign | You. The campaign pays on top of the fees. |
| Fee option | You. The buyer controls the fee rate, not the income. |
| Rental | The renter, for the whole term. Your income is the rent, paid in SOUL up front. |
| Bond | Held until maturity. In the bond's fee token the buyer receives up to the face value and any excess comes back to you; fees earned in the pool's other token are yours. |
| Syndicate or launchpad pool | The members or buyers, in proportion to their shares, claimed from that page. |
Leaving
- Remove burns the certificate and returns both reserves to your wallet, together with any provider fees you had not claimed yet. Nothing is left behind.
- Rent, Borrow and the other buttons hand the pool to a product. A pool under a product cannot be removed until the product ends. The pool-products and lending guides explain each.
- A pool pledged to a loan shows a pledged badge, and its Remove, Lock, Burn and Rent buttons wait with the reason. From saturnloans 1.0.3, if that loan is liquidated or defaults, the pool moves to the lender, and it appears in the lender's Positions ready to remove.
What can go wrong
- If the two tokens change price against each other, the pool rebalances and you end up holding more of the one that fell. This is impermanent loss, and fees are what pay you for taking it.
- A pool priced away from the market is an invitation: traders will take the cheap side until it matches.
- A pool under a product (a loan, a rental, a bond, an option) cannot be removed or have its fee changed until the product ends.