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

package/dist/evm-rpc-BxpgXIAF.mjs

@@ -0,0 +1,338 @@
+import { o as ContractError } from "./errors-CN1MFOLv.mjs";
+import { r as validateHeaderConflict } from "./headers-CMO7ia_D.mjs";
+import { t as httpRequest } from "./http-client-BrdVurTg.mjs";
+//#region src/client/evm-rpc.ts
+/**
+* EVM JSON-RPC Client
+*
+* Provides HTTP-based JSON-RPC methods for EVM chains (minievm).
+* Used for operations not supported by gRPC like transaction receipts and logs.
+*/
+/**
+* Convert a number or bigint to 0x-prefixed hex string for JSON-RPC params.
+*/
+function numberToHex(value) {
+	return "0x" + value.toString(16);
+}
+/**
+* Convert a block number parameter to hex or block tag
+*/
+function formatBlockParam(block) {
+	if (block === void 0) return "latest";
+	if (typeof block === "string") {
+		if (block === "latest" || block === "earliest" || block === "pending") return block;
+		if (block.startsWith("0x")) return block;
+		return numberToHex(BigInt(block));
+	}
+	return numberToHex(block);
+}
+/**
+* EVM JSON-RPC client for minievm chains.
+*
+* Provides methods for querying transaction receipts, logs, and block information
+* that are not available through gRPC.
+*
+* @example
+* ```typescript
+* const rpc = createEvmRpcClient('https://jsonrpc-evm-1.anvil.initia.xyz')
+*
+* // Get transaction receipt
+* const receipt = await rpc.getTransactionReceipt(txHash)
+*
+* // Get logs
+* const logs = await rpc.getLogs({
+*   address: '0x...',
+*   fromBlock: 'latest',
+*   topics: ['0x...']
+* })
+*
+* // Get block number
+* const blockNumber = await rpc.getBlockNumber()
+* ```
+*/
+var EvmRpcClient = class {
+	config;
+	requestId = 0;
+	constructor(endpoint, options = {}) {
+		validateHeaderConflict(options.auth, options.headers, "context");
+		this.config = {
+			endpoint,
+			auth: options.auth,
+			headers: {
+				"content-type": "application/json",
+				...options.headers
+			},
+			timeoutMs: options.timeoutMs ?? options.timeout
+		};
+	}
+	/**
+	* Make a JSON-RPC call
+	*/
+	async call(method, params = [], requestOptions) {
+		const request = {
+			jsonrpc: "2.0",
+			method,
+			params,
+			id: ++this.requestId
+		};
+		const response = await httpRequest(this.config, "", {
+			method: "POST",
+			body: JSON.stringify(request)
+		}, requestOptions);
+		if (!response.ok) throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+		const json = await response.json();
+		if (json.error) {
+			const revertData = typeof json.error.data === "string" ? json.error.data : void 0;
+			throw new ContractError("evm", json.error.code, json.error.message, revertData);
+		}
+		return json.result;
+	}
+	/**
+	* Get transaction receipt by hash.
+	*
+	* @param txHash - Transaction hash (0x-prefixed)
+	* @returns Transaction receipt or null if not found
+	*
+	* @example
+	* ```typescript
+	* const receipt = await rpc.getTransactionReceipt('0x...')
+	* if (receipt) {
+	*   console.log('Status:', receipt.status === '0x1' ? 'success' : 'failed')
+	*   console.log('Gas used:', parseInt(receipt.gasUsed, 16))
+	*   console.log('Logs:', receipt.logs.length)
+	* }
+	* ```
+	*/
+	async getTransactionReceipt(txHash, options) {
+		return this.call("eth_getTransactionReceipt", [txHash], options);
+	}
+	/**
+	* Get logs matching a filter.
+	*
+	* @param filter - Filter parameters
+	* @returns Array of matching logs
+	*
+	* @example
+	* ```typescript
+	* // Get all Transfer events from an ERC20 contract
+	* const transferTopic = '0xddf252ad...' // keccak256('Transfer(address,address,uint256)')
+	* const logs = await rpc.getLogs({
+	*   address: '0x...',
+	*   fromBlock: 1000000,
+	*   toBlock: 'latest',
+	*   topics: [transferTopic]
+	* })
+	* ```
+	*/
+	async getLogs(filter, options) {
+		const params = {};
+		if (filter.blockHash) params.blockHash = filter.blockHash;
+		else {
+			if (filter.fromBlock !== void 0) params.fromBlock = formatBlockParam(filter.fromBlock);
+			if (filter.toBlock !== void 0) params.toBlock = formatBlockParam(filter.toBlock);
+		}
+		if (filter.address) params.address = filter.address;
+		if (filter.topics) params.topics = filter.topics;
+		return this.call("eth_getLogs", [params], options);
+	}
+	/**
+	* Get the current block number.
+	*
+	* @returns Current block number
+	*
+	* @example
+	* ```typescript
+	* const blockNumber = await rpc.getBlockNumber()
+	* console.log('Current block:', blockNumber)
+	* ```
+	*/
+	async getBlockNumber(options) {
+		const result = await this.call("eth_blockNumber", [], options);
+		return BigInt(result);
+	}
+	/**
+	* Get block by number.
+	*
+	* @param blockNumber - Block number, "latest", "earliest", or "pending"
+	* @param includeTransactions - Whether to include full transaction objects
+	* @returns Block object or null if not found
+	*
+	* @example
+	* ```typescript
+	* const block = await rpc.getBlockByNumber('latest', false)
+	* if (block) {
+	*   console.log('Block hash:', block.hash)
+	*   console.log('Tx count:', block.transactions.length)
+	* }
+	* ```
+	*/
+	async getBlockByNumber(blockNumber, includeTransactions = false, options) {
+		const blockParam = typeof blockNumber === "bigint" ? numberToHex(blockNumber) : formatBlockParam(blockNumber);
+		return this.call("eth_getBlockByNumber", [blockParam, includeTransactions], options);
+	}
+	/**
+	* Get block by hash.
+	*
+	* @param blockHash - Block hash (0x-prefixed)
+	* @param includeTransactions - Whether to include full transaction objects
+	* @returns Block object or null if not found
+	*/
+	async getBlockByHash(blockHash, includeTransactions = false, options) {
+		return this.call("eth_getBlockByHash", [blockHash, includeTransactions], options);
+	}
+	/**
+	* Execute a read-only call against a contract (eth_call).
+	*
+	* On revert, throws a ContractError with the raw revert data in `e.data`,
+	* which can be decoded with `decodeRevertReason()`.
+	*
+	* @param tx - Transaction parameters (from, to, data, value)
+	* @param blockNumber - Block number or tag (default: "latest")
+	* @returns Hex-encoded return data
+	*
+	* @example
+	* ```typescript
+	* try {
+	*   const result = await rpc.ethCall({ from: '0x...', to: '0x...', data: '0x...' })
+	* } catch (e) {
+	*   if (e instanceof ContractError && e.data) {
+	*     const reason = decodeRevertReason(e.data, abi)
+	*   }
+	* }
+	* ```
+	*/
+	async ethCall(tx, blockNumber = "latest", options) {
+		return this.call("eth_call", [tx, formatBlockParam(blockNumber)], options);
+	}
+	/**
+	* Send a signed raw transaction.
+	*
+	* @param signedTx - Signed transaction as hex string (0x-prefixed)
+	* @returns Transaction hash
+	*
+	* @example
+	* ```typescript
+	* const txHash = await rpc.sendRawTransaction('0x02f8...')
+	* ```
+	*/
+	async sendRawTransaction(signedTx, options) {
+		return this.call("eth_sendRawTransaction", [signedTx], options);
+	}
+	/**
+	* Estimate gas for a transaction.
+	*
+	* @param tx - Transaction parameters
+	* @returns Estimated gas as bigint
+	*
+	* @example
+	* ```typescript
+	* const gas = await rpc.estimateGas({
+	*   from: '0x...',
+	*   to: '0x...',
+	*   data: '0x...',
+	* })
+	* ```
+	*/
+	async estimateGas(tx, options) {
+		const result = await this.call("eth_estimateGas", [tx], options);
+		return BigInt(result);
+	}
+	/**
+	* Get the chain ID.
+	*
+	* @returns Chain ID as bigint
+	*/
+	async getChainId(options) {
+		const result = await this.call("eth_chainId", [], options);
+		return BigInt(result);
+	}
+	/**
+	* Get the current gas price.
+	*
+	* @returns Gas price in wei
+	*/
+	async getGasPrice(options) {
+		const result = await this.call("eth_gasPrice", [], options);
+		return BigInt(result);
+	}
+	/**
+	* Get the balance of an account.
+	*
+	* @param address - Account address (0x-prefixed)
+	* @param blockNumber - Block number or tag (default: "latest")
+	* @returns Balance in wei
+	*/
+	async getBalance(address, blockNumber = "latest", options) {
+		const result = await this.call("eth_getBalance", [address, formatBlockParam(blockNumber)], options);
+		return BigInt(result);
+	}
+	/**
+	* Get the code at an address.
+	*
+	* @param address - Contract address (0x-prefixed)
+	* @param blockNumber - Block number or tag (default: "latest")
+	* @returns Contract bytecode or "0x" if no code
+	*/
+	async getCode(address, blockNumber = "latest", options) {
+		return this.call("eth_getCode", [address, formatBlockParam(blockNumber)], options);
+	}
+	/**
+	* Get the transaction count (nonce) of an address.
+	*
+	* @param address - Account address (0x-prefixed)
+	* @param blockNumber - Block number or tag (default: "latest")
+	* @returns Transaction count (nonce)
+	*/
+	async getTransactionCount(address, blockNumber = "latest", options) {
+		const result = await this.call("eth_getTransactionCount", [address, formatBlockParam(blockNumber)], options);
+		return BigInt(result);
+	}
+	/**
+	* Get transaction by hash.
+	*
+	* @param hash - Transaction hash (0x-prefixed)
+	* @returns Transaction object or null if not found
+	*/
+	async getTransactionByHash(hash, options) {
+		return this.call("eth_getTransactionByHash", [hash], options);
+	}
+	/**
+	* Get storage value at a given position.
+	*
+	* @param address - Contract address (0x-prefixed)
+	* @param position - Storage position (0x-prefixed hex)
+	* @param blockNumber - Block number or tag (default: "latest")
+	* @returns Storage value as hex string
+	*/
+	async getStorageAt(address, position, blockNumber = "latest", options) {
+		return this.call("eth_getStorageAt", [
+			address,
+			position,
+			formatBlockParam(blockNumber)
+		], options);
+	}
+};
+/**
+* Create an EVM JSON-RPC client.
+*
+* @param endpoint - JSON-RPC endpoint URL
+* @param options - Client options
+* @returns EVM RPC client instance
+*
+* @example
+* ```typescript
+* import { createEvmRpcClient } from 'initia.js'
+*
+* const rpc = createEvmRpcClient('https://jsonrpc-evm-1.anvil.initia.xyz')
+*
+* // Get transaction receipt with decoded logs
+* const receipt = await rpc.getTransactionReceipt(txHash)
+* ```
+*/
+function createEvmRpcClient(endpoint, options) {
+	return new EvmRpcClient(endpoint, options);
+}
+//#endregion
+export { createEvmRpcClient as n, EvmRpcClient as t };
+
+//# sourceMappingURL=evm-rpc-BxpgXIAF.mjs.map

