# How to use this guide Explore this beginner-friendly guide to STON.fi, covering key principles, step-by-step instructions, and FAQs. Learn about features, user levels, and how to navigate the platform effectively. This guide is a mini-encyclopedia of STON.fi with one simple job: help you act confidently. Look left: the sidebar is your map. It’s grouped by what you’ll actually do on [STON.fi](http://ston.fi): • **Start here** — onboarding essentials: what blockchain/DEX/wallets are, how to create a TON wallet, find your address, buy GRAM in Telegram.\ • **Swapping on** [**STON.fi**](http://ston.fi): how to connect a wallet, make your first swap, understand rate/price impact/min received, see how fees work, add custom tokens, and learn how referral fees from swaps are accrued.\ • **Providing Liquidity**: what a liquidity pool is, how impermanent loss works, add/withdraw liquidity, pool types, create a new pool, evaluate pools (TVL/APR/volume), and a dedicated flow for hardware wallets like Ledger.\ • **Farming**: what farming is, how to start/stop farming, how rewards and lockups behave.\ • **Staking**: how staking on STON.fi works and what it unlocks. At the top-right, the search bar finds pages and terms instantly. Try “price impact,” “LP tokens,” “impermanent loss”, or any other keyword. Each guide is step-by-step with screenshots; the footer links you onward to the next logical task. ### What else may be helpful? 1️⃣ Go to [the STON.fi support bot](https://t.me/STONfi_support_bot) to get help with account/wallet connection issues, error messages, or step-by-step fixes that involve device settings, extensions, or known incidents. It’s the canonical place for troubleshooting. 2️⃣ If something’s missing, or if something in the app behaves differently than described here, tell us in [the English-speaking community chat](https://t.me/stonfichat) — we keep this library alive. 3️⃣ [The STON.fi blog](https://blog.ston.fi/) covers deeper topics (ecosystem updates, security write-ups, protocol design, audits) in a more analytical style. Read it when you want context beyond the how-to. # What is blockchain and cryptocurrency Learn how blockchain works, what cryptocurrency is, and why these concepts matter when you use STON.fi and other DeFi protocols on TON. Understanding blockchain and cryptocurrency helps you understand why STON.fi works without accounts, passwords, or intermediaries, and why your wallet is the key to everything. ### What is a blockchain? {% hint style="info" %} A **blockchain** is a shared digital ledger: think of it as a public spreadsheet that anyone can read, but no one can secretly edit. {% endhint %} Instead of being stored on a single server, this ledger is distributed across thousands of computers around the world. Each new update is grouped into a “block,” and blocks are linked together in a strict order, forming a chain — hence the name blockchain. On the TON blockchain, new blocks are produced roughly every few seconds, continuously extending this shared history. ### Why blockchains are hard to change Each block contains a fingerprint (called a hash) of the previous block. If someone tried to alter past data, this fingerprint would break, and the entire chain after it would no longer match. To successfully rewrite history, an attacker would need to redo the work for every block after it, faster than the rest of the network combined. In practice, this makes blockchains extremely resistant to tampering. For users, this means: * Transactions are transparent * Records are permanent * Trust comes from math and network consensus, not from a single company or person ### What is cryptocurrency {% hint style="info" %} **Cryptocurrency** is a digital asset that exists on a blockchain. {% endhint %} There are no banks involved in holding or moving crypto. Ownership is defined by cryptographic keys, and transactions are recorded directly on the blockchain’s public ledger. When you send or receive cryptocurrency, you’re not moving coins between accounts. You’re updating the blockchain’s shared record to reflect a new owner. ### Coins vs tokens These terms are often mixed, but here’s a way to think about them: * **Coins** — native assets of a blockchain.\ Example: GRAM on the TON blockchain. * **Tokens** — assets created on top of a blockchain via smart contracts.\ Example: USDt, STON, and other jettons on TON. On STON.fi, you mostly interact with tokens, and you need to hold a bit of GRAM: it is used to pay network fees and power transactions. {% hint style="success" %} STON.fi is a DeFi protocol built on TON. It doesn’t hold your funds or manage balances internally. Instead: * Your wallet signs transactions * Smart contracts execute swaps and liquidity operations * The blockchain records everything transparently {% endhint %} In the next guides, we’ll explore how this foundation turns into real actions: wallets, swaps, liquidity pools, farming, and staking.
# What is DEX and how it works Learn what a decentralized exchange (DEX) is, how it differs from centralized platforms, and how STON.fi enables direct token swaps on the TON blockchain. You’ve probably already heard of decentralized exchanges before. Names like Uniswap, Curve, Sushi come up often when people talk about DeFi. But what do these platforms actually do and why are there so many of them? {% hint style="info" %} **A decentralized exchange, or DEX** is a system of smart contracts that allows users to swap one crypto asset for another directly on a blockchain, without intermediaries like banks or centralized exchanges. There are no accounts, no custody, and no order books in the traditional sense: everything happens on-chain. {% endhint %} Instead of trusting an exchange to hold your assets, you interact with smart contracts that execute swaps according to predefined rules. ### What makes a DEX different from a centralized exchange On a centralized exchange (CEX): * You create an account * Deposit funds into the exchange * Trades happen inside the exchange’s internal system * The exchange controls custody and execution On a DEX: * You control your assets via your own non-custodial wallet. [Read more on what a crypto wallet is](https://guide.ston.fi/en/start-here/what-is-a-crypto-wallet). * There is no registration or account balance held by the platform * Every swap happens on-chain via smart contracts * You approve each transaction yourself In short: on a DEX, you stay in control from start to finish. ### Are DEXs locked within one blockchain? DEXs can operate on a single blockchain or across multiple blockchains: * Single-chain DEXs are built specifically for one network. For example, Uniswap originally launched on Ethereum, Jupiter operates on Solana, and DeDust is native to TON. * Multi-chain DEXs support swaps on several blockchains, either by deploying the same protocol on multiple networks (like Uniswap on Ethereum, Polygon, and Arbitrum) or by routing liquidity across chains using bridges and messaging layers. Despite these differences, most DEXs rely on a similar core mechanism: liquidity pools. Instead of matching buyers and sellers, users swap against pools of tokens provided by other users. Prices are determined algorithmically, based on pool balances and predefined formulas. ### How swaps work on a DEX DEXs don’t use order books where buyers and sellers wait to match. Instead, swaps happen against liquidity pools. {% hint style="info" %} **A liquidity pool** is a smart contract that holds two tokens and allows users to swap between them instantly. Prices are determined algorithmically based on the ratio of assets in the pool. {% endhint %} When you make a swap: * You choose the token you give and the token you receive * The smart contract calculates the rate * The swap executes immediately, using pool liquidity * The result is written to the blockchain ### Why smart contracts matter Smart contracts are programs stored on the blockchain that automatically execute actions when conditions are met. On a DEX, smart contracts: * Calculate swap outcomes * Enforce rules consistently * Execute transactions without human intervention * Make all operations transparent and verifiable This is what allows a DEX to function without a central operator. ### What you need to use a DEX on TON To use a DEX on TON, you need: * A TON wallet (non-custodial) * Tokens in that wallet * A small amount of TON to cover blockchain fees That’s it. ### How TON DEX mechanics differ DEX mechanics on TON follow the same fundamental DeFi principles, but the underlying blockchain architecture introduces some important differences. TON was designed for high throughput and low-latency transactions, with fast block times and asynchronous message passing between smart contracts. As a result: * Swaps on TON feel closer to “instant” execution from a user perspective * Smart contracts interact differently compared to EVM-based chains like Ethereum * Liquidity and routing logic must be adapted to TON’s message-driven model Because of this, TON-native DeFi protocols are not simple copies of other blockchains designs. Liquidity pools, swap routing, and transaction flows are implemented with TON’s architecture in mind. STON.fi is a DeFi protocol built natively on the TON blockchain that provides decentralized exchange functionality as part of a broader on-chain financial infrastructure. Our role is to provide reusable on-chain components that make core DeFi operations possible, predictable, and composable for users, wallets, and applications across the TON ecosystem.
# What is a crypto wallet Learn about cryptocurrency wallets, focusing on non-custodial wallets for STON.fi. Discover how to store, send, and receive crypto securely with private keys and seed phrases. Learn what a crypto wallet is, why non-custodial wallets are required for STON.fi, how hot and cold wallets differ, and how to keep your keys safe. {% hint style="info" %} ### The big idea: read this first A wallet doesn’t “store” your tokens. All tokens live on the blockchain. A wallet is a signing app or signing device that:\ • shows you your on-chain balances and activity, and\ • creates and signs transactions with your private key so the network accepts them as valid. Whoever controls the private key controls the funds. That’s why key storage and signing matter more than the app’s brand or look. {% endhint %} ### Custodial vs non-custodial (self-custody) • **Custodial wallet**. A company holds the keys for you (e.g., on a centralized exchange). You usually pass KYC. Convenience is high; control is not. You cannot use custodial wallets to interact with STON.fi or other DEX apps directly.\ • **Non-custodial (self-custody)**. You hold the keys. Your wallet generates a recovery (seed) phrase (12 or 24 words) from which keys are derived. Privacy and control are yours. This is the type you use with STON.fi. ### Hot vs cold: how your key is kept • **Hot wallet (software)**. An internet-connected app on your phone or desktop (e.g., Tonkeeper, Tonhub). It can build and sign transactions itself. Easiest for daily use; protect the device and backups carefully.\ • **Cold wallet (hardware)**. A dedicated offline device (e.g., Ledger). It never exposes the private key to your phone/PC or the internet. It only signs transactions you approve on the device. Safer key storage; a bit more steps to use. How a hardware wallet flow works 1. You prepare a transaction in a companion app (for TON, that’s commonly Tonkeeper). 2. The unsigned transaction is sent to your hardware device (via cable, Bluetooth, or QR). 3. You verify the details on the device screen and approve. 4. The device produces a valid signature; the companion app broadcasts the signed transaction.\ Result: your private key never leaves the device. ### Seed phrase, private key, and addresses — what’s what • Seed (recovery) phrase: 12/24 words you must back up offline. It can regenerate your keys.\ • Private key: the cryptographic secret used to sign transactions. Never share it.\ • Public key / address: what others use to send you tokens. 💡 Rule of thumb: anyone with your seed or private key has your wallet. ### Which wallet to use for STON.fi? Use a non-custodial TON wallet. Hot wallets are great for everyday swaps and liquidity actions. If you prefer stronger protection, pair your companion app with a hardware wallet — STON.fi supports Ledger flows for key operations (like providing liquidity to v2 pools) with a step-by-step signing experience. {% hint style="info" %} ### Security basics • Back up your seed phrase on paper, in order, and keep it offline in two safe places. No screenshots, no cloud notes.\ • Set a strong device password/biometrics. Keep your phone/PC clean and updated.\ • Verify links and contracts before signing. If something looks off, stop and re-check.\ • Never share your seed or private key. Support will never ask for them. {% endhint %} ### Common myths busted • “My tokens are inside Tonkeeper/Ledger.” No. They’re recorded on the TON blockchain; the wallet just proves you’re the owner and lets you move them.\ • “Paper wallets aren’t real wallets.” A written seed is, in fact, a perfectly valid (offline) backup. Protect it like cash and IDs.\ • “Hardware wallets are complicated.” They add one approval step on the device. That extra step is the whole point: safer keys. ### Bottom line For STON.fi and other DEX apps, you need a non-custodial wallet. Choose a reputable hot wallet for convenience, and consider a hardware wallet if you want stronger key isolation. Remember: the wallet is your signer; the blockchain is where your assets live. Keep the signer safe, and the assets stay yours.
# How to create a TON wallet Follow this guide to create your first TON wallet for use on STON.fi. Learn to set up a wallet, secure your seed phrase, and start using the TON blockchain services safely. {% hint style="info" %} In this guide you’ll: \ ✅ Set up a TON wallet \ ✅ Securely back up your recovery phrase \ ✅ Get ready to use STON.fi and other TON apps {% endhint %} 🔑 Security first (real talk) * Your recovery phrase (seed phrase) is the master key to your wallet. If anyone has it, they have your funds. * Never share it, never type it into a website, and no screenshots — cloud syncs are a thief’s best friend. * STON.fi and support teams will never ask for your recovery phrase. If someone does — run. ### Step 1. Choose and install a wallet You can use Tonkeeper, Tonhub, or other reputable TON wallets. In this guide we’ll use Tonkeeper desktop version; the flow is similar in other wallets. ### Step 2. Create a new wallet Open Tonkeeper → Get Started → Create new wallet.

