@xchainjs/xchain-thorchain-amm
v2.0.18
Published
module that exposes estimating & swappping cryptocurrency assets on thorchain
Downloads
233
Readme
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)