package/dist/evm-rpc-BxpgXIAF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-rpc-BxpgXIAF.mjs","names":[],"sources":["../src/client/evm-rpc.ts"],"sourcesContent":["/**\n * EVM JSON-RPC Client\n *\n * Provides HTTP-based JSON-RPC methods for EVM chains (minievm).\n * Used for operations not supported by gRPC like transaction receipts and logs.\n */\n\nimport { httpRequest, type HttpClientConfig } from './http-client'\nimport { validateHeaderConflict } from './headers'\nimport { ContractError } from '../errors'\nimport type { AuthConfig, HttpRequestOptions } from './types'\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * JSON-RPC request structure\n */\ninterface JsonRpcRequest {\n  jsonrpc: '2.0'\n  method: string\n  params: unknown[]\n  id: number\n}\n\n/**\n * JSON-RPC response structure\n */\ninterface JsonRpcResponse<T> {\n  jsonrpc: '2.0'\n  result?: T\n  error?: {\n    code: number\n    message: string\n    data?: unknown\n  }\n  id: number\n}\n\n/**\n * EVM log entry\n */\nexport interface EvmLog {\n  /** Address from which this log originated */\n  address: string\n  /** Array of 0 to 4 32 Bytes DATA of indexed log arguments */\n  topics: string[]\n  /** Contains non-indexed arguments of the log */\n  data: string\n  /** Block number where this log was in (hex) */\n  blockNumber: string\n  /** Hash of the transaction this log was created from */\n  transactionHash: string\n  /** Index position of the transaction in the block (hex) */\n  transactionIndex: string\n  /** Hash of the block where this log was in */\n  blockHash: string\n  /** Index position in the block (hex) */\n  logIndex: string\n  /** true when the log was removed due to a chain reorg */\n  removed: boolean\n}\n\n/**\n * Transaction receipt\n */\nexport interface TransactionReceipt {\n  /** Hash of the transaction */\n  transactionHash: string\n  /** Index position of the transaction in the block (hex) */\n  transactionIndex: string\n  /** Hash of the block this transaction was in */\n  blockHash: string\n  /** Block number this transaction was in (hex) */\n  blockNumber: string\n  /** Address of the sender */\n  from: string\n  /** Address of the receiver (null for contract creation) */\n  to: string | null\n  /** Total gas used when this transaction was executed (hex) */\n  cumulativeGasUsed: string\n  /** Gas used by this specific transaction (hex) */\n  gasUsed: string\n  /** Contract address created if this was a contract creation, otherwise null */\n  contractAddress: string | null\n  /** Array of log objects generated by this transaction */\n  logs: EvmLog[]\n  /** Bloom filter for light clients to quickly retrieve related logs */\n  logsBloom: string\n  /** 1 (success) or 0 (failure) (hex) */\n  status: string\n  /** Post-transaction state root (pre-Byzantium) */\n  root?: string\n  /** Effective gas price (hex) */\n  effectiveGasPrice?: string\n  /** Transaction type (hex) */\n  type?: string\n}\n\n/**\n * Block information\n */\nexport interface EvmBlock {\n  /** Block number (hex) or null for pending */\n  number: string | null\n  /** Block hash or null for pending */\n  hash: string | null\n  /** Parent block hash */\n  parentHash: string\n  /** SHA3 of the uncles data */\n  sha3Uncles: string\n  /** Bloom filter for logs */\n  logsBloom: string\n  /** Root of the transaction trie */\n  transactionsRoot: string\n  /** Root of the state trie */\n  stateRoot: string\n  /** Root of the receipts trie */\n  receiptsRoot: string\n  /** Address of the miner */\n  miner: string\n  /** Mining difficulty (hex) */\n  difficulty: string\n  /** Total difficulty (hex) */\n  totalDifficulty: string\n  /** Extra data */\n  extraData: string\n  /** Block size in bytes (hex) */\n  size: string\n  /** Gas limit (hex) */\n  gasLimit: string\n  /** Gas used (hex) */\n  gasUsed: string\n  /** Block timestamp (hex) */\n  timestamp: string\n  /** Array of transaction hashes or transaction objects */\n  transactions: string[] | object[]\n  /** Array of uncle hashes */\n  uncles: string[]\n  /** Base fee per gas (hex, EIP-1559) */\n  baseFeePerGas?: string\n}\n\n/**\n * Filter parameters for getLogs\n */\nexport interface GetLogsFilter {\n  /** Block number (hex), \"earliest\", \"latest\", or \"pending\" */\n  fromBlock?: string | number\n  /** Block number (hex), \"earliest\", \"latest\", or \"pending\" */\n  toBlock?: string | number\n  /** Contract address or list of addresses */\n  address?: string | string[]\n  /** Array of topic filters */\n  topics?: (string | string[] | null)[]\n  /** Block hash (alternative to fromBlock/toBlock) */\n  blockHash?: string\n}\n\n/**\n * Ethereum transaction object\n */\nexport interface EvmTransaction {\n  hash: string\n  nonce: string\n  blockHash: string | null\n  blockNumber: string | null\n  transactionIndex: string | null\n  from: string\n  to: string | null\n  value: string\n  gas: string\n  gasPrice: string\n  input: string\n  v: string\n  r: string\n  s: string\n  type?: string\n  maxFeePerGas?: string\n  maxPriorityFeePerGas?: string\n  chainId?: string\n  accessList?: Array<{ address: string; storageKeys: string[] }>\n  yParity?: string\n}\n\n/**\n * Options for creating an EVM RPC client\n */\nexport interface EvmRpcClientOptions {\n  /** Request timeout in milliseconds (default: 30000) */\n  timeout?: number\n  /** Request timeout in milliseconds (preferred over timeout) */\n  timeoutMs?: number\n  /** Custom headers to include in requests */\n  headers?: Record<string, string>\n  /** Authentication configuration */\n  auth?: AuthConfig\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Convert a number or bigint to 0x-prefixed hex string for JSON-RPC params.\n */\nfunction numberToHex(value: number | bigint): string {\n  return '0x' + value.toString(16)\n}\n\n/**\n * Convert a block number parameter to hex or block tag\n */\nfunction formatBlockParam(block: string | number | undefined): string {\n  if (block === undefined) return 'latest'\n  if (typeof block === 'string') {\n    if (block === 'latest' || block === 'earliest' || block === 'pending') {\n      return block\n    }\n    // Already hex\n    if (block.startsWith('0x')) return block\n    // Number string\n    return numberToHex(BigInt(block))\n  }\n  return numberToHex(block)\n}\n\n// =============================================================================\n// EVM RPC Client\n// =============================================================================\n\n/**\n * EVM JSON-RPC client for minievm chains.\n *\n * Provides methods for querying transaction receipts, logs, and block information\n * that are not available through gRPC.\n *\n * @example\n * ```typescript\n * const rpc = createEvmRpcClient('https://jsonrpc-evm-1.anvil.initia.xyz')\n *\n * // Get transaction receipt\n * const receipt = await rpc.getTransactionReceipt(txHash)\n *\n * // Get logs\n * const logs = await rpc.getLogs({\n *   address: '0x...',\n *   fromBlock: 'latest',\n *   topics: ['0x...']\n * })\n *\n * // Get block number\n * const blockNumber = await rpc.getBlockNumber()\n * ```\n */\nexport class EvmRpcClient {\n  private config: HttpClientConfig\n  private requestId = 0\n\n  constructor(endpoint: string, options: EvmRpcClientOptions = {}) {\n    validateHeaderConflict(options.auth, options.headers, 'context')\n    this.config = {\n      endpoint,\n      auth: options.auth,\n      headers: { 'content-type': 'application/json', ...options.headers },\n      timeoutMs: options.timeoutMs ?? options.timeout,\n    }\n  }\n\n  /**\n   * Make a JSON-RPC call\n   */\n  private async call<T>(\n    method: string,\n    params: unknown[] = [],\n    requestOptions?: HttpRequestOptions\n  ): Promise<T> {\n    const request: JsonRpcRequest = {\n      jsonrpc: '2.0',\n      method,\n      params,\n      id: ++this.requestId,\n    }\n\n    const response = await httpRequest(\n      this.config,\n      '',\n      { method: 'POST', body: JSON.stringify(request) },\n      requestOptions\n    )\n\n    if (!response.ok) {\n      throw new Error(`HTTP error: ${response.status} ${response.statusText}`)\n    }\n\n    const json = (await response.json()) as JsonRpcResponse<T>\n\n    if (json.error) {\n      // EVM revert: code 3 with hex data in error.data\n      const revertData = typeof json.error.data === 'string' ? json.error.data : undefined\n      throw new ContractError('evm', json.error.code, json.error.message, revertData)\n    }\n\n    return json.result as T\n  }\n\n  // ===========================================================================\n  // Transaction Methods\n  // ===========================================================================\n\n  /**\n   * Get transaction receipt by hash.\n   *\n   * @param txHash - Transaction hash (0x-prefixed)\n   * @returns Transaction receipt or null if not found\n   *\n   * @example\n   * ```typescript\n   * const receipt = await rpc.getTransactionReceipt('0x...')\n   * if (receipt) {\n   *   console.log('Status:', receipt.status === '0x1' ? 'success' : 'failed')\n   *   console.log('Gas used:', parseInt(receipt.gasUsed, 16))\n   *   console.log('Logs:', receipt.logs.length)\n   * }\n   * ```\n   */\n  async getTransactionReceipt(\n    txHash: string,\n    options?: HttpRequestOptions\n  ): Promise<TransactionReceipt | null> {\n    return this.call<TransactionReceipt | null>('eth_getTransactionReceipt', [txHash], options)\n  }\n\n  // ===========================================================================\n  // Log Methods\n  // ===========================================================================\n\n  /**\n   * Get logs matching a filter.\n   *\n   * @param filter - Filter parameters\n   * @returns Array of matching logs\n   *\n   * @example\n   * ```typescript\n   * // Get all Transfer events from an ERC20 contract\n   * const transferTopic = '0xddf252ad...' // keccak256('Transfer(address,address,uint256)')\n   * const logs = await rpc.getLogs({\n   *   address: '0x...',\n   *   fromBlock: 1000000,\n   *   toBlock: 'latest',\n   *   topics: [transferTopic]\n   * })\n   * ```\n   */\n  async getLogs(filter: GetLogsFilter, options?: HttpRequestOptions): Promise<EvmLog[]> {\n    const params: Record<string, unknown> = {}\n\n    if (filter.blockHash) {\n      params.blockHash = filter.blockHash\n    } else {\n      if (filter.fromBlock !== undefined) {\n        params.fromBlock = formatBlockParam(filter.fromBlock)\n      }\n      if (filter.toBlock !== undefined) {\n        params.toBlock = formatBlockParam(filter.toBlock)\n      }\n    }\n\n    if (filter.address) {\n      params.address = filter.address\n    }\n\n    if (filter.topics) {\n      params.topics = filter.topics\n    }\n\n    return this.call<EvmLog[]>('eth_getLogs', [params], options)\n  }\n\n  // ===========================================================================\n  // Block Methods\n  // ===========================================================================\n\n  /**\n   * Get the current block number.\n   *\n   * @returns Current block number\n   *\n   * @example\n   * ```typescript\n   * const blockNumber = await rpc.getBlockNumber()\n   * console.log('Current block:', blockNumber)\n   * ```\n   */\n  async getBlockNumber(options?: HttpRequestOptions): Promise<bigint> {\n    const result = await this.call<string>('eth_blockNumber', [], options)\n    return BigInt(result)\n  }\n\n  /**\n   * Get block by number.\n   *\n   * @param blockNumber - Block number, \"latest\", \"earliest\", or \"pending\"\n   * @param includeTransactions - Whether to include full transaction objects\n   * @returns Block object or null if not found\n   *\n   * @example\n   * ```typescript\n   * const block = await rpc.getBlockByNumber('latest', false)\n   * if (block) {\n   *   console.log('Block hash:', block.hash)\n   *   console.log('Tx count:', block.transactions.length)\n   * }\n   * ```\n   */\n  async getBlockByNumber(\n    blockNumber: string | number | bigint,\n    includeTransactions = false,\n    options?: HttpRequestOptions\n  ): Promise<EvmBlock | null> {\n    const blockParam =\n      typeof blockNumber === 'bigint' ? numberToHex(blockNumber) : formatBlockParam(blockNumber)\n    return this.call<EvmBlock | null>(\n      'eth_getBlockByNumber',\n      [blockParam, includeTransactions],\n      options\n    )\n  }\n\n  /**\n   * Get block by hash.\n   *\n   * @param blockHash - Block hash (0x-prefixed)\n   * @param includeTransactions - Whether to include full transaction objects\n   * @returns Block object or null if not found\n   */\n  async getBlockByHash(\n    blockHash: string,\n    includeTransactions = false,\n    options?: HttpRequestOptions\n  ): Promise<EvmBlock | null> {\n    return this.call<EvmBlock | null>(\n      'eth_getBlockByHash',\n      [blockHash, includeTransactions],\n      options\n    )\n  }\n\n  // ===========================================================================\n  // Call Methods\n  // ===========================================================================\n\n  /**\n   * Execute a read-only call against a contract (eth_call).\n   *\n   * On revert, throws a ContractError with the raw revert data in `e.data`,\n   * which can be decoded with `decodeRevertReason()`.\n   *\n   * @param tx - Transaction parameters (from, to, data, value)\n   * @param blockNumber - Block number or tag (default: \"latest\")\n   * @returns Hex-encoded return data\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await rpc.ethCall({ from: '0x...', to: '0x...', data: '0x...' })\n   * } catch (e) {\n   *   if (e instanceof ContractError && e.data) {\n   *     const reason = decodeRevertReason(e.data, abi)\n   *   }\n   * }\n   * ```\n   */\n  async ethCall(\n    tx: {\n      from?: string\n      to: string\n      data?: string\n      value?: string\n    },\n    blockNumber: string | number = 'latest',\n    options?: HttpRequestOptions\n  ): Promise<string> {\n    return this.call<string>('eth_call', [tx, formatBlockParam(blockNumber)], options)\n  }\n\n  // ===========================================================================\n  // Transaction Sending Methods\n  // ===========================================================================\n\n  /**\n   * Send a signed raw transaction.\n   *\n   * @param signedTx - Signed transaction as hex string (0x-prefixed)\n   * @returns Transaction hash\n   *\n   * @example\n   * ```typescript\n   * const txHash = await rpc.sendRawTransaction('0x02f8...')\n   * ```\n   */\n  async sendRawTransaction(signedTx: string, options?: HttpRequestOptions): Promise<string> {\n    return this.call<string>('eth_sendRawTransaction', [signedTx], options)\n  }\n\n  /**\n   * Estimate gas for a transaction.\n   *\n   * @param tx - Transaction parameters\n   * @returns Estimated gas as bigint\n   *\n   * @example\n   * ```typescript\n   * const gas = await rpc.estimateGas({\n   *   from: '0x...',\n   *   to: '0x...',\n   *   data: '0x...',\n   * })\n   * ```\n   */\n  async estimateGas(\n    tx: {\n      from: string\n      to: string\n      data?: string\n      value?: string\n    },\n    options?: HttpRequestOptions\n  ): Promise<bigint> {\n    const result = await this.call<string>('eth_estimateGas', [tx], options)\n    return BigInt(result)\n  }\n\n  // ===========================================================================\n  // Chain Methods\n  // ===========================================================================\n\n  /**\n   * Get the chain ID.\n   *\n   * @returns Chain ID as bigint\n   */\n  async getChainId(options?: HttpRequestOptions): Promise<bigint> {\n    const result = await this.call<string>('eth_chainId', [], options)\n    return BigInt(result)\n  }\n\n  /**\n   * Get the current gas price.\n   *\n   * @returns Gas price in wei\n   */\n  async getGasPrice(options?: HttpRequestOptions): Promise<bigint> {\n    const result = await this.call<string>('eth_gasPrice', [], options)\n    return BigInt(result)\n  }\n\n  // ===========================================================================\n  // Account Methods\n  // ===========================================================================\n\n  /**\n   * Get the balance of an account.\n   *\n   * @param address - Account address (0x-prefixed)\n   * @param blockNumber - Block number or tag (default: \"latest\")\n   * @returns Balance in wei\n   */\n  async getBalance(\n    address: string,\n    blockNumber: string | number = 'latest',\n    options?: HttpRequestOptions\n  ): Promise<bigint> {\n    const result = await this.call<string>(\n      'eth_getBalance',\n      [address, formatBlockParam(blockNumber)],\n      options\n    )\n    return BigInt(result)\n  }\n\n  /**\n   * Get the code at an address.\n   *\n   * @param address - Contract address (0x-prefixed)\n   * @param blockNumber - Block number or tag (default: \"latest\")\n   * @returns Contract bytecode or \"0x\" if no code\n   */\n  async getCode(\n    address: string,\n    blockNumber: string | number = 'latest',\n    options?: HttpRequestOptions\n  ): Promise<string> {\n    return this.call<string>('eth_getCode', [address, formatBlockParam(blockNumber)], options)\n  }\n\n  /**\n   * Get the transaction count (nonce) of an address.\n   *\n   * @param address - Account address (0x-prefixed)\n   * @param blockNumber - Block number or tag (default: \"latest\")\n   * @returns Transaction count (nonce)\n   */\n  async getTransactionCount(\n    address: string,\n    blockNumber: string | number = 'latest',\n    options?: HttpRequestOptions\n  ): Promise<bigint> {\n    const result = await this.call<string>(\n      'eth_getTransactionCount',\n      [address, formatBlockParam(blockNumber)],\n      options\n    )\n    return BigInt(result)\n  }\n\n  /**\n   * Get transaction by hash.\n   *\n   * @param hash - Transaction hash (0x-prefixed)\n   * @returns Transaction object or null if not found\n   */\n  async getTransactionByHash(\n    hash: string,\n    options?: HttpRequestOptions\n  ): Promise<EvmTransaction | null> {\n    return this.call<EvmTransaction | null>('eth_getTransactionByHash', [hash], options)\n  }\n\n  /**\n   * Get storage value at a given position.\n   *\n   * @param address - Contract address (0x-prefixed)\n   * @param position - Storage position (0x-prefixed hex)\n   * @param blockNumber - Block number or tag (default: \"latest\")\n   * @returns Storage value as hex string\n   */\n  async getStorageAt(\n    address: string,\n    position: string,\n    blockNumber: string | number = 'latest',\n    options?: HttpRequestOptions\n  ): Promise<string> {\n    return this.call<string>(\n      'eth_getStorageAt',\n      [address, position, formatBlockParam(blockNumber)],\n      options\n    )\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create an EVM JSON-RPC client.\n *\n * @param endpoint - JSON-RPC endpoint URL\n * @param options - Client options\n * @returns EVM RPC client instance\n *\n * @example\n * ```typescript\n * import { createEvmRpcClient } from 'initia.js'\n *\n * const rpc = createEvmRpcClient('https://jsonrpc-evm-1.anvil.initia.xyz')\n *\n * // Get transaction receipt with decoded logs\n * const receipt = await rpc.getTransactionReceipt(txHash)\n * ```\n */\nexport function createEvmRpcClient(endpoint: string, options?: EvmRpcClientOptions): EvmRpcClient {\n  return new EvmRpcClient(endpoint, options)\n}\n"],"mappings":"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"}

package/dist/fetch-Bq_aay6V.mjs

@@ -0,0 +1,55 @@
+import { o as DEFAULT_REQUEST_TIMEOUT_MS } from "./constants-W6V0E-3W.mjs";
+//#region src/util/fetch.ts
+/**
+* Lightweight fetch utilities with timeout support.
+*
+* For use by REST API clients, registry providers, and other HTTP callers.
+* For full-featured HTTP with auth/headers/signal merging, use client/http-client.ts.
+*/
+/**
+* Merge a caller-provided AbortSignal with a controller's signal.
+* Uses AbortSignal.any when available, falls back to manual event forwarding.
+* The fallback cleans up listeners when the controller aborts first (e.g., timeout).
+*/
+function mergeAbortSignals(callerSignal, controller) {
+	if (typeof AbortSignal.any === "function") return AbortSignal.any([callerSignal, controller.signal]);
+	if (callerSignal.aborted) {
+		controller.abort(callerSignal.reason);
+		return controller.signal;
+	}
+	const forwardAbort = () => controller.abort(callerSignal.reason);
+	callerSignal.addEventListener("abort", forwardAbort, { once: true });
+	controller.signal.addEventListener("abort", () => {
+		callerSignal.removeEventListener("abort", forwardAbort);
+	}, { once: true });
+	return controller.signal;
+}
+/**
+* Fetch with AbortController-based timeout.
+*/
+async function fetchWithTimeout(url, init) {
+	const { timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS, ...fetchInit } = init ?? {};
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+	const signal = fetchInit.signal ? mergeAbortSignals(fetchInit.signal, controller) : controller.signal;
+	try {
+		return await fetch(url, {
+			...fetchInit,
+			signal
+		});
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+/**
+* Fetch and parse JSON response. Throws on non-ok status.
+*/
+async function fetchJson(url, init) {
+	const res = await fetchWithTimeout(url, init);
+	if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+	return await res.json();
+}
+//#endregion
+export { fetchWithTimeout as n, mergeAbortSignals as r, fetchJson as t };
+
+//# sourceMappingURL=fetch-Bq_aay6V.mjs.map

package/dist/fetch-Bq_aay6V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-Bq_aay6V.mjs","names":[],"sources":["../src/util/fetch.ts"],"sourcesContent":["/**\n * Lightweight fetch utilities with timeout support.\n *\n * For use by REST API clients, registry providers, and other HTTP callers.\n * For full-featured HTTP with auth/headers/signal merging, use client/http-client.ts.\n */\n\nimport { DEFAULT_REQUEST_TIMEOUT_MS } from '../constants'\n\n/**\n * Merge a caller-provided AbortSignal with a controller's signal.\n * Uses AbortSignal.any when available, falls back to manual event forwarding.\n * The fallback cleans up listeners when the controller aborts first (e.g., timeout).\n */\nexport function mergeAbortSignals(\n  callerSignal: AbortSignal,\n  controller: AbortController\n): AbortSignal {\n  if (typeof AbortSignal.any === 'function') {\n    return AbortSignal.any([callerSignal, controller.signal])\n  }\n  // Handle already-aborted signal (the event already fired, addEventListener won't trigger)\n  if (callerSignal.aborted) {\n    controller.abort(callerSignal.reason)\n    return controller.signal\n  }\n  const forwardAbort = () => controller.abort(callerSignal.reason)\n  callerSignal.addEventListener('abort', forwardAbort, { once: true })\n  // Clean up the forwarding listener when controller aborts first (e.g., timeout)\n  controller.signal.addEventListener(\n    'abort',\n    () => {\n      callerSignal.removeEventListener('abort', forwardAbort)\n    },\n    { once: true }\n  )\n  return controller.signal\n}\n\nexport interface FetchOptions extends RequestInit {\n  /** Timeout in milliseconds (default: DEFAULT_REQUEST_TIMEOUT_MS) */\n  timeoutMs?: number\n}\n\n/**\n * Fetch with AbortController-based timeout.\n */\nexport async function fetchWithTimeout(url: string, init?: FetchOptions): Promise<Response> {\n  const { timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS, ...fetchInit } = init ?? {}\n  const controller = new AbortController()\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs)\n\n  // Merge caller's signal with timeout signal to respect both\n  const signal = fetchInit.signal\n    ? mergeAbortSignals(fetchInit.signal, controller)\n    : controller.signal\n\n  try {\n    return await fetch(url, { ...fetchInit, signal })\n  } finally {\n    clearTimeout(timeoutId)\n  }\n}\n\n/**\n * Fetch and parse JSON response. Throws on non-ok status.\n */\nexport async function fetchJson<T>(url: string, init?: FetchOptions): Promise<T> {\n  const res = await fetchWithTimeout(url, init)\n  if (!res.ok) {\n    throw new Error(`HTTP ${res.status}: ${res.statusText}`)\n  }\n  return (await res.json()) as T\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,kBACd,cACA,YACa;AACb,KAAI,OAAO,YAAY,QAAQ,WAC7B,QAAO,YAAY,IAAI,CAAC,cAAc,WAAW,OAAO,CAAC;AAG3D,KAAI,aAAa,SAAS;AACxB,aAAW,MAAM,aAAa,OAAO;AACrC,SAAO,WAAW;;CAEpB,MAAM,qBAAqB,WAAW,MAAM,aAAa,OAAO;AAChE,cAAa,iBAAiB,SAAS,cAAc,EAAE,MAAM,MAAM,CAAC;AAEpE,YAAW,OAAO,iBAChB,eACM;AACJ,eAAa,oBAAoB,SAAS,aAAa;IAEzD,EAAE,MAAM,MAAM,CACf;AACD,QAAO,WAAW;;;;;AAWpB,eAAsB,iBAAiB,KAAa,MAAwC;CAC1F,MAAM,EAAE,YAAY,4BAA4B,GAAG,cAAc,QAAQ,EAAE;CAC3E,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,UAAU;CAGjE,MAAM,SAAS,UAAU,SACrB,kBAAkB,UAAU,QAAQ,WAAW,GAC/C,WAAW;AAEf,KAAI;AACF,SAAO,MAAM,MAAM,KAAK;GAAE,GAAG;GAAW;GAAQ,CAAC;WACzC;AACR,eAAa,UAAU;;;;;;AAO3B,eAAsB,UAAa,KAAa,MAAiC;CAC/E,MAAM,MAAM,MAAM,iBAAiB,KAAK,KAAK;AAC7C,KAAI,CAAC,IAAI,GACP,OAAM,IAAI,MAAM,QAAQ,IAAI,OAAO,IAAI,IAAI,aAAa;AAE1D,QAAQ,MAAM,IAAI,MAAM"}

package/dist/fungible-asset-aHBTYpoT.mjs

@@ -0,0 +1,64 @@
+import { t as Message } from "./types-CSS5rfW1.mjs";
+import { r as jsonStringifyArg } from "./json-CGak0DqP.mjs";
+import { n as MsgExecuteJSONSchema } from "./tx_pb-DYspoJTt.mjs";
+//#region src/token/fungible-asset.ts
+/**
+* Create a Move Fungible Asset TokenContract adapter.
+*
+* @param moveClient - Move query client
+* @param metadataAddress - Metadata object address identifying the token
+*/
+function createFungibleAssetToken(moveClient, metadataAddress) {
+	async function viewJSON(moduleName, functionName, args, typeArgs = []) {
+		const response = await moveClient.viewJSON({
+			address: "0x1",
+			moduleName,
+			functionName,
+			typeArgs,
+			args: args.map(jsonStringifyArg)
+		});
+		try {
+			return JSON.parse(response.data);
+		} catch {
+			throw new Error(`Failed to parse Move view response for ${moduleName}::${functionName}: ${response.data}`);
+		}
+	}
+	return {
+		async getInfo() {
+			const [name, symbol, decimals, supply] = await Promise.all([
+				viewJSON("fungible_asset", "name", [metadataAddress]),
+				viewJSON("fungible_asset", "symbol", [metadataAddress]),
+				viewJSON("fungible_asset", "decimals", [metadataAddress]),
+				viewJSON("fungible_asset", "supply", [metadataAddress])
+			]);
+			return {
+				name,
+				symbol,
+				decimals: Number(decimals),
+				totalSupply: supply != null ? BigInt(supply) : void 0
+			};
+		},
+		async balanceOf(owner) {
+			const result = await viewJSON("primary_fungible_store", "balance", [owner, metadataAddress]);
+			return BigInt(result);
+		},
+		createTransferMsg(sender, to, amount) {
+			return new Message(MsgExecuteJSONSchema, {
+				sender,
+				moduleAddress: "0x1",
+				moduleName: "primary_fungible_store",
+				functionName: "transfer",
+				typeArgs: [],
+				args: [
+					JSON.stringify(metadataAddress),
+					JSON.stringify(to),
+					JSON.stringify(amount.toString())
+				]
+			});
+		}
+	};
+}
+//#endregion
+export { createFungibleAssetToken as t };
+
+//# sourceMappingURL=fungible-asset-aHBTYpoT.mjs.map

package/dist/fungible-asset-aHBTYpoT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fungible-asset-aHBTYpoT.mjs","names":[],"sources":["../src/token/fungible-asset.ts"],"sourcesContent":["/**\n * Move Fungible Asset Token Contract Adapter.\n *\n * Implements TokenContract interface for Move-based chains (initia, minimove)\n * using the Initia fungible_asset and primary_fungible_store modules.\n */\n\nimport type { Numeric } from '../types'\nimport { jsonStringifyArg } from '../util/json'\nimport type { Client as ConnectClient } from '@connectrpc/connect'\nimport { MsgExecuteJSONSchema } from '@buf/initia-labs_initia.bufbuild_es/initia/move/v1/tx_pb'\nimport type { Query as MoveQuery } from '@buf/initia-labs_initia.bufbuild_es/initia/move/v1/query_pb'\n\nimport type { TokenInfo } from '../contracts/types'\nimport { Message } from '../msgs/types'\nimport type { TokenContract } from './types'\n\ntype MoveClient = ConnectClient<typeof MoveQuery>\n\n/**\n * Create a Move Fungible Asset TokenContract adapter.\n *\n * @param moveClient - Move query client\n * @param metadataAddress - Metadata object address identifying the token\n */\nexport function createFungibleAssetToken(\n  moveClient: MoveClient,\n  metadataAddress: string\n): TokenContract {\n  async function viewJSON(\n    moduleName: string,\n    functionName: string,\n    args: unknown[],\n    typeArgs: string[] = []\n  ): Promise<unknown> {\n    const response = await moveClient.viewJSON({\n      address: '0x1',\n      moduleName,\n      functionName,\n      typeArgs,\n      args: args.map(jsonStringifyArg),\n    })\n\n    try {\n      return JSON.parse(response.data)\n    } catch {\n      throw new Error(\n        `Failed to parse Move view response for ${moduleName}::${functionName}: ${response.data}`\n      )\n    }\n  }\n\n  return {\n    async getInfo(): Promise<TokenInfo> {\n      const [name, symbol, decimals, supply] = await Promise.all([\n        viewJSON('fungible_asset', 'name', [metadataAddress]),\n        viewJSON('fungible_asset', 'symbol', [metadataAddress]),\n        viewJSON('fungible_asset', 'decimals', [metadataAddress]),\n        viewJSON('fungible_asset', 'supply', [metadataAddress]),\n      ])\n\n      return {\n        name: name as string,\n        symbol: symbol as string,\n        decimals: Number(decimals),\n        totalSupply: supply != null ? BigInt(supply as string) : undefined,\n      }\n    },\n\n    async balanceOf(owner: string): Promise<bigint> {\n      const result = await viewJSON('primary_fungible_store', 'balance', [owner, metadataAddress])\n      return BigInt(result as string)\n    },\n\n    createTransferMsg(sender: string, to: string, amount: Numeric): Message {\n      return new Message(MsgExecuteJSONSchema, {\n        sender,\n        moduleAddress: '0x1',\n        moduleName: 'primary_fungible_store',\n        functionName: 'transfer',\n        typeArgs: [],\n        args: [\n          JSON.stringify(metadataAddress),\n          JSON.stringify(to),\n          JSON.stringify(amount.toString()),\n        ],\n      })\n    },\n\n    // Move fungible_asset does not have allowance/approve concept\n  }\n}\n"],"mappings":";;;;;;;;;;AAyBA,SAAgB,yBACd,YACA,iBACe;CACf,eAAe,SACb,YACA,cACA,MACA,WAAqB,EAAE,EACL;EAClB,MAAM,WAAW,MAAM,WAAW,SAAS;GACzC,SAAS;GACT;GACA;GACA;GACA,MAAM,KAAK,IAAI,iBAAiB;GACjC,CAAC;AAEF,MAAI;AACF,UAAO,KAAK,MAAM,SAAS,KAAK;UAC1B;AACN,SAAM,IAAI,MACR,0CAA0C,WAAW,IAAI,aAAa,IAAI,SAAS,OACpF;;;AAIL,QAAO;EACL,MAAM,UAA8B;GAClC,MAAM,CAAC,MAAM,QAAQ,UAAU,UAAU,MAAM,QAAQ,IAAI;IACzD,SAAS,kBAAkB,QAAQ,CAAC,gBAAgB,CAAC;IACrD,SAAS,kBAAkB,UAAU,CAAC,gBAAgB,CAAC;IACvD,SAAS,kBAAkB,YAAY,CAAC,gBAAgB,CAAC;IACzD,SAAS,kBAAkB,UAAU,CAAC,gBAAgB,CAAC;IACxD,CAAC;AAEF,UAAO;IACC;IACE;IACR,UAAU,OAAO,SAAS;IAC1B,aAAa,UAAU,OAAO,OAAO,OAAiB,GAAG,KAAA;IAC1D;;EAGH,MAAM,UAAU,OAAgC;GAC9C,MAAM,SAAS,MAAM,SAAS,0BAA0B,WAAW,CAAC,OAAO,gBAAgB,CAAC;AAC5F,UAAO,OAAO,OAAiB;;EAGjC,kBAAkB,QAAgB,IAAY,QAA0B;AACtE,UAAO,IAAI,QAAQ,sBAAsB;IACvC;IACA,eAAe;IACf,YAAY;IACZ,cAAc;IACd,UAAU,EAAE;IACZ,MAAM;KACJ,KAAK,UAAU,gBAAgB;KAC/B,KAAK,UAAU,GAAG;KAClB,KAAK,UAAU,OAAO,UAAU,CAAC;KAClC;IACF,CAAC;;EAIL"}

package/dist/get-tx-0P40z_A4.mjs

@@ -0,0 +1,99 @@
+import { c as InitiaError } from "./errors-CN1MFOLv.mjs";
+import { Code, ConnectError } from "@connectrpc/connect";
+//#region src/tx/get-tx.ts
+/** Create a Map-based ABI registry with lowercase key normalization. */
+function createAbiRegistry() {
+	const map = /* @__PURE__ */ new Map();
+	return {
+		get: (key) => map.get(key.toLowerCase()),
+		set: (key, abi) => map.set(key.toLowerCase(), abi),
+		has: (key) => map.has(key.toLowerCase())
+	};
+}
+/** No-op registry for chain types without ABI (wasm, other). */
+function createNoopAbiRegistry() {
+	return {
+		get: () => void 0,
+		set: () => {},
+		has: () => false
+	};
+}
+/** Thrown when a transaction is not found on-chain. */
+var TxNotFoundError = class extends InitiaError {
+	constructor(hash) {
+		super(`Transaction not found: ${hash}`);
+		this.hash = hash;
+		this.name = "TxNotFoundError";
+	}
+};
+async function getTx(client, decode, hash, enrichers, options) {
+	let normalizedOptions = options;
+	if (options?.abis) {
+		const normalized = {};
+		for (const [key, abi] of Object.entries(options.abis)) normalized[key.toLowerCase()] = abi;
+		normalizedOptions = {
+			...options,
+			abis: normalized
+		};
+	}
+	let response;
+	try {
+		response = await client.tx.getTx({ hash });
+	} catch (err) {
+		if (err instanceof ConnectError && err.code === Code.NotFound) throw new TxNotFoundError(hash);
+		throw err;
+	}
+	if (!response.txResponse) throw new InitiaError(`Malformed tx response: missing txResponse for hash ${hash}`);
+	const txResponse = response.txResponse;
+	if (!response.tx?.body) throw new InitiaError(`Malformed tx response: missing tx body for hash ${hash}`);
+	const messages = response.tx.body.messages.map((packed) => {
+		try {
+			return {
+				typeUrl: packed.typeUrl,
+				message: decode(packed)
+			};
+		} catch (err) {
+			if (normalizedOptions?.decodeArgs === "strict") throw err;
+			return {
+				typeUrl: packed.typeUrl,
+				message: packed,
+				decodeError: true
+			};
+		}
+	});
+	if (normalizedOptions?.decodeArgs !== "none") await Promise.all(messages.map(async (msg) => {
+		if (msg.decodeError) return;
+		for (const enricher of enrichers) {
+			if (!enricher.canEnrich(msg.typeUrl)) continue;
+			try {
+				await enricher.enrich(msg, normalizedOptions ?? {});
+			} catch (err) {
+				if (normalizedOptions?.decodeArgs === "strict") throw err;
+				msg.enrichError = err instanceof Error ? err.message : String(err);
+			}
+			break;
+		}
+	}));
+	return {
+		raw: response,
+		messages,
+		txHash: txResponse.txhash,
+		code: txResponse.code,
+		height: txResponse.height,
+		gasUsed: txResponse.gasUsed,
+		gasWanted: txResponse.gasWanted,
+		rawLog: txResponse.rawLog,
+		timestamp: txResponse.timestamp,
+		events: txResponse.events.map((e) => ({
+			type: e.type,
+			attributes: e.attributes.map((a) => ({
+				key: a.key,
+				value: a.value
+			}))
+		}))
+	};
+}
+//#endregion
+export { getTx as i, createAbiRegistry as n, createNoopAbiRegistry as r, TxNotFoundError as t };
+
+//# sourceMappingURL=get-tx-0P40z_A4.mjs.map

package/dist/get-tx-0P40z_A4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tx-0P40z_A4.mjs","names":[],"sources":["../src/tx/get-tx.ts"],"sourcesContent":["/**\n * Transaction decoding with VM-aware argument enrichment.\n *\n * Provides types and utilities for fetching on-chain transactions and\n * decoding their messages with VM-specific enrichment (Move BCS, EVM ABI, Wasm JSON).\n */\n\nimport type { Abi } from 'abitype'\nimport type { GetTxResponse } from '@buf/cosmos_cosmos-sdk.bufbuild_es/cosmos/tx/v1beta1/service_pb'\nimport type { Any } from '@bufbuild/protobuf/wkt'\nimport { ConnectError, Code } from '@connectrpc/connect'\nimport { InitiaError } from '../errors'\nimport type { Message } from '../msgs/types'\nimport type { ChainType } from '../client/types'\nimport type { MoveModuleAbi } from '../contracts/move/types'\n\n// =============================================================================\n// Decoded tx types\n// =============================================================================\n\nexport interface DecodedTxMessage {\n  /** Message typeUrl (e.g., '/cosmos.bank.v1beta1.MsgSend') */\n  typeUrl: string\n  /** Decoded protobuf message */\n  message: Message\n  /**\n   * True if protobuf decode failed (best-effort mode only).\n   * When true, `message` wraps the raw Any — typeUrl is still set from the Any.\n   * Enrichment is skipped for decode-failed messages.\n   */\n  decodeError?: boolean\n  /**\n   * Enrichment error description (best-effort mode only).\n   * Set when ABI fetch, BCS/ABI decode, or JSON parse fails during enrichment.\n   * When set, `args`/`contractMsg` may be undefined even for VM messages.\n   * Note: For Move messages, `functionName` is extracted before enrichment and remains valid.\n   * For EVM messages, `functionName` may be undefined if ABI decode failed.\n   */\n  enrichError?: string\n  /**\n   * Function name for VM calls. undefined for non-VM messages.\n   * - Move MsgExecute: function name (e.g., 'set_price')\n   * - EVM MsgCall with ABI: decoded name (e.g., 'transfer')\n   * - EVM MsgCall without ABI: 4-byte selector hex (e.g., '0xa9059cbb')\n   * - Wasm: undefined (use contractMsg instead)\n   */\n  functionName?: string\n  /**\n   * Decoded arguments. undefined for non-VM messages or when ABI unavailable.\n   * - Move MsgExecute: BCS-decoded args (via on-chain ABI)\n   * - EVM MsgCall: ABI-decoded args (via registered or one-time ABI)\n   * - Wasm: undefined (use contractMsg instead)\n   *\n   * **Move ABI version caveat**: On-chain ABI reflects the *current* module version.\n   * If a module was upgraded after this tx was submitted, the ABI may not match the\n   * args that were encoded against the old version — decode may silently produce\n   * incorrect values or fail. Use `ctx.abis.set('addr::module', historicalAbi)` or\n   * `options.abis` to provide the correct ABI for historical transactions.\n   */\n  args?: unknown[]\n  /**\n   * Named arguments mapped from ABI parameter names. undefined when:\n   * - No ABI available (EVM without registered/one-time ABI)\n   * - ABI has unnamed parameters\n   * - Function takes no arguments (zero-input ABI functions)\n   * - Non-EVM messages (Move ABI lacks param names; Wasm uses contractMsg)\n   *\n   * Currently populated for EVM MsgCall only.\n   * @example { to: '0x1234...', amount: 100n }\n   */\n  namedArgs?: Record<string, unknown>\n  /**\n   * Parsed JSON msg body. undefined for non-Wasm messages.\n   * Set for: MsgExecuteContract, MsgInstantiateContract,\n   * MsgInstantiateContract2, MsgMigrateContract\n   */\n  contractMsg?: unknown\n  /**\n   * Reserved for future: recursively decoded inner messages.\n   * For wrapper messages like MsgExec, MsgSubmitProposal, MsgExecuteMessages.\n   * Currently undefined — inner Any[] messages are not auto-decoded (Decision #64).\n   */\n  innerMessages?: DecodedTxMessage[]\n}\n\nexport interface DecodedTx {\n  /** Original gRPC response (all Cosmos SDK fields accessible) */\n  raw: GetTxResponse\n  /** Decoded messages with VM-aware enrichment */\n  messages: DecodedTxMessage[]\n\n  // ---- Convenience fields (extracted from raw.txResponse) ----\n\n  /** Transaction hash */\n  txHash: string\n  /** Result code. 0 = success, non-zero = failure */\n  code: number\n  /** Block height where tx was included */\n  height: bigint\n  /** Gas consumed */\n  gasUsed: bigint\n  /** Gas requested */\n  gasWanted: bigint\n  /** Raw log (error message on failure, empty on success) */\n  rawLog: string\n  /** Block timestamp when tx was included (ISO 8601, e.g. '2026-03-08T12:00:00Z') */\n  timestamp: string\n  /** Parsed events from the transaction */\n  events: Array<{\n    type: string\n    attributes: Array<{ key: string; value: string }>\n  }>\n}\n\n// =============================================================================\n// Options\n// =============================================================================\n\nexport interface GetTxOptions {\n  /**\n   * Arg decoding strategy.\n   * - 'best-effort' (default): decode when ABI available, undefined otherwise\n   * - 'strict': throw if ABI fetch or decode fails for VM messages\n   * - 'none': protobuf decode only — skip all VM enrichment (no ABI fetch, no arg decode)\n   */\n  decodeArgs?: 'best-effort' | 'strict' | 'none'\n  /**\n   * One-time ABIs for this call. Merged with ctx.abis registry.\n   * Keys are contract/module identifiers (case-insensitive).\n   * Value type is `unknown` at base level — narrowed by GetTxOptionsFor<T>.\n   */\n  abis?: Record<string, unknown>\n}\n\n/** ChainType-aware GetTxOptions — abis value type matches AbiValueFor<T>. */\nexport type GetTxOptionsFor<T extends ChainType> = Omit<GetTxOptions, 'abis'> & {\n  abis?: Record<string, AbiValueFor<T>>\n}\n\n// =============================================================================\n// Enricher interface\n// =============================================================================\n\n/**\n * Enricher that adds VM-specific decoded data to a DecodedTxMessage.\n * Each VM (Move, EVM, Wasm) provides its own enricher implementation.\n * Enrichers capture their dependencies via closure at creation time.\n */\nexport interface MessageEnricher {\n  /** Check if this enricher handles the given typeUrl */\n  canEnrich(typeUrl: string): boolean\n  /** Enrich the message with VM-specific data (functionName, args, contractMsg) */\n  enrich(msg: DecodedTxMessage, options: GetTxOptions): Promise<void>\n}\n\n// =============================================================================\n// ABI Registry\n// =============================================================================\n\n/**\n * ChainType-parameterized ABI registry (Decision #72).\n * - minievm: key = contract address, value = Abi (abitype)\n * - initia/minimove: key = 'addr::module', value = MoveModuleAbi\n * - miniwasm/other: no-op (set is ignored, get always returns undefined)\n *\n * Concurrency note: set() is guaranteed to take effect for subsequent getTx() calls.\n * ABIs set during an in-progress getTx() may or may not be used by that call.\n */\nexport interface AbiRegistry<V = unknown> {\n  get(key: string): V | undefined\n  set(key: string, abi: V): void\n  has(key: string): boolean\n}\n\n// Type mapping: ChainType → ABI value type\ntype AbiValueFor<T extends ChainType> = T extends 'minievm'\n  ? Abi\n  : T extends 'initia' | 'minimove'\n    ? MoveModuleAbi\n    : never\n\n/** Typed ABI registry for a specific chain type. */\nexport type AbiRegistryFor<T extends ChainType> = AbiRegistry<AbiValueFor<T>>\n\n/** Create a Map-based ABI registry with lowercase key normalization. */\nexport function createAbiRegistry<V>(): AbiRegistry<V> {\n  const map = new Map<string, V>()\n  return {\n    get: (key: string) => map.get(key.toLowerCase()),\n    set: (key: string, abi: V) => map.set(key.toLowerCase(), abi),\n    has: (key: string) => map.has(key.toLowerCase()),\n  }\n}\n\n/** No-op registry for chain types without ABI (wasm, other). */\nexport function createNoopAbiRegistry<V = never>(): AbiRegistry<V> {\n  return {\n    get: () => undefined,\n    set: () => {},\n    has: () => false,\n  }\n}\n\n// =============================================================================\n// TxNotFoundError\n// =============================================================================\n\n/** Thrown when a transaction is not found on-chain. */\nexport class TxNotFoundError extends InitiaError {\n  constructor(public readonly hash: string) {\n    super(`Transaction not found: ${hash}`)\n    this.name = 'TxNotFoundError'\n  }\n}\n\n// =============================================================================\n// getTx core\n// =============================================================================\n\n/** Minimal client interface for tx queries. */\ninterface TxQueryClient {\n  tx: { getTx(req: { hash: string }): Promise<GetTxResponse> }\n}\n\nexport async function getTx(\n  client: TxQueryClient,\n  decode: (packed: Any) => Message,\n  hash: string,\n  enrichers: MessageEnricher[],\n  options?: GetTxOptions\n): Promise<DecodedTx> {\n  // Normalize abis keys to lowercase (Decision #68)\n  let normalizedOptions = options\n  if (options?.abis) {\n    const normalized: Record<string, unknown> = {}\n    for (const [key, abi] of Object.entries(options.abis)) {\n      normalized[key.toLowerCase()] = abi\n    }\n    normalizedOptions = { ...options, abis: normalized }\n  }\n\n  let response: GetTxResponse\n  try {\n    response = await client.tx.getTx({ hash })\n  } catch (err) {\n    // Only wrap NOT_FOUND — network/auth/invalid-hash errors propagate as-is (Decision #69)\n    if (err instanceof ConnectError && err.code === Code.NotFound) {\n      throw new TxNotFoundError(hash)\n    }\n    throw err\n  }\n\n  if (!response.txResponse) {\n    throw new InitiaError(`Malformed tx response: missing txResponse for hash ${hash}`)\n  }\n  const txResponse = response.txResponse\n  if (!response.tx?.body) {\n    throw new InitiaError(`Malformed tx response: missing tx body for hash ${hash}`)\n  }\n  const anyMessages: Any[] = response.tx.body.messages\n\n  // Step 1: Decode each Any into DecodedTxMessage\n  const messages: DecodedTxMessage[] = anyMessages.map(packed => {\n    try {\n      return { typeUrl: packed.typeUrl, message: decode(packed) }\n    } catch (err) {\n      if (normalizedOptions?.decodeArgs === 'strict') throw err\n      // Best-effort: wrap raw Any, mark as decode failure (Decision #73)\n      return { typeUrl: packed.typeUrl, message: packed as unknown as Message, decodeError: true }\n    }\n  })\n\n  // Step 2: Enrich in parallel (skip entirely when decodeArgs: 'none') (Decision #84)\n  if (normalizedOptions?.decodeArgs !== 'none') {\n    await Promise.all(\n      messages.map(async msg => {\n        if (msg.decodeError) return // Skip enrichment for decode-failed messages\n        for (const enricher of enrichers) {\n          if (!enricher.canEnrich(msg.typeUrl)) continue\n          try {\n            await enricher.enrich(msg, normalizedOptions ?? {})\n          } catch (err) {\n            if (normalizedOptions?.decodeArgs === 'strict') throw err\n            // Best-effort: leave functionName/args/contractMsg undefined, record error\n            msg.enrichError = err instanceof Error ? err.message : String(err)\n          }\n          break // First matching enricher handles the message\n        }\n      })\n    )\n  }\n\n  // Step 3: Assemble DecodedTx with convenience fields (Decision #78)\n  return {\n    raw: response,\n    messages,\n    txHash: txResponse.txhash,\n    code: txResponse.code,\n    height: txResponse.height,\n    gasUsed: txResponse.gasUsed,\n    gasWanted: txResponse.gasWanted,\n    rawLog: txResponse.rawLog,\n    timestamp: txResponse.timestamp,\n    events: txResponse.events.map(e => ({\n      type: e.type,\n      attributes: e.attributes.map(a => ({ key: a.key, value: a.value })),\n    })),\n  }\n}\n"],"mappings":";;;;AAyLA,SAAgB,oBAAuC;CACrD,MAAM,sBAAM,IAAI,KAAgB;AAChC,QAAO;EACL,MAAM,QAAgB,IAAI,IAAI,IAAI,aAAa,CAAC;EAChD,MAAM,KAAa,QAAW,IAAI,IAAI,IAAI,aAAa,EAAE,IAAI;EAC7D,MAAM,QAAgB,IAAI,IAAI,IAAI,aAAa,CAAC;EACjD;;;AAIH,SAAgB,wBAAmD;AACjE,QAAO;EACL,WAAW,KAAA;EACX,WAAW;EACX,WAAW;EACZ;;;AAQH,IAAa,kBAAb,cAAqC,YAAY;CAC/C,YAAY,MAA8B;AACxC,QAAM,0BAA0B,OAAO;AADb,OAAA,OAAA;AAE1B,OAAK,OAAO;;;AAahB,eAAsB,MACpB,QACA,QACA,MACA,WACA,SACoB;CAEpB,IAAI,oBAAoB;AACxB,KAAI,SAAS,MAAM;EACjB,MAAM,aAAsC,EAAE;AAC9C,OAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,QAAQ,KAAK,CACnD,YAAW,IAAI,aAAa,IAAI;AAElC,sBAAoB;GAAE,GAAG;GAAS,MAAM;GAAY;;CAGtD,IAAI;AACJ,KAAI;AACF,aAAW,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;UACnC,KAAK;AAEZ,MAAI,eAAe,gBAAgB,IAAI,SAAS,KAAK,SACnD,OAAM,IAAI,gBAAgB,KAAK;AAEjC,QAAM;;AAGR,KAAI,CAAC,SAAS,WACZ,OAAM,IAAI,YAAY,sDAAsD,OAAO;CAErF,MAAM,aAAa,SAAS;AAC5B,KAAI,CAAC,SAAS,IAAI,KAChB,OAAM,IAAI,YAAY,mDAAmD,OAAO;CAKlF,MAAM,WAHqB,SAAS,GAAG,KAAK,SAGK,KAAI,WAAU;AAC7D,MAAI;AACF,UAAO;IAAE,SAAS,OAAO;IAAS,SAAS,OAAO,OAAO;IAAE;WACpD,KAAK;AACZ,OAAI,mBAAmB,eAAe,SAAU,OAAM;AAEtD,UAAO;IAAE,SAAS,OAAO;IAAS,SAAS;IAA8B,aAAa;IAAM;;GAE9F;AAGF,KAAI,mBAAmB,eAAe,OACpC,OAAM,QAAQ,IACZ,SAAS,IAAI,OAAM,QAAO;AACxB,MAAI,IAAI,YAAa;AACrB,OAAK,MAAM,YAAY,WAAW;AAChC,OAAI,CAAC,SAAS,UAAU,IAAI,QAAQ,CAAE;AACtC,OAAI;AACF,UAAM,SAAS,OAAO,KAAK,qBAAqB,EAAE,CAAC;YAC5C,KAAK;AACZ,QAAI,mBAAmB,eAAe,SAAU,OAAM;AAEtD,QAAI,cAAc,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;AAEpE;;GAEF,CACH;AAIH,QAAO;EACL,KAAK;EACL;EACA,QAAQ,WAAW;EACnB,MAAM,WAAW;EACjB,QAAQ,WAAW;EACnB,SAAS,WAAW;EACpB,WAAW,WAAW;EACtB,QAAQ,WAAW;EACnB,WAAW,WAAW;EACtB,QAAQ,WAAW,OAAO,KAAI,OAAM;GAClC,MAAM,EAAE;GACR,YAAY,EAAE,WAAW,KAAI,OAAM;IAAE,KAAK,EAAE;IAAK,OAAO,EAAE;IAAO,EAAE;GACpE,EAAE;EACJ"}