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

package/dist/entry.wasm.mjs

@@ -0,0 +1,600 @@
+import { o as ContractError } from "./errors-CN1MFOLv.mjs";
+import { t as Message$1, u as toProtoCoins } from "./types-CSS5rfW1.mjs";
+import { c as tryDecodeBech32 } from "./address-DwAkzgJk.mjs";
+import { a as MsgInstantiateContractSchema, c as MsgUpdateAdminSchema, i as MsgInstantiateContract2Schema, n as MsgClearAdminSchema, o as MsgMigrateContractSchema, r as MsgExecuteContractSchema, s as MsgStoreCodeSchema } from "./tx_pb-u3CoQYge.mjs";
+import { n as encodeMsg, t as decodeResponse } from "./json-CGak0DqP.mjs";
+import { t as createCw20Token } from "./cw20-BTpdgMXC.mjs";
+import { i as wasmAbi } from "./abi-helpers-DdwdqhMQ.mjs";
+import { n as parseUnits, t as formatUnits } from "./utils-B2carKSi.mjs";
+import { create } from "@bufbuild/protobuf";
+//#region src/contracts/wasm/contract.ts
+/**
+* Validates that a contract address is in valid bech32 format.
+* @throws Error if address format is invalid
+*/
+function validateContractAddress(address) {
+	if (!tryDecodeBech32(address)) throw new Error(`Invalid contract address: ${address}. Expected bech32 format.`);
+}
+function createWasmContract(context, contractAddress, schemaOrOptions) {
+	const options = schemaOrOptions != null && !("schema" in schemaOrOptions) && ("execute" in schemaOrOptions || "query" in schemaOrOptions) ? { schema: schemaOrOptions } : schemaOrOptions ?? {};
+	validateContractAddress(contractAddress);
+	const wasmClient = context.client.wasm;
+	const { schema } = options;
+	let cachedDecimals;
+	function getSchemaVariants(msgSchema) {
+		const variants = msgSchema?.oneOf ?? msgSchema?.anyOf;
+		if (!variants) return void 0;
+		const names = /* @__PURE__ */ new Set();
+		for (const v of variants) if (v.required && v.required.length === 1) names.add(v.required[0]);
+		return names.size > 0 ? names : void 0;
+	}
+	const executeVariants = getSchemaVariants(schema?.execute);
+	const queryVariants = getSchemaVariants(schema?.query);
+	function validateVariant(variant, variants, proxyName) {
+		if (variants && !variants.has(variant)) throw new ContractError("wasm", 0, `Unknown ${proxyName} variant: "${variant}". Available: ${[...variants].join(", ")}`);
+	}
+	const execute = new Proxy({}, { get(_, variant) {
+		return (sender, args, funds) => {
+			validateVariant(variant, executeVariants, "execute");
+			return new Message$1(MsgExecuteContractSchema, {
+				sender,
+				contract: contractAddress,
+				msg: encodeMsg(args !== void 0 ? { [variant]: args } : { [variant]: {} }),
+				funds: toProtoCoins(funds)
+			});
+		};
+	} });
+	const query = new Proxy({}, { get(_, variant) {
+		return async (args) => {
+			validateVariant(variant, queryVariants, "query");
+			const msg = args !== void 0 ? { [variant]: args } : { [variant]: {} };
+			return decodeResponse((await wasmClient.smartContractState({
+				address: contractAddress,
+				queryData: encodeMsg(msg)
+			})).data);
+		};
+	} });
+	function executeRaw(sender, msg, funds) {
+		return create(MsgExecuteContractSchema, {
+			sender,
+			contract: contractAddress,
+			msg: encodeMsg(msg),
+			funds: toProtoCoins(funds)
+		});
+	}
+	async function queryRaw(msg) {
+		return decodeResponse((await wasmClient.smartContractState({
+			address: contractAddress,
+			queryData: encodeMsg(msg)
+		})).data);
+	}
+	async function getContractInfo() {
+		const response = await wasmClient.contractInfo({ address: contractAddress });
+		if (!response.contractInfo) throw new ContractError("wasm", 0, `Contract info not found: ${contractAddress}`);
+		return response.contractInfo;
+	}
+	async function getRawState(key) {
+		const keyBytes = typeof key === "string" ? new TextEncoder().encode(key) : key;
+		return (await wasmClient.rawContractState({
+			address: contractAddress,
+			queryData: keyBytes
+		})).data;
+	}
+	async function getTokenInfo() {
+		const info = await queryRaw({ token_info: {} });
+		cachedDecimals = info.decimals;
+		return {
+			name: info.name,
+			symbol: info.symbol,
+			decimals: info.decimals,
+			totalSupply: info.total_supply ? BigInt(info.total_supply) : void 0
+		};
+	}
+	async function getDecimals() {
+		if (cachedDecimals !== void 0) return cachedDecimals;
+		return (await getTokenInfo()).decimals;
+	}
+	async function getNftInfo(tokenId) {
+		const info = await queryRaw({ nft_info: { token_id: tokenId } });
+		return {
+			tokenUri: info.token_uri,
+			extension: info.extension
+		};
+	}
+	async function getOwnerOf(tokenId) {
+		const result = await queryRaw({ owner_of: { token_id: tokenId } });
+		return {
+			owner: result.owner,
+			approvals: result.approvals.map((a) => ({
+				spender: a.spender,
+				expires: a.expires ? {
+					atHeight: a.expires.at_height ? BigInt(a.expires.at_height) : void 0,
+					atTime: a.expires.at_time ? BigInt(a.expires.at_time) : void 0,
+					never: a.expires.never !== void 0 ? true : void 0
+				} : void 0
+			}))
+		};
+	}
+	async function getTokens(owner, startAfter, limit) {
+		return (await queryRaw({ tokens: {
+			owner,
+			start_after: startAfter,
+			limit: limit ?? 30
+		} })).tokens;
+	}
+	return {
+		contractAddress,
+		schema,
+		execute,
+		query,
+		executeRaw,
+		queryRaw,
+		getContractInfo,
+		getRawState,
+		getTokenInfo,
+		async parseUnits(value) {
+			return parseUnits(value, await getDecimals());
+		},
+		async formatUnits(value) {
+			return formatUnits(value, await getDecimals());
+		},
+		getNftInfo,
+		getOwnerOf,
+		getTokens
+	};
+}
+/**
+* Creates a MsgStoreCode for uploading wasm bytecode.
+*
+* @param options - Store code options
+* @returns MsgStoreCode message for signing
+*
+* @example
+* ```typescript
+* const msg = createStoreCodeMsg({
+*   sender: 'cosmos1...',
+*   wasmByteCode: compiledWasm,
+* })
+* await wallet.signAndBroadcast([msg])
+* ```
+*/
+function createStoreCodeMsg(options) {
+	return create(MsgStoreCodeSchema, {
+		sender: options.sender,
+		wasmByteCode: options.wasmByteCode,
+		instantiatePermission: options.instantiatePermission
+	});
+}
+/**
+* Creates a MsgInstantiateContract for instantiating a contract.
+*
+* @param options - Instantiate options
+* @returns MsgInstantiateContract message for signing
+*
+* @example
+* ```typescript
+* const msg = createInstantiateMsg({
+*   sender: 'cosmos1...',
+*   codeId: 1,
+*   msg: { name: 'My Token', symbol: 'MTK', decimals: 6 },
+*   label: 'my-token-v1',
+*   admin: 'cosmos1...',
+* })
+* await wallet.signAndBroadcast([msg])
+* ```
+*/
+function createInstantiateMsg(options) {
+	return create(MsgInstantiateContractSchema, {
+		sender: options.sender,
+		admin: options.admin ?? "",
+		codeId: BigInt(options.codeId),
+		label: options.label,
+		msg: encodeMsg(options.msg),
+		funds: toProtoCoins(options.funds)
+	});
+}
+/**
+* Creates a MsgInstantiateContract2 for instantiating with predictable address.
+*
+* @param options - Instantiate2 options
+* @returns MsgInstantiateContract2 message for signing
+*
+* @example
+* ```typescript
+* const msg = createInstantiate2Msg({
+*   sender: 'cosmos1...',
+*   codeId: 1,
+*   msg: { name: 'My Token' },
+*   label: 'my-token-v1',
+*   salt: new TextEncoder().encode('my-salt'),
+* })
+* ```
+*/
+function createInstantiate2Msg(options) {
+	return create(MsgInstantiateContract2Schema, {
+		sender: options.sender,
+		admin: options.admin ?? "",
+		codeId: BigInt(options.codeId),
+		label: options.label,
+		msg: encodeMsg(options.msg),
+		funds: toProtoCoins(options.funds),
+		salt: options.salt,
+		fixMsg: options.fixMsg ?? false
+	});
+}
+/**
+* Creates a MsgExecuteContract directly.
+*
+* @param sender - Sender address
+* @param contract - Contract address
+* @param msg - Execute message
+* @param funds - Optional funds
+* @returns MsgExecuteContract message for signing
+*
+* @example
+* ```typescript
+* const msg = createWasmExecuteMsg(
+*   'cosmos1...',
+*   'cosmos1contract...',
+*   { transfer: { recipient: 'cosmos1...', amount: '1000000' } }
+* )
+* ```
+*/
+function createWasmExecuteMsg(sender, contract, msg, funds) {
+	return create(MsgExecuteContractSchema, {
+		sender,
+		contract,
+		msg: encodeMsg(msg),
+		funds: toProtoCoins(funds)
+	});
+}
+/**
+* Creates a MsgMigrateContract for migrating to new code.
+*
+* @param options - Migrate options
+* @returns MsgMigrateContract message for signing
+*
+* @example
+* ```typescript
+* const msg = createMigrateMsg({
+*   sender: 'cosmos1...',
+*   contract: 'cosmos1contract...',
+*   codeId: 2,
+*   msg: {},
+* })
+* ```
+*/
+function createMigrateMsg(options) {
+	return create(MsgMigrateContractSchema, {
+		sender: options.sender,
+		contract: options.contract,
+		codeId: BigInt(options.codeId),
+		msg: encodeMsg(options.msg)
+	});
+}
+/**
+* Creates a MsgUpdateAdmin for changing contract admin.
+*
+* @param options - Update admin options
+* @returns MsgUpdateAdmin message for signing
+*
+* @example
+* ```typescript
+* const msg = createUpdateAdminMsg({
+*   sender: 'cosmos1admin...',
+*   contract: 'cosmos1contract...',
+*   newAdmin: 'cosmos1newadmin...',
+* })
+* ```
+*/
+function createUpdateAdminMsg(options) {
+	return create(MsgUpdateAdminSchema, {
+		sender: options.sender,
+		contract: options.contract,
+		newAdmin: options.newAdmin
+	});
+}
+/**
+* Creates a MsgClearAdmin for removing contract admin.
+*
+* @param options - Clear admin options
+* @returns MsgClearAdmin message for signing
+*
+* @example
+* ```typescript
+* const msg = createClearAdminMsg({
+*   sender: 'cosmos1admin...',
+*   contract: 'cosmos1contract...',
+* })
+* ```
+*/
+function createClearAdminMsg(options) {
+	return create(MsgClearAdminSchema, {
+		sender: options.sender,
+		contract: options.contract
+	});
+}
+/**
+* Queries a smart contract directly.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param contractAddress - Contract address
+* @param queryMsg - Query message
+* @returns Query result
+*
+* @example
+* ```typescript
+* const balance = await queryContract(
+*   ctx,
+*   'cosmos1contract...',
+*   { balance: { address: 'cosmos1...' } }
+* )
+* ```
+*/
+async function queryContract(context, contractAddress, queryMsg) {
+	return decodeResponse((await context.client.wasm.smartContractState({
+		address: contractAddress,
+		queryData: encodeMsg(queryMsg)
+	})).data);
+}
+/**
+* Gets contract information.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param contractAddress - Contract address
+* @returns Contract info
+*
+* @example
+* ```typescript
+* const info = await getContractInfo(ctx, contractAddress)
+* ```
+*/
+async function getContractInfo(context, contractAddress) {
+	const response = await context.client.wasm.contractInfo({ address: contractAddress });
+	if (!response.contractInfo) throw new ContractError("wasm", 0, `Contract info not found: ${contractAddress}`);
+	return response.contractInfo;
+}
+/**
+* Gets raw contract state by key.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param contractAddress - Contract address
+* @param key - State key
+* @returns Raw state value
+*
+* @example
+* ```typescript
+* const state = await getRawContractState(ctx, contractAddress, 'config')
+* ```
+*/
+async function getRawContractState(context, contractAddress, key) {
+	const wasmClient = context.client.wasm;
+	const keyBytes = typeof key === "string" ? new TextEncoder().encode(key) : key;
+	return (await wasmClient.rawContractState({
+		address: contractAddress,
+		queryData: keyBytes
+	})).data;
+}
+/**
+* Gets code information.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param codeId - Code ID
+* @returns Code info
+*
+* @example
+* ```typescript
+* const codeInfo = await getCodeInfo(ctx, 1n)
+* ```
+*/
+async function getCodeInfo(context, codeId) {
+	const response = await context.client.wasm.code({ codeId: BigInt(codeId) });
+	if (!response.codeInfo) throw new ContractError("wasm", 0, `Code not found: ${codeId}`);
+	return {
+		codeInfo: response.codeInfo,
+		data: response.data
+	};
+}
+/**
+* Lists all contracts by code ID.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param codeId - Code ID
+* @returns List of contract addresses
+*
+* @example
+* ```typescript
+* const contracts = await getContractsByCode(ctx, 1n)
+* ```
+*/
+async function getContractsByCode(context, codeId) {
+	return (await context.client.wasm.contractsByCode({ codeId: BigInt(codeId) })).contracts;
+}
+/**
+* Gets contract code migration history.
+*
+* @param context - ChainContext with client (must have wasm service)
+* @param contractAddress - Contract address
+* @returns List of code history entries (migrations)
+*
+* @example
+* ```typescript
+* const history = await getContractHistory(ctx, 'cosmos1contract...')
+* for (const entry of history) {
+*   console.log(`Code ID: ${entry.codeId}, Operation: ${entry.operation}`)
+* }
+* ```
+*/
+async function getContractHistory(context, contractAddress) {
+	return (await context.client.wasm.contractHistory({ address: contractAddress })).entries;
+}
+//#endregion
+//#region src/contracts/wasm/schema.ts
+/**
+* Extracts message variant names from a JSON schema.
+* CosmWasm messages typically use oneOf with single-property objects.
+*
+* @param schema - JSON schema for the message type
+* @returns Array of variant names
+*
+* @example
+* ```typescript
+* const executeVariants = getSchemaVariants(schema.execute)
+* // ['transfer', 'approve', 'mint', 'burn']
+* ```
+*/
+function getSchemaVariants(schema) {
+	if (!schema) return [];
+	if (schema.oneOf) return schema.oneOf.flatMap((variant) => {
+		if (variant.properties) return Object.keys(variant.properties);
+		if (variant.required) return variant.required;
+		return [];
+	});
+	if (schema.anyOf) return schema.anyOf.flatMap((variant) => {
+		if (variant.properties) return Object.keys(variant.properties);
+		return [];
+	});
+	if (schema.properties) return Object.keys(schema.properties);
+	return [];
+}
+/**
+* Gets the schema for a specific message variant.
+*
+* @param schema - JSON schema for the message type
+* @param variant - Variant name to look up
+* @returns Schema for the variant's arguments, or undefined
+*/
+function getVariantSchema(schema, variant) {
+	if (!schema) return void 0;
+	if (schema.oneOf) {
+		for (const variantSchema of schema.oneOf) if (variantSchema.properties?.[variant]) return variantSchema.properties[variant];
+	}
+	if (schema.anyOf) {
+		for (const variantSchema of schema.anyOf) if (variantSchema.properties?.[variant]) return variantSchema.properties[variant];
+	}
+	if (schema.properties?.[variant]) return schema.properties[variant];
+}
+/**
+* Validates that a message has exactly one variant key.
+* This is a basic structural validation for CosmWasm messages.
+*
+* @param msg - Message to validate
+* @returns Validation result with variant name if valid
+*/
+function validateMessageStructure(msg) {
+	const keys = Object.keys(msg);
+	if (keys.length === 0) return {
+		valid: false,
+		error: "Message must have at least one variant key"
+	};
+	if (keys.length > 1) return {
+		valid: false,
+		error: "Message must have exactly one variant key"
+	};
+	return {
+		valid: true,
+		variant: keys[0]
+	};
+}
+/**
+* Validates an execute message against a schema (basic check).
+*
+* @param msg - Execute message to validate
+* @param schema - Contract schema
+* @returns Validation result
+*/
+function validateExecuteMsg(msg, schema) {
+	const structureResult = validateMessageStructure(msg);
+	if (!structureResult.valid) return structureResult;
+	if (!schema.execute) return { valid: true };
+	const variants = getSchemaVariants(schema.execute);
+	if (variants.length > 0 && !variants.includes(structureResult.variant)) return {
+		valid: false,
+		error: `Unknown execute variant: ${structureResult.variant}. Available: ${variants.join(", ")}`
+	};
+	return { valid: true };
+}
+/**
+* Validates a query message against a schema (basic check).
+*
+* @param msg - Query message to validate
+* @param schema - Contract schema
+* @returns Validation result
+*/
+function validateQueryMsg(msg, schema) {
+	const structureResult = validateMessageStructure(msg);
+	if (!structureResult.valid) return structureResult;
+	if (!schema.query) return { valid: true };
+	const variants = getSchemaVariants(schema.query);
+	if (variants.length > 0 && !variants.includes(structureResult.variant)) return {
+		valid: false,
+		error: `Unknown query variant: ${structureResult.variant}. Available: ${variants.join(", ")}`
+	};
+	return { valid: true };
+}
+/**
+* Gets information about a contract schema.
+*
+* @param schema - Contract schema
+* @returns Schema information
+*/
+function getSchemaInfo(schema) {
+	return {
+		name: schema.contract_name,
+		version: schema.contract_version,
+		executeVariants: getSchemaVariants(schema.execute),
+		queryVariants: getSchemaVariants(schema.query),
+		hasInstantiate: !!schema.instantiate,
+		hasMigrate: !!schema.migrate,
+		hasSudo: !!schema.sudo
+	};
+}
+/**
+* Gets the response schema for a query variant.
+*
+* @param schema - Contract schema
+* @param queryVariant - Query variant name
+* @returns Response schema, or undefined
+*/
+function getResponseSchema(schema, queryVariant) {
+	if (!schema.responses) return void 0;
+	if (schema.responses[queryVariant]) return schema.responses[queryVariant];
+	const responseKey = `${queryVariant}_response`;
+	if (schema.responses[responseKey]) return schema.responses[responseKey];
+	const pascalResponseKey = `${queryVariant.charAt(0).toUpperCase() + queryVariant.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}Response`;
+	if (schema.responses[pascalResponseKey]) return schema.responses[pascalResponseKey];
+}
+/**
+* Infers a basic TypeScript type string from a JSON schema.
+* This is a simplified inference for documentation purposes.
+*
+* @param schema - JSON schema
+* @returns TypeScript type string
+*/
+function inferTypeFromSchema(schema) {
+	if (!schema) return "unknown";
+	if (typeof schema.type === "string") switch (schema.type) {
+		case "string": return "string";
+		case "number":
+		case "integer": return "number";
+		case "boolean": return "boolean";
+		case "null": return "null";
+		case "array":
+			if (schema.items) return `${inferTypeFromSchema(Array.isArray(schema.items) ? schema.items[0] : schema.items)}[]`;
+			return "unknown[]";
+		case "object":
+			if (schema.properties) return `{ ${Object.entries(schema.properties).map(([key, propSchema]) => {
+				return `${key}${!schema.required?.includes(key) ? "?" : ""}: ${inferTypeFromSchema(propSchema)}`;
+			}).join("; ")} }`;
+			return "Record<string, unknown>";
+	}
+	if (schema.oneOf) return schema.oneOf.map(inferTypeFromSchema).join(" | ");
+	if (schema.anyOf) return schema.anyOf.map(inferTypeFromSchema).join(" | ");
+	if (schema.const !== void 0) return typeof schema.const === "string" ? `'${schema.const}'` : typeof schema.const === "object" ? JSON.stringify(schema.const) : String(schema.const);
+	if (schema.enum) return schema.enum.map((v) => typeof v === "string" ? `'${v}'` : String(v)).join(" | ");
+	return "unknown";
+}
+//#endregion
+export { createClearAdminMsg, createCw20Token, createInstantiate2Msg, createInstantiateMsg, createMigrateMsg, createStoreCodeMsg, createUpdateAdminMsg, createWasmContract, createWasmExecuteMsg, getCodeInfo, getContractHistory, getContractInfo, getContractsByCode, getRawContractState, getResponseSchema, getSchemaInfo, getSchemaVariants, getVariantSchema, inferTypeFromSchema, queryContract, validateExecuteMsg, validateMessageStructure, validateQueryMsg, wasmAbi };
+
+//# sourceMappingURL=entry.wasm.mjs.map

