AugustSDK

The main Upshift SDK class.

Main SDK class for interacting with Upshift vaults and services. Provides unified access to EVM, Solana, Sui, and Stellar blockchain adapters.

Extends: AugustBase

Constructors

Constructor

new AugustSDK(baseConfig): AugustSDK

Initialize the Upshift SDK with provider configuration. Automatically sets up EVM adapter and optionally initializes Solana if RPC URL is provided.

Parameters

Returns

AugustSDK

Overrides

AugustBase.constructor

Properties

Accessors

apiModule

Get Signature

get apiModule(): AugustApi

Get the backend API module instance (AugustApi) — read-only access to backend-computed data with no on-chain equivalent: the unrealized-PnL series and the transparency dashboard (position snapshot, backing series, smoothed APY, allocations, fee config, governance).

Returns

AugustApi

subAccountsModule

Get Signature

get subAccountsModule(): AugustSubAccounts

Get the Sub-Accounts module instance.

Returns

AugustSubAccounts

vaultsModule

Get Signature

get vaultsModule(): AugustVaults

Get the Vaults module instance.

Returns

AugustVaults

Methods

clearWallet()

clearWallet(): void

Clear the active wallet address from the SDK state and monitoring headers.

Returns

void

Overrides

AugustBase.clearWallet

fetchPointsLeaderboard()

fetchPointsLeaderboard(params?): Promise<any>

Fetch the points leaderboard data.

Parameters

Returns

Promise<any>

Leaderboard response data

getLatestUnrealizedPnl()

getLatestUnrealizedPnl(): Promise<IUnrealizedPnlSnapshot[]>

Fetch the latest unrealized-PnL snapshot for every tracked vault. Delegates to AugustApi.getLatestUnrealizedPnl — see it for return shape and thrown errors.

Returns

Promise<IUnrealizedPnlSnapshot[]>

getLayerZeroDeposits()

getLayerZeroDeposits(props): Promise<ILayerZeroDeposit[]>

Query LayerZero USDC deposits from the august-layerzero subgraphs. Returns all deposits or filters by sender wallet address if provided.

Important Notes:

• Only deposit transactions are tracked (not withdrawals or other operations)
• Sender and recipient addresses are stored in bytes32 format in the subgraph
• Timestamps are available from the subgraph

Supported Vaults:

• upusdc: 0x80E1048eDE66ec4c364b4F22C8768fc657FF6A42
• coreusdc: 0xE9B725010A9E419412ed67d0fA5f3A5f40159D32
• earnausd: 0x36eDbF0C834591BFdfCaC0Ef9605528c75c406aA

Parameters

Returns

Promise<ILayerZeroDeposit[]>

Array of deposit events with the following structure:

• assetAmt: Amount of assets deposited (as string)
• shareAmt: Amount of shares received (as string)
• sender: Sender address in bytes32 format
• recipient: Recipient address in bytes32 format
• dstEid: Destination endpoint ID (LayerZero chain identifier)
• transactionHash_: Transaction hash

Throws

Error if receipt token is invalid or GraphQL request fails

Example

// Get all coreUSDC deposits
const allDeposits = await sdk.getLayerZeroDeposits({
  receiptToken: 'coreusdc'
});

// Get deposits for a specific wallet
const userDeposits = await sdk.getLayerZeroDeposits({
  receiptToken: 'upusdc',
  wallet: '0xb0280B58F541131b29D1B33319CD440a99eA0305'
});

getLayerZeroRedeems()

getLayerZeroRedeems(props?): Promise<ILayerZeroRedeem[]>

Get LayerZero redeems for earnAUSD vault

Parameters

Returns

Promise<ILayerZeroRedeem[]>

Example

// Get all earnAUSD redeems
const allRedeems = await sdk.getLayerZeroRedeems();

// Get redeems for a specific wallet
const userRedeems = await sdk.getLayerZeroRedeems({
  wallet: '0x2de1DCB8EaAd40fAd327fa3eE3F48774b8e20649'
});

getPrice()

getPrice(symbol): Promise<number>

Get the current USD price of a token by symbol or contract address. Falls back to CoinGecko if primary price source fails.

