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

package/dist/entry.evm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.evm.mjs","names":["decodeFunctionResult","encodeFunctionData","Message","decodeErrorResult","encodeFunctionData","viemEncodeAbiParameters","decodeEventLog","encodeEventTopics"],"sources":["../src/tx/evm.ts","../src/contracts/evm/contract.ts","../src/contracts/evm/abi.ts","../src/contracts/evm/events.ts"],"sourcesContent":["/**\n * EVM Transaction utilities.\n *\n * Provides functions for building, signing, and sending EVM transactions\n * using the SDK's existing cryptographic primitives and EvmRpcClient.\n *\n * Bundle-optimized: uses viem only for `serializeTransaction` (EIP-1559 serialization),\n * avoids viem's WalletClient/PublicClient/privateKeyToAccount to prevent\n * double-bundling of secp256k1 and pulling in unused action modules.\n */\n\nimport { serializeTransaction, type TransactionSerializableEIP1559 } from 'viem'\nimport { secp256k1 } from '@noble/curves/secp256k1.js'\nimport { hexToBytes, bytesToHex } from '@noble/hashes/utils.js'\nimport { keccak256 } from '../util/hash'\nimport { EvmRpcClient } from '../client/evm-rpc'\nimport type { EvmTxSigner } from '../signer/types'\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface SendEvmTxOptions {\n  /** EvmRpcClient instance or RPC URL string (creates a client internally) */\n  rpc: EvmRpcClient | string\n  /** EVM tx signer (RawKey, MnemonicKey, or any EvmTxSigner) */\n  signer?: EvmTxSigner\n  /** Private key as 0x-prefixed hex (alternative to signer) */\n  privateKey?: `0x${string}`\n  /** Target contract/recipient address */\n  to: `0x${string}`\n  /** ABI-encoded calldata (0x-prefixed) */\n  data: `0x${string}`\n  /** Native token value in wei */\n  value?: bigint\n  /** Gas limit override (auto-estimated if omitted) */\n  gasLimit?: bigint\n  /** Max fee per gas override (auto-calculated if omitted) */\n  maxFeePerGas?: bigint\n  /** Max priority fee per gas override (defaults to gasPrice / 10) */\n  maxPriorityFeePerGas?: bigint\n}\n\nexport interface EvmTxResult {\n  txHash: string\n  status: 'success' | 'reverted'\n  blockNumber: bigint\n  gasUsed: bigint\n}\n\n// =============================================================================\n// Internal helpers\n// =============================================================================\n\n/**\n * Derive EVM address from an uncompressed secp256k1 public key.\n * address = keccak256(pubkey[1:])[12:32]\n */\nfunction publicKeyToEvmAddress(uncompressedPubKey: Uint8Array): `0x${string}` {\n  // Strip the 0x04 prefix byte (uncompressed point marker)\n  const pubKeyBody = uncompressedPubKey.slice(1)\n  const hash = keccak256(pubKeyBody)\n  return `0x${bytesToHex(hash.slice(12))}`\n}\n\nfunction resolveRpc(rpc: EvmRpcClient | string): EvmRpcClient {\n  return typeof rpc === 'string' ? new EvmRpcClient(rpc) : rpc\n}\n\n// =============================================================================\n// Public API\n// =============================================================================\n\n/**\n * Send a raw EVM transaction and return the transaction hash.\n *\n * Handles nonce retrieval, gas estimation, EIP-1559 serialization, and signing\n * via the provided EvmTxSigner or raw private key.\n *\n * @example Using signer (preferred)\n * ```typescript\n * const key = new MnemonicKey({ mnemonic: '...' })\n * const txHash = await sendEvmTx({\n *   rpc: 'https://1rpc.io/sepolia',\n *   signer: key,\n *   to: '0x...',\n *   data: '0x...',\n *   value: 1000000000000000n, // 0.001 ETH\n * })\n * ```\n *\n * @example Using privateKey (legacy)\n * ```typescript\n * const txHash = await sendEvmTx({\n *   rpc: 'https://1rpc.io/sepolia',\n *   privateKey: key.getPrivateKeyHex(),\n *   to: '0x...',\n *   data: '0x...',\n * })\n * ```\n */\nexport async function sendEvmTx(options: SendEvmTxOptions): Promise<string> {\n  const rpc = resolveRpc(options.rpc)\n\n  let from: `0x${string}`\n  let signHash: (\n    hash: Uint8Array\n  ) => Promise<{ r: `0x${string}`; s: `0x${string}`; yParity: 0 | 1 }>\n\n  if (options.signer && options.privateKey) {\n    throw new Error('Cannot specify both signer and privateKey. Use one or the other.')\n  }\n\n  if (options.signer) {\n    // Signer-based path\n    const signer = options.signer\n    if (!/^0x[0-9a-fA-F]{40}$/.test(signer.evmAddress)) {\n      throw new Error(\n        `Invalid EVM address from signer: \"${signer.evmAddress}\". ` +\n          'Expected 0x-prefixed 40-character hex string.'\n      )\n    }\n    from = signer.evmAddress\n    signHash = async (hash: Uint8Array) => {\n      const sig = await signer.signEvmHash(hash)\n      return {\n        r: `0x${bytesToHex(sig.r)}`,\n        s: `0x${bytesToHex(sig.s)}`,\n        yParity: sig.yParity,\n      }\n    }\n  } else if (options.privateKey) {\n    // Legacy private key path\n    const privateKeyBytes = hexToBytes(options.privateKey.slice(2))\n    const publicKey = secp256k1.getPublicKey(privateKeyBytes, false)\n    from = publicKeyToEvmAddress(publicKey)\n    signHash = (hash: Uint8Array) => {\n      const sigBytes = secp256k1.sign(hash, privateKeyBytes, {\n        prehash: false,\n        format: 'recovered',\n      })\n      return Promise.resolve({\n        r: `0x${bytesToHex(sigBytes.slice(1, 33))}`,\n        s: `0x${bytesToHex(sigBytes.slice(33, 65))}`,\n        yParity: sigBytes[0] as 0 | 1,\n      })\n    }\n  } else {\n    throw new Error('Either signer or privateKey must be provided')\n  }\n\n  // 1. Fetch nonce, chainId, gasPrice in parallel\n  const [nonce, chainId, gasPrice] = await Promise.all([\n    rpc.getTransactionCount(from),\n    rpc.getChainId(),\n    rpc.getGasPrice(),\n  ])\n\n  // 2. Estimate gas (or use override)\n  const gas =\n    options.gasLimit ??\n    (await rpc.estimateGas({\n      from,\n      to: options.to,\n      data: options.data,\n      value: options.value ? `0x${options.value.toString(16)}` : undefined,\n    }))\n\n  // 3. Build EIP-1559 transaction parameters\n  const maxFeePerGas = options.maxFeePerGas ?? gasPrice * 2n\n  const maxPriorityFeePerGas = options.maxPriorityFeePerGas ?? gasPrice / 10n\n\n  const txParams: TransactionSerializableEIP1559 = {\n    type: 'eip1559',\n    chainId: Number(chainId),\n    nonce: Number(nonce),\n    to: options.to,\n    data: options.data,\n    value: options.value ?? 0n,\n    maxFeePerGas,\n    maxPriorityFeePerGas,\n    gas,\n  }\n\n  // 4. Serialize unsigned transaction\n  const serialized = serializeTransaction(txParams)\n\n  // 5. Sign: keccak256(serialized) → ECDSA signature\n  const txHash = keccak256(hexToBytes(serialized.slice(2)))\n  const { r, s, yParity } = await signHash(txHash)\n\n  // 6. Serialize signed transaction\n  const signedTx = serializeTransaction(txParams, { r, s, yParity })\n\n  // 7. Send via JSON-RPC\n  return rpc.sendRawTransaction(signedTx)\n}\n\n/**\n * Send an EVM transaction and wait for the receipt.\n *\n * Polls `eth_getTransactionReceipt` until the transaction is confirmed\n * or the timeout is reached.\n *\n * @example\n * ```typescript\n * const result = await sendEvmTxAndWait({\n *   rpc: 'https://1rpc.io/sepolia',\n *   signer: key,\n *   to: '0x...',\n *   data: '0x...',\n * })\n * console.log(result.status) // 'success' or 'reverted'\n * ```\n */\nexport async function sendEvmTxAndWait(\n  options: SendEvmTxOptions,\n  pollIntervalMs = 2000,\n  timeoutMs = 120_000\n): Promise<EvmTxResult> {\n  const txHash = await sendEvmTx(options)\n  const rpc = resolveRpc(options.rpc)\n\n  const deadline = Date.now() + timeoutMs\n  while (Date.now() < deadline) {\n    const receipt = await rpc.getTransactionReceipt(txHash)\n    if (receipt) {\n      return {\n        txHash,\n        status: receipt.status === '0x1' ? 'success' : 'reverted',\n        blockNumber: BigInt(receipt.blockNumber),\n        gasUsed: BigInt(receipt.gasUsed),\n      }\n    }\n    await new Promise(r => setTimeout(r, pollIntervalMs))\n  }\n  throw new Error(`Timeout waiting for EVM tx receipt: ${txHash}`)\n}\n","/**\n * EVM Contract Factory and Helpers\n *\n * Provides type-safe contract interactions via gRPC or JSON-RPC.\n */\n\nimport type { Abi } from 'abitype'\nimport type { Client } from '@connectrpc/connect'\nimport { create } from '@bufbuild/protobuf'\nimport { encodeFunctionData, decodeFunctionResult, decodeErrorResult, encodeDeployData } from 'viem'\n\nimport type { Query as EvmQuery } from '@buf/initia-labs_minievm.bufbuild_es/minievm/evm/v1/query_pb'\nimport {\n  MsgCallSchema,\n  type MsgCall,\n} from '@buf/initia-labs_minievm.bufbuild_es/minievm/evm/v1/tx_pb'\n\nimport { Message } from '../../msgs/types'\nimport type { HasEvmService } from '../../client/types'\nimport type { EvmRpcClient } from '../../client/evm-rpc'\nimport type { TokenInfo } from '../types'\nimport { parseUnits, formatUnits } from '../utils'\nimport { ContractError } from '../errors'\nimport { AccAddress, isValidEvmAddress, tryDecodeBech32 } from '../../util/address'\nimport { sendEvmTx } from '../../tx/evm'\nimport type {\n  EvmContract,\n  EvmContractJsonRpc,\n  EvmContractJsonRpcOptions,\n  ReadFunctions,\n  WriteFunctions,\n  JsonRpcWriteFunctions,\n  WriteOptions,\n  EstimateGasFunctions,\n  JsonRpcEstimateGasFunctions,\n  DeployEvmContractOptions,\n} from './types'\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * EVM gRPC query client type.\n */\nexport type EvmQueryClient = Client<typeof EvmQuery>\n\n// Zero address in bech32 format for gRPC query sender\nconst ZERO_ADDRESS_BECH32 = 'init1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqa4qvvl'\n// Zero address in hex for JSON-RPC from field\nconst ZERO_ADDRESS_HEX: `0x${string}` = '0x0000000000000000000000000000000000000000'\n\n// =============================================================================\n// Address Validation\n// =============================================================================\n\n/**\n * Validates that an address is in a valid format (EVM hex or bech32).\n * @throws Error if address format is invalid\n */\nfunction validateContractAddress(address: string): void {\n  // Check EVM format (0x...)\n  if (address.startsWith('0x')) {\n    if (!isValidEvmAddress(address)) {\n      throw new Error(\n        `Invalid EVM address format: ${address}. ` + `Expected 0x followed by 40 hex characters.`\n      )\n    }\n    return\n  }\n\n  // Check bech32 format\n  if (!tryDecodeBech32(address)) {\n    throw new Error(\n      `Invalid contract address: ${address}. ` + `Expected EVM hex (0x...) or bech32 format.`\n    )\n  }\n}\n\n// =============================================================================\n// Bech32 → Hex Address Conversion\n// =============================================================================\n\n/** ABI parameter with optional components (for tuple types) */\ninterface AbiParam {\n  type: string\n  name?: string\n  components?: readonly AbiParam[]\n}\n\n/**\n * Converts a bech32 string to hex if it's not already hex.\n * Returns the value unchanged if conversion fails or unnecessary.\n */\nfunction maybeToHex(val: unknown): unknown {\n  if (typeof val === 'string' && !val.startsWith('0x')) {\n    try {\n      return AccAddress.toHex(val)\n    } catch {\n      // Not a valid bech32, pass through\n    }\n  }\n  return val\n}\n\n/**\n * Recursively converts bech32 addresses to hex based on ABI parameter type.\n * Handles address, address[], tuple (with components), and tuple[].\n */\nfunction convertEvmArg(arg: unknown, param: AbiParam): unknown {\n  const { type } = param\n\n  if (type === 'address') {\n    return maybeToHex(arg)\n  }\n\n  if (type === 'address[]' && Array.isArray(arg)) {\n    return arg.map(el => maybeToHex(el))\n  }\n\n  if (type === 'tuple' && param.components && arg && typeof arg === 'object') {\n    const obj = { ...(arg as Record<string, unknown>) }\n    for (const comp of param.components) {\n      if (comp.name && comp.name in obj) {\n        obj[comp.name] = convertEvmArg(obj[comp.name], comp)\n      }\n    }\n    return obj\n  }\n\n  if (type === 'tuple[]' && param.components && Array.isArray(arg)) {\n    const tupleParam: AbiParam = { ...param, type: 'tuple' }\n    return arg.map(el => convertEvmArg(el, tupleParam))\n  }\n\n  return arg\n}\n\n/**\n * Converts bech32 addresses in function args to hex, guided by ABI types.\n */\nexport function convertEvmArgs(contractAbi: Abi, functionName: string, args: unknown[]): unknown[] {\n  const fn = contractAbi.find(item => item.type === 'function' && item.name === functionName)\n  if (!fn || fn.type !== 'function') return args\n\n  return args.map((arg, i) => {\n    const input = fn.inputs[i]\n    if (!input) return arg\n    return convertEvmArg(arg, input as AbiParam)\n  })\n}\n\n// =============================================================================\n// Contract Factory\n// =============================================================================\n\n/**\n * Creates a type-safe EVM contract instance.\n *\n * @param context - ChainContext with client (must have evm service)\n * @param address - Contract address (0x hex or bech32)\n * @param abi - Contract ABI\n * @param options - Transport options (omit or `{ transport: 'jsonrpc' }`)\n * @returns Type-safe contract instance\n *\n * @example\n * ```typescript\n * import { createEvmContract } from 'initia.js'\n *\n * // gRPC (default)\n * const erc20 = createEvmContract(ctx, address, erc20Abi)\n * const msg = erc20.write.transfer(sender, to, amount)\n * await ctx.signAndBroadcast([msg])\n *\n * // JSON-RPC\n * const erc20 = createEvmContract(ctx, address, erc20Abi, { transport: 'jsonrpc' })\n * const txHash = await erc20.write.transfer(to, amount)\n * ```\n */\nexport function createEvmContract<const TAbi extends Abi>(\n  context: HasEvmService & { evmTransport: 'jsonrpc' },\n  address: string,\n  abi: TAbi\n): EvmContractJsonRpc<TAbi>\nexport function createEvmContract<const TAbi extends Abi>(\n  context: HasEvmService,\n  address: string,\n  abi: TAbi,\n  options: EvmContractJsonRpcOptions\n): EvmContractJsonRpc<TAbi>\nexport function createEvmContract<const TAbi extends Abi>(\n  context: HasEvmService,\n  address: string,\n  abi: TAbi\n): EvmContract<TAbi>\nexport function createEvmContract<const TAbi extends Abi>(\n  context: HasEvmService,\n  address: string,\n  abi: TAbi,\n  options?: EvmContractJsonRpcOptions\n): EvmContract<TAbi> | EvmContractJsonRpc<TAbi> {\n  validateContractAddress(address)\n\n  // Per-contract options take priority, then check context-level preference\n  const contextTransport = (context as unknown as Record<string, unknown>).evmTransport\n  if (options?.transport === 'jsonrpc' || contextTransport === 'jsonrpc') {\n    return createEvmContractJsonRpc(context, address, abi, options ?? { transport: 'jsonrpc' })\n  }\n\n  return createEvmContractGrpc(context, address, abi)\n}\n\n// =============================================================================\n// Shared Helpers\n// =============================================================================\n\n/**\n * Extract WriteOptions from the end of args if present.\n * Compares args count against the ABI-declared input count to detect the trailing options object.\n */\nfunction extractWriteOptions(\n  abi: Abi,\n  functionName: string,\n  args: unknown[]\n): { fnArgs: unknown[]; value: string } {\n  const abiItem = abi.find(item => item.type === 'function' && item.name === functionName)\n  const expectedArgCount = abiItem && abiItem.type === 'function' ? abiItem.inputs.length : 0\n\n  if (args.length > expectedArgCount) {\n    const lastArg = args[args.length - 1]\n    if (lastArg && typeof lastArg === 'object' && 'value' in lastArg) {\n      const opts = lastArg as WriteOptions\n      return {\n        fnArgs: args.slice(0, -1),\n        value: opts.value !== undefined ? opts.value.toString() : '0',\n      }\n    }\n  }\n\n  return { fnArgs: args, value: '0' }\n}\n\n/**\n * Ensure a hex string has a 0x prefix.\n */\nfunction ensureHexPrefix(hex: string): `0x${string}` {\n  return hex.startsWith('0x') ? (hex as `0x${string}`) : `0x${hex}`\n}\n\n/**\n * Build shared token utility methods (parseUnits, formatUnits, getTokenInfo).\n */\nfunction buildTokenUtils<TAbi extends Abi>(read: ReadFunctions<TAbi>) {\n  let cachedDecimals: number | undefined\n\n  async function getDecimals(): Promise<number> {\n    if (cachedDecimals !== undefined) {\n      return cachedDecimals\n    }\n    const erc20 = read as unknown as { decimals(): Promise<number> }\n    cachedDecimals = await erc20.decimals()\n    return cachedDecimals\n  }\n\n  return {\n    async parseUnits(value: string): Promise<bigint> {\n      const decimals = await getDecimals()\n      return parseUnits(value, decimals)\n    },\n\n    async formatUnits(value: bigint): Promise<string> {\n      const decimals = await getDecimals()\n      return formatUnits(value, decimals)\n    },\n\n    async getTokenInfo(): Promise<TokenInfo> {\n      const erc20 = read as unknown as {\n        name(): Promise<string>\n        symbol(): Promise<string>\n        decimals(): Promise<number>\n        totalSupply(): Promise<bigint>\n      }\n\n      const [name, symbol, decimals, totalSupply] = await Promise.all([\n        erc20.name(),\n        erc20.symbol(),\n        erc20.decimals(),\n        erc20.totalSupply().catch((): bigint | undefined => undefined),\n      ])\n\n      cachedDecimals = decimals\n\n      return { name, symbol, decimals, totalSupply }\n    },\n  }\n}\n\n/**\n * Convert contract address to 0x hex format for JSON-RPC.\n * If already 0x-prefixed, returns as-is. If bech32, converts to hex.\n */\nfunction toHexAddress(address: string): `0x${string}` {\n  if (address.startsWith('0x')) return address as `0x${string}`\n  return AccAddress.toHex(address) as `0x${string}`\n}\n\n// =============================================================================\n// gRPC Contract Factory (existing behavior)\n// =============================================================================\n\nfunction createEvmContractGrpc<TAbi extends Abi>(\n  context: HasEvmService,\n  address: string,\n  abi: TAbi\n): EvmContract<TAbi> {\n  const evmClient = context.client.evm\n\n  async function callContract(input: string): Promise<string> {\n    const response = await evmClient.call({\n      sender: ZERO_ADDRESS_BECH32,\n      contractAddr: address,\n      input,\n      value: '0',\n      accessList: [],\n    })\n\n    if (response.error) {\n      throw new ContractError('evm', 0, response.error)\n    }\n\n    return response.response\n  }\n\n  const read = new Proxy({} as ReadFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return async (...args: unknown[]) => {\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, args),\n        })\n\n        const responseHex = await callContract(input)\n        const data = ensureHexPrefix(responseHex)\n\n        return decodeFunctionResult({\n          abi: abi as Abi,\n          functionName,\n          data,\n        })\n      }\n    },\n  })\n\n  const write = new Proxy({} as WriteFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return (sender: string, ...args: unknown[]): Message<typeof MsgCallSchema> => {\n        const { fnArgs, value } = extractWriteOptions(abi as Abi, functionName, args)\n\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, fnArgs),\n        })\n\n        return new Message(MsgCallSchema, {\n          sender,\n          contractAddr: address,\n          input,\n          value,\n          accessList: [],\n        })\n      }\n    },\n  })\n\n  const estimateGas = new Proxy({} as EstimateGasFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return async (sender: string, ...args: unknown[]): Promise<bigint> => {\n        const { fnArgs, value } = extractWriteOptions(abi as Abi, functionName, args)\n\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, fnArgs),\n        })\n\n        const response = await evmClient.call({\n          sender,\n          contractAddr: address,\n          input,\n          value,\n          accessList: [],\n        })\n\n        if (response.error) {\n          throw new ContractError('evm', 0, response.error)\n        }\n\n        return response.usedGas\n      }\n    },\n  })\n\n  return {\n    address,\n    abi,\n    read,\n    write,\n    estimateGas,\n    ...buildTokenUtils(read),\n  }\n}\n\n// =============================================================================\n// JSON-RPC Contract Factory\n// =============================================================================\n\n/**\n * Resolve EvmRpcClient from context at runtime.\n * ChainContext<'minievm'> provides `evmRpc` via getter.\n */\nfunction resolveEvmRpc(context: HasEvmService): EvmRpcClient {\n  const rpc = (context as unknown as Record<string, unknown>).evmRpc\n  if (!rpc) {\n    throw new Error(\n      'JSON-RPC transport requires evmRpc on context.\\n' +\n        \"Use a ChainContext<'minievm'> which provides evmRpc, or pass a context with evmRpc.\"\n    )\n  }\n  return rpc as EvmRpcClient\n}\n\n/**\n * Resolve private key from options or context.signer at runtime.\n */\nfunction resolvePrivateKey(\n  context: HasEvmService,\n  options: EvmContractJsonRpcOptions\n): `0x${string}` {\n  if (options.privateKey) return options.privateKey\n\n  const signer = (context as unknown as Record<string, unknown>).signer\n  if (signer && typeof signer === 'object' && 'getPrivateKeyHex' in signer) {\n    return (signer as { getPrivateKeyHex(): `0x${string}` }).getPrivateKeyHex()\n  }\n\n  throw new Error(\n    'Private key required for JSON-RPC write.\\n' +\n      'Provide privateKey in options or use a context with a Key signer.'\n  )\n}\n\nfunction createEvmContractJsonRpc<TAbi extends Abi>(\n  context: HasEvmService,\n  address: string,\n  abi: TAbi,\n  options: EvmContractJsonRpcOptions\n): EvmContractJsonRpc<TAbi> {\n  const rpc = resolveEvmRpc(context)\n  const hexAddress = toHexAddress(address)\n\n  // Read proxy: eth_call via JSON-RPC\n  const read = new Proxy({} as ReadFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return async (...args: unknown[]) => {\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, args),\n        })\n\n        const responseHex = await rpc.ethCall({ to: hexAddress, data: input })\n        const data = ensureHexPrefix(responseHex)\n\n        return decodeFunctionResult({\n          abi: abi as Abi,\n          functionName,\n          data,\n        })\n      }\n    },\n  })\n\n  // EstimateGas proxy: eth_estimateGas via JSON-RPC (no sender arg)\n  const estimateGas = new Proxy({} as JsonRpcEstimateGasFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return async (...args: unknown[]): Promise<bigint> => {\n        const { fnArgs, value } = extractWriteOptions(abi as Abi, functionName, args)\n\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, fnArgs),\n        })\n\n        // Use privateKey-derived address if available, otherwise zero address\n        let from: `0x${string}` = ZERO_ADDRESS_HEX\n        try {\n          const pk = resolvePrivateKey(context, options)\n          // Derive address from private key using the same approach as sendEvmTx\n          const { secp256k1 } = await import('@noble/curves/secp256k1.js')\n          const { hexToBytes, bytesToHex } = await import('@noble/hashes/utils.js')\n          const { keccak256 } = await import('../../util/hash')\n          const pubKey = secp256k1.getPublicKey(hexToBytes(pk.slice(2)), false)\n          const hash = keccak256(pubKey.slice(1))\n          from = `0x${bytesToHex(hash.slice(12))}`\n        } catch {\n          // No private key available, use zero address\n        }\n\n        return rpc.estimateGas({\n          from,\n          to: hexAddress,\n          data: input,\n          value: value !== '0' ? `0x${BigInt(value).toString(16)}` : undefined,\n        })\n      }\n    },\n  })\n\n  // Write proxy: sendEvmTx via JSON-RPC (no sender arg, returns tx hash)\n  const write = new Proxy({} as JsonRpcWriteFunctions<TAbi>, {\n    get(_, functionName: string) {\n      return async (...args: unknown[]): Promise<string> => {\n        const { fnArgs, value } = extractWriteOptions(abi as Abi, functionName, args)\n        const privateKey = resolvePrivateKey(context, options)\n\n        const input = encodeFunctionData({\n          abi: abi as Abi,\n          functionName,\n          args: convertEvmArgs(abi as Abi, functionName, fnArgs),\n        })\n\n        return sendEvmTx({\n          rpc,\n          privateKey,\n          to: hexAddress,\n          data: input,\n          value: value !== '0' ? BigInt(value) : undefined,\n        })\n      }\n    },\n  })\n\n  return {\n    address,\n    abi,\n    read,\n    write,\n    estimateGas,\n    ...buildTokenUtils(read),\n  }\n}\n\n// =============================================================================\n// Deployment Helper\n// =============================================================================\n\n/**\n * Deploys an EVM contract.\n *\n * Note: This creates a MsgCreate message. Use with signAndBroadcast().\n *\n * @param sender - Deployer address\n * @param options - Deployment options (abi, bytecode, args, value)\n * @returns MsgCreate message for signing\n *\n * @example\n * ```typescript\n * const deployMsg = createDeployEvmContractMsg(ctx.address, {\n *   abi: myContractAbi,\n *   bytecode: '0x6080...',\n *   args: [arg1, arg2],\n * })\n *\n * const result = await ctx.signAndBroadcast([deployMsg])\n * ```\n */\nexport function createDeployEvmContractMsg<const TAbi extends Abi>(\n  sender: string,\n  options: DeployEvmContractOptions<TAbi>\n): MsgCall {\n  const { abi, bytecode, args, value } = options\n\n  const hexBytecode: `0x${string}` = bytecode.startsWith('0x')\n    ? (bytecode as `0x${string}`)\n    : `0x${bytecode}`\n\n  // Convert bech32 addresses in constructor args\n  const constructor = (abi as Abi).find(item => item.type === 'constructor')\n  let convertedArgs = args as unknown[] | undefined\n  if (convertedArgs && constructor && constructor.type === 'constructor') {\n    convertedArgs = convertedArgs.map((arg, i) => {\n      const input = constructor.inputs[i]\n      if (!input) return arg\n      return convertEvmArg(arg, input as AbiParam)\n    })\n  }\n\n  // encodeDeployData: bytecode + ABI-encoded constructor args\n  const code = encodeDeployData({\n    abi: abi as Abi,\n    bytecode: hexBytecode,\n    args: convertedArgs,\n  } as Parameters<typeof encodeDeployData>[0])\n\n  // Use MsgCreate for deployment (empty contract address)\n  return create(MsgCallSchema, {\n    sender,\n    contractAddr: '', // Empty for create\n    input: code.slice(2), // Strip 0x prefix\n    value: value?.toString() ?? '0',\n    accessList: [],\n  })\n}\n\n// =============================================================================\n// Error Decoding\n// =============================================================================\n\n/**\n * Decodes an EVM revert reason from error data.\n *\n * @param data - Hex encoded error data\n * @param abi - Optional contract ABI for custom error decoding\n * @returns Decoded error reason\n *\n * @example\n * ```typescript\n * try {\n *   await contract.read.transfer(to, amount)\n * } catch (e) {\n *   if (e instanceof ContractError && e.data) {\n *     const reason = decodeRevertReason(e.data, contract.abi)\n *     console.log('Revert reason:', reason)\n *   }\n * }\n * ```\n */\nexport function decodeRevertReason(data: string, abi?: Abi): string {\n  const hexData = data.startsWith('0x') ? data : `0x${data}`\n\n  try {\n    // Try decoding as custom error if ABI provided\n    if (abi) {\n      const decoded = decodeErrorResult({\n        abi,\n        data: hexData as `0x${string}`,\n      })\n      return `${decoded.errorName}(${decoded.args?.join(', ') ?? ''})`\n    }\n  } catch {\n    // Fall through to standard error decoding\n  }\n\n  // Standard Error(string) - selector 0x08c379a0\n  if (hexData.startsWith('0x08c379a0')) {\n    try {\n      const errorAbi = [\n        {\n          type: 'error',\n          name: 'Error',\n          inputs: [{ type: 'string', name: 'message' }],\n        },\n      ] as const\n\n      const decoded = decodeErrorResult({\n        abi: errorAbi,\n        data: hexData as `0x${string}`,\n      })\n      return String(decoded.args?.[0])\n    } catch {\n      // Fall through\n    }\n  }\n\n  // Panic(uint256) - selector 0x4e487b71\n  if (hexData.startsWith('0x4e487b71')) {\n    try {\n      const panicAbi = [\n        {\n          type: 'error',\n          name: 'Panic',\n          inputs: [{ type: 'uint256', name: 'code' }],\n        },\n      ] as const\n\n      const decoded = decodeErrorResult({\n        abi: panicAbi,\n        data: hexData as `0x${string}`,\n      })\n      const panicCode = decoded.args?.[0]\n      return `Panic(${panicCode}): ${getPanicReason(panicCode)}`\n    } catch {\n      // Fall through\n    }\n  }\n\n  return `Unknown error: ${hexData}`\n}\n\n/**\n * Gets human-readable panic reason.\n */\nfunction getPanicReason(code: bigint): string {\n  const reasons: Record<string, string> = {\n    '0': 'Generic compiler panic',\n    '1': 'Assert failed',\n    '17': 'Arithmetic overflow/underflow',\n    '18': 'Division by zero',\n    '33': 'Invalid enum value',\n    '34': 'Invalid storage access',\n    '49': 'Pop on empty array',\n    '50': 'Array index out of bounds',\n    '65': 'Out of memory',\n    '81': 'Call to zero-initialized function',\n  }\n  return reasons[code.toString()] ?? 'Unknown panic code'\n}\n","/**\n * EVM ABI Encoding/Decoding Utilities\n *\n * Standalone utilities for ABI operations without creating contract instances.\n * Re-exports viem functions for consistent API.\n */\n\nimport { parseAbi, encodeFunctionData, encodeAbiParameters as viemEncodeAbiParameters } from 'viem'\nimport type { Abi } from 'abitype'\nimport { convertEvmArgs } from './contract'\n\n// Function encoding/decoding\nexport { encodeFunctionData, decodeFunctionResult, encodeFunctionResult } from 'viem'\n\n// Event encoding/decoding\n// Note: parseEventLogs returns addresses in EIP-55 checksum format (mixed-case),\n// not lowercase as returned by on-chain RPC. Use .toLowerCase() when comparing\n// with raw on-chain addresses.\nexport { encodeEventTopics, decodeEventLog, parseEventLogs } from 'viem'\n\n// Error encoding/decoding\nexport { encodeErrorResult, decodeErrorResult } from 'viem'\n\n// ABI encoding/decoding (low-level)\nexport { encodeAbiParameters, decodeAbiParameters } from 'viem'\n\n// Type re-exports for convenience\nexport type { Abi, AbiFunction, AbiEvent, AbiError, AbiParameter } from 'abitype'\n\n/**\n * Encodes an EVM function call from a human-readable signature string.\n * Accepts bech32 addresses in args — automatically converts to hex for address params.\n *\n * @param signature - Human-readable function signature (e.g., \"function transfer(address to, uint256 amount)\")\n * @param args - Function arguments (bech32 addresses accepted for address params)\n * @returns ABI-encoded calldata with function selector\n *\n * @example\n * ```typescript\n * // With 'function' keyword\n * const calldata = encodeEvmCall(\n *   'function transfer(address to, uint256 amount)',\n *   ['init1qwer...', 100n]\n * )\n *\n * // Without 'function' keyword (also accepted)\n * const calldata = encodeEvmCall(\n *   'transfer(address,uint256)',\n *   ['init1qwer...', 100n]\n * )\n *\n * const msg = createExecuteMsg(sender, contractAddr, calldata)\n * ```\n */\nexport function encodeEvmCall(signature: string, args: unknown[]): `0x${string}` {\n  const fragment = signature.startsWith('function ') ? signature : `function ${signature}`\n\n  const abi = parseAbi([fragment]) as Abi\n  const fn = abi[0]\n  if (!fn || fn.type !== 'function') {\n    throw new Error(`Invalid function signature: ${signature}`)\n  }\n\n  const convertedArgs = convertEvmArgs(abi, fn.name, args)\n\n  return encodeFunctionData({\n    abi,\n    functionName: fn.name,\n    args: convertedArgs,\n  })\n}\n\n/**\n * Encodes ABI parameters from type strings with bech32 address auto-conversion.\n *\n * @param types - Parameter type strings (e.g., [\"address\", \"uint256\"])\n * @param values - Parameter values (bech32 addresses accepted for address params)\n * @returns ABI-encoded parameters (no function selector)\n *\n * @example\n * ```typescript\n * const encoded = encodeEvmParameters(\n *   ['address', 'uint256'],\n *   ['init1qwer...', 100n]\n * )\n * ```\n */\nexport function encodeEvmParameters(types: string[], values: unknown[]): `0x${string}` {\n  // Build a synthetic ABI to leverage convertEvmArgs for address conversion\n  const fragment = `function _encode(${types.join(',')})`\n  const abi = parseAbi([fragment]) as Abi\n  const convertedArgs = convertEvmArgs(abi, '_encode', values)\n\n  const params = types.map(type => ({ type }))\n  return viemEncodeAbiParameters(params, convertedArgs as readonly unknown[])\n}\n","/**\n * EVM Event Decoding Utilities\n *\n * Provides helpers for decoding EVM event logs from transaction receipts\n * and getLogs() results.\n */\n\nimport type { Abi, AbiEvent } from 'abitype'\nimport {\n  decodeEventLog,\n  encodeEventTopics,\n  type ContractEventName,\n  type DecodeEventLogReturnType,\n} from 'viem'\nimport type { EvmLog } from '../../client/evm-rpc'\n\n// Re-export for convenience\nexport { decodeEventLog }\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Decoded EVM event with original log data.\n *\n * When `TAbi` is a narrow `as const` ABI, `eventName` and `args` are\n * inferred from the ABI event definitions. When `TEventName` is provided,\n * the type is narrowed to that specific event.\n */\nexport type DecodedEvmLog<\n  TAbi extends Abi = Abi,\n  TEventName extends ContractEventName<TAbi> | undefined = undefined,\n> = {\n  /** Original log data */\n  log: EvmLog\n  /** Block number (parsed to bigint) */\n  blockNumber: bigint\n  /** Transaction index */\n  transactionIndex: number\n  /** Log index */\n  logIndex: number\n} & DecodeEventLogReturnType<TAbi, TEventName>\n\n/**\n * Options for decoding EVM logs.\n */\nexport interface DecodeEvmLogsOptions {\n  /**\n   * Whether to skip logs that fail to decode.\n   * If false, throws an error on decode failure.\n   * @default true\n   */\n  skipInvalid?: boolean\n}\n\n// =============================================================================\n// Functions\n// =============================================================================\n\n/**\n * Decode a single EVM log using the provided ABI.\n *\n * @param abi - Contract ABI containing event definitions\n * @param log - EVM log to decode\n * @returns Decoded event data with ABI-inferred eventName and args\n * @throws If log cannot be decoded with the provided ABI\n *\n * @example\n * ```typescript\n * import { decodeEvmLog } from 'initia.js'\n *\n * const log = await rpcClient.getLogs({ address: contractAddress })\n * const decoded = decodeEvmLog(erc20Abi, log[0])\n * if (decoded.eventName === 'Transfer') {\n *   console.log(decoded.args.from, decoded.args.to, decoded.args.value)\n * }\n * ```\n */\nexport function decodeEvmLog<const TAbi extends Abi>(abi: TAbi, log: EvmLog): DecodedEvmLog<TAbi> {\n  const topics = log.topics as [`0x${string}`, ...`0x${string}`[]]\n  const data = log.data as `0x${string}`\n\n  const decoded = decodeEventLog({\n    abi,\n    data,\n    topics,\n    strict: false,\n  })\n\n  return {\n    log,\n    eventName: decoded.eventName,\n    args: decoded.args,\n    blockNumber: BigInt(log.blockNumber),\n    transactionIndex: parseInt(log.transactionIndex, 16),\n    logIndex: parseInt(log.logIndex, 16),\n  } as DecodedEvmLog<TAbi>\n}\n\n/**\n * Decode multiple EVM logs using the provided ABI.\n *\n * @param abi - Contract ABI containing event definitions\n * @param logs - Array of EVM logs to decode\n * @param options - Decode options\n * @returns Array of decoded events with ABI-inferred types\n *\n * @example\n * ```typescript\n * import { createEvmRpcClient, decodeEvmLogs } from 'initia.js'\n *\n * const rpc = createEvmRpcClient(evmRpcEndpoint)\n * const logs = await rpc.getLogs({\n *   address: contractAddress,\n *   fromBlock: 1000000,\n *   toBlock: 'latest',\n * })\n *\n * const decoded = decodeEvmLogs(erc20Abi, logs)\n * for (const event of decoded) {\n *   if (event.eventName === 'Transfer') {\n *     console.log(event.args.from, event.args.to, event.args.value)\n *   }\n * }\n * ```\n */\nexport function decodeEvmLogs<const TAbi extends Abi>(\n  abi: TAbi,\n  logs: EvmLog[],\n  options: DecodeEvmLogsOptions = {}\n): DecodedEvmLog<TAbi>[] {\n  const { skipInvalid = true } = options\n  const decoded: DecodedEvmLog<TAbi>[] = []\n\n  for (const log of logs) {\n    try {\n      decoded.push(decodeEvmLog(abi, log))\n    } catch (error) {\n      if (!skipInvalid) {\n        throw error\n      }\n      // Skip logs that can't be decoded (from other contracts or unknown events)\n    }\n  }\n\n  return decoded\n}\n\n/**\n * Filter and decode logs by event name.\n *\n * @param abi - Contract ABI containing event definitions\n * @param logs - Array of EVM logs to filter and decode\n * @param eventName - Event name to filter by (narrowed to ABI event names)\n * @returns Array of decoded events narrowed to the specified event type\n *\n * @example\n * ```typescript\n * import { filterEvmLogsByEvent } from 'initia.js'\n *\n * const transfers = filterEvmLogsByEvent(erc20Abi, logs, 'Transfer')\n * for (const transfer of transfers) {\n *   // args is typed: { from: `0x${string}`, to: `0x${string}`, value: bigint }\n *   console.log(`Transfer from ${transfer.args.from} to ${transfer.args.to}: ${transfer.args.value}`)\n * }\n * ```\n */\nexport function filterEvmLogsByEvent<\n  const TAbi extends Abi,\n  TEventName extends ContractEventName<TAbi>,\n>(abi: TAbi, logs: EvmLog[], eventName: TEventName): DecodedEvmLog<TAbi, TEventName>[] {\n  const decoded = decodeEvmLogs(abi, logs, { skipInvalid: true })\n  return decoded.filter(d => d.eventName === eventName) as DecodedEvmLog<TAbi, TEventName>[]\n}\n\n/**\n * Get event signature (topic0) for an event by name.\n *\n * @param abi - Contract ABI containing event definitions\n * @param eventName - Event name (narrowed to ABI event names)\n * @returns Event signature hash (topic0) or undefined if not found\n *\n * @example\n * ```typescript\n * import { getEventSignature } from 'initia.js'\n *\n * const topic = getEventSignature(erc20Abi, 'Transfer')\n * // 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\n * ```\n */\nexport function getEventSignature<const TAbi extends Abi>(\n  abi: TAbi,\n  eventName: ContractEventName<TAbi>\n): `0x${string}` | undefined {\n  const event = abi.find(\n    (item): item is AbiEvent => item.type === 'event' && item.name === eventName\n  )\n\n  if (!event) {\n    return undefined\n  }\n\n  try {\n    const topics = encodeEventTopics({\n      abi: [event],\n      eventName: event.name,\n    })\n    return topics[0]\n  } catch {\n    return undefined\n  }\n}\n"],"mappings":"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"}