package/dist/entry.wasm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.wasm.mjs","names":["Message"],"sources":["../src/contracts/wasm/contract.ts","../src/contracts/wasm/schema.ts"],"sourcesContent":["/**\n * CosmWasm Contract Factory and Helpers\n *\n * Provides CosmWasm contract interactions via gRPC.\n * Supports execute, query, store, instantiate, migrate, and admin operations.\n */\n\nimport type { Numeric } from '../../types'\nimport type { Client } from '@connectrpc/connect'\nimport { create } from '@bufbuild/protobuf'\nimport type { Query as WasmQuery } from '@buf/cosmwasm_wasmd.bufbuild_es/cosmwasm/wasm/v1/query_pb'\nimport {\n  MsgStoreCodeSchema,\n  MsgInstantiateContractSchema,\n  MsgInstantiateContract2Schema,\n  MsgExecuteContractSchema,\n  MsgMigrateContractSchema,\n  MsgUpdateAdminSchema,\n  MsgClearAdminSchema,\n  type MsgStoreCode,\n  type MsgInstantiateContract,\n  type MsgInstantiateContract2,\n  type MsgExecuteContract,\n  type MsgMigrateContract,\n  type MsgUpdateAdmin,\n  type MsgClearAdmin,\n} from '@buf/cosmwasm_wasmd.bufbuild_es/cosmwasm/wasm/v1/tx_pb'\n\nimport { Message } from '../../msgs/types'\nimport { toProtoCoins } from '../../msgs/types'\nimport type { HasWasmService } from '../../client/types'\nimport type { Coin } from '../../core/coin'\nimport type { TokenInfo, NftInfo, OwnerOfResponse, NftApproval } from '../types'\nimport { parseUnits, formatUnits } from '../utils'\nimport { ContractError } from '../errors'\nimport { encodeMsg, decodeResponse } from '../../util/json'\nimport { tryDecodeBech32 } from '../../util/address'\n\nimport type {\n  WasmContract,\n  WasmContractSchema,\n  JsonSchema,\n  WasmExecuteProxy,\n  WasmQueryProxy,\n  ExecuteMsg,\n  QueryMsg,\n  StoreCodeOptions,\n  InstantiateContractOptions,\n  InstantiateContract2Options,\n  MigrateContractOptions,\n  UpdateAdminOptions,\n  ClearAdminOptions,\n  ReadonlyWasmContractSchema,\n  TypedWasmContract,\n} from './types'\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Wasm gRPC query client type.\n */\nexport type WasmQueryClient = Client<typeof WasmQuery>\n\n/**\n * Options for creating a Wasm contract instance.\n */\nexport interface CreateWasmContractOptions {\n  /** Optional JSON schema for validation */\n  schema?: WasmContractSchema\n}\n\n// =============================================================================\n// Utility Functions\n// =============================================================================\n\n// =============================================================================\n// Address Validation\n// =============================================================================\n\n/**\n * Validates that a contract address is in valid bech32 format.\n * @throws Error if address format is invalid\n */\nfunction validateContractAddress(address: string): void {\n  if (!tryDecodeBech32(address)) {\n    throw new Error(`Invalid contract address: ${address}. ` + `Expected bech32 format.`)\n  }\n}\n\n// =============================================================================\n// Contract Factory\n// =============================================================================\n\n/**\n * Creates a typed CosmWasm contract from a static schema.\n * Returns synchronously with variant-name autocomplete on execute/query.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address (bech32)\n * @param schema - Static schema (use `wasmAbi()` or `as const satisfies ReadonlyWasmContractSchema`)\n * @returns Typed wasm contract with IDE autocomplete for variant names\n *\n * @example\n * ```typescript\n * const schema = wasmAbi({\n *   execute: { oneOf: [{ required: ['transfer'], properties: { transfer: {} } }] },\n *   query: { oneOf: [{ required: ['balance'], properties: { balance: {} } }] },\n * })\n *\n * const cw20 = createWasmContract(ctx, 'cosmos1...', schema)\n * cw20.execute.transfer(sender, { recipient: '...', amount: '1000' })  // autocomplete!\n * ```\n */\nexport function createWasmContract<const T extends ReadonlyWasmContractSchema>(\n  context: HasWasmService,\n  contractAddress: string,\n  schema: T\n): TypedWasmContract<T>\n\n/**\n * Creates a CosmWasm contract instance for type-safe interactions.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address (bech32)\n * @param options - Contract options (schema)\n * @returns Wasm contract instance\n *\n * @example\n * ```typescript\n * import { createWasmContract } from 'initia.js'\n *\n * const cw20 = createWasmContract(ctx, 'cosmos1...')\n *\n * // Execute transfer\n * const msg = cw20.execute.transfer(sender, {\n *   recipient: 'cosmos1...',\n *   amount: '1000000'\n * })\n * await ctx.signAndBroadcast([msg])\n *\n * // Query balance\n * const balance = await cw20.query.balance({ address: 'cosmos1...' })\n * ```\n */\nexport function createWasmContract(\n  context: HasWasmService,\n  contractAddress: string,\n  options?: CreateWasmContractOptions\n): WasmContract\n\nexport function createWasmContract<T extends ReadonlyWasmContractSchema>(\n  context: HasWasmService,\n  contractAddress: string,\n  schemaOrOptions?: T | CreateWasmContractOptions\n): TypedWasmContract<T> | WasmContract {\n  // Distinguish static schema (has oneOf/anyOf in execute/query) from options (has schema key)\n  const isStaticSchema =\n    schemaOrOptions != null &&\n    !('schema' in schemaOrOptions) &&\n    ('execute' in schemaOrOptions || 'query' in schemaOrOptions)\n\n  const options: CreateWasmContractOptions = isStaticSchema\n    ? { schema: schemaOrOptions as unknown as WasmContractSchema }\n    : ((schemaOrOptions as CreateWasmContractOptions) ?? {})\n\n  // Validate address format\n  validateContractAddress(contractAddress)\n\n  const wasmClient = context.client.wasm\n  const { schema } = options\n  // Cache for decimals (used by parseUnits/formatUnits)\n  let cachedDecimals: number | undefined\n\n  // Extract variant names from a JSON schema's oneOf/anyOf array.\n  // Returns undefined if the schema structure doesn't support variant extraction.\n  function getSchemaVariants(msgSchema?: JsonSchema): Set<string> | undefined {\n    const variants = msgSchema?.oneOf ?? msgSchema?.anyOf\n    if (!variants) return undefined\n\n    const names = new Set<string>()\n    for (const v of variants) {\n      if (v.required && v.required.length === 1) {\n        names.add(v.required[0])\n      }\n    }\n    return names.size > 0 ? names : undefined\n  }\n\n  // Pre-compute variant sets from schema (if available)\n  const executeVariants = getSchemaVariants(schema?.execute)\n  const queryVariants = getSchemaVariants(schema?.query)\n\n  // Validate variant name against schema if available\n  function validateVariant(\n    variant: string,\n    variants: Set<string> | undefined,\n    proxyName: string\n  ): void {\n    if (variants && !variants.has(variant)) {\n      throw new ContractError(\n        'wasm',\n        0,\n        `Unknown ${proxyName} variant: \"${variant}\". Available: ${[...variants].join(', ')}`\n      )\n    }\n  }\n\n  // Create execute proxy\n  const execute = new Proxy({} as WasmExecuteProxy, {\n    get(_, variant: string) {\n      return (\n        sender: string,\n        args?: Record<string, unknown>,\n        funds?: Coin[]\n      ): Message<typeof MsgExecuteContractSchema> => {\n        validateVariant(variant, executeVariants, 'execute')\n\n        // Build message with variant as key\n        const msg: ExecuteMsg = args !== undefined ? { [variant]: args } : { [variant]: {} }\n\n        return new Message(MsgExecuteContractSchema, {\n          sender,\n          contract: contractAddress,\n          msg: encodeMsg(msg),\n          funds: toProtoCoins(funds),\n        })\n      }\n    },\n  })\n\n  // Create query proxy\n  const query = new Proxy({} as WasmQueryProxy, {\n    get(_, variant: string) {\n      return async (args?: Record<string, unknown>): Promise<unknown> => {\n        validateVariant(variant, queryVariants, 'query')\n\n        // Build query with variant as key\n        const msg: QueryMsg = args !== undefined ? { [variant]: args } : { [variant]: {} }\n\n        const response = await wasmClient.smartContractState({\n          address: contractAddress,\n          queryData: encodeMsg(msg),\n        })\n\n        return decodeResponse(response.data)\n      }\n    },\n  })\n\n  // Execute raw message\n  function executeRaw(sender: string, msg: ExecuteMsg, funds?: Coin[]): MsgExecuteContract {\n    return create(MsgExecuteContractSchema, {\n      sender,\n      contract: contractAddress,\n      msg: encodeMsg(msg),\n      funds: toProtoCoins(funds),\n    })\n  }\n\n  // Query raw message\n  async function queryRaw(msg: QueryMsg): Promise<unknown> {\n    const response = await wasmClient.smartContractState({\n      address: contractAddress,\n      queryData: encodeMsg(msg),\n    })\n    return decodeResponse(response.data)\n  }\n\n  // Get contract info\n  async function getContractInfo() {\n    const response = await wasmClient.contractInfo({\n      address: contractAddress,\n    })\n\n    if (!response.contractInfo) {\n      throw new ContractError('wasm', 0, `Contract info not found: ${contractAddress}`)\n    }\n\n    return response.contractInfo\n  }\n\n  // Get raw state\n  async function getRawState(key: string | Uint8Array): Promise<Uint8Array> {\n    const keyBytes = typeof key === 'string' ? new TextEncoder().encode(key) : key\n\n    const response = await wasmClient.rawContractState({\n      address: contractAddress,\n      queryData: keyBytes,\n    })\n\n    return response.data\n  }\n\n  // Get token info (CW20 convenience method)\n  async function getTokenInfo(): Promise<TokenInfo> {\n    const info = (await queryRaw({ token_info: {} })) as {\n      name: string\n      symbol: string\n      decimals: number\n      total_supply?: string\n    }\n\n    // Cache decimals\n    cachedDecimals = info.decimals\n\n    return {\n      name: info.name,\n      symbol: info.symbol,\n      decimals: info.decimals,\n      totalSupply: info.total_supply ? BigInt(info.total_supply) : undefined,\n    }\n  }\n\n  // Get decimals (with caching)\n  async function getDecimals(): Promise<number> {\n    if (cachedDecimals !== undefined) {\n      return cachedDecimals\n    }\n    const info = await getTokenInfo()\n    return info.decimals\n  }\n\n  // Get NFT info (CW721 convenience method)\n  async function getNftInfo(tokenId: string): Promise<NftInfo> {\n    const info = (await queryRaw({ nft_info: { token_id: tokenId } })) as {\n      token_uri?: string\n      extension?: unknown\n    }\n\n    return {\n      tokenUri: info.token_uri,\n      extension: info.extension,\n    }\n  }\n\n  // Get owner of NFT (CW721 convenience method)\n  async function getOwnerOf(tokenId: string): Promise<OwnerOfResponse> {\n    const result = (await queryRaw({ owner_of: { token_id: tokenId } })) as {\n      owner: string\n      approvals: Array<{\n        spender: string\n        expires?: {\n          at_height?: number\n          at_time?: string\n          never?: Record<string, never>\n        }\n      }>\n    }\n\n    return {\n      owner: result.owner,\n      approvals: result.approvals.map(\n        (a): NftApproval => ({\n          spender: a.spender,\n          expires: a.expires\n            ? {\n                atHeight: a.expires.at_height ? BigInt(a.expires.at_height) : undefined,\n                atTime: a.expires.at_time ? BigInt(a.expires.at_time) : undefined,\n                never: a.expires.never !== undefined ? true : undefined,\n              }\n            : undefined,\n        })\n      ),\n    }\n  }\n\n  // Get tokens owned by address (CW721 convenience method)\n  async function getTokens(owner: string, startAfter?: string, limit?: number): Promise<string[]> {\n    const result = (await queryRaw({\n      tokens: {\n        owner,\n        start_after: startAfter,\n        limit: limit ?? 30,\n      },\n    })) as { tokens: string[] }\n\n    return result.tokens\n  }\n\n  return {\n    contractAddress,\n    schema,\n    execute,\n    query,\n    executeRaw,\n    queryRaw,\n    getContractInfo,\n    getRawState,\n    getTokenInfo,\n\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    getNftInfo,\n    getOwnerOf,\n    getTokens,\n  }\n}\n\n// =============================================================================\n// Message Creators\n// =============================================================================\n\n/**\n * Creates a MsgStoreCode for uploading wasm bytecode.\n *\n * @param options - Store code options\n * @returns MsgStoreCode message for signing\n *\n * @example\n * ```typescript\n * const msg = createStoreCodeMsg({\n *   sender: 'cosmos1...',\n *   wasmByteCode: compiledWasm,\n * })\n * await wallet.signAndBroadcast([msg])\n * ```\n */\nexport function createStoreCodeMsg(options: StoreCodeOptions): MsgStoreCode {\n  return create(MsgStoreCodeSchema, {\n    sender: options.sender,\n    wasmByteCode: options.wasmByteCode,\n    instantiatePermission: options.instantiatePermission,\n  })\n}\n\n/**\n * Creates a MsgInstantiateContract for instantiating a contract.\n *\n * @param options - Instantiate options\n * @returns MsgInstantiateContract message for signing\n *\n * @example\n * ```typescript\n * const msg = createInstantiateMsg({\n *   sender: 'cosmos1...',\n *   codeId: 1,\n *   msg: { name: 'My Token', symbol: 'MTK', decimals: 6 },\n *   label: 'my-token-v1',\n *   admin: 'cosmos1...',\n * })\n * await wallet.signAndBroadcast([msg])\n * ```\n */\nexport function createInstantiateMsg(options: InstantiateContractOptions): MsgInstantiateContract {\n  return create(MsgInstantiateContractSchema, {\n    sender: options.sender,\n    admin: options.admin ?? '',\n    codeId: BigInt(options.codeId),\n    label: options.label,\n    msg: encodeMsg(options.msg),\n    funds: toProtoCoins(options.funds),\n  })\n}\n\n/**\n * Creates a MsgInstantiateContract2 for instantiating with predictable address.\n *\n * @param options - Instantiate2 options\n * @returns MsgInstantiateContract2 message for signing\n *\n * @example\n * ```typescript\n * const msg = createInstantiate2Msg({\n *   sender: 'cosmos1...',\n *   codeId: 1,\n *   msg: { name: 'My Token' },\n *   label: 'my-token-v1',\n *   salt: new TextEncoder().encode('my-salt'),\n * })\n * ```\n */\nexport function createInstantiate2Msg(\n  options: InstantiateContract2Options\n): MsgInstantiateContract2 {\n  return create(MsgInstantiateContract2Schema, {\n    sender: options.sender,\n    admin: options.admin ?? '',\n    codeId: BigInt(options.codeId),\n    label: options.label,\n    msg: encodeMsg(options.msg),\n    funds: toProtoCoins(options.funds),\n    salt: options.salt,\n    fixMsg: options.fixMsg ?? false,\n  })\n}\n\n/**\n * Creates a MsgExecuteContract directly.\n *\n * @param sender - Sender address\n * @param contract - Contract address\n * @param msg - Execute message\n * @param funds - Optional funds\n * @returns MsgExecuteContract message for signing\n *\n * @example\n * ```typescript\n * const msg = createWasmExecuteMsg(\n *   'cosmos1...',\n *   'cosmos1contract...',\n *   { transfer: { recipient: 'cosmos1...', amount: '1000000' } }\n * )\n * ```\n */\nexport function createWasmExecuteMsg(\n  sender: string,\n  contract: string,\n  msg: ExecuteMsg,\n  funds?: Coin[]\n): MsgExecuteContract {\n  return create(MsgExecuteContractSchema, {\n    sender,\n    contract,\n    msg: encodeMsg(msg),\n    funds: toProtoCoins(funds),\n  })\n}\n\n/**\n * Creates a MsgMigrateContract for migrating to new code.\n *\n * @param options - Migrate options\n * @returns MsgMigrateContract message for signing\n *\n * @example\n * ```typescript\n * const msg = createMigrateMsg({\n *   sender: 'cosmos1...',\n *   contract: 'cosmos1contract...',\n *   codeId: 2,\n *   msg: {},\n * })\n * ```\n */\nexport function createMigrateMsg(options: MigrateContractOptions): MsgMigrateContract {\n  return create(MsgMigrateContractSchema, {\n    sender: options.sender,\n    contract: options.contract,\n    codeId: BigInt(options.codeId),\n    msg: encodeMsg(options.msg),\n  })\n}\n\n/**\n * Creates a MsgUpdateAdmin for changing contract admin.\n *\n * @param options - Update admin options\n * @returns MsgUpdateAdmin message for signing\n *\n * @example\n * ```typescript\n * const msg = createUpdateAdminMsg({\n *   sender: 'cosmos1admin...',\n *   contract: 'cosmos1contract...',\n *   newAdmin: 'cosmos1newadmin...',\n * })\n * ```\n */\nexport function createUpdateAdminMsg(options: UpdateAdminOptions): MsgUpdateAdmin {\n  return create(MsgUpdateAdminSchema, {\n    sender: options.sender,\n    contract: options.contract,\n    newAdmin: options.newAdmin,\n  })\n}\n\n/**\n * Creates a MsgClearAdmin for removing contract admin.\n *\n * @param options - Clear admin options\n * @returns MsgClearAdmin message for signing\n *\n * @example\n * ```typescript\n * const msg = createClearAdminMsg({\n *   sender: 'cosmos1admin...',\n *   contract: 'cosmos1contract...',\n * })\n * ```\n */\nexport function createClearAdminMsg(options: ClearAdminOptions): MsgClearAdmin {\n  return create(MsgClearAdminSchema, {\n    sender: options.sender,\n    contract: options.contract,\n  })\n}\n\n// =============================================================================\n// Query Functions\n// =============================================================================\n\n/**\n * Queries a smart contract directly.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address\n * @param queryMsg - Query message\n * @returns Query result\n *\n * @example\n * ```typescript\n * const balance = await queryContract(\n *   ctx,\n *   'cosmos1contract...',\n *   { balance: { address: 'cosmos1...' } }\n * )\n * ```\n */\nexport async function queryContract(\n  context: HasWasmService,\n  contractAddress: string,\n  queryMsg: QueryMsg\n): Promise<unknown> {\n  const wasmClient = context.client.wasm\n  const response = await wasmClient.smartContractState({\n    address: contractAddress,\n    queryData: encodeMsg(queryMsg),\n  })\n\n  return decodeResponse(response.data)\n}\n\n/**\n * Gets contract information.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address\n * @returns Contract info\n *\n * @example\n * ```typescript\n * const info = await getContractInfo(ctx, contractAddress)\n * ```\n */\nexport async function getContractInfo(context: HasWasmService, contractAddress: string) {\n  const wasmClient = context.client.wasm\n  const response = await wasmClient.contractInfo({\n    address: contractAddress,\n  })\n\n  if (!response.contractInfo) {\n    throw new ContractError('wasm', 0, `Contract info not found: ${contractAddress}`)\n  }\n\n  return response.contractInfo\n}\n\n/**\n * Gets raw contract state by key.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address\n * @param key - State key\n * @returns Raw state value\n *\n * @example\n * ```typescript\n * const state = await getRawContractState(ctx, contractAddress, 'config')\n * ```\n */\nexport async function getRawContractState(\n  context: HasWasmService,\n  contractAddress: string,\n  key: string | Uint8Array\n): Promise<Uint8Array> {\n  const wasmClient = context.client.wasm\n  const keyBytes = typeof key === 'string' ? new TextEncoder().encode(key) : key\n\n  const response = await wasmClient.rawContractState({\n    address: contractAddress,\n    queryData: keyBytes,\n  })\n\n  return response.data\n}\n\n/**\n * Gets code information.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param codeId - Code ID\n * @returns Code info\n *\n * @example\n * ```typescript\n * const codeInfo = await getCodeInfo(ctx, 1n)\n * ```\n */\nexport async function getCodeInfo(context: HasWasmService, codeId: Numeric) {\n  const wasmClient = context.client.wasm\n  const response = await wasmClient.code({\n    codeId: BigInt(codeId),\n  })\n\n  if (!response.codeInfo) {\n    throw new ContractError('wasm', 0, `Code not found: ${codeId}`)\n  }\n\n  return {\n    codeInfo: response.codeInfo,\n    data: response.data,\n  }\n}\n\n/**\n * Lists all contracts by code ID.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param codeId - Code ID\n * @returns List of contract addresses\n *\n * @example\n * ```typescript\n * const contracts = await getContractsByCode(ctx, 1n)\n * ```\n */\nexport async function getContractsByCode(\n  context: HasWasmService,\n  codeId: Numeric\n): Promise<string[]> {\n  const wasmClient = context.client.wasm\n  const response = await wasmClient.contractsByCode({\n    codeId: BigInt(codeId),\n  })\n\n  return response.contracts\n}\n\n/**\n * Gets contract code migration history.\n *\n * @param context - ChainContext with client (must have wasm service)\n * @param contractAddress - Contract address\n * @returns List of code history entries (migrations)\n *\n * @example\n * ```typescript\n * const history = await getContractHistory(ctx, 'cosmos1contract...')\n * for (const entry of history) {\n *   console.log(`Code ID: ${entry.codeId}, Operation: ${entry.operation}`)\n * }\n * ```\n */\nexport async function getContractHistory(context: HasWasmService, contractAddress: string) {\n  const wasmClient = context.client.wasm\n  const response = await wasmClient.contractHistory({\n    address: contractAddress,\n  })\n\n  return response.entries\n}\n","/**\n * CosmWasm JSON Schema Utilities\n *\n * Provides utilities for working with CosmWasm contract schemas.\n * Note: Full JSON schema validation would require a library like ajv.\n * This module provides basic schema inspection and variant extraction.\n */\n\nimport type { JsonSchema, WasmContractSchema, ExecuteMsg, QueryMsg } from './types'\n\n// =============================================================================\n// Schema Inspection\n// =============================================================================\n\n/**\n * Extracts message variant names from a JSON schema.\n * CosmWasm messages typically use oneOf with single-property objects.\n *\n * @param schema - JSON schema for the message type\n * @returns Array of variant names\n *\n * @example\n * ```typescript\n * const executeVariants = getSchemaVariants(schema.execute)\n * // ['transfer', 'approve', 'mint', 'burn']\n * ```\n */\nexport function getSchemaVariants(schema: JsonSchema | undefined): string[] {\n  if (!schema) return []\n\n  // Handle oneOf (most common for CosmWasm messages)\n  if (schema.oneOf) {\n    return schema.oneOf.flatMap(variant => {\n      if (variant.properties) {\n        return Object.keys(variant.properties)\n      }\n      if (variant.required) {\n        return variant.required\n      }\n      return []\n    })\n  }\n\n  // Handle anyOf\n  if (schema.anyOf) {\n    return schema.anyOf.flatMap(variant => {\n      if (variant.properties) {\n        return Object.keys(variant.properties)\n      }\n      return []\n    })\n  }\n\n  // Handle direct properties (less common)\n  if (schema.properties) {\n    return Object.keys(schema.properties)\n  }\n\n  return []\n}\n\n/**\n * Gets the schema for a specific message variant.\n *\n * @param schema - JSON schema for the message type\n * @param variant - Variant name to look up\n * @returns Schema for the variant's arguments, or undefined\n */\nexport function getVariantSchema(\n  schema: JsonSchema | undefined,\n  variant: string\n): JsonSchema | undefined {\n  if (!schema) return undefined\n\n  // Handle oneOf\n  if (schema.oneOf) {\n    for (const variantSchema of schema.oneOf) {\n      if (variantSchema.properties?.[variant]) {\n        return variantSchema.properties[variant]\n      }\n    }\n  }\n\n  // Handle anyOf\n  if (schema.anyOf) {\n    for (const variantSchema of schema.anyOf) {\n      if (variantSchema.properties?.[variant]) {\n        return variantSchema.properties[variant]\n      }\n    }\n  }\n\n  // Handle direct properties\n  if (schema.properties?.[variant]) {\n    return schema.properties[variant]\n  }\n\n  return undefined\n}\n\n// =============================================================================\n// Basic Validation\n// =============================================================================\n\n/**\n * Validates that a message has exactly one variant key.\n * This is a basic structural validation for CosmWasm messages.\n *\n * @param msg - Message to validate\n * @returns Validation result with variant name if valid\n */\nexport function validateMessageStructure(msg: ExecuteMsg | QueryMsg): {\n  valid: boolean\n  variant?: string\n  error?: string\n} {\n  const keys = Object.keys(msg)\n\n  if (keys.length === 0) {\n    return { valid: false, error: 'Message must have at least one variant key' }\n  }\n\n  if (keys.length > 1) {\n    return { valid: false, error: 'Message must have exactly one variant key' }\n  }\n\n  return { valid: true, variant: keys[0] }\n}\n\n/**\n * Validates an execute message against a schema (basic check).\n *\n * @param msg - Execute message to validate\n * @param schema - Contract schema\n * @returns Validation result\n */\nexport function validateExecuteMsg(\n  msg: ExecuteMsg,\n  schema: WasmContractSchema\n): { valid: boolean; error?: string } {\n  // First, validate structure\n  const structureResult = validateMessageStructure(msg)\n  if (!structureResult.valid) {\n    return structureResult\n  }\n\n  // Check if schema is available\n  if (!schema.execute) {\n    return { valid: true } // No schema to validate against\n  }\n\n  // Check if variant exists in schema\n  const variants = getSchemaVariants(schema.execute)\n  if (variants.length > 0 && !variants.includes(structureResult.variant!)) {\n    return {\n      valid: false,\n      error: `Unknown execute variant: ${structureResult.variant}. Available: ${variants.join(', ')}`,\n    }\n  }\n\n  return { valid: true }\n}\n\n/**\n * Validates a query message against a schema (basic check).\n *\n * @param msg - Query message to validate\n * @param schema - Contract schema\n * @returns Validation result\n */\nexport function validateQueryMsg(\n  msg: QueryMsg,\n  schema: WasmContractSchema\n): { valid: boolean; error?: string } {\n  // First, validate structure\n  const structureResult = validateMessageStructure(msg)\n  if (!structureResult.valid) {\n    return structureResult\n  }\n\n  // Check if schema is available\n  if (!schema.query) {\n    return { valid: true } // No schema to validate against\n  }\n\n  // Check if variant exists in schema\n  const variants = getSchemaVariants(schema.query)\n  if (variants.length > 0 && !variants.includes(structureResult.variant!)) {\n    return {\n      valid: false,\n      error: `Unknown query variant: ${structureResult.variant}. Available: ${variants.join(', ')}`,\n    }\n  }\n\n  return { valid: true }\n}\n\n// =============================================================================\n// Schema Information\n// =============================================================================\n\n/**\n * Gets information about a contract schema.\n *\n * @param schema - Contract schema\n * @returns Schema information\n */\nexport function getSchemaInfo(schema: WasmContractSchema): {\n  name?: string\n  version?: string\n  executeVariants: string[]\n  queryVariants: string[]\n  hasInstantiate: boolean\n  hasMigrate: boolean\n  hasSudo: boolean\n} {\n  return {\n    name: schema.contract_name,\n    version: schema.contract_version,\n    executeVariants: getSchemaVariants(schema.execute),\n    queryVariants: getSchemaVariants(schema.query),\n    hasInstantiate: !!schema.instantiate,\n    hasMigrate: !!schema.migrate,\n    hasSudo: !!schema.sudo,\n  }\n}\n\n/**\n * Gets the response schema for a query variant.\n *\n * @param schema - Contract schema\n * @param queryVariant - Query variant name\n * @returns Response schema, or undefined\n */\nexport function getResponseSchema(\n  schema: WasmContractSchema,\n  queryVariant: string\n): JsonSchema | undefined {\n  if (!schema.responses) return undefined\n\n  // Try exact match first\n  if (schema.responses[queryVariant]) {\n    return schema.responses[queryVariant]\n  }\n\n  // Try with \"Response\" suffix (common pattern)\n  const responseKey = `${queryVariant}_response`\n  if (schema.responses[responseKey]) {\n    return schema.responses[responseKey]\n  }\n\n  // Try PascalCase with Response suffix\n  const pascalCase =\n    queryVariant.charAt(0).toUpperCase() +\n    queryVariant.slice(1).replace(/_([a-z])/g, (_, c: string) => c.toUpperCase())\n  const pascalResponseKey = `${pascalCase}Response`\n  if (schema.responses[pascalResponseKey]) {\n    return schema.responses[pascalResponseKey]\n  }\n\n  return undefined\n}\n\n// =============================================================================\n// TypeScript Type Inference (Basic)\n// =============================================================================\n\n/**\n * Infers a basic TypeScript type string from a JSON schema.\n * This is a simplified inference for documentation purposes.\n *\n * @param schema - JSON schema\n * @returns TypeScript type string\n */\nexport function inferTypeFromSchema(schema: JsonSchema | undefined): string {\n  if (!schema) return 'unknown'\n\n  // Handle explicit type\n  if (typeof schema.type === 'string') {\n    switch (schema.type) {\n      case 'string':\n        return 'string'\n      case 'number':\n      case 'integer':\n        return 'number'\n      case 'boolean':\n        return 'boolean'\n      case 'null':\n        return 'null'\n      case 'array':\n        if (schema.items) {\n          const itemType = inferTypeFromSchema(\n            Array.isArray(schema.items) ? schema.items[0] : schema.items\n          )\n          return `${itemType}[]`\n        }\n        return 'unknown[]'\n      case 'object':\n        if (schema.properties) {\n          const props = Object.entries(schema.properties)\n            .map(([key, propSchema]) => {\n              const optional = !schema.required?.includes(key)\n              return `${key}${optional ? '?' : ''}: ${inferTypeFromSchema(propSchema)}`\n            })\n            .join('; ')\n          return `{ ${props} }`\n        }\n        return 'Record<string, unknown>'\n    }\n  }\n\n  // Handle oneOf\n  if (schema.oneOf) {\n    return schema.oneOf.map(inferTypeFromSchema).join(' | ')\n  }\n\n  // Handle anyOf\n  if (schema.anyOf) {\n    return schema.anyOf.map(inferTypeFromSchema).join(' | ')\n  }\n\n  // Handle const\n  if (schema.const !== undefined) {\n    return typeof schema.const === 'string'\n      ? `'${schema.const}'`\n      : typeof schema.const === 'object'\n        ? JSON.stringify(schema.const)\n        : String(schema.const as string | number | boolean | bigint)\n  }\n\n  // Handle enum\n  if (schema.enum) {\n    return schema.enum.map(v => (typeof v === 'string' ? `'${v}'` : String(v))).join(' | ')\n  }\n\n  return 'unknown'\n}\n"],"mappings":"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"}