Parameters

Returns

Promise<number>

Current price in USD

getSwapRouterEligibleVaults()

getSwapRouterEligibleVaults(chainId, options?): Promise<0x${string}[]>

Resolve the vaults currently eligible for the any-token SwapRouter deposit surface on a chain — every vault the router has enableVault-ed whose on-chain registration is still live.

Delegates to AugustVaults.getSwapRouterEligibleVaults, which reconstructs the set from the router's VaultEnabled events and verifies each vault's current vaultInfo registration (not enumerable). Returns [] when no router is deployed on chainId or no provider is configured for it. On-chain eligibility only — app-level policy (e.g. OVault exclusions) remains the caller's responsibility.

Parameters

Returns

Promise<0x${string}[]>

Checksummed eligible vault addresses; [] when unavailable.

Throws

AugustSDKError when an eth_getLogs scan chunk fails.

Example

const vaults = await augustSdk.getSwapRouterEligibleVaults(1);

getSwapRouterWhitelistedTokens()

getSwapRouterWhitelistedTokens(chainId, options?): Promise<0x${string}[]>

Resolve the ERC-20 tokens currently whitelisted for the SwapRouter on a chain — the any-token set a deposit UI can offer as swap-and-deposit inputs.

Delegates to AugustVaults.getSwapRouterWhitelistedTokens, which reconstructs the set from the router's TokenEnabled events and verifies each against the on-chain whitelistedTokens mapping (not enumerable). Returns [] when no router is deployed on chainId or no provider is configured for it.

Parameters

Returns

Promise<0x${string}[]>

Checksummed whitelisted token addresses; [] when unavailable.

Throws

AugustSDKError when an eth_getLogs scan chunk fails.

Example

const tokens = await augustSdk.getSwapRouterWhitelistedTokens(1);

getTotalDeposited()

getTotalDeposited(options?): Promise<number>

Parameters

Returns

Promise<number>

getUserPoints()

getUserPoints(userAddress): Promise<any>

Get user points from the backend API. This fetches processed points data directly from the backend, removing the need for client-side points calculation.

Parameters

Returns

Promise<any>

Points data from the backend API

getVault()

getVault(props): Promise<IVault>

Fetch detailed information for a specific vault.

Parameters

Returns

Promise<IVault>

Single vault object with full metadata

getVaultActivity()

getVaultActivity(props): Promise<IVaultUserHistoryItem[]>

Get a vault's deposit/withdrawal activity across every participant.

The vault-wide counterpart to AugustSDK.getVaultUserHistory — use it to answer flow questions ("how many deposits in the last 7 days", "net flow this week") that point-in-time TVL cannot. Reads from the Goldsky subgraph, paginated so busy vaults are not truncated; a sinceTs window keeps short lookbacks cheap.

Parameters

Returns

Promise<IVaultUserHistoryItem[]>

Array of activity items (oldest-first) with normalized amounts, actor addresses, event type, and transaction hashes.

Throws

If vault is not a valid address or no chain id can be resolved.

Example

const weekAgo = Math.floor(Date.now() / 1000) - 7 * 86_400;
const items = await sdk.getVaultActivity({ vault, chainId: 143, sinceTs: weekAgo });

getVaultAllocations()

getVaultAllocations(props): Promise<IVaultAllocations | { message: string; status: number }>

Get vault asset allocations across DeFi protocols, CeFi, and OTC positions.

This is the data behind the "Vault Exposure" section of the Upshift app — a partner rendering that section in their own frontend needs only this call. Read exposurePerCategory for the pre-bucketed view the UI renders (supplying / borrowing / wallet / lending legs plus per-category USD totals) and netValue for the headline figure; the raw defi / cefi / otc arrays back the drill-downs. See Get Vault Allocations in the vaults docs for a faithful reproduction.

Stellar vaults resolve their DeFi exposure through the Untangled portfolio API instead of DeBank — one extra HTTP call, covering the idle buffer, Stellar protocol positions, custody wallets and bridged capital. If that call fails the exposure legs come back empty rather than throwing, so CeFi, OTC and loan allocations still resolve.

Parameters

Returns

