@initia/initia.js 1.0.21 → 2.0.0-rc.1

package/dist/address-DwAkzgJk.mjs

@@ -0,0 +1,156 @@
+import { bech32 } from "@scure/base";
+import { keccak_256 } from "@noble/hashes/sha3.js";
+import { bytesToHex, hexToBytes } from "@noble/hashes/utils.js";
+//#region src/util/address.ts
+/**
+* Bech32 address utilities for Initia blockchain.
+*
+* Provides type definitions and conversion utilities for all Initia address types:
+* - AccAddress: Account addresses (init1...)
+* - ValAddress: Validator operator addresses (initvaloper1...)
+* - ValConsAddress: Validator consensus addresses (initvalcons1...)
+* - AccPubKey: Account public keys (initpub1...)
+* - ValPubKey: Validator public keys (initvaloperpub1...)
+*/
+/**
+* Decode a bech32 address with runtime validation.
+* Centralizes the Bech32String type assertion to a single location.
+*
+* @param address - Address string to decode
+* @returns Decoded prefix and words
+* @throws Error if not a valid bech32 string
+*/
+function decodeBech32(address) {
+	if (!address.includes("1")) throw new Error(`Invalid bech32 format: missing separator in "${address}"`);
+	return bech32.decode(address);
+}
+/**
+* Try to decode a bech32 address, returning null on failure.
+*/
+function tryDecodeBech32(address) {
+	try {
+		if (!address.includes("1")) return null;
+		return bech32.decode(address);
+	} catch {
+		return null;
+	}
+}
+function checkPrefixAndLength(prefix, data, length) {
+	const decoded = tryDecodeBech32(data);
+	return decoded !== null && decoded.prefix === prefix && data.length === length;
+}
+/**
+* Account address utilities.
+*/
+const AccAddress = {
+	validate(data) {
+		return checkPrefixAndLength("init", data, 43) || checkPrefixAndLength("init", data, 63);
+	},
+	fromValAddress(valAddr) {
+		const decoded = decodeBech32(valAddr);
+		return bech32.encode("init", decoded.words);
+	},
+	toHex(address) {
+		const decoded = decodeBech32(address);
+		const bytes = bech32.fromWords(decoded.words);
+		return "0x" + bytesToHex(new Uint8Array(bytes));
+	},
+	fromHex(hexAddress, options) {
+		const prefix = options?.prefix ?? options?.chainInfo?.bech32Prefix ?? "init";
+		const hex = hexAddress.replace(/^0x0*|^0+/, "");
+		const bytes = hexToBytes(hex.length <= 40 ? hex.padStart(40, "0") : hex.padStart(64, "0"));
+		return bech32.encode(prefix, bech32.toWords(bytes));
+	},
+	toBytes(address) {
+		const decoded = decodeBech32(address);
+		return new Uint8Array(bech32.fromWords(decoded.words));
+	},
+	isValidBech32(address, prefix = "init") {
+		const decoded = tryDecodeBech32(address);
+		return decoded !== null && decoded.prefix === prefix;
+	}
+};
+/**
+* Account public key utilities.
+*/
+const AccPubKey = {
+	validate(data) {
+		return checkPrefixAndLength("initpub", data, 46);
+	},
+	fromAccAddress(address) {
+		const decoded = decodeBech32(address);
+		return bech32.encode("initpub", decoded.words);
+	}
+};
+/**
+* Validator operator address utilities.
+*/
+const ValAddress = {
+	validate(data) {
+		return checkPrefixAndLength("initvaloper", data, 50);
+	},
+	fromAccAddress(accAddr) {
+		const decoded = decodeBech32(accAddr);
+		return bech32.encode("initvaloper", decoded.words);
+	}
+};
+/**
+* Validator public key utilities.
+*/
+const ValPubKey = {
+	validate(data) {
+		return checkPrefixAndLength("initvaloperpub", data, 53);
+	},
+	fromValAddress(valAddress) {
+		const decoded = decodeBech32(valAddress);
+		return bech32.encode("initvaloperpub", decoded.words);
+	}
+};
+/**
+* Validator consensus address utilities.
+*/
+const ValConsAddress = { validate(data) {
+	return checkPrefixAndLength("initvalcons", data, 50);
+} };
+/**
+* Validates if a string is a valid EVM address (0x-prefixed, 40 hex chars).
+*
+* @param address - Address to validate
+* @returns true if valid EVM address format
+*
+* @example
+* ```typescript
+* isValidEvmAddress('0x1234567890123456789012345678901234567890')  // true
+* isValidEvmAddress('0x123')  // false (too short)
+* isValidEvmAddress('init1...')  // false (not EVM format)
+* ```
+*/
+function isValidEvmAddress(address) {
+	return /^0x[0-9a-fA-F]{40}$/.test(address);
+}
+/**
+* Converts an EVM address to EIP-55 checksum format.
+*
+* @param address - EVM address to convert
+* @returns Checksum-formatted address
+* @throws Error if address is invalid
+*
+* @example
+* ```typescript
+* toChecksumAddress('0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed')
+* // '0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed'
+* ```
+*/
+function toChecksumAddress(address) {
+	const lower = address.toLowerCase();
+	if (!/^0x[0-9a-f]{40}$/.test(lower)) throw new Error(`Invalid EVM address: ${address}`);
+	const body = lower.slice(2);
+	const hash = bytesToHex(keccak_256(new TextEncoder().encode(body)));
+	let result = "0x";
+	for (let i = 0; i < 40; i++) result += parseInt(hash[i], 16) >= 8 ? body[i].toUpperCase() : body[i];
+	return result;
+}
+//#endregion
+export { ValPubKey as a, tryDecodeBech32 as c, ValConsAddress as i, AccPubKey as n, isValidEvmAddress as o, ValAddress as r, toChecksumAddress as s, AccAddress as t };
+
+//# sourceMappingURL=address-DwAkzgJk.mjs.map

