soroswap-router-sdk
TypeScript icon, indicating that this package has built-in type declarations

1.4.6 • Public • Published

Soroswap Router SDK

npm version

This repository contains routing logic for the Soroswap.Finance protocol.

It searches for the most efficient way to swap token A for token B, considering the reserves available in the protocol's liquidity pools.

Useful links:

Install

npm i soroswap-router-sdk

or

yarn add soroswap-router-sdk

How to use

import {
  Router,
  Token,
  CurrencyAmount,
  TradeType,
  Networks,
} from "soroswap-router-sdk";

const XLM_ADDRESS = "CDMLFMKMMD7MWZP3FKUBZPVHTUEDLSX4BYGYKH4GCESXYHS3IHQ4EIG4";
const USDC_ADDRESS = "CAMZFR4BHDUMT6J7INBBBGJG22WMS26RXEYORKC2ERZL2YGDIEEKTOJB";

const XLM_TOKEN = new Token(
  Networks.TESTNET,
  XLM_ADDRESS,
  7,
  "XLM",
  "Stellar Lumens"
);

const USDC_TOKEN = new Token(
  Networks.TESTNET,
  USDC_ADDRESS,
  7,
  "USDC",
  "USD Coin"
);

const amount = 10000000;

const router = new Router({
  pairsCacheInSeconds: 20, // pairs cache duration
  protocols: [Protocols.SOROSWAP], // protocols to be used
  network: Networks.TESTNET, // network to be used
});

const currencyAmount = CurrencyAmount.fromRawAmount(USDC_TOKEN, amount);
const quoteCurrency = XLM_TOKEN;

const route = await router.route(
  currencyAmount,
  quoteCurrency,
  TradeType.EXACT_INPUT
);

console.log(route.trade.path);

//Output: ['0x...', '0x...', '0x...']

Development

Test

bash docker/run.sh
yarn
yarn test

Document

1.- Generate Documentation

bash docker/run.sh
yarn
yarn docs

Publish

bash docker/run.sh
git config --global --add safe.directory /workspace
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
npm login

yarn
yarn build
yarn publish

For beta versions you can use yarn publish --tag beta

Readme

Keywords

none

Package Sidebar

Install

npm i soroswap-router-sdk

Weekly Downloads

167

Version

1.4.6

License

SEE LICENSE IN LICENSE

Unpacked Size

881 kB

Total Files

47

Last publish

Collaborators

  • esteblock
  • coderipper
  • devmonsterblock