SDK V1

Overview

The SDK provides a set of tools to interact with the Mira Decentralized Exchange.

It allows developers to perform actions such as adding/removing liquidity, swapping tokens, querying liquidity pools, and more.

The SDK is built on top of the fuels library and supports both transaction-based and readonly operations.

GitHub

NPM

Installation

npm i fuels
npm i mira-dex-ts

Setup

To start using the SDK, you need to instantiate the MiraAmm or ReadonlyMiraAmm classes by providing the appropriate parameters like Account for signing transactions or Provider for read-only operations.

import {MiraAmm, ReadonlyMiraAmm} from "mira-dex-ts";
import {Account, Provider} from "fuels";
 
// For transaction-based operations
const provider = await Provider.create(RPC);
const wallet = new WalletUnlocked(SECRET_KEY, provider);
const miraAmm = new MiraAmm(wallet);
 
// For readonly operations
const readonlyMiraAmm = new ReadonlyMiraAmm(provider);

Data Types

PoolId

Identifier of a pool. Consists of two assets and a boolean flag indicating whether the pool is stable.

export type PoolId = [AssetId, AssetId, boolean];

MiraAmm Class

The MiraAmm class is used for building transaction requests to interact with the AMM.

Methods

id - Returns the AMM contract ID.

const ammId = miraAmm.id();

addLiquidity - Adds liquidity to an existing pool.

const txRequest = await miraAmm.addLiquidity(
  poolId,
  amount0Desired,
  amount1Desired,
  amount0Min,
  amount1Min,
  deadline,
  txParams,
);

poolId: ID of the pool.

amount0Desired: Desired amount of token 0.

amount1Desired: Desired amount of token 1.

amount0Min: Minimum amount of token 0.

amount1Min: Minimum amount of token 1.

deadline: Deadline block for the transaction.

The function will add two assets to the pool in the same proportion as the existing reserves in the pool. Desired and min amounts specify the amount of each asset to add. The actual amounts would be as close as possible to the desired amounts, not exceeding them and more than the min amounts.

createPoolAndAddLiquidity - Creates a new pool and adds liquidity in a single transaction.

const txRequest = await miraAmm.createPoolAndAddLiquidity(
  token0Contract,
  token0SubId,
  token1Contract,
  token1SubId,
  isStable,
  amount0Desired,
  amount1Desired,
  deadline,
  txParams,
);

token0Contract, token1Contract: Contract addresses for the tokens.

token0SubId, token1SubId: Sub ids of the tokens within the context of provided contracts.

isStable: Whether the pool is stable or volatile.

amount0Desired, amount1Desired: Desired amounts of token 0 and token 1.

deadline: Deadline block for the transaction.

The same as addLiquidity but creates a new pool. The pool is created with the provided tokens and the desired amounts. The function will throw an error if the pool already exists.

removeLiquidity - Removes liquidity from a pool.

const txRequest = await miraAmm.removeLiquidity(
  poolId,
  liquidity,
  amount0Min,
  amount1Min,
  deadline,
  txParams,
);

poolId: ID of the pool.

liquidity: Number of LP tokens to exchange for liquidity.

amount0Min, amount1Min: Minimum numbers of tokens to receive from the pool.

deadline: Deadline block for the transaction.

Exchanges LP tokens for the underlying assets. The LP tokens are burned, and the assets are transferred to the user.

swapExactInput - Performs a swap where the exact input amount is known.

const txRequest = await miraAmm.swapExactInput(
  amountIn,
  assetIn,
  amountOutMin,
  pools,
  deadline,
  txParams,
);

amountIn: Number of input tokens.

assetIn: Asset ID of the input token.

amountOutMin: Minimum number of output tokens.

pools: List of pools to route the swap.

deadline: Deadline block for the transaction.

Performs the swap specifying the exact number of input tokens. Supports multi-hop swaps if several pools are provided.

swapExactOutput - Performs a swap where the exact output amount is known.

const txRequest = await miraAmm.swapExactOutput(
  amountOut,
  assetOut,
  amountInMax,
  pools,
  deadline,
  txParams,
);

amountOut: Desired output amount.

assetOut: Asset ID of the output token.

amountInMax: Maximum number of input tokens.

pools: List of pools to route the swap.

deadline: Deadline block for the transaction.

Performs the swap specifying the exact number of output tokens. Supports multi-hop swaps if several pools are provided.

ReadonlyMiraAmm Class

The ReadonlyMiraAmm class is used for reading information from the AMM.

Methods

id - Returns the AMM contract ID.

const ammId = readonlyMiraAmm.id();

ammMetadata - Fetches metadata for the AMM contract, including fees and owner details.

const metadata = await readonlyMiraAmm.ammMetadata();

poolMetadata - Fetches metadata for a specific pool.

const poolData = await readonlyMiraAmm.poolMetadata(poolId);

poolId: ID of the pool.

lpAssetInfo - Fetches LP token asset info such as name, symbol, and total supply.

const lpInfo = await readonlyMiraAmm.lpAssetInfo(assetId);

totalAssets - Returns the total number of LP tokens created within the AMM. This number equals to the number of creates pools.

const totalAssets = await readonlyMiraAmm.totalAssets();

getLiquidityPosition - Fetches the position corresponding to the number of LP tokens for a specific pool.

const liquidityPosition = await readonlyMiraAmm.getLiquidityPosition(
  poolId,
  lpTokensAmount,
);

poolId: ID of the pool.

lpTokensAmount: Number of LP tokens.

getOtherTokenToAddLiquidity - Calculates the required amount of the second asset in a token pair based on the provided amount of the first asset. Returns the corresponding amount needed for the second asset to add to the pool.

const assetToAdd = await readonlyMiraAmm.getOtherTokenToAddLiquidity(
  poolId,
  amount,
  isFirstToken,
);

poolId: ID of the pool.

isFirstToken: whether the amount corresponds to the first asset in the pool or to the second.

amount: Number of tokens of one of the assets of the pool.

previewSwapExactInput - Calculates the output result of a swap operation with the exact input amount routed through the provided pools.

const expectedOutputAmount = await readonlyMiraAmm.previewSwapExactInput(
  assetIdIn,
  assetAmountIn,
  pools,
);

assetIdIn: Asset ID of the input token.

assetAmountIn: Number of input tokens.

pools: List of pools to route the swap.

previewSwapExactOutput - Calculates the amount of the input token to perform a swap operation routed through the provided pools to receive the specified output number of tokens.

const requiredInputAmount = await readonlyMiraAmm.previewSwapExactOutput(
  assetIdOut,
  assetAmountOut,
  pools,
);

assetIdOut: Asset ID of the output token.

assetAmountOut: Number of output tokens.

pools: List of pools to route the swap.