schemos 0.1.1 → 0.2.1

package/dist/encoding/json.js

@@ -0,0 +1,95 @@
+/**
+ * Platform-neutral encoding utilities for CosmWasm message fields.
+ *
+ * Base64 implementation adapted from ox (MIT, weth LLC)
+ * @see https://github.com/wevm/ox/blob/658ecc6/src/core/Base64.ts
+ */
+const textEncoder = /*#__PURE__*/ new TextEncoder();
+const textDecoder = /*#__PURE__*/ new TextDecoder();
+// Base64 lookup table (same approach as ox)
+const integerToCharacter = /*#__PURE__*/ Object.fromEntries(Array.from('ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/').map((c, i) => [i, c.charCodeAt(0)]));
+function utf8Encode(str) {
+    return textEncoder.encode(str);
+}
+function utf8Decode(bytes) {
+    return textDecoder.decode(bytes);
+}
+function base64Encode(bytes) {
+    const encoded = new Uint8Array(Math.ceil(bytes.length / 3) * 4);
+    for (let i = 0, j = 0; j < bytes.length; i += 4, j += 3) {
+        const y = (bytes[j] << 16) + ((bytes[j + 1] ?? 0) << 8) + (bytes[j + 2] ?? 0);
+        encoded[i] = integerToCharacter[y >> 18];
+        encoded[i + 1] = integerToCharacter[(y >> 12) & 0x3f];
+        encoded[i + 2] = integerToCharacter[(y >> 6) & 0x3f];
+        encoded[i + 3] = integerToCharacter[y & 0x3f];
+    }
+    const remainder = bytes.length % 3;
+    const end = Math.floor(bytes.length / 3) * 4 + (remainder && remainder + 1);
+    let base64 = textDecoder.decode(new Uint8Array(encoded.buffer, 0, end));
+    if (remainder === 1)
+        base64 += '==';
+    if (remainder === 2)
+        base64 += '=';
+    return base64;
+}
+// ---------------------------------------------------------------------------
+// Public API: Json namespace
+// ---------------------------------------------------------------------------
+export const Json = {
+    /**
+     * Encode a JSON-serializable object to UTF-8 bytes.
+     *
+     * Use for `MsgExecuteContract.msg` and `queryData` fields.
+     *
+     * @example
+     * ```ts
+     * import { Json } from 'schemos/encoding'
+     *
+     * const envelope = cw20Msg('transfer', { amount: '1000', recipient: 'osmo1...' })
+     * MsgExecuteContract.fromPartial({
+     *   sender, contract,
+     *   msg: Json.toBytes(envelope),
+     *   funds: [],
+     * })
+     * ```
+     */
+    toBytes(value) {
+        return utf8Encode(JSON.stringify(value));
+    },
+    /**
+     * Encode a JSON-serializable object to a base64 string.
+     *
+     * Use for CosmWasm `Binary` fields (e.g. cw20 `send` msg hook).
+     *
+     * @example
+     * ```ts
+     * import { Json } from 'schemos/encoding'
+     *
+     * cw20Msg('send', {
+     *   amount: '1000',
+     *   contract: 'osmo1...',
+     *   msg: Json.toBase64({ some_hook: { action: 'swap' } }),
+     * })
+     * ```
+     */
+    toBase64(value) {
+        return base64Encode(utf8Encode(JSON.stringify(value)));
+    },
+    /**
+     * Decode UTF-8 bytes to a JSON object.
+     *
+     * Use for decoding query responses from telescope RPC.
+     *
+     * @example
+     * ```ts
+     * import { Json } from 'schemos/encoding'
+     *
+     * const res = await rpc.cosmwasm.wasm.v1.smartContractState({ address, queryData })
+     * const result = Json.fromBytes(res.data)
+     * ```
+     */
+    fromBytes(bytes) {
+        return JSON.parse(utf8Decode(bytes));
+    },
+};
+//# sourceMappingURL=json.js.map

package/dist/encoding/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/encoding/json.ts"],"names":[],"mappings":"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"}

