Introduction

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

// Example venue (EVM)
{
  id: 3,
  name: 'AAVE V3',
  protocol: 'aave-v3',
  blockchain: 'ethereum',
  status: 'active',
  strategies: [...]
}

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

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

// Example strategy (Ethereum)
{
  strategyId: 5,
  name: 'USDC Lending',
  token: 'USDC',
  tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  apy: 0.052,  // 5.2%
  status: 'active'
}

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

// Example allocation (Ethereum)
{
  strategyId: 5,
  strategyName: 'USDC Lending',
  venueName: 'AAVE V3',
  walletAddress: '0x742d...bD18',
  principal: '5000000000',      // 5000 USDC deposited
  currentValue: '5026000000',   // 5026 USDC current value
  yieldEarned: '26000000',      // 26 USDC earned
  apy: 0.052
}

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

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

unsigned → pending → confirmed
                  ↘ failed