package/dist/address-DwAkzgJk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-DwAkzgJk.mjs","names":[],"sources":["../src/util/address.ts"],"sourcesContent":["/**\n * Bech32 address utilities for Initia blockchain.\n *\n * Provides type definitions and conversion utilities for all Initia address types:\n * - AccAddress: Account addresses (init1...)\n * - ValAddress: Validator operator addresses (initvaloper1...)\n * - ValConsAddress: Validator consensus addresses (initvalcons1...)\n * - AccPubKey: Account public keys (initpub1...)\n * - ValPubKey: Validator public keys (initvaloperpub1...)\n */\n\nimport { bech32 } from '@scure/base'\nimport { bytesToHex, hexToBytes } from '@noble/hashes/utils.js'\nimport { keccak_256 } from '@noble/hashes/sha3.js'\n\nimport type { ChainInfo } from '../provider/types'\n\n/** Bech32 string type (contains '1' separator) */\ntype Bech32String = `${string}1${string}`\n\n/** `init1...` prefixed account address */\nexport type AccAddress = string\n\n/** `initvaloper1...` prefixed validator operator address */\nexport type ValAddress = string\n\n/** `initvalcons1...` prefixed validator consensus address */\nexport type ValConsAddress = string\n\n/** `initpub1...` prefixed account public key */\nexport type AccPubKey = string\n\n/** `initvaloperpub1...` prefixed validator public key */\nexport type ValPubKey = string\n\n/**\n * Options for converting hex address to bech32.\n */\nexport interface FromHexOptions {\n  /** Direct prefix override (highest priority) */\n  prefix?: string\n  /** Extract prefix from ChainInfo (used if prefix not specified) */\n  chainInfo?: Pick<ChainInfo, 'bech32Prefix' | 'chainType'>\n}\n\n// =============================================================================\n// Bech32 Helpers (centralized type assertion)\n// =============================================================================\n\n/**\n * Decode a bech32 address with runtime validation.\n * Centralizes the Bech32String type assertion to a single location.\n *\n * @param address - Address string to decode\n * @returns Decoded prefix and words\n * @throws Error if not a valid bech32 string\n */\nfunction decodeBech32(address: string): { prefix: string; words: number[] } {\n  // Runtime validation: bech32 requires '1' separator\n  if (!address.includes('1')) {\n    throw new Error(`Invalid bech32 format: missing separator in \"${address}\"`)\n  }\n  return bech32.decode(address as Bech32String)\n}\n\n/**\n * Try to decode a bech32 address, returning null on failure.\n */\nexport function tryDecodeBech32(address: string): { prefix: string; words: number[] } | null {\n  try {\n    if (!address.includes('1')) return null\n    return bech32.decode(address as Bech32String)\n  } catch {\n    return null\n  }\n}\n\nfunction checkPrefixAndLength(prefix: string, data: string, length: number): boolean {\n  const decoded = tryDecodeBech32(data)\n  return decoded !== null && decoded.prefix === prefix && data.length === length\n}\n\n/**\n * Account address utilities.\n */\nexport const AccAddress = {\n  /**\n   * Validates if a string is a valid Initia account address.\n   * Accepts both 20-byte (43 chars) and 32-byte Move addresses (63 chars).\n   */\n  validate(data: string): boolean {\n    return checkPrefixAndLength('init', data, 43) || checkPrefixAndLength('init', data, 63)\n  },\n\n  /**\n   * Converts a validator address to an account address.\n   */\n  fromValAddress(valAddr: ValAddress): AccAddress {\n    const decoded = decodeBech32(valAddr)\n    return bech32.encode('init', decoded.words)\n  },\n\n  /**\n   * Converts an account address to a hex string (0x prefixed).\n   */\n  toHex(address: AccAddress): string {\n    const decoded = decodeBech32(address)\n    const bytes = bech32.fromWords(decoded.words)\n    return '0x' + bytesToHex(new Uint8Array(bytes))\n  },\n\n  /**\n   * Converts a hex address to a bech32 address.\n   * Handles both 20-byte and 32-byte addresses.\n   *\n   * @param hexAddress - Hex address (with or without 0x prefix)\n   * @param options - Optional prefix configuration\n   * @returns Bech32 encoded address\n   *\n   * @example\n   * ```typescript\n   * // Default (init prefix)\n   * AccAddress.fromHex('0x1234...')  // 'init1...'\n   *\n   * // Custom prefix\n   * AccAddress.fromHex('0x1234...', { prefix: 'noble' })  // 'noble1...'\n   *\n   * // From ChainInfo\n   * AccAddress.fromHex('0x1234...', { chainInfo })  // uses chainInfo.bech32Prefix\n   * ```\n   */\n  fromHex(hexAddress: string, options?: FromHexOptions): string {\n    // Determine prefix: options.prefix > chainInfo.bech32Prefix > 'init'\n    const prefix = options?.prefix ?? options?.chainInfo?.bech32Prefix ?? 'init'\n\n    const hex = hexAddress.replace(/^0x0*|^0+/, '')\n    const paddedHex = hex.length <= 40 ? hex.padStart(40, '0') : hex.padStart(64, '0')\n    const bytes = hexToBytes(paddedHex)\n    return bech32.encode(prefix, bech32.toWords(bytes))\n  },\n\n  /**\n   * Converts an account address to raw bytes.\n   */\n  toBytes(address: AccAddress): Uint8Array {\n    const decoded = decodeBech32(address)\n    return new Uint8Array(bech32.fromWords(decoded.words))\n  },\n\n  /**\n   * Validates if a string is a valid bech32 address with optional prefix check.\n   *\n   * @param address - Address to validate\n   * @param prefix - Expected prefix (defaults to 'init')\n   * @returns true if valid bech32 address with matching prefix\n   *\n   * @example\n   * ```typescript\n   * AccAddress.isValidBech32('init1...')           // true\n   * AccAddress.isValidBech32('noble1...', 'noble') // true\n   * AccAddress.isValidBech32('noble1...', 'init')  // false (prefix mismatch)\n   * ```\n   */\n  isValidBech32(address: string, prefix: string = 'init'): boolean {\n    const decoded = tryDecodeBech32(address)\n    return decoded !== null && decoded.prefix === prefix\n  },\n}\n\n/**\n * Account public key utilities.\n */\nexport const AccPubKey = {\n  /**\n   * Validates if a string is a valid Initia account public key.\n   */\n  validate(data: string): boolean {\n    return checkPrefixAndLength('initpub', data, 46)\n  },\n\n  /**\n   * Converts an account address to an account public key format.\n   */\n  fromAccAddress(address: AccAddress): AccPubKey {\n    const decoded = decodeBech32(address)\n    return bech32.encode('initpub', decoded.words)\n  },\n}\n\n/**\n * Validator operator address utilities.\n */\nexport const ValAddress = {\n  /**\n   * Validates if a string is a valid Initia validator address.\n   */\n  validate(data: string): boolean {\n    return checkPrefixAndLength('initvaloper', data, 50)\n  },\n\n  /**\n   * Converts an account address to a validator address.\n   */\n  fromAccAddress(accAddr: AccAddress): ValAddress {\n    const decoded = decodeBech32(accAddr)\n    return bech32.encode('initvaloper', decoded.words)\n  },\n}\n\n/**\n * Validator public key utilities.\n */\nexport const ValPubKey = {\n  /**\n   * Validates if a string is a valid Initia validator public key.\n   */\n  validate(data: string): boolean {\n    return checkPrefixAndLength('initvaloperpub', data, 53)\n  },\n\n  /**\n   * Converts a validator address to a validator public key format.\n   */\n  fromValAddress(valAddress: ValAddress): ValPubKey {\n    const decoded = decodeBech32(valAddress)\n    return bech32.encode('initvaloperpub', decoded.words)\n  },\n}\n\n/**\n * Validator consensus address utilities.\n */\nexport const ValConsAddress = {\n  /**\n   * Validates if a string is a valid Initia validator consensus address.\n   */\n  validate(data: string): boolean {\n    return checkPrefixAndLength('initvalcons', data, 50)\n  },\n}\n\n// =============================================================================\n// EVM Address Utilities\n// =============================================================================\n\n/**\n * Validates if a string is a valid EVM address (0x-prefixed, 40 hex chars).\n *\n * @param address - Address to validate\n * @returns true if valid EVM address format\n *\n * @example\n * ```typescript\n * isValidEvmAddress('0x1234567890123456789012345678901234567890')  // true\n * isValidEvmAddress('0x123')  // false (too short)\n * isValidEvmAddress('init1...')  // false (not EVM format)\n * ```\n */\nexport function isValidEvmAddress(address: string): boolean {\n  return /^0x[0-9a-fA-F]{40}$/.test(address)\n}\n\n/**\n * Converts an EVM address to EIP-55 checksum format.\n *\n * @param address - EVM address to convert\n * @returns Checksum-formatted address\n * @throws Error if address is invalid\n *\n * @example\n * ```typescript\n * toChecksumAddress('0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed')\n * // '0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed'\n * ```\n */\nexport function toChecksumAddress(address: string): string {\n  const lower = address.toLowerCase()\n  if (!/^0x[0-9a-f]{40}$/.test(lower)) {\n    throw new Error(`Invalid EVM address: ${address}`)\n  }\n  const body = lower.slice(2)\n  const hash = bytesToHex(keccak_256(new TextEncoder().encode(body)))\n  let result = '0x'\n  for (let i = 0; i < 40; i++) {\n    result += parseInt(hash[i], 16) >= 8 ? body[i].toUpperCase() : body[i]\n  }\n  return result\n}\n"],"mappings":"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"}

