@liquidium/client 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -321,7 +321,7 @@ type CreateProfileParams = {
 };
 /** Profile lifecycle and linked-wallet helpers. */
 declare class AccountsModule {
-    readonly canisterContext: CanisterContext;
+    private readonly canisterContext;
     constructor(canisterContext: CanisterContext);
     /**
      * Prepares a profile-creation action that can be signed and submitted later.
@@ -493,8 +493,8 @@ type GetActivityStatusResponse = {
 
 /** Receipt-oriented activity list and status helpers. */
 declare class ActivitiesModule {
-    readonly apiClient: ApiClient | undefined;
-    readonly canisterContext: CanisterContext;
+    private readonly apiClient;
+    private readonly canisterContext;
     constructor(apiClient: ApiClient | undefined, canisterContext: CanisterContext);
     /**
      * Lists profile activities. Defaults to all activities.
@@ -727,7 +727,7 @@ interface PaginatedResponse<T> {
 
 /** Historical pool, rate, user transaction, and liquidation data helpers. */
 declare class HistoryModule {
-    readonly apiClient: ApiClient | undefined;
+    private readonly apiClient;
     constructor(apiClient: ApiClient | undefined);
     private requireApi;
     /**
@@ -834,7 +834,7 @@ interface CreateBorrowRequest {
     poolId: string;
     /** Amount to borrow in the borrow asset's base units. */
     amount: bigint;
-    /** External-chain address that receives the borrowed asset. */
+    /** External-chain address that receives the borrowed asset. Must match the borrow pool chain. */
     receiverAddress: string;
     /** Wallet address that signs the borrow authorization. */
     signerWalletAddress: string;
@@ -863,7 +863,7 @@ interface CreateWithdrawRequest {
     poolId: string;
     /** Amount to withdraw in the pool asset's base units. */
     amount: bigint;
-    /** External-chain address that receives the withdrawn asset. */
+    /** External-chain address that receives the withdrawn asset. Must match the pool chain. */
     receiverAddress: string;
     /** Wallet address that signs the withdraw authorization. */
     signerWalletAddress: string;
@@ -1014,9 +1014,9 @@ interface EstimateInflowFeeRequest {
     /** Chain to estimate for. */
     chain: Chain;
 }
-/** Fee estimate for an inflow target. */
+/** Fee estimate for an inflow target, rounded up to the asset's fee unit. */
 interface InflowFeeEstimate {
-    /** Estimated total fee in the asset's base units. */
+    /** Estimated total fee rounded up in the asset's base units. */
     totalFee: bigint;
 }
 /** Request for ERC-20 approval and deposit planning. */
@@ -1080,9 +1080,9 @@ type WalletExecutionParams = {
 };
 /** Borrow, withdraw, supply, inflow reporting, and fee-estimation helpers. */
 declare class LendingModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
-    readonly evmReadClient: EvmReadClient | undefined;
+    private readonly canisterContext;
+    private readonly apiClient;
+    private readonly evmReadClient;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, evmReadClient: EvmReadClient | undefined);
     /**
      * Prepares a withdraw action that can be signed and submitted later.
@@ -1170,12 +1170,13 @@ declare class LendingModule {
      * Estimates the network/deposit fee for an inflow target.
      *
      * ETH stablecoin deposit-address estimates are served by the deposit-address
-     * canister. BTC estimates are not exposed by this SDK yet and return zero.
+     * canister. BTC estimates include the ckBTC minter deposit fee and ledger fee.
      *
      * @param request - Asset and chain pair to estimate for.
-     * @returns Total fee estimate in the asset's base units.
+     * @returns Total fee estimate rounded up in the asset's base units.
      */
     estimateInflowFee(request: EstimateInflowFeeRequest): Promise<InflowFeeEstimate>;
+    private estimateBtcInflowFee;
     private sendAndSubmitNativeSupplyInflow;
     private submitSupplyFlowInflow;
     private executeContractSupply;
@@ -1199,6 +1200,7 @@ declare class LendingModule {
     private requireApi;
     private requireEvmReadClient;
     private getPoolById;
+    private normalizeOutflowReceiverAddress;
     private sendEthContractTransaction;
     private waitForExpectedAllowance;
 }
@@ -1283,8 +1285,8 @@ interface PoolRate {
 
 /** Pool metadata, prices, and current rate helpers. */
 declare class MarketModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
+    private readonly canisterContext;
+    private readonly apiClient;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined);
     /**
      * Lists all pools with their current rates.
@@ -1422,7 +1424,7 @@ interface MaxRepayAmount {
 
 /** Profile position, health factor, and reserve valuation helpers. */
 declare class PositionsModule {
-    readonly canisterContext: CanisterContext;
+    private readonly canisterContext;
     readonly market: MarketModule;
     constructor(canisterContext: CanisterContext, market: MarketModule);
     /**
@@ -1470,7 +1472,7 @@ declare class PositionsModule {
      * Returns the per-reserve breakdown of a profile's supplies and borrows,
      * joined with pool metadata, rates, and current USD prices.
      *
-     * USD values are scaled to {@link USD_VALUE_SCALE_DECIMALS} (27).
+     * USD values are scaled to 27 decimals.
      *
      * @param profileId - The Liquidium profile principal text.
      * @returns Per-reserve position rows joined with pool metadata and USD values.
@@ -1574,11 +1576,13 @@ interface CreateInstantLoanRequest {
      */
     borrowAsset: InstantLoanAsset;
     /**
-     * Amount the user is expected to deposit as collateral, in base units.
+     * Intended credited collateral amount, in base units.
      *
-     * This is used to validate LTV and initialize the loan record. For BTC, pass
-     * satoshis. For token assets, convert the UI amount using the selected pool's
-     * `decimals` value.
+     * This is used to validate LTV and initialize the loan record before
+     * deposit/inflow fees are deducted. For BTC, pass satoshis. For token assets,
+     * convert the UI amount using the selected pool's `decimals` value. After
+     * creation, use `loan.initialDeposit.amount` as the fee-inclusive transfer
+     * amount to send to `loan.initialDeposit.target`.
      */
     collateralAmount: bigint;
     /**
@@ -1736,6 +1740,23 @@ interface InstantLoanRepayment {
     /** Address or ICRC account where the repayment should be sent. */
     target: SupplyTarget;
 }
+/** Initial collateral deposit quote returned when an instant loan is created. */
+interface InstantLoanInitialDeposit {
+    /** Full amount to send to the deposit target, including the estimated inflow fee. */
+    amount: bigint;
+    /** Decimal scale for `amount`, `collateralAmount`, and `inflowFeeAmount`. */
+    decimals: bigint;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    collateralAmount: bigint;
+    /** Inflow fee amount in base units added to the transfer amount. */
+    inflowFeeAmount: bigint;
+    /** Collateral asset to deposit. */
+    asset: MarketAsset;
+    /** Chain used for the collateral deposit. */
+    chain: MarketChain;
+    /** Address or ICRC account where the collateral should be sent. */
+    target: SupplyTarget;
+}
 /** Current lending position backing the instant loan. */
 interface InstantLoanPositionSummary {
     /** Current collateral amount in the collateral asset's base units. */
@@ -1760,9 +1781,45 @@ declare const InstantLoanStatus: {
     readonly active: "active";
     readonly settling: "settling";
     readonly closed: "closed";
+    readonly expired: "expired";
 };
 type InstantLoanStatus = (typeof InstantLoanStatus)[keyof typeof InstantLoanStatus];
-/** Hydrated instant-loan state plus generated deposit and repayment targets. */
+/** Immutable terms selected for an instant loan. */
+interface InstantLoanTerms {
+    /** Maximum loan-to-value ratio in basis points. */
+    ltvMaxBps: bigint;
+    /** Seconds allowed for the collateral deposit before timeout. */
+    depositWindowSeconds: bigint;
+}
+/** Collateral leg selected for an instant loan. */
+interface InstantLoanCollateral {
+    /** Principal text of the collateral pool. */
+    poolId: string;
+    /** Collateral asset symbol. */
+    asset: MarketAsset;
+    /** Chain used for collateral deposits. */
+    chain: MarketChain;
+    /** Decimal scale for collateral amounts. */
+    decimals: bigint;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    amount: bigint;
+}
+/** Borrow leg selected for an instant loan. */
+interface InstantLoanBorrow {
+    /** Principal text of the borrow pool. */
+    poolId: string;
+    /** Borrow asset symbol. */
+    asset: MarketAsset;
+    /** Chain used for repayment. */
+    chain: MarketChain;
+    /** Decimal scale for borrow and debt amounts. */
+    decimals: bigint;
+    /** Requested borrow amount in base units. */
+    amount: bigint;
+    /** Destination that receives the borrowed asset. */
+    destination: InstantLoanAccount;
+}
+/** Hydrated instant-loan state plus generated quote targets. */
 interface InstantLoan {
     /** Canister-assigned loan id. */
     loanId: bigint;
@@ -1772,32 +1829,17 @@ interface InstantLoan {
     status: InstantLoanStatus;
     /** Generated lending profile principal used by the instant loan. */
     profileId: string;
-    /** Maximum loan-to-value ratio in basis points. */
-    ltvMaxBps: bigint;
-    /** Seconds allowed for the collateral deposit before timeout. */
-    depositWindowSeconds: bigint;
-    /** Collateral-side pool, asset, chain, and current or requested collateral amount. */
-    collateral: {
-        poolId: string;
-        asset: MarketAsset;
-        chain: MarketChain;
-        amount: bigint;
-    };
-    /** Borrow-side pool, asset, chain, requested amount, and destination. */
-    borrow: {
-        poolId: string;
-        asset: MarketAsset;
-        chain: MarketChain;
-        amount: bigint;
-        destination: InstantLoanAccount;
-    };
+    /** Immutable loan terms. */
+    terms: InstantLoanTerms;
+    /** Collateral-side pool, asset, chain, decimals, and requested credited amount. */
+    collateral: InstantLoanCollateral;
+    /** Borrow-side pool, asset, chain, decimals, requested amount, and destination. */
+    borrow: InstantLoanBorrow;
     /** Destination used for collateral refunds or withdrawals. */
     refundDestination: InstantLoanAccount;
-    /** Address or ICRC account where the user deposits collateral. */
-    depositTarget: SupplyTarget;
-    /** Address or ICRC account where the user repays debt. */
-    repayTarget: SupplyTarget;
-    /** Current actionable repayment quote. */
+    /** Current actionable initial collateral deposit quote. */
+    initialDeposit: InstantLoanInitialDeposit;
+    /** Current repayment quote. Amount fields are zero when the loan has no debt. */
     repayment: InstantLoanRepayment;
     /** Current lending position state for the generated profile. */
     position: InstantLoanPositionSummary;
@@ -1825,20 +1867,20 @@ interface InstantLoanCandidate {
     collateralAsset: MarketAsset;
     /** Borrow asset symbol. */
     borrowAsset: MarketAsset;
-    /** Collateral amount hint in base units. */
-    collateralAmountHint: bigint;
+    /** Collateral amount in base units. */
+    collateralAmount: bigint;
 }
 
 /** Accountless instant-loan creation, lookup, recovery, and canister query helpers. */
 declare class InstantLoansModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
-    readonly lending: LendingModule;
-    readonly positions: PositionsModule;
+    private readonly canisterContext;
+    private readonly apiClient;
+    private readonly lending;
+    private readonly positions;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, lending: LendingModule, positions: PositionsModule);
     /**
      * Creates a profileless instant loan and returns canonical canister state plus
-     * deposit/repay targets for the generated lending profile.
+     * generated initial-deposit and repayment quote targets.
      *
      * Choose `collateralPoolId` and `borrowPoolId` from
      * `client.market.listPools()`, convert UI amounts to base units with the
@@ -1851,7 +1893,7 @@ declare class InstantLoansModule {
      * SDK maps it to the canister's internal `ltv_timer_s` field.
      *
      * @param request - Pool ids, assets, base-unit amounts, LTV limit, timeout, and destinations.
-     * @returns Hydrated loan state plus generated deposit and repayment targets.
+     * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     create(request: CreateInstantLoanRequest): Promise<InstantLoan>;
     /**
@@ -1861,7 +1903,7 @@ declare class InstantLoansModule {
      * from the instant-loans canister.
      *
      * @param request - Canister loan id or short public reference.
-     * @returns Hydrated loan state plus generated deposit and repayment targets.
+     * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     get(request: InstantLoanGetRequest): Promise<InstantLoan>;
     /**
@@ -1914,8 +1956,10 @@ declare class InstantLoansModule {
      */
     findByAddress(address: string): Promise<InstantLoanCandidate[]>;
     private mapLoanRecord;
+    private getCollateralAmountHint;
     private mapLoanWire;
     private hydrateLoan;
+    private createInitialDepositQuote;
     private estimateRepaymentInflowFee;
     private requireApi;
     private validateInstantLoanLtvPolicy;
@@ -2213,4 +2257,4 @@ interface ExecuteWithOptions {
  */
 declare function executeWith(options: ExecuteWithOptions): <TResult>(action: WalletAction<TResult>) => Promise<TResult>;
 
-export { type ActivitiesRequest, type Activity, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, type ApySample, Asset, type AssetPrices, 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 CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetEvmSupplyContextRequest, type HealthFactor, type HistoryEntry, type IcrcAccountSupplyTarget, type InflowActivity, type InflowActivityKind, type InflowActivityStatus, type InflowFeeEstimate, InflowSubmitType, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanCandidate, type InstantLoanGetRequest, InstantLoanStatus, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type ListActivitiesRequest, type LtvCalculation, type MarketAsset, type MarketChain, type NativeAccount, type NativeAddressSupplyTarget, 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, type QuoteRequest, type QuoteResult, type QuoteValidationError, QuoteValidationErrorCode, type QuoteWarning, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, type SendEthTransactionRequest, type SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, 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 WithdrawAction, type WithdrawOutflowDetails, type WithdrawSubmitSignatureInfo, createTransferErc20Transaction, executeWith, intFromPublicId, publicIdFromInt };
+export { AccountsModule, ActivitiesModule, type ActivitiesRequest, type Activity, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, type ActivityTopUp, type ApySample, Asset, type AssetPrices, 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 CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type FindPoolQuery, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetEvmSupplyContextRequest, type HealthFactor, type HistoryEntry, HistoryModule, type IcrcAccountSupplyTarget, type InflowActivity, type InflowActivityKind, type InflowActivityStatus, type InflowFeeEstimate, InflowSubmitType, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanAuthorization, type InstantLoanBorrow, type InstantLoanCandidate, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanEvent, type InstantLoanEventType, type InstantLoanGetRequest, type InstantLoanInitialDeposit, type InstantLoanLeg, type InstantLoanListEventsRequest, type InstantLoanPositionSummary, type InstantLoanRepayment, InstantLoanStatus, type InstantLoanTerms, type InstantLoanWarmedProfile, InstantLoansModule, LendingModule, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type LiquidiumErrorContext, type ListActivitiesRequest, type LtvCalculation, type ManualTransferSupplyFlowRequest, type MarketAsset, type MarketChain, MarketModule, type MaxRepayAmount, type NativeAccount, type NativeAddressSupplyTarget, 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 SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, 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, intFromPublicId, publicIdFromInt };

package/dist/index.d.ts

@@ -321,7 +321,7 @@ type CreateProfileParams = {
 };
 /** Profile lifecycle and linked-wallet helpers. */
 declare class AccountsModule {
-    readonly canisterContext: CanisterContext;
+    private readonly canisterContext;
     constructor(canisterContext: CanisterContext);
     /**
      * Prepares a profile-creation action that can be signed and submitted later.
@@ -493,8 +493,8 @@ type GetActivityStatusResponse = {
 
 /** Receipt-oriented activity list and status helpers. */
 declare class ActivitiesModule {
-    readonly apiClient: ApiClient | undefined;
-    readonly canisterContext: CanisterContext;
+    private readonly apiClient;
+    private readonly canisterContext;
     constructor(apiClient: ApiClient | undefined, canisterContext: CanisterContext);
     /**
      * Lists profile activities. Defaults to all activities.
@@ -727,7 +727,7 @@ interface PaginatedResponse<T> {
 
 /** Historical pool, rate, user transaction, and liquidation data helpers. */
 declare class HistoryModule {
-    readonly apiClient: ApiClient | undefined;
+    private readonly apiClient;
     constructor(apiClient: ApiClient | undefined);
     private requireApi;
     /**
@@ -834,7 +834,7 @@ interface CreateBorrowRequest {
     poolId: string;
     /** Amount to borrow in the borrow asset's base units. */
     amount: bigint;
-    /** External-chain address that receives the borrowed asset. */
+    /** External-chain address that receives the borrowed asset. Must match the borrow pool chain. */
     receiverAddress: string;
     /** Wallet address that signs the borrow authorization. */
     signerWalletAddress: string;
@@ -863,7 +863,7 @@ interface CreateWithdrawRequest {
     poolId: string;
     /** Amount to withdraw in the pool asset's base units. */
     amount: bigint;
-    /** External-chain address that receives the withdrawn asset. */
+    /** External-chain address that receives the withdrawn asset. Must match the pool chain. */
     receiverAddress: string;
     /** Wallet address that signs the withdraw authorization. */
     signerWalletAddress: string;
@@ -1014,9 +1014,9 @@ interface EstimateInflowFeeRequest {
     /** Chain to estimate for. */
     chain: Chain;
 }
-/** Fee estimate for an inflow target. */
+/** Fee estimate for an inflow target, rounded up to the asset's fee unit. */
 interface InflowFeeEstimate {
-    /** Estimated total fee in the asset's base units. */
+    /** Estimated total fee rounded up in the asset's base units. */
     totalFee: bigint;
 }
 /** Request for ERC-20 approval and deposit planning. */
@@ -1080,9 +1080,9 @@ type WalletExecutionParams = {
 };
 /** Borrow, withdraw, supply, inflow reporting, and fee-estimation helpers. */
 declare class LendingModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
-    readonly evmReadClient: EvmReadClient | undefined;
+    private readonly canisterContext;
+    private readonly apiClient;
+    private readonly evmReadClient;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, evmReadClient: EvmReadClient | undefined);
     /**
      * Prepares a withdraw action that can be signed and submitted later.
@@ -1170,12 +1170,13 @@ declare class LendingModule {
      * Estimates the network/deposit fee for an inflow target.
      *
      * ETH stablecoin deposit-address estimates are served by the deposit-address
-     * canister. BTC estimates are not exposed by this SDK yet and return zero.
+     * canister. BTC estimates include the ckBTC minter deposit fee and ledger fee.
      *
      * @param request - Asset and chain pair to estimate for.
-     * @returns Total fee estimate in the asset's base units.
+     * @returns Total fee estimate rounded up in the asset's base units.
      */
     estimateInflowFee(request: EstimateInflowFeeRequest): Promise<InflowFeeEstimate>;
+    private estimateBtcInflowFee;
     private sendAndSubmitNativeSupplyInflow;
     private submitSupplyFlowInflow;
     private executeContractSupply;
@@ -1199,6 +1200,7 @@ declare class LendingModule {
     private requireApi;
     private requireEvmReadClient;
     private getPoolById;
+    private normalizeOutflowReceiverAddress;
     private sendEthContractTransaction;
     private waitForExpectedAllowance;
 }
@@ -1283,8 +1285,8 @@ interface PoolRate {
 
 /** Pool metadata, prices, and current rate helpers. */
 declare class MarketModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
+    private readonly canisterContext;
+    private readonly apiClient;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined);
     /**
      * Lists all pools with their current rates.
@@ -1422,7 +1424,7 @@ interface MaxRepayAmount {
 
 /** Profile position, health factor, and reserve valuation helpers. */
 declare class PositionsModule {
-    readonly canisterContext: CanisterContext;
+    private readonly canisterContext;
     readonly market: MarketModule;
     constructor(canisterContext: CanisterContext, market: MarketModule);
     /**
@@ -1470,7 +1472,7 @@ declare class PositionsModule {
      * Returns the per-reserve breakdown of a profile's supplies and borrows,
      * joined with pool metadata, rates, and current USD prices.
      *
-     * USD values are scaled to {@link USD_VALUE_SCALE_DECIMALS} (27).
+     * USD values are scaled to 27 decimals.
      *
      * @param profileId - The Liquidium profile principal text.
      * @returns Per-reserve position rows joined with pool metadata and USD values.
@@ -1574,11 +1576,13 @@ interface CreateInstantLoanRequest {
      */
     borrowAsset: InstantLoanAsset;
     /**
-     * Amount the user is expected to deposit as collateral, in base units.
+     * Intended credited collateral amount, in base units.
      *
-     * This is used to validate LTV and initialize the loan record. For BTC, pass
-     * satoshis. For token assets, convert the UI amount using the selected pool's
-     * `decimals` value.
+     * This is used to validate LTV and initialize the loan record before
+     * deposit/inflow fees are deducted. For BTC, pass satoshis. For token assets,
+     * convert the UI amount using the selected pool's `decimals` value. After
+     * creation, use `loan.initialDeposit.amount` as the fee-inclusive transfer
+     * amount to send to `loan.initialDeposit.target`.
      */
     collateralAmount: bigint;
     /**
@@ -1736,6 +1740,23 @@ interface InstantLoanRepayment {
     /** Address or ICRC account where the repayment should be sent. */
     target: SupplyTarget;
 }
+/** Initial collateral deposit quote returned when an instant loan is created. */
+interface InstantLoanInitialDeposit {
+    /** Full amount to send to the deposit target, including the estimated inflow fee. */
+    amount: bigint;
+    /** Decimal scale for `amount`, `collateralAmount`, and `inflowFeeAmount`. */
+    decimals: bigint;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    collateralAmount: bigint;
+    /** Inflow fee amount in base units added to the transfer amount. */
+    inflowFeeAmount: bigint;
+    /** Collateral asset to deposit. */
+    asset: MarketAsset;
+    /** Chain used for the collateral deposit. */
+    chain: MarketChain;
+    /** Address or ICRC account where the collateral should be sent. */
+    target: SupplyTarget;
+}
 /** Current lending position backing the instant loan. */
 interface InstantLoanPositionSummary {
     /** Current collateral amount in the collateral asset's base units. */
@@ -1760,9 +1781,45 @@ declare const InstantLoanStatus: {
     readonly active: "active";
     readonly settling: "settling";
     readonly closed: "closed";
+    readonly expired: "expired";
 };
 type InstantLoanStatus = (typeof InstantLoanStatus)[keyof typeof InstantLoanStatus];
-/** Hydrated instant-loan state plus generated deposit and repayment targets. */
+/** Immutable terms selected for an instant loan. */
+interface InstantLoanTerms {
+    /** Maximum loan-to-value ratio in basis points. */
+    ltvMaxBps: bigint;
+    /** Seconds allowed for the collateral deposit before timeout. */
+    depositWindowSeconds: bigint;
+}
+/** Collateral leg selected for an instant loan. */
+interface InstantLoanCollateral {
+    /** Principal text of the collateral pool. */
+    poolId: string;
+    /** Collateral asset symbol. */
+    asset: MarketAsset;
+    /** Chain used for collateral deposits. */
+    chain: MarketChain;
+    /** Decimal scale for collateral amounts. */
+    decimals: bigint;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    amount: bigint;
+}
+/** Borrow leg selected for an instant loan. */
+interface InstantLoanBorrow {
+    /** Principal text of the borrow pool. */
+    poolId: string;
+    /** Borrow asset symbol. */
+    asset: MarketAsset;
+    /** Chain used for repayment. */
+    chain: MarketChain;
+    /** Decimal scale for borrow and debt amounts. */
+    decimals: bigint;
+    /** Requested borrow amount in base units. */
+    amount: bigint;
+    /** Destination that receives the borrowed asset. */
+    destination: InstantLoanAccount;
+}
+/** Hydrated instant-loan state plus generated quote targets. */
 interface InstantLoan {
     /** Canister-assigned loan id. */
     loanId: bigint;
@@ -1772,32 +1829,17 @@ interface InstantLoan {
     status: InstantLoanStatus;
     /** Generated lending profile principal used by the instant loan. */
     profileId: string;
-    /** Maximum loan-to-value ratio in basis points. */
-    ltvMaxBps: bigint;
-    /** Seconds allowed for the collateral deposit before timeout. */
-    depositWindowSeconds: bigint;
-    /** Collateral-side pool, asset, chain, and current or requested collateral amount. */
-    collateral: {
-        poolId: string;
-        asset: MarketAsset;
-        chain: MarketChain;
-        amount: bigint;
-    };
-    /** Borrow-side pool, asset, chain, requested amount, and destination. */
-    borrow: {
-        poolId: string;
-        asset: MarketAsset;
-        chain: MarketChain;
-        amount: bigint;
-        destination: InstantLoanAccount;
-    };
+    /** Immutable loan terms. */
+    terms: InstantLoanTerms;
+    /** Collateral-side pool, asset, chain, decimals, and requested credited amount. */
+    collateral: InstantLoanCollateral;
+    /** Borrow-side pool, asset, chain, decimals, requested amount, and destination. */
+    borrow: InstantLoanBorrow;
     /** Destination used for collateral refunds or withdrawals. */
     refundDestination: InstantLoanAccount;
-    /** Address or ICRC account where the user deposits collateral. */
-    depositTarget: SupplyTarget;
-    /** Address or ICRC account where the user repays debt. */
-    repayTarget: SupplyTarget;
-    /** Current actionable repayment quote. */
+    /** Current actionable initial collateral deposit quote. */
+    initialDeposit: InstantLoanInitialDeposit;
+    /** Current repayment quote. Amount fields are zero when the loan has no debt. */
     repayment: InstantLoanRepayment;
     /** Current lending position state for the generated profile. */
     position: InstantLoanPositionSummary;
@@ -1825,20 +1867,20 @@ interface InstantLoanCandidate {
     collateralAsset: MarketAsset;
     /** Borrow asset symbol. */
     borrowAsset: MarketAsset;
-    /** Collateral amount hint in base units. */
-    collateralAmountHint: bigint;
+    /** Collateral amount in base units. */
+    collateralAmount: bigint;
 }
 
 /** Accountless instant-loan creation, lookup, recovery, and canister query helpers. */
 declare class InstantLoansModule {
-    readonly canisterContext: CanisterContext;
-    readonly apiClient: ApiClient | undefined;
-    readonly lending: LendingModule;
-    readonly positions: PositionsModule;
+    private readonly canisterContext;
+    private readonly apiClient;
+    private readonly lending;
+    private readonly positions;
     constructor(canisterContext: CanisterContext, apiClient: ApiClient | undefined, lending: LendingModule, positions: PositionsModule);
     /**
      * Creates a profileless instant loan and returns canonical canister state plus
-     * deposit/repay targets for the generated lending profile.
+     * generated initial-deposit and repayment quote targets.
      *
      * Choose `collateralPoolId` and `borrowPoolId` from
      * `client.market.listPools()`, convert UI amounts to base units with the
@@ -1851,7 +1893,7 @@ declare class InstantLoansModule {
      * SDK maps it to the canister's internal `ltv_timer_s` field.
      *
      * @param request - Pool ids, assets, base-unit amounts, LTV limit, timeout, and destinations.
-     * @returns Hydrated loan state plus generated deposit and repayment targets.
+     * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     create(request: CreateInstantLoanRequest): Promise<InstantLoan>;
     /**
@@ -1861,7 +1903,7 @@ declare class InstantLoansModule {
      * from the instant-loans canister.
      *
      * @param request - Canister loan id or short public reference.
-     * @returns Hydrated loan state plus generated deposit and repayment targets.
+     * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     get(request: InstantLoanGetRequest): Promise<InstantLoan>;
     /**
@@ -1914,8 +1956,10 @@ declare class InstantLoansModule {
      */
     findByAddress(address: string): Promise<InstantLoanCandidate[]>;
     private mapLoanRecord;
+    private getCollateralAmountHint;
     private mapLoanWire;
     private hydrateLoan;
+    private createInitialDepositQuote;
     private estimateRepaymentInflowFee;
     private requireApi;
     private validateInstantLoanLtvPolicy;
@@ -2213,4 +2257,4 @@ interface ExecuteWithOptions {
  */
 declare function executeWith(options: ExecuteWithOptions): <TResult>(action: WalletAction<TResult>) => Promise<TResult>;
 
-export { type ActivitiesRequest, type Activity, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, type ApySample, Asset, type AssetPrices, 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 CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetEvmSupplyContextRequest, type HealthFactor, type HistoryEntry, type IcrcAccountSupplyTarget, type InflowActivity, type InflowActivityKind, type InflowActivityStatus, type InflowFeeEstimate, InflowSubmitType, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanCandidate, type InstantLoanGetRequest, InstantLoanStatus, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type ListActivitiesRequest, type LtvCalculation, type MarketAsset, type MarketChain, type NativeAccount, type NativeAddressSupplyTarget, 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, type QuoteRequest, type QuoteResult, type QuoteValidationError, QuoteValidationErrorCode, type QuoteWarning, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, type SendEthTransactionRequest, type SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, 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 WithdrawAction, type WithdrawOutflowDetails, type WithdrawSubmitSignatureInfo, createTransferErc20Transaction, executeWith, intFromPublicId, publicIdFromInt };
+export { AccountsModule, ActivitiesModule, type ActivitiesRequest, type Activity, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, type ActivityTopUp, type ApySample, Asset, type AssetPrices, 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 CreateWithdrawData, type CreateWithdrawRequest, Environment, type EstimateInflowFeeRequest, type EthTransactionRequest, type EvmReadClient, EvmSupplyApprovalStrategy, type EvmSupplyContext, type ExecuteWithOptions, type ExternalAccount, type FindPoolQuery, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetEvmSupplyContextRequest, type HealthFactor, type HistoryEntry, HistoryModule, type IcrcAccountSupplyTarget, type InflowActivity, type InflowActivityKind, type InflowActivityStatus, type InflowFeeEstimate, InflowSubmitType, type InstantLoan, type InstantLoanAccount, type InstantLoanAsset, type InstantLoanAuthorization, type InstantLoanBorrow, type InstantLoanCandidate, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanEvent, type InstantLoanEventType, type InstantLoanGetRequest, type InstantLoanInitialDeposit, type InstantLoanLeg, type InstantLoanListEventsRequest, type InstantLoanPositionSummary, type InstantLoanRepayment, InstantLoanStatus, type InstantLoanTerms, type InstantLoanWarmedProfile, InstantLoansModule, LendingModule, LiquidiumClient, type LiquidiumClientConfig, LiquidiumError, LiquidiumErrorCode, type LiquidiumErrorContext, type ListActivitiesRequest, type LtvCalculation, type ManualTransferSupplyFlowRequest, type MarketAsset, type MarketChain, MarketModule, type MaxRepayAmount, type NativeAccount, type NativeAddressSupplyTarget, 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 SendEthTransactionWalletAction, type SignMessageRequest, type SignMessageWalletAction, type SignPsbtRequest, 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, intFromPublicId, publicIdFromInt };