@upshiftfinance/sdk 0.0.0-stage → 0.1.0

package/lib/modules/sub-accounts/fetcher.d.ts

@@ -0,0 +1,53 @@
+import { type IFetchUpshiftOptions } from '../../core';
+import type { IAddress, ILoanBookInfo, IOTCPosition, ISubaccountDebank, ISubaccountTransaction, IWSSubaccountCefi, IWSSubAccountHealthFactor, IWSSubaccountListItem, IWSSubaccountLoan, IWSSubaccountSummary } from '../../types';
+/**
+ * Fetch one page of the subaccount directory (admin-only backend endpoint)
+ */
+export declare const fetchAllSubaccounts: (pagination: {
+    offset?: number;
+    limit?: number;
+}, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IWSSubaccountListItem[]>;
+/**
+ * Fetch a subaccount's transaction history (authenticated `GET
+ * /transactions/v2`), optionally windowed by ISO-8601 start/end datetimes.
+ */
+export declare const fetchSubaccountTransactions: (payload: {
+    address: IAddress;
+    startTime?: string;
+    endTime?: string;
+}, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<ISubaccountTransaction[]>;
+/**
+ * Fetch a single loan's loan-book detail by loan address + chain
+ * (admin-only `GET /subaccount/loans/{loan_address}`).
+ */
+export declare const fetchSubaccountLoanByAddress: (loanAddress: string, chainId: number, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<ILoanBookInfo>;
+/**
+ * Fetch cross-chain DeBank positions for a subaccount (`GET
+ * /subaccount/{subaccount_address}/debank`). Slow endpoint (300-second
+ * server-side cache) — it fans out across every supported chain.
+ */
+export declare const fetchSubaccountDebank: (address: IAddress, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<ISubaccountDebank>;
+/**
+ * Fetch subaccount health factor for a given subaccount address
+ */
+export declare const fetchSubaccountHeathFactor: (address: IAddress, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IWSSubAccountHealthFactor>;
+/**
+ * Fetch subaccount loans details
+ */
+export declare const fetchSubaccountLoans: (payload: {
+    address: IAddress;
+    side?: "BOTH" | "BORROWER" | "LENDER";
+    active?: boolean;
+}, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IWSSubaccountLoan[]>;
+/**
+ * Fetch the subaccount CeFi positions
+ */
+export declare const fetchSubaccountCefiPositions: (address: IAddress, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IWSSubaccountCefi[]>;
+/**
+ * Fetch the subaccount OTC positions
+ */
+export declare const fetchSubaccountOtcPositions: (address: IAddress, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IOTCPosition[]>;
+/**
+ * Fetch the subaccount summary view
+ */
+export declare const fetchSubaccountSummary: (address: IAddress, upshiftKey: string, headers?: IFetchUpshiftOptions["headers"]) => Promise<IWSSubaccountSummary>;

package/lib/modules/sub-accounts/fetcher.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSubaccountSummary = exports.fetchSubaccountOtcPositions = exports.fetchSubaccountCefiPositions = exports.fetchSubaccountLoans = exports.fetchSubaccountHeathFactor = exports.fetchSubaccountDebank = exports.fetchSubaccountLoanByAddress = exports.fetchSubaccountTransactions = exports.fetchAllSubaccounts = void 0;
+const core_1 = require("../../core");
+/**
+ * Fetch one page of the subaccount directory (admin-only backend endpoint)
+ */
+const fetchAllSubaccounts = async (pagination, upshiftKey, headers) => {
+    // fetchUpshiftWithKey throws a typed UpshiftSDKError (via
+    // errorFromResponseStatus) on any non-2xx response, so a returned
+    // response is always ok.
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.list(pagination.offset, pagination.limit), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchAllSubaccounts = fetchAllSubaccounts;
+/**
+ * Fetch a subaccount's transaction history (authenticated `GET
+ * /transactions/v2`), optionally windowed by ISO-8601 start/end datetimes.
+ */
+const fetchSubaccountTransactions = async (payload, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.transactions.v2(payload.address, payload.startTime, payload.endTime), { headers });
+    return response.json();
+};
+exports.fetchSubaccountTransactions = fetchSubaccountTransactions;
+/**
+ * Fetch a single loan's loan-book detail by loan address + chain
+ * (admin-only `GET /subaccount/loans/{loan_address}`).
+ */
+const fetchSubaccountLoanByAddress = async (loanAddress, chainId, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.loanByAddress(loanAddress, chainId), { headers });
+    return response.json();
+};
+exports.fetchSubaccountLoanByAddress = fetchSubaccountLoanByAddress;
+/**
+ * Fetch cross-chain DeBank positions for a subaccount (`GET
+ * /subaccount/{subaccount_address}/debank`). Slow endpoint (300-second
+ * server-side cache) — it fans out across every supported chain.
+ */
+const fetchSubaccountDebank = async (address, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.debank(address), { headers });
+    return response.json();
+};
+exports.fetchSubaccountDebank = fetchSubaccountDebank;
+/**
+ * Fetch subaccount health factor for a given subaccount address
+ */
+const fetchSubaccountHeathFactor = async (address, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.health_factor(address), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchSubaccountHeathFactor = fetchSubaccountHeathFactor;
+/**
+ * Fetch subaccount loans details
+ */
+const fetchSubaccountLoans = async (payload, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.loans(payload.address, payload.side, payload.active), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchSubaccountLoans = fetchSubaccountLoans;
+/**
+ * Fetch the subaccount CeFi positions
+ */
+const fetchSubaccountCefiPositions = async (address, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.cefi(address), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchSubaccountCefiPositions = fetchSubaccountCefiPositions;
+/**
+ * Fetch the subaccount OTC positions
+ */
+const fetchSubaccountOtcPositions = async (address, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.otc_positions(address), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchSubaccountOtcPositions = fetchSubaccountOtcPositions;
+/**
+ * Fetch the subaccount summary view
+ */
+const fetchSubaccountSummary = async (address, upshiftKey, headers) => {
+    const response = await (0, core_1.fetchUpshiftWithKey)(upshiftKey, core_1.WEBSERVER_ENDPOINTS.subaccount.summary(address), {
+        headers,
+    });
+    return response.json();
+};
+exports.fetchSubaccountSummary = fetchSubaccountSummary;
+//# sourceMappingURL=fetcher.js.map

package/lib/modules/sub-accounts/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fetcher';
+export * from './main';

package/lib/modules/sub-accounts/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fetcher"), exports);
+__exportStar(require("./main"), exports);
+//# sourceMappingURL=index.js.map

package/lib/modules/sub-accounts/main.d.ts

@@ -0,0 +1,249 @@
+import { UpshiftBase, type IUpshiftBase } from '../../core';
+import type { IAddress, ILoanBookInfo, ISubaccountDebank, ISubaccountTransaction, IWSSubaccountListItem } from '../../types';
+/**
+ * Subaccount operation class interacting with Upshift Subaccounts
+ * Subaccount is a smart contract wallet that serves as the fundamental infrastructure for Upshift's platform.
+ * It functions as a cross-margin account designed for optimal capital efficiency.
+ *
+ * `getSubaccountSummary`, `getSubaccountHealthFactor`, `getSubaccountLoans`,
+ * `getSubaccountCefiPositions` and `getSubaccountOtcPositions` work without an
+ * Upshift API key for subaccounts linked to a vault; `getSubaccountDebank` is
+ * public. `getSubaccountTransactions` needs a key authorized for the
+ * subaccount, and `getAllSubaccounts` and `getSubaccountLoanByAddress` need an
+ * admin key.
+ */
+export declare class UpshiftSubAccounts extends UpshiftBase {
+    private headers;
+    constructor(baseConfig: IUpshiftBase);
+    /**
+     * Retrieves one page of the directory of all Upshift subaccounts.
+     *
+     * Backed by the admin-only `GET /subaccount` backend endpoint, so the
+     * Upshift API key configured on the SDK must belong to an admin user —
+     * non-admin keys are rejected with an auth error by the backend. Makes
+     * exactly one HTTP request and no RPC calls.
+     *
+     * @param options - Pagination window over the subaccount directory
+     * @param options.offset - Number of records to skip. Defaults to 0; must be a non-negative integer.
+     * @param options.limit - Page size. Defaults to 100; must be an integer between 1 and 1000 (backend maximum).
+     * @returns The page of subaccount records (address, internal/friendly names, status, type, linked chains, risk metadata). An empty array means the offset is past the end of the directory.
+     * @throws UpshiftValidationError when `offset` or `limit` is out of range
+     * @throws UpshiftAuthError when the API key is missing or not admin-scoped
+     * @example
+     *   const page = await upshiftSdk.subAccountsModule.getAllSubaccounts({
+     *     offset: 0,
+     *     limit: 200,
+     *   });
+     *   console.log(page.map((s) => `${s.internal_name}: ${s.address}`));
+     */
+    getAllSubaccounts(options?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<IWSSubaccountListItem[]>;
+    /**
+     * Retrieves the health factor for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The health factor data including collateral value, loan value, and health factor ratio
+     */
+    getSubaccountHealthFactor(subaccountAddress: IAddress): Promise<{
+        id: `0x${string}`;
+        dateTime: string;
+        healthFactor: number;
+        totalCollateral: number;
+        totalLoan: number;
+    }>;
+    /**
+     * Retrieves loan positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @param side - Filter by loan side: 'BOTH' for all loans, 'LENDER' for lent positions, 'BORROWER' for borrowed positions
+     * @param active - When true, returns only active loans; when false, returns all loans including closed ones
+     * @returns List of loan positions matching the specified filters
+     */
+    getSubaccountLoans(subaccountAddress: IAddress, side: 'BOTH' | 'LENDER' | 'BORROWER', active: boolean): Promise<import("../../types").IWSSubaccountLoan[]>;
+    /**
+     * Retrieves CeFi (Centralized Finance) positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns List of CeFi positions held by the subaccount
+     */
+    getSubaccountCefiPositions(subaccountAddress: IAddress): Promise<import("../../types").IWSSubaccountCefi[]>;
+    /**
+     * Retrieves OTC (Over-The-Counter) positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns List of OTC positions held by the subaccount
+     */
+    getSubaccountOtcPositions(subaccountAddress: IAddress): Promise<import("../../types").IOTCPosition[]>;
+    /**
+     * Retrieves the summary view for a subaccount or EOA operator.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The full summary including portfolio, loanbook, tokens, and account values
+     */
+    getSubaccountSummary(subaccountAddress: IAddress): Promise<{
+        address: `0x${string}`;
+        name: string;
+        type: "eoa" | "subaccount";
+        portfolio: {
+            tokens: {
+                value: number;
+                balance: number;
+                token: {
+                    type: string;
+                    name: string;
+                    address: string;
+                    chain: number;
+                    symbol: string;
+                    decimals: number;
+                    imgUrl: string;
+                };
+            }[];
+            marginBalances: unknown[];
+            collateralBalances: unknown[];
+            cefiPositions: unknown[];
+            defiPositions: unknown[];
+            trsPositions: unknown[];
+            strategyContractPositions: unknown[];
+            legacyHedgerPositions: unknown[];
+            otcPositions: unknown[];
+            totalValue: number;
+            discountedValue: number;
+        };
+        loanbook: {
+            loans: {
+                subaccountAddress: `0x${string}`;
+                book: {
+                    address: `0x${string}`;
+                    lender: `0x${string}`;
+                    borrower: `0x${string}`;
+                    state: string;
+                    totalRepaid: number;
+                    principalToken: {
+                        type: string;
+                        name: string;
+                        address: string;
+                        chain: number;
+                        symbol: string;
+                        decimals: number;
+                        imgUrl: string;
+                        tokenType: number;
+                        discountFactor: number;
+                        price: number;
+                    };
+                    principalAmount: number;
+                    interestAmount: number;
+                    upcomingPayment: {
+                        amount: number;
+                        dueDate: string;
+                    };
+                    apr: number;
+                    initialPrincipalAmount: number;
+                    deployedDate: string;
+                    paymentInterval: number;
+                    totalInterestPaymentFees: number;
+                };
+                isBorrow: boolean;
+                debtInfo: {
+                    interestOwed: number;
+                    principalDebtOwed: number;
+                    interestRepaid: number;
+                };
+                creditInfo: {
+                    netInterestOwed: number;
+                    principalDebtOwed: number;
+                    netInterestRepaid: number;
+                };
+            }[];
+            totalDebt: number;
+            totalCredit: number;
+            aggregatesByToken: unknown[];
+        };
+        chains: {
+            name: string;
+            chainId: number;
+        }[];
+        tokens: {
+            type: string;
+            name: string;
+            address: string;
+            chain: number;
+            symbol: string;
+            decimals: number;
+            imgUrl: string;
+            price: number;
+            rawBalance: number;
+            balance: number;
+            value: number;
+        }[];
+        totalAccountValue: number;
+        totalCollateralValue: number;
+        totalLoanValue: number;
+        healthFactor: number;
+        netAccountValue: number;
+        totalEquityValue: number;
+    }>;
+    /**
+     * Retrieves a subaccount's on-chain transaction history, newest first,
+     * optionally windowed by a time range.
+     *
+     * Backed by the authenticated `GET /transactions/v2` backend endpoint,
+     * which resolves and authorizes the subaccount, so the configured Upshift
+     * API key must be authorized for it (an admin-scoped key always is). Makes
+     * exactly one HTTP request and no RPC calls.
+     *
+     * @param subaccountAddress - The address of the subaccount to query
+     * @param options - Optional time window
+     * @param options.startTime - ISO-8601 datetime lower bound (inclusive); omit for no lower bound
+     * @param options.endTime - ISO-8601 datetime upper bound (inclusive); omit for no upper bound
+     * @returns The subaccount's transactions with decoded logs, transfers, and function names
+     * @throws UpshiftValidationError When `subaccountAddress` is not a valid EVM address
+     * @throws UpshiftAuthError When the API key is missing or not authorized for the subaccount
+     * @throws UpshiftServerError When the API responds with a non-2xx status
+     * @example
+     *   const txs = await upshiftSdk.subAccountsModule.getSubaccountTransactions(
+     *     '0xabc…',
+     *     { startTime: '2026-01-01T00:00:00Z' },
+     *   );
+     */
+    getSubaccountTransactions(subaccountAddress: IAddress, options?: {
+        startTime?: string;
+        endTime?: string;
+    }): Promise<ISubaccountTransaction[]>;
+    /**
+     * Retrieves the full loan-book detail for a single loan by its address and
+     * chain.
+     *
+     * Backed by the admin-only `GET /subaccount/loans/{loan_address}` backend
+     * endpoint (60-second server-side cache), so the configured Upshift API key
+     * must belong to an admin user. Makes exactly one HTTP request and no RPC
+     * calls.
+     *
+     * @param loanAddress - The loan contract address
+     * @param chainId - Numeric Upshift chain id the loan lives on (e.g. `1` for Ethereum mainnet)
+     * @returns The loan's {@link ILoanBookInfo} detail
+     * @throws UpshiftValidationError When `chainId` is not an integer
+     * @throws UpshiftAuthError When the API key is missing or not admin-scoped
+     * @throws UpshiftServerError When the loan or chain is not found, or the API otherwise responds non-2xx
+     * @example
+     *   const loan = await upshiftSdk.subAccountsModule.getSubaccountLoanByAddress(
+     *     '0xloan…',
+     *     1,
+     *   );
+     */
+    getSubaccountLoanByAddress(loanAddress: string, chainId: number): Promise<ILoanBookInfo>;
+    /**
+     * Retrieves cross-chain DeBank protocol positions and token balances for a
+     * subaccount and its associated strategies.
+     *
+     * Backed by `GET /subaccount/{subaccount_address}/debank` (300-second
+     * server-side cache). This is a slow endpoint — it fans out to DeBank
+     * across every supported chain — so expect higher latency than other
+     * subaccount reads. Makes exactly one HTTP request and no RPC calls.
+     *
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The subaccount's DeBank positions/tokens plus per-strategy breakdowns
+     * @throws UpshiftValidationError When `subaccountAddress` is not a valid EVM address
+     * @throws UpshiftServerError When the API responds with a non-2xx status
+     * @example
+     *   const debank = await upshiftSdk.subAccountsModule.getSubaccountDebank('0xabc…');
+     *   console.log(debank.subaccount.positions.length);
+     */
+    getSubaccountDebank(subaccountAddress: IAddress): Promise<ISubaccountDebank>;
+}

package/lib/modules/sub-accounts/main.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpshiftSubAccounts = void 0;
+/**
+ * The Upshift Sub Accounts Module.
+ *
+ * @module UpshiftSubAccounts
+ */
+const fetcher_1 = require("./fetcher");
+const ethers_1 = require("ethers");
+const utils_1 = require("./utils");
+const core_1 = require("../../core");
+/**
+ * Validates that a subaccount address is a well-formed EVM address, throwing a
+ * typed {@link UpshiftValidationError} if not. Upshift subaccounts are EVM
+ * smart-contract wallets, so an invalid value should fail fast in the SDK
+ * rather than reaching the backend.
+ */
+function assertSubaccountAddress(address, method) {
+    if (typeof address !== 'string' || !(0, ethers_1.isAddress)(address)) {
+        throw new core_1.UpshiftValidationError('INVALID_ADDRESS', `${method}: "${address}" is not a valid subaccount address — pass the subaccount's EVM (0x…) address.`);
+    }
+}
+/**
+ * Subaccount operation class interacting with Upshift Subaccounts
+ * Subaccount is a smart contract wallet that serves as the fundamental infrastructure for Upshift's platform.
+ * It functions as a cross-margin account designed for optimal capital efficiency.
+ *
+ * `getSubaccountSummary`, `getSubaccountHealthFactor`, `getSubaccountLoans`,
+ * `getSubaccountCefiPositions` and `getSubaccountOtcPositions` work without an
+ * Upshift API key for subaccounts linked to a vault; `getSubaccountDebank` is
+ * public. `getSubaccountTransactions` needs a key authorized for the
+ * subaccount, and `getAllSubaccounts` and `getSubaccountLoanByAddress` need an
+ * admin key.
+ */
+class UpshiftSubAccounts extends core_1.UpshiftBase {
+    headers = null;
+    constructor(baseConfig) {
+        super(baseConfig);
+        this.headers = {
+            'x-environment': this.monitoring?.['x-environment'],
+            'x-user-id': this.monitoring?.['x-user-id'],
+        };
+    }
+    /**
+     * Retrieves one page of the directory of all Upshift subaccounts.
+     *
+     * Backed by the admin-only `GET /subaccount` backend endpoint, so the
+     * Upshift API key configured on the SDK must belong to an admin user —
+     * non-admin keys are rejected with an auth error by the backend. Makes
+     * exactly one HTTP request and no RPC calls.
+     *
+     * @param options - Pagination window over the subaccount directory
+     * @param options.offset - Number of records to skip. Defaults to 0; must be a non-negative integer.
+     * @param options.limit - Page size. Defaults to 100; must be an integer between 1 and 1000 (backend maximum).
+     * @returns The page of subaccount records (address, internal/friendly names, status, type, linked chains, risk metadata). An empty array means the offset is past the end of the directory.
+     * @throws UpshiftValidationError when `offset` or `limit` is out of range
+     * @throws UpshiftAuthError when the API key is missing or not admin-scoped
+     * @example
+     *   const page = await upshiftSdk.subAccountsModule.getAllSubaccounts({
+     *     offset: 0,
+     *     limit: 200,
+     *   });
+     *   console.log(page.map((s) => `${s.internal_name}: ${s.address}`));
+     */
+    async getAllSubaccounts(options = {}) {
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? 100;
+        if (!Number.isInteger(offset) || offset < 0) {
+            throw new core_1.UpshiftValidationError('INVALID_INPUT', `getAllSubaccounts: offset must be a non-negative integer, got ${offset}`);
+        }
+        if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
+            throw new core_1.UpshiftValidationError('INVALID_INPUT', `getAllSubaccounts: limit must be an integer between 1 and 1000, got ${limit}`);
+        }
+        return (0, fetcher_1.fetchAllSubaccounts)({ offset, limit }, this.keys.upshift, this.headers);
+    }
+    /**
+     * Retrieves the health factor for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The health factor data including collateral value, loan value, and health factor ratio
+     */
+    async getSubaccountHealthFactor(subaccountAddress) {
+        const response = await (0, fetcher_1.fetchSubaccountHeathFactor)(subaccountAddress, this.keys.upshift, this.headers);
+        return {
+            id: response.id,
+            dateTime: response.datetime,
+            healthFactor: response.health_factor,
+            totalCollateral: response.total_collateral_value,
+            totalLoan: response.total_loan_value,
+        };
+    }
+    /**
+     * Retrieves loan positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @param side - Filter by loan side: 'BOTH' for all loans, 'LENDER' for lent positions, 'BORROWER' for borrowed positions
+     * @param active - When true, returns only active loans; when false, returns all loans including closed ones
+     * @returns List of loan positions matching the specified filters
+     */
+    async getSubaccountLoans(subaccountAddress, side, active) {
+        const response = await (0, fetcher_1.fetchSubaccountLoans)({ address: subaccountAddress, active, side }, this.keys.upshift, this.headers);
+        return response;
+    }
+    /**
+     * Retrieves CeFi (Centralized Finance) positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns List of CeFi positions held by the subaccount
+     */
+    async getSubaccountCefiPositions(subaccountAddress) {
+        const response = await (0, fetcher_1.fetchSubaccountCefiPositions)(subaccountAddress, this.keys.upshift, this.headers);
+        return response;
+    }
+    /**
+     * Retrieves OTC (Over-The-Counter) positions for a subaccount.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns List of OTC positions held by the subaccount
+     */
+    async getSubaccountOtcPositions(subaccountAddress) {
+        const response = await (0, fetcher_1.fetchSubaccountOtcPositions)(subaccountAddress, this.keys.upshift, this.headers);
+        return response;
+    }
+    /**
+     * Retrieves the summary view for a subaccount or EOA operator.
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The full summary including portfolio, loanbook, tokens, and account values
+     */
+    async getSubaccountSummary(subaccountAddress) {
+        const response = await (0, fetcher_1.fetchSubaccountSummary)(subaccountAddress, this.keys.upshift, this.headers);
+        return (0, utils_1.transformSubaccountSummary)(response);
+    }
+    /**
+     * Retrieves a subaccount's on-chain transaction history, newest first,
+     * optionally windowed by a time range.
+     *
+     * Backed by the authenticated `GET /transactions/v2` backend endpoint,
+     * which resolves and authorizes the subaccount, so the configured Upshift
+     * API key must be authorized for it (an admin-scoped key always is). Makes
+     * exactly one HTTP request and no RPC calls.
+     *
+     * @param subaccountAddress - The address of the subaccount to query
+     * @param options - Optional time window
+     * @param options.startTime - ISO-8601 datetime lower bound (inclusive); omit for no lower bound
+     * @param options.endTime - ISO-8601 datetime upper bound (inclusive); omit for no upper bound
+     * @returns The subaccount's transactions with decoded logs, transfers, and function names
+     * @throws UpshiftValidationError When `subaccountAddress` is not a valid EVM address
+     * @throws UpshiftAuthError When the API key is missing or not authorized for the subaccount
+     * @throws UpshiftServerError When the API responds with a non-2xx status
+     * @example
+     *   const txs = await upshiftSdk.subAccountsModule.getSubaccountTransactions(
+     *     '0xabc…',
+     *     { startTime: '2026-01-01T00:00:00Z' },
+     *   );
+     */
+    async getSubaccountTransactions(subaccountAddress, options = {}) {
+        assertSubaccountAddress(subaccountAddress, 'getSubaccountTransactions');
+        return (0, fetcher_1.fetchSubaccountTransactions)({
+            address: subaccountAddress,
+            startTime: options.startTime,
+            endTime: options.endTime,
+        }, this.keys.upshift, this.headers);
+    }
+    /**
+     * Retrieves the full loan-book detail for a single loan by its address and
+     * chain.
+     *
+     * Backed by the admin-only `GET /subaccount/loans/{loan_address}` backend
+     * endpoint (60-second server-side cache), so the configured Upshift API key
+     * must belong to an admin user. Makes exactly one HTTP request and no RPC
+     * calls.
+     *
+     * @param loanAddress - The loan contract address
+     * @param chainId - Numeric Upshift chain id the loan lives on (e.g. `1` for Ethereum mainnet)
+     * @returns The loan's {@link ILoanBookInfo} detail
+     * @throws UpshiftValidationError When `chainId` is not an integer
+     * @throws UpshiftAuthError When the API key is missing or not admin-scoped
+     * @throws UpshiftServerError When the loan or chain is not found, or the API otherwise responds non-2xx
+     * @example
+     *   const loan = await upshiftSdk.subAccountsModule.getSubaccountLoanByAddress(
+     *     '0xloan…',
+     *     1,
+     *   );
+     */
+    async getSubaccountLoanByAddress(loanAddress, chainId) {
+        if (!Number.isInteger(chainId)) {
+            throw new core_1.UpshiftValidationError('INVALID_CHAIN', `getSubaccountLoanByAddress: chainId must be an integer Upshift chain id, got ${chainId}.`);
+        }
+        return (0, fetcher_1.fetchSubaccountLoanByAddress)(loanAddress, chainId, this.keys.upshift, this.headers);
+    }
+    /**
+     * Retrieves cross-chain DeBank protocol positions and token balances for a
+     * subaccount and its associated strategies.
+     *
+     * Backed by `GET /subaccount/{subaccount_address}/debank` (300-second
+     * server-side cache). This is a slow endpoint — it fans out to DeBank
+     * across every supported chain — so expect higher latency than other
+     * subaccount reads. Makes exactly one HTTP request and no RPC calls.
+     *
+     * @param subaccountAddress - The address of the subaccount to query
+     * @returns The subaccount's DeBank positions/tokens plus per-strategy breakdowns
+     * @throws UpshiftValidationError When `subaccountAddress` is not a valid EVM address
+     * @throws UpshiftServerError When the API responds with a non-2xx status
+     * @example
+     *   const debank = await upshiftSdk.subAccountsModule.getSubaccountDebank('0xabc…');
+     *   console.log(debank.subaccount.positions.length);
+     */
+    async getSubaccountDebank(subaccountAddress) {
+        assertSubaccountAddress(subaccountAddress, 'getSubaccountDebank');
+        return (0, fetcher_1.fetchSubaccountDebank)(subaccountAddress, this.keys.upshift, this.headers);
+    }
+}
+exports.UpshiftSubAccounts = UpshiftSubAccounts;
+//# sourceMappingURL=main.js.map