@liquidium/client 0.2.1 → 0.3.1

package/dist/index.d.cts

@@ -308,7 +308,7 @@ interface CreateProfileParams {
 }
 /** Data embedded in a prepared profile-creation action. */
 interface CreateAccountData {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Sign-message action that can be submitted after wallet signing. */
@@ -901,7 +901,7 @@ interface CreateBorrowRequest {
 }
 /** Prepared borrow request data embedded in the signable action. */
 interface CreateBorrowData extends CreateBorrowRequest {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Prepared action for creating a borrow outflow. */
@@ -930,7 +930,7 @@ interface CreateWithdrawRequest {
 }
 /** Prepared withdraw request data embedded in the signable action. */
 interface CreateWithdrawData extends CreateWithdrawRequest {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Prepared action for creating a withdraw outflow. */
@@ -1321,7 +1321,7 @@ interface Pool {
     borrowIndex: bigint;
     /** Whether borrowing the same asset as collateral is allowed. */
     sameAssetBorrowing: boolean;
-    /** Last pool update timestamp when available. */
+    /** Unix timestamp in seconds of the last pool update when available. */
     lastUpdated?: bigint;
 }
 /** USD price map keyed by market asset symbol. */
@@ -1394,7 +1394,7 @@ interface Position {
     poolId: string;
     /** Pool asset symbol. */
     asset: MarketAsset;
-    /** Supplied principal in base units. */
+    /** Current supplied amount in base units. */
     deposited: bigint;
     /** Decimal scale for supplied amounts. */
     depositedDecimals: bigint;
@@ -1406,7 +1406,7 @@ interface Position {
     earnedInterest: bigint;
     /** Accrued borrow interest in base units. */
     debtInterest: bigint;
-    /** Protocol timestamp of the last position update. */
+    /** Unix timestamp in seconds of the last position update. */
     lastUpdate: bigint;
 }
 /** Aggregate borrowing capacity for a profile. */
@@ -1483,6 +1483,13 @@ interface MaxRepayAmount {
     /** Decimal scale for `amount`. */
     decimals: bigint;
 }
+/** Full withdraw amount for a position. */
+interface FullWithdrawAmount {
+    /** Amount to withdraw in the supplied asset's base units. */
+    amount: bigint;
+    /** Decimal scale for `amount`. */
+    decimals: bigint;
+}
 
 /** Profile position, health factor, and reserve valuation helpers. */
 declare class PositionsModule {
@@ -1550,6 +1557,18 @@ declare class PositionsModule {
      * @returns Buffered repayment amount in the borrowed asset's base units.
      */
     getMaxRepayAmount(profileId: string, poolId: string, bufferBps?: bigint): Promise<MaxRepayAmount>;
+    /**
+     * Returns the current full withdraw amount for a position.
+     *
+     * `Position.deposited` already reflects the current supplied balance at the
+     * latest lending index; do not add `earnedInterest` to this amount.
+     * Pass `amount` to withdraw calls and use `decimals` for display formatting.
+     *
+     * @param profileId - The Liquidium profile principal text.
+     * @param poolId - The pool principal text.
+     * @returns Full withdraw amount in the supplied asset's base units.
+     */
+    getFullWithdrawAmount(profileId: string, poolId: string): Promise<FullWithdrawAmount>;
 }
 
 /** Builds calldata for an ERC-20 `transfer(recipient, amount)` transaction. */
@@ -1693,6 +1712,37 @@ interface InstantLoanGetByRefRequest {
 }
 /** Lookup request for loading canonical instant-loan state. */
 type InstantLoanGetRequest = InstantLoanGetByIdRequest | InstantLoanGetByRefRequest;
+/** Collateral leg returned by instant-loan search. */
+interface InstantLoanFindCollateral {
+    /** Principal text of the collateral pool. */
+    poolId: string;
+    /** Asset the user deposits as collateral. */
+    asset: InstantLoanAsset;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    amount: bigint;
+}
+/** Borrow leg returned by instant-loan search. */
+interface InstantLoanFindBorrow {
+    /** Principal text of the borrow pool. */
+    poolId: string;
+    /** Asset the user borrows. */
+    asset: InstantLoanAsset;
+}
+/** Lightweight search result for an instant loan match. */
+interface InstantLoanFindResult {
+    /** Canister-assigned loan id. Use this with `client.instantLoans.get({ loanId })` to load full loan state. */
+    loanId: bigint;
+    /** Short user-facing reference derived from `loanId`. */
+    ref: string;
+    /** Unix creation timestamp in seconds. */
+    createdAt: bigint;
+    /** Collateral-side pool, asset, and requested credited amount. */
+    collateral: InstantLoanFindCollateral;
+    /** Borrow-side pool and asset. */
+    borrow: InstantLoanFindBorrow;
+    /** Generated profile principal from the search index. */
+    profileId: string;
+}
 /** Page request for direct instant-loan canister event queries. */
 interface InstantLoanListEventsRequest {
     /** Event id to start from. */
@@ -1716,6 +1766,7 @@ interface InstantLoanAuthorization {
 interface InstantLoanWarmedProfile {
     id: bigint;
     authorization: InstantLoanAuthorization;
+    /** Unix creation timestamp in seconds. */
     createdAt: bigint;
     profileId: string;
 }
@@ -1723,6 +1774,7 @@ interface InstantLoanWarmedProfile {
 interface InstantLoanEvent {
     id: bigint;
     schemaVersion: number;
+    /** Unix event timestamp in seconds. */
     timestamp: bigint;
     eventType: InstantLoanEventType;
 }
@@ -1790,6 +1842,7 @@ interface InstantLoanRepayCompleteEventType {
 interface InstantLoanDepositTimerStartedEventType {
     type: "DepositTimerStarted";
     loanId: bigint;
+    /** Unix timestamp in seconds when the deposit timer started. */
     timestamp: bigint;
 }
 /** Direct canister event payload returned by instant-loans event queries. */
@@ -1833,6 +1886,10 @@ interface InstantLoanInitialDeposit {
     chain: MarketChain;
     /** Address or ICRC account where the collateral should be sent. */
     target: SupplyTarget;
+    /** Unix timestamp in seconds when the collateral deposit was detected, or null before detection. */
+    detectedTimestamp: bigint | null;
+    /** Unix timestamp in seconds when the collateral deposit window expires, or null before detection when unavailable. */
+    expiryTimestamp: bigint | null;
 }
 /** Current lending position backing the instant loan. */
 interface InstantLoanPositionSummary {
@@ -1904,7 +1961,7 @@ interface InstantLoan {
     ref: string;
     /** Simplified lifecycle status for display and flow control. */
     status: InstantLoanStatus;
-    /** Generated lending profile principal used by the instant loan. */
+    /** Generated profile principal used by the instant loan. */
     profileId: string;
     /** Immutable loan terms. */
     terms: InstantLoanTerms;
@@ -1921,32 +1978,6 @@ interface InstantLoan {
     /** Current lending position state for the generated profile. */
     position: InstantLoanPositionSummary;
 }
-/**
- * Discovery result returned by address lookup.
- *
- * Candidates are intentionally lightweight; call `instantLoans.get(...)` with
- * `loanId` or `ref` to load canonical canister state and transfer targets.
- */
-interface InstantLoanCandidate {
-    /** Canister-assigned loan id. */
-    loanId: bigint;
-    /** Short user-facing reference derived from `loanId`. */
-    ref: string;
-    /** Generated lending profile principal used by the instant loan. */
-    profileId: string;
-    /** API-observed creation time, if provided by the indexer. */
-    createdAt?: Date;
-    /** Principal text of the collateral pool. */
-    collateralPoolId: string;
-    /** Principal text of the borrow pool. */
-    borrowPoolId: string;
-    /** Collateral asset symbol. */
-    collateralAsset: MarketAsset;
-    /** Borrow asset symbol. */
-    borrowAsset: MarketAsset;
-    /** Collateral amount in base units. */
-    collateralAmount: bigint;
-}
 
 /** Accountless instant-loan creation, lookup, recovery, and canister query helpers. */
 declare class InstantLoansModule {
@@ -1983,6 +2014,16 @@ declare class InstantLoansModule {
      * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     get(request: InstantLoanGetRequest): Promise<InstantLoan>;
+    /**
+     * Finds instant loans by short reference, numeric loan id string, address, or transaction id.
+     *
+     * Search returns lightweight matches. Call `get({ loanId })` or `get({ ref })`
+     * when the user selects a match and you need hydrated loan state.
+     *
+     * @param query - Short reference, address, transaction id/hash, or numeric loan id string.
+     * @returns Matching loan ids and references from the search index.
+     */
+    find(query: string): Promise<InstantLoanFindResult[]>;
     /**
      * Returns the active instant-loans canister config via direct query.
      *
@@ -2021,20 +2062,10 @@ declare class InstantLoansModule {
      * @returns Warmed profile records available for assignment.
      */
     listWarmedProfiles(): Promise<InstantLoanWarmedProfile[]>;
-    /**
-     * Finds candidate loans associated with an address through the Liquidium SDK
-     * API. Returns discovery candidates only; call `get(...)` to hydrate canister state.
-     *
-     * Candidates are useful for recovery flows where the user knows a borrow or
-     * refund address but not the loan reference.
-     *
-     * @param address - Borrow or refund address to search for.
-     * @returns Lightweight loan candidates associated with the address.
-     */
-    findByAddress(address: string): Promise<InstantLoanCandidate[]>;
+    private findCandidateLoansByQuery;
+    private getLoanRecord;
     private mapLoanRecord;
     private getCollateralAmountHint;
-    private mapLoanWire;
     private hydrateLoan;
     private createInitialDepositQuote;
     private estimateRepaymentInflowFee;
@@ -2348,4 +2379,4 @@ interface ExecuteWithOptions {
  */
 declare function executeWith(options: ExecuteWithOptions): <TResult>(action: WalletAction<TResult>) => Promise<TResult>;
 
-export { 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 GetActivityStatusByProfileRequest, type GetActivityStatusByShortRefRequest, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetDepositAddressRequest, 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 InstantLoanBorrowRequestedEventType, type InstantLoanCandidate, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanCreatedEventType, type InstantLoanDepositTimerExceededEventType, type InstantLoanDepositTimerStartedEventType, type InstantLoanEvent, type InstantLoanEventType, 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 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 { 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 IcrcAccountSupplyTarget, 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 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 };

package/dist/index.d.ts

@@ -308,7 +308,7 @@ interface CreateProfileParams {
 }
 /** Data embedded in a prepared profile-creation action. */
 interface CreateAccountData {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Sign-message action that can be submitted after wallet signing. */
@@ -901,7 +901,7 @@ interface CreateBorrowRequest {
 }
 /** Prepared borrow request data embedded in the signable action. */
 interface CreateBorrowData extends CreateBorrowRequest {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Prepared action for creating a borrow outflow. */
@@ -930,7 +930,7 @@ interface CreateWithdrawRequest {
 }
 /** Prepared withdraw request data embedded in the signable action. */
 interface CreateWithdrawData extends CreateWithdrawRequest {
-    /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
+    /** Unix expiry timestamp in seconds, included in the signed message. */
     expiryTimestamp: bigint;
 }
 /** Prepared action for creating a withdraw outflow. */
@@ -1321,7 +1321,7 @@ interface Pool {
     borrowIndex: bigint;
     /** Whether borrowing the same asset as collateral is allowed. */
     sameAssetBorrowing: boolean;
-    /** Last pool update timestamp when available. */
+    /** Unix timestamp in seconds of the last pool update when available. */
     lastUpdated?: bigint;
 }
 /** USD price map keyed by market asset symbol. */
@@ -1394,7 +1394,7 @@ interface Position {
     poolId: string;
     /** Pool asset symbol. */
     asset: MarketAsset;
-    /** Supplied principal in base units. */
+    /** Current supplied amount in base units. */
     deposited: bigint;
     /** Decimal scale for supplied amounts. */
     depositedDecimals: bigint;
@@ -1406,7 +1406,7 @@ interface Position {
     earnedInterest: bigint;
     /** Accrued borrow interest in base units. */
     debtInterest: bigint;
-    /** Protocol timestamp of the last position update. */
+    /** Unix timestamp in seconds of the last position update. */
     lastUpdate: bigint;
 }
 /** Aggregate borrowing capacity for a profile. */
@@ -1483,6 +1483,13 @@ interface MaxRepayAmount {
     /** Decimal scale for `amount`. */
     decimals: bigint;
 }
+/** Full withdraw amount for a position. */
+interface FullWithdrawAmount {
+    /** Amount to withdraw in the supplied asset's base units. */
+    amount: bigint;
+    /** Decimal scale for `amount`. */
+    decimals: bigint;
+}
 
 /** Profile position, health factor, and reserve valuation helpers. */
 declare class PositionsModule {
@@ -1550,6 +1557,18 @@ declare class PositionsModule {
      * @returns Buffered repayment amount in the borrowed asset's base units.
      */
     getMaxRepayAmount(profileId: string, poolId: string, bufferBps?: bigint): Promise<MaxRepayAmount>;
+    /**
+     * Returns the current full withdraw amount for a position.
+     *
+     * `Position.deposited` already reflects the current supplied balance at the
+     * latest lending index; do not add `earnedInterest` to this amount.
+     * Pass `amount` to withdraw calls and use `decimals` for display formatting.
+     *
+     * @param profileId - The Liquidium profile principal text.
+     * @param poolId - The pool principal text.
+     * @returns Full withdraw amount in the supplied asset's base units.
+     */
+    getFullWithdrawAmount(profileId: string, poolId: string): Promise<FullWithdrawAmount>;
 }
 
 /** Builds calldata for an ERC-20 `transfer(recipient, amount)` transaction. */
@@ -1693,6 +1712,37 @@ interface InstantLoanGetByRefRequest {
 }
 /** Lookup request for loading canonical instant-loan state. */
 type InstantLoanGetRequest = InstantLoanGetByIdRequest | InstantLoanGetByRefRequest;
+/** Collateral leg returned by instant-loan search. */
+interface InstantLoanFindCollateral {
+    /** Principal text of the collateral pool. */
+    poolId: string;
+    /** Asset the user deposits as collateral. */
+    asset: InstantLoanAsset;
+    /** Intended credited collateral amount in base units, before inflow fees. */
+    amount: bigint;
+}
+/** Borrow leg returned by instant-loan search. */
+interface InstantLoanFindBorrow {
+    /** Principal text of the borrow pool. */
+    poolId: string;
+    /** Asset the user borrows. */
+    asset: InstantLoanAsset;
+}
+/** Lightweight search result for an instant loan match. */
+interface InstantLoanFindResult {
+    /** Canister-assigned loan id. Use this with `client.instantLoans.get({ loanId })` to load full loan state. */
+    loanId: bigint;
+    /** Short user-facing reference derived from `loanId`. */
+    ref: string;
+    /** Unix creation timestamp in seconds. */
+    createdAt: bigint;
+    /** Collateral-side pool, asset, and requested credited amount. */
+    collateral: InstantLoanFindCollateral;
+    /** Borrow-side pool and asset. */
+    borrow: InstantLoanFindBorrow;
+    /** Generated profile principal from the search index. */
+    profileId: string;
+}
 /** Page request for direct instant-loan canister event queries. */
 interface InstantLoanListEventsRequest {
     /** Event id to start from. */
@@ -1716,6 +1766,7 @@ interface InstantLoanAuthorization {
 interface InstantLoanWarmedProfile {
     id: bigint;
     authorization: InstantLoanAuthorization;
+    /** Unix creation timestamp in seconds. */
     createdAt: bigint;
     profileId: string;
 }
@@ -1723,6 +1774,7 @@ interface InstantLoanWarmedProfile {
 interface InstantLoanEvent {
     id: bigint;
     schemaVersion: number;
+    /** Unix event timestamp in seconds. */
     timestamp: bigint;
     eventType: InstantLoanEventType;
 }
@@ -1790,6 +1842,7 @@ interface InstantLoanRepayCompleteEventType {
 interface InstantLoanDepositTimerStartedEventType {
     type: "DepositTimerStarted";
     loanId: bigint;
+    /** Unix timestamp in seconds when the deposit timer started. */
     timestamp: bigint;
 }
 /** Direct canister event payload returned by instant-loans event queries. */
@@ -1833,6 +1886,10 @@ interface InstantLoanInitialDeposit {
     chain: MarketChain;
     /** Address or ICRC account where the collateral should be sent. */
     target: SupplyTarget;
+    /** Unix timestamp in seconds when the collateral deposit was detected, or null before detection. */
+    detectedTimestamp: bigint | null;
+    /** Unix timestamp in seconds when the collateral deposit window expires, or null before detection when unavailable. */
+    expiryTimestamp: bigint | null;
 }
 /** Current lending position backing the instant loan. */
 interface InstantLoanPositionSummary {
@@ -1904,7 +1961,7 @@ interface InstantLoan {
     ref: string;
     /** Simplified lifecycle status for display and flow control. */
     status: InstantLoanStatus;
-    /** Generated lending profile principal used by the instant loan. */
+    /** Generated profile principal used by the instant loan. */
     profileId: string;
     /** Immutable loan terms. */
     terms: InstantLoanTerms;
@@ -1921,32 +1978,6 @@ interface InstantLoan {
     /** Current lending position state for the generated profile. */
     position: InstantLoanPositionSummary;
 }
-/**
- * Discovery result returned by address lookup.
- *
- * Candidates are intentionally lightweight; call `instantLoans.get(...)` with
- * `loanId` or `ref` to load canonical canister state and transfer targets.
- */
-interface InstantLoanCandidate {
-    /** Canister-assigned loan id. */
-    loanId: bigint;
-    /** Short user-facing reference derived from `loanId`. */
-    ref: string;
-    /** Generated lending profile principal used by the instant loan. */
-    profileId: string;
-    /** API-observed creation time, if provided by the indexer. */
-    createdAt?: Date;
-    /** Principal text of the collateral pool. */
-    collateralPoolId: string;
-    /** Principal text of the borrow pool. */
-    borrowPoolId: string;
-    /** Collateral asset symbol. */
-    collateralAsset: MarketAsset;
-    /** Borrow asset symbol. */
-    borrowAsset: MarketAsset;
-    /** Collateral amount in base units. */
-    collateralAmount: bigint;
-}
 
 /** Accountless instant-loan creation, lookup, recovery, and canister query helpers. */
 declare class InstantLoansModule {
@@ -1983,6 +2014,16 @@ declare class InstantLoansModule {
      * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
      */
     get(request: InstantLoanGetRequest): Promise<InstantLoan>;
+    /**
+     * Finds instant loans by short reference, numeric loan id string, address, or transaction id.
+     *
+     * Search returns lightweight matches. Call `get({ loanId })` or `get({ ref })`
+     * when the user selects a match and you need hydrated loan state.
+     *
+     * @param query - Short reference, address, transaction id/hash, or numeric loan id string.
+     * @returns Matching loan ids and references from the search index.
+     */
+    find(query: string): Promise<InstantLoanFindResult[]>;
     /**
      * Returns the active instant-loans canister config via direct query.
      *
@@ -2021,20 +2062,10 @@ declare class InstantLoansModule {
      * @returns Warmed profile records available for assignment.
      */
     listWarmedProfiles(): Promise<InstantLoanWarmedProfile[]>;
-    /**
-     * Finds candidate loans associated with an address through the Liquidium SDK
-     * API. Returns discovery candidates only; call `get(...)` to hydrate canister state.
-     *
-     * Candidates are useful for recovery flows where the user knows a borrow or
-     * refund address but not the loan reference.
-     *
-     * @param address - Borrow or refund address to search for.
-     * @returns Lightweight loan candidates associated with the address.
-     */
-    findByAddress(address: string): Promise<InstantLoanCandidate[]>;
+    private findCandidateLoansByQuery;
+    private getLoanRecord;
     private mapLoanRecord;
     private getCollateralAmountHint;
-    private mapLoanWire;
     private hydrateLoan;
     private createInitialDepositQuote;
     private estimateRepaymentInflowFee;
@@ -2348,4 +2379,4 @@ interface ExecuteWithOptions {
  */
 declare function executeWith(options: ExecuteWithOptions): <TResult>(action: WalletAction<TResult>) => Promise<TResult>;
 
-export { 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 GetActivityStatusByProfileRequest, type GetActivityStatusByShortRefRequest, type GetActivityStatusRequest, type GetActivityStatusResponse, type GetDepositAddressRequest, 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 InstantLoanBorrowRequestedEventType, type InstantLoanCandidate, type InstantLoanCollateral, type InstantLoanConfig, type InstantLoanCreatedEventType, type InstantLoanDepositTimerExceededEventType, type InstantLoanDepositTimerStartedEventType, type InstantLoanEvent, type InstantLoanEventType, 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 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 { 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 IcrcAccountSupplyTarget, 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 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 };