Introduction

const { venues } = await client.venues.list();

// Example venue
{
  id: 1,
  name: 'Kamino',
  protocol: 'kamino',
  blockchain: 'solana',
  status: 'active',
  strategies: [...]
}

// Strategies are nested within venues
const strategy = venues[0].strategies[0];

// Example strategy
{
  strategyId: 1,
  name: 'USDC Vault',
  token: 'USDC',
  tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  apy: 0.085,  // 8.5%
  status: 'active'
}

const { allocations } = await client.allocations.list({
  walletAddress: userWallet
});

// Example allocation
{
  strategyId: 1,
  strategyName: 'USDC Vault',
  venueName: 'Kamino',
  walletAddress: 'So11...abc',
  principal: '1000000000',      // 1000 USDC deposited
  currentValue: '1008500000',   // 1008.50 USDC current value
  yieldEarned: '8500000',       // 8.50 USDC earned
  apy: 0.085
}

const operation = await client.operations.supply({
  walletAddress: userWallet,
  strategyId: 1,
  amount: '1000000000',
  tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
});

// Example operation response
{
  operationId: 123,
  type: 'supply',
  status: 'awaiting_signature',
  transactions: [{
    id: 456,
    status: 'unsigned',
    unsignedTransaction: 'base64...',
    description: 'Supply USDC to Kamino'
  }],
  expiresAt: '2024-01-15T12:30:00Z'
}

unsigned → pending → confirmed
                  ↘ failed