package/dist/entry.modules.d.mts

@@ -0,0 +1,2 @@
+import { At as ChainConfig, F as initiaChain, Ft as TxInput, Ha as miniwasmChain, It as createChainConfig, Mt as CoreMsgMethods, Nt as ModuleInput, Ot as buildChainContextFactory, Pt as MsgBuildersFromTx, _t as L1_CHAIN_IDS, bt as TypedFactoryOptions, jt as ChainConfigBuilder, no as minimoveChain, oo as createBaseConfig, ro as minievmChain, vt as TypedContextFactory, xt as buildTypedFactory, yt as TypedContextOptions } from "./types-DGrP9Ro_.mjs";
+export { type ChainConfig, ChainConfigBuilder, type CoreMsgMethods, L1_CHAIN_IDS, type ModuleInput, type MsgBuildersFromTx, type TxInput, type TypedContextFactory, type TypedContextOptions, type TypedFactoryOptions, buildChainContextFactory, buildTypedFactory, createBaseConfig, createChainConfig, initiaChain, minievmChain, minimoveChain, miniwasmChain };

package/dist/entry.modules.mjs

@@ -0,0 +1,7 @@
+import { g as createChainConfig, h as ChainConfigBuilder, n as createBaseConfig, v as buildChainContextFactory } from "./types_pb-K7pKBvcg.mjs";
+import { t as initiaChain } from "./initia-B8l_x6sT.mjs";
+import { t as minievmChain } from "./minievm-BAnGHa00.mjs";
+import { t as minimoveChain } from "./minimove-BBXTyhIv.mjs";
+import { t as miniwasmChain } from "./miniwasm-QdyYzmQ1.mjs";
+import { n as buildTypedFactory, t as L1_CHAIN_IDS } from "./typed-context-Cg0If0M9.mjs";
+export { ChainConfigBuilder, L1_CHAIN_IDS, buildChainContextFactory, buildTypedFactory, createBaseConfig, createChainConfig, initiaChain, minievmChain, minimoveChain, miniwasmChain };

