@initia/initia.js 1.0.20 → 2.0.0-rc.0

package/dist/base-provider-CLnd7kte.d.mts

@@ -0,0 +1,68 @@
+import { C as NetworkType, c as OpBridgeInfo, i as ChainInfoForType, l as RefreshResult, m as ChainType, n as ChainDataProvider, o as IbcChannelInfo, r as ChainInfo, s as ListAssetsOptions, t as AssetInfo, ts as Coin, u as TransferPath, ys as TransportFactory } from "./types-DGrP9Ro_.mjs";
+import { AssetList } from "@initia/initia-registry-types";
+import { AssetList as AssetList$1 } from "@chain-registry/types";
+
+//#region src/provider/base-provider.d.ts
+/**
+ * Base class for ChainDataProvider implementations.
+ * Provides shared implementations for amount conversion methods.
+ *
+ * @internal SDK internal use. Users should use ChainDataProvider interface or CustomProvider.
+ * Direct subclassing requires implementing 14 abstract methods.
+ */
+declare abstract class BaseChainDataProvider implements ChainDataProvider {
+  createTransport?: TransportFactory;
+  abstract getChainInfo<T extends ChainType = ChainType>(chainId: string): ChainInfoForType<T> | undefined;
+  abstract listChains(): ChainInfo[];
+  abstract hasChain(chainId: string): boolean;
+  abstract getAssets(chainId: string): Promise<AssetInfo[]>;
+  abstract getRawAssetList(chainId: string): Promise<AssetList | AssetList$1 | undefined>;
+  abstract findAsset(denom: string, chainId?: string): Promise<AssetInfo | undefined>;
+  abstract findAssetBySymbol(symbol: string, chainId?: string): Promise<AssetInfo[]>;
+  abstract listAssets(options?: ListAssetsOptions): Promise<AssetInfo[]>;
+  abstract getIbcChannels(chainId: string): IbcChannelInfo[];
+  abstract getIbcChannel(fromChainId: string, toChainId: string): IbcChannelInfo | undefined;
+  abstract getTransferPath(fromChainId: string, toChainId: string, denom?: string): TransferPath | undefined;
+  abstract getOpBridge(l2ChainId: string): OpBridgeInfo | undefined;
+  abstract resolveChainId(chainName: string, network?: NetworkType): string | undefined;
+  abstract getChainName(chainId: string): string | undefined;
+  /**
+   * Find multiple assets by denoms (batch operation).
+   * Default: getAssets() once then match in loop.
+   * Subclasses may override for optimized batch lookup.
+   */
+  findAssets(denoms: string[], chainId: string): Promise<Map<string, AssetInfo | undefined>>;
+  /**
+   * Refresh provider data. Default is no-op (for static providers).
+   * RegistryProvider overrides this to re-fetch from API.
+   */
+  refresh(): Promise<RefreshResult>;
+  /**
+   * Convert base amount to display amount.
+   * @example toDisplayAmount(coin('uinit', '1000000'), 'interwoven-1') → '1'
+   */
+  toDisplayAmount(coin: Coin, chainId: string): Promise<string>;
+  /**
+   * Convert display amount to base amount.
+   * Throws if amount has more decimal places than the asset's decimals.
+   * @example toBaseAmount('1', 'uinit', 'interwoven-1') → '1000000'
+   */
+  toBaseAmount(amount: string, denom: string, chainId: string): Promise<string>;
+  /**
+   * Convert amount between denom units.
+   * @example convertAmount('1.5', 'INIT', 'uinit', 'interwoven-1') → '1500000'
+   */
+  convertAmount(amount: string, fromDenom: string, toDenom: string, chainId: string): Promise<string>;
+  /**
+   * Format base amount for display (with symbol).
+   * @example formatAmount(coin('uinit', '1000000'), 'interwoven-1') → '1 INIT'
+   */
+  formatAmount(coin: Coin, chainId: string, options?: {
+    maxDecimals?: number;
+    minDecimals?: number;
+    trimTrailingZeros?: boolean;
+  }): Promise<string>;
+}
+//#endregion
+export { BaseChainDataProvider as t };
+//# sourceMappingURL=base-provider-CLnd7kte.d.mts.map

