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

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

1. Create virtual environment and install dependencies:

Javascript

cd js_examples/
npm install

Python

cd python_examples/
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

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

python wallet_integration.py

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

from vaultsfyi import VaultsSdk

client = VaultsSdk(api_key="your_api_key_here")

2. Viewing User Balances

Javascript

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

Python

idle_assets = client.get_idle_assets(user_address)

3. Finding Best Deposit Options

Javascript

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

Python

deposit_options = client.get_deposit_options(
    user_address,
    allowed_assets=["USDC", "USDS"]
)

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

transaction = client.get_actions(
    action="deposit",
    user_address=user_address,
    network=network,
    vault_address=vault_address,
    amount=amount,
    asset_address=asset_address,
    simulate=False
)

5. Viewing User Positions

Javascript

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

Python

positions = client.get_positions(user_address)