package/dist/entry.move.d.mts

@@ -0,0 +1,523 @@
+import { Ai as BuildMoveExecuteOptions, Bi as MoveFunctionVisibility, Ca as Message, Fa as hexToBytes, Fi as MoveContract, Gi as MoveViewProxy, Go as MsgExecuteJSON, Hi as MoveModuleAbi, Ii as MoveContractConfig, Ji as ReadonlyMoveModuleAbi, Jo as MsgPublish, Ki as PublishModuleOptions, Ko as MsgExecuteJSONSchema, Li as MoveExecuteProxy, Mi as ExecuteScriptOptions, Ni as MoveCallOptions, Pi as MoveClient, Qo as UpgradePolicy, R as moveAbi, Ri as MoveFieldAbi, Ui as MoveStructAbi, Vi as MoveGenericTypeParam, Wi as MoveTypeToTs, Xo as MsgScriptJSON, Yi as TypedMoveContract, Yo as MsgScript, Zo as Query, ji as BuildMoveViewOptions, ki as BcsScriptOptions, qi as ReadonlyMoveFunctionAbi, qo as MsgExecuteSchema, ut as createFungibleAssetToken, y as HasMoveService, zi as MoveFunctionAbi } from "./types-DGrP9Ro_.mjs";
+import { Client } from "@connectrpc/connect";
+import { BcsType, BcsTypeOptions, bcs as bcs$1 } from "@mysten/bcs";
+
+//#region src/contracts/move/abi-fetcher.d.ts
+/**
+ * Move gRPC query client type.
+ */
+type MoveQueryClient = Client<typeof Query>;
+/**
+ * Gets a cached ABI if available and not expired.
+ *
+ * @param moduleAddress - Module address
+ * @param moduleName - Module name
+ * @param ttl - Cache TTL in milliseconds (ignored for IMMUTABLE modules)
+ * @returns Cached ABI or undefined
+ */
+declare function getCachedAbi(moduleAddress: string, moduleName: string, ttl?: number): MoveModuleAbi | undefined;
+/**
+ * Caches a module ABI.
+ *
+ * @param moduleAddress - Module address
+ * @param moduleName - Module name
+ * @param abi - Module ABI to cache
+ * @param permanent - If true, cache never expires (for IMMUTABLE modules)
+ */
+declare function cacheModuleAbi(moduleAddress: string, moduleName: string, abi: MoveModuleAbi, permanent?: boolean): void;
+/**
+ * Clears the ABI cache.
+ * Optionally clear only entries for a specific address.
+ *
+ * @param moduleAddress - Optional address to clear cache for
+ */
+declare function clearAbiCache(moduleAddress?: string): void;
+/**
+ * Parses a raw ABI JSON string into a typed MoveModuleAbi.
+ *
+ * @param abiJson - JSON string from Module.abi
+ * @returns Parsed module ABI
+ * @throws Error if JSON parsing fails or ABI structure is invalid
+ *
+ * @example
+ * ```typescript
+ * const abi = parseModuleAbi('{"address":"0x1","name":"coin",...}')
+ * ```
+ */
+declare function parseModuleAbi(abiJson: string): MoveModuleAbi;
+/**
+ * Options for fetching module ABI.
+ */
+interface FetchAbiOptions {
+  /** Use cached ABI if available (default: true) */
+  useCache?: boolean;
+  /** Cache TTL in milliseconds (default: 5 minutes) */
+  cacheTtl?: number;
+}
+/**
+ * Fetches and parses a Move module ABI from the chain.
+ *
+ * **Caching behavior:**
+ * - **IMMUTABLE modules**: Cached permanently (staleness impossible)
+ * - **COMPATIBLE/upgradeable modules**: Cached with TTL (default 5 minutes)
+ *
+ * For upgradeable modules, the cache may become stale after upgrades.
+ * Use `clearAbiCache(moduleAddress)` after known upgrades, or set
+ * `useCache: false` to always fetch fresh data.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param moduleAddress - Module address (hex or bech32)
+ * @param moduleName - Module name
+ * @param options - Fetch options
+ * @returns Parsed module ABI
+ *
+ * @example Basic usage
+ * ```typescript
+ * const abi = await getModuleAbi(ctx, '0x1', 'coin')
+ * console.log(abi.exposed_functions)
+ * ```
+ *
+ * @example Handle upgradeable module
+ * ```typescript
+ * // After module upgrade, clear cache
+ * clearAbiCache('0x1')
+ *
+ * // Or bypass cache entirely
+ * const abi = await getModuleAbi(ctx, '0x1', 'coin', { useCache: false })
+ * ```
+ */
+declare function getModuleAbi(context: HasMoveService, moduleAddress: string, moduleName: string, options?: FetchAbiOptions): Promise<MoveModuleAbi>;
+/**
+ * Fetches all modules from an address.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param address - Account address
+ * @returns Array of module ABIs
+ *
+ * @example
+ * ```typescript
+ * const modules = await getModulesAbi(ctx, '0x1')
+ * ```
+ */
+declare function getModulesAbi(context: HasMoveService, address: string): Promise<MoveModuleAbi[]>;
+/**
+ * Finds a function in the module ABI by name.
+ *
+ * @param abi - Module ABI
+ * @param functionName - Function name to find
+ * @returns Function ABI or undefined
+ */
+declare function findFunction(abi: MoveModuleAbi, functionName: string): MoveFunctionAbi | undefined;
+/**
+ * Finds a struct in the module ABI by name.
+ *
+ * @param abi - Module ABI
+ * @param structName - Struct name to find
+ * @returns Struct ABI or undefined
+ */
+declare function findStruct(abi: MoveModuleAbi, structName: string): MoveStructAbi | undefined;
+/**
+ * Gets all entry functions from the module ABI.
+ *
+ * @param abi - Module ABI
+ * @returns Array of entry function ABIs
+ */
+declare function getEntryFunctions(abi: MoveModuleAbi): MoveFunctionAbi[];
+/**
+ * Gets all view functions from the module ABI.
+ *
+ * @param abi - Module ABI
+ * @returns Array of view function ABIs
+ */
+declare function getViewFunctions(abi: MoveModuleAbi): MoveFunctionAbi[];
+/**
+ * Checks if a function requires a signer parameter.
+ * Signer params are typically the first param with type '&signer' or 'signer'.
+ *
+ * @param fn - Function ABI
+ * @returns True if function requires signer
+ */
+declare function requiresSigner(fn: MoveFunctionAbi): boolean;
+/**
+ * Gets the non-signer parameters of a function.
+ *
+ * @param fn - Function ABI
+ * @returns Parameter types excluding signer
+ */
+declare function getNonSignerParams(fn: MoveFunctionAbi): string[];
+//#endregion
+//#region src/contracts/move/contract.d.ts
+/**
+ * Options for creating a Move contract instance.
+ */
+interface CreateMoveContractOptions {
+  /** Pre-fetched ABI (skips gRPC fetch if provided) */
+  abi?: MoveModuleAbi;
+  /** Use cached ABI (default: true) */
+  useCache?: boolean;
+  /** Cache TTL in milliseconds (default: 5 minutes) */
+  cacheTtl?: number;
+}
+/**
+ * Creates a Move contract instance with a static ABI for compile-time type inference.
+ * Returns synchronously since no ABI fetch is needed.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param abi - Static ABI object (use `moveAbi()` or `as const satisfies ReadonlyMoveModuleAbi`)
+ * @returns Typed Move contract instance with autocomplete and type inference
+ *
+ * @example
+ * ```typescript
+ * const COIN_ABI = moveAbi({
+ *   address: '0x1', name: 'coin', friends: [],
+ *   exposed_functions: [
+ *     { name: 'decimals', visibility: 'public', is_entry: false, is_view: true,
+ *       generic_type_params: [], params: ['0x1::object::Object<0x1::fungible_asset::Metadata>'],
+ *       return: ['u8'] },
+ *   ],
+ *   structs: [],
+ * })
+ * const coin = createMoveContract(ctx, COIN_ABI)
+ * const dec = await coin.view.decimals({ args: ['0xabc'] }) // dec: number
+ * ```
+ */
+declare function createMoveContract<const T extends ReadonlyMoveModuleAbi>(context: HasMoveService, abi: T): TypedMoveContract<T>;
+/**
+ * Creates a Move contract instance by fetching ABI from chain.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param moduleAddress - Module address (hex or bech32)
+ * @param moduleName - Module name
+ * @param options - Contract options (ABI, caching)
+ * @returns Move contract instance
+ *
+ * @example
+ * ```typescript
+ * const coin = await createMoveContract(ctx, '0x1', 'coin')
+ * const msg = coin.execute.transfer(sender, {
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: [recipient, '1000000']
+ * })
+ * ```
+ */
+declare function createMoveContract(context: HasMoveService, moduleAddress: string, moduleName: string, options?: CreateMoveContractOptions): Promise<MoveContract>;
+/**
+ * Creates a MsgPublish for publishing Move modules.
+ *
+ * @param options - Publish options
+ * @returns MsgPublish message for signing
+ *
+ * @example
+ * ```typescript
+ * const msg = createPublishMsg({
+ *   sender: 'init1...',
+ *   codeBytes: [compiledModule1, compiledModule2],
+ *   upgradePolicy: UpgradePolicy.COMPATIBLE,
+ * })
+ * await ctx.signAndBroadcast([msg])
+ * ```
+ */
+declare function createPublishMsg(options: PublishModuleOptions): MsgPublish;
+/**
+ * Creates a MsgScriptJSON for executing a Move script.
+ *
+ * @param options - Script execution options
+ * @returns MsgScriptJSON message for signing
+ *
+ * @example
+ * ```typescript
+ * const msg = createScriptMsg({
+ *   sender: 'init1...',
+ *   codeBytes: compiledScript,
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: ['1000000'],
+ * })
+ * await ctx.signAndBroadcast([msg])
+ * ```
+ */
+declare function createScriptMsg(options: ExecuteScriptOptions): MsgScriptJSON;
+/**
+ * Creates a MsgScript with BCS-encoded arguments.
+ *
+ * Use this when you have pre-encoded BCS arguments. For simpler JSON arguments,
+ * use createScriptMsg() instead.
+ *
+ * @param options - Script execution options with BCS-encoded args
+ * @returns MsgScript message for signing
+ *
+ * @example
+ * ```typescript
+ * const msg = createBcsScriptMsg({
+ *   sender: 'init1...',
+ *   codeBytes: compiledScript,
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: [bcsEncodedAmount], // Pre-encoded BCS bytes
+ * })
+ * await ctx.signAndBroadcast([msg])
+ * ```
+ */
+declare function createBcsScriptMsg(options: BcsScriptOptions): MsgScript;
+/**
+ * Creates a MsgExecuteJSON directly without a contract instance.
+ *
+ * @param sender - Sender address
+ * @param moduleAddress - Module address
+ * @param moduleName - Module name
+ * @param functionName - Function name
+ * @param typeArgs - Type arguments
+ * @param args - Function arguments (will be JSON stringified)
+ * @returns MsgExecuteJSON message for signing
+ *
+ * @example
+ * ```typescript
+ * const msg = createExecuteMsg(
+ *   sender,
+ *   '0x1',
+ *   'coin',
+ *   'transfer',
+ *   ['0x1::native_uinit::Coin'],
+ *   [recipient, '1000000']
+ * )
+ * ```
+ */
+declare function createExecuteMsg(sender: string, moduleAddress: string, moduleName: string, functionName: string, typeArgs?: string[], args?: unknown[]): MsgExecuteJSON;
+/**
+ * Calls a view function directly without creating a contract instance.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param moduleAddress - Module address
+ * @param moduleName - Module name
+ * @param functionName - Function name
+ * @param typeArgs - Type arguments
+ * @param args - Function arguments (will be JSON stringified)
+ * @returns View function result
+ *
+ * @example
+ * ```typescript
+ * const balance = await callViewFunction(
+ *   ctx,
+ *   '0x1',
+ *   'coin',
+ *   'balance',
+ *   ['0x1::native_uinit::Coin'],
+ *   [address]
+ * )
+ * ```
+ */
+declare function callViewFunction(context: HasMoveService, moduleAddress: string, moduleName: string, functionName: string, typeArgs?: string[], args?: unknown[]): Promise<unknown>;
+/**
+ * Build a Move execute message using a combined function identifier.
+ *
+ * Without paramTypes: creates MsgExecuteJSON (chain handles type resolution).
+ * With paramTypes: attempts BCS encoding (MsgExecute), falls back to JSON with bech32 conversion.
+ *
+ * @example
+ * ```typescript
+ * // Simple (JSON path)
+ * const msg = buildMoveExecute(sender, {
+ *   function: '0x1::coin::transfer',
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: ['0xrecipient', '1000000'],
+ * })
+ *
+ * // With BCS + bech32
+ * const msg = buildMoveExecute(sender, {
+ *   function: '0x1::coin::transfer',
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: ['init1qwer...', 1000000n],
+ *   paramTypes: ['address', 'u64'],
+ * })
+ * ```
+ */
+declare function buildMoveExecute(sender: string, options: BuildMoveExecuteOptions): Message<typeof MsgExecuteSchema> | Message<typeof MsgExecuteJSONSchema>;
+/**
+ * Call a Move view function using a combined function identifier.
+ *
+ * Without returns: returns raw JSON.parse result.
+ * With returns: converts response to typed values (u64→bigint, etc.).
+ * With paramTypes: applies bech32→hex conversion on args.
+ *
+ * @example
+ * ```typescript
+ * // Typed response
+ * const balance = await buildMoveView(ctx, {
+ *   function: '0x1::coin::balance',
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: ['0xaddress'],
+ *   returns: ['u64'],
+ * })
+ * // balance: bigint
+ *
+ * // With bech32 args + typed response
+ * const balance = await buildMoveView(ctx, {
+ *   function: '0x1::coin::balance',
+ *   typeArgs: ['0x1::native_uinit::Coin'],
+ *   args: ['init1qwer...'],
+ *   paramTypes: ['address'],
+ *   returns: ['u64'],
+ * })
+ * ```
+ */
+declare function buildMoveView(context: HasMoveService, options: BuildMoveViewOptions): Promise<unknown>;
+/**
+ * Queries a Move resource directly.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param address - Account address
+ * @param structTag - Resource struct tag (e.g., '0x1::coin::CoinStore<0x1::native_uinit::Coin>')
+ * @returns Parsed resource data
+ *
+ * @example
+ * ```typescript
+ * const resource = await queryResource(ctx, '0x1', '0x1::coin::CoinInfo<...>')
+ * ```
+ */
+declare function queryResource(context: HasMoveService, address: string, structTag: string): Promise<unknown>;
+/**
+ * Queries a Move table entry directly.
+ *
+ * @param context - ChainContext with client (must have move service)
+ * @param tableHandle - Table handle address
+ * @param key - Key value
+ * @param keyType - Key type for BCS encoding
+ * @returns Parsed table entry value
+ *
+ * @example
+ * ```typescript
+ * const entry = await queryTableEntry(ctx, tableHandle, key, 'address')
+ * ```
+ */
+declare function queryTableEntry(context: HasMoveService, tableHandle: string, key: unknown, keyType: string): Promise<unknown>;
+//#endregion
+//#region src/contracts/move/bcs.d.ts
+/**
+ * Creates a BCS type for Move addresses (32 bytes).
+ * Accepts hex strings (0x...) or bech32 addresses (init1...).
+ */
+declare const initiaAddress: (options?: BcsTypeOptions<Uint8Array, Iterable<number>>) => BcsType<string, string, "bytes[32]">;
+/**
+ * Creates a BCS type for fixed_point32 (u64 with 32-bit fractional).
+ */
+declare const fixedPoint32: (options?: BcsTypeOptions<string, string | number | bigint>) => BcsType<string, string | number, "u64">;
+/**
+ * Creates a BCS type for fixed_point64 (u128 with 64-bit fractional).
+ */
+declare const fixedPoint64: (options?: BcsTypeOptions<string, string | number | bigint>) => BcsType<string, string | number, "u128">;
+/**
+ * Creates a BCS type for decimal128 (u128 with 18 decimal places).
+ */
+declare const decimal128: (options?: BcsTypeOptions<string, string | number | bigint>) => BcsType<string, string | number, "u128">;
+/**
+ * Creates a BCS type for decimal256 (u256 with 18 decimal places).
+ */
+declare const decimal256: (options?: BcsTypeOptions<string, string | number | bigint>) => BcsType<string, string | number, "u256">;
+/**
+ * Extended BCS object with Initia-specific types.
+ */
+declare const bcs: typeof bcs$1 & {
+  address: typeof initiaAddress;
+  object: typeof initiaAddress;
+  fixed_point32: typeof fixedPoint32;
+  fixed_point64: typeof fixedPoint64;
+  decimal128: typeof decimal128;
+  decimal256: typeof decimal256;
+};
+/**
+ * Parsed Move type representation.
+ */
+interface ParsedMoveType {
+  /** Base type name (e.g., 'vector', 'u64', 'address') */
+  base: string;
+  /** Type arguments for generic types */
+  typeArgs: ParsedMoveType[];
+}
+/**
+ * Parses a Move type string into a structured representation.
+ *
+ * @param typeStr - Move type string (e.g., 'vector<u8>', '0x1::coin::Coin<T>')
+ * @returns Parsed type structure
+ *
+ * @example
+ * ```typescript
+ * parseMoveType('u64')                    // { base: 'u64', typeArgs: [] }
+ * parseMoveType('vector<u8>')             // { base: 'vector', typeArgs: [{ base: 'u8', typeArgs: [] }] }
+ * parseMoveType('0x1::option::Option<u64>') // { base: '0x1::option::Option', typeArgs: [...] }
+ * ```
+ */
+declare function parseMoveType(typeStr: string): ParsedMoveType;
+/**
+ * Gets a BCS type for a Move type string.
+ *
+ * @param moveType - Move type string
+ * @returns BCS type for serialization/deserialization
+ *
+ * @example
+ * ```typescript
+ * const type = getBcsType('u64')
+ * const bytes = type.serialize(1000n).toBytes()
+ * ```
+ */
+declare function getBcsType(moveType: string): BcsType<any, any>;
+/**
+ * Encodes a single Move argument to BCS bytes.
+ *
+ * @param value - Value to encode
+ * @param moveType - Move type string
+ * @returns BCS encoded bytes
+ *
+ * @example
+ * ```typescript
+ * encodeMoveArg(1000n, 'u64')           // Uint8Array
+ * encodeMoveArg('init1...', 'address')  // Uint8Array
+ * encodeMoveArg([1, 2, 3], 'vector<u8>') // Uint8Array
+ * ```
+ */
+declare function encodeMoveArg(value: unknown, moveType: string): Uint8Array;
+/**
+ * Encodes multiple Move arguments to BCS bytes.
+ *
+ * @param values - Values to encode
+ * @param moveTypes - Move type strings for each value
+ * @returns Array of BCS encoded bytes
+ *
+ * @example
+ * ```typescript
+ * encodeMoveArgs(
+ *   ['init1...', 1000n],
+ *   ['address', 'u64']
+ * )
+ * ```
+ */
+declare function encodeMoveArgs(values: unknown[], moveTypes: string[]): Uint8Array[];
+/**
+ * Decodes BCS bytes to a Move value.
+ *
+ * @param bytes - BCS encoded bytes
+ * @param moveType - Move type string
+ * @returns Decoded value
+ *
+ * @example
+ * ```typescript
+ * decodeMoveResult(bytes, 'u64')      // bigint string
+ * decodeMoveResult(bytes, 'address')  // hex string
+ * decodeMoveResult(bytes, 'bool')     // boolean
+ * ```
+ */
+declare function decodeMoveResult(bytes: Uint8Array, moveType: string): unknown;
+/**
+ * Decodes multiple BCS values from a concatenated byte array.
+ * Note: This assumes the values are simply concatenated without length prefixes.
+ * For proper multi-value decoding, use separate byte arrays.
+ *
+ * @param bytesArray - Array of BCS encoded bytes
+ * @param moveTypes - Move type strings for each value
+ * @returns Array of decoded values
+ */
+declare function decodeMoveResults(bytesArray: Uint8Array[], moveTypes: string[]): unknown[];
+/**
+ * Converts Uint8Array to a hex string.
+ */
+declare function bytesToHex(bytes: Uint8Array): string;
+//#endregion
+export { type BcsScriptOptions, type BuildMoveExecuteOptions, type BuildMoveViewOptions, type CreateMoveContractOptions, type ExecuteScriptOptions, type FetchAbiOptions, type MoveCallOptions, type MoveClient, type MoveContract, type MoveContractConfig, type MoveExecuteProxy, type MoveFieldAbi, type MoveFunctionAbi, type MoveFunctionVisibility, type MoveGenericTypeParam, type MoveModuleAbi, type MoveQueryClient, type MoveStructAbi, type MoveTypeToTs, type MoveViewProxy, type MsgExecuteJSON as MsgExecute, type MsgPublish, type MsgScriptJSON as MsgScript, type ParsedMoveType, type PublishModuleOptions, type ReadonlyMoveFunctionAbi, type ReadonlyMoveModuleAbi, type TypedMoveContract, UpgradePolicy, bcs, buildMoveExecute, buildMoveView, bytesToHex, cacheModuleAbi, callViewFunction, clearAbiCache, createBcsScriptMsg, createExecuteMsg, createFungibleAssetToken, createMoveContract, createPublishMsg, createScriptMsg, decodeMoveResult, decodeMoveResults, encodeMoveArg, encodeMoveArgs, findFunction, findStruct, getBcsType, getCachedAbi, getEntryFunctions, getModuleAbi, getModulesAbi, getNonSignerParams, getViewFunctions, hexToBytes, moveAbi, parseModuleAbi, parseMoveType, queryResource, queryTableEntry, requiresSigner };
+//# sourceMappingURL=entry.move.d.mts.map