package/dist/address-profile-DjdaEBxo.d.mts

@@ -0,0 +1,112 @@
+import { _ as HasClient } from "./types-DGrP9Ro_.mjs";
+
+//#region src/client/address-profile.d.ts
+/**
+ * On-chain account type derived from auth query's typeUrl.
+ * - 'unknown': typeUrl that SDK doesn't explicitly map (e.g., vesting accounts on other Cosmos chains)
+ * - Initia uses Move-based vesting, not Cosmos SDK vesting accounts
+ */
+type AccountKind = 'base' | 'module' | 'evm-code' | 'evm-shorthand' | 'move-object' | 'move-table' | 'unknown';
+/**
+ * Functional capability derived from VM queries.
+ * Kept as a standalone export for convenience; inline literals used in AddressProfile for narrowing.
+ */
+type ContractKind = 'none' | 'evm' | 'move' | 'wasm';
+/**
+ * Discriminated union representing a comprehensive address profile.
+ *
+ * Two independent axes:
+ * - `account`: on-chain truth from auth query (undefined = not yet on-chain)
+ * - `contract`: functional capability from VM queries (discriminant)
+ *
+ * Type-level constraints prevent impossible states:
+ * - 'evm-code' always pairs with contract: 'evm'
+ * - 'evm-shorthand' pairs with contract: 'evm' or 'none' (transparent resolve of canonical)
+ * - Move/Wasm variants exclude EVM-specific account kinds
+ */
+type AddressProfile = {
+  address: string;
+  account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>;
+  contract: 'none';
+} | {
+  address: string;
+  account: 'evm-code';
+  contract: 'evm'; /** Byte count of deployed EVM code. 0 means no code. */
+  codeSize: number;
+  codeHash: Uint8Array;
+} | {
+  address: string;
+  account: 'evm-shorthand';
+  canonical: string;
+  contract: 'evm'; /** Byte count of deployed EVM code. 0 means no code. */
+  codeSize: number;
+  codeHash: Uint8Array;
+} | {
+  address: string;
+  account: 'evm-shorthand';
+  canonical: string;
+  contract: 'none';
+} | {
+  address: string;
+  account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>;
+  contract: 'move';
+  modules: [string, ...string[]];
+} | {
+  address: string;
+  account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>;
+  contract: 'wasm';
+  codeId: bigint;
+};
+/** Profile where contract is 'evm' (includes both direct and shorthand). */
+type EvmProfile = Extract<AddressProfile, {
+  contract: 'evm';
+}>;
+/** Profile with account 'evm-shorthand' (contract can be 'evm' or 'none'). */
+type ShorthandProfile = Extract<AddressProfile, {
+  account: 'evm-shorthand';
+}>;
+/** Profile with contract 'none' excluding shorthand (pure EOA/module/etc). */
+type EoaProfile = Exclude<Extract<AddressProfile, {
+  contract: 'none';
+}>, ShorthandProfile>;
+/** Profile where contract is 'move'. */
+type MoveProfile = Extract<AddressProfile, {
+  contract: 'move';
+}>;
+/** Profile where contract is 'wasm'. */
+type WasmProfile = Extract<AddressProfile, {
+  contract: 'wasm';
+}>;
+/**
+ * Options for getAddressProfile.
+ */
+interface GetAddressProfileOptions {
+  /** Cache TTL in milliseconds. Default 60000. Set to 0 to disable caching. */
+  cacheTtl?: number;
+  /** Bypass cache and force fresh queries. */
+  forceRefresh?: boolean;
+}
+/**
+ * Cache interface for AddressProfile results.
+ */
+interface ProfileCache {
+  get(address: string): AddressProfile | undefined;
+  set(address: string, profile: AddressProfile, ttl?: number): void;
+  invalidate(address: string): void;
+}
+/**
+ * Get comprehensive address profile by querying auth and VM services.
+ * Uses context's address when available.
+ */
+declare function getAddressProfile(context: {
+  readonly client: unknown;
+  readonly address: string;
+}, options?: GetAddressProfileOptions): Promise<AddressProfile>;
+/**
+ * Get comprehensive address profile by querying auth and VM services.
+ * Address is provided as a separate parameter.
+ */
+declare function getAddressProfile(context: HasClient, address: string, options?: GetAddressProfileOptions): Promise<AddressProfile>;
+//#endregion
+export { EvmProfile as a, ProfileCache as c, getAddressProfile as d, EoaProfile as i, ShorthandProfile as l, AddressProfile as n, GetAddressProfileOptions as o, ContractKind as r, MoveProfile as s, AccountKind as t, WasmProfile as u };
+//# sourceMappingURL=address-profile-DjdaEBxo.d.mts.map

