Import
Usage
Parameters
Return Type
Example: TVL Display Component
Error Handling
Related
- getVaultAPY - Fetch vault APY
- fetchSupportedAssets - Discover available vaults
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Fetch total value locked for a vault
import { getVaultTVL } from "@paxoslabs/amplify-sdk";
const result = await getVaultTVL({
vaultAddress: "0x1234...5678",
});
console.log(result.tvl); // "15000000.00"
console.log(result.tvlAsset); // "USDC"
| Parameter | Type | Required | Description |
|---|---|---|---|
vaultAddress | Address | Yes | Vault contract address |
chainId | number | No | Blockchain network ID (optional filter) |
interface GetVaultTVLParams {
vaultAddress: Address;
chainId?: number;
}
interface VaultTVLResult {
/** Total value locked as string */
tvl: string;
/** Asset denomination (e.g., "USDC") */
tvlAsset: string;
/** Vault address */
vaultAddress: Address;
/** Chain ID */
chainId: number;
/** Timestamp of the data point */
timestamp: string;
}
import { useQuery } from "@tanstack/react-query";
import { getVaultTVL } from "@paxoslabs/amplify-sdk";
function VaultTVLDisplay({ vaultAddress }: { vaultAddress: `0x${string}` }) {
const { data, isLoading } = useQuery({
queryKey: ["vaultTVL", vaultAddress],
queryFn: () => getVaultTVL({ vaultAddress }),
});
if (isLoading) return <span>Loading...</span>;
const formatted = data
? `$${Number(data.tvl).toLocaleString()} ${data.tvlAsset}`
: "N/A";
return <span>{formatted}</span>;
}
| Error Message Pattern | Description | Resolution |
|---|---|---|
"SDK not initialized" | SDK not initialized | Call initAmplifySDK() first |
"No TVL data found" | No data for vault | Verify vault address |
"Failed to fetch vault TVL" | Network or API error | Check connection and retry |