Promise<IVaultAllocations | { message: string; status: number }>

Detailed breakdown of vault allocations by category

Example

const { exposurePerCategory, netValue } = await sdk.getVaultAllocations({
  vault: '0xcd69123b3FBBfC666E1f6a501da27B564C00De54',
  chainId: 1,
});
for (const item of exposurePerCategory?.supplying ?? []) {
  console.log(item.protocol, item.symbol, item.amount);
}

getVaultAnnualizedApy()

getVaultAnnualizedApy(props): Promise<IVaultAnnualizedApy>

Get annualized APY metrics for a vault.

Supported Vaults: cUSDO, tETH, wstETH, rsETH

Parameters

Returns

Promise<IVaultAnnualizedApy>

Annualized APY data including liquidity APY

Deprecated

The hgETH30dLiquidAPY and hgETH7dLiquidAPY response fields are deprecated. These fields will be removed on 2026-01-01. Use liquidAPY30Day and liquidAPY7Day fields instead.

getVaultApy()

getVaultApy(props): Promise<object[]>

Get current or historical APY for a vault.

Parameters

Returns

Promise<object[]>

APY data including rewards breakdown

Deprecated

use getVaultHistoricalTimeseries instead

getVaultAvailableRedemptions()

getVaultAvailableRedemptions(props): Promise<{ availableRedemptions: IVaultAvailableRedemption[]; pendingRedemptions: IVaultAvailableRedemption[]; processedWithdrawals: ISubgraphWithdrawProccessed[]; requestedWithdrawals: ISubgraphWithdrawRequest[] }>

Get redemption requests that are ready to be claimed.

Parameters

Returns

Promise<{ availableRedemptions: IVaultAvailableRedemption[]; pendingRedemptions: IVaultAvailableRedemption[]; processedWithdrawals: ISubgraphWithdrawProccessed[]; requestedWithdrawals: ISubgraphWithdrawRequest[] }>

Array of available redemption requests with amounts and timestamps

getVaultBorrowerHealthFactor()

getVaultBorrowerHealthFactor(props?): Promise<Record<string, IVaultBorrowerHealthFactor[]> | Record<string, IVaultBorrowerHealthFactor[]>[]>

Get the borrower's health factor by vault.

Pass vault whenever the caller knows which pool it cares about — it skips the all-vaults cross-chain fanout and only reads the loans for that one pool. The response map is keyed by lowercased vault address; look entries up with address.toLowerCase().

Parameters

Returns

Promise<Record<string, IVaultBorrowerHealthFactor[]> | Record<string, IVaultBorrowerHealthFactor[]>[]>

Object containing the borrower's health factor by vault.

getVaultHistoricalTimeseries()

getVaultHistoricalTimeseries(props): Promise<IHistoricalTimeseriesResponse>

Get historical timeseries data for a vault.

Parameters

Returns

Promise<IHistoricalTimeseriesResponse>

Historical timeseries data with TVL, APY, PnL, share price, and other metrics

getVaultLoans()

getVaultLoans(props): Promise<IVaultLoan[]>

Get active loans deployed from a vault.

Parameters

Returns

Promise<IVaultLoan[]>

Array of loan details including borrower, principal, APR

getVaultPnl()

getVaultPnl(props): Promise<IVaultPnl>

Get PnL for a vault (vault-level, not user-specific). Returns the vault's overall profit and loss across all users.

Parameters

Returns

Promise<IVaultPnl>

Vault PnL in USD and notional value

getVaultPositions()

getVaultPositions(props): Promise<IVaultPosition[]>

Get user positions across vaults including shares and claimable redemptions. Supports both EVM and Solana vaults.

Parameters

Returns

Promise<IVaultPosition[]>

Array of positions with balances and pending redemptions

getVaultRedemptionHistory()

getVaultRedemptionHistory(props): Promise<IVaultRedemptionHistoryItem[]>

Get historical redemption requests for a vault (settled, cancelled, pending-but-out-of-window), optionally filtered to one wallet.

Parameters

Returns

Promise<IVaultRedemptionHistoryItem[]>

Historical redemption records, newest first.

getVaults()

