THORChain AMM is a module that allows users and developers to interact with the THORChain protocol without having to worry about the underlining particularities of the protocol.

Installation

yarn add @xchainjs/xchain-thorchain-amm

or

npm install @xchainjs/xchain-thorchain-amm

Initialization

Using Thorchain AMM, you can initialize the main class of the module in consultation mode if you do not provide any parameters, this means you could retrieve information from the protocol, but you will not be able to make actions the protocol needs you to sign.

  import { ThorchainAMM } from '@xchainjs/xchain-thorchain-amm'

  const thorchainAmm = new ThorchainAMM()

Otherwise, if you want to be able make actions the protocol needs you to sign, you will need to initialize the main class of the protocol as follows

  import { ThorchainAMM } from '@xchainjs/xchain-thorchain-amm'
  import { ThorchainQuery } from '@xchainjs/xchain-thorchain-query'
  import { Wallet } from '@xchainjs/xchain-wallet'

  const thorChainQuery = new ThorchainQuery()
  const wallet = new Wallet({
    // Your XChainJS clients
  })
  const thorchainAmm = new ThorchainAMM(thorChainQuery, wallet)

Features

Using THORChain AMM package, you could easily implement the following features

Swaps

• Estimate swaps
• Do swaps, streaming swaps and trade asset swaps
• Approve THORChain router to be able to do ERC-20 swaps

Liquidity pools

• Add liquidity to pools, symmetrical and asymmetrical
• Withdraw liquidity from pools

Rune pool

• Deposit Rune to Rune pool
• Withdraw Rune from Rune pool

Savers

• Add a position in a THORChain savers vault
• Withdraw a position from a THORChain savers vault

Trade assets

• Deposit L1 assets into the THORChain network to mint trade assets to receive accredited shares
• Swap trade assets with RUNE or another trade asset
• Withdraw trade asset balance

THORNames

• Get THORNames details
• Get THORNames by owner
• Register and update THORNames

Examples

You can find examples using the THORChain AMM package in the thorchain-amm examples folder.

Documentation

More information about how to use the Thorchain AMM package can be found on documentation

Setting Headers for Nine Realms endpoints

If you plan on using the publically accessible endpoints provided by Nine Realms(listed below), ensure that you add a valid 'x-client-id' to all requests

• https://midgard.ninerealms.com
• https://haskoin.ninerealms.com (BTC/BCH/LTC)
• https://thornode.ninerealms.com

Example

import cosmosclient from '@cosmos-client/core'
import axios from 'axios'
import { register9Rheader } from '@xchainjs/xchain-util'

register9Rheader(axios)
register9Rheader(cosmosclient.config.globalAxios)