Tonkeeper Chrome Extension

Click Continue to proceed to recovery phrase backup. ### Step 3. Back up your recovery phrase 1. The wallet will show 24 words (your recovery phrase). 2. Write them down on paper, in the exact order and spelling. 3. Store backups offline in two separate safe places. ⚠️ OMG, I lost my recovery phrase! Is this THAT bad? If you lose your recovery phrase, no one can restore your wallet or funds. Be careful. If your wallet is still unlocked on a device, immediately move all funds to a new wallet with a brand-new recovery phrase.

Example of a seed phrase on Tonkeeper

{% hint style="info" %} **Short FAQ on recovery phrases** **❓ 12 vs 24 words — does it matter?** Both exist. Just write them in order and store offline. **❓ Can support recover my wallet?** Nope. No one can. **❓ Are screenshots okay?** Still no. Cloud backups get hacked. Paper wins. **❓ Can I email the phrase to myself?** Please don’t. Treat it like a private key to your house and bank account combined. {% endhint %} ### Step 4. Verify your recovery phrase Follow the on-screen prompts to confirm the words in the correct order, then click Continue.

Checking seed recovery phrase

### Step 5. Create a password (device security) Set a strong password to unlock the wallet on this device and confirm transactions. If available, enable biometrics (fingerprint/face) on mobile. {% hint style="info" %} ⚠️ Forgot the password? You can regain access only with the recovery phrase. {% endhint %}

Creating password on Tonkeeper

✅ Congratulations! Your first wallet is ready to use. ### (Optional) Import an existing wallet Already have a wallet? Choose Import existing wallet, then enter your recovery phrase and confirm. Never paste it into any website fields. ### ▶️ Video guides * [Creating a wallet in Tonkeeper](https://vimeo.com/812447622) * [Creating a wallet in Tonhub](https://vimeo.com/812462980) # Where to find your wallet address Learn how to find your TON wallet address and safely share it when using STON.fi and other TON apps. {% hint style="info" %} In this guide you’ll: ✅ Understand what a wallet address is\ ✅ Learn where to find it in your wallet app\ ✅ Know what’s safe to share {% endhint %} ### What is a wallet address? A wallet address is your public identifier on the blockchain. Think of it like a crypto “account number” — people use it to send you funds. On TON, your wallet address is a long string of characters that usually starts with EQ or UQ. This is completely normal and helps identify it as a TON address. ### Is it safe to share your wallet address? Yes. Sharing your wallet address is safe. Anyone with your address can: * Send you GRAM or tokens * View transactions associated with that address on the blockchain They cannot: * Access your funds * Move tokens * Control your wallet 🔒 Important: your wallet address is public.\ Your recovery phrase / private key is private.\ If someone asks for your recovery phrase, that’s a scam. Always. ### About privacy and anonymity Blockchains are transparent, which means transactions are publicly visible. However, your wallet address is not linked to your real-world identity. STON.fi and other DeFi apps do not ask for personal data. As long as you don’t connect your address to your identity elsewhere, you remain anonymous. ### Where to find your TON wallet address You can find your wallet address directly on the main screen of your wallet app. For example, in Tonkeeper: * Open the app * Look at the top of the main screen * Tap on the address to copy it ### Why you might see more than one address Some wallet apps support multiple blockchains. This means you may see: * A TON address (starts with EQ or UQ) * Addresses for other networks (for example, TRON)

A couple of addresses you may see in your wallet