getVaults(options?): Promise<IVault[]>

Fetch all available vaults across configured networks. Optionally filter by chain IDs and include loan/allocation data.

Parameters

Returns

Promise<IVault[]>

Array of vault objects with metadata and optional position data

getVaultStakingPositions()

getVaultStakingPositions(props): Promise<IActiveStakingPosition[]>

Get user's staking positions for vault receipt tokens.

Parameters

Returns

Promise<IActiveStakingPosition[]>

Array of staking positions with rewards

getVaultSummary()

getVaultSummary(props): Promise<IVaultSummary>

Get summary data for a vault (name, type, chain, recent returns).

Parameters

Returns

Promise<IVaultSummary>

Vault summary data

getVaultTvl()

getVaultTvl(props): Promise<object[]>

Get current or historical TVL for a vault.

Parameters

Returns

Promise<object[]>

TVL in vault's base asset units

getVaultUnrealizedPnlHistory()

getVaultUnrealizedPnlHistory(params): Promise<IUnrealizedPnlSnapshot[]>

Fetch the historical unrealized-PnL series for a vault, newest first. Delegates to AugustApi.getVaultUnrealizedPnlHistory — see it for parameter semantics and thrown errors.

Parameters

Returns

Promise<IUnrealizedPnlSnapshot[]>

getVaultUserHistory()

getVaultUserHistory(props): Promise<IVaultUserHistoryItem[]>

Get user's historical vault interactions including deposits and withdrawals.

Parameters

Returns

Promise<IVaultUserHistoryItem[]>

Array of historical transactions with amounts and timestamps

getVaultUserLifetimePnl()

getVaultUserLifetimePnl(props): Promise<IVaultUserLifetimePnl>

Get lifetime PnL for a user in a specific vault. Calculates realized and unrealized PnL based on deposit/withdrawal history and current position.

Parameters

Returns

Promise<IVaultUserLifetimePnl>

Lifetime PnL data including realized and unrealized PnL in both native token and USD

getVaultUserTransfers()

getVaultUserTransfers(props): Promise<object[]>

Get user's vault share transfer history from subgraph.

Parameters

Returns

Promise<object[]>

Array of transfer events

getVaultWithdrawals()

getVaultWithdrawals(props): Promise<IVaultWithdrawals>

Get withdrawal summary and pending queue for a vault.

Parameters

Returns

Promise<IVaultWithdrawals>

Withdrawal summary and pending queue

getYieldLastRealizedOn()

getYieldLastRealizedOn(props): Promise<number>

Get the timestamp when yield was last realized for a vault.

Parameters

Returns

Promise<number>

Timestamp (Unix timestamp in seconds) when yield was last realized

init()

init(): Promise<void>

Verify API keys and authorize SDK usage.

Returns

Promise<void>

Inherited from

AugustBase.init

previewRedemption()

previewRedemption(props): Promise<INormalizedNumber>

Preview the amount of assets that would be received for redeeming shares (queued redemption).

Parameters

Returns

Promise<INormalizedNumber>

The amount of assets as INormalizedNumber

registerUserForPoints()

registerUserForPoints(userAddress, referrerAddress, chainId, signature, nonce, expiry): Promise<Response>

Register a user for the points program, authenticated by a wallet signature.

The caller produces a personal_sign signature over a canonical message containing the user address, referrer (or "none"), chain, nonce, and expiry — see AugustVaults.registerUserForPoints for the exact template.

Parameters

Returns

Promise<Response>

Raw Response from the backend.

switchNetwork()

switchNetwork(chainId): void

Switch the active network for vault operations. Updates the SDK's active chain and RPC provider.

Parameters

Returns

void

Overrides

AugustBase.switchNetwork

updateWallet()

updateWallet(address): void

Set the active wallet address for tracking user-specific vault data. Updates monitoring headers with the wallet address.

Parameters

Returns

void

Overrides

AugustBase.updateWallet

vaultDeposit()

vaultDeposit(signer, options): Promise<string>

Fetch all available vaults across configured networks. Optionally filter by chain IDs and include loan/allocation data.

Parameters

Returns

Promise<string>

Array of vault objects with metadata and optional position data