package/dist/encoding/json.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.test.d.ts.map

package/dist/encoding/json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.test.d.ts","sourceRoot":"","sources":["../../src/encoding/json.test.ts"],"names":[],"mappings":""}

package/dist/encoding/json.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, test } from 'vitest';
+import { Json } from './json.js';
+describe('Json.toBytes', () => {
+    test('encodes object to JSON UTF-8 bytes', () => {
+        const bytes = Json.toBytes({ transfer: { amount: '1000' } });
+        expect(bytes).toBeInstanceOf(Uint8Array);
+        expect(JSON.parse(new TextDecoder().decode(bytes))).toEqual({
+            transfer: { amount: '1000' },
+        });
+    });
+    test('encodes empty object', () => {
+        const bytes = Json.toBytes({ token_info: {} });
+        expect(JSON.parse(new TextDecoder().decode(bytes))).toEqual({
+            token_info: {},
+        });
+    });
+});
+describe('Json.toBase64', () => {
+    test('encodes object to base64 string', () => {
+        const b64 = Json.toBase64({ some_hook: { action: 'swap' } });
+        // Verify roundtrip via atob
+        expect(JSON.parse(atob(b64))).toEqual({ some_hook: { action: 'swap' } });
+    });
+    test('handles padding correctly', () => {
+        // Different object sizes produce different padding
+        const b64_1 = Json.toBase64({ a: 1 });
+        expect(b64_1).toMatch(/^[A-Za-z0-9+/]+=*$/);
+        const b64_2 = Json.toBase64({ ab: 12 });
+        expect(b64_2).toMatch(/^[A-Za-z0-9+/]+=*$/);
+    });
+    test('produces valid base64 for cw20 send msg pattern', () => {
+        const hookMsg = { execute_swap: { offer_asset: 'uosmo' } };
+        const b64 = Json.toBase64(hookMsg);
+        expect(JSON.parse(atob(b64))).toEqual(hookMsg);
+    });
+});
+describe('Json.fromBytes', () => {
+    test('decodes UTF-8 bytes to object', () => {
+        const original = { balance: '1000' };
+        const bytes = new TextEncoder().encode(JSON.stringify(original));
+        expect(Json.fromBytes(bytes)).toEqual(original);
+    });
+    test('roundtrips with Json.toBytes', () => {
+        const original = { transfer: { amount: '1000', recipient: 'osmo1abc' } };
+        const bytes = Json.toBytes(original);
+        expect(Json.fromBytes(bytes)).toEqual(original);
+    });
+});
+//# sourceMappingURL=json.test.js.map

package/dist/encoding/json.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.test.js","sourceRoot":"","sources":["../../src/encoding/json.test.ts"],"names":[],"mappings":"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"}

package/dist/formats.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Custom Ajv format validators for CosmWasm-specific integer formats.
+ *
+ * The `cosmwasm-schema` Rust crate emits JSON Schemas with format annotations
+ * like `"format": "uint64"` on `type: "integer"` fields. Ajv validates these
+ * as strings by default; we register numeric validators instead.
+ *
+ * Formats covered: uint8, uint32, uint64
+ * (These are the only formats appearing in the bundled cw20/cw721 schemas.)
+ */
+export interface FormatDefinition {
+    type: 'number';
+    validate: (value: number) => boolean;
+}
+/** uint8: integer in [0, 255] */
+export declare const uint8Format: FormatDefinition;
+/** uint32: integer in [0, 4294967295] */
+export declare const uint32Format: FormatDefinition;
+/**
+ * uint64: integer in [0, 2^64 - 1].
+ *
+ * JavaScript numbers cannot represent the full uint64 range exactly (max safe
+ * integer is 2^53 - 1). We accept any non-negative safe integer here, which
+ * matches what JSON parsers can round-trip without loss. Values above
+ * Number.MAX_SAFE_INTEGER must be handled via BigInt at the application layer.
+ */
+export declare const uint64Format: FormatDefinition;
+export declare const cosmwasmFormats: {
+    readonly uint8: FormatDefinition;
+    readonly uint32: FormatDefinition;
+    readonly uint64: FormatDefinition;
+};
+//# sourceMappingURL=formats.d.ts.map

