Wallet Integration

Example code + mini tutorial showing Portfolio and Transactional integrations with Vaults.fyi

The example will:

• Check user balances (idle assets) and display them in a formatted table

• Display the best deposit options filtered for USDC/USDS only

• Generate a transactional payload for depositing into a vault that includes optional deposit fee for wallets

• Show all user positions across different vaults

Run the tutorial code

1. Clone or download tutorial code

Javascript

git clone https://github.com/WallfacerLabs/js-examples.git

Python

1. Create virtual environment and install dependencies:

Javascript

cd js_examples/
npm install

Python

1. Set your API key as an environment variable:

export VAULTS_FYI_API_KEY="your_api_key_here"

Run

Javascript

npm run wallet_integration

Python

Step by step

1. SDK Initialization

Javascript

import pkg from '@vaultsfyi/sdk';
const { VaultsSdk } = pkg;

// Initialize the SDK
const vaultsFyi = new VaultsSdk({
  apiKey: process.env.VAULTS_FYI_API_KEY,
 
});

Python

2. Viewing User Balances

Javascript

async function getUserBalances() {
  const idleAssets = await vaultsFyi.getIdleAssets({
    path: { userAddress: '0xdB79e7E9e1412457528e40db9fCDBe69f558777d' }
  });
  
  return idleAssets;
}

Python

3. Finding Best Deposit Options

Javascript

async function getBestDepositOptions() {
  const depositOptions = await vaultsFyi.getDepositOptions({
    path: { userAddress: '0xdB79e7E9e1412457528e40db9fCDBe69f558777d' },
    query: { allowedAssets: ['USDC', 'USDS'] }
  });
  
  return depositOptions;
}

Python

4. Generating Deposit Transactions

Javascript

async function generateDepositTransaction(vaultAddress, amount, userAddress, network, assetAddress) {
  const transaction = await vaultsFyi.getActions({
    path: { 
      action: 'deposit',
      userAddress: userAddress,
      network: network, 
      vaultAddress: vaultAddress
    },
    query: { 
      amount: amount,
      assetAddress: assetAddress,
      simulate: false
    }
  });
  
  return transaction;
}

Python

5. Viewing User Positions

Javascript

async function getUserPositions() {
  const positions = await vaultsFyi.getPositions({
    path: { userAddress: '0xdB79e7E9e1412457528e40db9fCDBe69f558777d' }
  });
  
  return positions;
}
  

Python