package/dist/address-profile-DlAFvgdg.mjs

@@ -0,0 +1,241 @@
+import { g as isNotFoundError } from "./errors-CN1MFOLv.mjs";
+import { n as ShorthandAccountSchema, t as ContractAccountSchema } from "./auth_pb-DN4URGLh.mjs";
+import { anyUnpack } from "@bufbuild/protobuf/wkt";
+//#region src/client/address-profile.ts
+const DEFAULT_CACHE_TTL = 6e4;
+var MemoryProfileCache = class {
+	store = /* @__PURE__ */ new Map();
+	get(address) {
+		const entry = this.store.get(address);
+		if (!entry) return void 0;
+		if (Date.now() > entry.expiresAt) {
+			this.store.delete(address);
+			return;
+		}
+		return entry.profile;
+	}
+	set(address, profile, ttl = DEFAULT_CACHE_TTL) {
+		this.store.set(address, {
+			profile,
+			expiresAt: Date.now() + ttl
+		});
+	}
+	invalidate(address) {
+		this.store.delete(address);
+	}
+};
+const typeUrlToAccountKind = {
+	"/cosmos.auth.v1beta1.BaseAccount": "base",
+	"/cosmos.auth.v1beta1.ModuleAccount": "module",
+	"/initia.move.v1.ObjectAccount": "move-object",
+	"/initia.move.v1.TableAccount": "move-table",
+	"/minievm.evm.v1.ContractAccount": "evm-code",
+	"/minievm.evm.v1.ShorthandAccount": "evm-shorthand"
+};
+/** Resolve a proto typeUrl to AccountKind. Returns 'unknown' for unmapped typeUrls. */
+function resolveAccountKind(typeUrl) {
+	return typeUrlToAccountKind[typeUrl] ?? "unknown";
+}
+function hasAuthService(client) {
+	return client !== null && typeof client === "object" && "auth" in client;
+}
+function hasEvmService(client) {
+	return client !== null && typeof client === "object" && "evm" in client;
+}
+function hasMoveService(client) {
+	return client !== null && typeof client === "object" && "move" in client;
+}
+function hasWasmService(client) {
+	return client !== null && typeof client === "object" && "wasm" in client;
+}
+/**
+* Query auth account. Returns null for NOT_FOUND (account doesn't exist on-chain).
+* Throws on network failure.
+*/
+async function queryAuth(client, address) {
+	let response;
+	try {
+		response = await client.auth.account({ address });
+	} catch (err) {
+		if (isNotFoundError(err)) return null;
+		throw err;
+	}
+	if (!response.account) return null;
+	const { typeUrl } = response.account;
+	const accountKind = resolveAccountKind(typeUrl);
+	const result = { accountKind };
+	if (accountKind === "evm-code") {
+		const unpacked = anyUnpack(response.account, ContractAccountSchema);
+		if (unpacked) result.codeHash = unpacked.codeHash;
+	} else if (accountKind === "evm-shorthand") {
+		const unpacked = anyUnpack(response.account, ShorthandAccountSchema);
+		if (unpacked) result.originalAddress = unpacked.originalAddress;
+	}
+	return result;
+}
+/**
+* Query EVM code size. Returns 0 if no code deployed. Throws on network failure.
+* Note: returns byte count of deployed code (Uint8Array.length).
+*/
+async function queryEvmCode(client, address) {
+	return (await client.evm.code({ contractAddr: address })).code.length;
+}
+/** Query Move modules. Returns empty array if no modules. Throws on network failure. */
+async function queryMoveModules(client, address) {
+	return (await client.move.modules({ address })).modules.map((m) => m.moduleName).filter(Boolean);
+}
+/** Query Wasm contract info. Returns codeId or null if not a wasm contract. Throws on network failure. */
+async function queryWasmContract(client, address) {
+	try {
+		return (await client.wasm.contractInfo({ address })).contractInfo?.codeId ?? null;
+	} catch (err) {
+		if (isNotFoundError(err)) return null;
+		throw err;
+	}
+}
+/**
+* Validate consistency between auth result and EVM code query.
+* Throws on impossible state combinations.
+*/
+function validateEvmConsistency(address, accountKind, codeSize) {
+	if (accountKind === "evm-code" && codeSize === 0) throw new Error(`Inconsistent state for ${address}: ContractAccount but EVM codeSize = 0`);
+	if (accountKind !== "evm-code" && accountKind !== "evm-shorthand" && codeSize > 0) throw new Error(`Inconsistent state for ${address}: account '${accountKind}' but EVM codeSize > 0`);
+}
+/**
+* Validate that ShorthandAccount has a canonical address.
+* Throws if proto unpacking failed.
+*/
+function validateShorthandCanonical(address, originalAddress) {
+	if (!originalAddress) throw new Error(`Failed to extract canonical address from ShorthandAccount ${address}`);
+}
+/**
+* Resolve a ShorthandAccount by querying the canonical address.
+* Returns an AddressProfile with account: 'evm-shorthand'.
+*
+* ShorthandAccount only exists on Minievm chains, so only EVM is checked for canonical.
+*/
+async function resolveShorthand(client, shorthandAddress, canonicalAddress) {
+	if (!hasAuthService(client)) throw new Error("Auth service required for ShorthandAccount resolve");
+	const canonicalAuth = await queryAuth(client, canonicalAddress);
+	if (!canonicalAuth) return {
+		address: shorthandAddress,
+		account: "evm-shorthand",
+		canonical: canonicalAddress,
+		contract: "none"
+	};
+	if (canonicalAuth.accountKind === "evm-shorthand") throw new Error(`Unexpected: canonical address ${canonicalAddress} is also a ShorthandAccount`);
+	if (canonicalAuth.accountKind === "evm-code") {
+		if (!canonicalAuth.codeHash) throw new Error(`ContractAccount ${canonicalAddress} missing codeHash`);
+		if (!hasEvmService(client)) throw new Error("EVM service required for ContractAccount on Minievm chain");
+		const codeSize = await queryEvmCode(client, canonicalAddress);
+		if (codeSize === 0) throw new Error(`ContractAccount ${canonicalAddress} has no EVM code (codeSize = 0)`);
+		return {
+			address: shorthandAddress,
+			account: "evm-shorthand",
+			canonical: canonicalAddress,
+			contract: "evm",
+			codeSize,
+			codeHash: canonicalAuth.codeHash
+		};
+	}
+	return {
+		address: shorthandAddress,
+		account: "evm-shorthand",
+		canonical: canonicalAddress,
+		contract: "none"
+	};
+}
+const profileCache = new MemoryProfileCache();
+async function getAddressProfile(context, addressOrOptions, maybeOptions) {
+	let address;
+	let options;
+	if (typeof addressOrOptions === "string") {
+		address = addressOrOptions;
+		options = maybeOptions;
+	} else {
+		const ctx = context;
+		if (!ctx.address) throw new Error("Context has no address. Pass address as second argument.");
+		address = ctx.address;
+		options = addressOrOptions;
+	}
+	const cacheTtl = options?.cacheTtl ?? DEFAULT_CACHE_TTL;
+	if (!options?.forceRefresh && cacheTtl > 0) {
+		const cached = profileCache.get(address);
+		if (cached) return cached;
+	}
+	const { client } = context;
+	if (!hasAuthService(client)) throw new Error("Auth service is required for getAddressProfile");
+	const authResult = await queryAuth(client, address);
+	if (!authResult) {
+		const profile = {
+			address,
+			contract: "none"
+		};
+		if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+		return profile;
+	}
+	const { accountKind, codeHash, originalAddress } = authResult;
+	if (accountKind === "evm-shorthand") {
+		validateShorthandCanonical(address, originalAddress);
+		const profile = await resolveShorthand(client, address, originalAddress);
+		if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+		return profile;
+	}
+	if (accountKind === "evm-code") {
+		if (!codeHash) throw new Error(`ContractAccount ${address} missing codeHash`);
+		if (!hasEvmService(client)) throw new Error("EVM service required for ContractAccount");
+		const codeSize = await queryEvmCode(client, address);
+		validateEvmConsistency(address, accountKind, codeSize);
+		const profile = {
+			address,
+			account: "evm-code",
+			contract: "evm",
+			codeSize,
+			codeHash
+		};
+		if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+		return profile;
+	}
+	const account = accountKind;
+	if (hasEvmService(client)) {
+		const codeSize = await queryEvmCode(client, address);
+		validateEvmConsistency(address, accountKind, codeSize);
+	}
+	if (hasMoveService(client)) {
+		const modules = await queryMoveModules(client, address);
+		if (modules.length > 0) {
+			const profile = {
+				address,
+				account,
+				contract: "move",
+				modules
+			};
+			if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+			return profile;
+		}
+	}
+	if (hasWasmService(client)) {
+		const codeId = await queryWasmContract(client, address);
+		if (codeId !== null) {
+			const profile = {
+				address,
+				account,
+				contract: "wasm",
+				codeId
+			};
+			if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+			return profile;
+		}
+	}
+	const profile = {
+		address,
+		account,
+		contract: "none"
+	};
+	if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl);
+	return profile;
+}
+//#endregion
+export { getAddressProfile as t };
+
+//# sourceMappingURL=address-profile-DlAFvgdg.mjs.map

