Execute Batch Swap

Slippage is an important concept in trading that can have a significant impact on your trading outcomes. It refers to the difference between the expected price of a trade and the actual price at which the trade is executed. Slippage can occur in various market conditions and for several reasons, and it's crucial for traders to be aware of its potential effects.

Fibrous Finance uses slippage settings to prevent you from losing money; there is no need to increase your slippage when you spot an arbitrage opportunity.

Fibrous Finance is still in alpha version. Please make sure you have adjusted your slippage properly.

Generate transaction data for calling the Fibrous Finance Router contract

import { Router as FibrousRouter } from "fibrous-router-sdk";
import { BigNumber } from "@ethersproject/bignumber";
import { parseUnits } from "ethers";

const fibrous = new FibrousRouter();

const tokens = await fibrous.supportedTokens("starknet");
const tokens = await fibrous.supportedTokens();
const tokenInAddress_1 = tokens["eth"].address;
const tokenInAddress_2 = tokens["strk"].address;
const tokenInAddress_3 = tokens["usdc"].address;

const tokenOutAddress = tokens["usdt"].address;

const tokenInDecimals_1 = tokens["eth"].decimals;
const tokenInDecimals_2 = tokens["strk"].decimals;
const tokenInDecimals_3 = tokens["usdc"].decimals;

const inputAmounts = [
    BigNumber.from(1n * 10n ** BigInt(tokenInDecimals_1 - 3)), // 0.001 ETH
    BigNumber.from(10n * 10n ** BigInt(tokenInDecimals_2)), // 0.001 STRK
    BigNumber.from(5n * 10n ** BigInt(tokenInDecimals_3)), // 5 USDC
]; // 0.001 ETH

Usage on frontend

// Usage on your website

const starknet = await connect({ showList: false })

await starknet.enable()

if (starknet.isConnected) {

// Call the buildTransaction method in order to build the transaction
// slippage: The maximum acceptable slippage of the buyAmount amount.
const slippage = 1; // 1%
const destination = starknet.selectedAddress; // The address to receive the tokens after the swap is completed (required)

const tokenInAddresses = [tokenInAddress_1, tokenInAddress_2, tokenInAddress_3];
const tokenOutAddresses = [tokenOutAddress];
const swapCalls = await fibrous.buildBatchTransaction(
    inputAmounts,
    tokenInAddresses,
    tokenOutAddresses,
    slippage,
    destination,
    "starknet",
);

   const approveCalls: Call[] = [];
    for(let i = 0; i < inputAmounts.length; i++) {
        const approveCall: Call = await fibrous.buildApproveStarknet(
            inputAmounts[i],
            tokenInAddresses[i],
        );
        approveCalls.push(approveCall);
    }
  await starknet.account.execute([...approveCall,...swapCall]);
}

import { Call } from "starknet";

const starknet = await connect({ showList: false })

await starknet.enable()

if (starknet.isConnected) {

  // Call the buildTransaction method in order to build the transaction
  // slippage: The maximum acceptable slippage of the buyAmount amount. 
  const slippage = 1; // %1 slippage
  const receiverAddress = starknet.selectedAddress;

  const approveCall:Call = await fibrous.buildApproveStarknet(
      inputAmount,
      tokenInAddress,
  );

  const swapCall:Call = await fibrous.buildTransaction(
    inputAmount,
    tokenInAddress,
    tokenOutAddress,
    slippage, 
    receiverAddress,
    "starknet",
  );

  await starknet.account.execute([approveCall,swapCall]);
}

Usage on backend on Starknet

import { Account, Provider } from "starknet";
import { Call } from "starknet";

const provider = new Provider();
const privateKey0 = "YOUR_PRIVATE_KEY";
const accountAddress0 = "YOUR_WALLET_ADDRESS";
// https://www.starknetjs.com/docs/guides/connect_account
// If this account is based on a Cairo v2 contract (for example OpenZeppelin account 0.7.0 or later), do not forget to add the parameter "1" after the privateKey parameter
const RPC_URL = "RPC_URL";
const account0 = account(privateKey, public_key, "1", RPC_URL);

// Call the buildTransaction method in order to build the transaction
// slippage: The maximum acceptable slippage of the buyAmount amount.
const slippage = 1; // %1
const swapCalls = await fibrous.buildBatchTransaction(
    inputAmounts,
    tokenInAddresses,
    tokenOutAddresses,
    slippage,
    destination,
    "starknet",
);

const approveCalls: Call[] = [];
for(let i = 0; i < inputAmounts.length; i++) {
    const approveCall: Call = await fibrous.buildApproveStarknet(
        inputAmounts[i],
        tokenInAddresses[i],
    );
    approveCalls.push(approveCall);
}

const resp = await account0.execute([...approveCalls, ...swapCalls]);
console.log(`https://voyager.online/tx/${resp.transaction_hash}`);

swapCall:Call

{
    contractAddress:ROUTER_ADDRESS,
    entrypoint: "swap",
    calldata: calldata,
}