package/dist/entry.move.mjs

@@ -0,0 +1,7 @@
+import { d as hexToBytes } from "./types-CSS5rfW1.mjs";
+import { t as UpgradePolicy } from "./types_pb-CrjtO9sB.mjs";
+import { t as createFungibleAssetToken } from "./fungible-asset-aHBTYpoT.mjs";
+import { r as moveAbi } from "./abi-helpers-DdwdqhMQ.mjs";
+import { _ as getNonSignerParams, a as encodeMoveArg, b as requiresSigner, c as parseMoveType, d as findFunction, f as findStruct, g as getModulesAbi, h as getModuleAbi, i as decodeMoveResults, l as cacheModuleAbi, m as getEntryFunctions, n as bytesToHex, o as encodeMoveArgs, p as getCachedAbi, r as decodeMoveResult, s as getBcsType, t as bcs, u as clearAbiCache, v as getViewFunctions, y as parseModuleAbi } from "./bcs-DiRcL4n9.mjs";
+import { a as createExecuteMsg, c as createScriptMsg, i as createBcsScriptMsg, l as queryResource, n as buildMoveView, o as createMoveContract, r as callViewFunction, s as createPublishMsg, t as buildMoveExecute, u as queryTableEntry } from "./contract-Dpvu4wLO.mjs";
+export { UpgradePolicy, bcs, buildMoveExecute, buildMoveView, bytesToHex, cacheModuleAbi, callViewFunction, clearAbiCache, createBcsScriptMsg, createExecuteMsg, createFungibleAssetToken, createMoveContract, createPublishMsg, createScriptMsg, decodeMoveResult, decodeMoveResults, encodeMoveArg, encodeMoveArgs, findFunction, findStruct, getBcsType, getCachedAbi, getEntryFunctions, getModuleAbi, getModulesAbi, getNonSignerParams, getViewFunctions, hexToBytes, moveAbi, parseModuleAbi, parseMoveType, queryResource, queryTableEntry, requiresSigner };