@liquidium/client 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -226,6 +226,16 @@ interface SignatureInfo {
     /** Account that produced the signature, when different from the action default. */
     account?: string;
 }
+/** Request submitted after a BTC PSBT has been signed. */
+interface SignPsbtSubmitRequest {
+    /** Base64-encoded signed PSBT. */
+    signedPsbtBase64: string;
+}
+/** Request submitted after an ETH transaction has been sent. */
+interface SendEthTransactionSubmitRequest {
+    /** EVM transaction hash returned by the wallet. */
+    txHash: string;
+}
 /** Prepared action that requires message signing before submit. */
 interface SignMessageWalletAction<TData, TResult> {
     /** Protocol action kind. */
@@ -260,9 +270,7 @@ interface SignPsbtWalletAction<TResult> {
     /** Base64-encoded unsigned PSBT. */
     psbtBase64: string;
     /** Submits the signed PSBT and resolves the protocol result. */
-    submit(request: {
-        signedPsbtBase64: string;
-    }): Promise<TResult>;
+    submit(request: SignPsbtSubmitRequest): Promise<TResult>;
 }
 /** Prepared action that requires sending an ETH transaction before submit. */
 interface SendEthTransactionWalletAction<TResult> {
@@ -279,13 +287,25 @@ interface SendEthTransactionWalletAction<TResult> {
     /** EVM transaction request to send. */
     transaction: EthTransactionRequest;
     /** Submits the transaction hash and resolves the protocol result. */
-    submit(request: {
-        txHash: string;
-    }): Promise<TResult>;
+    submit(request: SendEthTransactionSubmitRequest): Promise<TResult>;
 }
 /** Any prepared action returned by SDK methods and executable by {@link executeWith}. */
 type WalletAction<TResult> = SignMessageWalletAction<unknown, TResult> | SignPsbtWalletAction<TResult> | SendEthTransactionWalletAction<TResult>;
 
+/** Options for preparing a profile-creation action. */
+interface PrepareCreateProfileOptions {
+    /** Wallet address that will own the new profile. */
+    account: string;
+}
+/** Parameters for creating a profile through a wallet adapter. */
+interface CreateProfileParams {
+    /** Wallet address that will own the new profile. */
+    account: string;
+    /** Chain used to sign the profile-creation message. */
+    chain: Chain;
+    /** Wallet adapter used to sign the profile-creation message. */
+    walletAdapter: WalletAdapter;
+}
 /** Data embedded in a prepared profile-creation action. */
 interface CreateAccountData {
     /** Expiry timestamp, in protocol nanoseconds, included in the signed message. */
@@ -311,14 +331,6 @@ interface CreateAccountRequest {
     signatureInfo: SignatureInfo;
 }
 
-type PrepareCreateProfileOptions = {
-    account: string;
-};
-type CreateProfileParams = {
-    account: string;
-    chain: Chain;
-    walletAdapter: WalletAdapter;
-};
 /** Profile lifecycle and linked-wallet helpers. */
 declare class AccountsModule {
     private readonly canisterContext;
@@ -464,32 +476,56 @@ interface OutflowActivity extends BaseActivity {
 }
 /** Any activity returned by `activities.list` or `activities.getStatus`. */
 type Activity = InflowActivity | OutflowActivity;
-/** Request for listing activities by profile id or instant-loan short reference. */
-type ListActivitiesRequest = {
+/** Shared request fields for listing activities. */
+interface BaseListActivitiesRequest {
     /** Optional state filter; defaults to `all`. */
     filter?: ActivityFilter;
-} & ({
+}
+/** Activity list request scoped to a Liquidium profile. */
+interface ListActivitiesByProfileRequest extends BaseListActivitiesRequest {
+    /** Profile principal text to list activities for. */
     profileId: string;
-} | {
+}
+/** Activity list request scoped to an instant-loan short reference. */
+interface ListActivitiesByShortRefRequest extends BaseListActivitiesRequest {
+    /** Instant-loan short reference to list activities for. */
     shortRef: string;
-});
-/** Request for fetching one activity by id and owner identifier. */
-type GetActivityStatusRequest = {
+}
+/** Request for listing activities by profile id or instant-loan short reference. */
+type ListActivitiesRequest = ListActivitiesByProfileRequest | ListActivitiesByShortRefRequest;
+/** Shared request fields for an activity status lookup. */
+interface BaseGetActivityStatusRequest {
     /** Activity or receipt id to look up. */
     id: string;
-} & ({
+}
+/** Activity status lookup scoped to a Liquidium profile. */
+interface GetActivityStatusByProfileRequest extends BaseGetActivityStatusRequest {
+    /** Profile principal text that owns the activity. */
     profileId: string;
-} | {
+}
+/** Activity status lookup scoped to an instant-loan short reference. */
+interface GetActivityStatusByShortRefRequest extends BaseGetActivityStatusRequest {
+    /** Instant-loan short reference that owns the activity. */
     shortRef: string;
-});
-/** Result of an activity status lookup. */
-type GetActivityStatusResponse = {
+}
+/** Request for fetching one activity by id and owner identifier. */
+type GetActivityStatusRequest = GetActivityStatusByProfileRequest | GetActivityStatusByShortRefRequest;
+/** Successful activity status lookup result. */
+interface ActivityStatusFoundResponse {
+    /** Indicates the activity was found. */
     found: true;
+    /** Matched activity. */
     activity: Activity;
-} | {
+}
+/** Missing activity status lookup result. */
+interface ActivityStatusNotFoundResponse {
+    /** Indicates the activity was not found. */
     found: false;
+    /** Requested activity or receipt id. */
     id: string;
-};
+}
+/** Result of an activity status lookup. */
+type GetActivityStatusResponse = ActivityStatusFoundResponse | ActivityStatusNotFoundResponse;
 
 /** Receipt-oriented activity list and status helpers. */
 declare class ActivitiesModule {
@@ -774,6 +810,29 @@ declare class HistoryModule {
     getLiquidationHistory(user: string, market?: string, filters?: UserLiquidationHistoryFilters): Promise<PaginatedResponse<UserLiquidationHistoryEntry>>;
 }
 
+/** Wallet execution dependencies for borrow and withdraw convenience methods. */
+interface WalletExecutionParams {
+    /** Chain used by the signing wallet. */
+    signerChain: Chain;
+    /** Wallet adapter used to execute the prepared action. */
+    signerWalletAdapter: WalletAdapter;
+}
+/** EVM transaction payload returned by lending transaction builders. */
+interface EvmContractTransaction {
+    /** Contract address to call. */
+    to: string;
+    /** Hex-encoded calldata. */
+    data: string;
+}
+/** Parameters for an ERC-20 transfer transaction. */
+interface CreateTransferErc20TransactionParams {
+    /** ERC-20 token contract address. */
+    tokenAddress: string;
+    /** Destination EVM address. */
+    recipientAddress: string;
+    /** Transfer amount in token base units. */
+    amount: bigint;
+}
 /** Destination account for a completed outflow. */
 interface OutflowReceiver {
     /** Destination account type reported by the protocol. */
@@ -781,6 +840,13 @@ interface OutflowReceiver {
     /** Destination principal or external-chain address. */
     account: string;
 }
+/** External-chain destination for a completed outflow. */
+interface ExternalOutflowReceiver {
+    /** Destination account type reported by the protocol. */
+    type: "External";
+    /** External-chain destination address. */
+    account: string;
+}
 /**
  * Receipt for a borrow or withdraw submitted to the lending canister.
  *
@@ -804,18 +870,12 @@ interface OutflowDetails {
 /** Borrow receipt with an external-chain receiver. */
 type BorrowOutflowDetails = OutflowDetails & {
     outflowType: "borrow";
-    receiver: {
-        type: "External";
-        account: string;
-    };
+    receiver: ExternalOutflowReceiver;
 };
 /** Withdraw receipt with an external-chain receiver. */
 type WithdrawOutflowDetails = OutflowDetails & {
     outflowType: "withdraw";
-    receiver: {
-        type: "External";
-        account: string;
-    };
+    receiver: ExternalOutflowReceiver;
 };
 /** Signature payload for submitting a prepared borrow action. */
 interface BorrowSubmitSignatureInfo extends SignatureInfo {
@@ -1014,6 +1074,17 @@ interface EstimateInflowFeeRequest {
     /** Chain to estimate for. */
     chain: Chain;
 }
+/** Request for an ETH stablecoin deposit address. */
+interface GetDepositAddressRequest {
+    /** Liquidium profile principal text. */
+    profileId: string;
+    /** Pool principal text receiving the inflow. */
+    poolId: string;
+    /** ETH stablecoin asset. */
+    asset: string;
+    /** Deposit or repayment action for the inflow. */
+    action: SupplyAction;
+}
 /** Fee estimate for an inflow target, rounded up to the asset's fee unit. */
 interface InflowFeeEstimate {
     /** Estimated total fee rounded up in the asset's base units. */
@@ -1074,10 +1145,6 @@ interface EvmSupplyContext {
     approvalStrategy: EvmSupplyApprovalStrategy;
 }
 
-type WalletExecutionParams = {
-    signerChain: Chain;
-    signerWalletAdapter: WalletAdapter;
-};
 /** Borrow, withdraw, supply, inflow reporting, and fee-estimation helpers. */
 declare class LendingModule {
     private readonly canisterContext;
@@ -1160,12 +1227,7 @@ declare class LendingModule {
      * @param request - Profile, pool, asset, and supply action.
      * @returns The EVM deposit address for the derived account.
      */
-    getDepositAddress(request: {
-        profileId: string;
-        poolId: string;
-        asset: string;
-        action: SupplyAction;
-    }): Promise<string>;
+    getDepositAddress(request: GetDepositAddressRequest): Promise<string>;
     /**
      * Estimates the network/deposit fee for an inflow target.
      *
@@ -1491,14 +1553,7 @@ declare class PositionsModule {
 }
 
 /** Builds calldata for an ERC-20 `transfer(recipient, amount)` transaction. */
-declare function createTransferErc20Transaction(params: {
-    tokenAddress: string;
-    recipientAddress: string;
-    amount: bigint;
-}): {
-    to: string;
-    data: string;
-};
+declare function createTransferErc20Transaction(params: CreateTransferErc20TransactionParams): EvmContractTransaction;
 
 /** Asset symbols supported by the instant-loans canister. */
 type InstantLoanAsset = "BTC" | "SOL" | "USDC" | "USDT";
@@ -1626,12 +1681,18 @@ interface CreateInstantLoanRequest {
      */
     refundDestination: string | ExternalAccount;
 }
-/** Lookup request for loading canonical instant-loan state. */
-type InstantLoanGetRequest = {
+/** Lookup request for loading an instant loan by numeric canister id. */
+interface InstantLoanGetByIdRequest {
+    /** Canister-assigned loan id. */
     loanId: bigint;
-} | {
+}
+/** Lookup request for loading an instant loan by short user-facing reference. */
+interface InstantLoanGetByRefRequest {
+    /** Short user-facing reference derived from `loanId`. */
     ref: string;
-};
+}
+/** Lookup request for loading canonical instant-loan state. */
+type InstantLoanGetRequest = InstantLoanGetByIdRequest | InstantLoanGetByRefRequest;
 /** Page request for direct instant-loan canister event queries. */
 interface InstantLoanListEventsRequest {
     /** Event id to start from. */
@@ -1667,8 +1728,8 @@ interface InstantLoanEvent {
 }
 /** Instant-loan leg used when stuck funds are withdrawn. */
 type InstantLoanLeg = "Lend" | "Borrow";
-/** Direct canister event payload returned by instant-loans event queries. */
-type InstantLoanEventType = {
+/** Loan-created instant-loan event payload. */
+interface InstantLoanCreatedEventType {
     type: "LoanCreated";
     loanId: bigint;
     borrowDestination: InstantLoanAccount;
@@ -1681,42 +1742,58 @@ type InstantLoanEventType = {
     profileId: string;
     borrowPoolId: string;
     borrowAsset: InstantLoanAsset;
-} | {
+}
+/** Full collateral withdrawal request event payload. */
+interface InstantLoanFullLendWithdrawalRequestedEventType {
     type: "FullLendWithdrawalRequested";
     loanId: bigint;
     account: InstantLoanAccount;
     poolId: string;
-} | {
+}
+/** Borrow request event payload. */
+interface InstantLoanBorrowRequestedEventType {
     type: "BorrowRequested";
     loanId: bigint;
     account: InstantLoanAccount;
     poolId: string;
     amount: bigint;
-} | {
+}
+/** Deposit timer exceeded event payload. */
+interface InstantLoanDepositTimerExceededEventType {
     type: "DepositTimerExceeded";
     loanId: bigint;
-} | {
+}
+/** Stuck funds withdrawal request event payload. */
+interface InstantLoanStuckFundsWithdrawalRequestedEventType {
     type: "StuckFundsWithdrawalRequested";
     leg: InstantLoanLeg;
     loanId: bigint;
     account: InstantLoanAccount;
     poolId: string;
     amount: bigint;
-} | {
+}
+/** Profile-warmed event payload. */
+interface InstantLoanProfileWarmedEventType {
     type: "ProfileWarmed";
     derivationIndex: Uint8Array;
     warmedProfileId: bigint;
     ethAddress: string;
     profileId: string;
-} | {
+}
+/** Repay-complete event payload. */
+interface InstantLoanRepayCompleteEventType {
     type: "RepayComplete";
     loanId: bigint;
     profileId: string;
-} | {
+}
+/** Deposit timer started event payload. */
+interface InstantLoanDepositTimerStartedEventType {
     type: "DepositTimerStarted";
     loanId: bigint;
     timestamp: bigint;
-};
+}
+/** Direct canister event payload returned by instant-loans event queries. */
+type InstantLoanEventType = InstantLoanCreatedEventType | InstantLoanFullLendWithdrawalRequestedEventType | InstantLoanBorrowRequestedEventType | InstantLoanDepositTimerExceededEventType | InstantLoanStuckFundsWithdrawalRequestedEventType | InstantLoanProfileWarmedEventType | InstantLoanRepayCompleteEventType | InstantLoanDepositTimerStartedEventType;
 /** Current amount to send to the repayment target to close the debt. */
 interface InstantLoanRepayment {
     /** Full amount to send to the repayment target, including fee and interest buffer. */
@@ -2146,6 +2223,20 @@ declare class LiquidiumClient {
     constructor(config?: LiquidiumClientConfig);
 }
 
+/** Minimum borrow amounts in each asset's base units. */
+declare const MIN_BORROW_AMOUNTS_BY_ASSET: {
+    readonly BTC: 5100n;
+    readonly USDC: 1000000n;
+    readonly USDT: 1000000n;
+};
+type MinimumBorrowAsset = keyof typeof MIN_BORROW_AMOUNTS_BY_ASSET;
+/**
+ * Returns the minimum borrow amount for an asset in base units.
+ *
+ * Assets without a configured product minimum return `0n`.
+ */
+declare function getMinimumBorrowAmount(asset: string): bigint;
+
 /**
  * Stable string codes for {@link LiquidiumError}. Use for branching in application code.
  */
@@ -2257,4 +2348,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 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 };
+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 };

package/dist/index.js

@@ -3105,6 +3105,39 @@ function assertSupportsIcrcAccountInflowTarget(asset) {
   );
 }
 
+// src/core/borrow-minimums.ts
+var MIN_BORROW_AMOUNTS_BY_ASSET = {
+  BTC: 5100n,
+  // 5,100 sats = 0.000051 BTC
+  USDC: 1000000n,
+  // 1 USDC
+  USDT: 1000000n
+  // 1 USDT
+};
+function getMinimumBorrowAmount(asset) {
+  if (!isMinimumBorrowAsset(asset)) {
+    return 0n;
+  }
+  return MIN_BORROW_AMOUNTS_BY_ASSET[asset];
+}
+function getBorrowAmountMinimumValidationError(params) {
+  const minimumAmount = getMinimumBorrowAmount(params.asset);
+  if (minimumAmount <= 0n || params.amount >= minimumAmount) {
+    return null;
+  }
+  return {
+    asset: params.asset,
+    minimumAmount,
+    message: formatMinimumBorrowAmountMessage(params.asset, minimumAmount)
+  };
+}
+function formatMinimumBorrowAmountMessage(asset, minimumAmount) {
+  return `Borrow amount must be at least ${minimumAmount} base units for ${asset}`;
+}
+function isMinimumBorrowAsset(asset) {
+  return Object.hasOwn(MIN_BORROW_AMOUNTS_BY_ASSET, asset);
+}
+
 // src/modules/quote/types.ts
 var QuoteValidationErrorCode = /* @__PURE__ */ ((QuoteValidationErrorCode2) => {
   QuoteValidationErrorCode2["INVALID_LTV"] = "INVALID_LTV";
@@ -3127,7 +3160,6 @@ var BASIS_POINTS_DENOMINATOR = 10000n;
 var BPS_PER_PERCENT = 100n;
 var MIN_LTV_BPS = 0n;
 var HIGH_LTV_WARNING_THRESHOLD_BPS = 8000n;
-var MIN_BORROW_AMOUNT_BASE_UNITS = 5000n;
 var INTERNAL_USD_DECIMAL_PLACES = 8;
 var PRICE_SCALE_DECIMAL_PLACES = 8;
 var QuoteModule = class {
@@ -3185,11 +3217,12 @@ var QuoteModule = class {
         message: `Price not available for collateral asset: ${collateralPool.asset}`
       });
     }
-    if (request.borrowAmount <= 0n) {
-      validationErrors.push({
-        code: "BORROW_AMOUNT_TOO_LOW" /* BORROW_AMOUNT_TOO_LOW */,
-        message: "Borrow amount must be greater than 0"
-      });
+    const borrowAmountError = createBorrowAmountValidationError({
+      amount: request.borrowAmount,
+      asset: borrowPool.asset
+    });
+    if (borrowAmountError) {
+      validationErrors.push(borrowAmountError);
     }
     if (request.collateralAmount <= 0n) {
       validationErrors.push({
@@ -3311,16 +3344,12 @@ var QuoteModule = class {
         message: `Price not available for collateral asset: ${collateralAsset}`
       });
     }
-    if (borrowAmount < 0n) {
-      validationErrors.push({
-        code: "BORROW_AMOUNT_TOO_LOW" /* BORROW_AMOUNT_TOO_LOW */,
-        message: `Borrow amount must be non-negative`
-      });
-    } else if (borrowAmount < MIN_BORROW_AMOUNT_BASE_UNITS) {
-      validationErrors.push({
-        code: "BORROW_AMOUNT_TOO_LOW" /* BORROW_AMOUNT_TOO_LOW */,
-        message: `Borrow amount must be at least ${MIN_BORROW_AMOUNT_BASE_UNITS} base units`
-      });
+    const borrowAmountError = createBorrowAmountValidationError({
+      amount: borrowAmount,
+      asset: borrowAsset
+    });
+    if (borrowAmountError) {
+      validationErrors.push(borrowAmountError);
     }
     if (targetLtvBps <= MIN_LTV_BPS) {
       validationErrors.push({
@@ -3443,6 +3472,22 @@ function createQuoteResult(params) {
     warnings: params.warnings
   };
 }
+function createBorrowAmountValidationError(params) {
+  if (params.amount <= 0n) {
+    return {
+      code: "BORROW_AMOUNT_TOO_LOW" /* BORROW_AMOUNT_TOO_LOW */,
+      message: "Borrow amount must be greater than 0"
+    };
+  }
+  const minimumBorrowAmountError = getBorrowAmountMinimumValidationError(params);
+  if (!minimumBorrowAmountError) {
+    return null;
+  }
+  return {
+    code: "BORROW_AMOUNT_TOO_LOW" /* BORROW_AMOUNT_TOO_LOW */,
+    message: minimumBorrowAmountError.message
+  };
+}
 function computeUsdInternalFromBaseUnits(params) {
   const { amountBaseUnits, priceScaled, assetDecimalPlaces } = params;
   const scaleDiff = INTERNAL_USD_DECIMAL_PLACES - PRICE_SCALE_DECIMAL_PLACES;
@@ -3768,7 +3813,9 @@ var InstantLoansModule = class {
       );
     }
     const apiClient = this.requireApi("Instant loan address lookup");
-    const response = await apiClient.get(buildInstantLoanAddressLookupPath({ address: trimmedAddress }));
+    const response = await apiClient.get(
+      buildInstantLoanAddressLookupPath({ address: trimmedAddress })
+    );
     return (response.candidates ?? response.loans ?? []).map(mapCandidateWire);
   }
   async mapLoanRecord(record, collateralAmount) {
@@ -3789,7 +3836,9 @@ var InstantLoansModule = class {
   }
   async getCollateralAmountHint(loanId) {
     const apiClient = this.requireApi("Instant loan lookup");
-    const response = await apiClient.get(buildInstantLoanCollateralHintPath({ loanId }));
+    const response = await apiClient.get(
+      buildInstantLoanCollateralHintPath({ loanId })
+    );
     return parseBigintWire(response.collateralAmountHint, "collateral amount");
   }
   async mapLoanWire(loan) {
@@ -4713,9 +4762,28 @@ var LendingModule = class {
         "Borrow requires a signer account"
       );
     }
-    const receiverAddress = await this.normalizeOutflowReceiverAddress({
-      poolId: request.poolId,
-      receiverAddress: destinationAccount
+    if (request.amount <= 0n) {
+      throw new LiquidiumError(
+        LiquidiumErrorCode.VALIDATION_ERROR,
+        "Borrow amount must be greater than 0"
+      );
+    }
+    const selectedPool = await this.getPoolById(request.poolId);
+    const selectedAsset = getVariantKey(selectedPool.asset);
+    const minimumBorrowAmountError = getBorrowAmountMinimumValidationError({
+      amount: request.amount,
+      asset: selectedAsset
+    });
+    if (minimumBorrowAmountError) {
+      throw new LiquidiumError(
+        LiquidiumErrorCode.VALIDATION_ERROR,
+        minimumBorrowAmountError.message
+      );
+    }
+    const receiverAddress = normalizeExternalAddress({
+      address: destinationAccount,
+      asset: selectedAsset,
+      chain: getVariantKey(selectedPool.chain)
     });
     const lendingActor = createLendingActor(this.canisterContext);
     try {
@@ -5964,6 +6032,6 @@ function resolveEvmReadClient(config) {
   });
 }
 
-export { AccountsModule, ActivitiesModule, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, Asset, CK_ETH_DEPOSIT_CONTRACT_ADDRESS, Chain, Environment, EvmSupplyApprovalStrategy, HistoryModule, InflowSubmitType, InstantLoanStatus, InstantLoansModule, LendingModule, LiquidiumClient, LiquidiumError, LiquidiumErrorCode, MarketModule, OutflowType, PositionsModule, QuoteModule, QuoteValidationErrorCode, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, SupplyAction, SupplyPlanType, TransferMode, USDC_CONTRACT_ADDRESS, USDT_CONTRACT_ADDRESS, UserHistoryStatus, WalletExecutionKind, createTransferErc20Transaction, executeWith, intFromPublicId, publicIdFromInt };
+export { AccountsModule, ActivitiesModule, ActivityDirection, ActivityFilter, ActivityKind, ActivityStatus, Asset, CK_ETH_DEPOSIT_CONTRACT_ADDRESS, Chain, Environment, EvmSupplyApprovalStrategy, HistoryModule, InflowSubmitType, InstantLoanStatus, InstantLoansModule, LendingModule, LiquidiumClient, LiquidiumError, LiquidiumErrorCode, MIN_BORROW_AMOUNTS_BY_ASSET, MarketModule, OutflowType, PositionsModule, QuoteModule, QuoteValidationErrorCode, QuoteWarningCode, RATE_DECIMALS, RATE_SCALE, SupplyAction, SupplyPlanType, TransferMode, USDC_CONTRACT_ADDRESS, USDT_CONTRACT_ADDRESS, UserHistoryStatus, WalletExecutionKind, createTransferErc20Transaction, executeWith, getMinimumBorrowAmount, intFromPublicId, publicIdFromInt };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map