@naviprotocol/wallet-client 2.0.5 → 2.0.7

package/dist/client.d.ts

@@ -1,9 +1,9 @@
 import { Signer } from '@mysten/sui/cryptography';
 import { Emitter } from 'mitt';
-import { Module, ModuleConfig } from './modules/module';
-import { modules, ModuleName, ModuleEvents } from './modules';
+import { Module, ModuleConfig } from './modules/module.js';
+import { modules, ModuleName, ModuleEvents } from './modules/index.js';
 import { Transaction } from '@mysten/sui/transactions';
-import { DryRunOptions, NaviTransactionExecutionOptions, NaviWalletTransactionResult } from './types';
+import { DryRunOptions, NaviTransactionExecutionOptions, NaviWalletTransactionResult } from './types.js';
 import { NaviCoreClient, NaviJsonRpcCompatClient, NaviSdkServiceOptions, NaviSuiClientBundle, NaviSuiClientOptions, NaviSuiLegacyJsonRpcOptions, NaviSuiNetwork } from '@naviprotocol/lending';
 
 /**

package/dist/client.js

@@ -0,0 +1,160 @@
+import p from "mitt";
+import { modules as w } from "./modules/index.js";
+import { Transaction as l } from "@mysten/sui/transactions";
+import { fromBase64 as C } from "@mysten/sui/utils";
+import { normalizeTransactionResult as o, mergeTransactionResponseOptions as f } from "./transaction-result.js";
+import { PUBLIC_MAINNET_GRPC_URL as R, createNaviSuiClientBundle as T, createNaviLegacyJsonRpcClient as J } from "@naviprotocol/lending";
+function d(n) {
+  const e = f(n);
+  return {
+    effects: e.showEffects,
+    events: e.showEvents,
+    balanceChanges: e.showBalanceChanges,
+    objectTypes: e.showObjectChanges
+  };
+}
+function g(n) {
+  return n.core;
+}
+function x(n) {
+  return "grpc" in n;
+}
+function B(n) {
+  if (x(n))
+    return T(n);
+  const e = n.network ?? "mainnet", t = J(e, n.legacyJsonRpc);
+  return {
+    network: e,
+    coreClient: t,
+    grpc: t,
+    legacyJsonRpc: t,
+    services: n.services
+  };
+}
+class O {
+  /**
+   * Creates a new wallet client instance
+   * @param options - Configuration options for the wallet client
+   */
+  constructor(e) {
+    this.modules = w, this.userConfigs = {}, this.events = p();
+    const t = e.client ?? {
+      network: "mainnet",
+      grpc: { url: R }
+    };
+    this.clientBundle = B(t), this.client = this.clientBundle.coreClient, this.clientUrl = "grpc" in t ? t.legacyJsonRpc && "url" in t.legacyJsonRpc ? t.legacyJsonRpc.url : void 0 : "url" in t.legacyJsonRpc ? t.legacyJsonRpc.url : void 0, this.signer = e.signer, this.userConfigs = e.configs || {}, Object.entries(this.modules).forEach(([s, i]) => {
+      if (s !== i.name)
+        throw new Error(`Module name ${s} does not match module name ${i.name}`);
+      i.install(this);
+    });
+  }
+  get lending() {
+    return this.modules.lending;
+  }
+  get balance() {
+    return this.modules.balance;
+  }
+  get volo() {
+    return this.modules.volo;
+  }
+  get swap() {
+    return this.modules.swap;
+  }
+  get haedal() {
+    return this.modules.haedal;
+  }
+  /**
+   * Signs and executes a transaction block
+   * @param options - Transaction execution options including dry run support
+   * @returns Promise with transaction execution result
+   */
+  async signExecuteTransaction(e) {
+    const { dryRun: t = !1, ...s } = e;
+    if (t) {
+      const r = g(this.client);
+      if (typeof r?.simulateTransaction == "function") {
+        e.transaction instanceof l && e.transaction.setSenderIfNotSet(this.address);
+        const y = await r.simulateTransaction({
+          transaction: e.transaction,
+          include: d(s.options)
+        });
+        return o("dryRun", y);
+      }
+      const c = this.clientBundle.legacyJsonRpc;
+      if (!c)
+        throw new Error(
+          "WalletClient dry-run requires core.simulateTransaction or an explicit legacyJsonRpc client"
+        );
+      let a;
+      e.transaction instanceof l ? (e.transaction.setSenderIfNotSet(this.address), a = await e.transaction.build({
+        client: c
+      })) : a = e.transaction;
+      const m = await c.dryRunTransactionBlock({
+        transactionBlock: a
+      });
+      return o("dryRun", m);
+    }
+    const i = g(this.client);
+    if (typeof i?.executeTransaction == "function") {
+      let r;
+      e.transaction instanceof l ? (e.transaction.setSenderIfNotSet(this.address), r = await e.transaction.build({
+        client: this.client
+      })) : r = e.transaction;
+      const c = await this.signer.signTransaction(r), a = await i.executeTransaction({
+        transaction: C(c.bytes),
+        signatures: [c.signature],
+        include: d(s.options)
+      });
+      return o("execute", a);
+    }
+    const u = this.clientBundle.legacyJsonRpc;
+    if (!u)
+      throw new Error(
+        "WalletClient execution requires core.executeTransaction or an explicit legacyJsonRpc client"
+      );
+    const h = await u.signAndExecuteTransaction({
+      ...s,
+      options: f(s.options),
+      signer: this.signer
+    });
+    return o("execute", h);
+  }
+  /**
+   * Gets the wallet address from the signer's public key
+   * @returns The wallet address as a string
+   */
+  get address() {
+    return this.signer.getPublicKey().toSuiAddress();
+  }
+  /**
+   * Gets a specific module by name
+   * @param name - The name of the module to retrieve
+   * @returns The requested module instance
+   */
+  module(e) {
+    return this.modules[e];
+  }
+  /**
+   * Gets the configuration for a specific module
+   * @param name - The name of the module
+   * @returns The merged configuration (default + user config)
+   */
+  config(e) {
+    return {
+      ...this.modules[e].defaultConfig,
+      ...this.userConfigs[e]
+    };
+  }
+  /**
+   * Checks if a module is available
+   * @param name - The name of the module to check
+   * @returns True if the module exists, false otherwise
+   */
+  hasModule(e) {
+    return e in this.modules;
+  }
+}
+export {
+  O as WalletClient
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../src/client.ts"],"sourcesContent":["/**\n * Wallet Client - Core Client Implementation\n *\n * This module provides the main wallet client for interacting with the Sui blockchain.\n * It manages transaction signing, module integration, and provides a unified interface\n * for various DeFi operations including swaps, lending, and balance management.\n *\n * @module WalletClient\n */\n\nimport { Signer } from '@mysten/sui/cryptography'\nimport mitt, { Emitter } from 'mitt'\nimport { Module, ModuleConfig } from './modules/module'\nimport { modules, ModuleName, ModuleEvents } from './modules'\nimport { Transaction } from '@mysten/sui/transactions'\nimport { fromBase64 } from '@mysten/sui/utils'\nimport {\n  DryRunOptions,\n  NaviTransactionExecutionOptions,\n  NaviWalletTransactionResult\n} from './types'\nimport { mergeTransactionResponseOptions, normalizeTransactionResult } from './transaction-result'\nimport {\n  createNaviLegacyJsonRpcClient,\n  createNaviSuiClientBundle,\n  type NaviCoreClient,\n  type NaviJsonRpcCompatClient,\n  type NaviSdkServiceOptions,\n  type NaviSuiClientBundle,\n  type NaviSuiClientOptions,\n  type NaviSuiLegacyJsonRpcOptions,\n  type NaviSuiNetwork,\n  PUBLIC_MAINNET_GRPC_URL\n} from '@naviprotocol/lending'\n\n/**\n * Extracts the configuration type from a module\n */\ntype ExtractModuleConfig<T> = T extends Module<infer TConfig, any> ? TConfig : never\n\n/**\n * User configuration type for all modules\n */\nexport type UserConfigs = {\n  [K in ModuleName]: Partial<ExtractModuleConfig<(typeof modules)[K]>>\n}\n\n/**\n * Options for initializing the wallet client\n */\nexport type WalletClientOptions = {\n  /** The signer for transaction signing */\n  signer: Signer\n  /** Optional module-specific configurations */\n  configs?: Partial<UserConfigs>\n  /**\n   * Sui v2 client configuration. Optional (v1 parity): when omitted, a public\n   * mainnet gRPC client is used — fine for development and low volume;\n   * production should pass its own client (private endpoint / auth headers).\n   */\n  client?: NaviSuiClientOptions | WalletLegacyJsonRpcClientOptions\n}\n\nexport type WalletLegacyJsonRpcClientOptions = {\n  network?: NaviSuiNetwork\n  /**\n   * @deprecated JSON-RPC is a short-lived compatibility transport. New paths must use `grpc`.\n   */\n  legacyJsonRpc: NaviSuiLegacyJsonRpcOptions\n  services?: NaviSdkServiceOptions\n}\n\nfunction transactionIncludeOptions(options?: NaviTransactionExecutionOptions['options']) {\n  const merged = mergeTransactionResponseOptions(options)\n  return {\n    effects: merged.showEffects,\n    events: merged.showEvents,\n    balanceChanges: merged.showBalanceChanges,\n    objectTypes: merged.showObjectChanges\n  }\n}\n\nfunction getCoreTransactionClient(client: unknown) {\n  return (client as { core?: unknown }).core as\n    | {\n        simulateTransaction?(options: any): Promise<any>\n        executeTransaction?(options: any): Promise<any>\n      }\n    | undefined\n}\n\nfunction isNaviSuiClientOptions(\n  options: NaviSuiClientOptions | WalletLegacyJsonRpcClientOptions\n): options is NaviSuiClientOptions {\n  return 'grpc' in options\n}\n\nfunction createWalletClientBundle(\n  options: NaviSuiClientOptions | WalletLegacyJsonRpcClientOptions\n): NaviSuiClientBundle {\n  if (isNaviSuiClientOptions(options)) {\n    return createNaviSuiClientBundle(options)\n  }\n  const network = options.network ?? 'mainnet'\n  const legacyJsonRpc = createNaviLegacyJsonRpcClient(network, options.legacyJsonRpc)\n  return {\n    network,\n    coreClient: legacyJsonRpc,\n    grpc: legacyJsonRpc,\n    legacyJsonRpc,\n    services: options.services\n  }\n}\n\n/**\n * Main wallet client class that provides unified access to blockchain operations\n *\n * This class integrates various modules (swap, lending, balance, etc.) and provides\n * a consistent interface for interacting with the Sui blockchain. It handles\n * transaction signing, module management, and event emission.\n */\nexport class WalletClient {\n  /** The signer instance for transaction signing */\n  public readonly signer: Signer\n\n  /** Available modules for different functionalities */\n  private readonly modules = modules\n\n  /** User-provided module configurations */\n  private readonly userConfigs: Partial<UserConfigs> = {}\n\n  /** Event emitter for module events */\n  public readonly events: Emitter<ModuleEvents> = mitt()\n\n  /** The Sui client instance */\n  public readonly client: NaviCoreClient & Partial<NaviJsonRpcCompatClient>\n\n  /** Normalized transport bundle for modules that need transport-specific clients. */\n  public readonly clientBundle: NaviSuiClientBundle\n\n  /** URL used by the default JSON-RPC client, when available. */\n  public readonly clientUrl?: string\n\n  public get lending() {\n    return this.modules.lending\n  }\n\n  public get balance() {\n    return this.modules.balance\n  }\n\n  public get volo() {\n    return this.modules.volo\n  }\n\n  public get swap() {\n    return this.modules.swap\n  }\n\n  public get haedal() {\n    return this.modules.haedal\n  }\n\n  /**\n   * Creates a new wallet client instance\n   * @param options - Configuration options for the wallet client\n   */\n  constructor(options: WalletClientOptions) {\n    // v1 parity: default to the public mainnet node when no client is given.\n    const clientOptions = options.client ?? {\n      network: 'mainnet' as const,\n      grpc: { url: PUBLIC_MAINNET_GRPC_URL }\n    }\n    this.clientBundle = createWalletClientBundle(clientOptions)\n    this.client = this.clientBundle.coreClient as NaviCoreClient & Partial<NaviJsonRpcCompatClient>\n    this.clientUrl =\n      'grpc' in clientOptions\n        ? clientOptions.legacyJsonRpc && 'url' in clientOptions.legacyJsonRpc\n          ? clientOptions.legacyJsonRpc.url\n          : undefined\n        : 'url' in clientOptions.legacyJsonRpc\n          ? clientOptions.legacyJsonRpc.url\n          : undefined\n    this.signer = options.signer\n    this.userConfigs = options.configs || {}\n\n    // Install all modules and validate their names\n    Object.entries(this.modules).forEach(([name, module]) => {\n      if (name !== module.name) {\n        throw new Error(`Module name ${name} does not match module name ${module.name}`)\n      }\n      module.install(this)\n    })\n  }\n\n  /**\n   * Signs and executes a transaction block\n   * @param options - Transaction execution options including dry run support\n   * @returns Promise with transaction execution result\n   */\n  async signExecuteTransaction(\n    options: {\n      transaction: Uint8Array | Transaction\n    } & NaviTransactionExecutionOptions &\n      Partial<DryRunOptions>\n  ): Promise<NaviWalletTransactionResult<boolean>> {\n    const { dryRun = false, ...rest } = options\n\n    if (dryRun) {\n      const core = getCoreTransactionClient(this.client)\n      if (typeof core?.simulateTransaction === 'function') {\n        if (options.transaction instanceof Transaction) {\n          options.transaction.setSenderIfNotSet(this.address)\n        }\n        const result = await core.simulateTransaction({\n          transaction: options.transaction,\n          include: transactionIncludeOptions(rest.options)\n        })\n        return normalizeTransactionResult('dryRun', result)\n      }\n\n      const legacyJsonRpc = this.clientBundle.legacyJsonRpc\n      if (!legacyJsonRpc) {\n        throw new Error(\n          'WalletClient dry-run requires core.simulateTransaction or an explicit legacyJsonRpc client'\n        )\n      }\n      // Handle dry run mode for transaction simulation\n      let txBytes\n      if (options.transaction instanceof Transaction) {\n        options.transaction.setSenderIfNotSet(this.address)\n        txBytes = await options.transaction.build({\n          client: legacyJsonRpc as any\n        })\n      } else {\n        txBytes = options.transaction\n      }\n      const result = await legacyJsonRpc.dryRunTransactionBlock({\n        transactionBlock: txBytes\n      })\n      return normalizeTransactionResult('dryRun', result)\n    }\n\n    const core = getCoreTransactionClient(this.client)\n    if (typeof core?.executeTransaction === 'function') {\n      let txBytes: Uint8Array\n      if (options.transaction instanceof Transaction) {\n        options.transaction.setSenderIfNotSet(this.address)\n        txBytes = await options.transaction.build({\n          client: this.client as any\n        })\n      } else {\n        txBytes = options.transaction\n      }\n      const signed = await this.signer.signTransaction(txBytes)\n      const result = await core.executeTransaction({\n        transaction: fromBase64(signed.bytes),\n        signatures: [signed.signature],\n        include: transactionIncludeOptions(rest.options)\n      })\n      return normalizeTransactionResult('execute', result)\n    }\n\n    const legacyJsonRpc = this.clientBundle.legacyJsonRpc\n    if (!legacyJsonRpc) {\n      throw new Error(\n        'WalletClient execution requires core.executeTransaction or an explicit legacyJsonRpc client'\n      )\n    }\n    // Execute the actual transaction\n    const result = await legacyJsonRpc.signAndExecuteTransaction({\n      ...rest,\n      options: mergeTransactionResponseOptions(rest.options),\n      signer: this.signer\n    } as any)\n    return normalizeTransactionResult('execute', result)\n  }\n\n  /**\n   * Gets the wallet address from the signer's public key\n   * @returns The wallet address as a string\n   */\n  get address(): string {\n    return this.signer.getPublicKey().toSuiAddress()\n  }\n\n  /**\n   * Gets a specific module by name\n   * @param name - The name of the module to retrieve\n   * @returns The requested module instance\n   */\n  module<TName extends ModuleName>(name: TName): (typeof modules)[TName] {\n    return this.modules[name]\n  }\n\n  /**\n   * Gets the configuration for a specific module\n   * @param name - The name of the module\n   * @returns The merged configuration (default + user config)\n   */\n  config<TName extends ModuleName>(name: TName): ExtractModuleConfig<(typeof modules)[TName]> {\n    const mergedConfig = {\n      ...this.modules[name].defaultConfig,\n      ...this.userConfigs[name]\n    }\n    return mergedConfig as ExtractModuleConfig<(typeof modules)[TName]>\n  }\n\n  /**\n   * Checks if a module is available\n   * @param name - The name of the module to check\n   * @returns True if the module exists, false otherwise\n   */\n  hasModule(name: ModuleName): boolean {\n    return name in this.modules\n  }\n}\n\nexport type { ModuleConfig }\n"],"names":["transactionIncludeOptions","options","merged","mergeTransactionResponseOptions","getCoreTransactionClient","client","isNaviSuiClientOptions","createWalletClientBundle","createNaviSuiClientBundle","network","legacyJsonRpc","createNaviLegacyJsonRpcClient","WalletClient","modules","mitt","clientOptions","PUBLIC_MAINNET_GRPC_URL","name","module","dryRun","rest","core","Transaction","result","normalizeTransactionResult","txBytes","signed","fromBase64"],"mappings":"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"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @module WalletClient
  */
-export * from './client';
-export * from './types';
-export * from './signer';
+export * from './client.js';
+export * from './types.js';
+export * from './signer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,8 @@
+import { WalletClient as t } from "./client.js";
+import { WatchSigner as i, WebSigner as l } from "./signer.js";
+export {
+  t as WalletClient,
+  i as WatchSigner,
+  l as WebSigner
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/modules/balanceModule/index.d.ts

@@ -1,8 +1,8 @@
-import { Module } from '../module';
+import { Module } from '../module.js';
 import { CoinStruct } from '@mysten/sui/jsonRpc';
-import { WalletClient } from '../../client';
-import { UserPortfolio } from './portfolio';
-import { NaviWalletTransactionResult } from '../../types';
+import { WalletClient } from '../../client.js';
+import { UserPortfolio } from './portfolio.js';
+import { NaviWalletTransactionResult } from '../../types.js';
 
 /**
  * Configuration options for the balance module

package/dist/modules/balanceModule/index.js

@@ -0,0 +1,214 @@
+import { Module as m } from "../module.js";
+import { withSingleton as p, getCoins as b, mergeCoinsPTB as C, listAddressBalances as B } from "@naviprotocol/lending";
+import { UserPortfolio as f } from "./portfolio.js";
+import P from "bignumber.js";
+import { Transaction as u } from "@mysten/sui/transactions";
+import { normalizeStructTag as w } from "@mysten/sui/utils";
+class v extends m {
+  constructor() {
+    super(...arguments), this.name = "balance", this.defaultConfig = {
+      coinPollingInterval: 6e3,
+      disableCoinPolling: !1
+    }, this.updatePortfolio = p(async () => {
+      if (!this.walletClient)
+        throw new Error("Wallet client not found");
+      this._coins = await b(this.walletClient.address, {
+        client: this.walletClient.client
+      });
+      const t = await this.getAddressBalanceMap();
+      this._portfolio = new f(this._coins, t), this.emit("balance:portfolio-updated", {});
+    }), this._coins = [], this._portfolio = new f(), this.pollingTimer = null, this._updatePromise = null;
+  }
+  /**
+   * Gets the current coin objects from the wallet
+   *
+   * @returns Array of coin objects owned by the wallet
+   */
+  get coins() {
+    return this._coins;
+  }
+  /**
+   * Gets the current portfolio information
+   *
+   * @returns UserPortfolio instance with current balance information
+   */
+  get portfolio() {
+    return this._portfolio;
+  }
+  /**
+   * Waits for the next portfolio update to complete
+   *
+   * @returns Promise that resolves when the portfolio is updated
+   * @throws Error if no update promise is available
+   */
+  async waitForUpdate() {
+    if (!this._updatePromise)
+      throw new Error("Update promise not found");
+    return await this._updatePromise;
+  }
+  /**
+   * Sends a single coin to a recipient
+   *
+   * @param coinType - Type of coin to send
+   * @param recipient - Recipient address
+   * @param amount - Amount to send
+   * @param options - Optional parameters including dry run mode
+   * @returns Transaction response or dry run response
+   */
+  async sendCoin(t, e, n, s) {
+    return this.sendCoinBatch(t, [e], [n], s);
+  }
+  /**
+   * Sends coins to multiple recipients in a single transaction
+   *
+   * @param coinType - Type of coin to send
+   * @param recipients - Array of recipient addresses
+   * @param amounts - Array of amounts to send (must match recipients length)
+   * @param options - Optional parameters including dry run mode
+   * @returns Transaction response or dry run response
+   */
+  async sendCoinBatch(t, e, n, s) {
+    if (!this.walletClient)
+      throw new Error("Wallet client not found");
+    if (e.length !== n.length)
+      throw new Error("Recipients and amounts must have the same length");
+    await this.waitForUpdate();
+    const o = this.portfolio.getBalance(t), i = w(t) === w("0x2::sui::SUI"), c = i ? o.amount : this.portfolio.combinedBalanceOf(t), d = n.reduce((r, l) => r.plus(l), P(0));
+    if (c.lt(d))
+      throw new Error("Insufficient balance");
+    const a = new u();
+    if (i) {
+      const r = a.splitCoins(a.gas, n);
+      e.forEach((l, h) => {
+        a.transferObjects([r[h]], l);
+      });
+    } else {
+      const r = C(a, o.coins, {
+        balance: d.toNumber(),
+        addressBalance: o.addressBalance.toFixed(0),
+        coinType: t
+      });
+      if (e.length === 1)
+        a.transferObjects([r], e[0]);
+      else {
+        const l = a.splitCoins(r, n.slice(0, -1));
+        e.slice(0, -1).forEach((h, g) => {
+          a.transferObjects([l[g]], h);
+        }), a.transferObjects([r], e[e.length - 1]);
+      }
+    }
+    return await this.walletClient.signExecuteTransaction({
+      transaction: a,
+      dryRun: s?.dryRun ?? !1
+    });
+  }
+  /**
+   * Transfers a single object to a recipient
+   *
+   * @param object - Object ID to transfer
+   * @param recipient - Recipient address
+   * @param options - Optional parameters including dry run mode
+   * @returns Transaction response or dry run response
+   */
+  async transferObject(t, e, n) {
+    return this.transferObjectBatch([t], [e], n);
+  }
+  /**
+   * Transfers multiple objects to their respective recipients in a single transaction
+   *
+   * Each object is transferred to its corresponding recipient by index
+   * (first object → first recipient, second object → second recipient, etc.)
+   *
+   * @param objects - Object IDs to transfer
+   * @param recipients - Recipient addresses (must match objects array length)
+   * @param options - Optional parameters including dry run mode
+   * @returns Transaction response or dry run response
+   */
+  async transferObjectBatch(t, e, n) {
+    if (!this.walletClient)
+      throw new Error("Wallet client not found");
+    if (t.length !== e.length)
+      throw new Error("Objects and recipients must have the same length");
+    await this.waitForUpdate();
+    const s = new u();
+    return t.forEach((i, c) => {
+      s.transferObjects([s.object(i)], e[c]);
+    }), await this.walletClient.signExecuteTransaction({
+      transaction: s,
+      dryRun: n?.dryRun ?? !1
+    });
+  }
+  /**
+   * Builds a map of coin type to address-level balance (v2 address balances).
+   *
+   * Feature-detects the v2 Core balance API on the injected client; when it is
+   * unavailable (legacy JSON-RPC only), returns an empty map so the portfolio
+   * falls back to coin-object-only behavior.
+   *
+   * @returns Map of normalized coin type to address balance (atomic units)
+   */
+  async getAddressBalanceMap() {
+    const t = {};
+    if (!this.walletClient)
+      return t;
+    const e = this.walletClient.client.core;
+    if (typeof e?.listBalances != "function" || typeof e?.getBalance != "function")
+      return t;
+    try {
+      let n = null;
+      do {
+        const { balances: s, nextCursor: o } = await B(this.walletClient.client, {
+          owner: this.walletClient.address,
+          cursor: n,
+          limit: 100
+        });
+        for (const i of s)
+          i.addressBalance && i.addressBalance !== "0" && (t[i.coinType] = i.addressBalance);
+        n = o;
+      } while (n);
+    } catch (n) {
+      console.error(n);
+    }
+    return t;
+  }
+  /**
+   * Starts polling for portfolio updates
+   *
+   * This method recursively schedules itself to run at the configured
+   * interval, ensuring regular balance updates.
+   */
+  async startPolling() {
+    if (!this.config.disableCoinPolling)
+      try {
+        await this.updatePortfolio();
+      } catch (t) {
+        console.error(t);
+      } finally {
+        this.pollingTimer = setTimeout(this.startPolling, this.config.coinPollingInterval);
+      }
+  }
+  /**
+   * Installs the balance module into a wallet client
+   *
+   * @param walletClient - The wallet client instance to install into
+   */
+  install(t) {
+    super.install(t), this.startPolling = this.startPolling.bind(this), this.startPolling(), this._updatePromise = new Promise((e) => {
+      t.events.on("balance:portfolio-updated", () => {
+        e();
+      });
+    });
+  }
+  /**
+   * Uninstalls the balance module from the wallet client
+   *
+   * This method cleans up timers and stops polling to prevent memory leaks.
+   */
+  uninstall() {
+    super.uninstall(), this.pollingTimer && (clearTimeout(this.pollingTimer), this.pollingTimer = null);
+  }
+}
+export {
+  v as BalanceModule
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/balanceModule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/modules/balanceModule/index.ts"],"sourcesContent":["/**\n * Balance Module Implementation\n *\n * This module provides comprehensive balance management functionality for the wallet client.\n * It handles coin tracking, portfolio management, coin transfers, and automatic balance updates\n * through polling mechanisms.\n *\n * @module BalanceModule\n */\n\nimport { Module } from '../module'\nimport { getCoins, mergeCoinsPTB, withSingleton, listAddressBalances } from '@naviprotocol/lending'\nimport type { CoinStruct } from '@mysten/sui/jsonRpc'\nimport type { WalletClient } from '../../client'\nimport { UserPortfolio } from './portfolio'\nimport BigNumber from 'bignumber.js'\nimport { Transaction } from '@mysten/sui/transactions'\nimport type { NaviWalletTransactionResult } from '../../types'\nimport { normalizeStructTag } from '@mysten/sui/utils'\n\n/**\n * Configuration options for the balance module\n */\nexport interface BalanceModuleConfig {\n  /** Interval in milliseconds for polling coin balances */\n  coinPollingInterval: number\n  /** Whether to disable coin polling */\n  disableCoinPolling: boolean\n}\n\n/**\n * Events emitted by the balance module\n */\nexport type Events = {\n  /** Emitted when the portfolio is updated with new balance information */\n  'balance:portfolio-updated': {}\n}\n\n/**\n * Balance management module for wallet operations\n *\n * This module provides functionality for:\n * - Tracking coin balances and portfolio information\n * - Sending coins to recipients\n * - Transferring objects\n * - Automatic balance updates through polling\n * - Portfolio management and balance queries\n */\nexport class BalanceModule extends Module<BalanceModuleConfig, Events> {\n  /** Module name identifier */\n  readonly name = 'balance'\n\n  /** Default configuration values */\n  readonly defaultConfig = {\n    coinPollingInterval: 6000,\n    disableCoinPolling: false\n  }\n\n  /**\n   * Gets the current coin objects from the wallet\n   *\n   * @returns Array of coin objects owned by the wallet\n   */\n  public get coins() {\n    return this._coins\n  }\n\n  /**\n   * Gets the current portfolio information\n   *\n   * @returns UserPortfolio instance with current balance information\n   */\n  public get portfolio() {\n    return this._portfolio\n  }\n\n  /**\n   * Waits for the next portfolio update to complete\n   *\n   * @returns Promise that resolves when the portfolio is updated\n   * @throws Error if no update promise is available\n   */\n  public async waitForUpdate() {\n    if (!this._updatePromise) {\n      throw new Error('Update promise not found')\n    }\n    return await this._updatePromise\n  }\n\n  /**\n   * Sends a single coin to a recipient\n   *\n   * @param coinType - Type of coin to send\n   * @param recipient - Recipient address\n   * @param amount - Amount to send\n   * @param options - Optional parameters including dry run mode\n   * @returns Transaction response or dry run response\n   */\n  public async sendCoin<T extends boolean = false>(\n    coinType: string,\n    recipient: string,\n    amount: number,\n    options?: { dryRun: T }\n  ): Promise<NaviWalletTransactionResult<T>> {\n    return this.sendCoinBatch(coinType, [recipient], [amount], options)\n  }\n\n  /**\n   * Sends coins to multiple recipients in a single transaction\n   *\n   * @param coinType - Type of coin to send\n   * @param recipients - Array of recipient addresses\n   * @param amounts - Array of amounts to send (must match recipients length)\n   * @param options - Optional parameters including dry run mode\n   * @returns Transaction response or dry run response\n   */\n  public async sendCoinBatch<T extends boolean = false>(\n    coinType: string,\n    recipients: string[],\n    amounts: number[],\n    options?: { dryRun: T }\n  ): Promise<NaviWalletTransactionResult<T>> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client not found')\n    }\n    if (recipients.length !== amounts.length) {\n      throw new Error('Recipients and amounts must have the same length')\n    }\n\n    // Wait for latest portfolio update\n    await this.waitForUpdate()\n\n    // Check if sufficient balance is available. SUI is funded from the gas coin\n    // below (address balance is not spendable on that path), so its sufficiency\n    // counts coin objects only; other coins can redeem the address balance via\n    // mergeCoinsPTB, so they count the combined total.\n    const coinBalance = this.portfolio.getBalance(coinType)\n    const isSui = normalizeStructTag(coinType) === normalizeStructTag('0x2::sui::SUI')\n    const spendable = isSui ? coinBalance.amount : this.portfolio.combinedBalanceOf(coinType)\n    const totalAmount = amounts.reduce((acc, curr) => acc.plus(curr), BigNumber(0))\n    if (spendable.lt(totalAmount)) {\n      throw new Error('Insufficient balance')\n    }\n\n    // Build transaction\n    const tx = new Transaction()\n\n    if (isSui) {\n      // SUI: split each share from the gas coin; the leftover stays on the gas\n      // coin, so there is no dangling zero-balance result.\n      const shares = tx.splitCoins(tx.gas, amounts)\n      recipients.forEach((address, index) => {\n        tx.transferObjects([shares[index]], address)\n      })\n    } else {\n      // Non-SUI: mergeCoinsPTB returns a coin holding EXACTLY totalAmount. It may\n      // be a redeem_funds result (address balance) with no owned object to\n      // absorb leftover, so a plain splitCoins of every share would leave the\n      // source at zero balance and unused (Coin has no `drop` ability → PTB\n      // fails). Instead split the first n-1 shares and transfer the source coin\n      // itself as the last share, fully consuming it.\n      const mergedCoin = mergeCoinsPTB(tx, coinBalance.coins, {\n        balance: totalAmount.toNumber(),\n        addressBalance: coinBalance.addressBalance.toFixed(0),\n        coinType\n      })\n      if (recipients.length === 1) {\n        tx.transferObjects([mergedCoin], recipients[0])\n      } else {\n        const headShares = tx.splitCoins(mergedCoin, amounts.slice(0, -1))\n        recipients.slice(0, -1).forEach((address, index) => {\n          tx.transferObjects([headShares[index]], address)\n        })\n        tx.transferObjects([mergedCoin], recipients[recipients.length - 1])\n      }\n    }\n\n    // Execute transaction\n    const result = await this.walletClient.signExecuteTransaction({\n      transaction: tx,\n      dryRun: options?.dryRun ?? false\n    })\n\n    return result as any\n  }\n\n  /**\n   * Transfers a single object to a recipient\n   *\n   * @param object - Object ID to transfer\n   * @param recipient - Recipient address\n   * @param options - Optional parameters including dry run mode\n   * @returns Transaction response or dry run response\n   */\n  async transferObject<T extends boolean = false>(\n    object: string,\n    recipient: string,\n    options?: { dryRun: T }\n  ): Promise<NaviWalletTransactionResult<T>> {\n    return this.transferObjectBatch([object], [recipient], options)\n  }\n\n  /**\n   * Transfers multiple objects to their respective recipients in a single transaction\n   *\n   * Each object is transferred to its corresponding recipient by index\n   * (first object → first recipient, second object → second recipient, etc.)\n   *\n   * @param objects - Object IDs to transfer\n   * @param recipients - Recipient addresses (must match objects array length)\n   * @param options - Optional parameters including dry run mode\n   * @returns Transaction response or dry run response\n   */\n  async transferObjectBatch<T extends boolean = false>(\n    objects: string[],\n    recipients: string[],\n    options?: { dryRun: T }\n  ): Promise<NaviWalletTransactionResult<T>> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client not found')\n    }\n\n    if (objects.length !== recipients.length) {\n      throw new Error('Objects and recipients must have the same length')\n    }\n\n    // Wait for latest portfolio update\n    await this.waitForUpdate()\n\n    // Build transaction\n    const tx = new Transaction()\n\n    // Transfer objects to recipients\n    objects.forEach((object, index) => {\n      tx.transferObjects([tx.object(object)], recipients[index])\n    })\n\n    // Execute transaction\n    const result = await this.walletClient.signExecuteTransaction({\n      transaction: tx,\n      dryRun: options?.dryRun ?? false\n    })\n\n    return result as any\n  }\n\n  /**\n   * Updates the portfolio with current coin information\n   *\n   * This function is wrapped with singleton behavior to prevent\n   * concurrent updates and ensure data consistency.\n   */\n  updatePortfolio = withSingleton(async () => {\n    if (!this.walletClient) {\n      throw new Error('Wallet client not found')\n    }\n\n    // Fetch current coins from the wallet\n    this._coins = await getCoins(this.walletClient.address, {\n      client: this.walletClient.client\n    })\n\n    // Also fetch funds held at the address level (v2 address balances). Coin\n    // objects only cover `Coin<T>` objects, so this map lets sufficiency checks\n    // and coin selection see the full spendable total.\n    const addressBalances = await this.getAddressBalanceMap()\n\n    // Update portfolio with new coin data\n    this._portfolio = new UserPortfolio(this._coins, addressBalances)\n\n    // Emit portfolio update event\n    this.emit('balance:portfolio-updated', {})\n  })\n\n  /**\n   * Builds a map of coin type to address-level balance (v2 address balances).\n   *\n   * Feature-detects the v2 Core balance API on the injected client; when it is\n   * unavailable (legacy JSON-RPC only), returns an empty map so the portfolio\n   * falls back to coin-object-only behavior.\n   *\n   * @returns Map of normalized coin type to address balance (atomic units)\n   */\n  private async getAddressBalanceMap(): Promise<{ [key in string]?: string }> {\n    const map: { [key in string]?: string } = {}\n    if (!this.walletClient) {\n      return map\n    }\n    const core = (this.walletClient.client as { core?: Record<string, unknown> }).core\n    if (typeof core?.listBalances !== 'function' || typeof core?.getBalance !== 'function') {\n      return map\n    }\n    try {\n      let cursor: string | null | undefined = null\n      do {\n        const { balances, nextCursor } = await listAddressBalances(this.walletClient.client, {\n          owner: this.walletClient.address,\n          cursor,\n          limit: 100\n        })\n        for (const balance of balances) {\n          // Only track coin types that actually hold funds at the address level\n          // to avoid creating empty portfolio entries.\n          if (balance.addressBalance && balance.addressBalance !== '0') {\n            map[balance.coinType] = balance.addressBalance\n          }\n        }\n        cursor = nextCursor\n      } while (cursor)\n    } catch (error) {\n      console.error(error)\n    }\n    return map\n  }\n\n  /** Current coin objects from the wallet */\n  private _coins: CoinStruct[] = []\n\n  /** Current portfolio information */\n  private _portfolio: UserPortfolio = new UserPortfolio()\n\n  /** Timer for polling balance updates */\n  private pollingTimer: NodeJS.Timeout | null = null\n\n  /** Promise for waiting on portfolio updates */\n  private _updatePromise: Promise<void> | null = null\n\n  /**\n   * Starts polling for portfolio updates\n   *\n   * This method recursively schedules itself to run at the configured\n   * interval, ensuring regular balance updates.\n   */\n  private async startPolling() {\n    if (this.config.disableCoinPolling) {\n      return\n    }\n\n    try {\n      await this.updatePortfolio()\n    } catch (error) {\n      console.error(error)\n    } finally {\n      this.pollingTimer = setTimeout(this.startPolling, this.config.coinPollingInterval)\n    }\n  }\n\n  /**\n   * Installs the balance module into a wallet client\n   *\n   * @param walletClient - The wallet client instance to install into\n   */\n  install(walletClient: WalletClient) {\n    super.install(walletClient)\n\n    // Bind the polling method and start polling\n    this.startPolling = this.startPolling.bind(this)\n    this.startPolling()\n\n    // Create update promise for waiting on portfolio updates\n    this._updatePromise = new Promise((resolve) => {\n      walletClient.events.on('balance:portfolio-updated', () => {\n        resolve()\n      })\n    })\n  }\n\n  /**\n   * Uninstalls the balance module from the wallet client\n   *\n   * This method cleans up timers and stops polling to prevent memory leaks.\n   */\n  uninstall() {\n    super.uninstall()\n    if (this.pollingTimer) {\n      clearTimeout(this.pollingTimer)\n      this.pollingTimer = null\n    }\n  }\n}\n"],"names":["BalanceModule","Module","withSingleton","getCoins","addressBalances","UserPortfolio","coinType","recipient","amount","options","recipients","amounts","coinBalance","isSui","normalizeStructTag","spendable","totalAmount","acc","curr","BigNumber","tx","Transaction","shares","address","index","mergedCoin","mergeCoinsPTB","headShares","object","objects","map","core","cursor","balances","nextCursor","listAddressBalances","balance","error","walletClient","resolve"],"mappings":"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"}

package/dist/modules/balanceModule/portfolio.js

@@ -0,0 +1,105 @@
+import { BigNumber as s } from "bignumber.js";
+import { normalizeStructTag as l } from "@mysten/sui/utils";
+class i {
+  /**
+   * Creates a new user portfolio
+   *
+   * @param coins - Array of coin objects or existing portfolio to copy from
+   * @param addressBalances - Optional map of normalized coin type to funds held
+   *   directly at the address level (v2 address balances). Coin objects only
+   *   account for `Coin<T>` objects, so this carries the balance that lives at
+   *   the address and is not represented by any object. Defaults to empty,
+   *   which preserves legacy coin-object-only behavior.
+   */
+  constructor(a, o) {
+    if (a instanceof i)
+      this.balances = JSON.parse(JSON.stringify(a.balances)), Object.values(this.balances).forEach((n) => {
+        n.amount = s(n.amount), n.addressBalance = s(n.addressBalance ?? 0);
+      });
+    else {
+      const n = {};
+      a?.forEach((t) => {
+        if (!t.coinType || t.balance === void 0 || t.balance === null)
+          return;
+        const c = l(t.coinType);
+        let e = n[c];
+        e || (e = {
+          coinType: c,
+          amount: s(0),
+          addressBalance: s(0),
+          coins: []
+        }, n[c] = e), e.coins.push(t), e.amount = e.amount.plus(t.balance);
+      }), o && Object.entries(o).forEach(([t, c]) => {
+        if (c == null)
+          return;
+        const e = l(t);
+        let r = n[e];
+        r || (r = {
+          coinType: e,
+          amount: s(0),
+          addressBalance: s(0),
+          coins: []
+        }, n[e] = r), r.addressBalance = s(c);
+      }), this.balances = n;
+    }
+  }
+  /**
+   * Gets balance information for a specific coin type
+   *
+   * @param coinType - The coin type to query
+   * @returns UserCoinBalance object with coin type, total amount, and coin objects
+   */
+  getBalance(a) {
+    return a = l(a), this.balances[a] || {
+      coinType: a,
+      amount: s(0),
+      addressBalance: s(0),
+      coins: []
+    };
+  }
+  /**
+   * Gets the combined total balance for a coin type: the sum of coin objects
+   * (`amount`) plus funds held at the address level (`addressBalance`). Use
+   * this for sufficiency checks; use `.amount` when you specifically need the
+   * coin-object-only sum.
+   *
+   * @param coinType - The coin type to query
+   * @returns BigNumber representing the combined total balance
+   */
+  combinedBalanceOf(a) {
+    const o = this.getBalance(a);
+    return o.amount.plus(o.addressBalance ?? 0);
+  }
+  /**
+   * Gets all coin types in the portfolio
+   *
+   * @returns Array of coin type strings
+   */
+  getCoinTypes() {
+    return Object.values(this.balances).map((a) => a.coinType);
+  }
+  /**
+   * Gets the total balance amount for a specific coin type
+   *
+   * @param coinType - The coin type to query
+   * @returns BigNumber representing the total balance
+   */
+  balanceOf(a) {
+    return a = l(a), this.getBalance(a)?.amount || s(0);
+  }
+  /**
+   * Creates a deep copy of the portfolio
+   *
+   * This method creates a completely independent copy of the portfolio
+   * that can be modified without affecting the original.
+   *
+   * @returns New UserPortfolio instance with copied data
+   */
+  clone() {
+    return new i(this);
+  }
+}
+export {
+  i as UserPortfolio
+};
+//# sourceMappingURL=portfolio.js.map

package/dist/modules/balanceModule/portfolio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.js","sources":["../../../src/modules/balanceModule/portfolio.ts"],"sourcesContent":["/**\n * User Portfolio Management\n *\n * This module provides portfolio management functionality for tracking\n * user coin balances across different token types. It aggregates coin\n * objects by type and provides convenient methods for balance queries\n * and portfolio operations.\n *\n * @module UserPortfolio\n */\n\nimport type { CoinStruct } from '@mysten/sui/jsonRpc'\nimport { BigNumber } from 'bignumber.js'\nimport { normalizeStructTag } from '@mysten/sui/utils'\n\n/**\n * User portfolio for managing coin balances\n *\n * This class provides functionality to:\n * - Aggregate coins by type and calculate total balances\n * - Query balances for specific coin types\n * - Clone portfolio state for safe operations\n * - Normalize coin types for consistent comparison\n */\nexport class UserPortfolio {\n  /** Mapping of coin types to their balance information */\n  balances: { [key in string]: UserCoinBalance }\n\n  /**\n   * Creates a new user portfolio\n   *\n   * @param coins - Array of coin objects or existing portfolio to copy from\n   * @param addressBalances - Optional map of normalized coin type to funds held\n   *   directly at the address level (v2 address balances). Coin objects only\n   *   account for `Coin<T>` objects, so this carries the balance that lives at\n   *   the address and is not represented by any object. Defaults to empty,\n   *   which preserves legacy coin-object-only behavior.\n   */\n  constructor(\n    coins?: CoinStruct[] | UserPortfolio,\n    addressBalances?: { [key in string]?: BigNumber.Value }\n  ) {\n    if (coins instanceof UserPortfolio) {\n      // Copy from existing portfolio\n      this.balances = JSON.parse(JSON.stringify(coins.balances))\n      // JSON round-trips BigNumber to string, so rehydrate BigNumber fields.\n      Object.values(this.balances).forEach((balance) => {\n        balance.amount = BigNumber(balance.amount)\n        balance.addressBalance = BigNumber(balance.addressBalance ?? 0)\n      })\n    } else {\n      // Build portfolio from coin objects\n      const balances: { [key in string]: UserCoinBalance } = {}\n\n      coins?.forEach((item) => {\n        if (!item.coinType || item.balance === undefined || item.balance === null) {\n          return\n        }\n        // Normalize coin type for consistent key usage\n        const normalizedCoinType = normalizeStructTag(item.coinType)\n        let existPofolio = balances[normalizedCoinType]\n\n        // Create new balance entry if it doesn't exist\n        if (!existPofolio) {\n          existPofolio = {\n            coinType: normalizedCoinType,\n            amount: BigNumber(0),\n            addressBalance: BigNumber(0),\n            coins: []\n          }\n          balances[normalizedCoinType] = existPofolio\n        }\n\n        // Add coin to balance and update total amount\n        existPofolio.coins.push(item)\n        existPofolio.amount = existPofolio.amount.plus(item.balance)\n      })\n\n      // Merge in address-level balances (v2). A coin type may have an address\n      // balance without any coin objects, so create entries as needed.\n      if (addressBalances) {\n        Object.entries(addressBalances).forEach(([coinType, value]) => {\n          if (value === undefined || value === null) {\n            return\n          }\n          const normalizedCoinType = normalizeStructTag(coinType)\n          let existPofolio = balances[normalizedCoinType]\n          if (!existPofolio) {\n            existPofolio = {\n              coinType: normalizedCoinType,\n              amount: BigNumber(0),\n              addressBalance: BigNumber(0),\n              coins: []\n            }\n            balances[normalizedCoinType] = existPofolio\n          }\n          existPofolio.addressBalance = BigNumber(value)\n        })\n      }\n\n      this.balances = balances\n    }\n  }\n\n  /**\n   * Gets balance information for a specific coin type\n   *\n   * @param coinType - The coin type to query\n   * @returns UserCoinBalance object with coin type, total amount, and coin objects\n   */\n  getBalance(coinType: string): UserCoinBalance {\n    coinType = normalizeStructTag(coinType)\n    return (\n      this.balances[coinType] || {\n        coinType,\n        amount: BigNumber(0),\n        addressBalance: BigNumber(0),\n        coins: []\n      }\n    )\n  }\n\n  /**\n   * Gets the combined total balance for a coin type: the sum of coin objects\n   * (`amount`) plus funds held at the address level (`addressBalance`). Use\n   * this for sufficiency checks; use `.amount` when you specifically need the\n   * coin-object-only sum.\n   *\n   * @param coinType - The coin type to query\n   * @returns BigNumber representing the combined total balance\n   */\n  combinedBalanceOf(coinType: string) {\n    const balance = this.getBalance(coinType)\n    return balance.amount.plus(balance.addressBalance ?? 0)\n  }\n\n  /**\n   * Gets all coin types in the portfolio\n   *\n   * @returns Array of coin type strings\n   */\n  getCoinTypes() {\n    return Object.values(this.balances).map((item) => {\n      return item.coinType\n    })\n  }\n\n  /**\n   * Gets the total balance amount for a specific coin type\n   *\n   * @param coinType - The coin type to query\n   * @returns BigNumber representing the total balance\n   */\n  balanceOf(coinType: string) {\n    coinType = normalizeStructTag(coinType)\n    const balance = this.getBalance(coinType)\n    return balance?.amount || BigNumber(0)\n  }\n\n  /**\n   * Creates a deep copy of the portfolio\n   *\n   * This method creates a completely independent copy of the portfolio\n   * that can be modified without affecting the original.\n   *\n   * @returns New UserPortfolio instance with copied data\n   */\n  clone() {\n    // Reuse the copy constructor, which deep-copies and rehydrates the\n    // BigNumber fields (amount / addressBalance). Assigning JSON-parsed\n    // balances directly would leave them as plain strings and break `.plus` /\n    // `.toFixed` on the clone.\n    return new UserPortfolio(this)\n  }\n}\n\n/**\n * Balance information for a specific coin type\n *\n * This type represents the aggregated balance information for all\n * coins of a particular type in the user's portfolio.\n */\nexport type UserCoinBalance = {\n  /** Normalized coin type string */\n  coinType: string\n  /** Total balance across all coin objects (`Coin<T>`) of this type */\n  amount: BigNumber\n  /**\n   * Funds held directly at the address level (v2 address balances) for this\n   * coin type. Not represented by any coin object. Defaults to `0`. The\n   * combined spendable total is `amount + addressBalance`.\n   */\n  addressBalance: BigNumber\n  /** Array of individual coin objects */\n  coins: CoinStruct[]\n}\n"],"names":["UserPortfolio","coins","addressBalances","balance","BigNumber","balances","item","normalizedCoinType","normalizeStructTag","existPofolio","coinType","value"],"mappings":";;AAwBO,MAAMA,EAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAczB,YACEC,GACAC,GACA;AACA,QAAID,aAAiBD;AAEnB,WAAK,WAAW,KAAK,MAAM,KAAK,UAAUC,EAAM,QAAQ,CAAC,GAEzD,OAAO,OAAO,KAAK,QAAQ,EAAE,QAAQ,CAACE,MAAY;AAChD,QAAAA,EAAQ,SAASC,EAAUD,EAAQ,MAAM,GACzCA,EAAQ,iBAAiBC,EAAUD,EAAQ,kBAAkB,CAAC;AAAA,MAChE,CAAC;AAAA,SACI;AAEL,YAAME,IAAiD,CAAA;AAEvD,MAAAJ,GAAO,QAAQ,CAACK,MAAS;AACvB,YAAI,CAACA,EAAK,YAAYA,EAAK,YAAY,UAAaA,EAAK,YAAY;AACnE;AAGF,cAAMC,IAAqBC,EAAmBF,EAAK,QAAQ;AAC3D,YAAIG,IAAeJ,EAASE,CAAkB;AAG9C,QAAKE,MACHA,IAAe;AAAA,UACb,UAAUF;AAAA,UACV,QAAQH,EAAU,CAAC;AAAA,UACnB,gBAAgBA,EAAU,CAAC;AAAA,UAC3B,OAAO,CAAA;AAAA,QAAC,GAEVC,EAASE,CAAkB,IAAIE,IAIjCA,EAAa,MAAM,KAAKH,CAAI,GAC5BG,EAAa,SAASA,EAAa,OAAO,KAAKH,EAAK,OAAO;AAAA,MAC7D,CAAC,GAIGJ,KACF,OAAO,QAAQA,CAAe,EAAE,QAAQ,CAAC,CAACQ,GAAUC,CAAK,MAAM;AAC7D,YAA2BA,KAAU;AACnC;AAEF,cAAMJ,IAAqBC,EAAmBE,CAAQ;AACtD,YAAID,IAAeJ,EAASE,CAAkB;AAC9C,QAAKE,MACHA,IAAe;AAAA,UACb,UAAUF;AAAA,UACV,QAAQH,EAAU,CAAC;AAAA,UACnB,gBAAgBA,EAAU,CAAC;AAAA,UAC3B,OAAO,CAAA;AAAA,QAAC,GAEVC,EAASE,CAAkB,IAAIE,IAEjCA,EAAa,iBAAiBL,EAAUO,CAAK;AAAA,MAC/C,CAAC,GAGH,KAAK,WAAWN;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAWK,GAAmC;AAC5C,WAAAA,IAAWF,EAAmBE,CAAQ,GAEpC,KAAK,SAASA,CAAQ,KAAK;AAAA,MACzB,UAAAA;AAAA,MACA,QAAQN,EAAU,CAAC;AAAA,MACnB,gBAAgBA,EAAU,CAAC;AAAA,MAC3B,OAAO,CAAA;AAAA,IAAC;AAAA,EAGd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,kBAAkBM,GAAkB;AAClC,UAAMP,IAAU,KAAK,WAAWO,CAAQ;AACxC,WAAOP,EAAQ,OAAO,KAAKA,EAAQ,kBAAkB,CAAC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,eAAe;AACb,WAAO,OAAO,OAAO,KAAK,QAAQ,EAAE,IAAI,CAACG,MAChCA,EAAK,QACb;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAUI,GAAkB;AAC1B,WAAAA,IAAWF,EAAmBE,CAAQ,GACtB,KAAK,WAAWA,CAAQ,GACxB,UAAUN,EAAU,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,QAAQ;AAKN,WAAO,IAAIJ,EAAc,IAAI;AAAA,EAC/B;AACF;"}

package/dist/modules/haedalModule/index.d.ts

@@ -1,7 +1,7 @@
 import { CoinObject, NaviSdkServiceOptions } from '@naviprotocol/lending';
 import { Transaction } from '@mysten/sui/transactions';
-import { Module } from '../module';
-import { NaviWalletTransactionResult } from '../../types';
+import { Module } from '../module.js';
+import { NaviWalletTransactionResult } from '../../types.js';
 
 /**
  * Configuration for the Haedal module