👋 About Us • 🛡️ Client-Side Security Essentials • 🖥️ Installation • 🧑💻 Usage • 📃 Examples• 🌐 Socials
🔶 SDK for expand.network built on top of Node.js 🔶
| Blockchain Types | Blockchains |
|---|---|
| EVM compatible | Arbitrum, Avalanche, Base, Binance Smart Chain, Cronos, Ethereum, Fantom, Optimism, Polygon, zkSync |
| Non-EVM | Algorand, Aptos, NEAR, Solana, Starknet, Stellar, Sui, TON, Tron |
In addition, we currently support the following DeFi protocols:
| Protocol types | Protocol |
|---|---|
| DEX & Aggregators | 0x, 1inch, Balancer, Curve, Kyberswap, Pancakeswap, Sushiswap, Trader Joe, Uniswap (V2, V3, X) |
| Bridge | Stargate, Squid Router |
| Lend and Borrow | Aave V2, Aave V3, Compound V2, Compound V3 |
| Synthetic | Synthetix |
| Yield aggregator | Yearn Finance, Harvest Finance |
| Oracle | Chainlink, Pyth Network, Winklink |
| Derivative | dYdX v4 |
Coming soon:
| Protocol Types | Protocol |
|---|---|
| Liquid Staking | Lido |
All transactions are securely signed on your end, so your private key remains with you and never comes to us over API. We do not hold your crypto at any point: 🔐 Your keys, Your crypto. Our APIs are a one-stop-shop for you to make the enquiries and conduct the transactions as you want.
CT makes it easier to detect and prevent digital certificate fraud, thereby improving the security of internet connections.
In addition to implementing certificate transparency measures on our end, we highly recommend users to also consider implementing these measures for added security benefits.
A user's private key is stored securely in a digital wallet, and should never be shared with anyone as it provides full access and control over their digital assets.
It is highly recommended that users take necessary precautions to ensure the safety and confidentiality of their private keys, as we do not possess any access or control over them.
- It is important for the user to safeguard both their data and workstation from potential risks such as spoofing, tampering, and other related threats.
- It is important for the end user to connect to a secure network and ensure that they use only TLS 1.2 or a newer version for enhanced security to safeguard them from any kind of threats and attacks.
To install, clone the repository from git directly.
git clone https://github.com/expand-network/sdk-nodejs.git
Or, use the following npm package.
npm i expand-network
You can get your API key by visiting our website or by clicking here
Sample code: Send one Wei from one public address to another public address. You need to use your private key to sign the transaction. The return value is the transaction hash (res).
const { Wallet, prepareTransaction } = require('expand-network');
async function main(){
const wallet = new Wallet({ privateKey: 'YOUR_PRIVATE_KEY', xApiKey: 'YOUR_API_KEY' });
// Signing transaction
const signedTx = await wallet.signTransaction({
from: 'PUBLIC_ADDRESS',
to: 'PUBLIC_ADDRESS',
value: '1',
chainId: '1',
gas: '50000',
});
//Sending transaction
const tx = await wallet.sendTransaction(signedTx);
console.log("Transaction Pending....", tx.data);
}
main()Sample code: Approve 5 DAI (token ending in d0F),In this example, the "from" is the user address (ending in 006) and "to" is protocol address (ending in 056), so 5 DAI is approved from user address on the protocol address. User need to use private key to sign the transaction.
const { Wallet, prepareTransaction } = require('expand-network');
async function approve() {
const wallet = new Wallet({ privateKey: 'YOUR_PRIVATE_KEY', xApiKey: 'YOUR_API_KEY' });
// Preparing transaction
const preparedTx = await prepareTransaction('https://api.expand.network/fungibletoken/approve', {
from: 'PUBLIC_ADDRESS',
to: 'PUBLIC_ADDRESS', // The spender's or contract's or router's address that needs to be approved
tokenAddress:"0x6B175474E89094C44Da98b954EedeAC495271d0F",
amount: "5000000000000000000",
gas: '100000',
chainId:"1"
xApiKey: "YOUR_API_KEY"
});
// Signing transaction
const signedTx = await wallet.signTransaction(preparedTx);
//Sending transaction
const tx = await wallet.sendTransaction(signedTx);
console.log("Transaction Pending....", tx.data);
}
approve();Sample code: Swap 5 DAI (token ending in d0F) with WETH (token ending in Cc2). In this example, the "to" and "from" are the same (ending in 006), so the swapped tokens will come back into the same address. Again, you need to use your private key to sign the transaction.
const { Wallet, prepareTransaction } = require('expand-network');
async function swap() {
const wallet = new Wallet({ privateKey: 'YOUR_PRIVATE_KEY', xApiKey: 'YOUR_API_KEY' });
// Preparing transaction
const preparedTx = await prepareTransaction('https://api.expand.network/dex/swap', {
amountIn: '5000000000000000000',
amountOutMin: '0',
path: ['0x6B175474E89094C44Da98b954EedeAC495271d0F','0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2'], // DAI and WETH contract addresses
to: 'PUBLIC_ADDRESS',
deadline: '1693143453', // Epoch Unix timestamp
from: 'PUBLIC_ADDRESS',
gas: '229880',
xApiKey : 'YOUR_API_KEY',
chainId:"1"
});
// Signing transaction
const signedTx = await wallet.signTransaction(preparedTx);
//Sending transaction
const tx = await wallet.sendTransaction(signedTx);
console.log("Transaction Pending....", tx.data);
}
swap();Versioned Transactions are the new transaction format that allows for additional functionality in the Solana runtime, including Address Lookup Tables.
The Solana runtime supports two transaction versions:
- legacy - older transaction format with no additional benefit
- 0 - added support for Address Lookup Tables
*(0 is known as versioned transaction)
Now using expand users can leverage Versioned Transactions to pack richer instruction sets into a single transaction and use lookup tables.
Sample code: get balances from different chains: Ethereum, BSC and Solana.
//Setting API-KEY for axios header
axios.defaults.headers['X-API-KEY'] = "YOUR_API_KEY";
// Fetching balance from Ethereum
config.params = {
address: publicAddressEvm
}
response = await axios.get(baseUrl + '/chain/getbalance/', config);
balance = response.data.data.balance / 10**18; // Divide by 10 to the power decimals of the asset (18 for ETH)
console.log (`${publicAddressEvm} balance on ethereum chain is ${balance}`);
// Fetching balance from Binance Smart Chain
config.params = {
chainId: '56',
address: publicAddressBsc
}
response = await axios.get(baseUrl + '/chain/getbalance/', config);
balance = response.data.data.balance / 10**18;
console.log (`${publicAddressBsc} balance on binance smart chain is ${balance}`);
// Fetching balance from Solana
config.params = {
chainSymbol: 'SOL',
address: publicAddressSolana
}
response = await axios.get(baseUrl + '/chain/getbalance/', config);
balance = response.data.data.balance / 10**9;
console.log (`${publicAddressSolana} balance on solana chain is ${balance}`);Sample Code: For the swap pair DAI <> WETH, find the best price on three different DEX protocols: Uniswap v2, v3, and Sushiswap. Whichever DEX has the best price, swap the DAI with WETH on that particular DEX.
const { Wallet, prepareTransaction } = require('expand-network');
const getPrice = async(dexId) => {
config.params = {
dexId: dexId,
path: '0x6B175474E89094C44Da98b954EedeAC495271d0F' + ',' + '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
amountIn: amount
}
const response = await axios.get(baseUrl + '/dex/getprice/', config);
prices[dexId] = response.data.amountsOut[1];
}
const swap = async(dexId) => {
const wallet = new Wallet({ privateKey: 'YOUR_PRIVATE_KEY', xApiKey: 'YOUR_API_KEY' });
const preparedTx = await prepareTransaction(baseUrl + '/dex/swap', {
dexId,
amountIn: amount,
amountOutMin: '0',
path: [ '0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' ],
to: 'PUBLIC_ADDRESS',
deadline: Date.now() + 60*60*20,
from: 'PUBLIC_ADDRESS',
gas: '229880',
xApiKey : 'YOUR_API_KEY'
});
// Signing transaction
const signedTx = await wallet.signTransaction(preparedTx);
//Sending transaction
const tx = await wallet.sendTransaction(signedTx);
console.log("Transaction Pending....", tx.data);
}
const bestBuy = async() => {
// Fetching price from Uniswap V2
await getPrice('1000');
// Fetching price from Sushiswap
await getPrice('1100');
// Fetching price from Uniswap V3
await getPrice('1300');
var max = 0;
var maxDexId = 0;
for ( var dexId in prices ){
if ( Number(prices[dexId]) > max ) {
max = prices[dexId];
maxDexId = dexId;
}
}
console.log(`${maxDexId} gives the best swap price of ${max}`);
// Time to swap the tokens
swap(maxDexId);
}
bestBuy();