package/dist/base-provider-LNp6K7Mt.mjs

@@ -0,0 +1,96 @@
+import { n as AssetNotFoundError } from "./errors-CN1MFOLv.mjs";
+import { n as formatUnits, r as parseUnits, t as formatTokenAmount } from "./amount-B0J9TTNF.mjs";
+//#region src/provider/utils.ts
+/**
+* Convert amount between denom units (viem-based, no precision loss).
+*
+* @param amount - Amount string. Decimal input allowed when exponentDiff > 0.
+*   When exponentDiff < 0, must be integer string (BigInt conversion).
+* @param exponentDiff - fromUnit.exponent - toUnit.exponent
+* @returns Converted amount string
+*
+* @example convertDenomAmount('1.5', 6)      → '1500000'  (INIT → uinit)
+* @example convertDenomAmount('1500000', -6)  → '1.5'      (uinit → INIT)
+* @example convertDenomAmount('500', -6)      → '0.0005'   (precision preserved)
+*
+* @internal Not exported from public API
+*/
+function convertDenomAmount(amount, exponentDiff) {
+	if (exponentDiff === 0) return amount;
+	if (exponentDiff > 0) return parseUnits(amount, exponentDiff).toString();
+	else return formatUnits(BigInt(amount), -exponentDiff);
+}
+//#endregion
+//#region src/provider/base-provider.ts
+/**
+* Base class for ChainDataProvider implementations.
+* Provides shared implementations for amount conversion methods.
+*
+* @internal SDK internal use. Users should use ChainDataProvider interface or CustomProvider.
+* Direct subclassing requires implementing 14 abstract methods.
+*/
+var BaseChainDataProvider = class {
+	createTransport;
+	/**
+	* Find multiple assets by denoms (batch operation).
+	* Default: getAssets() once then match in loop.
+	* Subclasses may override for optimized batch lookup.
+	*/
+	async findAssets(denoms, chainId) {
+		const result = /* @__PURE__ */ new Map();
+		const assets = await this.getAssets(chainId);
+		for (const denom of denoms) result.set(denom, assets.find((a) => a.denom === denom));
+		return result;
+	}
+	/**
+	* Refresh provider data. Default is no-op (for static providers).
+	* RegistryProvider overrides this to re-fetch from API.
+	*/
+	async refresh() {
+		return {};
+	}
+	/**
+	* Convert base amount to display amount.
+	* @example toDisplayAmount(coin('uinit', '1000000'), 'interwoven-1') → '1'
+	*/
+	async toDisplayAmount(coin, chainId) {
+		const asset = await this.findAsset(coin.denom, chainId);
+		if (!asset) throw new AssetNotFoundError(coin.denom, chainId);
+		return formatUnits(BigInt(coin.amount), asset.decimals);
+	}
+	/**
+	* Convert display amount to base amount.
+	* Throws if amount has more decimal places than the asset's decimals.
+	* @example toBaseAmount('1', 'uinit', 'interwoven-1') → '1000000'
+	*/
+	async toBaseAmount(amount, denom, chainId) {
+		const asset = await this.findAsset(denom, chainId);
+		if (!asset) throw new AssetNotFoundError(denom, chainId);
+		return parseUnits(amount, asset.decimals).toString();
+	}
+	/**
+	* Convert amount between denom units.
+	* @example convertAmount('1.5', 'INIT', 'uinit', 'interwoven-1') → '1500000'
+	*/
+	async convertAmount(amount, fromDenom, toDenom, chainId) {
+		const asset = (await this.getAssets(chainId)).find((a) => a.denomUnits.some((u) => u.denom === fromDenom || u.aliases?.includes(fromDenom)) && a.denomUnits.some((u) => u.denom === toDenom || u.aliases?.includes(toDenom)));
+		if (!asset) throw new AssetNotFoundError(`${fromDenom}→${toDenom}`, chainId);
+		const fromUnit = asset.denomUnits.find((u) => u.denom === fromDenom || u.aliases?.includes(fromDenom));
+		const toUnit = asset.denomUnits.find((u) => u.denom === toDenom || u.aliases?.includes(toDenom));
+		if (!fromUnit || !toUnit) throw new AssetNotFoundError(`${fromDenom}→${toDenom}`, chainId);
+		return convertDenomAmount(amount, fromUnit.exponent - toUnit.exponent);
+	}
+	/**
+	* Format base amount for display (with symbol).
+	* @example formatAmount(coin('uinit', '1000000'), 'interwoven-1') → '1 INIT'
+	*/
+	async formatAmount(coin, chainId, options) {
+		const asset = await this.findAsset(coin.denom, chainId);
+		if (!asset) throw new AssetNotFoundError(coin.denom, chainId);
+		return `${formatTokenAmount(BigInt(coin.amount), asset.decimals, options ?? {})} ${asset.symbol}`;
+	}
+};
+//#endregion
+export { BaseChainDataProvider as t };
+
+//# sourceMappingURL=base-provider-LNp6K7Mt.mjs.map

