SDK Integration

npm install @kasufinance/kasu-sdk

import { Kasu } from '@kasufinance/kasu-sdk';

// Initialize with a live chain (base, xdc, xdc-usdc)
const kasu = Kasu.create({ chain: 'base', signerOrProvider: provider });

// Browse strategies (lending pools)
const strategies = await kasu.strategies.getAll();

// Deposit into a pool
const tx = await kasu.deposits.deposit({
  poolId: '0x...',
  trancheId: '0x...',
  amount: parseUnits('1000', 6), // 1,000 USDC
  kycSignature: { blockExpiration, signature },
});

// Fetch user positions
const positions = await kasu.portfolio.getPositions('0xUser...');

const kasu = Kasu.create({
  chain: { chainId: 123, name: 'MyChain', isLiteDeployment: true, ... },
  signerOrProvider: provider,
});

interface Strategy {
  id: string;               // Pool address
  name: string;             // Pool name
  apy: number;              // Weighted-average APY (decimal, 0.08 = 8%)
  tvl: { total, offchain }; // Total value locked
  availableCapacity: string; // Remaining capacity (USDC)
  tranches: StrategyTranche[];
  assetClass: string;       // e.g. "Tax Receivables"
  apyStructure: 'Variable' | 'Fixed';
}

interface StrategyTranche {
  id: string;               // Tranche address
  name: string;             // e.g. "Senior"
  apy: number;              // Current base APY
  minimumDeposit: string;   // Min USDC deposit
  maximumDeposit: string;   // Max USDC deposit
  availableCapacity: string;
  fixedTermOptions: FixedTermOption[];
}

interface DepositParams {
  poolId: string;
  trancheId: string;
  amount: BigNumberish;        // USDC in base units (6 decimals)
  kycSignature: {
    blockExpiration: BigNumberish;
    signature: BytesLike;
  };
  fixedTermConfigId?: BigNumberish; // Pass 0 for variable deposits
  swapData?: BytesLike;            // Pass '0x' for direct USDC deposits
  depositData?: BytesLike;         // Pass '0x' when not needed
}

interface UserPositions {
  pools: PortfolioLendingPool[];  // Per-pool breakdown
  summary: PortfolioSummary;      // Aggregate: invested, yields, APY
}

// Direct service access
const locks = await kasu.services.Locking.getUserLocks(address);
const poolData = await kasu.services.DataService.getPoolOverview(epochId);

const kasu = Kasu.create({
  chain: 'base',
  signerOrProvider: signer,
  configOverrides: {
    subgraphUrl: 'https://custom-subgraph-url.com',
    directusUrl: 'https://custom-cms-url.com',
    contracts: { ... },       // Override contract addresses
    isLiteDeployment: false,
    UNUSED_LENDING_POOL_IDS: ['0x...'],
    poolMetadataMapping: {},  // Map pool addresses to metadata sources
  },
});