package/dist/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAA;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC;AAED,iCAAiC;AACjC,eAAO,MAAM,WAAW,EAAE,gBAGzB,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,YAAY,EAAE,gBAG1B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,gBAI1B,CAAA;AAED,eAAO,MAAM,eAAe;;;;CAIlB,CAAA"}

package/dist/formats.js

@@ -0,0 +1,38 @@
+/**
+ * Custom Ajv format validators for CosmWasm-specific integer formats.
+ *
+ * The `cosmwasm-schema` Rust crate emits JSON Schemas with format annotations
+ * like `"format": "uint64"` on `type: "integer"` fields. Ajv validates these
+ * as strings by default; we register numeric validators instead.
+ *
+ * Formats covered: uint8, uint32, uint64
+ * (These are the only formats appearing in the bundled cw20/cw721 schemas.)
+ */
+/** uint8: integer in [0, 255] */
+export const uint8Format = {
+    type: 'number',
+    validate: (v) => Number.isInteger(v) && v >= 0 && v <= 255,
+};
+/** uint32: integer in [0, 4294967295] */
+export const uint32Format = {
+    type: 'number',
+    validate: (v) => Number.isInteger(v) && v >= 0 && v <= 4_294_967_295,
+};
+/**
+ * uint64: integer in [0, 2^64 - 1].
+ *
+ * JavaScript numbers cannot represent the full uint64 range exactly (max safe
+ * integer is 2^53 - 1). We accept any non-negative safe integer here, which
+ * matches what JSON parsers can round-trip without loss. Values above
+ * Number.MAX_SAFE_INTEGER must be handled via BigInt at the application layer.
+ */
+export const uint64Format = {
+    type: 'number',
+    validate: (v) => Number.isInteger(v) && v >= 0 && v <= Number.MAX_SAFE_INTEGER,
+};
+export const cosmwasmFormats = {
+    uint8: uint8Format,
+    uint32: uint32Format,
+    uint64: uint64Format,
+};
+//# sourceMappingURL=formats.js.map

package/dist/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG;CACnE,CAAA;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa;CAC7E,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE,CACtB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,gBAAgB;CAChE,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;CACZ,CAAA"}

package/dist/formats.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formats.test.d.ts.map

package/dist/formats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.test.d.ts","sourceRoot":"","sources":["../src/formats.test.ts"],"names":[],"mappings":""}

