@dontuseit/swap-sdk v37.5.0
Mayan Swap SDK
A minimal package for sending cross-chain swap transactions
Installation:
npm install --save @mayanfinance/swap-sdk
Usage:
Import the necessary functions and models:
import { fetchQuote, swapFromEvm, swapFromSolana, Quote } from '@mayanfinance/swap-sdk'
Then you will need to get a quote:
Getting Quote:
const quote = await fetchQuote({
amount: 250,
fromToken: fromToken.contract,
toToken: toToken.contract,
fromChain: "bsc",
toChain: "solana",
slippage: 3,
gasDrop: 0.04, // optional
referrer: "YOUR SOLANA WALLET ADDRESS", // optional
});
You can get the list of supported tokens using Tokens API
Gas on destination:
To enable Gas on destination set the gasDrop param to the amount of native token (e.g. ETH, BNB..) you want to receive on the destination chain.
Maximum supported amount of gasDrop for each destination chain:
ethereum: 0.05 ETH
bsc: 0.02 BNB
polygon: 0.2 MATIC
avalanche: 0.2 AVAX
solana: 0.2 SOL
arbitrum: 0.01 ETH
Referrer fee:
If you want to receive referrer fee, set the
referrer
param to your wallet address.
Slippage:
Slippage is in percentage, so 3 means "up to three percent slippage".
Swap from Solana:
swapTrx = await swapFromSolana(quote, originWalletAddress, destinationWalletAddress, deadlineInSeconds, referrerAddresses, signSolanaTransaction, solanaConnection)
Swap from EVM:
swapTrx = await swapFromEvm(quote, destinationWalletAddress, deadlineInSeconds, referrerAddresses, provider, signer)
referrerAddress
must be a Solana wallet address. If you don't want to get referrer fee from users, set "referrerAddress" tonull
or"11111111111111111111111111111111"
Tracking:
To track the progress of swaps, you can use Mayan Explorer API
📱 React Native Support (Solana Mobile SDK):
You can also use this SDK in your react native app:
import { transact, Web3MobileWallet } from '@solana-mobile/mobile-wallet-adapter-protocol-web3js';
For swaps from solana after importing the above functions from Solana Mobile SDK you have to pass a callback function that calls transact
function as the signSolanaTransaction
parameter of swapFromSolana
function:
const signSolanaTransaction = useCallback(
async (tx: Transaction) => {
return await transact(async (wallet: Web3MobileWallet) => {
authorizeSession(wallet);
const signedTransactions = await wallet.signTransactions({
transactions: [tx],
});
return signedTransactions[0];
});
},
[authorizeSession],
);
For swaps from EVM you can use useWalletConnectModal
hook from WalletConnet to get the provider and pass it to swapFromEvm
function as the signer
:
import {useWalletConnectModal} from '@walletconnect/modal-react-native';
...
const { provider: evmWalletProvider} =
useWalletConnectModal();
...
const web3Provider = new ethers.providers.Web3Provider(
evmWalletProvider,
);
const signer = web3Provider.getSigner(0);
To learn more about how to use Mayan SDK in a react-native project, you can check this scaffold.
2 days ago
2 days ago
2 days ago
2 days ago
2 days ago
3 days ago
5 days ago
5 days ago
7 days ago
6 days ago
7 days ago
9 days ago
11 days ago
11 days ago
11 days ago
11 days ago
13 days ago
16 days ago
16 days ago
16 days ago
17 days ago
18 days ago
19 days ago
19 days ago
19 days ago
19 days ago
19 days ago
19 days ago
19 days ago
19 days ago
24 days ago
25 days ago
27 days ago
28 days ago
27 days ago
28 days ago
28 days ago
27 days ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
1 month ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
4 months ago
4 months ago
4 months ago