Always make sure you’re sharing the TON address when using STON.fi. 📍 STON.fi works on the TON blockchain only. Now that you know where to find your wallet address, you’re ready to receive tokens, connect to STON.fi, and move on to swaps, liquidity, and other DeFi features. # How to buy GRAM (ex Toncoin) in Telegram Learn how to buy GRAM directly in Telegram and send it to your non-custodial wallet to use STON.fi and other TON apps safely. {% hint style="info" %} In this guide you’ll: ✅ Buy TON using Telegram’s built-in wallet\ ✅ Send TON to your non-custodial wallet\ ✅ Get ready for swaps and other on-chain actions {% endhint %} ### Why do you need TON? GRAM (ex. TON) is the native currency of the TON blockchain. You’ll need GRAM to: * Pay blockchain fees for any transaction * Swap tokens * Add liquidity * Interact with DeFi apps like STON.fi 💡 Even if you mainly use other tokens, a small GRAM balance is essential. ### Step 1. Open @wallet in Telegram Open Telegram and go to [@wallet](https://t.me/wallet). No setup needed, it’s already linked to your Telegram account. Tap Open Wallet (or Wallet) near the message input field.
### Step 2. Add crypto Inside @wallet tap Deposit:
### Step 3. Choose a purchase method Select a convenient option. We’ll use the simplest one for this example — P2P Express.
### Step 4. Select GRAM Choose GRAM and tap Continue. ### Step 5. Choose amount and currency * Select your local currency * Enter the amount you want to spend The app will show how much GRAM you’ll receive before confirmation. ### Step 6. Complete the purchase @wallet will match you with a seller. Follow the on-screen instructions: * Send the payment to the provided account * Wait for confirmation ✅ Once completed, GRAM will appear in your Telegram wallet. ### Why we don’t stop here @wallet in Telegram is custodial. That means the wallet is managed by a service, not fully by you. To use STON.fi and DeFi safely, you should move GRAM to a non-custodial wallet (like Tonkeeper), where only you control the keys. Let’s do that. ### Step 7. Send GRAM from Telegram to your wallet Open @wallet again and tap Withdraw.
### Step 8. Choose destination * Select External wallet or exchange
* Choose GRAM ### Step 9. Enter your wallet address Paste the address of your non-custodial TON wallet. If you’re not sure where to find it, [check the previous guide on wallet addresses](https://guide.ston.fi/en/start-here/where-to-find-your-wallet-address).
### Step 10. Choose amount and send * Enter the amount of GRAM to send * Tap Send ⚠️ Leave a small GRAM balance behind — network fees are paid in GRAM. 🎉 Done! Your GRAM is now in your own non-custodial wallet. You’re ready to connect to STON.fi and start using the TON ecosystem. # How to connect your TON wallet to STON.fi Learn how to connect your TON wallet to STON.fi and start using swaps, liquidity pools, farming, and other DeFi features — safely and in a few clicks. In this guide you’ll: ✅ Connect your TON wallet to STON.fi\ ✅ Choose the right connection method (mobile or desktop)\ ✅ Understand what happens during wallet connection {% embed url="" %} ### Why connect a wallet? STON.fi is a non-custodial DeFi protocol. This means: * Your wallet stays fully under your control * STON.fi never holds your funds * Every action requires your explicit confirmation Connecting a wallet simply allows the app to: * See your wallet address * Request transaction signatures (you always approve them) 💡 No funds are moved during connection. No permissions are given silently. ### Step 1. Open STON.fi Go to[ https://app.ston.fi/
](https://app.ston.fi/)Click Connect wallet in the top-right corner.
### Step 2. Choose how you’ll connect **📱 If you use a mobile wallet** 1. A QR code will appear on the screen 2. Open your TON wallet app (for example, Tonkeeper) 3. Use the built-in QR scanner 4. Scan the code and continue 🔍 The scanner icon looks the same in most TON wallets — you’ll recognize it.
**💻 If you use a desktop wallet or browser extension** 1. Click View all wallets 2. Select your wallet from the list
3. Choose the version: Browser extension, or Desktop app
### Step 3. Confirm the connection Your wallet will ask you to confirm the connection to STON.fi. Click Connect wallet in your wallet app or extension.
✅ That’s it — your wallet is now connected. Your wallet will stay connected until: * You manually disconnect it, or * You clear your browser cache ### Security note 🔒 Connecting a wallet: * Does NOT share your recovery phrase * Does NOT give STON.fi control over your funds * Does NOT execute any transactions Every transaction still requires your manual approval. If someone asks for your recovery phrase, close the tab and walk away. ### FAQ ❓ My wallet is not in the list. What should I do? Most likely, your wallet was created on another blockchain. STON.fi works on the TON blockchain only. Check our guide on [how to create a TON wallet](https://guide.ston.fi/en/start-here/how-to-create-a-ton-wallet). ❓ Desktop app or browser extension — how do I tell? * Desktop wallet: installed as a separate program on your computer * Browser extension: installed inside your browser and opens from the extensions menu Both work perfectly with STON.fi. ❓ I don’t see a connection request in my wallet This usually happens if: * You’re logged out of the wallet * The wallet wasn’t fully set up Open your wallet app, make sure your wallet is active, then try connecting again. 🎉 All set! Your wallet is connected, and you’re ready to explore swaps, liquidity, farming, and staking on STON.fi. # How to swap (exchange) tokens on STON.fi Learn how to swap one token for another on STON.fi — choose assets, review route, slippage and fees, and confirm safely in your wallet. {% hint style="info" %} **In this guide you’ll**:\ ✅ Select tokens and amounts\ ✅ Review route, fees, slippage, and “min received”\ ✅ Confirm the swap and verify the result {% endhint %} {% embed url="" %} Showcase video: how to swap tokens on STON.fi {% endembed %} ### Step 1. Open Swap tab Open the STON.fi app and go to the **Swap** tab.\ 💡 Keep a little GRAM in your wallet for network fees. ### Step 2. Pick tokens In “You pay”, choose the token you’re sending (for example, USDt).\ In “You get”, choose the token you’ll receive (for example, GRAM).\ Enter an amount on either side — the other side auto-calculates. Click **Swap**.

STON.fi interface: swap window

### Step 3. Review and confirm In a pop-up window verify the details: the tokens and amounts, the effective rate, your slippage tolerance, the fee reservation. All swaps on [STON.fi](http://ston.fi) are routed with Omniston — a liquidity aggregation protocol that finds the best route and price by aggregating liquidity across TON, then executes your swap in one go.

STON.fi interface: swap confirmation window

Click **Confirm swap** and approve the transaction in your wallet. ✅ Done! After confirmation, your new tokens appear in your wallet and app balance.\ 🔎 To verify on-chain, use the explorer link shown after the swap.

STON.fi interface: successful interface

### Common hiccups and quick fixes • Insufficient GRAM for fees: add a bit of GRAM and retry.\ • Slippage error or “price updated”: raise slippage slightly or lower the amount.\ • Token not visible in wallet: add the jetton to your wallet’s token list.\ • Allowance/approval prompt: approve once, then swap again. ### Smart safety habits 🔒 Use official links and verified tokens only.\ 💡 Keep slippage reasonable; avoid illiquid pairs for large swaps.\ 🚫 Never share your recovery phrase — no one from STON.fi will ever ask.
# Transaction parameters: what is price impact, exchange rate, blockchain fee, minimum received Understand transaction parameters on STON.fi, including price impact, exchange rate, blockchain fee, and minimum received. Learn how these factors affect your swaps and trading experience. As an experienced user in swaps, you've probably noticed that before making transactions on STON.fi, there are several different parameters displayed:
Let's consider each one separately. Let's start from the end, from simple to complex. **Route:** The path your funds will take to become the token you need. Cryptocurrency does not exist "on its own" — tokens are held in balanced pairs (called liquidity pools), for example, GRAM/STON. When you sell GRAM and buy STON for it, you are interacting with this pair, adding GRAM there and taking STON away. For simplicity, let's imagine these routes as flights: popular routes are usually connected by direct flights, while less demanded ones require transfers and additional costs. On STON.fi, you can only exchange tokens along direct routes — this is the simplest and most effective way of trading. **Blockchain fee:** The fee that the blockchain charges for each transaction. This is the payment for the blockchain's operation. **Minimum received:** History remembers cases when the token price changed dramatically during the transaction. A user expecting to receive a certain amount in exchange for tokens would receive a completely different amount (usually losing money — which, of course, is deeply unpleasant!). STON.fi solves this problem: the smart contract fixes the value of all assets at the time of the transaction. Even if at the moment you press 'Swap', the token price changes radically, you will receive the amount specified here. **Exchange rate:** The current rate of the token received to the one sold. **Price impact:** If you exchange a volume of tokens that represents a significant portion of the liquidity pool, i.e., available for exchange tokens, then by this operation you will change the ratio of the value of one token to another, and its price will change. For example, if you want to buy many tokens, but there are few of them in the pool, you risk buying them too expensively due to your own actions. You won't notice a price impact in large popular pools, but always remember this indicator. We consider transactions with a price impact above 5% disadvantageous in the vast majority of cases and warn about this in the swap app interface. *We remind you that within this guide, we provide information in a simplified form, omitting some details and generalizing the principles of exchange operation.* # How to import (find) your own token with a contract address Learn how to import (find) you own token with a contract address on STON.fi ### **Token import** 1. Enter a contract address into the search bar.
2. Wait until the token information from the blockchain is uploaded.
3. Press '**Agree and Proceed'.**

Importing a token with a contract address

After you have seen your token in the list, you will be able to see the amount of this token in your wallet. # Blockchain and DEX fees In this guide, you’ll learn how fees on STON.fi really work: what GRAM is temporarily reserved vs. actually consumed for swaps and liquidity provision, the typical cost ranges, and how pool (DEX) fees {% hint style="info" %} I**n short**: ✅ You always need a bit of GRAM to cover on-chain (network) fees. ✅ We reserve slightly more than the final fee so your transaction won’t fail; unused GRAM is auto-refunded. ✅ Swaps: we reserve up to \~0.35 GRAM; typical actual cost is \~0.06–0.09 GRAM, but can reach \~0.13 GRAM depending on the pool’s fee. ✅ Providing liquidity: we reserve per token (two reservations), usually up to \~0.7–0.8 GRAM total; typical actual cost is \~0.10–0.13 GRAM. ✅ DEX/trading fee (pool fee) is set per pool by its owner. A common setting is 0.30%; typically 0.20% goes to LPs and 0.10% to STON.fi, but the exact split follows the pool’s configured fee. {% endhint %} ### Why more GRAM is “reserved” TON network fees aren’t perfectly predictable upfront. To avoid failed transactions: * We temporarily reserve a bit more GRAM (the “cap”). * The unused part is sent back to you automatically right after execution. 💡 Think of it like tapping your card at a gas station: a higher hold first, then a final charge for what you actually used. ### Swaps * Reservation (cap): up to \~0.35 GRAM (can vary by route/pool). * Typical actual network fee: \~0.06–0.09 GRAM. * Upper bound in some cases: \~0.13 GRAM. * What drives it: the pool’s configured trading fee (set by the pool owner) and route complexity.

Any unused portion of the reservation is refunded.

### Providing Liquidity * Two signatures, two network actions (one per token). Network fees are reserved separately for each token, it makes two reservations in total. Costs refer to adding liquidity; removing liquidity typically incurs slightly lower network fees. * Total reservation: usually up to \~0.7–0.8 GRAM (both tokens combined). * Typical actual network fee (total): \~0.10–0.13 GRAM. * What drives it: pool configuration and whether you’re using balanced vs. arbitrary provision.
As with swaps, unused TON is refunded automatically.

As with swaps, unused GRAM is refunded automatically.

### DEX / Trading Fee (Pool Fee) * Who sets it: pool owner. * Common configuration: 0.30% per swap. * Where it goes: typically \~0.20% to LPs and \~0.10% to STON.fi. * But: the exact fee and split follow the pool’s current settings. 🔍 You can see the trading fee in the pool details before you swap or add liquidity. ### Practical tips ✅ Keep a small GRAM buffer for fees (even if you mainly hold jettons). ✅ Check the pool’s fee (0.30% is common, but not guaranteed). ✅ Expect a higher reservation on first tries or complex routes; the final spend is usually lower. ✅ If a transaction fails, reserved GRAM is automatically returned — you don’t lose it.
# How to get referral fees from swaps? Get a percentage of swaps made through your referral link on STON.fi. Simply create a referral link by appending your wallet address to the URL and share it with friends. [STON.fi](https://ston.fi/) offers a referral program that encourages users to share referral links and earn commissions. The structure of referral commissions varies between V1 and V2 pools. #### Key Referral Commission Differences Between V1 and V2 Pools | **Parameter** | **V1** | **V2** | | ---------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | Default referral percentage | 0.1% | Customizable (0.0% – 1.0%) | | Commission distribution | Automatic to wallet | Accumulates in vaults | | Manual withdrawal required | No | Yes | | Flexibility in referral percentage | No | Yes | | Transaction cost | Higher (referral fee is sent immediately to the referrer during the swap) | Lower (referral fee accrues in a vault; not transferred during the swap) | ### V1 referral commission **Default referral commission**\ In V1, users can share a referral link to receive a default commission of 0.1% from any swaps made through their link.\ \ **Example referral link:** \ 1. Automatic distribution\ The commission is automatically credited to the wallet that owns the referral\_address. No extra action is required.
2. Simplified workflow\ The commission is transferred immediately, which offers instant rewards for referrers. However, the swapping user pays a slightly higher gas/processing cost because the referral token transfer occurs within the swap transaction. ### V2 referral commission **Customizable referral percentage**\ In V2, the referral commission can be set by adding the referral\_percent parameter to the link. The value can range from 0% (0 bps) to 1% (100 bps).\ Note: referral\_percent is a decimal (e.g., 0.1 = 0.1%).\ \ **Example referral link (custom commission):** \\&referral\_percent=0.1 1. Accrued commission in vaults\ Commissions do not distribute automatically. Instead, they accumulate in vault contracts associated with the pools. As a result, the swapping user pays less because no immediate referral transfer is made. 2. Manual withdrawal, how to claim: Open:[ https://sdk-demo-app.ston.fi/vault](https://sdk-demo-app.ston.fi/vault)
Connect your wallet and review available referral fees for your address and click Claim on the ones you want.
Approve the transaction in your wallet.
After confirmation, the claimed fees will appear in your wallet. 3. Withdrawal Referrers must manually request the accumulated commission from the vault. This is done by sending a withdrawal request to the vault contract. *Docs:* [*https://docs.ston.fi/developer-section/omniston/omniston-referral-fees#id-2-withdrawing-your-fees*](https://docs.ston.fi/developer-section/omniston/omniston-referral-fees#id-2-withdrawing-your-fees) 4. Increased flexibility\ Referrers can set the commission to match their strategy (e.g., 0% for growth, 0.05%–0.2% for light incentives, up to 1% for high‑touch campaigns). ### Applicability of referral program * The referral program applies to all swaps performed after opening the DEX through the referral link. * The referral context resets if the page is refreshed, the app is closed, or the user operates in another tab/session. ### FAQ * **Does the 0.1% referral commission add extra cost or is it paid from the protocol fee?**\ Referral commissions are always added on top, making the exchange more expensive for the user by the amount of the referral commission. * **What happens if the \&referral\_percent= parameter is used for V1 pools?**\ It is ignored. For V1 pools, the referral percentage is always 0.1% if a referral\_address is specified. * **In which token is the referral commission accrued?**\ In the input token.\ Example: for USDT → STON, the input token is USDT, so the commission accrues in USDT. * **Does the referral commission apply to one swap or multiple swaps?**\ It applies to all swaps performed after opening the DEX via the referral link, until the referral context resets (page refresh, app closure, another tab/session). * **What happens if a value greater than 1% is set for referral\_percent?**\ The system automatically applies the maximum allowed value of 1%. * **What happens if \&referral\_percent= is not specified?**\ The default value of 0.1% is applied. * **Can anyone request the referral commission withdrawal?**\ Anyone can send a withdrawal request, but only the vault owner receives the rewards. The claim message simply triggers distribution to the vault owner. * **What happens if a non‑owner requests a withdrawal?**\ The non‑owner receives nothing. All rewards are sent to the vault owner. #### At‑a‑glance: building links * Minimum V1 link\ \&tt=\\&referral\_address=\ * Minimum V2 link with custom rate\ \&tt=\\&referral\_address=\\&referral\_percent=<0.0–1.0> * Reminder: If you need a visual walkthrough or screenshots for claiming V2 rewards, use the tutorial. # How to make a cross-chain swap on STON.fi Learn how to swap tokens across TON, Ethereum, Base, BNB Chain, and Polygon directly in the STON.fi app using Omniston's protected cross-chain execution. {% hint style="info" %} **In this guide you’ll:** ✅ Select the source and destination chains ✅ Choose supported tokens and enter an amount ✅ Review fees and transaction details ✅ Confirm the swap and receive assets on another blockchain {% endhint %} ### What is a cross-chain swap? A cross-chain swap lets you exchange assets between different blockchains in one action. Instead of using a bridge or a CEX, waiting for funds to arrive, and then making another swap, STON.fi combines everything into a single protected operation. Cross-chain swaps on STON.fi are powered by Omniston — our cross-chain liquidity and execution protocol. It finds the best available route and completes the entire operation atomically: either you receive exactly what was quoted, or the swap doesn't complete and your funds remain safe. ### Before you start, you’ll need * Two wallets: TON-compatible (say, Tonkeeper) and other chain-compatible, e. g. EVM (say, Metamask) * A supported token you plan to swap * A small GRAM (prev. Toncoin) amount if you're swapping from TON to cover network fees ### How to swap 1. Open the [STON.fi dApp](https://app.ston.fi/swap?mode=cross-chain\&in=ethereum%3AUSDT\&out=ton%3AUSD%E2%82%AE), switch to the **Cross-chain** tab, and choose a token you want to send. The token may be any from the list of compatible chains and tokens. Cross-chain Omniston is stablecoin-first by design, so as for June 2026, the list of supported tokens is as follows: • USDT on TON • USDT and USDC on Base • USDT and USDC on Ethereum • USDT and USDC on BNB Chain • PUSD and USDC on Polygon 💡 The list will expand over time as new chains and tokens become supported. 2. Select the supported token you want to receive. 3. Enter the amount of the token you want to receive or the token you want to send. 💡 Omniston is ready to link both sides of a cross-chain swap with paired HTLCs and send your quote to a resolver. You’ll see the exact amount you'll receive before you confirm. Click **Swap** when you're ready. 4. Review the transaction details: check rate, minimum received, and network fee before you swap. If everything looks correct, click **Confirm swap**. 5. Confirm the swap in your source chain wallet. If you swap from TON, you sign the transaction in your TON-compatible wallet, if it is EVM, you sign in your EVM-compatible wallet, say Metamask.
6. Once confirmed, Omniston completes the swap across both blockchains. Most swaps settle within 15–40 seconds. When the transaction finishes, your tokens will appear in your wallet on the destination chain. ✅ That's it! Your assets have moved across chains without bridges, CEXs, multiple apps, or manual transfers. ### Gasless swaps from EVM 👀 If you're swapping from an EVM chain, you usually don't need to hold the chain's native gas token for the swap itself. Depending on your wallet and token, the first transaction may require a token approval. Some wallets can make this approval gasless as well. Once approved, you normally won't need to repeat this step when swapping the same token from the same wallet. [Read more about gasless flow in this blog article](https://blog.ston.fi/omnistons-new-execution-model-gasless-scenarios/) # What is liquidity pool Learn what liquidity pools are on STON.fi, how they facilitate instant trades, and how liquidity providers get a percentage of transaction fees. Discover how to provide liquidity for rewards. **A liquidity pool** is like a "reservoir of cryptocurrencies," or more precisely, a pair of scales provided by users known as liquidity providers. Typically, a pool consists of two tokens that form a trading pair, such as GRAM and USDT. The size of the pool is determined by the amount of each token contributed by participants. These liquidity pools are managed by DEX smart contracts: during a swap, the required amount of Token A is taken from one side of the scale, and the amount of tokens given by the trader, Token B, is placed on the other side. The liquidity pool ensures that transactions are executed as quickly and safely as possible: users do not need to wait for someone with the required amount of tokens — the assets are always available in the liquidity pool. Without funds in the liquidity pool, there would be nothing to trade. ### **Where do tokens come from in the liquidity pool?** They are deposited there by liquidity providers because it can be useful. Often, token creators, by adding their token to DEX for trading, themselves provide liquidity — otherwise, no one would be able to buy it. Trading is impossible without liquidity pools, and therefore, the operation of DEX itself. Liquidity providers earn income — they receive a percentage for each transaction within the pool. On STON.fi, this is 0.2% of the transaction amount. These 0.2% are distributed among all liquidity providers in proportion to their share in the pool (for example, whoever provided 50% of all liquidity will receive half of 0.2% of each transaction in that pair). ### **Can I also provide liquidity and receive a percentage of the fees?** Of course! We will talk about this in the following chapters. But remember that liquidity provision must be balanced on both sides of the scale — which means you will need to choose the right liquidity pool and acquire both tokens from the pair in the required volume. *We remind you that within this guide, we provide information in a simplified form, omitting some details and generalizing the principles of DEX operation.* # Impermanent loss Impermanent loss explained — how price moves reshape your LP position, how to quantify the impact, and when fees can offset it. {% hint style="info" %} **In short**: ✅ Impermanent loss (IL) is the value difference between:\ (a) providing liquidity to a pool vs. (b) simply holding the same tokens, after prices move. ✅ It’s called “impermanent” because if the price ratio reverts, the gap shrinks. ✅ Swap fees (and incentives) can offset or exceed IL—that’s why LPing can still be profitable. ✅ Volatile pairs → higher IL risk; correlated/stable pairs → lower IL. {% endhint %} ### Why IL happens AMMs price assets by pool ratios rather than order books. When price moves on the market, arbitrage traders push the pool back to fair value by adding the cheaper token and removing the more expensive one. In a constant-product AMM (like most v2 pools), the pool keeps the product x\*y = k constant. As an LP, you end up holding more of the token that went down (relative) and less of the one that went up, compared to simple holding. That’s IL. ### Example Imagine you want to provide liquidity into the GRAM/USDt pool, and an initial prices are: 1 GRAM = 10 USDt (i. e. $10), 1 USDt = $1. Let’s say the pool reserves 100 GRAM and 1,000 USDt (each side worth $1,000). Remember the constant product formula? x\*y = k = 100 x 1,000 = 100,000 You decide to add liquidity: 10 GRAM ($100) + 100 USDt ($100) = $200\ Your pool share ≈ 10% Consider price change: GRAM pumps 4× vs USDt. New price: 1 GRAM = 40 USDt (=$40) Pool must rebalance to the new ratio with k: * Let new reserves be x GRAM and y USDt, with y =40 x and x ⋅ y = 100,000 * x ⋅ 40x=100,000 ⇒ x = 50, y = 2,000 * New pool: 50 GRAM and 2,000 USDt You decide to withdraw your 10% share: * You get 5 GRAM and 200 USDt * Value at new price: 5 × $40 + 200 × $1=$200 + $200 = $400 Compare to holding strategy: * If you had simply held 10 GRAM + 100 USDt: 10 × $40 + 100 × $1 = $400 + $100 = $500 Impermanent loss = $500 − $400 = $100 (−20%) relative to a holding strategy. 🔎 Note the pattern: as GRAM outperforms USDt, the pool tilts you away from GRAM and toward USDt — this is the essence of IL. IL depends on price ratio, not which side you added: if GRAM dumps vs USDt, you’ll end up holding more GRAM and less USDt than a holder — still IL. ### Quick Reference Table Below are common IL magnitudes (absolute %) | Price move | ≈ IL | | ---------- | ------- | | 1.25× | \~0.6% | | 1.5× | \~2.0% | | 1.75× | \~3.8% | | 2× | \~5.7% | | 3× | \~13.4% | | 4× | \~20.0% | | 5× | \~25.5% | {% hint style="info" %} 💡 For precise scenarios, use our [Impermanent Loss Calculator](https://tools.ston.fi/impermanent-loss-calculator). {% endhint %} ### Fees vs. IL * Swap fees (and possible farming incentives) accrue to LPs as trades happen. * If fee revenue ≥ IL, your net PnL can be positive. * Deeper and busier pools (with healthy volume) improve the odds of fees offsetting IL — but nothing is guaranteed. ### Common Misconceptions * “IL is a permanent loss.” → False. It’s impermanent until you withdraw; if prices revert, IL can shrink. * “Fees always cover IL.” → Not always. It depends on volume, fee rate, and how far prices move. * “Equal-value deposits eliminate IL.” → No. IL depends on price changes after you deposit, not how you enter. # How to provide liquidity on STON.fi Learn how to add your tokens to a pool on STON.fi. You’ll supply liquidity, receive LP tokens that represent your share, and your position will accrue a portion of swap fees over time. {% hint style="info" %} **In this guide you’ll**: ✅ Pick a pool and choose balanced or arbitrary provision ✅ Add liquidity step-by-step and confirm safely in your wallet ✅ Understand LP tokens and what happens after the deposit ✅ Review fees, good practices, and how to withdraw later {% endhint %} {% embed url="" %} ### You’ll need * A connected wallet (e.g., Tonkeeper) * The two tokens you plan to deposit * A small GRAM balance for network fees ### What’s a liquidity pool? A pool is a reservoir of two assets (e.g., STON and GRAM) managed by smart contracts. When users swap, the pool balances amounts; liquidity providers receive a share of swap fees. There are two ways to add liquidity: 1️⃣ **Balanced**: deposit the same dollar value of both tokens. 2️⃣ **Arbitrary** **(v2 pools)**: deposit in any ratio or even just one token; the contract handles the math. ### Step 1. Pick a pool Open Pools → choose a pair (e.g., STON/GRAM).\ Review **TVL**, **24h volume**, and **APR** to understand pool size, recent activity, and indicative fee rates. Click **Add liquidity**.

STON.fi interface: the STON/GRAM pool

💡 Tip: Use the search bar; verify token icons and tickers match what you intend to deposit. 🔗 Read more on pool metrics in the article [How to evaluate a liquidity pool](https://guide.ston.fi/en/providing-liquidity/how-to-evaluate-a-liquidity-pool-tvl-apr-trading-volume). ### Step 2. Choose your mode #### 🔹 Balanced (default) * Enter amount for Token A; the app auto-calculates Token B to match pool ratio. * Click **Preview liquidity provision**. #### 🔹 Arbitrary (V2) * Toggle **Arbitrary provision** to supply in any proportion. * Enter amounts → **Preview liquidity provision**.

STON.fi interface: adding liquidity

💡 Tip: Missing one of the tokens? Make a swap first, then return. ### Step 3. Review & confirm In the confirmation window you’ll see: * Indicative APR * Your pool share * Estimated network fee Click **Confirm liquidity provision**, then approve operation in your wallet. ### After confirmation * You’ll receive LP tokens representing your pool share; fee distributions accrue to the position over time. * Liquidity can be withdrawn anytime (subject to pool terms). * Fees are collected in the pool’s received token on each swap. ### After confirmation * Your LP positions appear in **Pools** → **My pools**. * Your position starts accruing a share of swap fees as trades happen in the pool. * You can add more liquidity or withdraw later from the same screen. ### Notes & good practice ✅ Keep a small GRAM buffer for fees. ✅ Larger pools generally mean lower price impact for swaps. ✅ Arbitrary mode is convenient when you mainly hold one side. ✅ If a pool has an active farm, you may stake LP tokens for additional reward programs. # Liquidity provision, farming, and staking — what's the difference? Liquidity provision, farming, and staking are basic operations on STON.fi. All three are related to locking assets to receive additional rewards and opportunities. This guide is for users who already know the basics of TON and want a practical overview of how these three earn mechanics work on [STON.fi](https://ston.fi). {% hint style="info" %} **In short**: ✅ Liquidity provision = you add tokens to a pool so others can swap; you earn swap fees. ✅ Farming = you stake LP tokens from a pool to earn extra rewards (on top of fees), often for a limited time. ✅ Staking = you lock tokens in a smart contract to earn specific rewards. No liquidity pool involved. {% endhint %} ### What is a liquidity pool? Think of a liquidity pool as a reservoir of cryptocurrencies funded by users called liquidity providers (LPs). * A pool typically holds two tokens that form a trading pair (GRAM/USDt). * The size of the pool depends on how much of each token participants contribute. * When someone swaps Token A → Token B, the smart contract takes B out and adds A in; the price updates automatically based on the pool’s math (AMM). * Bigger pools usually mean lower price impact and more stable pricing for traders. On STON.fi, LPs earn a share of trading fees from every swap that uses their pool, proportional to the liquidity they added. How it works: * You select a pair (e.g., GRAM/USDt) and add tokens to the pool. * In return, you receive LP tokens that represent your share of the pool. * As swaps happen, you earn fees; your share auto-compounds into the position. * You can usually withdraw anytime (unless you’ve staked LPs into a farm with a lock). {% hint style="info" %} **You earn**: swap fees.\ **You need**: the two tokens (or use “one-sided” options where available).\ **Main risk**: impermanent loss vs. just holding the assets. {% endhint %} 💡 [Learn how to provide liquidity](https://guide.ston.fi/en/how-to-provide-liquidity-on-ston.fi) 💡 [Learn more about impermanent loss](https://guide.ston.fi/en/impermanent-loss) ### Farming Projects want deeper pools so users can trade larger volumes with less slippage. To incentivize this, a project can launch a farm that pays extra rewards to LPs. How it works: 1. You provide liquidity to a pool and receive LP tokens. 2. You stake LP tokens in the farm’s smart contract. 3. You earn additional rewards (on top of swap fees) for as long as the farm runs or until you unstake. 4. Some farms are ongoing; others run for a fixed period and may include lock-ups. {% hint style="info" %} **You earn**: extra rewards (often the project’s token) + regular swap fees.\ **You need**: LP tokens from the selected pool.\ **Main trade-off**: lock-ups (if any) and the need to manage positions (claim/unstake). {% endhint %} 💡 [Learn more about farming on STON.fi](https://guide.ston.fi/en/how-to-farm-on-ston.fi) ### Staking Staking on STON.fi is separate from liquidity provision. You lock STON directly in a smart contract — no pool and no LP tokens. What you get are unique protocol-related rewards: * ARKENSTON — a soulbound NFT (non-transferable) tied to your wallet. Planned as a key to the STON.fi DAO (membership & governance access in the future). * GEMSTON — a community token (tradable). A calculator in the Stake tab shows how much GEMSTON you receive right after staking. * Boost Farm APR — a campaign-based perk. During the active Boost Farm APR campaign, staking STON can also unlock an APR multiplier for farming in the [STON/USDt V2](https://app.ston.fi/pools/EQBbsMjyLRj-xJE4eqMbtgABvPq34TF_hwiAGEAUGUb5sNGO) pool. The boost applies only during the campaign window and only while you have an active stake in the STON.fi app. {% hint style="info" %} **You earn**: specific staking rewards (ARKENSTON, GEMSTON) plus an opportunity to join an active Boost Farm APR campaign.\ **You need**: STON tokens to stake.\ **Main note**: not related to pools; rewards are protocol-specific. {% endhint %} 💡 [Learn how to stake STON](https://guide.ston.fi/en/staking-on-ston.fi) 💡 [Learn more on Boost Farm APR](https://blog.ston.fi/introducing-boost-farm-apr-extra-rewards-for-ston-stakers/) ### Side-by-side: what’s different? | **Feature** | **Liquidity Provision** | **Farming** | **Staking** | | ------------------ | ------------------------------- | --------------------------------- | ---------------------------------------------- | | Assets you deposit | Pair tokens (e.g., GRAM + USDt) | LP tokens from a pool | STON | | What you earn | Swap fees | Extra rewards (+ fees) | Protocol-specific rewards (ARKENSTON, GEMSTON) | | Lock-ups | Usually none (pool-level) | Possible (farm-level) | Depends on staking rules | | Main risk | Impermanent loss | Impermanent loss + lock-up if any | Opportunity cost (no IL) | | Tokens involved | Pool pair | LP tokens | STON only | | Goal | Power swaps & earn fees | Boost pool depth & reward LPs | Earn ecosystem rewards | ### Quick tips: do’s & don’ts ✅ Start small, learn the flows, then scale. ✅ Keep a little GRAM for fees. ✅ Read farm details (APR, duration, lock-ups) before staking LPs. ✅ Revisit positions regularly; claiming/farming mechanics can change. 🚫 Don’t assume pools keep “equal value” at all times — prices float with trades. 🚫 Don’t stake LPs you’ll need immediately if the farm has a lock. # Liquidity pool types Learn about different types of liquidity pools on STON.fi. Understand liquidity pools versions and how they affect liquidity providers. {% hint style="info" %} In a few minutes, you’ll understand how STON.fi pools work, how v1 (constant product) differs from v2 (advanced pool family), and how to choose the right pool for a given token pair. We start with quick comparison tables, then give short, parallel sections for each pool type, and wrap with a compact math appendix so builders can verify the mechanics. {% endhint %} ### Quick explanation: pools v1 vs v2 * Pools v1 (constant product). Classic AMM pools using the x·y = k invariant. They’re simple, reliable, and great for volatile pairs with equal exposure. V1 does not support single-sided liquidity adds and uses simpler fee/referral handling. * Pools v2 (advanced). A family of pool types — constant product, stableswap, weighted constant product, and weighted stableswap, plus upgrades like single-sided LP, Vault-based accounting, better position/LP management, gas optimizations, current SDK. Recommended for new pools/integrations. ### Pools v1 vs v2 at a glance | Parameter | V1 | V2 (current) | | ---------------------- | --------------------- | ---------------------------------------------------------------------------- | | Pool types | Constant product | Constant product, stableswap, weighted constant product, weighted stableswap | | Pricing curves | x·y = k only | Choice of invariant per pair; low-slippage options for correlated assets | | Single-sided liquidity | Not supported | Supported (deposit one asset; contracts rebalance) | | Fees and referrals | Inline in swap path | Accrue to Vaults with configurable withdrawal | | LP/position management | More manual flows | More automated updates and typed getters | | Gas and reliability | Standard | Optimized gas paths; sturdier failure handling | | SDK and integration | Legacy, generic calls | SDK v2 with typed pools/routers and unit helpers | | Recommended use | Legacy/compatibility | Default for all new pools and integrations | ### Pool types available in v2 | Type | What it’s for | How it behaves | Key trade-offs | | -------------------------------- | ------------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------- | | Constant product | Volatile/volatile pairs with equal exposure | x·y=k; price impact grows with trade size vs depth | Simple, always-on; higher IL for diverging prices | | Stableswap | Correlated assets (e.g., stablecoins, wrapped variants) | Low slippage near 1:1; curve steepens if ratio drifts | Efficient large swaps near peg; watch peg risk | | Weighted constant product (WCPI) | Uneven exposure (e.g., 80/20), portfolio-style pools | Constant-product with custom weights | Flexible exposure; risk depends on chosen weights | | Weighted stableswap | Stable-like assets with non-equal weights | Stableswap curve + weights + amplification factor A | Low slippage and flexible allocation; more tuning (weights, A) | ### Pool types explained #### Constant product pool **What it is** A classic AMM pool that keeps the product of two token reserves constant: x·y = k. Prices adjust automatically based on the relative amounts of the two assets in the pool. It removes order books and enables continuous, on-chain swaps. **How it works** The pool holds reserves X (Token A) and Y (Token B). When a user swaps A for B, he adds A and removes B so the product X·Y remains constant. Larger trades move the pool further from balance, so price impact grows with trade size relative to liquidity. **Advantages** Continuous liquidity without matching counterparties. Fully on-chain and non-custodial. Simple, well-understood mechanics that are easy to reason about and integrate. **Risks** Impermanent loss when token prices diverge; the effect grows with volatility and trade size. The mechanism is predictable but can produce meaningful slippage for big orders in shallow pools. **Best for (use scenarios)** Volatile–volatile pairs where equal exposure is acceptable, routing steps between non-correlated assets, and integrations that value simplicity and robustness. #### Weighted constant product pool **What it is** A constant-product pool with configurable asset weights (e.g., 80/20 instead of 50/50). Weights encode a target portfolio split, allowing uneven exposure while keeping AMM properties. **How it works** Each asset has a fixed weight (w₁, w₂ with w₁ + w₂ = 1). The invariant generalizes to x^{w₁}·y^{w₂} = k. Marginal price responds to trades based on weights: the heavier-weighted asset’s price moves less for the same order size; the lighter-weighted asset moves more. **Advantages** Customizable exposure that aligns with treasury or tokenomics goals. Potentially lower price impact than 50/50 for the heavily weighted side under typical flows. Useful for portfolio-style pools and asymmetric markets. **Risks** Outcome depends on chosen weights. Overweighting a volatile asset can increase variance and impermanent loss. Price impact still rises with order size relative to depth; poor weight choices reduce efficiency. **Best for (use scenarios)** Volatile–volatile or stable–volatile pairs where you want a non-50/50 mix (e.g., 80/20), programmatic treasury management, and strategies that need directional exposure inside the pool. #### Stableswap pool **What it is** A pool designed for assets that should trade near 1:1 (stablecoins, wrapped variants). Its curve is very flat around the peg, enabling large swaps with minimal price impact when assets are near equal value. **How it works** The invariant blends constant-sum behavior near 1:1 with constant-product behavior farther away. Around the peg, the curve is flat and efficient; as the pool drifts off-peg, the curve steepens to discourage imbalance and protect liquidity. **Advantages** Much lower slippage for like-valued assets, especially on large trades. Better preservation of intended 1:1 value and more efficient rebalancing across stable assets. **Risks** Primary risk is peg instability of the underlying assets. If one asset breaks peg or liquidity fragments elsewhere, slippage rises and impermanent loss can appear, though typically less than volatile pairs when pegs hold. **Best for (use scenarios)** Stable ↔ stable swaps (USDt/USDC, wrapped variants), cross-venue rebalancing, and routing legs that traverse pegged assets where price impact must stay minimal. #### Weighted stableswap pool **What it is** A hybrid that combines stableswap mechanics with configurable weights. It targets near-1:1 efficiency while allowing non-equal inventory splits across stable-like assets. **How it works** The pool applies stableswap’s flattened region around equilibrium and adds weights plus an amplification factor A. Weights set the target proportions; A controls how flat the curve stays near the weighted equilibrium and how quickly it steepens off-target. **Advantages** Low slippage for similar-value assets with the flexibility to hold them in non-equal proportions. Lets LPs match inventory or policy constraints without sacrificing near-peg efficiency. **Risks** More parameters to tune. Mis-setting A or weights can reduce efficiency or make the pool slow to correct imbalances. Settings should be reviewed as liquidity, flow patterns, or volatility change. **Best for (use scenarios)** Stable ↔ stable pairs where inventories aren’t meant to be 50/50, baskets of stable-like assets with operational targets, and strategies that need both low slippage and asymmetric holdings. ### Math appendix #### Constant product (CP) Invariant. x·y = k, where x and y are reserves. Spot price. p ≈ y/x (ignoring fees).\ Output estimate. For input Δx, output Δy ≈ y·Δx/(x+Δx).\ Example. X=1,000, Y=1,000. Swap Δx=10 → Δy≈9.90 before fees.

Figure 1: Uniswap pool work principle. Source: Cryptotesters

### Weighted constant product (WCP) Invariant (two-asset). x^{w₁}·y^{w₂} = k with w₁ + w₂ = 1. Spot price. p ≈ (w₁/w₂)·(y/x). Heavier weight on x makes price less sensitive to Δx.\ Interpretation. Weights encode desired exposure and shape price response under the same order size. \

Figure 2: Comparison of weighted pools vs traditional AMM pool. Source: Chaisomsri on Medium

#### Stableswap (SS) Idea. Blend between constant-sum near 1:1 and constant-product away from it.\ Amplification (A). Higher A flattens the curve near the peg (lower slippage for small imbalances) and steepens off-peg to restore balance.\ Effect. Efficient large swaps when assets stay close to 1:1; slippage grows if the ratio drifts far.

Figure 3: Comparison of a stableswap pool with a constant product pool (Uniswap). Source: The AMM Book

#### Weighted stableswap (WSS) Idea. Stableswap logic with non-equal weights and amplification A.\ Behavior. Low slippage near the weighted equilibrium; weights set the target mix, A controls flatness.\ Tuning. Start with weights that match intended inventory; size A to expected variance and revisit after market or flow changes. Understanding how each pool type works means you can evaluate routes, provision liquidity, and design policies independently, without waiting for someone else’s take. The result is better decisions, fewer surprises, and pools that behave the way you intend. # How to create a new liquidity pool Learn how to create a pool v2 on STON.fi and seed it with liquidity in one transaction — simple, fast, secure. Through the pool creation you may also add a new token to the protocol taking into account [STON.fi](https://ston.fi/)’s internal policy limitations and UI filtering rules. {% hint style="info" %} **Before you start**: ✅ Connect your wallet at app.ston.fi ✅ Have both tokens you’ll use (enough to seed initial liquidity) ✅ Keep a bit of GRAM for fees ✅ Check whether either token has fee-on-transfer / taxable mechanics, as this may affect how the pool and swaps are handled in the interface
{% endhint %} 🔎 Initial price matters: the token ratio you deposit sets the pool’s starting price. If it’s far from the market, arbitrage can move it (you may take a loss). If one of the tokens is taxable, its transfer mechanics may also affect received amounts and swap behavior. ### Step 1. Start pool creation Open Pools → click Add liquidity.
In Provide liquidity, select Token A and Token B (your new pair). 💡 Tip: verify token contracts (tickers can repeat).
### Step 2. Configure a new pool Under the info banner, set up the pool: 1. Set token ratio by entering deposit amounts for both tokens. This defines the initial price (Price = TokenB / TokenA). 2. Enter the amount of each token you’re adding as initial liquidity. 3. Click Preview pool creation. 💡 Quick sanity check: * Does the implied price match the broader market? * Is your liquidity size sufficient to keep price impact reasonable? * Do you have enough GRAM reserved for fees? * Does either token have fee-on-transfer / taxable mechanics that may trigger interface warnings or swap restrictions?
### Step 3. Review & Confirm 1. In the popup, review amounts, price, and fee reservation. 2. Fees are taken in GRAM from your wallet. 3. The liquidity you add is locked into the pool. Click Confirm pool creation and approve in your wallet.
🎉 Done! Your v2 pool is live. ### Adding a token to STON.fi via a new pool On STON.fi, anyone can introduce a new token by creating a v2 liquidity pool for it. This is the standard, permissionless way to make a token swappable via the protocol. If the token passes our interface policies (see below), it will also be discoverable in the app by name; otherwise, it may be accessible only by contract address or hidden from the UI. #### Why STON.fi labels tokens DeFi is open by design. Anyone can deploy a token, and that openness is one of blockchain’s core strengths. STON.fi does not decide what should or should not exist onchain. Labels are used only at the interface level to give users more context before they interact with a token. In other words, labeling is an interface-level transparency tool. Labels are based on observable signals and documented inputs, such as user complaints, manual monitoring, honeypot alerts, and official legal requests. ### Labeled tokens: what it means in practice * Most labeled tokens can only be found by entering the contract address manually. * Fake and Honeypot tokens cannot be swapped in the STON.fi dApp. * Taxable tokens may have limited support, but only under strict technical safeguards. Tokens with transfer tax above 10% are not supported for swaps. * Suspicious and DMCA Notice labels act as warnings; such tokens may still be available in the dApp. * A label does not remove a token from the blockchain. The token still exists onchain and may remain accessible through other interfaces or direct contract interaction. 💡 [Read more on how STON.fi labels non-standard tokens](https://blog.ston.fi/know-what-youre-interacting-with-how-ston-fi-labels-non-standard-tokens/) ### What’s next? * Add more liquidity to reduce price impact and improve trading experience. Read more in the [How to provide liquidity on STON.fi](/providing-liquidity/how-to-provide-liquidity-on-ston.fi) guide. * Share the pool with your community to bootstrap volume. * Monitor fees earned, volume, and price impact. # How to withdraw funds from a liquidity pool Learn how to withdraw your liquidity from a pool on STON.fi, receive your tokens back, and understand what affects the final amounts. {% hint style="info" %} In this guide you’ll: ✅ Withdraw liquidity step by step\ ✅ Choose how much of your position to exit\ ✅ Understand what affects the tokens you receive\ ✅ Know what to check before confirming the transaction {% endhint %} ### Before you start Make sure you have: • A connected wallet\ • An active liquidity position\ • A small amount of GRAM to cover blockchain fees {% embed url="" %} ### Step 1. Open your pools Go to the **Pools** section and switch to the **My Pools** tab. Here you’ll see all liquidity pools where you have an active position.

“My Pools” tab in the Pools section

### Step 2. Select a pool 1. Choose the pool you want to withdraw from. 2. Open it and scroll down to the bottom of the page. 3. Click **Withdraw**.

The bottom of a pool page

### Step 3. Choose withdrawal amount In the withdrawal window: • Select how much liquidity you want to withdraw\ • Use **MAX** if you want to exit the position completely The interface will show the estimated amounts of each token you will receive.
### Step 4. Confirm the withdrawal Click **Withdraw Liquidity** and confirm the transaction in your wallet. After confirmation, your tokens will be returned to your wallet. ✅ Done! Your liquidity has been withdrawn. ### What affects the final amounts you receive When you withdraw liquidity, you do not necessarily receive the exact same token amounts you initially deposited. Two main factors affect the result: #### 1. Swap fees gained As trades happen in the pool, fees accumulate and are added to your position. This means your final amount may be higher than your initial deposit. #### 2. Impermanent loss Impermanent loss is the difference between holding tokens and providing liquidity after prices change. If the price ratio of tokens changed while your liquidity was in the pool, the proportions of tokens you receive will also change. {% hint style="warning" %} ### Important notes * Withdrawing liquidity is an on-chain transaction. You must have enough GRAM in your wallet to cover blockchain fees. * Always review the token amounts before confirming. Pool state and prices may change over time. {% endhint %} ### Bottom line Withdrawing liquidity on STON.fi is a simple process: Select pool → choose amount → confirm transaction What you receive depends on: • Fees earned in the pool\ • Price changes during your participation Understanding this helps you exit positions without surprises.
# How to evaluate a liquidity pool (TVL, APR, trading volume) Learn how to read the main liquidity pool metrics on STON.fi and use them to assess pool size, activity, and potential fee generation. {% hint style="info" %} **In this guide you’ll:** ✅ Understand what TVL, APR, and 24h volume mean ✅ See how these metrics affect trading conditions and liquidity provision ✅ Learn what “My Liquidity” shows in the pool list ✅ Understand why pool metrics change over time {% endhint %} When you open the **Pools** tab on STON.fi, you’ll see a list of available liquidity pools and several metrics.
These metrics help you quickly assess how large a pool is, how actively it is used, and what kind of fee-based returns it may generate for liquidity providers. ⚠️ Important: pool data is dynamic. As new tokens appear and market conditions change, both the list of pools and their metrics can change significantly. This means the values you see in screenshots may differ from what you currently see in the app. ### APR ℹ️ **APR (Annual Percentage Rate)** shows the estimated annualized return from the pool, expressed as a percentage. On STON.fi, this value is based on recent pool activity, typically using data from the last 24 hours. In simple terms, APR answers this question: **if the recent trading activity and liquidity size stayed roughly the same for a full year, what annual return might liquidity providers earn?** But in DeFi, conditions rarely stay unchanged. Trading volume, fees, token prices, and liquidity levels move constantly, so APR can rise or fall from day to day. ⚠️ APR is not a guaranteed return. It is only an estimate based on recent data. Past performance does not guarantee future results. ### TVL ℹ️ **TVL (Total Value Locked)** is the total dollar value of tokens currently deposited in a liquidity pool. This metric helps you understand the pool’s size. In general: • Higher TVL usually means deeper liquidity • Deeper liquidity usually means lower price impact for swaps • Larger pools are typically better able to handle bigger trades That does not automatically make a pool better in every sense, but it usually means the pool is more stable from a trading perspective. ### Volume (24h) ℹ️ **Volume (24h)** shows how much trading activity passed through the pool over the last 24 hours. This metric helps you understand whether the pool is actually being used. In general: • Higher volume means the pool is seeing more trading activity • More trading activity usually means more swap fees are being generated • More fees can mean better earnings for liquidity providers A pool with high TVL but very low volume may be large, but not especially productive. A pool with strong volume relative to its size may generate fees more efficiently. ### My Liquidity **My Liquidity** shows how much liquidity **you personally** have provided to that pool, expressed in dollar terms. This helps you quickly see whether you already have an active position in a pool and how large it is compared to others in your portfolio. ### How to read these metrics together It’s better not to look at any one metric in isolation. A more practical approach is: • **TVL** helps you judge pool depth • **Volume** helps you judge recent activity • **APR** helps you estimate recent fee-based return potential For example: • A pool with **high TVL + high volume** may be deep and actively used • A pool with **low TVL + high volume** may offer strong fee generation, but can also be more volatile • A pool with high **TVL + low volume** may be stable, but less efficient from an earnings perspective ### Bottom line Pool metrics help you evaluate how a liquidity pool is functioning right now. **APR** → estimated return based on recent activity **TVL** → pool size and liquidity depth **Volume (24h)** → recent trading activity **My Liquidity** → your personal position in the pool Understanding these metrics makes it easier to compare pools and make more informed decisions before providing liquidity.
# Liquidity provision with Ledger Read a getting started guide to use liquidity provision with Ledger on STON.fi, step-by-step instruction. ## Liquidity Provision with Ledger This guide explains how to add liquidity on [STON.fi](https://ston.fi/) using a **Ledger hardware wallet**. ⚠️ **Note:** Ledger signs only one transaction at a time. Adding liquidity often requires **multiple signatures**. Don’t worry — the [STON.fi app](https://app.ston.fi/) detects that you use a Ledger wallet and guides you step-by-step. Your funds are always safe, even if you stop halfway. *** ### ✅ Before You Start Make sure: you have * Your **Ledger device set up** * Ledger **connected to Tonkeeper** ([see guide](https://tonkeeper.helpscoutdocs.com/article/86-how-to-connect-ledger-to-tonkeeper)) * A stable internet connection ### Step 1. Connect Ledger to [STON.fi](https://ston.fi/) 1. Open [STON.fi app](https://app.ston.fi/). 2. Click **Connect Wallet → TonKeeper → Ledger wallet**. ### Step 2. Choose a Pool There are two ways to choose a pool: * **Direct**. Go to [Provide liquidity page](https://app.ston.fi/liquidity/provide?utm_source=chatgpt.com) → pick a token pair (e.g., GRAM**/STON**) → click **Select pair**.
* **From Pools List.** Open [Pools](https://app.ston.fi/pools) → select a pool → click **Add Liquidity**.
### Step 3. Select Provision Mode You can provide liquidity in two modes: #### 🔹 Balanced Mode (default) Provide equal value of both tokens.
* Enter the amount of Token A → Token B is calculated automatically. * Click Preview liquidity provision → **Confirm liquidity provision**.
* In the confirmation window, approve the action.
* Sign two transactions with Ledger: * Token A deposit\
* Token B deposit\ \ ⚠️ Keep the confirmation window open until both signatures are complete.\
#### 2. Arbitrary Provision (optional) Supply tokens in any ratio. The pool automatically balances your contribution to align with the required ratio.
* You can provide one or two tokens. * Sign one transaction (if one token) or two transactions (if two tokens). * Click Preview liquidity provision → Confirm liquidity provision.
* Sign transactions with Ledger as prompted. ✅ That’s it! You’ve successfully added liquidity on [STON.fi](https://ston.fi/) with Ledger. ❌ Limitations. Pool creation is not supported with Ledger yet. You can only add liquidity to existing pools. ### Special Cases with Ledger Since Ledger signs one transaction at a time, you may see intermediate states:
Case 1: Signed only one token What to do: * Sign the second transaction to finish, OR * Use Arbitrary provision to complete the operation with a single token, OR * Refund the first token back to your wallet. Case 2: Both tokens sent but provision not completed What to do: * Complete liquidity provision with already sent tokens, OR * Add more tokens to increase your LP position, OR * Refund tokens back to your wallet. 👉 Every action requires a Ledger signature. 👉 Your funds remain safe at all times.
# How to add a new token on STON.fi Anyone can add a token to STON.fi by creating a v2 liquidity pool. This guide explains when it’s appropriate, how to do it safely, and how interface policies affect visibility, warnings, and swaps. STON.fi is permissionless: new tokens become swappable by creating a liquidity pool. This guide walks you through the process, what to check beforehand, and when a token may be shown with warnings, restricted, hidden, or blocked in the interface even if the pool exists on-chain. {% hint style="info" %} Before you start: ✅ Ensure you hold enough of both assets to seed the pool. ✅ Review STON.fi interface policies (taxable tokens, IP/impersonation) so you know how visibility works after creation. {% endhint %} ### When adding a token is appropriate * You’re the token issuer or an authorized contributor. * You’re listing a community token that does not violate IP or impersonate other assets. * If the token uses fee-on-transfer (“tax”) mechanics, you understand that STON.fi does not endorse such tokens and supports them only in limited cases, with user warnings and technical restrictions. Read more on tax tokens: [Tax tokens on TON: what they are and how STON.fi handles them](https://blog.ston.fi/tax-tokens-on-ton-what-they-are-and-why-they-arent-on-ston-fi/) ### Step-by-step: add a token by creating a pool 1. Open STON.fi → Pools → Add liquidity. 2. In “Provide liquidity,” select the token pair for the pool (e.g., NEW/GRAM or NEW/USDt). If your token doesn’t appear by name, paste its contract address. **Configure the pool**: * Set the initial price by choosing amounts for each side. * Review settings and click **Preview pool creation**. **Confirm**: * Check the popup details (pool parameters, fee from your wallet). * Click **Confirm pool creation** and approve in your wallet.\ Pool creation and initial liquidity happen in one transaction. For the exact click-paths and screenshots, follow guide [How to create a new liquidity pool](https://guide.ston.fi/en/providing-liquidity/how-to-create-a-new-liquidity-pool). ### After creation * Your pool is live on-chain; swaps can route through it at the protocol level. * If the token complies with interface policies and technical restrictions, it may appear in [app.ston.fi](https://www.google.com/url?q=http://app.ston.fi\&sa=D\&source=docs\&ust=1778070760205503\&usg=AOvVaw3rZF0cupoqnf_JalCWE0Bb) search by name. Otherwise, it may be accessible only by contract address. #### Why STON.fi labels tokens Labels are used only at the interface level to give users more context before they interact with a token. In other words, labeling is an interface-level transparency tool. Labels are based on observable signals and documented inputs, such as user complaints, manual monitoring, honeypot alerts, and official legal requests. #### Labeled tokens: what it means in practice * Most labeled tokens can only be found by entering the contract address manually. * Fake and Honeypot tokens cannot be swapped in the STON.fi dApp. * Taxable tokens may have limited support, but only under strict technical safeguards. Tokens with transfer tax above 10% are not supported for swaps. * Suspicious and DMCA Notice labels act as warnings; such tokens may still be available in the dApp. * A label does not remove a token from the blockchain. The token still exists onchain and may remain accessible through other interfaces or direct contract interaction. 💡 [Read more on how STON.fi labels non-standard tokens](https://blog.ston.fi/know-what-youre-interacting-with-how-ston-fi-labels-non-standard-tokens/) ### Important limits: taxable tokens (fee-on-transfer) To keep swaps predictable and safe, the STON.fi interface disables “taxable” (fee-on-transfer) tokens. Our AMM/aggregation contracts cannot reliably account for variable transfer deductions across multi-hop routes.\ What this means for you: * You can still create a pool for a tax token at the protocol level. * However, the token will not be surfaced or routed in app.ston.fi. * Other third-party interfaces may still access the pool directly via the blockchain. Use caution and do your own research. ### Important limits: intellectual property and impersonation Per our [Terms of Use](https://ston.fi/terms), STON.fi hides tokens that: * impersonate known assets (e.g., fake “USDt”, “BTC”), * misuse brands, names, logos, or characters without permission, * claim affiliation with legitimate projects when they are not. Meme tokens are welcome when they’re original. Direct copies of protected brands are not. ### Visibility rules in the interface * Hidden: Some tokens won’t show up by name, but can be used if you enter the contract address manually. Responsibility is on you; verify what you’re adding. * Blacklisted: Fraudulent tokens are blocked entirely in the UI (even by address).\ These rules affect only the app interface. Pools still exist on-chain and can be accessed programmatically or via other UIs.
Important limits: taxable tokens (fee-on-transfer) To keep swaps predictable and safe, STON.fi treats taxable tokens as a special-risk category. The interface supports taxable tokens only in limited cases, shows users a clear warning, and applies technical restrictions because transfer deductions can affect received amounts and make routing less predictable. Taxable tokens cannot be used as intermediate assets in routes, and tokens with a transfer tax above 10% are not supported for swaps. * You can still create a pool for a tax token at the protocol level. * However, [app.ston.fi](https://www.google.com/url?q=http://app.ston.fi\&sa=D\&source=docs\&ust=1778065345725201\&usg=AOvVaw2CII-t4NwPBgOcqQ-pKvoH) will handle the token according to its taxable-token rules: the UI will show a warning, the token cannot be used as an intermediate asset in routes, and swaps are not supported if the transfer tax is above 10%. * Other third-party interfaces may still access the pool directly via the blockchain. Use caution and do your own research.
Important limits: intellectual property and impersonation Per our [Terms of Use](https://ston.fi/terms), STON.fi hides tokens that: * impersonate known assets (e.g., fake “USDt”, “BTC”), * misuse brands, names, logos, or characters without permission, * claim affiliation with legitimate projects when they are not. Meme tokens are welcome when they’re original. Direct copies of protected brands are not.
### FAQ ❓ **Can I add a token name/logo?**\ Token metadata is read from the ecosystem’s token registries and community resources. Names/logos may take time to propagate; always share the contract address so users can verify.\ ❓ **Why don’t I see my token by name?**\ It may be new because metadata has not propagated yet, hidden by policy, restricted for swaps on STON.fi if it violates safety rules. Users may still be able to paste the contract address. Taxable tokens can still carry warnings and swap restrictions.\ ❓ **Can I create multiple pools for the same token?**\ Yes, but liquidity fragmentation can worsen swap conditions. It’s usually better to build depth in one or two key pairs (e.g., NEW/GRAM or NEW/USDt).\ ❓ **Does STON.fi “list” tokens?**\ No approvals are needed at the protocol level. The UI applies safety filters to protect users; the protocol itself remains open and decentralized.
# What is farming? Learn how farming works on STON.fi, why projects launch farms, and how staking LP tokens adds an extra reward layer on top of liquidity provision. {% hint style="info" %} **In this guide you’ll:**\ ✅ Understand what farming is and how it works\ ✅ Learn how LP tokens are used in farming\ ✅ See where rewards come from\ ✅ Understand key conditions like lock-ups and farm duration {% endhint %} ### What is farming (in simple terms) Farming is an additional layer on top of liquidity provision. You provide liquidity to a pool and receive LP tokens. Then you stake those LP tokens in a farm to receive extra rewards distributed by a smart contract. 💡 In short: * Liquidity provision gives you LP tokens. * Farming uses those LP tokens to receive additional incentives. ### Why farming exists Projects want deeper liquidity in their pools so users can swap larger amounts with lower price impact. To incentivize this, a project can launch a farm: * It allocates a reward pool (usually in its own token) * A smart contract distributes these rewards among participants * The more LP tokens you stake, the larger your share Farming is simply a way to encourage users to keep liquidity in specific pools. ### What you receive When participating in farming, you get: • A share of swap fees from the liquidity pool\ • Additional rewards from the farm (often the project’s token) ### Types of farms Farms can differ in how they operate. For example, ongoing farms have no fixed end date. Rewards continue as long as the farm is funded. Fixed-period farms run for a limited time with a predefined reward pool. ### What you need to participate To join a farm, you need: • LP tokens from the selected pool\ • A connected non-custodial wallet\ • A small amount of GRAM for transaction fees ### What to keep in mind Farming introduces additional factors compared to simple liquidity provision: • Your LP tokens may be locked (depending on the farm)\ • You need to manage your position (claim rewards, unstake)\ • Your underlying liquidity is still exposed to pool dynamics (see Impermanent loss) ### Bottom line Farming is a mechanism that distributes additional rewards to liquidity providers who stake their LP tokens. It helps projects strengthen liquidity, and gives participants an extra incentive to stay in the pool with clearly defined conditions. # How to farm on STON.fi Learn how to activate farming on STON.fi, lock your LP tokens, track rewards, and unwind positions without surprises. {% hint style="info" %} **In this guide you’ll**:\ ✅ Activate farming on an eligible pool\ ✅ Stake (lock) LP tokens for farming\ ✅ Understand lockups and how to exit safely {% endhint %} {% embed url="" %} ### What is farming? You add liquidity to a pool and receive LP tokens. When you stake LP in a farm, the farm’s smart contract distributes rewards among all participants based on their staked share. Some farms have a lockup period; others are flexible. ### Quickstart (if you already know a pool with active farming) Head to **Pools** → click **Add liquidity**.

Adding liquidity button

Pick a pair, e.g., STON/USDt. Toggle **Get farm rewards** option. This will place your liquidity position into active farming within a single transaction. ✅ Done — in one operation you got LP tokens, locked in the pool, and rewards start accruing.

Providing liquidity on STON.fi

### If you are not aware of pools with active farming Go to **Pools** → toggle **Farming** to show eligible pools → pick the pool you want.

STON.fi interface: Pools — Farming toggle on

Click **Add Liquidity**, enter amounts, toggle **Get farm rewards** option, and confirm in your wallet. You’ll receive **LP tokens** and instantly start staking them in the pool, getting more rewards. ### Already have LP tokens in the pool? If you already have provided liquidity to this pool, you have LP tokens. You may open the pool and click **Farm**.

Farming page example

Verify the details in the confirmation window, and click **Farm**. Approve in your wallet. # How to withdraw funds from farming Learn how to withdraw funds from farming on STON.fi, including claiming rewards, unlocking LP tokens, and retrieving liquidity. Follow the steps to manage your farming positions and withdraw assets. {% hint style="info" %} **In this guide you’ll**: ✅ Claim your farming rewards ✅ Unstake (unlock) your LP tokens ✅ Withdraw your liquidity back to your wallet {% endhint %} 💡 Here's what you can withdraw from your farming position: * Rewards you’ve earned * LP tokens you staked in the farm * Underlying liquidity (your tokens inside the pool) These come out in separate steps — like luggage, carry-on, and that extra souvenir. 😅 {% embed url="" %} ### Before you start * Connect your wallet at [app.ston.fi](https://app.ston.fi/) * Have a little GRAM for network fees * Go to Pools → select My Pools tab to find your active positions
### Step 1. Claim your rewards 1. Open Pools and select My Pools tab. 2. Scroll to Farm Positions → My Positions. 3. Click Claim rewards → confirm in your wallet.

✅ After this, only your rewards go to your wallet. 🔒 Your LP tokens are still staked in the farm, and your liquidity remains in the pool. 😌 Mini-moment of joy: Watching the rewards hit your wallet is legally considered self-care. ### Step 2. Unstake (unlock) your LP tokens Your LP tokens are what you staked to join the farm. They are locked in the smart contract during farming. Unstaking finishes farming and returns LP tokens to your wallet. 1. In Farm Positions → My Positions, find your farm. 2. Click the “−” (minus) icon to remove your staked LP tokens.
If the button is disabled, there’s an active lock-up. Hover the tooltip to see time left. 3. Confirm the transaction in your wallet. {% hint style="info" %} ⚠️ **Important**: You can only unstake the full staked amount. {% endhint %} ✅ Any unclaimed rewards will be auto-claimed when you unstake. #### When the farm has ended (no “−” icon) 😎 No minus? No problem. Ended farms don’t lock your LP anymore — the interface just switches to a Remove and claim flow, and the “−” icon isn’t shown in the UI. After removing and claiming you’ll get your LP-tokens and rewards in full.
### Step 3. Withdraw your liquidity from the pool Unstaking LP tokens doesn’t pull your assets out of the pool yet — you still need to withdraw the underlying tokens. 1. Go to Pools → My Pools and open the pool you want to exit.
2. At the bottom of the page, find information about your provided liquidity (My total liquidity). Сlick Withdraw.
3. Choose how much to withdraw (use MAX to exit fully).
4. Click Withdraw Liquidity → confirm in your wallet. ⚡ You’ll need a bit of GRAM for fees to execute the withdrawal.\ 🔍 Check the token amounts you’ll receive — fees & pool state can change the split.\ 📉 Remember about impermanent loss: your received amounts may differ from your initial deposit due to price movement while you were providing liquidity. [Learn more on impermanent loss](https://guide.ston.fi/en/impermanent-loss). ### Common questions & quick fixes * **I don’t see the “−” icon to unstake.** If the farm ended, the minus icon is hidden. You may remove LP tokens and claim rewards if needed. * **The minus button is greyed out.** Your LP tokens are still locked. Hover the timer tooltip to see when you can unstake. * **I claimed rewards but can’t withdraw liquidity.** Make sure your LP tokens are back in your wallet (unstaked). Only then you can withdraw liquidity. * **Transaction failed.** Keep a small buffer of GRAM for fees and try again. ### Pro tips * Claim rewards regularly — no need to wait until unstaking. * Unstake fully when you’re done farming; partial unstake isn’t supported. * Use MAX when withdrawing if you want to fully exit the pool. ✅ That’s it! You’ve claimed rewards, unstaked LP, and withdrawn your liquidity — clean and complete.
# Staking on STON.fi Staking on STON.fi means locking your tokens in a smart contract for a chosen period to get protocol rewards, with clear timers and on-chain transparency. Learn how to stake STON. {% hint style="info" %} **In this guide you’ll**:\ ✅ Stake STON step-by-step ✅ See what ARKENSTON & GEMSTON do for you ✅ Learn how staking opens way to join campaigns like Boost Farm APR ✅ Understand lock-ups and how to unstake {% endhint %} {% embed url="" %} Showcase video: how to stake tokens on STON.fi {% endembed %} ### What is staking? Staking is locking STON in a smart contract for a chosen period to receive protocol rewards. You keep custody; the contract enforces the lock-up. 💡 When you farm, you stake LP tokens to get extra rewards on top of pool fees. Lock-up depends on the farm. When you stake, you stake STON and get protocol-defined rewards. Lock-up is chosen by you. Read more on the difference between liquidity provision, staking, and farming [in this guide](https://guide.ston.fi/en/providing-liquidity/liquidity-provision-farming-and-staking-whats-the-difference). ### What you get * **ARKENSTON** (soulbound NFT). Tied to your wallet; not transferable. It’s designed as proof of long-term alignment with the protocol and an access key to governanceIt is your entry pass to the STON.fi DAO and your voting power — the level of influence you have in the DAO. The more STON you stake and the longer you lock it in the protocol, the more voting power you have. * **GEMSTON** (community token). Issued at stake time per the on-screen calculator. Its utility and distribution rules will be set by the DAO. In practice, that means GEMSTON is the lever the community can use to power programs, incentives, and access mechanics over time — aligning active participants with the protocol’s growth while keeping the rules transparent and on-chain. * **Boost Farm APR** (campaign-based perk). During the active Boost Farm APR campaign, staking STON can also unlock an APR multiplier for farming in the STON/USDt V2 pool. The boost applies only during the campaign window and only while you have an active stake in the STON.fi app. 💡 [Learn more on how to join the STON.fi DAO](https://dao.ston.fi/about) 💡 [Learn more on Boost Farm APR](https://blog.ston.fi/boost-farm-apr-extra-rewards-for-ston-stakers-in-the-ston-usdt-v2-pool/) ### Before you start * A TON wallet connected to STON.fi * Some STON to stake * A little GRAM for network fees ### How to stake 1. Head to the **Stake tab → click Stake STON**. 2. Enter amount and choose duration (lock-up length). Review the rewards preview. 3. Confirm the transaction in your wallet.

STON.fi staking interface

✅ That’s it! Staking starts immediately. ### How to join Boost Farm APR (STON/USDt V2) Boost Farm APR is a time-limited campaign program for STON stakers. If the campaign is active and you both stake STON and farm the STON/USDt V2 pool, your farm rewards receive an APR multiplier. Boost tiers (stake amount in the STON.fi app): * Stake 500+ STON → up to 1.5× farm APR * Stake 1,000+ STON → up to 2× farm APR #### Step-by-step: 1. Stake STON as described above. Use the stake amount to target the multiplier tier you want. 2. Go to **Pools**, switch on **Farming**, and find the STON/USDt V2 pool. Verify that the program is active — you can see it in the label.
3. To participate in farming, first add liquidity to this pool. Ensure you have some USDt to provide liquidity in **STON/USDt V2**.
4. Toggle **Get farm** **rewards** option. This will place your liquidity position into active farming and grant you LP tokens within a single transaction. That’s it!
If you already have provided liquidity to this pool, you have LP tokens. You may [open the pool](https://app.ston.fi/pools/EQBbsMjyLRj-xJE4eqMbtgABvPq34TF_hwiAGEAUGUb5sNGO) and click **Farm**. Read more on farming in [How to farm on STON.fi](https://guide.ston.fi/en/farming/how-to-farm-on-ston.fi) guide. 📢 **Important rules** * The boost applies only while you are actively staking during the campaign window. If your stake ends, boost accrual stops. * Maximum eligible liquidity for the boost is $10,000 per participant. * The “boost” portion is paid out in STON via an airdrop during the specified rewards period. ### How to unstake? * No early exit. Unstaking is available only after the selected period ends. * When the timer hits zero, return to **Stake → Manage your stakes** and confirm in your wallet. * Network fees apply to on-chain actions. ### Quick FAQ ❓ **Can I add more STON later?**\ Yes! Start a new stake with the amount and duration you want. ❓ **Can I unstake partially before the end?**\ No. The lock-up period is binding; you must wait until it ends. ❓ **Where do I see my future rewards?**\ In the Stake tab, scroll down to Manage your stakes, and choose My stakes tab to see your current stakes. # ★★ Liquidity Pools Types ### WCPI Pools WCPI (Weighted Constant Product Invariant) pools are a new type of liquidity pool used in automated market makers (AMMs). They allow users to set custom weights for different assets in a pool, giving more control over risk and exposure. **How WCPI Pools Work** WCPI pools use a formula that extends the traditional constant product formula (x \* y = k) by adding weight parameters. The new formula is x^w^x \* y^w^y, where w is the weight of each asset. This approach offers several benefits: 1. Multiple assets: Pools can contain more than two assets. 2. Custom ratios: Users can set custom ratios like 75/25 or 60/40, instead of the traditional 50/50 split. 3. Better risk management: Higher weight for an asset means less price impact when traded. **Advantages of WCPI Pools** 1. Flexible asset management: Users can adjust weights to match their strategy. 2. Reduced [impermanent loss](https://guide.ston.fi/en/impermanent-loss): Custom weighting can help minimize this common DeFi risk. 3. Improved price control: Users can influence how much price movement occurs during trades. 4. Portfolio diversification: Multiple assets with custom weights allow for more diverse strategies. **Examples** 1. Reducing risk: Increase the weight of a volatile asset (like a memecoin) to reduce its price impact. 2. Optimizing returns: Adjust weights to focus on assets you expect to perform well. **Wrapping Up** WCPI pools on STON.fi offer users more control over their liquidity provision. By customizing asset weights, you can better manage risk, control price impact, and create strategies that match your investment goals.

### Stableswap Pools Stableswap pools are a specialized tool for trading stablecoins — cryptocurrencies designed to maintain a stable value. These pools offer more efficient trading with less price slippage, especially for assets with similar values. **How Stableswap Pools Work** Stableswap pools use a "curve algorithm" with an important feature called the amplification factor, or "A" parameter. This factor helps control how much prices can move during trades: * A higher "A" value: Prices stay more stable, closer to a 1:1 exchange rate. * A lower "A" value: Allows for more price movement, similar to a regular trading pool. For example, in a pool with USDT and USDC (both pegged to $1), a high "A" value would keep the exchange rate very close to 1 USDT = 1 USDC, even during larger trades. **Advantages of Stableswap Pools** 1. Lower Slippage: When you trade 1000 USDT for USDC in a Stableswap pool, you're more likely to get very close to 1000 USDC in return, instead of 995 or 990 USDC you might get in a regular pool. 2. Better Liquidity: Stableswap pools maintain good trading conditions even when there's less activity. This means you can trade larger amounts without dramatically affecting the price. 3. Price Stability: Helps keep stablecoin prices close to their target value (usually $1), reducing the risk of depegging. 4. Efficient Trading: Allows for easy exchanges between various stablecoin pairs, like USDT/jUSD, with minimal value loss. **Real-World Example** Imagine you have 10,000 USDT and want to swap it for jUSD: * In a regular pool, you might only get 9,900 jUSD due to price impact and slippage. * In a Stableswap pool, you're more likely to get 9,990 jUSD or even closer to the full 10,000 USDC. This difference becomes even more significant for larger trades or in times of market volatility. **Wrapping Up** Stableswap pools on platforms like STON.fi is an efficient way to trade between stablecoins. They provide a more stable and predictable trading experience, help users maintain the value of their stablecoins while still allowing for necessary exchanges. Stableswap pools can help you swap with minimal value loss and increased confidence in the exchange rate.
### WStableswap Pools WStableswap pools are an advanced tool that combines the benefits of Stableswap and Weighted pools. They offer efficient trading for stablecoins and allow users to adjust the weight of each asset in the pool. **How WStableswap Pools Work** 1. Stableswap Feature: Minimizes slippage when trading between assets with similar values, like stablecoins. 2. Weighted Pool Feature: Allows users to set custom weights for each asset in the pool. For example, in a USDT-USDC pool: * The Stableswap feature keeps the exchange rate close to 1:1. * The Weighted feature lets you adjust the pool to be 60% USDT and 40% jUSD if you prefer. **Advantages of WStableswap Pools** 1. Reduced Slippage: Like Stableswap, WStableswap keeps price impact low for stablecoin trades. Example: Trading 10,000 USDT to jUSD might result in 9,995 jUSD instead of 9,900 in a regular pool. 2. Flexible Asset Management: Users can adjust weights to match their strategy. Example: If you believe USDT is more stable, you could set the pool to 70% USDT and 30% jUSD. 3. Better Liquidity Control: Weighted balances help maintain high liquidity even during market fluctuations. 4. Enhanced Risk Management: Adjusting weights allows users to reduce exposure to specific assets. Example: If you're concerned about USDT's stability, you could reduce its weight in the pool. 5. Improved Capital Efficiency: The combination of low slippage and weight adjustment allows for more efficient use of capital. **WStableswap vs Traditional Stableswap** WStableswap can outperform traditional Stableswap in certain scenarios: 1. Lower Slippage: The weight adjustment can further reduce slippage in some cases. 2. Better Price Control: Weights provide an additional tool to manage price volatility. 3. Higher Liquidity: The ability to adjust weights can help maintain liquidity in changing market conditions. Example: In a USDT/jUSD pool, if USDT becomes slightly less stable, you could adjust the weight in favor of jUSD, potentially maintaining better liquidity than a fixed 50/50 Stableswap pool. **Wrapping Up** WStableswap pools on STON.fi offer a powerful combination of stable pricing and flexible asset management. They're perfect for users who want to provide liquidity for stablecoins while maintaining control over each asset. WStableswap pools help fine-tune your stablecoin strategy. # ★★How to integrate Omniston into your React app Want to add powerful, decentralized swaps to your TON-based app? Omniston makes it surprisingly easy. This guide walks you through the essentials of integrating Omniston using the official React SDK. #### What Is Omniston? Omniston is a decentralized liquidity aggregation protocol built for the TON blockchain. It connects multiple DEXs and market makers into one unified system, ensuring your users always get the best possible price when swapping tokens. By routing trades through the most liquid paths using a Request-for-Quote (RFQ) mechanism, it handles the complexity of price discovery — so you don’t have to.
#### Who Should Integrate Omniston? From wallets to DeFi platforms, Omniston unlocks functionality, efficiency, and new revenue streams: * Wallets & Portfolio Apps → Keep users in your app with in-wallet swaps and generate referral income. * Games & NFT Marketplaces → Let players convert tokens natively in the UI, driving more purchases and smoother UX. * DeFi dApps → Instantly aggregate liquidity and offer optimal prices — no need to manage multiple DEX APIs. * TON Startups → Accelerate development and offer DeFi-grade functionality from day one. Now, let’s see how to bring it into your app. #### 🛠 Quick Start: 6 Steps to Integration **1. Install the SDK** Start by adding the SDK to your project: `pnpm install @ston-fi/omniston-sdk-react` This package includes all the React hooks and utilities you’ll need. 🧠 Pro Tip: The SDK is fully open-source — if you want to dive deeper or customize the logic, the[ GitHub repo](https://github.com/ston-fi/omniston-sdk-react) is a great place to start. **2. Wrap Your App with OmnistonProvider** In your app’s root component (e.g., *\_app.tsx* or *index.tsx*), wrap your application with the provider: `import { OmnistonProvider } from "@ston-fi/omniston-sdk-react";` `` `{/* your app components */}` `` This establishes the WebSocket connection to Omniston’s aggregation backend. 🧠 Pro Tip: No backend needed. The SDK handles blockchain comms and quote management via WebSocket — your integration stays lightweight and frontend-only. **3. Add TON Wallet Support** You can use TON Connect to integrate wallet connectivity: `pnpm install @tonconnect/ui-react` Then create a "Connect Wallet" button using TonConnect’s hooks. This allows users to approve transactions using familiar wallets like Tonkeeper or TON Space. **4. Request a Quote** Use Omniston’s hook `useRfq` to fetch swap quotes. Omniston automatically routes through intermediate tokens if needed and returns the best available price. 🧠 Pro Tip: No pool for your token pair? No problem. Omniston uses smart routing to find paths through intermediary tokens — your users can swap any available tokens on TON. **5. Execute the Swap** Once the user confirms the quote, use the `useOmniston` hook to execute the transaction. Omniston uses HTLC-based smart contracts to securely execute swaps on-chain. 🧠 Pro Tip: Omniston’s RFQ system locks in the rate before the user signs. No slippage surprises — users get exactly the rate they agreed to. **6. Track Swap Status (optional)** Use `useTrackTrade` to monitor the trade’s progress and update your UI accordingly. This is great for giving feedback to the user — for example, you might show a loading spinner until the trade is confirmed on-chain, then display a success message once tokens have swapped. #### 🔍 Want to Learn More? * Demo App:[ omniston.ston.fi](https://omniston.ston.fi) * Quickstart Guide: [Omniston Guide ](https://docs.ston.fi/developer-section/quickstart/omniston) * GitHub Repo:[ STON.fi Omniston SDK\
](https://github.com/ston-fi/omniston-sdk-react) You can fork the live Replit example and experiment instantly in the browser. *** #### 🧠 Pro Tip Omniston supports revenue-sharing via referral fees. Set a `referrer` address in the swap request to earn a fee for each trade executed through your app. *** Omniston abstracts away the complexity of blockchain-based token swaps and delivers a high-level SDK that feels just like any modern React library. Whether you're building a wallet, a game, or a full DeFi app — adding Omniston puts deep liquidity and smart routing in your hands with just a few lines of code.