LogoLogo
ston-fi/docs
ston-fi/docs
  • User section
    • About
    • STON.fi Protocol
    • Fees
    • Glossary
    • Whitepaper
  • Developer section
    • Architecture
    • SDK
      • DEX v1 guide
        • reference
        • swap
        • provide liquidity
        • refund liquidity
        • burn liquidity tokens
      • DEX v2 guide
        • swap
        • provide liquidity
        • refund liquidity
        • burn liquidity tokens
        • withdraw fee from vault
      • Farm guide
        • stake in farm
        • claim farm rewards
        • unstake from farm
        • destroy farm NFT
      • Transaction sending guide
        • via ton
        • via tonweb
        • via tonconnect
      • v0.5 > v1.0.0 migration guide
      • v0.5 (deprecated)
        • DEX guide
          • swap
          • provide liquidity
          • refund liquidity
          • burn liquidity tokens
        • Farm guide
          • stake in farm
          • claim farm rewards
          • unstake from farm
          • destroy farm NFT
        • Transaction sending guide
          • via ton
          • via tonweb
          • via tonconnect
      • v0.4 > v0.5 migration guide
      • v0.4 (deprecated)
        • perform a swap operation
        • provide liquidity
        • refund liquidity
        • burn liquidity tokens
        • using get methods
        • create a custom router revision
    • API reference v1
      • Router
      • Pool
      • LpAccount
      • LpWallet
    • API reference v2
      • Router
      • Pool
      • LpAccount
      • LpWallet
      • Vault
      • Swap examples
      • LpProvide examples
      • Vault examples
      • Op Codes
    • DEX API
    • OMNISTON
      • Resolvers (How to become a resolver)
      • Swap overview
      • Swap extra
      • Swap grpc
      • React
      • Nodejs
      • Referral fees
    • Quickstart Guides
      • Swap Guide
      • Omniston Guide
  • Help
    • Contact Us
Powered by GitBook
On this page
  • API reference
  • Overview
  • Example schemes
  • Op code list
  • New DEX v2 features:
  • Swap
  • Liquidity
  • Referral
  • pTON v2
  • Other
  • Removed
Export as PDF
  1. Developer section

API reference v2

This section describes different op codes of AMM smart contracts v2

PreviousLpWalletNextRouter

Last updated 15 days ago

API reference

Overview

The section contains separate documents for each smart contract used in AMM:

Definitions of terminology used can be found in

Example schemes

Example schemes can be found here:

Op code list

A table with DEX v2 op codes:

New DEX v2 features:

Swap

  • custom payload & nested operations after swaps

  • chain multiple swaps on the same Router

  • chain multiple swaps on different v2 Routers

  • custom refund address and payload on swap failure

  • deadline for tx completion

Liquidity

  • custom payload after liquidly provision

  • improved initial liquidity locking management, no coins are lost anymore

  • now always mints a maximum possible amount of lp tokens to user even if provision ratio is different from current one in Pool

  • single side liquidity provision

  • deadline for tx completion

Referral

  • referral fees are stored in Vault contract

  • custom referral fee value in each swap (maximum 1%)

pTON v2

  • now uses a custom op code for ton transfers

  • ton transfer to user is non-bouncable

  • improved gas management

  • can chain ton transfers between 2 pTON wallets (to chain pTON swaps on v2 Routers)

Other

  • LpAccount and Vault are deleted if they have 0 tokens on balance to avoid paying storage cost

  • better error management: no coins are lost if Pool doesn't exist / payload is not correct

  • complete refactoring of the codebase and usage of libs in masterchain to make all operations cheaper

  • fixed various excesses issues

  • fixed some Pools having broken get_jetton_data

Removed

Pool

  • off-chain get_expected_outputs

  • off-chain get_expected_tokens

  • off-chain get_expected_liquidity

  • on-chain getter_expected_outputs

  • on-chain getter_expected_tokens

  • on-chain getter_expected_liquidity

  • user-called collect_fees

For more details and usage examples, see

Pool
Router
LpAccount
LpWallet
Vault
Glossary
Swap examples
Lp provide examples
Vault examples
Op Codes
Omniston referral fees guide