Skip to content

Repository files navigation

@cryptoscan/swap-sdk

The fastest way to swap any tokens on any networks & dexes

[GitHub] [Our website] [Docs] [Discord]

Supported networks

  • Solana

Networks are planned to support: https://api.cryptoscan.pro/v1/networks

Get started

To install package:

npm install @cryptoscan/swap-sdk

Easy-To-Use Example

import { getWallet } from '@cryptoscan/solana-wallet-sdk';
import { swap } from '@cryptoscan/swap-sdk';

const secretKeyStr = 'YOUR_SECRET_KEY';
const wallet = getWallet(secretKeyStr);
const from = 'sol';
const to = 'HJAoYbnsf16Z8ftk3SsuShKLQQgzmxAPu41RTpjjpump';
const amount = 0.05;

swap({
  wallet,
  from,
  to,
  amount,
})
.then((tx) => console.log(tx))

Primary Usage

import { Keypair, Connection } from "@solana/web3.js";
import sendTransaction from '@cryptoscan/solana-send-transaction';
import { createTransaction } from '@cryptoscan/swap-sdk';

const rpcUrl = 'https://api.mainnet-beta.solana.com';
const wsRpcUrl = 'wss://api.mainnet-beta.solana.com';
const secretKeyStr = 'YOUR_SECRET_KEY';
const wallet = Keypair.fromSecretKey(bs58.decode(secretKeyStr));
const from = 'sol';
const to = 'HJAoYbnsf16Z8ftk3SsuShKLQQgzmxAPu41RTpjjpump';
const amount = 0.05;

async function swap() {
  const connection = new Connection(rpcUrl, {
    wsEndpoint: wsRpcUrl,
  })
  const transaction = await createTransaction({
    walletAddress: wallet.publicKey.toString(),
    from,
    to,
    amount,
  });

  if (transaction instanceof Error) {
    return transaction;
  }

  transaction.sign([wallet]);

  return sendTransaction(transaction, { connection })
}

swap().then((tx) => console.log(tx));

Swap Docs

  • wallet - Keypair of the wallet
  • from - Coin address to pay (Defaults: sol)
  • service - Platform to buy (Optional: auto-detecting)
  • to - Coin address to buy
  • amount - Amount of Coin from to buy
  • fee - Transaction fee (Optional)
  • priorityFee - Priority fee (Default: 0.0001)
  • slippage - Slippage (Default: 1)

FAQ

Is it secure to use sdk with private key?

Yes. You don't share private key through api request. You sign transaction with private key locally only.

Is it free?

We charge a 0.39% fee on each successful transaction instruction. If you want to decrease fee - please contact us in discord or telegram We can increase fee down to 0.1% if you will contribute us.

How to contribute?

You can create pull requests or make a project based on our packages. You have chance to get some supply for a work and get fee reduced for the api.

Contribute

To install dependencies:

npm install

To build:

npm build

About

Toolkit to easy swap in the top rated blockchains without any knowledge

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages