@xoxno/sdk-js 1.0.227 → 1.0.228

package/dist/cjs/sdk/stellar/__tests__/amount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/sdk/stellar/lending.d.ts

@@ -19,6 +19,15 @@
 import { xdr } from '@stellar/stellar-sdk';
 import { type StellarNetwork } from './contracts.js';
 import { type StellarSeizeModeInput, type StellarStrategySwapHopInput, type StellarStrategySwapInput, type StellarStrategySwapPathInput } from './scval-encode.js';
+/**
+ * Convert a positive decimal token amount into a builder-ready base-unit string.
+ * Uses Stellar's exact string parser; never rounds excess precision or uses floats.
+ * @param amount - Plain decimal text, for example '1.25'; no sign or exponent.
+ * @param decimals - Token decimal places, from 0 to 18; null metadata is rejected.
+ * @throws If the input is invalid, non-positive, over-precise, or exceeds i128.
+ * @example parseStellarTokenAmount('1.25', 7) // '12500000'
+ */
+export declare function parseStellarTokenAmount(amount: string, decimals: number | null): string;
 /**
  * Stellar `G...` public key of the caller (tx source account).
  */

package/dist/esm/sdk/stellar/lending.js

@@ -15,9 +15,30 @@
  * current sequence via `rpc.Server.getAccount(caller)` and runs
  * `rpc.Server.prepareTransaction` (simulation + Soroban footprint/auth/resource
  * fee) before handing the XDR to the wallet to sign.
- */ import { Account, BASE_FEE, Contract, scValToNative, TransactionBuilder, xdr } from "@stellar/stellar-sdk";
+ */ import { Account, BASE_FEE, Contract, Soroban, scValToNative, TransactionBuilder, xdr } from "@stellar/stellar-sdk";
 import { STELLAR_NETWORK_PASSPHRASE } from "./contracts.js";
 import { addr, asStellarBytes, asStellarStrategySwapBytes, bool, hubAsset, i128, option, seizeMode, tupleAddrAmountVec, tupleHubAssetAmount, tupleHubAssetAmountVec, u32, u64, vec } from "./scval-encode.js";
+/**
+ * Convert a positive decimal token amount into a builder-ready base-unit string.
+ * Uses Stellar's exact string parser; never rounds excess precision or uses floats.
+ * @param amount - Plain decimal text, for example '1.25'; no sign or exponent.
+ * @param decimals - Token decimal places, from 0 to 18; null metadata is rejected.
+ * @throws If the input is invalid, non-positive, over-precise, or exceeds i128.
+ * @example parseStellarTokenAmount('1.25', 7) // '12500000'
+ */ export function parseStellarTokenAmount(amount, decimals) {
+    if (typeof decimals !== 'number' || !Number.isInteger(decimals) || decimals < 0 || decimals > 18) {
+        throw new Error('Token decimals must be an integer from 0 to 18');
+    }
+    if (typeof amount !== 'string' || !/^\d+(?:\.\d+)?$/.test(amount)) {
+        throw new Error('Token amount must be plain decimal text');
+    }
+    const raw = Soroban.parseTokenAmount(amount, decimals);
+    const value = BigInt(raw);
+    if (value <= 0n || value > (1n << 127n) - 1n) {
+        throw new Error('Token amount must be within the positive i128 range');
+    }
+    return raw;
+}
 // -----------------------------------------------------------------------------
 // Transaction assembly
 // -----------------------------------------------------------------------------