@liquidium/client 0.8.2 → 0.9.0

package/README.md

@@ -75,7 +75,7 @@ See the [quick start](https://liquidium-inc.github.io/liquidium-sdk/getting-star
 
 ## Development
 
-Requires Node.js 20+ and pnpm 11+.
+Requires Node.js 22.12+ in the 22.x line, 24.x, or 26+, and pnpm 11+.
 
 ```bash
 pnpm install

package/dist/index.cjs

@@ -1265,6 +1265,8 @@ var AccountsModule = class {
    *
    * @param options - `account` is the wallet address that will own the new profile.
    * @returns A signable {@link CreateAccountAction} with `submit` wired to the canister.
+   * @throws {@link LiquidiumError} If account validation or protocol
+   * preparation fails.
    */
   async prepareCreateProfile(options) {
     return await this.buildCreateProfileAction(options.account);
@@ -1276,6 +1278,9 @@ var AccountsModule = class {
    *
    * @param params - Wallet `account`, signing `chain`, and `walletAdapter` with `signMessage`.
    * @returns The new profile principal as text.
+   * @throws {@link LiquidiumError} If SDK validation or protocol submission
+   * fails.
+   * @throws `Error` If the wallet adapter rejects message signing.
    */
   async createProfile(params) {
     const account = normalizeProfileAccount(params.account);
@@ -1560,6 +1565,7 @@ var flexibleSimpleLoansIdlFactory = ({ IDL }) => {
   });
   const SimpleLoansError = IDL.Variant({
     BorrowAmountRequired: IDL.Null,
+    AnonymousPrincipalNotAllowed: IDL.Null,
     NoCollateralPosition: IDL.Record({ loan_id: IDL.Nat }),
     LtvTimerOutOfRange: IDL.Record({ max: IDL.Nat64 }),
     LtvMaxExceeded: IDL.Record({
@@ -1573,6 +1579,11 @@ var flexibleSimpleLoansIdlFactory = ({ IDL }) => {
       CallRejected: IDL.Record({ method: IDL.Text, reason: IDL.Text }),
       DecodeFailed: IDL.Record({ method: IDL.Text, reason: IDL.Text })
     }),
+    PoolNotFound: IDL.Record({ pool_id: IDL.Principal }),
+    LendingCanisterImmutable: IDL.Record({
+      requested: IDL.Principal,
+      configured: IDL.Principal
+    }),
     LtvMaxOutOfRange: IDL.Record({ max: IDL.Nat64 }),
     AccountRequired: IDL.Record({ label: IDL.Text }),
     DepositTimerExceeded: IDL.Record({ loan_id: IDL.Nat }),
@@ -1585,8 +1596,14 @@ var flexibleSimpleLoansIdlFactory = ({ IDL }) => {
     DepositAlreadyProcessed: IDL.Record({ loan_id: IDL.Nat }),
     MissingPrice: IDL.Record({ symbol: IDL.Text }),
     InvalidLtvTimerS: IDL.Null,
+    PoolLendingDisabled: IDL.Record({ pool_id: IDL.Principal }),
     DebtNotFullyRepaid: IDL.Record({ loan_id: IDL.Nat }),
     EmptyCollateralPosition: IDL.Null,
+    PoolAssetMismatch: IDL.Record({
+      configured_asset: IDL.Unknown,
+      requested_asset: IDL.Unknown,
+      pool_id: IDL.Principal
+    }),
     SigningFailed: IDL.Record({ reason: IDL.Text })
   });
   const CreateLoanRequest = IDL.Record({
@@ -3192,7 +3209,8 @@ var flexibleLendingIdlFactory = ({ IDL }) => {
     same_asset_borrowing: IDL.Opt(IDL.Bool),
     same_asset_borrowing_dust_threshold: IDL.Nat,
     frozen: IDL.Bool,
-    last_updated: IDL.Opt(IDL.Nat64)
+    last_updated: IDL.Opt(IDL.Nat64),
+    activation_fee: IDL.Opt(IDL.Nat64)
   });
   const BorrowingPowerRecord = IDL.Record({
     max_borrowable_usd: IDL.Nat,
@@ -3298,7 +3316,8 @@ function decodeFlexiblePool(pool) {
     same_asset_borrowing: pool.same_asset_borrowing,
     same_asset_borrowing_dust_threshold: pool.same_asset_borrowing_dust_threshold,
     frozen: pool.frozen,
-    last_updated: pool.last_updated
+    last_updated: pool.last_updated,
+    activation_fee: pool.activation_fee ?? []
   };
 }
 function decodeFlexiblePosition(position) {
@@ -4793,6 +4812,8 @@ var LendingModule = class {
    * Use this when you need explicit control over signing and submission.
    * @param request - Profile, pool, amount (pool asset base units), outflow address, and signer wallet.
    * @returns A signable {@link WithdrawAction} with `submit` wired to the canister.
+   * @throws {@link LiquidiumError} If request validation, destination
+   * validation, or protocol preparation fails.
    */
   async prepareWithdraw(request) {
     const destination = resolveOutflowDestinationInput({
@@ -4945,6 +4966,9 @@ var LendingModule = class {
    *
    * @param params - Withdraw request fields plus `signerChain` and `signerWalletAdapter`.
    * @returns The canister {@link OutflowDetails} for the completed withdraw.
+   * @throws {@link LiquidiumError} If SDK validation or protocol submission
+   * fails.
+   * @throws `Error` If the wallet adapter rejects message signing.
    */
   async withdraw(params) {
     const action = await this.prepareWithdraw(params);
@@ -4963,6 +4987,8 @@ var LendingModule = class {
    *
    * @param request - Profile, pool, amount (borrow asset base units), outflow address, and signer wallet.
    * @returns A signable {@link BorrowAction} with `submit` wired to the canister.
+   * @throws {@link LiquidiumError} If request validation, destination
+   * validation, or protocol preparation fails.
    */
   async prepareBorrow(request) {
     const destination = resolveOutflowDestinationInput({
@@ -5116,6 +5142,9 @@ var LendingModule = class {
    *
    * @param params - Borrow request fields plus `signerChain` and `signerWalletAdapter`.
    * @returns The lending canister receipt as {@link OutflowDetails}.
+   * @throws {@link LiquidiumError} If SDK validation or protocol submission
+   * fails.
+   * @throws `Error` If the wallet adapter rejects message signing.
    *
    * @remarks
    * `id` is always present. `txid` may be missing on the first response; the SDK does not
@@ -5141,6 +5170,10 @@ var LendingModule = class {
    *
    * @returns A {@link SupplyFlow} receipt with `type`, `target`, `submit`, and
    *   an optional `txid` present when the SDK broadcast for you.
+   * @throws {@link LiquidiumError} If validation, transfer planning, or
+   * protocol submission fails.
+   * @throws `Error` If the wallet adapter rejects or fails to broadcast a
+   * transaction.
    */
   async supply(request) {
     return await this.createSupplyFlowExecutor().create(request);
@@ -5265,6 +5298,8 @@ var LendingModule = class {
    *
    * @param request - Broadcast `txid` plus inflow `operation` and optional `chain`.
    * @returns Acknowledgement including the submitted `txid`.
+   * @throws {@link LiquidiumError} If the chain is unsupported or the API
+   * request fails.
    */
   async submitInflow(request) {
     if (request.chain !== void 0 && request.chain !== Chain.BTC && request.chain !== Chain.ETH) {
@@ -5510,6 +5545,7 @@ function mapDecodedPoolToPool(pool, rate) {
     liquidationBonus: pool.liquidation_bonus,
     protocolLiquidationFee: pool.protocol_liquidation_fee,
     reserveFactor: pool.reserve_factor,
+    activationFee: pool.activation_fee[0] ?? 0n,
     rateDecimals: RATE_DECIMALS,
     lendingRate: rate[1],
     estimatedLendingApy: estimateSupplyApy(rate[1]),
@@ -6156,7 +6192,7 @@ var QuoteModule = class {
       });
     }
     const borrowUsd = computeUsdInternalFromBaseUnits({
-      amountBaseUnits: request.borrowAmount,
+      amountBaseUnits: getOpeningDebt(request.borrowAmount, borrowPool),
       priceScaled: scalePriceUsdToBigint(borrowPrice),
       assetDecimalPlaces: getPoolDecimalPlaces(borrowPool)
     });
@@ -6313,7 +6349,7 @@ var QuoteModule = class {
       collateralPrice
     );
     const borrowUsdInternal = computeUsdInternalFromBaseUnits({
-      amountBaseUnits: borrowAmount,
+      amountBaseUnits: getOpeningDebt(borrowAmount, borrowPool),
       priceScaled: borrowPriceScaled,
       assetDecimalPlaces: borrowAssetDecimals
     });
@@ -6361,6 +6397,9 @@ var QuoteModule = class {
     });
   }
 };
+function getOpeningDebt(borrowAmount, borrowPool) {
+  return borrowAmount + borrowAmount * borrowPool.activationFee / BASIS_POINTS_DENOMINATOR;
+}
 function createLtvCalculation(params) {
   return {
     borrowAmount: params.request.borrowAmount,
@@ -6571,6 +6610,10 @@ var SimpleLoansModule = class {
    *
    * @param request - Collateral, borrow, refund, LTV limit, timeout, and inflow options.
    * @returns Hydrated loan state plus generated initial-deposit and repayment quote targets.
+   * @throws {@link LiquidiumError} If request validation, API transport, or
+   * protocol validation fails before creation.
+   * @throws {@link SimpleLoanCreatedError} If the remote loan is created but
+   * the SDK cannot load its hydrated state.
    */
   async create(request) {
     validateCreateRequest(request);