@parity/product-sdk-contracts 0.0.0-dev.312.0

package/dist/codegen.js

@@ -0,0 +1,83 @@
+import { loadPvmContractAbi } from './chunk-2UN4YA25.js';
+
+// src/codegen.ts
+async function resolveContractTypeInputs(inputs) {
+  return Promise.all(
+    inputs.map(async (input) => {
+      if ("abi" in input) return { library: input.library, abi: input.abi };
+      return { library: input.library, abi: await loadPvmContractAbi(input.abiPath) };
+    })
+  );
+}
+function mapSolidityType(param) {
+  const t = param.type;
+  if (t.endsWith("[]")) {
+    const inner = { ...param, type: t.slice(0, -2) };
+    return `${mapSolidityType(inner)}[]`;
+  }
+  const fixedArrayMatch = t.match(/^(.+)\[(\d+)\]$/);
+  if (fixedArrayMatch) {
+    const inner = { ...param, type: fixedArrayMatch[1] };
+    return `${mapSolidityType(inner)}[]`;
+  }
+  if (t === "tuple" && param.components) {
+    const fields = param.components.map((c) => `${c.name}: ${mapSolidityType(c)}`);
+    return `{ ${fields.join("; ")} }`;
+  }
+  if (/^uint(8|16|32)$/.test(t)) return "number";
+  if (/^uint\d*$/.test(t)) return "bigint";
+  if (/^int(8|16|32)$/.test(t)) return "number";
+  if (/^int\d*$/.test(t)) return "bigint";
+  if (t === "address") return "HexString";
+  if (t === "bytes") return "HexString";
+  const bytesMatch = t.match(/^bytes(\d+)$/);
+  if (bytesMatch) return `SizedHex<${bytesMatch[1]}>`;
+  if (t === "bool") return "boolean";
+  if (t === "string") return "string";
+  return "unknown";
+}
+function generateMethodArgsType(inputs) {
+  if (inputs.length === 0) return "[]";
+  const parts = inputs.map((p) => `${p.name}: ${mapSolidityType(p)}`);
+  return `[${parts.join(", ")}]`;
+}
+function generateMethodResponseType(outputs) {
+  if (!outputs || outputs.length === 0) return "undefined";
+  if (outputs.length === 1) return mapSolidityType(outputs[0]);
+  const fields = outputs.map((o, i) => {
+    const name = o.name || `_${i}`;
+    return `${name}: ${mapSolidityType(o)}`;
+  });
+  return `{ ${fields.join("; ")} }`;
+}
+function generateContractTypes(contracts) {
+  const lines = [
+    "// Auto-generated by cdm install \u2014 do not edit",
+    'import type { HexString, SizedHex } from "polkadot-api";',
+    "",
+    'declare module "@parity/product-sdk-contracts" {',
+    "    interface Contracts {"
+  ];
+  for (const contract of contracts) {
+    const methods = contract.abi.filter((e) => e.type === "function" && e.name);
+    lines.push(`        "${contract.library}": {`);
+    lines.push("            methods: {");
+    for (const method of methods) {
+      const args = generateMethodArgsType(method.inputs);
+      const response = generateMethodResponseType(method.outputs);
+      lines.push(
+        `                ${method.name}: { args: ${args}; response: ${response} };`
+      );
+    }
+    lines.push("            };");
+    lines.push("        };");
+  }
+  lines.push("    }");
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+
+export { generateContractTypes, resolveContractTypeInputs };
+//# sourceMappingURL=codegen.js.map
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen.ts"],"names":[],"mappings":"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","file":"codegen.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\nimport type { AbiEntry, AbiParam } from \"./types.js\";\nimport { loadPvmContractAbi } from \"./pvm.js\";\n\n/** A contract input to {@link generateContractTypes}: either an inline ABI or a `cargo-pvm-contract` artefact path. */\nexport type ContractTypeInput =\n    | { library: string; abi: AbiEntry[] }\n    | { library: string; abiPath: string };\n\n/**\n * Resolve a heterogeneous list of {@link ContractTypeInput} entries into the\n * `{ library, abi }` shape consumed by {@link generateContractTypes}. Reads any\n * `abiPath` entries off disk via {@link loadPvmContractAbi} (Node only).\n *\n * @example\n * ```ts\n * const resolved = await resolveContractTypeInputs([\n *     { library: \"@example/counter\", abiPath: \"./target/counter.release.abi.json\" },\n *     { library: \"@example/inline\", abi: counterAbi },\n * ]);\n * const src = generateContractTypes(resolved);\n * ```\n */\nexport async function resolveContractTypeInputs(\n    inputs: readonly ContractTypeInput[],\n): Promise<{ library: string; abi: AbiEntry[] }[]> {\n    return Promise.all(\n        inputs.map(async (input) => {\n            if (\"abi\" in input) return { library: input.library, abi: input.abi };\n            return { library: input.library, abi: await loadPvmContractAbi(input.abiPath) };\n        }),\n    );\n}\n\n/** Map a Solidity ABI type to its TypeScript equivalent. */\nfunction mapSolidityType(param: AbiParam): string {\n    const t = param.type;\n\n    // Dynamic arrays — e.g. uint256[]\n    if (t.endsWith(\"[]\")) {\n        const inner = { ...param, type: t.slice(0, -2) };\n        return `${mapSolidityType(inner)}[]`;\n    }\n\n    // Fixed-size arrays — e.g. uint256[3]\n    const fixedArrayMatch = t.match(/^(.+)\\[(\\d+)\\]$/);\n    if (fixedArrayMatch) {\n        const inner = { ...param, type: fixedArrayMatch[1] };\n        return `${mapSolidityType(inner)}[]`;\n    }\n\n    // Tuple\n    if (t === \"tuple\" && param.components) {\n        const fields = param.components.map((c) => `${c.name}: ${mapSolidityType(c)}`);\n        return `{ ${fields.join(\"; \")} }`;\n    }\n\n    // Unsigned integers — uint8/16/32 fit in JS number\n    if (/^uint(8|16|32)$/.test(t)) return \"number\";\n    if (/^uint\\d*$/.test(t)) return \"bigint\";\n\n    // Signed integers\n    if (/^int(8|16|32)$/.test(t)) return \"number\";\n    if (/^int\\d*$/.test(t)) return \"bigint\";\n\n    // Address\n    if (t === \"address\") return \"HexString\";\n\n    // Bytes — viem's ABI codec accepts hex strings (`0x…`) for both\n    // variable-length `bytes` and fixed-length `bytesN`. We surface\n    // `SizedHex<N>` for the latter so consumers see the byte width at\n    // compile time, even though the runtime check is just on the prefix.\n    if (t === \"bytes\") return \"HexString\";\n    const bytesMatch = t.match(/^bytes(\\d+)$/);\n    if (bytesMatch) return `SizedHex<${bytesMatch[1]}>`;\n\n    // Primitives\n    if (t === \"bool\") return \"boolean\";\n    if (t === \"string\") return \"string\";\n\n    return \"unknown\";\n}\n\nfunction generateMethodArgsType(inputs: AbiParam[]): string {\n    if (inputs.length === 0) return \"[]\";\n    const parts = inputs.map((p) => `${p.name}: ${mapSolidityType(p)}`);\n    return `[${parts.join(\", \")}]`;\n}\n\nfunction generateMethodResponseType(outputs: AbiParam[] | undefined): string {\n    if (!outputs || outputs.length === 0) return \"undefined\";\n    if (outputs.length === 1) return mapSolidityType(outputs[0]);\n    const fields = outputs.map((o, i) => {\n        const name = o.name || `_${i}`;\n        return `${name}: ${mapSolidityType(o)}`;\n    });\n    return `{ ${fields.join(\"; \")} }`;\n}\n\n/**\n * Generate a TypeScript module augmentation that extends the\n * {@link Contracts} interface with typed method signatures for each\n * installed contract.\n *\n * The output is written to `.cdm/contracts.d.ts` (or equivalent) and\n * augments `\"@parity/product-sdk-contracts\"` so that\n * `ContractManager.getContract()` returns fully-typed handles.\n *\n * Accepts `{ library, abi }` directly. To pull ABIs from\n * `cargo-pvm-contract` build artefacts on disk, use\n * {@link resolveContractTypeInputs} first.\n *\n * @example\n * ```ts\n * // Inline ABIs\n * const src = generateContractTypes([\n *     { library: \"@example/counter\", abi },\n * ]);\n * writeFileSync(\".cdm/contracts.d.ts\", src);\n *\n * // From cargo-pvm-contract artefacts\n * const resolved = await resolveContractTypeInputs([\n *     { library: \"@example/counter\", abiPath: \"./target/counter.release.abi.json\" },\n * ]);\n * writeFileSync(\".cdm/contracts.d.ts\", generateContractTypes(resolved));\n * ```\n */\nexport function generateContractTypes(contracts: { library: string; abi: AbiEntry[] }[]): string {\n    const lines: string[] = [\n        \"// Auto-generated by cdm install — do not edit\",\n        'import type { HexString, SizedHex } from \"polkadot-api\";',\n        \"\",\n        'declare module \"@parity/product-sdk-contracts\" {',\n        \"    interface Contracts {\",\n    ];\n\n    for (const contract of contracts) {\n        const methods = contract.abi.filter((e) => e.type === \"function\" && e.name);\n        lines.push(`        \"${contract.library}\": {`);\n        lines.push(\"            methods: {\");\n        for (const method of methods) {\n            const args = generateMethodArgsType(method.inputs);\n            const response = generateMethodResponseType(method.outputs);\n            lines.push(\n                `                ${method.name!}: { args: ${args}; response: ${response} };`,\n            );\n        }\n        lines.push(\"            };\");\n        lines.push(\"        };\");\n    }\n\n    lines.push(\"    }\");\n    lines.push(\"}\");\n    lines.push(\"\");\n\n    return lines.join(\"\\n\");\n}\n\nif (import.meta.vitest) {\n    const { test, expect, describe } = import.meta.vitest;\n\n    describe(\"mapSolidityType\", () => {\n        const cases: [AbiParam, string][] = [\n            [{ name: \"x\", type: \"uint8\" }, \"number\"],\n            [{ name: \"x\", type: \"uint16\" }, \"number\"],\n            [{ name: \"x\", type: \"uint32\" }, \"number\"],\n            [{ name: \"x\", type: \"uint64\" }, \"bigint\"],\n            [{ name: \"x\", type: \"uint128\" }, \"bigint\"],\n            [{ name: \"x\", type: \"uint256\" }, \"bigint\"],\n            [{ name: \"x\", type: \"int8\" }, \"number\"],\n            [{ name: \"x\", type: \"int32\" }, \"number\"],\n            [{ name: \"x\", type: \"int64\" }, \"bigint\"],\n            [{ name: \"x\", type: \"int256\" }, \"bigint\"],\n            [{ name: \"x\", type: \"address\" }, \"HexString\"],\n            [{ name: \"x\", type: \"bool\" }, \"boolean\"],\n            [{ name: \"x\", type: \"string\" }, \"string\"],\n            [{ name: \"x\", type: \"bytes\" }, \"HexString\"],\n            [{ name: \"x\", type: \"bytes32\" }, \"SizedHex<32>\"],\n            [{ name: \"x\", type: \"bytes4\" }, \"SizedHex<4>\"],\n            [{ name: \"x\", type: \"uint256[]\" }, \"bigint[]\"],\n            [{ name: \"x\", type: \"address[]\" }, \"HexString[]\"],\n            [{ name: \"x\", type: \"uint256[3]\" }, \"bigint[]\"],\n            [{ name: \"x\", type: \"somethingWeird\" }, \"unknown\"],\n        ];\n\n        for (const [param, expected] of cases) {\n            test(`${param.type} → ${expected}`, () => {\n                expect(mapSolidityType(param)).toBe(expected);\n            });\n        }\n\n        test(\"tuple with components\", () => {\n            const param: AbiParam = {\n                name: \"info\",\n                type: \"tuple\",\n                components: [\n                    { name: \"addr\", type: \"address\" },\n                    { name: \"amount\", type: \"uint256\" },\n                ],\n            };\n            expect(mapSolidityType(param)).toBe(\"{ addr: HexString; amount: bigint }\");\n        });\n\n        test(\"nested array of tuples\", () => {\n            const param: AbiParam = {\n                name: \"items\",\n                type: \"tuple[]\",\n                components: [\n                    { name: \"id\", type: \"uint32\" },\n                    { name: \"name\", type: \"string\" },\n                ],\n            };\n            expect(mapSolidityType(param)).toBe(\"{ id: number; name: string }[]\");\n        });\n    });\n\n    describe(\"generateMethodArgsType\", () => {\n        test(\"empty inputs\", () => {\n            expect(generateMethodArgsType([])).toBe(\"[]\");\n        });\n\n        test(\"single input\", () => {\n            expect(generateMethodArgsType([{ name: \"to\", type: \"address\" }])).toBe(\n                \"[to: HexString]\",\n            );\n        });\n\n        test(\"multiple inputs\", () => {\n            const result = generateMethodArgsType([\n                { name: \"to\", type: \"address\" },\n                { name: \"amount\", type: \"uint256\" },\n            ]);\n            expect(result).toBe(\"[to: HexString, amount: bigint]\");\n        });\n    });\n\n    describe(\"generateMethodResponseType\", () => {\n        test(\"no outputs\", () => {\n            expect(generateMethodResponseType(undefined)).toBe(\"undefined\");\n            expect(generateMethodResponseType([])).toBe(\"undefined\");\n        });\n\n        test(\"single output\", () => {\n            expect(generateMethodResponseType([{ name: \"\", type: \"uint32\" }])).toBe(\"number\");\n        });\n\n        test(\"multiple outputs\", () => {\n            const result = generateMethodResponseType([\n                { name: \"balance\", type: \"uint256\" },\n                { name: \"nonce\", type: \"uint32\" },\n            ]);\n            expect(result).toBe(\"{ balance: bigint; nonce: number }\");\n        });\n\n        test(\"unnamed outputs get positional names\", () => {\n            const result = generateMethodResponseType([\n                { name: \"\", type: \"bool\" },\n                { name: \"\", type: \"uint256\" },\n            ]);\n            expect(result).toBe(\"{ _0: boolean; _1: bigint }\");\n        });\n    });\n\n    describe(\"generateContractTypes\", () => {\n        test(\"generates valid module augmentation\", () => {\n            const result = generateContractTypes([\n                {\n                    library: \"@example/counter\",\n                    abi: [\n                        {\n                            type: \"constructor\",\n                            inputs: [],\n                            stateMutability: \"nonpayable\",\n                        },\n                        {\n                            type: \"function\",\n                            name: \"getCount\",\n                            inputs: [],\n                            outputs: [{ name: \"\", type: \"uint32\" }],\n                            stateMutability: \"view\",\n                        },\n                        {\n                            type: \"function\",\n                            name: \"increment\",\n                            inputs: [],\n                            outputs: [],\n                            stateMutability: \"nonpayable\",\n                        },\n                    ],\n                },\n            ]);\n\n            expect(result).toContain('declare module \"@parity/product-sdk-contracts\"');\n            expect(result).toContain(\"interface Contracts\");\n            expect(result).toContain('\"@example/counter\"');\n            expect(result).toContain(\"getCount: { args: []; response: number };\");\n            expect(result).toContain(\"increment: { args: []; response: undefined };\");\n            // Should not include constructor\n            expect(result).not.toContain(\"constructor\");\n        });\n\n        test(\"handles multiple contracts\", () => {\n            const result = generateContractTypes([\n                {\n                    library: \"@a/one\",\n                    abi: [\n                        {\n                            type: \"function\",\n                            name: \"foo\",\n                            inputs: [{ name: \"x\", type: \"uint256\" }],\n                            outputs: [{ name: \"\", type: \"bool\" }],\n                        },\n                    ],\n                },\n                {\n                    library: \"@b/two\",\n                    abi: [\n                        {\n                            type: \"function\",\n                            name: \"bar\",\n                            inputs: [],\n                            outputs: [{ name: \"\", type: \"address\" }],\n                        },\n                    ],\n                },\n            ]);\n\n            expect(result).toContain('\"@a/one\"');\n            expect(result).toContain('\"@b/two\"');\n            expect(result).toContain(\"foo: { args: [x: bigint]; response: boolean };\");\n            expect(result).toContain(\"bar: { args: []; response: HexString };\");\n        });\n\n        test(\"empty contracts list\", () => {\n            const result = generateContractTypes([]);\n            expect(result).toContain(\"interface Contracts {\");\n            expect(result).toContain(\"}\");\n        });\n\n        test(\"includes polkadot-api type imports\", () => {\n            const result = generateContractTypes([]);\n            expect(result).toContain(\"import type { HexString, SizedHex }\");\n            expect(result).toContain('from \"polkadot-api\"');\n        });\n    });\n\n    describe(\"resolveContractTypeInputs\", () => {\n        test(\"passes inline { library, abi } through unchanged\", async () => {\n            const abi: AbiEntry[] = [\n                {\n                    type: \"function\",\n                    name: \"foo\",\n                    inputs: [],\n                    outputs: [{ name: \"\", type: \"bool\" }],\n                },\n            ];\n            const out = await resolveContractTypeInputs([{ library: \"@x/foo\", abi }]);\n            expect(out).toEqual([{ library: \"@x/foo\", abi }]);\n        });\n\n        test(\"loads ABI from { abiPath } on disk\", async () => {\n            const fs = await import(\"node:fs/promises\");\n            const path = await import(\"node:path\");\n            const os = await import(\"node:os\");\n            const tmp = await fs.mkdtemp(path.join(os.tmpdir(), \"codegen-\"));\n            const abi: AbiEntry[] = [\n                {\n                    type: \"function\",\n                    name: \"ping\",\n                    inputs: [],\n                    outputs: [{ name: \"\", type: \"bool\" }],\n                },\n            ];\n            const file = path.join(tmp, \"ping.release.abi.json\");\n            await fs.writeFile(file, JSON.stringify(abi), \"utf8\");\n            try {\n                const out = await resolveContractTypeInputs([\n                    { library: \"@x/ping\", abiPath: file },\n                ]);\n                expect(out).toEqual([{ library: \"@x/ping\", abi }]);\n\n                // And it composes with generateContractTypes end-to-end:\n                const src = generateContractTypes(out);\n                expect(src).toContain('\"@x/ping\"');\n                expect(src).toContain(\"ping: { args: []; response: boolean };\");\n            } finally {\n                await fs.rm(tmp, { recursive: true, force: true });\n            }\n        });\n    });\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+import { Result } from '@parity/result';
+import { PolkadotClient, HexString, SS58String } from 'polkadot-api';
+import { C as CdmJson, a as ContractRuntime, b as ContractManagerOptions, c as ContractDefaults, d as ContractRuntimeOptions, L as LiveContractResolutionOptions, e as ContractError, f as Contracts, g as Contract, h as ContractDef, A as AbiEntry, i as ContractOptions } from './types-Dtu4IsSh.js';
+export { j as AbiParam, k as CdmJsonContract, l as CdmJsonDependencyVersion, m as ContractDryRunAt, n as ContractDryRunFailedError, o as ContractInvalidOriginError, p as ContractLiveAddressResolutionError, q as ContractNotFoundError, r as ContractRevertInfo, s as ContractRevertedError, t as ContractSignerMissingError, D as DecodedContractRevert, P as PrepareOptions, Q as QueryOptions, u as QueryResult, R as ReviveDryRunCall, v as ReviveDryRunCallOptions, w as ReviveDryRunResult, x as ReviveTypedApi, T as TxOptions, y as createContractRuntime, z as createContractRuntimeFromClient, B as ensureContractAccountMapped, E as isContractAccountMapped } from './types-Dtu4IsSh.js';
+export { BatchableCall, TxResult } from '@parity/product-sdk-tx';
+import '@parity/product-sdk-signer';
+import '@parity/product-sdk-errors';
+
+/**
+ * Return a cloned manifest whose installed contract addresses have been
+ * replaced by live addresses from the CDM registry.
+ *
+ * This is intentionally strict: if a requested library cannot be resolved from
+ * the registry, the result is `err`. Use `new ContractManager(...)` or
+ * `ContractManager.fromClient(...)` directly for snapshot-only behavior.
+ *
+ * @returns A {@link Result}: `ok(CdmJson)` with live addresses patched in, or
+ *   `err(ContractError)` — a `ContractLiveAddressResolutionError` (missing
+ *   contracts, no registry, or a lookup that failed / returned nothing) or a
+ *   `ContractNotFoundError` (a requested library isn't installed).
+ */
+declare function withLiveContractAddresses(cdmJson: CdmJson, runtime: ContractRuntime, options?: LiveContractResolutionOptions): Promise<Result<CdmJson, ContractError>>;
+/**
+ * Manages typed contract interactions backed by a `cdm.json` manifest.
+ *
+ * Pass a `signerManager` (e.g. a `SignerManager` from `@parity/product-sdk-signer`)
+ * so the currently logged-in account is used automatically — no manual
+ * signer/origin wiring needed.
+ *
+ * @example
+ * ```ts
+ * import { createChainClient } from "@parity/product-sdk-chain-client";
+ * import { paseo_asset_hub } from "@parity/product-sdk-descriptors/paseo-asset-hub";
+ * import { ContractManager, createContractRuntime } from "@parity/product-sdk-contracts";
+ * import cdmJson from "./cdm.json";
+ *
+ * const client = await createChainClient({
+ *     chains: { assetHub: paseo_asset_hub },
+ * });
+ * const runtime = createContractRuntime(client.assetHub);
+ * const manager = new ContractManager(cdmJson, runtime, {
+ *     signerManager,
+ * });
+ *
+ * const counter = manager.getContract("@example/counter");
+ * const { value } = await counter.getCount.query();
+ * await counter.increment.tx();
+ * ```
+ */
+declare class ContractManager {
+    private contracts;
+    private runtime;
+    private defaults;
+    constructor(cdmJson: CdmJson, runtime: ContractRuntime, options?: ContractManagerOptions);
+    /** Update the default origin, signer, or signerManager used by all contract handles. */
+    setDefaults(defaults: ContractDefaults): void;
+    /**
+     * Create a `ContractManager` from a raw `PolkadotClient`.
+     *
+     * Convenience factory: builds a `ContractRuntime` internally from the
+     * client's typed API. Requires that the chain's typed API exposes the
+     * `Revive` pallet and `ReviveApi` runtime API (Asset Hub Paseo /
+     * Polkadot / Kusama).
+     *
+     * @param cdmJson - The CDM manifest.
+     * @param client - A `PolkadotClient` for the chain where contracts are deployed.
+     * @param descriptor - The chain descriptor used to derive the typed API.
+     * @param options - Optional configuration (signerManager, defaults).
+     */
+    static fromClient<TDescriptor>(cdmJson: CdmJson, client: PolkadotClient, descriptor: TDescriptor, options?: ContractManagerOptions & ContractRuntimeOptions): ContractManager;
+    /**
+     * Create a manager after strictly resolving installed contract addresses
+     * from the live CDM registry. ABIs still come from the installed manifest.
+     */
+    static fromLive(cdmJson: CdmJson, runtime: ContractRuntime, options?: ContractManagerOptions & LiveContractResolutionOptions): Promise<Result<ContractManager, ContractError>>;
+    /**
+     * Convenience factory for {@link fromLive} when the caller has a raw
+     * `PolkadotClient` and descriptor.
+     */
+    static fromLiveClient<TDescriptor>(cdmJson: CdmJson, client: PolkadotClient, descriptor: TDescriptor, options?: ContractManagerOptions & ContractRuntimeOptions & LiveContractResolutionOptions): Promise<Result<ContractManager, ContractError>>;
+    private getContractData;
+    /**
+     * Get a typed contract handle.
+     *
+     * Each method on the returned object has `.query()` for read-only calls
+     * and `.tx()` for signed transactions. When codegen augments
+     * {@link Contracts}, passing a known library name returns a fully-typed
+     * handle. Without codegen the generic overload still works — methods are
+     * accessible but untyped.
+     */
+    getContract<K extends string & keyof Contracts>(library: K): Contract<Contracts[K]>;
+    getContract(library: string): Contract<ContractDef>;
+    /** Get the on-chain address of an installed contract. */
+    getAddress(library: string): HexString;
+    /**
+     * Get the underlying {@link ContractRuntime} backing this manager.
+     *
+     * Useful when a consumer needs to call helpers that take a runtime
+     * directly — most commonly {@link ensureContractAccountMapped} at app
+     * boot. Avoids the alternative of building a second runtime against the
+     * same client and descriptor.
+     */
+    getRuntime(): ContractRuntime;
+}
+/**
+ * Create a contract handle from a raw H160 address and ABI — no `cdm.json` needed.
+ *
+ * @example
+ * ```ts
+ * import { createContractRuntime, createContract } from "@parity/product-sdk-contracts";
+ *
+ * const runtime = createContractRuntime(client.assetHub);
+ * const counter = createContract(runtime, "0xC472...", abi, { signerManager });
+ * await counter.getCount.query();
+ * await counter.increment.tx();
+ * ```
+ */
+declare function createContract(runtime: ContractRuntime, address: HexString, abi: AbiEntry[], options?: ContractOptions): Contract<ContractDef>;
+/**
+ * Create a contract handle from a raw `PolkadotClient`, descriptor, address, and ABI.
+ *
+ * Convenience wrapper that builds the `ContractRuntime` from the client's
+ * typed API. The chain must expose `Revive` + `ReviveApi`.
+ *
+ * @example
+ * ```ts
+ * const counter = createContractFromClient(client, paseo_asset_hub, "0xC472...", abi);
+ * const { value } = await counter.getCount.query();
+ * ```
+ */
+declare function createContractFromClient<TDescriptor>(client: PolkadotClient, descriptor: TDescriptor, address: HexString, abi: AbiEntry[], options?: ContractOptions & ContractRuntimeOptions): Contract<ContractDef>;
+
+declare const QUERY_FALLBACK_ORIGIN: SS58String;
+
+export { AbiEntry, CdmJson, Contract, ContractDef, ContractDefaults, ContractError, ContractManager, ContractManagerOptions, ContractOptions, ContractRuntime, ContractRuntimeOptions, Contracts, LiveContractResolutionOptions, QUERY_FALLBACK_ORIGIN, createContract, createContractFromClient, withLiveContractAddresses };