@parity/product-sdk-host 0.14.1 → 0.15.0

package/dist/testing.js

@@ -89,6 +89,7 @@ function createFakeTruApiClient(options) {
         ringIndex: 0,
         ringRevision: 0
       }),
+      signVrf: () => okAsync({ preOutput: publicKey, proof: signature }),
       connectionStatusSubscribe: () => inertObservable()
     },
     signing: {

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * Test fakes for `@parity/product-sdk-host`.\n *\n * The host reaches its container through one cached `TrUApiClient`.\n * `createFakeHost()` injects a fake via `setTruApiClient` so every accessor\n * (`getHostLocalStorage`, `getAccountsProvider`, `getStatementStore`, `getTruApi`,\n * …) resolves against it and `isInsideContainer()` reports `true` — which also\n * makes a default `SignerManager`, `local-storage` auto-detection, and the\n * `statement-store` / `cloud-storage` host paths testable.\n *\n * Not modeled: the PAPI `chain` JSON-RPC surface behind `getHostProvider()` —\n * there's no chain-read fake, by design; the host owns RPC selection — and the\n * `chat` / `coinPayment` / `entropy` / `notifications` / `payment` /\n * `permissions` / `resourceAllocation` / `theme` domains. Touching an unmodeled\n * domain throws a descriptive error rather than failing with `undefined is not\n * a function`.\n *\n * @packageDocumentation\n */\nimport type { ObservableLike, Observer, Subscription, TrUApiClient } from \"@parity/truapi\";\nimport { okAsync } from \"neverthrow\";\n\nimport { setTruApiClient } from \"./transport.js\";\n\nexport { setTruApiClient };\n\n/**\n * The public surface of a generated truapi domain client. `keyof` skips private\n * members, so this is the shape a plain object can implement — the classes\n * themselves are unimplementable outside truapi because of their\n * `private transport`.\n */\ntype PublicSurface<C> = { [K in keyof C]: C[K] };\n\n/**\n * `TrUApiClient` seen through public surfaces only. The fake is checked against\n * this member-by-member, so drift from the generated client — a renamed method,\n * a changed request or response type — fails compilation here instead of\n * surfacing as a runtime mismatch in consumers' tests.\n */\ntype PublicTruApiClient = { [D in keyof TrUApiClient]: PublicSurface<TrUApiClient[D]> };\n\n/** Inlined to keep the `truapi` facade out of this entry's bundle. */\nfunction toHex(bytes: Uint8Array): `0x${string}` {\n    return `0x${Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\nfunction fakeSubscription(): Subscription {\n    return { unsubscribe: () => {}, subscriptionId: \"fake-subscription\" };\n}\n\n/**\n * Wrap a `subscribe` implementation into a full `ObservableLike`. The\n * `Symbol.observable` interop member only lands on the object when the symbol\n * is polyfilled (e.g. by rxjs) — same as the generated client — and nothing in\n * the SDK reads it; it exists to satisfy the interface.\n */\nfunction makeObservable<Item, Reason = never>(\n    subscribe: (observer?: Partial<Observer<Item, Reason>>) => Subscription,\n): ObservableLike<Item, Reason> {\n    const observable: ObservableLike<Item, Reason> = {\n        subscribe,\n        [Symbol.observable]() {\n            return observable;\n        },\n    };\n    return observable;\n}\n\n/** An `ObservableLike` that never emits. Drive statement delivery with `createFakeStatementTransport`. */\nfunction inertObservable<Item, Reason = never>(): ObservableLike<Item, Reason> {\n    return makeObservable(() => fakeSubscription());\n}\n\n/**\n * An `ObservableLike` that emits `item` once, asynchronously. The microtask defer\n * matters: the caller assigns its subscription handle from the return value, so\n * the item must arrive after `subscribe()` returns, not during it.\n */\nfunction oneShotObservable<Item>(item: Item): ObservableLike<Item> {\n    return makeObservable((observer) => {\n        queueMicrotask(() => observer?.next?.(item));\n        return fakeSubscription();\n    });\n}\n\n/**\n * A domain the fake deliberately doesn't model (see the module header). Any\n * member access throws with a pointer here, instead of the bare TypeError an\n * empty stub would give. The empty-object cast is the one concession a Proxy\n * needs; every modeled domain is checked structurally.\n */\nfunction notModeled<D extends keyof TrUApiClient>(domain: D): PublicSurface<TrUApiClient[D]> {\n    return new Proxy({} as PublicSurface<TrUApiClient[D]>, {\n        get(_target, member) {\n            // Stay quiet for inspection probes (console.log, await-resolution).\n            if (typeof member === \"symbol\" || member === \"then\") return undefined;\n            throw new Error(\n                `createFakeTruApiClient: \\`${domain}.${member}\\` is not modeled by the fake. See the @parity/product-sdk-host/testing module docs for what is covered.`,\n            );\n        },\n    });\n}\n\n/** Deterministic `0x`-prefixed preimage key derived from a hex value (FNV-1a). */\nfunction preimageKey(hexValue: string): `0x${string}` {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < hexValue.length; i++) {\n        h ^= hexValue.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    return `0x${(h >>> 0).toString(16).padStart(8, \"0\")}`;\n}\n\n/** Options for {@link createFakeTruApiClient}. */\nexport interface CreateFakeTruApiClientOptions {\n    /** `account.getUserId` primary username. Default `\"alice.dot\"`. */\n    primaryUsername?: string;\n    /** Product-account public key. Default 32 bytes of `0x11`. */\n    publicKey?: Uint8Array;\n    /** Bytes returned by the signing domain (signatures / proofs / transactions). Default 64 bytes of `0x22`. */\n    signature?: Uint8Array;\n    /** Whether `system.featureSupported` reports the chain supported. Default `true`. */\n    chainSupported?: boolean;\n    /** Seed the in-memory host localStorage, keyed by storage key. */\n    localStorage?: Record<string, Uint8Array>;\n    /** Legacy accounts returned by `account.getLegacyAccounts`. Default none. */\n    legacyAccounts?: Array<{ publicKey: Uint8Array; name: string }>;\n    /** Seed the in-memory preimage store, keyed by the `0x` preimage key. */\n    preimages?: Record<string, Uint8Array>;\n}\n\n/**\n * Build a fake `TrUApiClient` covering the domains the host accessors use:\n * `localStorage` (real in-memory KV), `account` / `signing` (canned data),\n * `statementStore`, `preimage`, and `system`. Unmodeled domains (`chain` et al —\n * see the module header) throw on member access.\n */\nexport function createFakeTruApiClient(options?: CreateFakeTruApiClientOptions): TrUApiClient {\n    const primaryUsername = options?.primaryUsername ?? \"alice.dot\";\n    const publicKey = toHex(options?.publicKey ?? new Uint8Array(32).fill(0x11));\n    const signature = toHex(options?.signature ?? new Uint8Array(64).fill(0x22));\n    const chainSupported = options?.chainSupported ?? true;\n\n    // Real in-memory KV (hex values) so getHostLocalStorage()/createLocalKvStore() round-trip.\n    const kv = new Map<string, `0x${string}`>();\n    for (const [key, value] of Object.entries(options?.localStorage ?? {})) {\n        kv.set(key, toHex(value));\n    }\n\n    const legacyAccounts = (options?.legacyAccounts ?? []).map((a) => ({\n        publicKey: toHex(a.publicKey),\n        name: a.name,\n    }));\n\n    // Preimage store (hex key -> hex value), for getPreimageManager() and submit/lookup round-trips.\n    const preimages = new Map<string, `0x${string}`>();\n    for (const [key, value] of Object.entries(options?.preimages ?? {})) {\n        preimages.set(key, toHex(value));\n    }\n\n    // Typed against the generated client's public surface: every method below is\n    // structurally checked, so a truapi signature change breaks this file's build,\n    // not a consumer's test run.\n    const client: PublicTruApiClient = {\n        localStorage: {\n            read: ({ key }) => okAsync({ value: kv.get(key) }),\n            write: ({ key, value }) => {\n                kv.set(key, value);\n                return okAsync(undefined);\n            },\n            clear: ({ key }) => {\n                kv.delete(key);\n                return okAsync(undefined);\n            },\n        },\n        account: {\n            getUserId: () => okAsync({ primaryUsername }),\n            requestLogin: () => okAsync(\"Success\"),\n            getAccount: () => okAsync({ account: { publicKey } }),\n            getAccountAlias: () =>\n                okAsync({ context: toHex(new Uint8Array([1])), alias: toHex(new Uint8Array([2])) }),\n            getLegacyAccounts: () => okAsync({ accounts: legacyAccounts }),\n            createAccountProof: () =>\n                okAsync({\n                    proof: signature,\n                    contextualAlias: {\n                        context: toHex(new Uint8Array([1])),\n                        alias: toHex(new Uint8Array([2])),\n                    },\n                    ringIndex: 0,\n                    ringRevision: 0,\n                }),\n            connectionStatusSubscribe: () => inertObservable(),\n        },\n        signing: {\n            createTransaction: () => okAsync({ transaction: signature }),\n            createTransactionWithLegacyAccount: () => okAsync({ transaction: signature }),\n            signRaw: () => okAsync({ signature }),\n            signRawWithLegacyAccount: () => okAsync({ signature }),\n            signPayload: () => okAsync({ signature }),\n            signPayloadWithLegacyAccount: () => okAsync({ signature }),\n        },\n        statementStore: {\n            subscribe: () => inertObservable(),\n            createProof: () =>\n                okAsync({ proof: { tag: \"Sr25519\", value: { signature, signer: publicKey } } }),\n            createProofAuthorized: () =>\n                okAsync({ proof: { tag: \"Sr25519\", value: { signature, signer: publicKey } } }),\n            submit: () => okAsync(undefined),\n        },\n        system: {\n            handshake: () => okAsync(undefined),\n            featureSupported: () => okAsync({ supported: chainSupported }),\n            navigateTo: () => okAsync(undefined),\n        },\n        preimage: {\n            lookupSubscribe: ({ request: { key } }) =>\n                oneShotObservable({ value: preimages.get(key) }),\n            submit: (value) => {\n                const key = preimageKey(value);\n                preimages.set(key, value);\n                return okAsync(key);\n            },\n        },\n        chain: notModeled(\"chain\"),\n        chat: notModeled(\"chat\"),\n        coinPayment: notModeled(\"coinPayment\"),\n        entropy: notModeled(\"entropy\"),\n        notifications: notModeled(\"notifications\"),\n        payment: notModeled(\"payment\"),\n        permissions: notModeled(\"permissions\"),\n        resourceAllocation: notModeled(\"resourceAllocation\"),\n        theme: notModeled(\"theme\"),\n    };\n\n    // A plain downcast, not an `unknown` bridge: each generated class is\n    // assignable to its `PublicSurface`, and TS has already verified every fake\n    // member against the generated signatures in the annotation above.\n    return client as TrUApiClient;\n}\n\n/**\n * A `beforeEach`-registered test hook, e.g. Vitest's `onTestFinished`. Read off\n * `globalThis` so we couple to no test framework: present under Vitest's globals\n * mode, absent everywhere else (Jest, `node:test`, plain scripts).\n */\ntype TestFinishedHook = (fn: () => void) => void;\n\n/** Handle returned by {@link createFakeHost}. */\nexport interface FakeHost extends Disposable {\n    /** The injected fake client (also what `getTruApi()` returns). */\n    client: TrUApiClient;\n    /** Clear the override. Idempotent; safe to call more than once. */\n    dispose(): void;\n    /** `using host = createFakeHost()` restores the real client at scope end. */\n    [Symbol.dispose](): void;\n}\n\n/**\n * Inject a fake client via {@link setTruApiClient} and return a disposer.\n *\n * Cleanup is guaranteed three ways, so a forgotten reset can't leak the override\n * into the next test or file: prefer `using` (scope-end disposal), otherwise the\n * handle self-registers `onTestFinished` when created inside a Vitest run, and\n * `dispose()` is always there to call by hand.\n *\n * @example\n * ```ts\n * import { createFakeHost } from \"@parity/product-sdk-host/testing\";\n *\n * test(\"host storage is reachable\", async () => {\n *   using host = createFakeHost({ primaryUsername: \"carol.dot\" });\n *   // getHostLocalStorage(), getAccountsProvider(), a default SignerManager, etc.\n *   // resolve the fake; the real client is restored when the test scope ends.\n * });\n * ```\n */\nexport function createFakeHost(options?: CreateFakeTruApiClientOptions): FakeHost {\n    const client = createFakeTruApiClient(options);\n    setTruApiClient(client);\n\n    let disposed = false;\n    const dispose = () => {\n        if (disposed) return;\n        disposed = true;\n        setTruApiClient(null);\n    };\n\n    // Best-effort auto-cleanup for the common case (a bare `const host =\n    // createFakeHost()` with no `using` and no manual reset). Under Vitest's\n    // globals mode `onTestFinished` is on `globalThis`; elsewhere it's absent and\n    // we quietly rely on `using` / manual `dispose()`.\n    const onTestFinished = (globalThis as { onTestFinished?: TestFinishedHook }).onTestFinished;\n    if (typeof onTestFinished === \"function\") {\n        try {\n            onTestFinished(dispose);\n        } catch {\n            // Not inside a running test (e.g. called at module scope) — ignore.\n        }\n    }\n\n    return {\n        client,\n        dispose,\n        [Symbol.dispose]: dispose,\n    };\n}\n\nif (import.meta.vitest) {\n    // Round-trip guard: drive the fake through the *real* host accessors.\n    const { describe, test, expect, afterEach } = import.meta.vitest;\n    const { getHostLocalStorage, getStatementStore, isInsideContainer } = await import(\n        \"./container.js\"\n    );\n    const { getAccountsProvider } = await import(\"./accounts.js\");\n    const { getPreimageManager } = await import(\"./truapi.js\");\n\n    const lookupOnce = (\n        manager: NonNullable<Awaited<ReturnType<typeof getPreimageManager>>>,\n        key: `0x${string}`,\n    ) =>\n        new Promise<Uint8Array | null>((resolve) => {\n            manager.lookup(key, (preimage) => {\n                if (preimage !== null) resolve(preimage);\n            });\n        });\n\n    afterEach(() => setTruApiClient(null));\n\n    describe(\"createFakeHost / createFakeTruApiClient\", () => {\n        test(\"host localStorage round-trips through the real adapter\", async () => {\n            createFakeHost();\n            const ls = await getHostLocalStorage();\n            expect(ls).not.toBeNull();\n            await ls?.writeString(\"k\", \"v\");\n            expect(await ls?.readString(\"k\")).toBe(\"v\");\n            await ls?.writeJSON(\"j\", { a: 1 });\n            expect(await ls?.readJSON(\"j\")).toEqual({ a: 1 });\n            expect(await ls?.readString(\"missing\")).toBe(\"\");\n        });\n\n        test(\"seeded localStorage is readable\", async () => {\n            createFakeHost({ localStorage: { greeting: new TextEncoder().encode(\"hi\") } });\n            const ls = await getHostLocalStorage();\n            expect(await ls?.readString(\"greeting\")).toBe(\"hi\");\n        });\n\n        test(\"accounts provider resolves the configured user\", async () => {\n            createFakeHost({ primaryUsername: \"carol.dot\" });\n            const accounts = await getAccountsProvider();\n            expect(accounts).not.toBeNull();\n            const userId = await accounts?.getUserId().match(\n                (v) => v,\n                () => null,\n            );\n            expect(userId?.primaryUsername).toBe(\"carol.dot\");\n        });\n\n        test(\"statement store resolves\", async () => {\n            createFakeHost();\n            expect(await getStatementStore()).not.toBeNull();\n        });\n\n        test(\"preimage manager reads seeded bytes and round-trips submit -> lookup\", async () => {\n            createFakeHost({ preimages: { \"0xabc\": new Uint8Array([1, 2, 3]) } });\n            const pm = await getPreimageManager();\n            expect(pm).not.toBeNull();\n\n            const seeded = await lookupOnce(pm!, \"0xabc\");\n            expect(Array.from(seeded ?? [])).toEqual([1, 2, 3]);\n\n            const key = await pm!.submit(new Uint8Array([9, 9]));\n            const back = await lookupOnce(pm!, key);\n            expect(Array.from(back ?? [])).toEqual([9, 9]);\n        });\n\n        test(\"isInsideContainer is true while set, false after dispose\", async () => {\n            const host = createFakeHost();\n            expect(await isInsideContainer()).toBe(true);\n            host.dispose();\n            expect(await isInsideContainer()).toBe(false);\n            expect(await getHostLocalStorage()).toBeNull();\n        });\n\n        test(\"Symbol.dispose clears the override and dispose is idempotent\", async () => {\n            {\n                using host = createFakeHost();\n                expect(await isInsideContainer()).toBe(true);\n                host.dispose(); // explicit + scope-end Symbol.dispose must not double-clear badly\n            }\n            expect(await isInsideContainer()).toBe(false);\n        });\n    });\n}\n"]}
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * Test fakes for `@parity/product-sdk-host`.\n *\n * The host reaches its container through one cached `TrUApiClient`.\n * `createFakeHost()` injects a fake via `setTruApiClient` so every accessor\n * (`getHostLocalStorage`, `getAccountsProvider`, `getStatementStore`, `getTruApi`,\n * …) resolves against it and `isInsideContainer()` reports `true` — which also\n * makes a default `SignerManager`, `local-storage` auto-detection, and the\n * `statement-store` / `cloud-storage` host paths testable.\n *\n * Not modeled: the PAPI `chain` JSON-RPC surface behind `getHostProvider()` —\n * there's no chain-read fake, by design; the host owns RPC selection — and the\n * `chat` / `coinPayment` / `entropy` / `notifications` / `payment` /\n * `permissions` / `resourceAllocation` / `theme` domains. Touching an unmodeled\n * domain throws a descriptive error rather than failing with `undefined is not\n * a function`.\n *\n * @packageDocumentation\n */\nimport type { ObservableLike, Observer, Subscription, TrUApiClient } from \"@parity/truapi\";\nimport { okAsync } from \"neverthrow\";\n\nimport { setTruApiClient } from \"./transport.js\";\n\nexport { setTruApiClient };\n\n/**\n * The public surface of a generated truapi domain client. `keyof` skips private\n * members, so this is the shape a plain object can implement — the classes\n * themselves are unimplementable outside truapi because of their\n * `private transport`.\n */\ntype PublicSurface<C> = { [K in keyof C]: C[K] };\n\n/**\n * `TrUApiClient` seen through public surfaces only. The fake is checked against\n * this member-by-member, so drift from the generated client — a renamed method,\n * a changed request or response type — fails compilation here instead of\n * surfacing as a runtime mismatch in consumers' tests.\n */\ntype PublicTruApiClient = { [D in keyof TrUApiClient]: PublicSurface<TrUApiClient[D]> };\n\n/** Inlined to keep the `truapi` facade out of this entry's bundle. */\nfunction toHex(bytes: Uint8Array): `0x${string}` {\n    return `0x${Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\nfunction fakeSubscription(): Subscription {\n    return { unsubscribe: () => {}, subscriptionId: \"fake-subscription\" };\n}\n\n/**\n * Wrap a `subscribe` implementation into a full `ObservableLike`. The\n * `Symbol.observable` interop member only lands on the object when the symbol\n * is polyfilled (e.g. by rxjs) — same as the generated client — and nothing in\n * the SDK reads it; it exists to satisfy the interface.\n */\nfunction makeObservable<Item, Reason = never>(\n    subscribe: (observer?: Partial<Observer<Item, Reason>>) => Subscription,\n): ObservableLike<Item, Reason> {\n    const observable: ObservableLike<Item, Reason> = {\n        subscribe,\n        [Symbol.observable]() {\n            return observable;\n        },\n    };\n    return observable;\n}\n\n/** An `ObservableLike` that never emits. Drive statement delivery with `createFakeStatementTransport`. */\nfunction inertObservable<Item, Reason = never>(): ObservableLike<Item, Reason> {\n    return makeObservable(() => fakeSubscription());\n}\n\n/**\n * An `ObservableLike` that emits `item` once, asynchronously. The microtask defer\n * matters: the caller assigns its subscription handle from the return value, so\n * the item must arrive after `subscribe()` returns, not during it.\n */\nfunction oneShotObservable<Item>(item: Item): ObservableLike<Item> {\n    return makeObservable((observer) => {\n        queueMicrotask(() => observer?.next?.(item));\n        return fakeSubscription();\n    });\n}\n\n/**\n * A domain the fake deliberately doesn't model (see the module header). Any\n * member access throws with a pointer here, instead of the bare TypeError an\n * empty stub would give. The empty-object cast is the one concession a Proxy\n * needs; every modeled domain is checked structurally.\n */\nfunction notModeled<D extends keyof TrUApiClient>(domain: D): PublicSurface<TrUApiClient[D]> {\n    return new Proxy({} as PublicSurface<TrUApiClient[D]>, {\n        get(_target, member) {\n            // Stay quiet for inspection probes (console.log, await-resolution).\n            if (typeof member === \"symbol\" || member === \"then\") return undefined;\n            throw new Error(\n                `createFakeTruApiClient: \\`${domain}.${member}\\` is not modeled by the fake. See the @parity/product-sdk-host/testing module docs for what is covered.`,\n            );\n        },\n    });\n}\n\n/** Deterministic `0x`-prefixed preimage key derived from a hex value (FNV-1a). */\nfunction preimageKey(hexValue: string): `0x${string}` {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < hexValue.length; i++) {\n        h ^= hexValue.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    return `0x${(h >>> 0).toString(16).padStart(8, \"0\")}`;\n}\n\n/** Options for {@link createFakeTruApiClient}. */\nexport interface CreateFakeTruApiClientOptions {\n    /** `account.getUserId` primary username. Default `\"alice.dot\"`. */\n    primaryUsername?: string;\n    /** Product-account public key. Default 32 bytes of `0x11`. */\n    publicKey?: Uint8Array;\n    /** Bytes returned by the signing domain (signatures / proofs / transactions). Default 64 bytes of `0x22`. */\n    signature?: Uint8Array;\n    /** Whether `system.featureSupported` reports the chain supported. Default `true`. */\n    chainSupported?: boolean;\n    /** Seed the in-memory host localStorage, keyed by storage key. */\n    localStorage?: Record<string, Uint8Array>;\n    /** Legacy accounts returned by `account.getLegacyAccounts`. Default none. */\n    legacyAccounts?: Array<{ publicKey: Uint8Array; name: string }>;\n    /** Seed the in-memory preimage store, keyed by the `0x` preimage key. */\n    preimages?: Record<string, Uint8Array>;\n}\n\n/**\n * Build a fake `TrUApiClient` covering the domains the host accessors use:\n * `localStorage` (real in-memory KV), `account` / `signing` (canned data),\n * `statementStore`, `preimage`, and `system`. Unmodeled domains (`chain` et al —\n * see the module header) throw on member access.\n */\nexport function createFakeTruApiClient(options?: CreateFakeTruApiClientOptions): TrUApiClient {\n    const primaryUsername = options?.primaryUsername ?? \"alice.dot\";\n    const publicKey = toHex(options?.publicKey ?? new Uint8Array(32).fill(0x11));\n    const signature = toHex(options?.signature ?? new Uint8Array(64).fill(0x22));\n    const chainSupported = options?.chainSupported ?? true;\n\n    // Real in-memory KV (hex values) so getHostLocalStorage()/createLocalKvStore() round-trip.\n    const kv = new Map<string, `0x${string}`>();\n    for (const [key, value] of Object.entries(options?.localStorage ?? {})) {\n        kv.set(key, toHex(value));\n    }\n\n    const legacyAccounts = (options?.legacyAccounts ?? []).map((a) => ({\n        publicKey: toHex(a.publicKey),\n        name: a.name,\n    }));\n\n    // Preimage store (hex key -> hex value), for getPreimageManager() and submit/lookup round-trips.\n    const preimages = new Map<string, `0x${string}`>();\n    for (const [key, value] of Object.entries(options?.preimages ?? {})) {\n        preimages.set(key, toHex(value));\n    }\n\n    // Typed against the generated client's public surface: every method below is\n    // structurally checked, so a truapi signature change breaks this file's build,\n    // not a consumer's test run.\n    const client: PublicTruApiClient = {\n        localStorage: {\n            read: ({ key }) => okAsync({ value: kv.get(key) }),\n            write: ({ key, value }) => {\n                kv.set(key, value);\n                return okAsync(undefined);\n            },\n            clear: ({ key }) => {\n                kv.delete(key);\n                return okAsync(undefined);\n            },\n        },\n        account: {\n            getUserId: () => okAsync({ primaryUsername }),\n            requestLogin: () => okAsync(\"Success\"),\n            getAccount: () => okAsync({ account: { publicKey } }),\n            getAccountAlias: () =>\n                okAsync({ context: toHex(new Uint8Array([1])), alias: toHex(new Uint8Array([2])) }),\n            getLegacyAccounts: () => okAsync({ accounts: legacyAccounts }),\n            createAccountProof: () =>\n                okAsync({\n                    proof: signature,\n                    contextualAlias: {\n                        context: toHex(new Uint8Array([1])),\n                        alias: toHex(new Uint8Array([2])),\n                    },\n                    ringIndex: 0,\n                    ringRevision: 0,\n                }),\n            signVrf: () => okAsync({ preOutput: publicKey, proof: signature }),\n            connectionStatusSubscribe: () => inertObservable(),\n        },\n        signing: {\n            createTransaction: () => okAsync({ transaction: signature }),\n            createTransactionWithLegacyAccount: () => okAsync({ transaction: signature }),\n            signRaw: () => okAsync({ signature }),\n            signRawWithLegacyAccount: () => okAsync({ signature }),\n            signPayload: () => okAsync({ signature }),\n            signPayloadWithLegacyAccount: () => okAsync({ signature }),\n        },\n        statementStore: {\n            subscribe: () => inertObservable(),\n            createProof: () =>\n                okAsync({ proof: { tag: \"Sr25519\", value: { signature, signer: publicKey } } }),\n            createProofAuthorized: () =>\n                okAsync({ proof: { tag: \"Sr25519\", value: { signature, signer: publicKey } } }),\n            submit: () => okAsync(undefined),\n        },\n        system: {\n            handshake: () => okAsync(undefined),\n            featureSupported: () => okAsync({ supported: chainSupported }),\n            navigateTo: () => okAsync(undefined),\n        },\n        preimage: {\n            lookupSubscribe: ({ request: { key } }) =>\n                oneShotObservable({ value: preimages.get(key) }),\n            submit: (value) => {\n                const key = preimageKey(value);\n                preimages.set(key, value);\n                return okAsync(key);\n            },\n        },\n        chain: notModeled(\"chain\"),\n        chat: notModeled(\"chat\"),\n        coinPayment: notModeled(\"coinPayment\"),\n        entropy: notModeled(\"entropy\"),\n        notifications: notModeled(\"notifications\"),\n        payment: notModeled(\"payment\"),\n        permissions: notModeled(\"permissions\"),\n        resourceAllocation: notModeled(\"resourceAllocation\"),\n        theme: notModeled(\"theme\"),\n    };\n\n    // A plain downcast, not an `unknown` bridge: each generated class is\n    // assignable to its `PublicSurface`, and TS has already verified every fake\n    // member against the generated signatures in the annotation above.\n    return client as TrUApiClient;\n}\n\n/**\n * A `beforeEach`-registered test hook, e.g. Vitest's `onTestFinished`. Read off\n * `globalThis` so we couple to no test framework: present under Vitest's globals\n * mode, absent everywhere else (Jest, `node:test`, plain scripts).\n */\ntype TestFinishedHook = (fn: () => void) => void;\n\n/** Handle returned by {@link createFakeHost}. */\nexport interface FakeHost extends Disposable {\n    /** The injected fake client (also what `getTruApi()` returns). */\n    client: TrUApiClient;\n    /** Clear the override. Idempotent; safe to call more than once. */\n    dispose(): void;\n    /** `using host = createFakeHost()` restores the real client at scope end. */\n    [Symbol.dispose](): void;\n}\n\n/**\n * Inject a fake client via {@link setTruApiClient} and return a disposer.\n *\n * Cleanup is guaranteed three ways, so a forgotten reset can't leak the override\n * into the next test or file: prefer `using` (scope-end disposal), otherwise the\n * handle self-registers `onTestFinished` when created inside a Vitest run, and\n * `dispose()` is always there to call by hand.\n *\n * @example\n * ```ts\n * import { createFakeHost } from \"@parity/product-sdk-host/testing\";\n *\n * test(\"host storage is reachable\", async () => {\n *   using host = createFakeHost({ primaryUsername: \"carol.dot\" });\n *   // getHostLocalStorage(), getAccountsProvider(), a default SignerManager, etc.\n *   // resolve the fake; the real client is restored when the test scope ends.\n * });\n * ```\n */\nexport function createFakeHost(options?: CreateFakeTruApiClientOptions): FakeHost {\n    const client = createFakeTruApiClient(options);\n    setTruApiClient(client);\n\n    let disposed = false;\n    const dispose = () => {\n        if (disposed) return;\n        disposed = true;\n        setTruApiClient(null);\n    };\n\n    // Best-effort auto-cleanup for the common case (a bare `const host =\n    // createFakeHost()` with no `using` and no manual reset). Under Vitest's\n    // globals mode `onTestFinished` is on `globalThis`; elsewhere it's absent and\n    // we quietly rely on `using` / manual `dispose()`.\n    const onTestFinished = (globalThis as { onTestFinished?: TestFinishedHook }).onTestFinished;\n    if (typeof onTestFinished === \"function\") {\n        try {\n            onTestFinished(dispose);\n        } catch {\n            // Not inside a running test (e.g. called at module scope) — ignore.\n        }\n    }\n\n    return {\n        client,\n        dispose,\n        [Symbol.dispose]: dispose,\n    };\n}\n\nif (import.meta.vitest) {\n    // Round-trip guard: drive the fake through the *real* host accessors.\n    const { describe, test, expect, afterEach } = import.meta.vitest;\n    const { getHostLocalStorage, getStatementStore, isInsideContainer } = await import(\n        \"./container.js\"\n    );\n    const { getAccountsProvider } = await import(\"./accounts.js\");\n    const { getPreimageManager } = await import(\"./truapi.js\");\n\n    const lookupOnce = (\n        manager: NonNullable<Awaited<ReturnType<typeof getPreimageManager>>>,\n        key: `0x${string}`,\n    ) =>\n        new Promise<Uint8Array | null>((resolve) => {\n            manager.lookup(key, (preimage) => {\n                if (preimage !== null) resolve(preimage);\n            });\n        });\n\n    afterEach(() => setTruApiClient(null));\n\n    describe(\"createFakeHost / createFakeTruApiClient\", () => {\n        test(\"host localStorage round-trips through the real adapter\", async () => {\n            createFakeHost();\n            const ls = await getHostLocalStorage();\n            expect(ls).not.toBeNull();\n            await ls?.writeString(\"k\", \"v\");\n            expect(await ls?.readString(\"k\")).toBe(\"v\");\n            await ls?.writeJSON(\"j\", { a: 1 });\n            expect(await ls?.readJSON(\"j\")).toEqual({ a: 1 });\n            expect(await ls?.readString(\"missing\")).toBe(\"\");\n        });\n\n        test(\"seeded localStorage is readable\", async () => {\n            createFakeHost({ localStorage: { greeting: new TextEncoder().encode(\"hi\") } });\n            const ls = await getHostLocalStorage();\n            expect(await ls?.readString(\"greeting\")).toBe(\"hi\");\n        });\n\n        test(\"accounts provider resolves the configured user\", async () => {\n            createFakeHost({ primaryUsername: \"carol.dot\" });\n            const accounts = await getAccountsProvider();\n            expect(accounts).not.toBeNull();\n            const userId = await accounts?.getUserId().match(\n                (v) => v,\n                () => null,\n            );\n            expect(userId?.primaryUsername).toBe(\"carol.dot\");\n        });\n\n        test(\"statement store resolves\", async () => {\n            createFakeHost();\n            expect(await getStatementStore()).not.toBeNull();\n        });\n\n        test(\"preimage manager reads seeded bytes and round-trips submit -> lookup\", async () => {\n            createFakeHost({ preimages: { \"0xabc\": new Uint8Array([1, 2, 3]) } });\n            const pm = await getPreimageManager();\n            expect(pm).not.toBeNull();\n\n            const seeded = await lookupOnce(pm!, \"0xabc\");\n            expect(Array.from(seeded ?? [])).toEqual([1, 2, 3]);\n\n            const key = await pm!.submit(new Uint8Array([9, 9]));\n            const back = await lookupOnce(pm!, key);\n            expect(Array.from(back ?? [])).toEqual([9, 9]);\n        });\n\n        test(\"isInsideContainer is true while set, false after dispose\", async () => {\n            const host = createFakeHost();\n            expect(await isInsideContainer()).toBe(true);\n            host.dispose();\n            expect(await isInsideContainer()).toBe(false);\n            expect(await getHostLocalStorage()).toBeNull();\n        });\n\n        test(\"Symbol.dispose clears the override and dispose is idempotent\", async () => {\n            {\n                using host = createFakeHost();\n                expect(await isInsideContainer()).toBe(true);\n                host.dispose(); // explicit + scope-end Symbol.dispose must not double-clear badly\n            }\n            expect(await isInsideContainer()).toBe(false);\n        });\n    });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk-host",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "description": "Host container detection and storage access for Polkadot Desktop and Mobile environments",
   "type": "module",
   "sideEffects": false,
@@ -22,13 +22,13 @@
     "src"
   ],
   "dependencies": {
-    "@parity/truapi": "^0.5.0",
+    "@parity/truapi": "^0.6.0",
     "@polkadot-api/json-rpc-provider": "^0.2.0",
     "@polkadot-api/substrate-bindings": "^0.20.3",
     "neverthrow": "^8.2.0",
     "polkadot-api": "^2.1.6",
-    "@parity/product-sdk-logger": "0.1.1",
     "@parity/product-sdk-errors": "0.2.0",
+    "@parity/product-sdk-logger": "0.1.1",
     "@parity/result": "0.2.0"
   },
   "devDependencies": {

package/src/accounts.ts

@@ -27,6 +27,7 @@ import { AccountId, type PolkadotSigner } from "polkadot-api";
 
 import type {
     ContextualAlias as WireAlias,
+    DerivationIndex,
     HostAccountConnectionStatusSubscribeItem,
     HostAccountCreateProofResponse as WireRingVRFProof,
     HostRequestLoginResponse,
@@ -54,16 +55,22 @@ import type { HostSubscription } from "./types.js";
  * - `RingLocation` — where the ring lives (`{ chainId, junctions }`; junctions
  *   address the ring via `PalletInstance` / `CollectionId` steps).
  * - `ProductProofContext` — the product-scoped proof context
- *   (`{ productId, suffix }`), hashed by the host into the 32-byte context a
+ *   (`{ productId, suffix }`), expanded by the host into the 32-byte context a
  *   proof or alias is bound to.
+ * - `DerivationIndex` — the tagged selector `ProductProofContext.suffix`
+ *   carries: `{ tag: "Left", value: number }` for a plain index, or
+ *   `{ tag: "Right", value: HexString }` for a raw 32-byte index.
  */
-export type { ProductProofContext, RingLocation } from "@parity/truapi";
+export type { DerivationIndex, ProductProofContext, RingLocation } from "@parity/truapi";
 
 // The account/alias shapes come from `@parity/truapi`'s generated specs; we
 // derive the SDK-facing views from them so the field inventory tracks the
-// protocol automatically, and override only the byte fields the adapter
-// decodes (the wire types carry `0x`-prefixed `HexString`s, whereas these
-// surface decoded `Uint8Array`s). Same pattern as `@parity/product-sdk-statement-store`.
+// protocol automatically, and override only the fields the adapter re-encodes:
+// byte fields decoded from `0x`-prefixed `HexString`s to `Uint8Array`s, and
+// the tagged derivation-index selector kept as a plain `number` (wrapped back
+// into `Left` at the wire boundary). Shapes re-exported verbatim (e.g.
+// `ProductProofContext`) track the wire as-is. Same pattern as
+// `@parity/product-sdk-statement-store`.
 
 /**
  * One of the user's existing wallet accounts, surfaced through the host and
@@ -86,10 +93,14 @@ export type HostAccount = Omit<WireLegacyAccount, "publicKey"> & {
  *
  * Combines `@parity/truapi`'s `ProductAccountId` (the `{ dotNsIdentifier,
  * derivationIndex }` lookup key) with the `ProductAccount` payload, with
- * `publicKey` decoded to bytes.
+ * `publicKey` decoded to bytes and `derivationIndex` kept as the plain
+ * numeric index (the adapter wraps it into the wire's tagged
+ * {@link DerivationIndex} selector).
  */
-export type ProductAccount = ProductAccountId &
+export type ProductAccount = Omit<ProductAccountId, "derivationIndex"> &
     Omit<WireProductAccount, "publicKey"> & {
+        /** Plain account index within the product subtree. */
+        derivationIndex: number;
         /** Raw public key bytes. */
         publicKey: Uint8Array;
     };
@@ -217,6 +228,14 @@ function toHostExtensions(
     }));
 }
 
+/** Build the wire `ProductAccountId`, wrapping the plain index as a `Left` selector. */
+function toWireProductAccountId(
+    dotNsIdentifier: string,
+    derivationIndex: number,
+): ProductAccountId {
+    return { dotNsIdentifier, derivationIndex: { tag: "Left", value: derivationIndex } };
+}
+
 /** Build an {@link AccountsProvider} over a TruAPI client's `account` / `signing` domains. */
 function adaptAccountsProvider(client: TrUApiClient): AccountsProvider {
     const account = client.account;
@@ -233,7 +252,9 @@ function adaptAccountsProvider(client: TrUApiClient): AccountsProvider {
         },
         getProductAccount(dotNsIdentifier, derivationIndex = 0) {
             return account
-                .getAccount({ productAccountId: { dotNsIdentifier, derivationIndex } })
+                .getAccount({
+                    productAccountId: toWireProductAccountId(dotNsIdentifier, derivationIndex),
+                })
                 .map((response) => ({
                     publicKey: fromHex(response.account.publicKey),
                     dotNsIdentifier,
@@ -272,10 +293,10 @@ function adaptAccountsProvider(client: TrUApiClient): AccountsProvider {
                 }));
         },
         getProductAccountSigner(account_) {
-            const productAccountId = {
-                dotNsIdentifier: account_.dotNsIdentifier,
-                derivationIndex: account_.derivationIndex,
-            };
+            const productAccountId = toWireProductAccountId(
+                account_.dotNsIdentifier,
+                account_.derivationIndex,
+            );
 
             return {
                 publicKey: account_.publicKey,
@@ -428,7 +449,12 @@ if (import.meta.vitest) {
         );
         expect(calls[0]).toEqual([
             "getAccount",
-            { productAccountId: { dotNsIdentifier: "app.dot", derivationIndex: 2 } },
+            {
+                productAccountId: {
+                    dotNsIdentifier: "app.dot",
+                    derivationIndex: { tag: "Left", value: 2 },
+                },
+            },
         ]);
         expect(account).toEqual({
             publicKey: fromHex("0xaa"),
@@ -443,7 +469,7 @@ if (import.meta.vitest) {
         const provider = adaptAccountsProvider(client);
         const proof = await provider
             .createRingVRFProof(
-                { productId: "app.dot", suffix: "0x00" },
+                { productId: "app.dot", suffix: { tag: "Left", value: 0 } },
                 { chainId: "0x01", junctions: [{ tag: "PalletInstance", value: 1 }] },
                 new Uint8Array([1, 2, 3]),
             )
@@ -453,7 +479,7 @@ if (import.meta.vitest) {
             );
         expect(calls[0][0]).toBe("createAccountProof");
         expect(calls[0][1]).toEqual({
-            context: { productId: "app.dot", suffix: "0x00" },
+            context: { productId: "app.dot", suffix: { tag: "Left", value: 0 } },
             ringLocation: { chainId: "0x01", junctions: [{ tag: "PalletInstance", value: 1 }] },
             message: toHex(new Uint8Array([1, 2, 3])),
         });
@@ -478,7 +504,7 @@ if (import.meta.vitest) {
         expect(calls.at(-1)).toEqual([
             "signRaw",
             {
-                account: { dotNsIdentifier: "app.dot", derivationIndex: 0 },
+                account: { dotNsIdentifier: "app.dot", derivationIndex: { tag: "Left", value: 0 } },
                 payload: { tag: "Bytes", value: { bytes: toHex(new Uint8Array([9, 9])) } },
             },
         ]);
@@ -565,7 +591,7 @@ if (import.meta.vitest) {
         expect(calls.at(-1)).toEqual([
             "createTransaction",
             {
-                signer: { dotNsIdentifier: "app.dot", derivationIndex: 0 },
+                signer: { dotNsIdentifier: "app.dot", derivationIndex: { tag: "Left", value: 0 } },
                 genesisHash: toHex(new Uint8Array([0x01, 0x02])),
                 callData: toHex(new Uint8Array([0xca, 0x11])),
                 extensions: expectedHostExtensions,

package/src/index.ts

@@ -70,6 +70,7 @@ export type { HostErrorPayload } from "./errors.js";
 export { getAccountsProvider } from "./accounts.js";
 export type {
     AccountsProvider,
+    DerivationIndex,
     HostAccount,
     ProductAccount,
     ContextualAlias,

package/src/payments.ts

@@ -97,7 +97,7 @@ function adaptPaymentManager(client: TrUApiClient): PaymentManager {
  * const payments = await getPaymentManager();
  * if (payments) {
  *   const sub = payments.subscribeBalance((b) => { ... });
- *   await payments.topUp(1_000_000n, { tag: "ProductAccount", value: { derivationIndex: 0 } });
+ *   await payments.topUp(1_000_000n, { tag: "ProductAccount", value: { derivationIndex: { tag: "Left", value: 0 } } });
  *   const { id } = await payments.requestPayment(500n, "0x…");
  *   sub.unsubscribe();
  * }

package/src/testing.ts

@@ -193,6 +193,7 @@ export function createFakeTruApiClient(options?: CreateFakeTruApiClientOptions):
                     ringIndex: 0,
                     ringRevision: 0,
                 }),
+            signVrf: () => okAsync({ preOutput: publicKey, proof: signature }),
             connectionStatusSubscribe: () => inertObservable(),
         },
         signing: {

package/src/truapi.ts

@@ -183,6 +183,8 @@ export async function createHostPreimageManager(): Promise<PreimageManager | nul
 // Resource-allocation / permission types, re-exported verbatim from
 // `@parity/truapi` (imported above for the local signatures):
 // - `AllocatableResource` — resource types requestable via `requestResourceAllocation`.
+//   Since truapi 0.6.0 its `SmartContractAllowance` variant carries the tagged
+//   `DerivationIndex` selector (`{ tag: "Left", value: number }` for a plain index).
 // - `AllocationOutcome` — per-resource outcome, the string union
 //   `"Allocated" | "Rejected" | "NotAvailable"` (RFC-10).
 // - `RemotePermission` — permission the dapp asks the host to grant via `requestPermission`.