@0xmonaco/types 0.8.7 → 0.8.10

package/dist/faucet/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Faucet Types
+ *
+ * Types for the testnet token faucet. Wire shapes are snake_case.
+ *
+ * NOTE: The faucet is **testnet-only** and performs real on-chain mints from a
+ * backend-operator-funded signer. It is disabled (returns an error) if the
+ * gateway operator has not configured a signer; the SDK caller has no control
+ * over that. It is rate-limited per user (default 1 request / 24h).
+ */
+import type { BaseAPI } from "../api";
+/** A token successfully minted by the faucet. */
+export interface MintedToken {
+    /** Asset UUID */
+    asset_id: string;
+    /** Token symbol */
+    symbol: string;
+    /** Amount minted in token units */
+    amount: string;
+    /** On-chain transaction hash */
+    tx_hash: string;
+}
+/** A token the faucet failed to mint. */
+export interface FailedMint {
+    /** Asset UUID */
+    asset_id: string;
+    /** Token symbol */
+    symbol: string;
+    /** Error message describing why the mint failed */
+    error: string;
+}
+/** Result of a faucet mint request. */
+export interface MintTokensResponse {
+    /** Tokens that were successfully minted */
+    minted: MintedToken[];
+    /** Tokens that failed to mint */
+    failed: FailedMint[];
+    /** Remaining faucet requests in the next 24h */
+    remaining_requests_24h: number;
+}
+/**
+ * Faucet API interface. Session-authenticated.
+ */
+export interface FaucetAPI extends BaseAPI {
+    /**
+     * Mints the full set of testnet tokens to the authenticated user.
+     *
+     * Testnet-only and rate-limited; see the module note. Partial success is
+     * possible — inspect `minted` and `failed` in the response.
+     *
+     * @returns Promise resolving to the minted/failed tokens and remaining quota
+     */
+    mint(): Promise<MintTokensResponse>;
+}

package/dist/faucet/index.js

@@ -0,0 +1,10 @@
+/**
+ * Faucet Types
+ *
+ * Types for the testnet token faucet. Wire shapes are snake_case.
+ *
+ * NOTE: The faucet is **testnet-only** and performs real on-chain mints from a
+ * backend-operator-funded signer. It is disabled (returns an error) if the
+ * gateway operator has not configured a signer; the SDK caller has no control
+ * over that. It is rate-limited per user (default 1 request / 24h).
+ */

package/dist/index.d.ts

@@ -9,13 +9,17 @@ export * from "./applications";
 export * from "./auth";
 export * from "./contracts";
 export * from "./delegated-agents";
+export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";
+export * from "./sub-accounts";
 export * from "./trading";
 export * from "./validation";
 export * from "./vault";
 export * from "./websocket";
+export * from "./whitelist";
+export * from "./withdrawals";

package/dist/index.js

@@ -10,13 +10,17 @@ export * from "./applications";
 export * from "./auth";
 export * from "./contracts";
 export * from "./delegated-agents";
+export * from "./faucet";
 export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";
+export * from "./sub-accounts";
 export * from "./trading";
 export * from "./validation";
 export * from "./vault";
 export * from "./websocket";
+export * from "./whitelist";
+export * from "./withdrawals";

package/dist/margin-accounts/index.d.ts

