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

package/dist/entry.wasm.d.mts

@@ -0,0 +1,447 @@
+import { $ as StoreCodeOptions, $a as AccessType, B as ClearAdminOptions, G as InstantiateMsg, Ga as MsgInstantiateContract, H as ExtractVariantNames, J as MigrateMsg, Ja as MsgStoreCode, K as JsonSchema, Ka as MsgInstantiateContract2, Q as ReadonlyWasmVariant, Qa as AccessConfig, U as InstantiateContract2Options, Ua as MsgClearAdmin, V as ExecuteMsg, W as InstantiateContractOptions, Wa as MsgExecuteContract, X as ReadonlyWasmContractSchema, Xa as Query, Y as QueryMsg, Ya as MsgUpdateAdmin, Z as ReadonlyWasmMsgSchema, Za as AbsoluteTxPosition, at as WasmContractSchema, ct as WasmQueryProxy, dt as createCw20Token, eo as ContractCodeHistoryEntry, et as TypedWasmContract, it as WasmContractConfig, ls as Numeric, lt as WasmQueryProxyTyped, ms as WrappedResponse, nt as WasmClient, ot as WasmExecuteProxy, q as MigrateContractOptions, qa as MsgMigrateContract, rt as WasmContract, st as WasmExecuteProxyTyped, to as ContractInfo, ts as Coin, tt as UpdateAdminOptions, x as HasWasmService, z as wasmAbi } from "./types-DGrP9Ro_.mjs";
+import * as _$_bufbuild_protobuf0 from "@bufbuild/protobuf";
+import * as _$_bufbuild_protobuf_wkt0 from "@bufbuild/protobuf/wkt";
+import { Client } from "@connectrpc/connect";
+
+//#region src/contracts/wasm/contract.d.ts
+/**
+ * Wasm gRPC query client type.
+ */
+type WasmQueryClient = Client<typeof Query>;
+/**
+ * Options for creating a Wasm contract instance.
+ */
+interface CreateWasmContractOptions {
+  /** Optional JSON schema for validation */
+  schema?: WasmContractSchema;
+}
+/**
+ * Creates a typed CosmWasm contract from a static schema.
+ * Returns synchronously with variant-name autocomplete on execute/query.
+ *
+ * @param context - ChainContext with client (must have wasm service)
+ * @param contractAddress - Contract address (bech32)
+ * @param schema - Static schema (use `wasmAbi()` or `as const satisfies ReadonlyWasmContractSchema`)
+ * @returns Typed wasm contract with IDE autocomplete for variant names
+ *
+ * @example
+ * ```typescript
+ * const schema = wasmAbi({
+ *   execute: { oneOf: [{ required: ['transfer'], properties: { transfer: {} } }] },
+ *   query: { oneOf: [{ required: ['balance'], properties: { balance: {} } }] },
+ * })
+ *
+ * const cw20 = createWasmContract(ctx, 'cosmos1...', schema)
+ * cw20.execute.transfer(sender, { recipient: '...', amount: '1000' })  // autocomplete!
+ * ```
+ */
+declare function createWasmContract<const T extends ReadonlyWasmContractSchema>(context: HasWasmService, contractAddress: string, schema: T): TypedWasmContract<T>;
+/**
+ * Creates a CosmWasm contract instance for type-safe interactions.
+ *
+ * @param context - ChainContext with client (must have wasm service)
+ * @param contractAddress - Contract address (bech32)
+ * @param options - Contract options (schema)
+ * @returns Wasm contract instance
+ *
+ * @example
+ * ```typescript
+ * import { createWasmContract } from 'initia.js'
+ *
+ * const cw20 = createWasmContract(ctx, 'cosmos1...')
+ *
+ * // Execute transfer
+ * const msg = cw20.execute.transfer(sender, {
+ *   recipient: 'cosmos1...',
+ *   amount: '1000000'
+ * })
+ * await ctx.signAndBroadcast([msg])
+ *
+ * // Query balance
+ * const balance = await cw20.query.balance({ address: 'cosmos1...' })
+ * ```
+ */
+declare function createWasmContract(context: HasWasmService, contractAddress: string, options?: CreateWasmContractOptions): WasmContract;
+/**
+ * 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])
+ * ```
+ */
+declare function createStoreCodeMsg(options: StoreCodeOptions): MsgStoreCode;
+/**
+ * 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])
+ * ```
+ */
+declare function createInstantiateMsg(options: InstantiateContractOptions): MsgInstantiateContract;
+/**
+ * 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'),
+ * })
+ * ```
+ */
+declare function createInstantiate2Msg(options: InstantiateContract2Options): MsgInstantiateContract2;
+/**
+ * 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' } }
+ * )
+ * ```
+ */
+declare function createWasmExecuteMsg(sender: string, contract: string, msg: ExecuteMsg, funds?: Coin[]): MsgExecuteContract;
+/**
+ * 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: {},
+ * })
+ * ```
+ */
+declare function createMigrateMsg(options: MigrateContractOptions): MsgMigrateContract;
+/**
+ * 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...',
+ * })
+ * ```
+ */
+declare function createUpdateAdminMsg(options: UpdateAdminOptions): MsgUpdateAdmin;
+/**
+ * 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...',
+ * })
+ * ```
+ */
+declare function createClearAdminMsg(options: ClearAdminOptions): MsgClearAdmin;
+/**
+ * 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...' } }
+ * )
+ * ```
+ */
+declare function queryContract(context: HasWasmService, contractAddress: string, queryMsg: QueryMsg): Promise<unknown>;
+/**
+ * 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)
+ * ```
+ */
+declare function getContractInfo(context: HasWasmService, contractAddress: string): Promise<_$_bufbuild_protobuf0.Message<"cosmwasm.wasm.v1.ContractInfo"> & {
+  codeId: bigint;
+  creator: string;
+  admin: string;
+  label: string;
+  created?: AbsoluteTxPosition;
+  ibcPortId: string;
+  ibc2PortId: string;
+  extension?: _$_bufbuild_protobuf_wkt0.Any;
+} & {
+  readonly schema: _$_bufbuild_protobuf0.DescMessage;
+  readonly typeUrl: string;
+  toJson(options?: Partial<_$_bufbuild_protobuf0.JsonWriteOptions>): _$_bufbuild_protobuf0.JsonValue;
+  toJSON(): _$_bufbuild_protobuf0.JsonValue;
+} & {
+  readonly $typeName: "cosmwasm.wasm.v1.ContractInfo";
+  $unknown?: _$_bufbuild_protobuf0.UnknownField[] | undefined;
+  codeId: bigint;
+  creator: string;
+  admin: string;
+  label: string;
+  created?: (_$_bufbuild_protobuf0.Message<"cosmwasm.wasm.v1.AbsoluteTxPosition"> & {
+    blockHeight: bigint;
+    txIndex: bigint;
+  } & {
+    readonly schema: _$_bufbuild_protobuf0.DescMessage;
+    readonly typeUrl: string;
+    toJson(options?: Partial<_$_bufbuild_protobuf0.JsonWriteOptions>): _$_bufbuild_protobuf0.JsonValue;
+    toJSON(): _$_bufbuild_protobuf0.JsonValue;
+  } & {
+    readonly $typeName: "cosmwasm.wasm.v1.AbsoluteTxPosition";
+    $unknown?: _$_bufbuild_protobuf0.UnknownField[] | undefined;
+    blockHeight: bigint;
+    txIndex: bigint;
+  }) | undefined;
+  ibcPortId: string;
+  ibc2PortId: string;
+  extension?: (_$_bufbuild_protobuf0.Message<"google.protobuf.Any"> & {
+    typeUrl: string;
+    value: Uint8Array;
+  } & {
+    readonly schema: _$_bufbuild_protobuf0.DescMessage;
+    readonly typeUrl: string;
+    toJson(options?: Partial<_$_bufbuild_protobuf0.JsonWriteOptions>): _$_bufbuild_protobuf0.JsonValue;
+    toJSON(): _$_bufbuild_protobuf0.JsonValue;
+  } & {
+    readonly $typeName: "google.protobuf.Any";
+    $unknown?: _$_bufbuild_protobuf0.UnknownField[] | undefined;
+    typeUrl: string;
+    value: Uint8Array;
+  }) | undefined;
+}>;
+/**
+ * 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')
+ * ```
+ */
+declare function getRawContractState(context: HasWasmService, contractAddress: string, key: string | Uint8Array): Promise<Uint8Array>;
+/**
+ * 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)
+ * ```
+ */
+declare function getCodeInfo(context: HasWasmService, codeId: Numeric): Promise<{
+  codeInfo: _$_bufbuild_protobuf0.Message<"cosmwasm.wasm.v1.CodeInfoResponse"> & {
+    codeId: bigint;
+    creator: string;
+    dataHash: Uint8Array;
+    instantiatePermission?: AccessConfig;
+  } & {
+    readonly schema: _$_bufbuild_protobuf0.DescMessage;
+    readonly typeUrl: string;
+    toJson(options?: Partial<_$_bufbuild_protobuf0.JsonWriteOptions>): _$_bufbuild_protobuf0.JsonValue;
+    toJSON(): _$_bufbuild_protobuf0.JsonValue;
+  } & {
+    readonly $typeName: "cosmwasm.wasm.v1.CodeInfoResponse";
+    $unknown?: _$_bufbuild_protobuf0.UnknownField[] | undefined;
+    codeId: bigint;
+    creator: string;
+    dataHash: Uint8Array;
+    instantiatePermission?: (_$_bufbuild_protobuf0.Message<"cosmwasm.wasm.v1.AccessConfig"> & {
+      permission: AccessType;
+      addresses: string[];
+    } & {
+      readonly schema: _$_bufbuild_protobuf0.DescMessage;
+      readonly typeUrl: string;
+      toJson(options?: Partial<_$_bufbuild_protobuf0.JsonWriteOptions>): _$_bufbuild_protobuf0.JsonValue;
+      toJSON(): _$_bufbuild_protobuf0.JsonValue;
+    } & {
+      readonly $typeName: "cosmwasm.wasm.v1.AccessConfig";
+      $unknown?: _$_bufbuild_protobuf0.UnknownField[] | undefined;
+      permission: AccessType;
+      addresses: string[];
+    }) | undefined;
+  };
+  data: Uint8Array<ArrayBufferLike>;
+}>;
+/**
+ * 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)
+ * ```
+ */
+declare function getContractsByCode(context: HasWasmService, codeId: Numeric): Promise<string[]>;
+/**
+ * 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}`)
+ * }
+ * ```
+ */
+declare function getContractHistory(context: HasWasmService, contractAddress: string): Promise<ContractCodeHistoryEntry[] & WrappedResponse<ContractCodeHistoryEntry>[]>;
+//#endregion
+//#region src/contracts/wasm/schema.d.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']
+ * ```
+ */
+declare function getSchemaVariants(schema: JsonSchema | undefined): string[];
+/**
+ * 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
+ */
+declare function getVariantSchema(schema: JsonSchema | undefined, variant: string): JsonSchema | undefined;
+/**
+ * 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
+ */
+declare function validateMessageStructure(msg: ExecuteMsg | QueryMsg): {
+  valid: boolean;
+  variant?: string;
+  error?: string;
+};
+/**
+ * Validates an execute message against a schema (basic check).
+ *
+ * @param msg - Execute message to validate
+ * @param schema - Contract schema
+ * @returns Validation result
+ */
+declare function validateExecuteMsg(msg: ExecuteMsg, schema: WasmContractSchema): {
+  valid: boolean;
+  error?: string;
+};
+/**
+ * Validates a query message against a schema (basic check).
+ *
+ * @param msg - Query message to validate
+ * @param schema - Contract schema
+ * @returns Validation result
+ */
+declare function validateQueryMsg(msg: QueryMsg, schema: WasmContractSchema): {
+  valid: boolean;
+  error?: string;
+};
+/**
+ * Gets information about a contract schema.
+ *
+ * @param schema - Contract schema
+ * @returns Schema information
+ */
+declare function getSchemaInfo(schema: WasmContractSchema): {
+  name?: string;
+  version?: string;
+  executeVariants: string[];
+  queryVariants: string[];
+  hasInstantiate: boolean;
+  hasMigrate: boolean;
+  hasSudo: boolean;
+};
+/**
+ * Gets the response schema for a query variant.
+ *
+ * @param schema - Contract schema
+ * @param queryVariant - Query variant name
+ * @returns Response schema, or undefined
+ */
+declare function getResponseSchema(schema: WasmContractSchema, queryVariant: string): JsonSchema | undefined;
+/**
+ * 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
+ */
+declare function inferTypeFromSchema(schema: JsonSchema | undefined): string;
+//#endregion
+export { type AccessConfig, type ClearAdminOptions, type ContractInfo, type CreateWasmContractOptions, type ExecuteMsg, type ExtractVariantNames, type InstantiateContract2Options, type InstantiateContractOptions, type InstantiateMsg, type JsonSchema, type MigrateContractOptions, type MigrateMsg, type MsgClearAdmin, type MsgExecuteContract, type MsgInstantiateContract, type MsgMigrateContract, type MsgStoreCode, type MsgUpdateAdmin, type QueryMsg, type ReadonlyWasmContractSchema, type ReadonlyWasmMsgSchema, type ReadonlyWasmVariant, type StoreCodeOptions, type TypedWasmContract, type UpdateAdminOptions, type WasmClient, type WasmContract, type WasmContractConfig, type WasmContractSchema, type WasmExecuteProxy, type WasmExecuteProxyTyped, type WasmQueryClient, type WasmQueryProxy, type WasmQueryProxyTyped, 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.d.mts.map