package/dist/formats.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, test } from 'vitest';
+import { uint8Format, uint32Format, uint64Format } from './formats.js';
+import { createMsgBuilder } from './msg.js';
+import { cw20ExecuteSchema, cw20QuerySchema } from './schemas/cw20/index.js';
+// ---------------------------------------------------------------------------
+// Unit tests for individual format validators
+// ---------------------------------------------------------------------------
+describe('uint8Format', () => {
+    const { validate } = uint8Format;
+    test('accepts 0 (minimum)', () => {
+        expect(validate(0)).toBe(true);
+    });
+    test('accepts 255 (maximum)', () => {
+        expect(validate(255)).toBe(true);
+    });
+    test('accepts mid-range value', () => {
+        expect(validate(128)).toBe(true);
+    });
+    test('rejects -1 (negative)', () => {
+        expect(validate(-1)).toBe(false);
+    });
+    test('rejects 256 (overflow)', () => {
+        expect(validate(256)).toBe(false);
+    });
+    test('rejects non-integer float', () => {
+        expect(validate(1.5)).toBe(false);
+    });
+});
+describe('uint32Format', () => {
+    const { validate } = uint32Format;
+    test('accepts 0 (minimum)', () => {
+        expect(validate(0)).toBe(true);
+    });
+    test('accepts 4294967295 (maximum)', () => {
+        expect(validate(4_294_967_295)).toBe(true);
+    });
+    test('accepts mid-range value', () => {
+        expect(validate(100_000)).toBe(true);
+    });
+    test('rejects -1 (negative)', () => {
+        expect(validate(-1)).toBe(false);
+    });
+    test('rejects 4294967296 (overflow)', () => {
+        expect(validate(4_294_967_296)).toBe(false);
+    });
+    test('rejects non-integer float', () => {
+        expect(validate(3.14)).toBe(false);
+    });
+});
+describe('uint64Format', () => {
+    const { validate } = uint64Format;
+    test('accepts 0 (minimum)', () => {
+        expect(validate(0)).toBe(true);
+    });
+    test('accepts Number.MAX_SAFE_INTEGER', () => {
+        expect(validate(Number.MAX_SAFE_INTEGER)).toBe(true);
+    });
+    test('accepts typical block height', () => {
+        expect(validate(12_345_678)).toBe(true);
+    });
+    test('rejects -1 (negative)', () => {
+        expect(validate(-1)).toBe(false);
+    });
+    test('rejects Number.MAX_SAFE_INTEGER + 1 (beyond safe range)', () => {
+        expect(validate(Number.MAX_SAFE_INTEGER + 1)).toBe(false);
+    });
+    test('rejects non-integer float', () => {
+        expect(validate(1.1)).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// Integration: format validation active in createMsgBuilder
+// ---------------------------------------------------------------------------
+describe('format validation integration', () => {
+    const cw20Msg = createMsgBuilder(cw20ExecuteSchema);
+    const cw20QueryMsg = createMsgBuilder(cw20QuerySchema);
+    test('valid uint64 at_height passes', () => {
+        const result = cw20Msg('increase_allowance', {
+            amount: '500',
+            spender: 'osmo1abc',
+            expires: { at_height: 100 },
+        });
+        expect(result).toEqual({
+            increase_allowance: {
+                amount: '500',
+                spender: 'osmo1abc',
+                expires: { at_height: 100 },
+            },
+        });
+    });
+    test('negative at_height fails (uint64 violation)', () => {
+        expect(() => cw20Msg('increase_allowance', {
+            amount: '500',
+            spender: 'osmo1abc',
+            expires: { at_height: -1 },
+        })).toThrow('Validation failed for "increase_allowance"');
+    });
+    test('float at_height fails (uint64 violation)', () => {
+        expect(() => cw20Msg('increase_allowance', {
+            amount: '500',
+            spender: 'osmo1abc',
+            expires: { at_height: 1.5 },
+        })).toThrow('Validation failed for "increase_allowance"');
+    });
+    test('valid uint32 limit in query passes', () => {
+        const result = cw20QueryMsg('all_accounts', { limit: 10 });
+        expect(result).toEqual({ all_accounts: { limit: 10 } });
+    });
+    test('null limit in query passes (nullable uint32)', () => {
+        const result = cw20QueryMsg('all_accounts', { limit: null });
+        expect(result).toEqual({ all_accounts: { limit: null } });
+    });
+    test('negative limit fails (uint32 violation)', () => {
+        expect(() => cw20QueryMsg('all_accounts', {
+            limit: -1,
+        })).toThrow('Validation failed for "all_accounts"');
+    });
+    test('float limit fails (uint32 violation)', () => {
+        expect(() => cw20QueryMsg('all_accounts', {
+            limit: 2.5,
+        })).toThrow('Validation failed for "all_accounts"');
+    });
+});
+//# sourceMappingURL=formats.test.js.map

package/dist/formats.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.test.js","sourceRoot":"","sources":["../src/formats.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export type { CosmWasmExecuteClient, CosmWasmQueryClient } from './client.js';
 export type { TypedContract, TypedQueryContract } from './contract.js';
 export { createTypedContract } from './contract.js';
+export { Json } from './encoding/index.js';
+export type { InferMsg, InferResponse, MessageArgs, MessageNames, MsgBuilder, MsgValidator, } from './msg.js';
+export { createMsgBuilder, createMsgValidator } from './msg.js';
 export type { Coin, StdFee } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,YAAY,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC/D,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,2 +1,4 @@
 export { createTypedContract } from './contract.js';
+export { Json } from './encoding/index.js';
+export { createMsgBuilder, createMsgValidator } from './msg.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAS1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA"}

package/dist/msg-compat.test-d.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Level 2 (createMsgBuilder) output compatibility tests.
+ *
+ * Verifies that the typed envelope from createMsgBuilder plugs directly
+ * into existing SDK APIs without needing a Level 3 adapter.
+ *
+ * Two integration patterns:
+ * 1. Convenience API (cosmjs, graz): envelope is the `msg` parameter as-is
+ * 2. Protobuf API (telescope, interchainjs): envelope goes through
+ *    JSON.stringify → toUtf8 → MsgExecuteContract.fromPartial({ msg })
+ */
+export {};
+//# sourceMappingURL=msg-compat.test-d.d.ts.map

package/dist/msg-compat.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-compat.test-d.d.ts","sourceRoot":"","sources":["../src/msg-compat.test-d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/msg-compat.test-d.js

@@ -0,0 +1,68 @@
+/**
+ * Level 2 (createMsgBuilder) output compatibility tests.
+ *
+ * Verifies that the typed envelope from createMsgBuilder plugs directly
+ * into existing SDK APIs without needing a Level 3 adapter.
+ *
+ * Two integration patterns:
+ * 1. Convenience API (cosmjs, graz): envelope is the `msg` parameter as-is
+ * 2. Protobuf API (telescope, interchainjs): envelope goes through
+ *    JSON.stringify → toUtf8 → MsgExecuteContract.fromPartial({ msg })
+ */
+import { expectTypeOf, test } from 'vitest';
+import { createMsgBuilder } from './msg.js';
+import { cw20ExecuteSchema, cw20QuerySchema } from './schemas/cw20/index.js';
+const cw20Msg = createMsgBuilder(cw20ExecuteSchema);
+const cw20QueryMsg = createMsgBuilder(cw20QuerySchema);
+// ---------------------------------------------------------------------------
+// Pattern 1: Convenience APIs — envelope plugs in directly as `msg`
+// ---------------------------------------------------------------------------
+// cosmjs: SigningCosmWasmClient.execute(sender, contract, msg: JsonObject, fee)
+test('cosmjs: Level 2 output assignable to execute() msg parameter', () => {
+    const envelope = cw20Msg('transfer', {
+        amount: '1000',
+        recipient: 'osmo1abc',
+    });
+    expectTypeOf(envelope).toExtend();
+});
+// cosmjs: SigningCosmWasmClient.executeMultiple(sender, instructions, fee)
+test('cosmjs: Level 2 output assignable to ExecuteInstruction.msg', () => {
+    const envelope = cw20Msg('burn', { amount: '500' });
+    expectTypeOf(envelope).toExtend();
+});
+// cosmjs: CosmWasmClient.queryContractSmart(address, query: JsonObject)
+test('cosmjs: Level 2 output assignable to queryContractSmart() query parameter', () => {
+    const envelope = cw20QueryMsg('balance', { address: 'osmo1abc' });
+    expectTypeOf(envelope).toExtend();
+});
+// graz: executeContract({ msg: Message extends Record<string, unknown> })
+test('graz: Level 2 output assignable to Record<string, unknown>', () => {
+    const envelope = cw20Msg('transfer', {
+        amount: '1000',
+        recipient: 'osmo1abc',
+    });
+    // graz's Message generic is constrained to Record<string, unknown>
+    expectTypeOf(envelope).toExtend();
+});
+// ---------------------------------------------------------------------------
+// Pattern 2: Protobuf APIs — envelope goes into MsgExecuteContract.msg field
+// after JSON.stringify → Uint8Array encoding (user handles this step)
+// ---------------------------------------------------------------------------
+// interchainjs/telescope: MsgExecuteContract.msg is Uint8Array
+test('telescope/interchainjs: Level 2 output is JSON-serializable for MsgExecuteContract.msg field', () => {
+    const envelope = cw20Msg('transfer', {
+        amount: '1000',
+        recipient: 'osmo1abc',
+    });
+    // The envelope is a plain object that can be JSON.stringify'd
+    // User does: toUtf8(JSON.stringify(envelope)) → Uint8Array → MsgExecuteContract.msg
+    const serialized = JSON.stringify(envelope);
+    expectTypeOf(serialized).toBeString();
+    expectTypeOf().toEqualTypeOf();
+});
+// interchainjs: signAndBroadcast expects Message<any>[] (= { typeUrl, value }[])
+// User builds the full message using telescope codegen, Level 2 only provides the msg field
+test('interchainjs: Message<any> is { typeUrl: string, value: any }', () => {
+    expectTypeOf().toEqualTypeOf();
+});
+//# sourceMappingURL=msg-compat.test-d.js.map

package/dist/msg-compat.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-compat.test-d.js","sourceRoot":"","sources":["../src/msg-compat.test-d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE5E,MAAM,OAAO,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAA;AACnD,MAAM,YAAY,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA;AAEtD,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E,gFAAgF;AAChF,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,UAAU;KACtB,CAAC,CAAA;IAEF,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAc,CAAA;AAC/C,CAAC,CAAC,CAAA;AAEF,2EAA2E;AAC3E,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAGnD,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAkB,CAAA;AACnD,CAAC,CAAC,CAAA;AAEF,wEAAwE;AACxE,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACrF,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;IAEjE,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAY,CAAA;AAC7C,CAAC,CAAC,CAAA;AAEF,0EAA0E;AAC1E,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,UAAU;KACtB,CAAC,CAAA;IACF,mEAAmE;IACnE,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAA2B,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,6EAA6E;AAC7E,sEAAsE;AACtE,8EAA8E;AAE9E,+DAA+D;AAC/D,IAAI,CAAC,8FAA8F,EAAE,GAAG,EAAE;IACxG,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,UAAU;KACtB,CAAC,CAAA;IAEF,8DAA8D;IAC9D,oFAAoF;IACpF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC3C,YAAY,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAA;IAIrC,YAAY,EAAY,CAAC,aAAa,EAAc,CAAA;AACtD,CAAC,CAAC,CAAA;AAEF,iFAAiF;AACjF,4FAA4F;AAC5F,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IAEzE,YAAY,EAAqB,CAAC,aAAa,EAG3C,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/msg.d.ts

@@ -0,0 +1,96 @@
+import type { FromSchema, JSONSchema } from 'json-schema-to-ts';
+/** Infer the TypeScript message type from a JSON Schema definition. */
+export type InferMsg<TSchema extends JSONSchema> = FromSchema<TSchema>;
+/** Extract all top-level message names from a union of single-key objects. */
+export type MessageNames<T> = T extends Record<string, unknown> ? keyof T & string : never;
+/** Extract the args type for a specific message name from a union. */
+export type MessageArgs<T, K extends string> = T extends Record<K, infer V> ? V : never;
+/** Infer a specific response type from a responses schema map. */
+export type InferResponse<TResponses extends Record<string, JSONSchema>, K extends keyof TResponses & string> = FromSchema<TResponses[K]>;
+/** Typed callable interface returned by createMsgBuilder. */
+export type MsgBuilder<TMsg> = <K extends MessageNames<TMsg>>(msg: K, args: MessageArgs<TMsg, K>, options?: {
+    context?: string;
+}) => {
+    [P in K]: MessageArgs<TMsg, K>;
+};
+/**
+ * Create a typed message builder from a JSON Schema.
+ *
+ * Returns a callable that builds validated `{ [msgName]: args }` envelopes.
+ * The schema is compiled once and cached — safe for batch usage.
+ *
+ * This follows the same pattern as `createTypedContract`: the schema type
+ * is resolved once at factory level, avoiding expensive repeated evaluation
+ * of `FromSchema` on complex schemas (12+ oneOf branches with $ref).
+ *
+ * @example
+ * ```ts
+ * import { createMsgBuilder } from 'schemos/msg'
+ * import { cw20 } from 'schemos/schemas'
+ *
+ * const cw20Msg = createMsgBuilder(cw20.execute)
+ * const msg = cw20Msg('transfer', { amount: '1000', recipient: 'osmo1...' })
+ * // msg is typed as { transfer: { amount: string; recipient: string } }
+ *
+ * // Batch usage — schema compiled once, reused across calls:
+ * const msgs = [
+ *   cw20Msg('transfer', { amount: '100', recipient: addr1 }),
+ *   cw20Msg('transfer', { amount: '200', recipient: addr2 }),
+ * ]
+ * ```
+ */
+export declare function createMsgBuilder<const TSchema extends JSONSchema>(schema: TSchema): MsgBuilder<FromSchema<TSchema>>;
+/** Typed callable interface returned by createMsgValidator. */
+export type MsgValidator<TMsg> = (data: TMsg, options?: {
+    context?: string;
+}) => TMsg;
+/**
+ * Create a typed message validator from a JSON Schema.
+ *
+ * Returns a callable that validates data and returns it with the inferred
+ * type. The schema type is resolved once at factory level — same pattern
+ * as `createTypedContract` and `createMsgBuilder`.
+ *
+ * @example
+ * ```ts
+ * import { createMsgValidator } from 'schemos'
+ * import { cw20 } from 'schemos/schemas'
+ *
+ * const validateInit = createMsgValidator(cw20.instantiate)
+ * const msg = validateInit({
+ *   name: 'Token', symbol: 'TKN', decimals: 6, initial_balances: []
+ * })
+ * // msg type is inferred from cw20.instantiate schema
+ *
+ * await client.instantiate(sender, codeId, msg, 'label', 'auto')
+ * ```
+ */
+export declare function createMsgValidator<const TSchema extends JSONSchema>(schema: TSchema): MsgValidator<FromSchema<TSchema>>;
+/**
+ * Validate data against a JSON Schema. Returns the data as-is if valid,
+ * throws a descriptive error if invalid.
+ *
+ * Reuses the same WeakMap-based validator cache as `buildMsg` — safe for
+ * repeated calls with the same schema reference.
+ *
+ * @example
+ * ```ts
+ * import { validateMsg } from 'schemos'
+ *
+ * const initMsg = validateMsg(cw20InstantiateSchema, {
+ *   name: 'Token', symbol: 'TKN', decimals: 6, initial_balances: []
+ * })
+ * ```
+ */
+export declare function validateMsg<T>(schema: JSONSchema, data: unknown, options?: {
+    context?: string;
+}): T;
+/**
+ * Build a validated message envelope. Used internally by createMsgBuilder
+ * and createTypedContract. Accepts loose types — prefer createMsgBuilder
+ * for type-safe usage.
+ */
+export declare function buildMsg(schema: JSONSchema, msg: string, args: unknown, options?: {
+    context?: string;
+}): Record<string, unknown>;
+//# sourceMappingURL=msg.d.ts.map

package/dist/msg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg.d.ts","sourceRoot":"","sources":["../src/msg.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAO/D,uEAAuE;AACvE,MAAM,MAAM,QAAQ,CAAC,OAAO,SAAS,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;AAEtE,8EAA8E;AAC9E,MAAM,MAAM,YAAY,CAAC,CAAC,IACxB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAE9D,sEAAsE;AACtE,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IACzC,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE1C,kEAAkE;AAClE,MAAM,MAAM,aAAa,CACvB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC7C,CAAC,SAAS,MAAM,UAAU,GAAG,MAAM,IACjC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;AA8B7B,6DAA6D;AAC7D,MAAM,MAAM,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,YAAY,CAAC,IAAI,CAAC,EAC1D,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3B;KAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;CAAE,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,OAAO,SAAS,UAAU,EAC/D,MAAM,EAAE,OAAO,GACd,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAIjC;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3B,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,OAAO,SAAS,UAAU,EACjE,MAAM,EAAE,OAAO,GACd,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AAWpC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,CAAC,CAOH;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}