@@ -3,6 +3,8 @@ import type { OrderSide, OrderType, PositionSide } from "../trading";
 export interface MarginAccountSummary {
     margin_account_id: string;
     label?: string;
+    margin_bucket_id?: string;
+    margin_mode?: "ISOLATED" | "CROSS";
     trading_pair_id?: string;
     strategy_key?: string;
     account_state: string;
@@ -28,16 +30,8 @@ export interface ListMarginAccountsResponse {
     page: number;
     page_size: number;
 }
-export interface CreateMarginAccountRequest {
-    label?: string;
-    collateralAsset?: string;
-}
-export interface CreateMarginAccountResponse {
-    margin_account_id: string;
-    label?: string;
-    account_state: string;
-    collateral_asset: string;
-    created_at: string;
+export interface GetMarginAccountSummaryParams {
+    tradingPairId?: string;
 }
 export interface GetAvailableCollateralParams {
     asset?: string;
@@ -51,6 +45,8 @@ export interface GetAvailableCollateralResponse {
 export interface TransferCollateralRequest {
     asset: string;
     amount: string;
+    tradingPairId?: string;
+    strategyKey?: string;
 }
 export interface TransferCollateralToAutoMarginAccountRequest extends TransferCollateralRequest {
     tradingPairId: string;
@@ -88,7 +84,6 @@ export interface GetMarginAccountMovementsResponse {
 }
 export interface SimulateOrderRiskRequest {
     tradingPairId: string;
-    strategyKey?: string;
     side: OrderSide;
     positionSide: PositionSide;
     orderType: OrderType;
@@ -97,6 +92,9 @@ export interface SimulateOrderRiskRequest {
     leverage: string;
     reduceOnly?: boolean;
 }
+export interface SimulateAutoMarginOrderRiskRequest extends SimulateOrderRiskRequest {
+    strategyKey?: string;
+}
 export interface SimulateOrderRiskResponse {
     accepted: boolean;
     reject_reason?: string;
@@ -111,13 +109,12 @@ export interface SimulateOrderRiskResponse {
 }
 export interface MarginAccountsAPI extends BaseAPI {
     listMarginAccounts(params?: ListMarginAccountsParams): Promise<ListMarginAccountsResponse>;
-    createMarginAccount(request?: CreateMarginAccountRequest): Promise<CreateMarginAccountResponse>;
-    getMarginAccountSummary(marginAccountId: string): Promise<MarginAccountSummary>;
+    getMarginAccountSummary(marginAccountId: string, params?: GetMarginAccountSummaryParams): Promise<MarginAccountSummary>;
     getAvailableCollateral(params?: GetAvailableCollateralParams): Promise<GetAvailableCollateralResponse>;
     transferCollateralToMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
     transferCollateralToAutoMarginAccount(request: TransferCollateralToAutoMarginAccountRequest): Promise<TransferCollateralResponse>;
     transferCollateralFromMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
     getMarginAccountMovements(marginAccountId: string, params?: GetMarginAccountMovementsParams): Promise<GetMarginAccountMovementsResponse>;
     simulateOrderRisk(marginAccountId: string, request: SimulateOrderRiskRequest): Promise<SimulateOrderRiskResponse>;
-    simulateAutoMarginOrderRisk(request: SimulateOrderRiskRequest): Promise<SimulateOrderRiskResponse>;
+    simulateAutoMarginOrderRisk(request: SimulateAutoMarginOrderRiskRequest): Promise<SimulateOrderRiskResponse>;
 }

package/dist/market/index.d.ts

@@ -46,6 +46,10 @@ export interface TradingPair {
     max_order_size: string;
     /** Tick size for price increments */
     tick_size: string;
+    /** Minimum supported leverage for margin markets (optional, margin only) */
+    min_leverage?: string | null;
+    /** Maximum supported leverage for margin markets (optional, margin only) */
+    max_leverage?: string | null;
 }
 /**
  * OHLCV candlestick data point (matches API response format)
@@ -139,6 +143,71 @@ export interface GetTradingPairsResponse {
 export interface GetTradingPairResponse {
     trading_pair: TradingPair;
 }
+/**
+ * Query parameters for the market screener
+ */
+export interface GetScreenerParams {
+    /** Page number (min 1, default 1) */
+    page?: number;
+    /** Items per page (min 1, max 100, default 50) */
+    page_size?: number;
+    /** Filter by market type: SPOT or MARGIN */
+    market_type?: string;
+    /** Filter by active status */
+    is_active?: boolean;
+}
+/**
+ * One UTC-day bucket in a pair's 7-day screener snapshot
+ */
+export interface ScreenerSnapshotPoint {
+    /** UTC day boundary (ms since epoch, as string) */
+    bucket_start: string;
+    /** Quote-token volume for the day */
+    quote_volume: string;
+    /** Percent price change (close - open) / open * 100 for the day */
+    price_change_percent: string;
+}
+/**
+ * Per-pair screener row. Window fields are null when there is insufficient history.
+ */
+export interface ScreenerItem {
+    /** Trading pair UUID */
+    trading_pair_id: string;
+    /** Trading pair symbol (e.g. "BTC/USDC") */
+    symbol: string;
+    /** Base token icon URL */
+    base_icon_url: string;
+    /** Quote token icon URL */
+    quote_icon_url: string;
+    /** Most recent close price (null if no trades yet) */
+    last_price: string | null;
+    /** Timestamp of the last candle (ms since epoch, as string; null if no trades yet) */
+    last_price_timestamp: string | null;
+    /** Quote-token volume in the last 1 hour (null if <1h history) */
+    quote_volume_1h: string | null;
+    /** Quote-token volume in the last 24 hours (null if <24h history) */
+    quote_volume_24h: string | null;
+    /** Quote-token volume in the last 7 days (null if <7d history) */
+    quote_volume_7d: string | null;
+    /** Percent price change over the last 1 hour (null if <1h history) */
+    price_change_percent_1h: string | null;
+    /** Percent price change over the last 24 hours (null if <24h history) */
+    price_change_percent_24h: string | null;
+    /** Percent price change over the last 7 days (null if <7d history) */
+    price_change_percent_7d: string | null;
+    /** Up to 7 UTC-day buckets (oldest first); empty when <1 day of history */
+    snapshot_7d: ScreenerSnapshotPoint[];
+}
+/**
+ * Paginated screener response, sorted by quote_volume_24h desc (nulls last)
+ */
+export interface GetScreenerResponse {
+    items: ScreenerItem[];
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+}
 /**
  * API response wrapper for single trading pair
  */
@@ -275,12 +344,26 @@ export interface MarketAPI extends BaseAPI {
      * @returns Promise resolving to paginated response with trading pairs
      */
     getPaginatedTradingPairs(params?: GetTradingPairsParams): Promise<GetTradingPairsResponse>;
+    /**
+     * Fetch a single trading pair by its UUID.
+     * @param tradingPairId - Trading pair UUID
+     * @returns Promise resolving to the trading pair
+     * @throws {APIError} If the pair is not found
+     */
+    getTradingPair(tradingPairId: string): Promise<TradingPair>;
     /**
      * Fetch metadata for a single trading pair by its symbol (e.g. BTC-USDC).
      * @param symbol - Trading pair symbol
      * @returns Promise resolving to trading pair or undefined if not found
      */
     getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+    /**
+     * Fetch the paginated market screener: per-pair price/volume/change windows
+     * (1h, 24h, 7d) plus a 7-day daily snapshot, sorted by 24h quote volume.
+     * @param params - Optional pagination and filter parameters
+     * @returns Promise resolving to the paginated screener response
+     */
+    getScreener(params?: GetScreenerParams): Promise<GetScreenerResponse>;
     /**
      * Fetch historical candlestick data for a trading pair.
      *

package/dist/positions/index.d.ts

@@ -5,6 +5,7 @@ export type ClosePositionType = "MARKET" | "LIMIT" | "IOC";
 export interface Position {
     position_id: string;
     margin_account_id: string;
+    margin_bucket_id?: string;
     trading_pair_id: string;
     side: PositionSide;
     size: string;

package/dist/profile/index.d.ts

@@ -76,6 +76,12 @@ export interface LedgerMovement {
     block_number: number | null;
     /** Transaction timestamp */
     created_at: string | null;
+    /** Asset UUID this movement affects */
+    asset_id?: string | null;
+    /** User UUID who owns this movement */
+    user_id?: string | null;
+    /** Balance UUID this movement affects */
+    balance_id?: string | null;
 }
 /**
  * Ledger entry type for filtering movements.
@@ -190,7 +196,7 @@ export interface AccountBalance {
     available_balance: string;
     /** Locked balance (in orders or pending operations, normalized) */
     locked_balance: string;
-    /** Total balance (available + locked + margin collateral, normalized) */
+    /** Total balance (available + locked, normalized) */
     total_balance: string;
     /** Available balance in raw format (wei) */
     available_balance_raw: string;
@@ -244,6 +250,67 @@ export interface GetUserTradesResponse {
     /** Total number of pages */
     total_pages: number;
 }
+/**
+ * Direction of a funding payment from the user's perspective.
+ */
+export type FundingDirection = "PAID" | "RECEIVED";
+/**
+ * A single funding payment settled against a margin position.
+ */
+export interface FundingPayment {
+    /** Funding payment unique identifier (UUID) */
+    id: string;
+    /** Margin position identifier (UUID) */
+    position_id: string;
+    /** Margin account identifier (UUID) */
+    margin_account_id: string;
+    /** Trading pair identifier (UUID) */
+    trading_pair_id: string;
+    /** Funding rate applied for the epoch (as string to preserve precision) */
+    funding_rate: string;
+    /** Absolute position size at settlement (as string to preserve precision) */
+    position_size: string;
+    /** Signed funding amount; positive means paid, negative means received (as string) */
+    payment_amount: string;
+    /** Funding direction for the user */
+    direction: FundingDirection;
+    /** Funding window start timestamp (ISO 8601), if known */
+    period_start?: string;
+    /** Funding window end timestamp (ISO 8601), if known */
+    period_end?: string;
+    /** Funding payment creation timestamp (ISO 8601), if known */
+    created_at?: string;
+}
+/**
+ * Query parameters for listing funding payments.
+ */
+export interface ListFundingPaymentsParams {
+    /** Page number (starts from 1) */
+    page?: number;
+    /** Number of items per page (max 100) */
+    page_size?: number;
+    /** Filter by trading pair ID (UUID) */
+    trading_pair_id?: string;
+    /** Filter by margin position ID (UUID) */
+    position_id?: string;
+    /** Filter by margin account ID (UUID) */
+    margin_account_id?: string;
+}
+/**
+ * Response from listing funding payments.
+ */
+export interface ListFundingPaymentsResponse {
+    /** List of funding payment records */
+    records: FundingPayment[];
+    /** Current page number */
+    page: number;
+    /** Items per page */
+    page_size: number;
+    /** Total number of matching records */
+    total: number;
+    /** Total number of pages */
+    total_pages: number;
+}
 /**
  * Time period for portfolio stats and chart queries.
  */
@@ -315,6 +382,10 @@ export interface UserProfile {
     maker_fee_bps: number;
     /** Account creation timestamp (ISO string) */
     created_at: string;
+    /** Additional taker fee in basis points contributed by the application (if any) */
+    application_taker_fee_bps?: number;
+    /** Additional maker fee in basis points contributed by the application (if any) */
+    application_maker_fee_bps?: number;
 }
 /**
  * Profile API interface.
@@ -402,4 +473,20 @@ export interface ProfileAPI extends BaseAPI {
      * @throws ValidationError If pagination params (page/limit) are invalid or trading_pair_id is not a valid UUID; this may occur before any network request.
      */
     getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
+    /**
+     * List the current user's funding payment history with pagination and filters.
+     *
+     * Fetches funding payments from the /api/v1/accounts/funding-payments endpoint.
+     * Requires a valid access token to be set.
+     *
+     * @param params - Optional query parameters for pagination and filtering
+     * @param params.page - Page number (starts from 1)
+     * @param params.page_size - Number of items per page (max 100)
+     * @param params.trading_pair_id - Filter by trading pair ID (UUID)
+     * @param params.position_id - Filter by margin position ID (UUID)
+     * @param params.margin_account_id - Filter by margin account ID (UUID)
+     * @returns Promise resolving to paginated funding payments response
+     * @throws ValidationError If pagination params or a UUID filter are invalid; this may occur before any network request.
+     */
+    listFundingPayments(params?: ListFundingPaymentsParams): Promise<ListFundingPaymentsResponse>;
 }

package/dist/sdk/index.d.ts

@@ -1,15 +1,19 @@
 import type { PublicClient, TransactionReceipt, WalletClient } from "viem";
 import type { ApplicationsAPI } from "../applications";
-import type { AuthAPI, AuthState } from "../auth/index";
+import type { AuthAPI, AuthState, SessionCredentials } from "../auth/index";
 import type { DelegatedAgentsAPI } from "../delegated-agents";
+import type { FaucetAPI } from "../faucet";
 import type { FeesAPI } from "../fees";
 import type { MarginAccountsAPI } from "../margin-accounts";
 import type { Interval, MarketAPI } from "../market";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
+import type { SubAccountsAPI } from "../sub-accounts";
 import type { TradingAPI, TradingMode } from "../trading";
 import type { VaultAPI } from "../vault";
 import type { ConditionalOrderEvent, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserBalanceEvent, UserMovementEvent } from "../websocket";
+import type { WhitelistAPI } from "../whitelist";
+import type { WithdrawalsAPI } from "../withdrawals";
 import type { Network } from "./network";
 /**
  * Configuration options for the Monaco SDK.
@@ -29,10 +33,27 @@ export interface SDKConfig {
      * - "mainnet": https://api.monaco.xyz
      *
      * Only "mainnet" uses the Sei mainnet chain. All other networks use Sei testnet.
+     * `network` always selects the chain; supply {@link apiUrl} / {@link wsUrl}
+     * to point the SDK at a gateway that the preset URL doesn't cover.
      */
     network: Network;
     /** RPC URL for Sei blockchain interactions */
     seiRpcUrl: string;
+    /**
+     * Override the API gateway base URL. When set, the SDK sends all HTTP
+     * requests here instead of the {@link network} preset's default URL. Use for
+     * self-hosted gateways or e2e/dev stacks reachable only by a custom host
+     * (e.g. Docker DNS `http://api-gateway:8080`). `network` still selects the
+     * chain. Must be a valid absolute URL.
+     */
+    apiUrl?: string;
+    /**
+     * Override the WebSocket base URL. When set, the SDK connects here instead of
+     * the {@link network} preset's default WS URL. Pair with {@link apiUrl} when
+     * the WS service is reachable at a different host than the API gateway
+     * (e.g. Docker DNS `ws://ws-api:8080/ws`). Must be a valid absolute URL.
+     */
+    wsUrl?: string;
 }
 /**
  * Core SDK interface providing access to all Monaco functionality.
@@ -48,6 +69,8 @@ export interface MonacoSDK {
     delegatedAgents: DelegatedAgentsAPI;
     /** Vault operations API */
     vault: VaultAPI;
+    /** Low-level withdrawals API (initiate + fetch signed calldata) */
+    withdrawals: WithdrawalsAPI;
     /** Trading operations API */
     trading: TradingAPI;
     /** Market metadata API */
@@ -56,6 +79,12 @@ export interface MonacoSDK {
     marginAccounts: MarginAccountsAPI;
     /** Perp position operations API */
     positions: PositionsAPI;
+    /** Sub-account management API */
+    subAccounts: SubAccountsAPI;
+    /** Testnet faucet API */
+    faucet: FaucetAPI;
+    /** Public whitelist (waitlist) submission API */
+    whitelist: WhitelistAPI;
     /** Profile operations API */
     profile: ProfileAPI;
     /** Orderbook REST API for fetching orderbook snapshots */
@@ -86,7 +115,7 @@ export interface MonacoSDK {
         disconnect: () => void;
         isConnected: () => boolean;
         getStatus: () => "connected" | "connecting" | "disconnected" | "reconnecting";
-        setToken: (token: string) => void;
+        setSessionKeypair: (credentials: SessionCredentials | undefined) => void;
         orders: (tradingPairId: string, tradingMode: TradingMode, handler: (event: OrderEvent) => void) => () => void;
         orderbook: (tradingPairId: string, tradingMode: TradingMode, magnitude: number, quotationMode: OrderbookQuotationMode, handler: (event: OrderbookEvent) => void) => () => void;
         ohlcv: (tradingPairId: string, tradingMode: TradingMode, interval: Interval, handler: (event: OHLCVEvent) => void) => () => void;
@@ -108,6 +137,15 @@ export interface MonacoSDK {
     login(clientId: string, options?: {
         connectWebSocket?: boolean;
     }): Promise<AuthState>;
+    /**
+     * Create and adopt an owner-scoped delegated session.
+     *
+     * The current authenticated session must belong to an agent wallet that has
+     * an active delegation from `ownerUserId`. On success, the SDK signs
+     * subsequent requests with the delegated session keypair, so account reads
+     * and trading calls operate on the owner while preserving agent attribution.
+     */
+    loginAsDelegatedOwner(ownerUserId: string): Promise<AuthState>;
     /** Log out the user */
     logout(): Promise<void>;
     /** Refresh the access token */

package/dist/sub-accounts/index.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Sub-Accounts Types
+ *
+ * Types for managing sub-accounts and their per-asset spending limits. All
+ * endpoints are session-authenticated; the limit mutations additionally
+ * require the caller to be a master account with the `ManageSubAccounts`
+ * permission (enforced server-side). Wire shapes are snake_case; optional
+ * fields are `null` rather than omitted.
+ */
+import type { BaseAPI } from "../api";
+import type { AccountBalance } from "../profile";
+/**
+ * A sub-account owned by the authenticated master account, with its balances.
+ */
+export interface SubAccount {
+    /** Sub-account UUID */
+    id: string;
+    /** Sub-account wallet address */
+    address: string;
+    /** Sub-account display username */
+    username: string | null;
+    /** Whether the sub-account is allowed to withdraw */
+    can_withdraw: boolean;
+    /** Account creation timestamp (ISO 8601) */
+    created_at: string;
+    /** Per-asset balances held by the sub-account */
+    balances: AccountBalance[];
+}
+/**
+ * A per-asset spending limit on a sub-account.
+ */
+export interface SubAccountLimit {
+    /** Limit UUID */
+    id: string;
+    /** Sub-account UUID this limit applies to */
+    sub_account_id: string;
+    /** Token contract address */
+    token: string;
+    /** Maximum daily spending limit in token units */
+    daily_limit: string | null;
+    /** Amount used today against the limit */
+    used_today: string;
+    /** Limit creation timestamp (ISO 8601) */
+    created_at: string;
+    /** Last update timestamp (ISO 8601) */
+    updated_at: string | null;
+    /** Master account UUID that owns this sub-account */
+    master_account_id: string;
+    /** Maximum amount allowed in token units */
+    max_amount: string;
+    /** Last reset timestamp for the daily limit (ISO 8601) */
+    last_reset_at: string | null;
+    /** Whether the limit is active */
+    is_active: boolean;
+}
+/**
+ * Body for creating a sub-account limit.
+ */
+export interface CreateSubAccountLimitRequest {
+    /** Sub-account UUID to create the limit for */
+    sub_account_id: string;
+    /** Asset UUID to limit */
+    asset_id: string;
+    /** Maximum amount allowed in token units */
+    max_amount: string;
+    /** Maximum daily spending limit in token units */
+    daily_limit?: string;
+}
+/**
+ * Body for updating a sub-account limit. The sub-account and asset are taken
+ * from the path; all body fields are optional (partial update).
+ */
+export interface UpdateSubAccountLimitBody {
+    /** New maximum amount allowed in token units */
+    max_amount?: string;
+    /** New maximum daily spending limit in token units */
+    daily_limit?: string;
+    /** Whether the limit is active */
+    is_active?: boolean;
+}
+/** Paginated list of the master account's sub-accounts. */
+export interface ListSubAccountsResponse {
+    sub_accounts: SubAccount[];
+    /** Total number of sub-accounts */
+    total: number;
+}
+/** Response wrapping a single created limit. */
+export interface CreateSubAccountLimitResponse {
+    limit: SubAccountLimit;
+}
+/** Response wrapping a single updated limit. */
+export interface UpdateSubAccountLimitResponse {
+    limit: SubAccountLimit;
+}
+/** Response wrapping a sub-account's limits. */
+export interface GetSubAccountLimitsResponse {
+    limits: SubAccountLimit[];
+}
+/**
+ * Sub-accounts API interface.
+ *
+ * `list` and `getLimits` need only session auth; `createLimit`, `updateLimit`,
+ * and `deleteLimit` additionally require the master account to hold the
+ * `ManageSubAccounts` permission (enforced server-side — a non-master or
+ * unpermissioned caller gets a 403).
+ */
+export interface SubAccountsAPI extends BaseAPI {
+    /**
+     * Lists the authenticated master account's sub-accounts with balances.
+     *
+     * @returns Promise resolving to the sub-accounts and total count
+     */
+    list(): Promise<ListSubAccountsResponse>;
+    /**
+     * Creates a per-asset spending limit on a sub-account.
+     *
+     * @param body - Sub-account, asset, max amount, and optional daily limit
+     * @returns Promise resolving to the created limit
+     */
+    createLimit(body: CreateSubAccountLimitRequest): Promise<CreateSubAccountLimitResponse>;
+    /**
+     * Gets the limits configured for a sub-account.
+     *
+     * @param subAccountId - Sub-account UUID
+     * @returns Promise resolving to the sub-account's limits
+     */
+    getLimits(subAccountId: string): Promise<GetSubAccountLimitsResponse>;
+    /**
+     * Updates a sub-account's per-asset limit (partial update).
+     *
+     * @param subAccountId - Sub-account UUID
+     * @param assetId - Asset UUID
+     * @param body - Fields to update
+     * @returns Promise resolving to the updated limit
+     */
+    updateLimit(subAccountId: string, assetId: string, body: UpdateSubAccountLimitBody): Promise<UpdateSubAccountLimitResponse>;
+    /**
+     * Deletes a sub-account's per-asset limit.
+     *
+     * @param subAccountId - Sub-account UUID
+     * @param assetId - Asset UUID
+     * @returns Promise resolving when the limit is deleted
+     */
+    deleteLimit(subAccountId: string, assetId: string): Promise<void>;
+}

package/dist/sub-accounts/index.js

@@ -0,0 +1,9 @@
+/**
+ * Sub-Accounts Types
+ *
+ * Types for managing sub-accounts and their per-asset spending limits. All
+ * endpoints are session-authenticated; the limit mutations additionally
+ * require the caller to be a master account with the `ManageSubAccounts`
+ * permission (enforced server-side). Wire shapes are snake_case; optional
+ * fields are `null` rather than omitted.
+ */