@liquidium/client 0.3.4 → 0.4.0

package/dist/index.d.ts

@@ -87,17 +87,10 @@ type SupplyAction = (typeof SupplyAction)[keyof typeof SupplyAction];
 declare const OutflowType: {
     readonly borrow: "borrow";
     readonly feeClaim: "feeClaim";
-    readonly withdraw: "withdraw";
+    readonly withdrawal: "withdrawal";
 };
 /** Outflow operation reported by the lending canister. */
 type OutflowType = (typeof OutflowType)[keyof typeof OutflowType];
-/** Inflow submit type expected by the SDK API. */
-declare const InflowSubmitType: {
-    readonly DEPOSIT: "DEPOSIT";
-    readonly REPAY: "REPAY";
-};
-/** Inflow submit type expected by the SDK API. */
-type InflowSubmitType = (typeof InflowSubmitType)[keyof typeof InflowSubmitType];
 /** Wallet address and chain pair linked to a Liquidium profile. */
 interface Wallet {
     /** Chain where the wallet address is valid. */
@@ -205,12 +198,12 @@ interface SendBtcTransactionRequest {
  * - `signMessage` - account creation, borrow, withdraw
  * - `sendBtcTransaction` / `sendEthTransaction` - automated transfer-path supply
  * - `sendEthTransaction` - contract-interaction supply and ETH native sends
- * - `signPsbt` - reserved for PSBT-based actions when exposed
+ * - `signPsbt` - reserved; no current SDK flow emits PSBT-signing actions
  */
 interface WalletAdapter {
     /** Signs an SDK plaintext message and returns the wallet signature. BTC adapters may return base64 BIP-322 or hex-encoded signature bytes. */
     signMessage?: (request: SignMessageRequest) => Promise<string>;
-    /** Signs an SDK-provided BTC PSBT and returns the signed PSBT as base64. */
+    /** Reserved for future PSBT-signing flows; no current SDK method calls this. */
     signPsbt?: (request: SignPsbtRequest) => Promise<string>;
     /** Sends an EVM transaction and returns its transaction hash. */
     sendEthTransaction?: (request: SendEthTransactionRequest) => Promise<string>;
@@ -239,7 +232,7 @@ interface SendEthTransactionSubmitRequest {
 /** Prepared action that requires message signing before submit. */
 interface SignMessageWalletAction<TData, TResult> {
     /** Protocol action kind. */
-    kind: string;
+    kind: WalletActionKind;
     /** Wallet capability required to execute the action. */
     executionKind: typeof WalletExecutionKind.signMessage;
     /** Adapter-facing action type. */
@@ -255,10 +248,10 @@ interface SignMessageWalletAction<TData, TResult> {
     /** Submits the signature and resolves the protocol result. */
     submit(signatureInfo: SignatureInfo): Promise<TResult>;
 }
-/** Prepared action that requires BTC PSBT signing before submit. */
+/** Reserved prepared action for future BTC PSBT-signing flows. */
 interface SignPsbtWalletAction<TResult> {
     /** Protocol action kind. */
-    kind: string;
+    kind: WalletActionKind;
     /** Wallet capability required to execute the action. */
     executionKind: typeof WalletExecutionKind.signPsbt;
     /** Adapter-facing action type. */
@@ -275,7 +268,7 @@ interface SignPsbtWalletAction<TResult> {
 /** Prepared action that requires sending an ETH transaction before submit. */
 interface SendEthTransactionWalletAction<TResult> {
     /** Protocol action kind. */
-    kind: string;
+    kind: WalletActionKind;
     /** Wallet capability required to execute the action. */
     executionKind: typeof WalletExecutionKind.sendEthTransaction;
     /** Adapter-facing action type. */
@@ -385,42 +378,30 @@ interface ApiClient {
     post<TResponse, TBody>(path: string, body: TBody): Promise<TResponse>;
 }
 
-/** Activity list state filter. */
+/** Lifecycle operation represented by a Liquidium status. */
+type LiquidiumOperation = "deposit" | "borrow" | "repayment" | "withdrawal" | "liquidation";
+/** Lifecycle state represented by a Liquidium status. */
+type LiquidiumState = "action_required" | "confirming" | "processing" | "active" | "completed" | "failed" | "expired";
+/** Shared lifecycle status returned by SDK methods that expose flow state. */
+interface LiquidiumStatus {
+    /** Operation currently represented by the status. */
+    operation: LiquidiumOperation;
+    /** Current lifecycle state for the operation. */
+    state: LiquidiumState;
+    /** Observed chain confirmations, or null when unavailable or not applicable. */
+    confirmations: number | null;
+    /** Required confirmations, or null when unavailable or not applicable. */
+    requiredConfirmations: number | null;
+}
+
+/** Activity list lifecycle filter. */
 declare const ActivityFilter: {
     readonly active: "active";
     readonly completed: "completed";
     readonly all: "all";
 };
-/** Activity list state filter. */
+/** Activity list lifecycle filter. */
 type ActivityFilter = (typeof ActivityFilter)[keyof typeof ActivityFilter];
-/** Direction of value movement for an activity. */
-declare const ActivityDirection: {
-    readonly inflow: "inflow";
-    readonly outflow: "outflow";
-};
-/** Direction of value movement for an activity. */
-type ActivityDirection = (typeof ActivityDirection)[keyof typeof ActivityDirection];
-/** Consumer-facing activity kind. */
-declare const ActivityKind: {
-    readonly deposit: "deposit";
-    readonly repayment: "repayment";
-    readonly borrow: "borrow";
-    readonly withdraw: "withdraw";
-};
-/** Consumer-facing activity kind. */
-type ActivityKind = (typeof ActivityKind)[keyof typeof ActivityKind];
-/** Consumer-facing activity lifecycle status. */
-declare const ActivityStatus: {
-    readonly requested: "requested";
-    readonly pending: "pending";
-    readonly detected: "detected";
-    readonly processing: "processing";
-    readonly sent: "sent";
-    readonly confirmed: "confirmed";
-    readonly failed: "failed";
-};
-/** Consumer-facing activity lifecycle status. */
-type ActivityStatus = (typeof ActivityStatus)[keyof typeof ActivityStatus];
 /** Fee top-up state for an inflow activity. */
 interface ActivityTopUp {
     /** Whether another transfer is needed before processing can continue. */
@@ -432,14 +413,16 @@ interface ActivityTopUp {
     /** Additional amount needed before processing can start. */
     shortfallAmount: bigint;
 }
-/** Activity kind emitted by deposit or repayment inflows. */
-type InflowActivityKind = typeof ActivityKind.deposit | typeof ActivityKind.repayment;
-/** Activity kind emitted by borrow or withdraw outflows. */
-type OutflowActivityKind = typeof ActivityKind.borrow | typeof ActivityKind.withdraw;
-/** Lifecycle status that can appear on an inflow activity. */
-type InflowActivityStatus = typeof ActivityStatus.requested | typeof ActivityStatus.pending | typeof ActivityStatus.detected | typeof ActivityStatus.processing | typeof ActivityStatus.confirmed | typeof ActivityStatus.failed;
-/** Lifecycle status that can appear on an outflow activity. */
-type OutflowActivityStatus = typeof ActivityStatus.requested | typeof ActivityStatus.pending | typeof ActivityStatus.sent | typeof ActivityStatus.confirmed | typeof ActivityStatus.failed;
+/** Operation emitted by deposit or repayment inflows. */
+type InflowActivityOperation = Extract<LiquidiumOperation, "deposit" | "repayment">;
+/** Operation emitted by borrow or withdrawal outflows. */
+type OutflowActivityOperation = Extract<LiquidiumOperation, "borrow" | "withdrawal">;
+type InflowActivityStatus = LiquidiumStatus & {
+    operation: InflowActivityOperation;
+};
+type OutflowActivityStatus = LiquidiumStatus & {
+    operation: OutflowActivityOperation;
+};
 interface BaseActivity {
     id: string;
     poolId: string;
@@ -447,29 +430,19 @@ interface BaseActivity {
     chain: Chain | null;
     amount: bigint;
     timestampMs: number;
-    txid: string | null;
+    /** Chain transaction ids associated with the activity when available. */
     txids?: string[];
-    confirmations: number | null;
-    requiredConfirmations: number | null;
 }
 /** Deposit or repayment activity returned by the activity API. */
 interface InflowActivity extends BaseActivity {
-    /** Direction discriminator. */
-    direction: typeof ActivityDirection.inflow;
-    /** Deposit or repayment kind. */
-    kind: InflowActivityKind;
-    /** Single consumer-facing lifecycle status. */
+    /** Shared consumer-facing lifecycle status. */
     status: InflowActivityStatus;
     /** Fee top-up state when the inflow is below the current processing fee. */
     topUp?: ActivityTopUp;
 }
-/** Borrow or withdraw activity returned by the activity API. */
+/** Borrow or withdrawal activity returned by the activity API. */
 interface OutflowActivity extends BaseActivity {
-    /** Direction discriminator. */
-    direction: typeof ActivityDirection.outflow;
-    /** Borrow or withdraw kind. */
-    kind: OutflowActivityKind;
-    /** Single consumer-facing lifecycle status. */
+    /** Shared consumer-facing lifecycle status. */
     status: OutflowActivityStatus;
     /** Outflows never carry top-up state. */
     topUp?: never;
@@ -478,7 +451,7 @@ interface OutflowActivity extends BaseActivity {
 type Activity = InflowActivity | OutflowActivity;
 /** Shared request fields for listing activities. */
 interface BaseListActivitiesRequest {
-    /** Optional state filter; defaults to `all`. */
+    /** Optional lifecycle filter; defaults to `active`. */
     filter?: ActivityFilter;
 }
 /** Activity list request scoped to a Liquidium profile. */
@@ -533,11 +506,11 @@ declare class ActivitiesModule {
     private readonly canisterContext;
     constructor(apiClient: ApiClient | undefined, canisterContext: CanisterContext);
     /**
-     * Lists profile activities. Defaults to all activities.
+     * Lists profile activities. Defaults to active activities.
      *
      * Uses the Liquidium SDK API.
      *
-     * @param request - Profile id or instant-loan short reference plus optional state filter.
+     * @param request - Profile id or instant-loan short reference plus optional lifecycle filter.
      * @returns Activities owned by the resolved profile.
      */
     list(request: ListActivitiesRequest): Promise<Activity[]>;
@@ -554,23 +527,12 @@ declare class ActivitiesModule {
     private resolveProfileId;
 }
 
-/** Consumer-facing status for profile transaction history entries. */
-declare const UserHistoryStatus: {
-    readonly requested: "requested";
-    readonly pending: "pending";
-    readonly confirmed: "confirmed";
-    readonly failed: "failed";
-};
-/** Consumer-facing status for profile transaction history entries. */
-type UserHistoryStatus = (typeof UserHistoryStatus)[keyof typeof UserHistoryStatus];
-/** Uppercase status value used by SDK API responses. */
-type UserHistoryStatusApi = Uppercase<UserHistoryStatus>;
-/** User transaction kinds returned by profile transaction history. */
-type UserTransactionHistoryType = "supply" | "borrow" | "repay" | "withdraw";
-/** User liquidation history kind. */
-type UserLiquidationHistoryType = "liquidation";
-/** Any user history kind returned by the history API. */
-type UserHistoryType = UserTransactionHistoryType | UserLiquidationHistoryType;
+/** User transaction operations returned by profile transaction history. */
+type UserTransactionHistoryOperation = LiquidiumOperation;
+/** Any user history operation returned by the history API. */
+type UserHistoryOperation = UserTransactionHistoryOperation;
+/** Lifecycle states accepted by profile transaction history filters. */
+type UserTransactionHistoryState = Exclude<LiquidiumState, "active" | "expired">;
 interface BaseUserHistoryEntry {
     id: string;
     amount: bigint;
@@ -578,19 +540,15 @@ interface BaseUserHistoryEntry {
     timestamp: string;
     txids?: string[];
 }
-/** Supply, borrow, repay, or withdraw entry in user history. */
+/** Deposit, borrow, repayment, withdrawal, or liquidation entry in user history. */
 interface UserTransactionHistoryEntry extends BaseUserHistoryEntry {
-    /** Transaction history kind. */
-    type: UserTransactionHistoryType;
     /** Current lifecycle status. */
-    status: UserHistoryStatus;
+    status: LiquidiumStatus;
 }
 /** Liquidation entry in user history. */
 interface UserLiquidationHistoryEntry extends BaseUserHistoryEntry {
-    /** Liquidation kind discriminator. */
-    type: UserLiquidationHistoryType;
-    /** Liquidations are only returned once confirmed. */
-    status: typeof UserHistoryStatus.confirmed;
+    /** Current lifecycle status. */
+    status: LiquidiumStatus;
 }
 /** Any consumer-facing profile history entry. */
 type UserHistoryEntry = UserTransactionHistoryEntry | UserLiquidationHistoryEntry;
@@ -604,10 +562,10 @@ interface UserTransactionHistoryFilters {
     market?: string;
     /** Pool principal text filter. */
     poolId?: string;
-    /** Transaction kind filters. */
-    types?: UserTransactionHistoryType[];
-    /** Status filters. */
-    statuses?: UserHistoryEntry["status"][];
+    /** Transaction operation filters. */
+    operations?: UserTransactionHistoryOperation[];
+    /** Lifecycle state filters. */
+    states?: UserTransactionHistoryState[];
     /** Inclusive start timestamp filter accepted by the SDK API. */
     from?: string;
     /** Inclusive end timestamp filter accepted by the SDK API. */
@@ -628,131 +586,20 @@ interface UserLiquidationHistoryFilters {
     /** Inclusive end timestamp filter accepted by the SDK API. */
     to?: string;
 }
-/** Backwards-compatible alias for user transaction history filters. */
-type ActivitiesRequest = UserTransactionHistoryFilters;
-/** Time-window and pagination options for borrow APY history. */
-interface BorrowApyHistoryRequest {
-    /** Pagination cursor from a previous response. */
-    cursor?: string;
-    /** Maximum number of samples to return. */
-    limit?: number;
-    /** Inclusive start timestamp filter accepted by the SDK API. */
-    from?: string;
-    /** Inclusive end timestamp filter accepted by the SDK API. */
-    to?: string;
-}
-/** Time-window and pagination options for pool rate history. */
-type PoolHistoryRequest = BorrowApyHistoryRequest;
-/** Borrow APY sample returned to SDK consumers. */
-interface ApySample {
-    /** Sample date from the SDK API. */
-    date: string;
-    /** Decimal scale for `avgRate`. */
-    rateDecimals: bigint;
-    /** Average borrow rate for the sample, scaled by `rateDecimals`. */
-    avgRate: bigint;
-}
 /** Wire-format user history item returned by the SDK API. */
 interface UserHistoryEntryApiItem {
     id: string;
-    type: UserHistoryType;
     amount: string;
     poolId: string;
     timestamp: string;
-    status: UserHistoryStatusApi;
+    status: LiquidiumStatus;
     txids?: string[];
 }
 /** Wire-format user history page returned by the SDK API. */
 interface UserHistoryResponse {
-    success: true;
     items: UserHistoryEntryApiItem[];
     nextCursor?: string;
 }
-/** Pool rate and utilization history entry returned to SDK consumers. */
-interface PoolHistoryEntry {
-    /** Sample date from the SDK API. */
-    date: string;
-    /** Decimal scale for rate fields. */
-    rateDecimals: bigint;
-    /** Average borrow rate for the sample, scaled by `rateDecimals`. */
-    avgBorrowRate: bigint;
-    /** Average lend rate for the sample, scaled by `rateDecimals`. */
-    avgLendRate: bigint;
-    /** Average utilization rate for the sample, scaled by `rateDecimals`. */
-    avgUtilizationRate: bigint;
-}
-/** Wire-format pool rate history item returned by the SDK API. */
-interface PoolHistoryEntryApiItem {
-    date: string;
-    rateDecimals: number;
-    avgBorrowRate: string;
-    avgLendRate: string;
-    avgUtilizationRate: string;
-}
-/** Wire-format pool rate history page returned by the SDK API. */
-interface PoolHistoryResponse {
-    success: true;
-    items: PoolHistoryEntryApiItem[];
-    nextCursor?: string;
-}
-/** Pool configuration snapshot returned to SDK consumers. */
-interface PoolConfigHistoryEntry {
-    type: "configuration_change";
-    poolId: string;
-    asset: string;
-    chain: string;
-    timestamp: string;
-    totalSupply: bigint;
-    totalDebt: bigint;
-    supplyCap?: bigint;
-    borrowCap?: bigint;
-    maxLtv: bigint;
-    liquidationThreshold: bigint;
-    liquidationBonus: bigint;
-    protocolLiquidationFee: bigint;
-    reserveFactor: bigint;
-    baseRate: bigint;
-    optimalUtilizationRate: bigint;
-    rateSlopeBefore: bigint;
-    rateSlopeAfter: bigint;
-    lendingIndex: bigint;
-    borrowIndex: bigint;
-    sameAssetBorrowing: boolean;
-    frozen: boolean;
-}
-/** Wire-format pool configuration history item returned by the SDK API. */
-interface PoolConfigHistoryEntryApiItem {
-    type: "configuration_change";
-    poolId: string;
-    asset: string;
-    chain: string;
-    timestamp: string;
-    totalSupply: string;
-    totalDebt: string;
-    supplyCap?: string;
-    borrowCap?: string;
-    maxLtv: string;
-    liquidationThreshold: string;
-    liquidationBonus: string;
-    protocolLiquidationFee: string;
-    reserveFactor: string;
-    baseRate: string;
-    optimalUtilizationRate: string;
-    rateSlopeBefore: string;
-    rateSlopeAfter: string;
-    lendingIndex: string;
-    borrowIndex: string;
-    sameAssetBorrowing: boolean;
-    frozen: boolean;
-}
-/** Wire-format pool configuration history page returned by the SDK API. */
-interface PoolConfigHistoryResponse {
-    success: true;
-    items: PoolConfigHistoryEntryApiItem[];
-    nextCursor?: string;
-}
-/** Any history entry returned by history module methods. */
-type HistoryEntry = UserHistoryEntry | PoolHistoryEntry | PoolConfigHistoryEntry;
 /** Generic SDK API paginated response. */
 interface PaginatedResponse<T> {
     /** Items in the current page. */
@@ -761,44 +608,19 @@ interface PaginatedResponse<T> {
     nextCursor?: string;
 }
 
-/** Historical pool, rate, user transaction, and liquidation data helpers. */
+/** Historical user transaction and liquidation data helpers. */
 declare class HistoryModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient | undefined);
     private requireApi;
-    /**
-     * Returns paginated rate and utilization history for a pool.
-     *
-     * @param poolId - The pool principal text.
-     * @param window - Optional time window with from/to timestamps and limit.
-     * @returns A page of pool rate history entries and the next cursor when more results are available.
-     */
-    getPoolHistory(poolId: string, window?: PoolHistoryRequest): Promise<PaginatedResponse<PoolHistoryEntry>>;
-    /**
-     * Returns paginated configuration change history for a pool.
-     *
-     * @param poolId - The pool principal text.
-     * @param cursor - An optional pagination cursor from a previous response.
-     * @returns A page of pool configuration changes and the next cursor when more results are available.
-     */
-    getPoolConfigHistory(poolId: string, cursor?: string): Promise<PaginatedResponse<PoolConfigHistoryEntry>>;
-    /**
-     * Returns borrow rate history for a pool.
-     *
-     * @param poolId - The pool principal text.
-     * @param window - Optional time window with from/to timestamps and limit.
-     * @returns Paginated APY samples.
-     */
-    getBorrowRateHistory(poolId: string, window?: BorrowApyHistoryRequest): Promise<PaginatedResponse<ApySample>>;
     /**
      * Returns transaction history for a user.
      *
      * @param user - The Liquidium profile principal text.
-     * @param filters - Optional pool, type, status, time range, and pagination filters.
+     * @param filters - Optional pool, operation, state, time range, and pagination filters.
      * @returns Paginated user history entries.
      */
     getUserTransactionHistory(user: string, filters?: UserTransactionHistoryFilters): Promise<PaginatedResponse<UserTransactionHistoryEntry>>;
-    getUserTransactionHistory(user: string, market?: string, filters?: UserTransactionHistoryFilters): Promise<PaginatedResponse<UserTransactionHistoryEntry>>;
     /**
      * Returns liquidation history for a user.
      *
@@ -807,7 +629,6 @@ declare class HistoryModule {
      * @returns Paginated liquidation history entries.
      */
     getLiquidationHistory(user: string, filters?: UserLiquidationHistoryFilters): Promise<PaginatedResponse<UserLiquidationHistoryEntry>>;
-    getLiquidationHistory(user: string, market?: string, filters?: UserLiquidationHistoryFilters): Promise<PaginatedResponse<UserLiquidationHistoryEntry>>;
 }
 
 /** Wallet execution dependencies for borrow and withdraw convenience methods. */
@@ -868,7 +689,7 @@ interface IcrcOutflowReceiver {
     account: string;
 }
 /**
- * Receipt for a borrow or withdraw submitted to the lending canister.
+ * Receipt for a borrow or withdrawal outflow submitted to the lending canister.
  *
  * `id` is the outflow reference to show users immediately. `txid` may be unset until
  * the protocol assigns a chain transaction id. `outflowRef` is an optional protocol reference.
@@ -876,7 +697,7 @@ interface IcrcOutflowReceiver {
 interface OutflowDetails {
     /** Protocol outflow id. */
     id: string;
-    /** Borrow, withdraw, or fee-claim discriminator. */
+    /** Borrow, withdrawal, or fee-claim discriminator. */
     outflowType: OutflowType;
     /** Optional protocol outflow reference. */
     outflowRef?: string;
@@ -890,10 +711,14 @@ interface OutflowDetails {
 /** Borrow receipt. */
 type BorrowOutflowDetails = OutflowDetails & {
     outflowType: "borrow";
+    /** Shared lifecycle status for the borrow outflow receipt. */
+    status: LiquidiumStatus;
 };
 /** Withdraw receipt. */
 type WithdrawOutflowDetails = OutflowDetails & {
-    outflowType: "withdraw";
+    outflowType: "withdrawal";
+    /** Shared lifecycle status for the withdraw outflow receipt. */
+    status: LiquidiumStatus;
 };
 /** Signature payload for submitting a prepared borrow action. */
 interface BorrowSubmitSignatureInfo extends SignatureInfo {
@@ -1052,6 +877,8 @@ type SupplyFlowRequest = TransferSupplyFlowRequest | ContractInteractionSupplyFl
  *   (wallet-adapter path). When undefined, the caller is expected to broadcast
  *   themselves and call {@link SupplyFlow.submit} for flows that require txid
  *   registration.
+ * - If post-broadcast inflow registration fails after the SDK broadcasts the
+ *   transaction, `txid` is still returned so callers can track the transaction.
  * - `submit` registers a broadcast txid with the SDK API when needed. ETH
  *   stablecoin deposit-address transfers are indexed from ERC-20 transfer logs,
  *   so `submit` acknowledges the txid without posting it to the inflow endpoint.
@@ -1066,22 +893,27 @@ interface SupplyFlow {
     target: SupplyTarget;
     /** Transaction id when the SDK broadcast the transaction. */
     txid?: string;
+    /** Shared lifecycle status for the supply flow. */
+    status: LiquidiumStatus;
     /** Registers a broadcast transaction id when the flow requires an indexing hint. */
-    submit(request: SubmitInflowRequest): Promise<SubmitInflowResponse>;
+    submit(request: SubmitSupplyFlowInflowRequest): Promise<SubmitInflowResponse>;
 }
-/** Body for `SupplyFlow.submit` / `lending.submitInflow`. */
-interface SubmitInflowRequest {
+/** Canonical inflow operation accepted by direct inflow submission. */
+type InflowOperation = Extract<LiquidiumOperation, "deposit" | "repayment">;
+/** Body for `SupplyFlow.submit`. The supply flow supplies the inflow operation. */
+interface SubmitSupplyFlowInflowRequest {
     /** Broadcast transaction id or hash. */
     txid: string;
     /** Chain where the transaction was broadcast, when not implied by the flow. */
     chain?: Chain;
-    /** Deposit or repayment submit type, when not implied by the flow. */
-    type?: InflowSubmitType;
+}
+/** Body for direct `lending.submitInflow`. */
+interface SubmitInflowRequest extends SubmitSupplyFlowInflowRequest {
+    /** Deposit or repayment operation represented by the transaction. */
+    operation: InflowOperation;
 }
 /** Acknowledgement from the SDK API after submitting an inflow hint. */
 interface SubmitInflowResponse {
-    /** Indicates the submit request was accepted by the SDK API. */
-    success: true;
     /** Transaction id accepted by the SDK API. */
     txid: string;
 }
@@ -1131,8 +963,6 @@ declare const EvmSupplyApprovalStrategy: {
 type EvmSupplyApprovalStrategy = (typeof EvmSupplyApprovalStrategy)[keyof typeof EvmSupplyApprovalStrategy];
 /** ERC-20 supply planning data returned by `lending.getEvmSupplyContext(...)`. */
 interface EvmSupplyContext {
-    /** Indicates the context was computed successfully. */
-    success: true;
     /** Liquidium profile principal text. */
     profileId: string;
     /** Pool principal text receiving the inflow. */
@@ -1235,7 +1065,6 @@ declare class LendingModule {
      * @returns Locally computed {@link EvmSupplyContext} for approvals and deposit.
      */
     getEvmSupplyContext(request: GetEvmSupplyContextRequest): Promise<EvmSupplyContext>;
-    private getEvmSupplyContextForPool;
     /**
      * Returns the read-only deposit address for an ETH stablecoin inflow target.
      *
@@ -1257,17 +1086,12 @@ declare class LendingModule {
      */
     estimateInflowFee(request: EstimateInflowFeeRequest): Promise<InflowFeeEstimate>;
     private estimateBtcInflowFee;
-    private sendAndSubmitNativeSupplyInflow;
-    private submitSupplyFlowInflow;
-    private executeContractSupply;
-    private sendNativeSupplyTransaction;
-    private submitInflowWithRetry;
     /**
      * Submits an inflow transaction id for faster indexing.
      *
      * Uses the Liquidium SDK API.
      *
-     * @param request - Broadcast `txid` plus optional `chain` and inflow `type`.
+     * @param request - Broadcast `txid` plus inflow `operation` and optional `chain`.
      * @returns Acknowledgement including the submitted `txid`.
      */
     submitInflow(request: SubmitInflowRequest): Promise<SubmitInflowResponse>;
@@ -1278,11 +1102,9 @@ declare class LendingModule {
      */
     isBorrowingDisabled(): Promise<boolean>;
     private requireApi;
-    private requireEvmReadClient;
+    private createSupplyFlowExecutor;
     private getPoolById;
     private normalizeOutflowReceiverAddress;
-    private sendEthContractTransaction;
-    private waitForExpectedAllowance;
 }
 
 /** Current protocol metadata and rate state for a lending pool. */
@@ -1369,9 +1191,11 @@ declare class MarketModule {
     private readonly apiClient;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined);
     /**
-     * Lists all pools with their current rates.
+     * Lists SDK-supported pools with their current rates.
+     *
+     * Unsupported asset or chain variants returned by the canister are omitted.
      *
-     * @returns All configured lending pools enriched with their current rate data.
+     * @returns Supported lending pools enriched with their current rate data.
      */
     listPools(): Promise<Pool[]>;
     /**
@@ -1944,16 +1768,6 @@ interface InstantLoanPositionSummary {
     /** Borrowed principal plus accrued interest in base units, before repayment buffer. */
     totalDebtAmount: bigint;
 }
-/** Simplified lifecycle status for consumer UIs. */
-declare const InstantLoanStatus: {
-    readonly awaitingDeposit: "awaiting_deposit";
-    readonly depositDetected: "deposit_detected";
-    readonly active: "active";
-    readonly settling: "settling";
-    readonly closed: "closed";
-    readonly expired: "expired";
-};
-type InstantLoanStatus = (typeof InstantLoanStatus)[keyof typeof InstantLoanStatus];
 /** Immutable terms selected for an instant loan. */
 interface InstantLoanTerms {
     /** Maximum loan-to-value ratio in basis points. */
@@ -1995,8 +1809,8 @@ interface InstantLoan {
     loanId: bigint;
     /** Short user-facing reference derived from `loanId`. */
     ref: string;
-    /** Simplified lifecycle status for display and flow control. */
-    status: InstantLoanStatus;
+    /** Shared lifecycle status for display and flow control. */
+    status: LiquidiumStatus;
     /** Generated profile principal used by the instant loan. */
     profileId: string;
     /** Immutable loan terms. */
@@ -2019,9 +1833,10 @@ interface InstantLoan {
 declare class InstantLoansModule {
     private readonly canisterContext;
     private readonly apiClient;
+    private readonly activities;
     private readonly lending;
     private readonly positions;
-    constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, lending: LendingModule, positions: PositionsModule);
+    constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, activities: ActivitiesModule, lending: LendingModule, positions: PositionsModule);
     /**
      * Creates a profileless instant loan and returns canonical canister state plus
      * generated initial-deposit and repayment quote targets.
@@ -2407,7 +2222,7 @@ interface ExecuteWithOptions {
  * Returns an async function that runs a {@link WalletAction} end-to-end.
  *
  * - `sign-message`: needs `walletAdapter.signMessage` and `options.chain`.
- * - `sign-psbt`: needs `walletAdapter.signPsbt`.
+ * - `sign-psbt`: reserved; no current SDK flow emits this action.
  * - `send-eth-transaction`: needs `walletAdapter.sendEthTransaction`.
  *
  * @param options - Adapter and optional chain/account overrides.
@@ -2415,4 +2230,4 @@ interface ExecuteWithOptions {
  */
 declare function executeWith(options: ExecuteWithOptions): <TResult>(action: WalletAction<TResult>) => Promise<TResult>;
 
-export { type AccountIdentifierAccount, type AccountIdentifierOutflowReceiver, AccountsModule, ActivitiesModule, type ActivitiesRequest, type Activity, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, type ActivityStatusFoundResponse, type ActivityStatusNotFoundResponse, type ActivityTopUp, type ApySample, Asset, type AssetPrices, type BaseGetActivityStatusRequest, type BaseListActivitiesRequest, type BorrowAction, type BorrowApyHistoryRequest, type BorrowOutflowDetails, type BorrowSubmitSignatureInfo, type BorrowingPower, CK_ETH_DEPOSIT_CONTRACT_ADDRESS, type CalculateLtvRequest, type CanisterIds, Chain, type ContractInteractionSupplyFlowRequest, type CreateAccountAction, type CreateAccountData, type CreateAccountRequest, type CreateBorrowData, type CreateBorrowRequest, type CreateInstantLoanRequest, type CreateProfileParams, type CreateTransferErc20TransactionParams, type CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmContractTransaction, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type ExternalOutflowReceiver, type FindPoolQuery, type FullWithdrawAmount, type GetActivityStatusByProfileRequest, type GetActivityStatusByShortRefRequest, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetDepositAddressRequest, type GetEvmSupplyContextRequest, type HealthFactor, type HistoryEntry, HistoryModule, type IcrcAccount, type IcrcAccountSupplyTarget, type IcrcOutflowReceiver, type InflowActivity, type InflowActivityKind, type InflowActivityStatus, type InflowFeeEstimate, InflowSubmitType, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanAuthorization, type InstantLoanBorrow, type InstantLoanBorrowRequestedEventType, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanCreatedEventType, type InstantLoanDepositTimerExceededEventType, type InstantLoanDepositTimerStartedEventType, type InstantLoanEvent, type InstantLoanEventType, type InstantLoanFindBorrow, type InstantLoanFindCollateral, type InstantLoanFindResult, type InstantLoanFullLendWithdrawalRequestedEventType, type InstantLoanGetByIdRequest, type InstantLoanGetByRefRequest, type InstantLoanGetRequest, type InstantLoanInitialDeposit, type InstantLoanLeg, type InstantLoanListEventsRequest, type InstantLoanPositionSummary, type InstantLoanProfileWarmedEventType, type InstantLoanRepayCompleteEventType, type InstantLoanRepayment, InstantLoanStatus, type InstantLoanStuckFundsWithdrawalRequestedEventType, type InstantLoanTerms, type InstantLoanWarmedProfile, InstantLoansModule, LendingModule, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type LiquidiumErrorContext, type ListActivitiesByProfileRequest, type ListActivitiesByShortRefRequest, type ListActivitiesRequest, type LtvCalculation, MIN_BORROW_AMOUNTS_BY_ASSET, type ManualTransferSupplyFlowRequest, type MarketAsset, type MarketChain, MarketModule, type MaxRepayAmount, type MinimumBorrowAsset, type NativeAccount, type NativeAddressSupplyTarget, type NativeOutflowReceiver, type OutflowActivity, type OutflowActivityKind, type OutflowActivityStatus, type OutflowDetails, type OutflowReceiver, OutflowType, type PaginatedResponse, type Pool, type PoolConfigHistoryEntry, type PoolConfigHistoryEntryApiItem, type PoolConfigHistoryResponse, type PoolHistoryEntry, type PoolHistoryEntryApiItem, type PoolHistoryRequest, type PoolHistoryResponse, type PoolRate, type Position, PositionsModule, type PrepareCreateProfileOptions, QuoteModule, type QuoteRequest, type QuoteResult, type QuoteValidationError, QuoteValidationErrorCode, type QuoteWarning, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, type SendBtcTransactionRequest, type SendEthTransactionRequest, type SendEthTransactionSubmitRequest, type SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, type SignPsbtSubmitRequest, type SignPsbtWalletAction, type SignableAction, type SignatureInfo, type SubmitInflowRequest, type SubmitInflowResponse, SupplyAction, type SupplyFlow, type SupplyFlowRequest, SupplyPlanType, type SupplyTarget, TransferMode, type TransferSupplyFlowRequest, USDC_CONTRACT_ADDRESS, USDT_CONTRACT_ADDRESS, type UserHistoryEntry, type UserHistoryEntryApiItem, type UserHistoryResponse, UserHistoryStatus, type UserHistoryStatusApi, type UserHistoryType, type UserLiquidationHistoryEntry, type UserLiquidationHistoryFilters, type UserLiquidationHistoryType, type UserPositionSummary, type UserReserve, type UserStats, type UserTransactionHistoryEntry, type UserTransactionHistoryFilters, type UserTransactionHistoryType, type Wallet, type WalletAction, type WalletAdapter, WalletExecutionKind, type WalletExecutionParams, type WalletTransferSupplyFlowRequest, type WithdrawAction, type WithdrawOutflowDetails, type WithdrawSubmitSignatureInfo, createTransferErc20Transaction, executeWith, getMinimumBorrowAmount, intFromPublicId, publicIdFromInt };
+export { type AccountIdentifierAccount, type AccountIdentifierOutflowReceiver, AccountsModule, ActivitiesModule, type Activity, ActivityFilter, type ActivityStatusFoundResponse, type ActivityStatusNotFoundResponse, type ActivityTopUp, Asset, type AssetPrices, type BaseGetActivityStatusRequest, type BaseListActivitiesRequest, type BorrowAction, type BorrowOutflowDetails, type BorrowSubmitSignatureInfo, type BorrowingPower, CK_ETH_DEPOSIT_CONTRACT_ADDRESS, type CalculateLtvRequest, type CanisterIds, Chain, type ContractInteractionSupplyFlowRequest, type CreateAccountAction, type CreateAccountData, type CreateAccountRequest, type CreateBorrowData, type CreateBorrowRequest, type CreateInstantLoanRequest, type CreateProfileParams, type CreateTransferErc20TransactionParams, type CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmContractTransaction, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type ExternalOutflowReceiver, type FindPoolQuery, type FullWithdrawAmount, type GetActivityStatusByProfileRequest, type GetActivityStatusByShortRefRequest, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetDepositAddressRequest, type GetEvmSupplyContextRequest, type HealthFactor, HistoryModule, type IcrcAccount, type IcrcAccountSupplyTarget, type IcrcOutflowReceiver, type InflowActivity, type InflowActivityOperation, type InflowActivityStatus, type InflowFeeEstimate, type InflowOperation, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanAuthorization, type InstantLoanBorrow, type InstantLoanBorrowRequestedEventType, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanCreatedEventType, type InstantLoanDepositTimerExceededEventType, type InstantLoanDepositTimerStartedEventType, type InstantLoanEvent, type InstantLoanEventType, type InstantLoanFindBorrow, type InstantLoanFindCollateral, type InstantLoanFindResult, type InstantLoanFullLendWithdrawalRequestedEventType, type InstantLoanGetByIdRequest, type InstantLoanGetByRefRequest, type InstantLoanGetRequest, type InstantLoanInitialDeposit, type InstantLoanLeg, type InstantLoanListEventsRequest, type InstantLoanPositionSummary, type InstantLoanProfileWarmedEventType, type InstantLoanRepayCompleteEventType, type InstantLoanRepayment, type InstantLoanStuckFundsWithdrawalRequestedEventType, type InstantLoanTerms, type InstantLoanWarmedProfile, InstantLoansModule, LendingModule, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type LiquidiumErrorContext, type LiquidiumOperation, type LiquidiumState, type LiquidiumStatus, type ListActivitiesByProfileRequest, type ListActivitiesByShortRefRequest, type ListActivitiesRequest, type LtvCalculation, MIN_BORROW_AMOUNTS_BY_ASSET, type ManualTransferSupplyFlowRequest, type MarketAsset, type MarketChain, MarketModule, type MaxRepayAmount, type MinimumBorrowAsset, type NativeAccount, type NativeAddressSupplyTarget, type NativeOutflowReceiver, type OutflowActivity, type OutflowActivityOperation, type OutflowActivityStatus, type OutflowDetails, type OutflowReceiver, OutflowType, type PaginatedResponse, type Pool, type PoolRate, type Position, PositionsModule, type PrepareCreateProfileOptions, QuoteModule, type QuoteRequest, type QuoteResult, type QuoteValidationError, QuoteValidationErrorCode, type QuoteWarning, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, type SendBtcTransactionRequest, type SendEthTransactionRequest, type SendEthTransactionSubmitRequest, type SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, type SignPsbtSubmitRequest, type SignPsbtWalletAction, type SignableAction, type SignatureInfo, type SubmitInflowRequest, type SubmitInflowResponse, type SubmitSupplyFlowInflowRequest, SupplyAction, type SupplyFlow, type SupplyFlowRequest, SupplyPlanType, type SupplyTarget, TransferMode, type TransferSupplyFlowRequest, USDC_CONTRACT_ADDRESS, USDT_CONTRACT_ADDRESS, type UserHistoryEntry, type UserHistoryEntryApiItem, type UserHistoryOperation, type UserHistoryResponse, type UserLiquidationHistoryEntry, type UserLiquidationHistoryFilters, type UserPositionSummary, type UserReserve, type UserStats, type UserTransactionHistoryEntry, type UserTransactionHistoryFilters, type UserTransactionHistoryOperation, type UserTransactionHistoryState, type Wallet, type WalletAction, WalletActionKind, type WalletAdapter, WalletExecutionKind, type WalletExecutionParams, type WalletTransferSupplyFlowRequest, type WithdrawAction, type WithdrawOutflowDetails, type WithdrawSubmitSignatureInfo, createTransferErc20Transaction, executeWith, getMinimumBorrowAmount, intFromPublicId, publicIdFromInt };