package/dist/base-provider-LNp6K7Mt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider-LNp6K7Mt.mjs","names":[],"sources":["../src/provider/utils.ts","../src/provider/base-provider.ts"],"sourcesContent":["import { formatUnits, parseUnits } from '../util/units'\n\n/**\n * Convert amount between denom units (viem-based, no precision loss).\n *\n * @param amount - Amount string. Decimal input allowed when exponentDiff > 0.\n *   When exponentDiff < 0, must be integer string (BigInt conversion).\n * @param exponentDiff - fromUnit.exponent - toUnit.exponent\n * @returns Converted amount string\n *\n * @example convertDenomAmount('1.5', 6)      → '1500000'  (INIT → uinit)\n * @example convertDenomAmount('1500000', -6)  → '1.5'      (uinit → INIT)\n * @example convertDenomAmount('500', -6)      → '0.0005'   (precision preserved)\n *\n * @internal Not exported from public API\n */\nexport function convertDenomAmount(amount: string, exponentDiff: number): string {\n  if (exponentDiff === 0) return amount\n\n  if (exponentDiff > 0) {\n    // Larger unit → smaller unit (e.g., INIT → uinit): parseUnits\n    return parseUnits(amount, exponentDiff).toString()\n  } else {\n    // Smaller unit → larger unit (e.g., uinit → INIT): formatUnits\n    return formatUnits(BigInt(amount), -exponentDiff)\n  }\n}\n","import type { AssetList } from '@initia/initia-registry-types'\nimport type { AssetList as CosmosAssetList } from '@chain-registry/types'\nimport type { ChainType, NetworkType } from '../client/types'\nimport type { Coin } from '../core/coin'\nimport { AssetNotFoundError } from '../errors'\nimport { formatUnits, parseUnits } from '../util/units'\nimport { convertDenomAmount } from './utils'\nimport { formatTokenAmount } from '../util/amount'\nimport type { TransportFactory } from '../client/transport-common'\nimport type {\n  ChainInfo,\n  ChainInfoForType,\n  AssetInfo,\n  IbcChannelInfo,\n  ListAssetsOptions,\n  OpBridgeInfo,\n  TransferPath,\n  ChainDataProvider,\n  RefreshResult,\n} from './types'\n\n/**\n * Base class for ChainDataProvider implementations.\n * Provides shared implementations for amount conversion methods.\n *\n * @internal SDK internal use. Users should use ChainDataProvider interface or CustomProvider.\n * Direct subclassing requires implementing 14 abstract methods.\n */\nexport abstract class BaseChainDataProvider implements ChainDataProvider {\n  createTransport?: TransportFactory\n\n  // === Abstract methods (subclasses must implement) ===\n\n  abstract getChainInfo<T extends ChainType = ChainType>(\n    chainId: string\n  ): ChainInfoForType<T> | undefined\n  abstract listChains(): ChainInfo[]\n  abstract hasChain(chainId: string): boolean\n  abstract getAssets(chainId: string): Promise<AssetInfo[]>\n  abstract getRawAssetList(chainId: string): Promise<AssetList | CosmosAssetList | undefined>\n  abstract findAsset(denom: string, chainId?: string): Promise<AssetInfo | undefined>\n  abstract findAssetBySymbol(symbol: string, chainId?: string): Promise<AssetInfo[]>\n  abstract listAssets(options?: ListAssetsOptions): Promise<AssetInfo[]>\n  abstract getIbcChannels(chainId: string): IbcChannelInfo[]\n  abstract getIbcChannel(fromChainId: string, toChainId: string): IbcChannelInfo | undefined\n  abstract getTransferPath(\n    fromChainId: string,\n    toChainId: string,\n    denom?: string\n  ): TransferPath | undefined\n  abstract getOpBridge(l2ChainId: string): OpBridgeInfo | undefined\n  abstract resolveChainId(chainName: string, network?: NetworkType): string | undefined\n  abstract getChainName(chainId: string): string | undefined\n\n  // === Shared implementations ===\n\n  /**\n   * Find multiple assets by denoms (batch operation).\n   * Default: getAssets() once then match in loop.\n   * Subclasses may override for optimized batch lookup.\n   */\n  async findAssets(denoms: string[], chainId: string): Promise<Map<string, AssetInfo | undefined>> {\n    const result = new Map<string, AssetInfo | undefined>()\n    const assets = await this.getAssets(chainId)\n    for (const denom of denoms) {\n      result.set(\n        denom,\n        assets.find(a => a.denom === denom)\n      )\n    }\n    return result\n  }\n\n  /**\n   * Refresh provider data. Default is no-op (for static providers).\n   * RegistryProvider overrides this to re-fetch from API.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async refresh(): Promise<RefreshResult> {\n    // No-op for static data providers\n    return {}\n  }\n\n  /**\n   * Convert base amount to display amount.\n   * @example toDisplayAmount(coin('uinit', '1000000'), 'interwoven-1') → '1'\n   */\n  async toDisplayAmount(coin: Coin, chainId: string): Promise<string> {\n    const asset = await this.findAsset(coin.denom, chainId)\n    if (!asset) throw new AssetNotFoundError(coin.denom, chainId)\n    return formatUnits(BigInt(coin.amount), asset.decimals)\n  }\n\n  /**\n   * Convert display amount to base amount.\n   * Throws if amount has more decimal places than the asset's decimals.\n   * @example toBaseAmount('1', 'uinit', 'interwoven-1') → '1000000'\n   */\n  async toBaseAmount(amount: string, denom: string, chainId: string): Promise<string> {\n    const asset = await this.findAsset(denom, chainId)\n    if (!asset) throw new AssetNotFoundError(denom, chainId)\n    return parseUnits(amount, asset.decimals).toString()\n  }\n\n  /**\n   * Convert amount between denom units.\n   * @example convertAmount('1.5', 'INIT', 'uinit', 'interwoven-1') → '1500000'\n   */\n  async convertAmount(\n    amount: string,\n    fromDenom: string,\n    toDenom: string,\n    chainId: string\n  ): Promise<string> {\n    const assets = await this.getAssets(chainId)\n    const asset = assets.find(\n      a =>\n        a.denomUnits.some(u => u.denom === fromDenom || u.aliases?.includes(fromDenom)) &&\n        a.denomUnits.some(u => u.denom === toDenom || u.aliases?.includes(toDenom))\n    )\n    if (!asset) throw new AssetNotFoundError(`${fromDenom}→${toDenom}`, chainId)\n\n    const fromUnit = asset.denomUnits.find(\n      u => u.denom === fromDenom || u.aliases?.includes(fromDenom)\n    )\n    const toUnit = asset.denomUnits.find(u => u.denom === toDenom || u.aliases?.includes(toDenom))\n    if (!fromUnit || !toUnit) throw new AssetNotFoundError(`${fromDenom}→${toDenom}`, chainId)\n\n    return convertDenomAmount(amount, fromUnit.exponent - toUnit.exponent)\n  }\n\n  /**\n   * Format base amount for display (with symbol).\n   * @example formatAmount(coin('uinit', '1000000'), 'interwoven-1') → '1 INIT'\n   */\n  async formatAmount(\n    coin: Coin,\n    chainId: string,\n    options?: {\n      maxDecimals?: number\n      minDecimals?: number\n      trimTrailingZeros?: boolean\n    }\n  ): Promise<string> {\n    const asset = await this.findAsset(coin.denom, chainId)\n    if (!asset) throw new AssetNotFoundError(coin.denom, chainId)\n\n    const formatted = formatTokenAmount(BigInt(coin.amount), asset.decimals, options ?? {})\n    return `${formatted} ${asset.symbol}`\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,mBAAmB,QAAgB,cAA8B;AAC/E,KAAI,iBAAiB,EAAG,QAAO;AAE/B,KAAI,eAAe,EAEjB,QAAO,WAAW,QAAQ,aAAa,CAAC,UAAU;KAGlD,QAAO,YAAY,OAAO,OAAO,EAAE,CAAC,aAAa;;;;;;;;;;;ACIrD,IAAsB,wBAAtB,MAAyE;CACvE;;;;;;CAgCA,MAAM,WAAW,QAAkB,SAA8D;EAC/F,MAAM,yBAAS,IAAI,KAAoC;EACvD,MAAM,SAAS,MAAM,KAAK,UAAU,QAAQ;AAC5C,OAAK,MAAM,SAAS,OAClB,QAAO,IACL,OACA,OAAO,MAAK,MAAK,EAAE,UAAU,MAAM,CACpC;AAEH,SAAO;;;;;;CAQT,MAAM,UAAkC;AAEtC,SAAO,EAAE;;;;;;CAOX,MAAM,gBAAgB,MAAY,SAAkC;EAClE,MAAM,QAAQ,MAAM,KAAK,UAAU,KAAK,OAAO,QAAQ;AACvD,MAAI,CAAC,MAAO,OAAM,IAAI,mBAAmB,KAAK,OAAO,QAAQ;AAC7D,SAAO,YAAY,OAAO,KAAK,OAAO,EAAE,MAAM,SAAS;;;;;;;CAQzD,MAAM,aAAa,QAAgB,OAAe,SAAkC;EAClF,MAAM,QAAQ,MAAM,KAAK,UAAU,OAAO,QAAQ;AAClD,MAAI,CAAC,MAAO,OAAM,IAAI,mBAAmB,OAAO,QAAQ;AACxD,SAAO,WAAW,QAAQ,MAAM,SAAS,CAAC,UAAU;;;;;;CAOtD,MAAM,cACJ,QACA,WACA,SACA,SACiB;EAEjB,MAAM,SADS,MAAM,KAAK,UAAU,QAAQ,EACvB,MACnB,MACE,EAAE,WAAW,MAAK,MAAK,EAAE,UAAU,aAAa,EAAE,SAAS,SAAS,UAAU,CAAC,IAC/E,EAAE,WAAW,MAAK,MAAK,EAAE,UAAU,WAAW,EAAE,SAAS,SAAS,QAAQ,CAAC,CAC9E;AACD,MAAI,CAAC,MAAO,OAAM,IAAI,mBAAmB,GAAG,UAAU,GAAG,WAAW,QAAQ;EAE5E,MAAM,WAAW,MAAM,WAAW,MAChC,MAAK,EAAE,UAAU,aAAa,EAAE,SAAS,SAAS,UAAU,CAC7D;EACD,MAAM,SAAS,MAAM,WAAW,MAAK,MAAK,EAAE,UAAU,WAAW,EAAE,SAAS,SAAS,QAAQ,CAAC;AAC9F,MAAI,CAAC,YAAY,CAAC,OAAQ,OAAM,IAAI,mBAAmB,GAAG,UAAU,GAAG,WAAW,QAAQ;AAE1F,SAAO,mBAAmB,QAAQ,SAAS,WAAW,OAAO,SAAS;;;;;;CAOxE,MAAM,aACJ,MACA,SACA,SAKiB;EACjB,MAAM,QAAQ,MAAM,KAAK,UAAU,KAAK,OAAO,QAAQ;AACvD,MAAI,CAAC,MAAO,OAAM,IAAI,mBAAmB,KAAK,OAAO,QAAQ;AAG7D,SAAO,GADW,kBAAkB,OAAO,KAAK,OAAO,EAAE,MAAM,UAAU,WAAW,EAAE,CAAC,CACnE,GAAG,MAAM"}