package/dist/address-profile-DlAFvgdg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-profile-DlAFvgdg.mjs","names":[],"sources":["../src/client/address-profile.ts"],"sourcesContent":["import type { HasClient } from './types'\nimport { isNotFoundError } from '../errors'\nimport type { Any } from '@bufbuild/protobuf/wkt'\nimport { anyUnpack } from '@bufbuild/protobuf/wkt'\nimport {\n  ContractAccountSchema,\n  ShorthandAccountSchema,\n} from '@buf/initia-labs_minievm.bufbuild_es/minievm/evm/v1/auth_pb'\n\n/**\n * On-chain account type derived from auth query's typeUrl.\n * - 'unknown': typeUrl that SDK doesn't explicitly map (e.g., vesting accounts on other Cosmos chains)\n * - Initia uses Move-based vesting, not Cosmos SDK vesting accounts\n */\nexport type AccountKind =\n  | 'base'\n  | 'module'\n  | 'evm-code'\n  | 'evm-shorthand'\n  | 'move-object'\n  | 'move-table'\n  | 'unknown'\n\n/**\n * Functional capability derived from VM queries.\n * Kept as a standalone export for convenience; inline literals used in AddressProfile for narrowing.\n */\nexport type ContractKind = 'none' | 'evm' | 'move' | 'wasm'\n\n/**\n * Discriminated union representing a comprehensive address profile.\n *\n * Two independent axes:\n * - `account`: on-chain truth from auth query (undefined = not yet on-chain)\n * - `contract`: functional capability from VM queries (discriminant)\n *\n * Type-level constraints prevent impossible states:\n * - 'evm-code' always pairs with contract: 'evm'\n * - 'evm-shorthand' pairs with contract: 'evm' or 'none' (transparent resolve of canonical)\n * - Move/Wasm variants exclude EVM-specific account kinds\n */\nexport type AddressProfile =\n  | {\n      address: string\n      account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>\n      contract: 'none'\n    }\n  | {\n      address: string\n      account: 'evm-code'\n      contract: 'evm'\n      /** Byte count of deployed EVM code. 0 means no code. */\n      codeSize: number\n      codeHash: Uint8Array\n    }\n  | {\n      address: string\n      account: 'evm-shorthand'\n      canonical: string\n      contract: 'evm'\n      /** Byte count of deployed EVM code. 0 means no code. */\n      codeSize: number\n      codeHash: Uint8Array\n    }\n  | {\n      address: string\n      account: 'evm-shorthand'\n      canonical: string\n      contract: 'none'\n    }\n  | {\n      address: string\n      account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>\n      contract: 'move'\n      modules: [string, ...string[]]\n    }\n  | {\n      address: string\n      account?: Exclude<AccountKind, 'evm-code' | 'evm-shorthand'>\n      contract: 'wasm'\n      codeId: bigint\n    }\n\n/** Profile where contract is 'evm' (includes both direct and shorthand). */\nexport type EvmProfile = Extract<AddressProfile, { contract: 'evm' }>\n\n/** Profile with account 'evm-shorthand' (contract can be 'evm' or 'none'). */\nexport type ShorthandProfile = Extract<AddressProfile, { account: 'evm-shorthand' }>\n\n/** Profile with contract 'none' excluding shorthand (pure EOA/module/etc). */\nexport type EoaProfile = Exclude<Extract<AddressProfile, { contract: 'none' }>, ShorthandProfile>\n\n/** Profile where contract is 'move'. */\nexport type MoveProfile = Extract<AddressProfile, { contract: 'move' }>\n\n/** Profile where contract is 'wasm'. */\nexport type WasmProfile = Extract<AddressProfile, { contract: 'wasm' }>\n\n/**\n * Options for getAddressProfile.\n */\nexport interface GetAddressProfileOptions {\n  /** Cache TTL in milliseconds. Default 60000. Set to 0 to disable caching. */\n  cacheTtl?: number\n  /** Bypass cache and force fresh queries. */\n  forceRefresh?: boolean\n}\n\n/**\n * Cache interface for AddressProfile results.\n */\nexport interface ProfileCache {\n  get(address: string): AddressProfile | undefined\n  set(address: string, profile: AddressProfile, ttl?: number): void\n  invalidate(address: string): void\n}\n\n// --- Internal implementation ---\n\nconst DEFAULT_CACHE_TTL = 60_000\n\nclass MemoryProfileCache implements ProfileCache {\n  private store = new Map<string, { profile: AddressProfile; expiresAt: number }>()\n\n  get(address: string): AddressProfile | undefined {\n    const entry = this.store.get(address)\n    if (!entry) return undefined\n    if (Date.now() > entry.expiresAt) {\n      this.store.delete(address)\n      return undefined\n    }\n    return entry.profile\n  }\n\n  set(address: string, profile: AddressProfile, ttl: number = DEFAULT_CACHE_TTL): void {\n    this.store.set(address, { profile, expiresAt: Date.now() + ttl })\n  }\n\n  invalidate(address: string): void {\n    this.store.delete(address)\n  }\n}\n\n// --- Internal: typeUrl mapping ---\n\nconst typeUrlToAccountKind: Record<string, AccountKind> = {\n  '/cosmos.auth.v1beta1.BaseAccount': 'base',\n  '/cosmos.auth.v1beta1.ModuleAccount': 'module',\n  '/initia.move.v1.ObjectAccount': 'move-object',\n  '/initia.move.v1.TableAccount': 'move-table',\n  '/minievm.evm.v1.ContractAccount': 'evm-code',\n  '/minievm.evm.v1.ShorthandAccount': 'evm-shorthand',\n}\n\n/** Resolve a proto typeUrl to AccountKind. Returns 'unknown' for unmapped typeUrls. */\nfunction resolveAccountKind(typeUrl: string): AccountKind {\n  return typeUrlToAccountKind[typeUrl] ?? 'unknown'\n}\n\n// --- Internal: client type interfaces ---\n\ninterface AuthQueryClient {\n  auth: { account(req: { address: string }): Promise<{ account?: Any }> }\n}\n\ninterface EvmQueryClient {\n  evm: { code(req: { contractAddr: string }): Promise<{ code: string }> }\n}\n\ninterface MoveQueryClient {\n  move: { modules(req: { address: string }): Promise<{ modules: { moduleName: string }[] }> }\n}\n\ninterface WasmQueryClient {\n  wasm: { contractInfo(req: { address: string }): Promise<{ contractInfo?: { codeId: bigint } }> }\n}\n\n// --- Internal: service detection type guards ---\n\nfunction hasAuthService(client: unknown): client is AuthQueryClient {\n  return client !== null && typeof client === 'object' && 'auth' in client\n}\n\nfunction hasEvmService(client: unknown): client is EvmQueryClient {\n  return client !== null && typeof client === 'object' && 'evm' in client\n}\n\nfunction hasMoveService(client: unknown): client is MoveQueryClient {\n  return client !== null && typeof client === 'object' && 'move' in client\n}\n\nfunction hasWasmService(client: unknown): client is WasmQueryClient {\n  return client !== null && typeof client === 'object' && 'wasm' in client\n}\n\n// --- Internal: auth query result ---\n\ninterface AuthResult {\n  accountKind: AccountKind\n  codeHash?: Uint8Array\n  originalAddress?: string\n}\n\n// --- Internal: query helpers ---\n\n/**\n * Query auth account. Returns null for NOT_FOUND (account doesn't exist on-chain).\n * Throws on network failure.\n */\nasync function queryAuth(client: AuthQueryClient, address: string): Promise<AuthResult | null> {\n  let response: { account?: Any }\n  try {\n    response = await client.auth.account({ address })\n  } catch (err) {\n    if (isNotFoundError(err)) {\n      return null\n    }\n    throw err\n  }\n\n  if (!response.account) {\n    return null\n  }\n\n  const { typeUrl } = response.account\n  const accountKind = resolveAccountKind(typeUrl)\n\n  const result: AuthResult = { accountKind }\n\n  if (accountKind === 'evm-code') {\n    const unpacked = anyUnpack(response.account, ContractAccountSchema)\n    if (unpacked) {\n      result.codeHash = unpacked.codeHash\n    }\n  } else if (accountKind === 'evm-shorthand') {\n    const unpacked = anyUnpack(response.account, ShorthandAccountSchema)\n    if (unpacked) {\n      result.originalAddress = unpacked.originalAddress\n    }\n  }\n\n  return result\n}\n\n/**\n * Query EVM code size. Returns 0 if no code deployed. Throws on network failure.\n * Note: returns byte count of deployed code (Uint8Array.length).\n */\nasync function queryEvmCode(client: EvmQueryClient, address: string): Promise<number> {\n  const response = await client.evm.code({ contractAddr: address })\n  return response.code.length\n}\n\n/** Query Move modules. Returns empty array if no modules. Throws on network failure. */\nasync function queryMoveModules(client: MoveQueryClient, address: string): Promise<string[]> {\n  const response = await client.move.modules({ address })\n  return response.modules.map(m => m.moduleName).filter(Boolean)\n}\n\n/** Query Wasm contract info. Returns codeId or null if not a wasm contract. Throws on network failure. */\nasync function queryWasmContract(client: WasmQueryClient, address: string): Promise<bigint | null> {\n  try {\n    const response = await client.wasm.contractInfo({ address })\n    return response.contractInfo?.codeId ?? null\n  } catch (err) {\n    if (isNotFoundError(err)) {\n      return null\n    }\n    throw err\n  }\n}\n\n// --- Internal: consistency validation ---\n\n/**\n * Validate consistency between auth result and EVM code query.\n * Throws on impossible state combinations.\n */\nfunction validateEvmConsistency(address: string, accountKind: AccountKind, codeSize: number): void {\n  if (accountKind === 'evm-code' && codeSize === 0) {\n    throw new Error(`Inconsistent state for ${address}: ContractAccount but EVM codeSize = 0`)\n  }\n  if (accountKind !== 'evm-code' && accountKind !== 'evm-shorthand' && codeSize > 0) {\n    throw new Error(\n      `Inconsistent state for ${address}: account '${accountKind}' but EVM codeSize > 0`\n    )\n  }\n}\n\n/**\n * Validate that ShorthandAccount has a canonical address.\n * Throws if proto unpacking failed.\n */\nfunction validateShorthandCanonical(\n  address: string,\n  originalAddress: string | undefined\n): asserts originalAddress is string {\n  if (!originalAddress) {\n    throw new Error(`Failed to extract canonical address from ShorthandAccount ${address}`)\n  }\n}\n\n// --- Internal: ShorthandAccount transparent resolve ---\n\n/**\n * Resolve a ShorthandAccount by querying the canonical address.\n * Returns an AddressProfile with account: 'evm-shorthand'.\n *\n * ShorthandAccount only exists on Minievm chains, so only EVM is checked for canonical.\n */\nasync function resolveShorthand(\n  client: unknown,\n  shorthandAddress: string,\n  canonicalAddress: string\n): Promise<AddressProfile> {\n  if (!hasAuthService(client)) {\n    throw new Error('Auth service required for ShorthandAccount resolve')\n  }\n\n  const canonicalAuth = await queryAuth(client, canonicalAddress)\n\n  // Canonical NOT_FOUND: address not yet on-chain\n  if (!canonicalAuth) {\n    return {\n      address: shorthandAddress,\n      account: 'evm-shorthand',\n      canonical: canonicalAddress,\n      contract: 'none',\n    }\n  }\n\n  // Defensive assertion: canonical should never be another ShorthandAccount (20byte→32byte is one-way)\n  if (canonicalAuth.accountKind === 'evm-shorthand') {\n    throw new Error(`Unexpected: canonical address ${canonicalAddress} is also a ShorthandAccount`)\n  }\n\n  // Canonical is ContractAccount: query EVM code for codeSize\n  if (canonicalAuth.accountKind === 'evm-code') {\n    if (!canonicalAuth.codeHash) {\n      throw new Error(`ContractAccount ${canonicalAddress} missing codeHash`)\n    }\n    if (!hasEvmService(client)) {\n      throw new Error('EVM service required for ContractAccount on Minievm chain')\n    }\n    const codeSize = await queryEvmCode(client, canonicalAddress)\n    if (codeSize === 0) {\n      throw new Error(`ContractAccount ${canonicalAddress} has no EVM code (codeSize = 0)`)\n    }\n    return {\n      address: shorthandAddress,\n      account: 'evm-shorthand',\n      canonical: canonicalAddress,\n      contract: 'evm',\n      codeSize,\n      codeHash: canonicalAuth.codeHash,\n    }\n  }\n\n  // Canonical is any other account type (BaseAccount, ModuleAccount, etc): not a contract\n  return {\n    address: shorthandAddress,\n    account: 'evm-shorthand',\n    canonical: canonicalAddress,\n    contract: 'none',\n  }\n}\n\n// --- Module-level cache ---\n\nconst profileCache = new MemoryProfileCache()\n\n// --- Exported API: getAddressProfile ---\n\n/**\n * Get comprehensive address profile by querying auth and VM services.\n * Uses context's address when available.\n */\nexport async function getAddressProfile(\n  context: { readonly client: unknown; readonly address: string },\n  options?: GetAddressProfileOptions\n): Promise<AddressProfile>\n/**\n * Get comprehensive address profile by querying auth and VM services.\n * Address is provided as a separate parameter.\n */\nexport async function getAddressProfile(\n  context: HasClient,\n  address: string,\n  options?: GetAddressProfileOptions\n): Promise<AddressProfile>\nexport async function getAddressProfile(\n  context: HasClient,\n  addressOrOptions?: string | GetAddressProfileOptions,\n  maybeOptions?: GetAddressProfileOptions\n): Promise<AddressProfile> {\n  let address: string\n  let options: GetAddressProfileOptions | undefined\n\n  if (typeof addressOrOptions === 'string') {\n    address = addressOrOptions\n    options = maybeOptions\n  } else {\n    const ctx = context as { address?: string }\n    if (!ctx.address) {\n      throw new Error('Context has no address. Pass address as second argument.')\n    }\n    address = ctx.address\n    options = addressOrOptions\n  }\n\n  const cacheTtl = options?.cacheTtl ?? DEFAULT_CACHE_TTL\n\n  // Cache check\n  if (!options?.forceRefresh && cacheTtl > 0) {\n    const cached = profileCache.get(address)\n    if (cached) return cached\n  }\n\n  const { client } = context\n\n  // Auth query (always first)\n  if (!hasAuthService(client)) {\n    throw new Error('Auth service is required for getAddressProfile')\n  }\n\n  const authResult = await queryAuth(client, address)\n\n  // NOT_FOUND: account doesn't exist on-chain\n  if (!authResult) {\n    const profile: AddressProfile = { address, contract: 'none' }\n    if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n    return profile\n  }\n\n  const { accountKind, codeHash, originalAddress } = authResult\n\n  // ShorthandAccount: transparent resolve\n  if (accountKind === 'evm-shorthand') {\n    validateShorthandCanonical(address, originalAddress)\n    const profile = await resolveShorthand(client, address, originalAddress)\n    if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n    return profile\n  }\n\n  // ContractAccount: must query EVM for codeSize\n  if (accountKind === 'evm-code') {\n    if (!codeHash) {\n      throw new Error(`ContractAccount ${address} missing codeHash`)\n    }\n    if (!hasEvmService(client)) {\n      throw new Error('EVM service required for ContractAccount')\n    }\n    const codeSize = await queryEvmCode(client, address)\n    validateEvmConsistency(address, accountKind, codeSize)\n    const profile: AddressProfile = {\n      address,\n      account: 'evm-code',\n      contract: 'evm',\n      codeSize,\n      codeHash,\n    }\n    if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n    return profile\n  }\n\n  // Remaining account types: base, module, move-object, move-table, unknown\n  const account = accountKind\n\n  // EVM consistency check: proactively query EVM code for non-EVM accounts\n  // to detect impossible states (e.g., BaseAccount with deployed EVM code).\n  // Adds one extra network call on EVM-enabled chains, but ensures fail-fast\n  // on data inconsistency rather than silently returning a wrong profile.\n  if (hasEvmService(client)) {\n    const codeSize = await queryEvmCode(client, address)\n    validateEvmConsistency(address, accountKind, codeSize)\n  }\n\n  // Move check\n  if (hasMoveService(client)) {\n    const modules = await queryMoveModules(client, address)\n    if (modules.length > 0) {\n      const profile: AddressProfile = {\n        address,\n        account,\n        contract: 'move',\n        modules: modules as [string, ...string[]],\n      }\n      if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n      return profile\n    }\n  }\n\n  // Wasm check\n  if (hasWasmService(client)) {\n    const codeId = await queryWasmContract(client, address)\n    if (codeId !== null) {\n      const profile: AddressProfile = {\n        address,\n        account,\n        contract: 'wasm',\n        codeId,\n      }\n      if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n      return profile\n    }\n  }\n\n  // No VM contract found\n  const profile: AddressProfile = { address, account, contract: 'none' }\n  if (cacheTtl > 0) profileCache.set(address, profile, cacheTtl)\n  return profile\n}\n"],"mappings":"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"}