@coffer_so/sdk 1.3.0 → 1.4.0

package/dist/clients/CubeBackendClient.d.ts

@@ -1,877 +0,0 @@
-import { SdkResult } from "../types/result";
-import { PoolSummary } from "../types/pool";
-export interface CubeBackendClientParams {
-    apiEndpoint: string;
-    apiKey?: string;
-    defaultHeaders?: Record<string, string>;
-    /**
-     * Called when tokens are refreshed automatically after a 401.
-     * The frontend should persist the new tokens (e.g. to localStorage).
-     */
-    onTokenRefreshed?: (tokens: AuthTokens) => void;
-    /**
-     * Called when both access and refresh tokens are expired/invalid.
-     * The frontend should trigger a full re-authentication (SIWS sign-in).
-     */
-    onAuthExpired?: () => void;
-}
-export type StatsKind = "tvl" | "volume" | "swap_count" | "avg_swap" | "median_swap" | "fees_lp" | "fees_protocol" | "users_total" | "dau" | "mau" | "deposits" | "removals";
-export type StatsWindow = "1d" | "7d" | "30d" | "all";
-export interface StatsSeriesPoint {
-    t: number;
-    v: number;
-}
-export interface StatsSeries {
-    points: StatsSeriesPoint[];
-}
-export interface PriceMap {
-    [mint: string]: number;
-}
-export interface SwapRouteEntry {
-    poolAddress: string;
-    poolName: string;
-    amountIn: string;
-    /** Raw expected output for this leg — NET of the v5 sell-off surge fee
-     *  (what the user actually receives). */
-    expectedOut: string;
-    /** Raw minimum output for this leg after slippage — sign this into the
-     *  swap instruction. */
-    minAmountOut: string;
-    percentage: number;
-    swapFee: number;
-    /** Estimated v5 sell-off surge fee for this leg (raw units of tokenOut).
-     *  "0" in the common case — rises as the input token's max-selloff
-     *  window fills. */
-    surgeFeeAmount: string;
-    /** Surge fee rate applied to this leg (%). 0 when the window is calm. */
-    surgeFeePct: number;
-    tokenProgramIn: string;
-    tokenProgramOut: string;
-    tokenInIndex: number;
-    tokenOutIndex: number;
-    vaultIn: string | null;
-    vaultOut: string | null;
-}
-export interface SwapRouteResponse {
-    routes: SwapRouteEntry[];
-    totalAmountIn: string;
-    totalExpectedOut: string;
-    /** Total raw minimum received after slippage (sum of per-leg
-     *  minAmountOut). Always ≤ totalExpectedOut — display this as "Min
-     *  received" instead of extrapolating from spot price. */
-    minReceived: string;
-    /** Slippage tolerance applied by the backend (basis points; 200 = 2%). */
-    slippageBps: number;
-    effectivePrice: number;
-    priceImpact: number;
-    spotPrice: number;
-    /** Weighted average fee across routes (%), INCLUDING the v5 surge fee
-     *  when one is active. */
-    feePercent: number;
-    /** Total estimated v5 surge fee across legs (raw units of tokenOut).
-     *  "0" in the common case. */
-    totalSurgeFee: string;
-    /** Estimated XP earned from this swap (based on LP fees generated) */
-    estimatedXp: number;
-    /** True when a personalized XP boost (e.g. referred user +3%) was
-     *  applied to `estimatedXp` — requires the request to carry a JWT. */
-    xpBoostApplied: boolean;
-}
-export interface LeaderboardEntry {
-    address: string;
-    points: number;
-    place: number;
-}
-export interface LeaderboardResponse {
-    total: number;
-    page: number;
-    limit: number;
-    data: LeaderboardEntry[];
-}
-export interface LeaderboardUserStats {
-    place: number;
-    address: string;
-    points: number;
-    lastAccrualSwapUsd: number;
-    lastAccrualLiqUsd: number;
-    lastAccrualAt: string | null;
-}
-export interface XpAccrualHistoryEntry {
-    accrualTime: string;
-    swapVolumeUsd: number;
-    swapXp: number;
-    lpValueUsd: number;
-    lpXp: number;
-    totalXp: number;
-}
-export interface XpAccrualHistoryResponse {
-    total: number;
-    page: number;
-    limit: number;
-    data: XpAccrualHistoryEntry[];
-}
-export interface EpochHistoryEntry {
-    epoch: number;
-    start: string;
-    end: string;
-    multiplier: number;
-    swapXpPerUsdLpFee: number;
-    lpXpPerUsd: number;
-    isCurrent: boolean;
-}
-export interface LeaderboardEpochResponse {
-    currentEpoch: number;
-    currentEpochStart: string;
-    nextEpochStart: string;
-    msUntilNextEpoch: number;
-    currentMultiplier: number;
-    baseRates: {
-        swapXpPerUsdLpFee: number;
-        lpXpPerUsd: number;
-    };
-    currentRates: {
-        swapXpPerUsdLpFee: number;
-        lpXpPerUsd: number;
-    };
-    epochs: EpochHistoryEntry[];
-}
-export interface LeaderboardStatsResponse {
-    /** Total number of users in the leaderboard */
-    totalUsers: number;
-    /** Sum of all XP points across all users */
-    totalXp: number;
-}
-export interface CampaignStatusResponse {
-    /** Active campaign slug the backend is currently running. */
-    campaign: string;
-    participating: boolean;
-    /** ISO time of the ORIGINAL join; null when not participating. */
-    joinedAt: string | null;
-}
-export interface CampaignPrizeTier {
-    /** Inclusive place range this prize applies to. */
-    fromPlace: number;
-    toPlace: number;
-    usd: number;
-}
-export interface CampaignInfoResponse {
-    campaign: string;
-    startsAt: string;
-    endsAt: string;
-    /** Server-computed — drive the countdown from this, not client clocks. */
-    msUntilEnd: number;
-    ended: boolean;
-    prizePoolUsd: number;
-    /** Fixed for the whole campaign; paid out manually after the end. */
-    prizes: CampaignPrizeTier[];
-    rates: {
-        /** Same swap-XP rate as the leaderboard; LP XP is NOT accrued here. */
-        swapXpPerUsdLpFee: number;
-    };
-}
-export interface CampaignRankResponse {
-    campaign: string;
-    from: string;
-    /** Effective window end after server-side clamping to the campaign. */
-    to: string;
-    participating: boolean;
-    /**
-     * Place under the same ordering as the public top table; null when not
-     * participating or no swap XP earned inside the window.
-     */
-    place: number | null;
-    swapXp: number;
-    swapVolumeUsd: number;
-    /** Size of the ranked table — for "you are N of M" UI. */
-    totalRanked: number;
-}
-export interface CampaignTopEntry {
-    /** Continuous across pages. */
-    place: number;
-    address: string;
-    /** XP earned from swaps inside the window (LP XP not counted). */
-    swapXp: number;
-    swapVolumeUsd: number;
-    joinedAt: string;
-}
-export interface CampaignTopResponse {
-    campaign: string;
-    from: string;
-    /** Effective window end after server-side clamping to the campaign. */
-    to: string;
-    /** Participants with swap XP > 0 in the window. */
-    total: number;
-    page: number;
-    limit: number;
-    data: CampaignTopEntry[];
-}
-export interface PlatformStatsResponse {
-    totalTvlUsd: number;
-    totalVirtualTvl: number;
-    totalVolume24h: number;
-    poolCount: number;
-    updatedAt: string | null;
-}
-export interface AdminPoolEntry {
-    poolAddress: string;
-    poolName: string;
-    /** Off-chain: mint shown first in the token list (null = default order). */
-    baseAssetMint: string | null;
-    /** Off-chain: short pool description. */
-    description: string | null;
-    tvlUsd: number;
-    apy: number;
-    volume24h: number;
-    swapFee: number;
-    poolEnabled: boolean;
-    swapsEnabled: boolean;
-    tokens: Array<{
-        mintAddress: string;
-        ticker: string;
-        imageUrl: string | null;
-    }>;
-}
-/** Off-chain, admin-editable pool settings. */
-export interface UpdatePoolSettingsBody {
-    /** Mint of the base asset (one of the pool tokens); "" clears it. */
-    baseAssetMint?: string;
-    /** Short description; "" clears it. */
-    description?: string;
-}
-export interface AdminPoolsResponse {
-    pools: AdminPoolEntry[];
-}
-export interface IsAdminResponse {
-    poolAddress: string;
-    isAdmin: boolean;
-}
-export interface RenamePoolResponse {
-    poolAddress: string;
-    name: string;
-    updated: true;
-}
-export interface ReferralBindResponse {
-    referrer: string;
-    bound: true;
-}
-export interface ReferralRates {
-    l1Percent: number;
-    l2Percent: number;
-}
-export interface ReferralStats {
-    totalReferrals: number;
-    l1Count: number;
-    l2Count: number;
-    totalBonusPoints: number;
-    l1BonusPoints: number;
-    l2BonusPoints: number;
-}
-export interface ReferralStatusResponse {
-    referredBy: string | null;
-    referralCode: string;
-    customCodes: string[];
-    rates: ReferralRates;
-    stats: ReferralStats;
-}
-export interface ReferralEntry {
-    /** Wallet address of the referral */
-    address: string;
-    /** Total bonus XP this referral has earned for you */
-    earnedBonusXp: number;
-    /** When this user became your referral */
-    boundAt: string;
-}
-export interface ReferralListResponse {
-    total: number;
-    page: number;
-    limit: number;
-    data: ReferralEntry[];
-}
-export interface PortfolioValueChange {
-    abs: number;
-    pct: number;
-}
-export interface PortfolioSummaryResponse {
-    value: {
-        total: number;
-        inPositions: number;
-        inWallet: number;
-        change: {
-            d1: PortfolioValueChange;
-            d7: PortfolioValueChange;
-        };
-    };
-    totalPnl: {
-        net: number;
-        pct: number;
-        components: {
-            feesEarned: number;
-            ilCurrent: number;
-            ilRealized: number;
-        };
-    };
-}
-export interface PortfolioExposureToken {
-    symbol: string;
-    mint: string;
-    logo: string | null;
-    usd: number;
-    amount: number;
-    pct: number;
-    inLp: number;
-    inWallet: number;
-    pools: string[];
-}
-export interface PortfolioExposureResponse {
-    totalUsd: number;
-    tokens: PortfolioExposureToken[];
-}
-export interface PortfolioHistoryPoint {
-    t: number;
-    feesCumulative: number;
-    ilCumulative: number;
-    netPnl: number;
-}
-export interface PortfolioHistoryResponse {
-    range: string;
-    series: PortfolioHistoryPoint[];
-}
-export interface PortfolioPoolEntry {
-    poolAddress: string;
-    poolName: string;
-    tokens: Array<{
-        symbol: string;
-        mint: string;
-    }>;
-    value: number;
-    feesEarned: number;
-    /** LIVE unrealized IL only (≤ 0); realized part is `ilRealized` */
-    il: number;
-    /** Result locked in on past withdrawals vs HODL ("Realized PnL" in UI) */
-    ilRealized: number;
-    netPnl: number;
-    /** POOL-wide APY, % — the same number as the pools page (legacy name). */
-    apr: number;
-}
-export interface PortfolioPoolsResponse {
-    pools: PortfolioPoolEntry[];
-}
-export interface PortfolioPoolHistoryPoint {
-    t: number;
-    feesCumulative: number;
-    ilCumulative: number;
-}
-export interface PortfolioPoolHistoryResponse {
-    poolAddress: string;
-    range: string;
-    series: PortfolioPoolHistoryPoint[];
-}
-export type PortfolioChartMetric = "networth" | "pnl" | "il" | "xp";
-export type PortfolioChartRange = "24h" | "1w" | "1m" | "1y" | "all";
-export interface PortfolioChartResponse {
-    metric: PortfolioChartMetric;
-    range: PortfolioChartRange;
-    /** Distance between series/line points, seconds. */
-    granularitySec: number;
-    /**
-     * Headline value: the last point. For `xp` — the lifetime XP total.
-     * For `il` — the NET result (profit + IL, the bottom line vs HODL).
-     */
-    current: number;
-    /**
-     * Change over the range (for XP: abs = XP earned in the range; for il:
-     * the net change). `pct` is null when the base is zero/near-zero
-     * (growth from nothing, or a signed pnl/net-il base under $1) — render
-     * it as "—".
-     */
-    change: {
-        abs: number;
-        pct: number | null;
-    };
-    /**
-     * True when the data is partially estimated: wallet history coverage
-     * hit its cap / the history API was unavailable (amounts frozen at the
-     * horizon), or LP events inside the range (il / pnl metrics).
-     */
-    approximate: boolean;
-    /**
-     * The single line, [unixSeconds, value] pairs ascending — for
-     * `networth`, `pnl` and `xp`. ABSENT for `il`, which returns two
-     * separate lines in `lines` instead.
-     *
-     * - networth: whole-portfolio USD value at each point.
-     * - pnl: cumulative profit/loss vs invested dollars (never-decreasing
-     *   is NOT guaranteed — it moves with the market and with fixations).
-     * - xp: the total XP as of each point — cumulative, never decreasing.
-     */
-    series?: Array<[number, number]>;
-    /**
-     * `il` metric ONLY: two lines to draw on the same chart, both
-     * [unixSeconds, value] ascending on a shared grid, BOTH as POSITIVE
-     * magnitudes.
-     * - `profit`: cumulative LP fees earned (≥ 0, draw green).
-     * - `il`: impermanent loss as a positive number (≥ 0, draw red) — the
-     *   red line already means "loss", so it carries no minus sign.
-     * The net LP result vs HODL is `profit − il`, and that is what
-     * `current` and `change` report. There is no `series` for this metric.
-     */
-    lines?: {
-        profit: Array<[number, number]>;
-        il: Array<[number, number]>;
-    };
-}
-export type PortfolioActivityType = "swap" | "added" | "removed" | "zap" | "sent" | "received" | "deployed";
-export type PortfolioActivityFilter = "all" | "liquidity" | "zap" | "swap" | "transfer" | "deployed";
-export interface ActivityTokenInfo {
-    mint: string;
-    symbol: string | null;
-    logo: string | null;
-}
-export interface PortfolioActivityItem {
-    type: PortfolioActivityType;
-    signature: string;
-    /** Unix seconds. */
-    time: number;
-    /**
-     * Signed USD: + for added/zap/received, − for removed/sent, unsigned for
-     * swap; null when unpriceable and for deployed rows.
-     */
-    valueUsd: number | null;
-    pool: {
-        address: string;
-        name: string;
-        feePercent: number | null;
-        bptMint: string | null;
-        tokens: ActivityTokenInfo[];
-        /** Pool weights in % (for the deployed row's "80/20 weights" subtitle). */
-        weights?: number[];
-    } | null;
-    /** Only on swap rows. */
-    swap?: {
-        tokenIn: ActivityTokenInfo;
-        tokenOut: ActivityTokenInfo;
-    };
-    /** Only on sent/received rows (wallet-to-wallet LP token transfers). */
-    transfer?: {
-        counterparty: string | null;
-    };
-}
-export interface PortfolioActivityResponse {
-    total: number;
-    page: number;
-    limit: number;
-    data: PortfolioActivityItem[];
-}
-export type SortOrder = "desc" | "asc";
-export type PortfolioActivitySortField = "time" | "value";
-export type PortfolioHoldingsSortField = "value" | "price" | "balance";
-export interface PortfolioHoldingItem {
-    token: {
-        mint: string;
-        symbol: string | null;
-        /** Full token name (e.g. "USD Coin"); null when metadata has none. */
-        name: string | null;
-        logo: string | null;
-    };
-    priceUsd: number;
-    /** Total amount: wallet + decomposed LP positions. */
-    balance: number;
-    valueUsd: number;
-    /** Source breakdown for the tooltip; pct is of the token's balance. */
-    sources: {
-        wallet: {
-            amount: number;
-            pct: number;
-        };
-        pools: Array<{
-            poolAddress: string;
-            poolName: string;
-            amount: number;
-            pct: number;
-        }>;
-    };
-}
-export interface PortfolioHoldingsResponse {
-    total: number;
-    page: number;
-    limit: number;
-    data: PortfolioHoldingItem[];
-}
-export type PortfolioPositionsSortField = "value" | "fees" | "il" | "pnl" | "apy";
-export interface PortfolioPositionItem {
-    pool: {
-        address: string;
-        name: string;
-        feePercent: number | null;
-        bptMint: string | null;
-        tokens: ActivityTokenInfo[];
-    };
-    /** Position value from the 30s-fresh wallet BPT balance. */
-    valueUsd: number;
-    /** Lifetime LP fees earned in this pool. */
-    feesEarned: number;
-    /** Live unrealized IL (≤ 0); the realized part is `ilRealized`. */
-    il: number;
-    ilRealized: number;
-    /** feesEarned + il + ilRealized. */
-    netPnl: number;
-    /** POOL-wide APY, % (24h-based) — the same number as the pools page. */
-    apy: number;
-}
-export interface PortfolioPositionsResponse {
-    /** Number of ACTIVE positions (the "N active positions" header). */
-    total: number;
-    page: number;
-    limit: number;
-    /** Σ value of ALL active positions (the header total), not the page. */
-    totalValueUsd: number;
-    data: PortfolioPositionItem[];
-}
-export type PairChartRange = "1d" | "1w" | "1m" | "1y" | "all";
-/**
- * Price of token `a` expressed in units of token `b` over time — the
- * one-line chart behind the range picker on the pool creation page.
- */
-export interface TokenPairChartResponse {
-    /** Numerator mint — the token being priced. */
-    a: string;
-    /** Denominator mint — the token `a` is priced IN. */
-    b: string;
-    range: PairChartRange;
-    /** Spacing between series points, seconds. */
-    granularitySec: number;
-    current: {
-        /**
-         * How many units of `b` one unit of `a` is worth right now — the
-         * big "1,284.52 SOL/USDT" headline number.
-         */
-        ratio: number;
-        /** Current USD price of `a` — the grey "$345.44" next to it. */
-        aUsd: number;
-        /** Current USD price of `b`. */
-        bUsd: number;
-    };
-    /**
-     * Change of the pair price over the range. `pct` is null when the
-     * range started from an unknown (zero) price — render "—".
-     */
-    change: {
-        abs: number;
-        pct: number | null;
-    };
-    /**
-     * [unixSeconds, priceAinB] ascending — ONE line. Values are rounded
-     * to 6 significant digits (pairs like BONK/SOL live around 1e-9).
-     */
-    series: Array<[number, number]>;
-}
-export interface NonceResponse {
-    nonce: string;
-    message: string;
-}
-/**
- * Challenge for the transaction-based sign-in fallback (wallets whose
- * signMessage path is broken — Ledger through mobile apps first of all).
- */
-export interface TxChallengeResponse {
-    nonce: string;
-    /** Base64-encoded UNSIGNED transaction to pass to wallet.signTransaction. */
-    transaction: string;
-    /** Human-readable memo embedded in the transaction (agreements + nonce). */
-    memo: string;
-}
-export interface AuthTokens {
-    accessToken: string;
-    refreshToken: string;
-    wallet: string;
-    expiresIn: string;
-}
-/**
- * REST wrapper around the Cube backend. Every method is a SdkResult; no
- * exceptions escape. If a request fails, the result carries a
- * human-readable error plus the original cause.
- *
- * Auto-refresh: when a request gets 401, the client automatically tries
- * to refresh tokens via POST /api/auth/refresh. If successful, the
- * original request is retried once with the new access token.
- */
-export declare class CubeBackendClient {
-    private readonly endpoint;
-    private readonly headers;
-    private refreshToken;
-    private refreshInFlight;
-    private readonly onTokenRefreshed?;
-    private readonly onAuthExpired?;
-    constructor(params: CubeBackendClientParams);
-    listPools(): Promise<SdkResult<PoolSummary[]>>;
-    getPool(addr: string): Promise<SdkResult<PoolSummary>>;
-    /**
-     * Raw pool-list response in the same envelope the backend returns
-     * (`{ data, hasMore, totalCount }`). Kept so the frontend's React
-     * Query hooks can map directly.
-     */
-    listPoolsRaw(limit: number, offset: number): Promise<SdkResult<{
-        data: unknown[];
-        hasMore: boolean;
-        totalCount: number;
-    }>>;
-    getPoolRaw(addr: string): Promise<SdkResult<unknown>>;
-    createPool<T>(body: unknown): Promise<SdkResult<T>>;
-    getPoolsByTokenPair<T>(tokenA: string, tokenB: string): Promise<SdkResult<T>>;
-    getPlatformStats(): Promise<SdkResult<PlatformStatsResponse>>;
-    getPortfolio<T>(wallet: string): Promise<SdkResult<T>>;
-    getAllTokens<T>(): Promise<SdkResult<T>>;
-    getTopTokens<T>(limit?: number): Promise<SdkResult<T>>;
-    getPoolTxStats<T>(addr: string): Promise<SdkResult<T>>;
-    getTransactions<T>(addr: string, options?: {
-        limit?: number;
-        offset?: number;
-        type?: "swap" | "add_liquidity" | "remove_liquidity";
-        user?: string;
-    }): Promise<SdkResult<T>>;
-    getSwapRoute(tokenIn: string, tokenOut: string, amountIn: string, decimalsIn?: number, slippageBps?: number, 
-    /**
-     * Restrict the quote to this single pool: no split routing, all
-     * estimates (priceImpact against this pool's own spot, fees, XP) are
-     * computed as if swapping only through it.
-     */
-    pool?: string): Promise<SdkResult<SwapRouteResponse>>;
-    getLeaderboard(page?: number, limit?: number): Promise<SdkResult<LeaderboardResponse>>;
-    getLeaderboardUser(address: string): Promise<SdkResult<LeaderboardUserStats>>;
-    getLeaderboardUserHistory(address: string, page?: number, limit?: number): Promise<SdkResult<XpAccrualHistoryResponse>>;
-    getLeaderboardEpoch(): Promise<SdkResult<LeaderboardEpochResponse>>;
-    /** Get overall leaderboard stats: total users and total XP. */
-    getLeaderboardStats(): Promise<SdkResult<LeaderboardStatsResponse>>;
-    /**
-     * Join the active swap-XP campaign. Requires SIWS auth (`setTokens`);
-     * the wallet comes from the JWT. IDEMPOTENT — repeat calls are no-ops
-     * returning the same status with the original join time.
-     */
-    joinCampaign(): Promise<SdkResult<CampaignStatusResponse>>;
-    /** Participation status of the authenticated wallet (requires SIWS auth). */
-    getCampaignStatus(): Promise<SdkResult<CampaignStatusResponse>>;
-    /** Active campaign card: window, server-side countdown, prizes. Public. */
-    getCampaignInfo(): Promise<SdkResult<CampaignInfoResponse>>;
-    /**
-     * The authenticated wallet's own place in the campaign standings
-     * (requires SIWS auth). Same window semantics and ordering as
-     * getCampaignTop, so the place always matches the public table.
-     */
-    getCampaignRank(from?: string, to?: string): Promise<SdkResult<CampaignRankResponse>>;
-    /**
-     * Campaign standings: participants only, ranked by swap XP inside
-     * [from, to). Both dates are optional and CLAMPED into the campaign
-     * window server-side (defaults: the whole campaign) — omit both for
-     * the live standings of the running campaign; they freeze by
-     * themselves once it ends. Public endpoint, paginated like the
-     * leaderboard.
-     */
-    getCampaignTop(from?: string, to?: string, page?: number, limit?: number): Promise<SdkResult<CampaignTopResponse>>;
-    getTokenPrices(mints: string[]): Promise<SdkResult<PriceMap>>;
-    getStats(kind: StatsKind, window?: StatsWindow, poolAddr?: string, unit?: "usd" | "token"): Promise<SdkResult<StatsSeries>>;
-    /**
-     * Get pools where the authenticated user is the on-chain admin.
-     * Requires authentication.
-     */
-    getAdminPools(): Promise<SdkResult<AdminPoolsResponse>>;
-    /**
-     * Check if the authenticated user is the on-chain admin of a specific pool.
-     * Requires authentication.
-     */
-    isPoolAdmin(poolAddress: string): Promise<SdkResult<IsAdminResponse>>;
-    /**
-     * Rename a pool. Only the on-chain pool admin can do this.
-     * Requires authentication.
-     */
-    renamePool(poolAddress: string, name: string): Promise<SdkResult<RenamePoolResponse>>;
-    /**
-     * Update off-chain pool settings (base asset, description). Only fields
-     * present are changed; empty string clears a field. Base asset must be
-     * one of the pool tokens. Pool admin only; requires authentication.
-     */
-    updatePoolSettings<T>(poolAddress: string, settings: UpdatePoolSettingsBody): Promise<SdkResult<T>>;
-    /**
-     * Bind the authenticated user as a referral of the given referrer.
-     * The code can be a wallet address or a custom referral code.
-     * Optionally pass UTM parameters from the referral link for analytics.
-     * Requires authentication (setTokens must be called first).
-     */
-    bindReferral(code: string, utm?: {
-        source?: string;
-        medium?: string;
-        campaign?: string;
-        content?: string;
-        term?: string;
-    }): Promise<SdkResult<ReferralBindResponse>>;
-    /**
-     * Get the authenticated user's referral status: referrer, referral code,
-     * custom codes, bonus rates (L1/L2 %), and aggregated stats.
-     * Requires authentication.
-     */
-    getReferralStatus(): Promise<SdkResult<ReferralStatusResponse>>;
-    /**
-     * Get a paginated list of the authenticated user's direct referrals (L1).
-     * Requires authentication.
-     */
-    getMyReferrals(page?: number, limit?: number): Promise<SdkResult<ReferralListResponse>>;
-    /**
-     * Portfolio summary: value (LP + wallet) + total PnL (fees, IL current, IL realized).
-     * Returns 404 if user has no LP positions.
-     */
-    getPortfolioSummary(): Promise<SdkResult<PortfolioSummaryResponse>>;
-    /**
-     * Token exposure: per-token breakdown of LP positions + wallet balances.
-     */
-    getPortfolioExposure(): Promise<SdkResult<PortfolioExposureResponse>>;
-    /**
-     * Portfolio history for charts (fees cumulative + IL cumulative).
-     * Daily data points for the selected range.
-     */
-    getPortfolioHistory(range?: "7d" | "30d" | "90d" | "all"): Promise<SdkResult<PortfolioHistoryResponse>>;
-    /**
-     * Per-pool portfolio metrics (value, fees, unrealized IL, realized
-     * IL/PnL, net PnL, APR).
-     */
-    getPortfolioPools(): Promise<SdkResult<PortfolioPoolsResponse>>;
-    /**
-     * Per-pool history (lazy-loaded on row expand).
-     * Fees cumulative + IL cumulative series for a single pool.
-     */
-    getPortfolioPoolHistory(poolAddress: string, range?: "7d" | "30d" | "90d" | "all"): Promise<SdkResult<PortfolioPoolHistoryResponse>>;
-    /**
-     * Chart data for the portfolio page chart card. Most metrics fill
-     * `series` (one line); `il` fills `lines` (two lines) instead.
-     *
-     * Metrics: `networth` — whole portfolio value over time (wallet tokens +
-     * LP positions, reconstructed from on-chain wallet history × historical
-     * prices); `pnl` — CUMULATIVE profit/loss vs invested dollars:
-     * unrealized (LP value minus entry-priced capital) + profit FIXED at
-     * every exit (withdrawal = received USD − capital share, transfer-out =
-     * amount × LP price at that moment − capital share) — continuous at
-     * both top-ups and exits;
-     * `il` — TWO lines in `lines`, both POSITIVE: `profit` (cumulative LP
-     * fees earned) and `il` (impermanent loss magnitude, vs HODL); there is
-     * no `series` for this metric, and `current`/`change` report the net
-     * (profit − il);
-     * `xp` — the total XP as of each point (cumulative, never decreasing).
-     *
-     * `all` range spans at least one year even for recent users, so it is
-     * never shorter than `1y`.
-     */
-    getPortfolioChart(metric: PortfolioChartMetric, range: PortfolioChartRange): Promise<SdkResult<PortfolioChartResponse>>;
-    /**
-     * On-chain activity feed: swaps, liquidity added/removed, zaps
-     * (single-token deposits), LP tokens sent/received (wallet transfers
-     * with counterparties) and pools deployed by the user. Newest first,
-     * page/limit pagination. The Recent Activity widget is `{ limit: 4 }`;
-     * filters: `liquidity` = added + removed, `transfer` = sent + received.
-     */
-    getPortfolioActivity(options?: {
-        page?: number;
-        limit?: number;
-        type?: PortfolioActivityFilter;
-        /** Sort column; unpriced rows (deployed) always go last on "value". */
-        sort?: PortfolioActivitySortField;
-        order?: SortOrder;
-    }): Promise<SdkResult<PortfolioActivityResponse>>;
-    /**
-     * Token Holdings: every token the user holds, with LP positions
-     * DECOMPOSED into their underlying tokens (per-pool share of actual
-     * balances — what the user would receive on withdrawal). LP tokens
-     * themselves are never listed. Each row carries a source breakdown
-     * (wallet + per-pool amounts/percentages) for the Source tooltip.
-     * The widget is `{ limit: 4 }`; sortable by value/price/balance.
-     */
-    getPortfolioHoldings(options?: {
-        page?: number;
-        limit?: number;
-        sort?: PortfolioHoldingsSortField;
-        order?: SortOrder;
-    }): Promise<SdkResult<PortfolioHoldingsResponse>>;
-    /**
-     * Position Pools: the user's ACTIVE LP positions with per-pool money
-     * metrics — value (from the fresh wallet BPT balance), fees earned,
-     * unrealized + realized IL, net PnL and personal compounded APY.
-     * A freshly received (transferred) position appears immediately with
-     * its value and zeroed metrics until the background snapshot builds.
-     */
-    getPortfolioPositions(options?: {
-        page?: number;
-        limit?: number;
-        sort?: PortfolioPositionsSortField;
-        order?: SortOrder;
-    }): Promise<SdkResult<PortfolioPositionsResponse>>;
-    /**
-     * Price of token `a` expressed in token `b` over time — one line for
-     * the range-picker chart on the pool creation page. Works for ANY two
-     * Solana mints; no auth required.
-     *
-     * Cheap to call in bursts: the backend caches price history PER TOKEN,
-     * so charting every token of a pool against one base costs at most one
-     * upstream fetch per unique mint — flipping the base token reuses all
-     * of them. Rate-limited per IP (90/min) on top of the global limiter.
-     *
-     * `"all"` is capped at one year — the historical price horizon for
-     * arbitrary mints.
-     */
-    getTokenPairChart(a: string, b: string, range: PairChartRange): Promise<SdkResult<TokenPairChartResponse>>;
-    /** Request a SIWS nonce + pre-built message for the given wallet. */
-    getNonce(wallet: string): Promise<SdkResult<NonceResponse>>;
-    /** Submit signed SIWS message to receive access + refresh tokens. */
-    verifySignature(message: string, signature: string): Promise<SdkResult<AuthTokens>>;
-    /**
-     * Request a sign-in challenge transaction (fallback for wallets whose
-     * signMessage is broken: Ledger via mobile apps, etc.). The returned
-     * transaction is a 0-lamport self-transfer plus a memo with the
-     * agreements statement and a single-use nonce; it is verified offline
-     * by the backend and never broadcast on-chain.
-     */
-    getTxChallenge(wallet: string): Promise<SdkResult<TxChallengeResponse>>;
-    /**
-     * Submit the signed challenge transaction (base64, from
-     * wallet.signTransaction + serialize) to receive the same access +
-     * refresh token pair as verifySignature().
-     */
-    verifyTransaction(signedTransactionBase64: string): Promise<SdkResult<AuthTokens>>;
-    /**
-     * Set both tokens. Call this after verifySignature() and on app init
-     * (restoring tokens from storage).
-     */
-    setTokens(accessToken: string, refreshToken: string): void;
-    /** Clear both tokens (logout). */
-    clearTokens(): void;
-    /** @deprecated Use setTokens() instead. */
-    setAccessToken(token: string): void;
-    /** @deprecated Use clearTokens() instead. */
-    clearAccessToken(): void;
-    /** Generic GET with retry. Callers that need it for other endpoints. */
-    get<T>(path: string): Promise<SdkResult<T>>;
-    post<T>(path: string, body: unknown): Promise<SdkResult<T>>;
-    put<T>(path: string, body: unknown): Promise<SdkResult<T>>;
-    /**
-     * Core request method with auto-refresh on 401.
-     * If a request gets 401 and we have a refresh token:
-     *   1. Call POST /api/auth/refresh (deduplicated if concurrent)
-     *   2. On success: update tokens, notify via callback, retry original request
-     *   3. On failure: notify via onAuthExpired callback, return original error
-     */
-    private requestWithRefresh;
-    private rawRequest;
-    /**
-     * Attempt to refresh tokens. Returns true if successful.
-     * Deduplicates concurrent refresh attempts.
-     */
-    private tryRefresh;
-    private doRefresh;
-    private is401;
-    /**
-     * Fetch a response envelope of the form `{ data: T, ... }` and unwrap
-     * the `.data` field. The existing Cube backend wraps most endpoints
-     * this way.
-     */
-    private getDataField;
-    private postDataField;
-    /** Fetch the full envelope (for endpoints that return meta alongside data). */
-    private getEnvelope;
-}
-//# sourceMappingURL=CubeBackendClient.d.ts.map