SDK Utilities

Helper methods available on the VaeaFlash client for monitoring and debugging.

getTokenCapacity()

Get capacity for a single token without loading all 30 tokens. Throws TOKEN_NOT_SUPPORTED if not found.

const msol = await flash.getTokenCapacity('mSOL');
console.log(msol.max_amount);      // 12000
console.log(msol.route_type);      // 'synthetic'
console.log(msol.source_protocol); // 'Marginfi'
console.log(msol.swap_protocol);   // 'Sanctum'
console.log(msol.status);          // 'available' | 'degraded' | 'offline'

// Also works with mint address:
const sol = await flash.getTokenCapacity('So11111111111111111111111111111111111111112');

Field	Type	Description
`symbol`	`string`	Token symbol (e.g. "mSOL")
`mint`	`string`	Token mint address
`decimals`	`number`	Token decimals
`max_amount`	`number`	Maximum borrowable amount (in token units)
`route_type`	`direct` \| `synthetic`	How the token is sourced
`source_protocol`	`string`	Lending protocol providing the liquidity
`swap_protocol`	`string \| null`	Swap provider (null for direct routes)
`status`	`available` \| `degraded` \| `offline`	Current availability status

getHealth()

Check the health of all VAEA Flash infrastructure components. Useful for monitoring dashboards and alerting.

const health = await flash.getHealth();

console.log(health.status);                    // 'ok'
console.log(health.components.redis.status);   // 'ok'
console.log(health.components.scanner.status); // 'ok'
console.log(health.components.scanner.cache_age_ms); // 1200
console.log(health.components.program.program_id);   // 'HoYiwk...'

// Source availability:
for (const [name, src] of Object.entries(health.sources)) {
  console.log(`${name}: ${src.status} — ${src.available_sol ?? 0} SOL`);
}

Component	Fields	Description
`components.redis`	`status`	Cache layer health
`components.scanner`	`status`, `cache_age_ms`	Liquidity scanner freshness
`components.program`	`program_id`	On-chain program ID
`sources`	`status`, `available_sol`	Per-protocol availability

💡 Tip

Use getHealth() in your monitoring system to detect degraded sources. If a source goes offline, the SDK automatically falls back to the next available protocol.