@parity/product-sdk-bulletin 0.1.0 → 0.2.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/authorization.ts","../src/errors.ts","../src/cid.ts","../src/gateway.ts","../src/query.ts","../src/resolve-query.ts","../src/upload.ts","../src/resolve-signer.ts"],"sourcesContent":["import { getChainAPI } from \"@parity/product-sdk-chain-client\";\nimport type { PolkadotSigner } from \"polkadot-api\";\n\nimport { checkAuthorization } from \"./authorization.js\";\nimport {\n    type CidCodec,\n    type HashAlgorithm,\n    cidToPreimageKey,\n    computeCid,\n    hashToCid,\n} from \"./cid.js\";\nimport { cidExists, getGateway, gatewayUrl } from \"./gateway.js\";\nimport { executeQuery } from \"./query.js\";\nimport { resolveQueryStrategy, type QueryStrategy } from \"./resolve-query.js\";\nimport { batchUpload, upload } from \"./upload.js\";\nimport type {\n    AuthorizationStatus,\n    BatchUploadItem,\n    BatchUploadOptions,\n    BatchUploadResult,\n    BulletinApi,\n    Environment,\n    QueryOptions,\n    UploadOptions,\n    UploadResult,\n} from \"./types.js\";\n\n/**\n * Ergonomic entry point for Bulletin Chain operations.\n *\n * Bundles a typed Bulletin API (from chain-client) and an IPFS gateway URL\n * so callers don't need to re-pass them on every call.\n *\n * Both upload and query paths use the host container APIs:\n * - **Uploads** — the host preimage API signs and submits automatically.\n * - **Queries** (`fetchBytes`/`fetchJson`) — uses host preimage lookup with caching.\n *\n * @example\n * ```ts\n * const bulletin = await BulletinClient.create(\"paseo\");\n * const result = await bulletin.upload(fileBytes);\n * const metadata = await bulletin.fetchJson<Metadata>(result.cid);\n * ```\n */\nexport class BulletinClient {\n    readonly api: BulletinApi;\n    readonly gateway: string;\n\n    private queryStrategyPromise: Promise<QueryStrategy> | null = null;\n\n    private constructor(api: BulletinApi, gateway: string) {\n        this.api = api;\n        this.gateway = gateway;\n    }\n\n    /** Lazily resolve and cache the query strategy for the client lifetime. */\n    private resolveQuery(): Promise<QueryStrategy> {\n        if (!this.queryStrategyPromise) {\n            this.queryStrategyPromise = resolveQueryStrategy();\n        }\n        return this.queryStrategyPromise;\n    }\n\n    /** Create from an environment — resolves API via chain-client, gateway from known list. */\n    static async create(env: Environment): Promise<BulletinClient> {\n        const chain = await getChainAPI(env);\n        return new BulletinClient(chain.bulletin, getGateway(env));\n    }\n\n    /** Create from an explicit API and gateway (custom setups, testing). */\n    static from(api: BulletinApi, gateway: string): BulletinClient {\n        return new BulletinClient(api, gateway);\n    }\n\n    /** Compute CID without uploading. Static — no instance needed. */\n    static computeCid(data: Uint8Array): string {\n        return computeCid(data);\n    }\n\n    /**\n     * Reconstruct a CID from a `0x`-prefixed hex hash. Static — no instance needed.\n     *\n     * Useful for converting on-chain hashes back to CIDs for IPFS gateway lookups.\n     * Pass optional hash algorithm and codec to match the on-chain CID configuration.\n     *\n     * @see {@link hashToCid} for full documentation.\n     */\n    static hashToCid(hexHash: `0x${string}`, hashCode?: HashAlgorithm, codec?: CidCodec): string {\n        return hashToCid(hexHash, hashCode, codec);\n    }\n\n    /**\n     * Upload data to the Bulletin Chain.\n     *\n     * @param data   - Raw bytes to store.\n     * @param signer - Optional signer. When omitted, uses the host preimage API.\n     * @param options - Upload options (timeout, waitFor, status callback).\n     */\n    async upload(\n        data: Uint8Array,\n        signer?: PolkadotSigner,\n        options?: Omit<UploadOptions, \"gateway\">,\n    ): Promise<UploadResult> {\n        return upload(this.api, data, signer, { ...options, gateway: this.gateway });\n    }\n\n    /**\n     * Upload multiple items sequentially.\n     *\n     * @param items  - Array of items to upload, each with data and a label.\n     * @param signer - Optional signer. When omitted, auto-resolved.\n     * @param options - Batch upload options (timeout, progress callback).\n     */\n    async batchUpload(\n        items: BatchUploadItem[],\n        signer?: PolkadotSigner,\n        options?: Omit<BatchUploadOptions, \"gateway\">,\n    ): Promise<BatchUploadResult[]> {\n        return batchUpload(this.api, items, signer, { ...options, gateway: this.gateway });\n    }\n\n    /**\n     * Fetch raw bytes by CID.\n     *\n     * Uses host preimage lookup with caching.\n     */\n    async fetchBytes(cid: string, options?: QueryOptions): Promise<Uint8Array> {\n        const strategy = await this.resolveQuery();\n        return executeQuery(strategy, cid, options);\n    }\n\n    /**\n     * Fetch and parse JSON by CID.\n     *\n     * Auto-resolves query path (same as {@link fetchBytes}).\n     */\n    async fetchJson<T>(cid: string, options?: QueryOptions): Promise<T> {\n        const bytes = await this.fetchBytes(cid, options);\n        return JSON.parse(new TextDecoder().decode(bytes)) as T;\n    }\n\n    /** Check if a CID exists on the gateway. */\n    async cidExists(cid: string): Promise<boolean> {\n        return cidExists(cid, this.gateway);\n    }\n\n    /** Build the full gateway URL for a CID. */\n    gatewayUrl(cid: string): string {\n        return gatewayUrl(cid, this.gateway);\n    }\n\n    /**\n     * Check whether an account is authorized to store data on the Bulletin Chain.\n     *\n     * Use as a pre-flight check before {@link upload} to provide clear UX\n     * instead of letting the transaction fail mid-execution.\n     *\n     * @param address - SS58-encoded account address to check.\n     * @returns Authorization status with remaining quota.\n     *\n     * @see {@link checkAuthorization} for the standalone function equivalent.\n     */\n    async checkAuthorization(address: string): Promise<AuthorizationStatus> {\n        return checkAuthorization(this.api, address);\n    }\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    const mockApi = {\n        tx: {\n            TransactionStorage: {\n                store: vi.fn().mockReturnValue({\n                    signSubmitAndWatch: () => ({\n                        subscribe: (handlers: { next: (e: unknown) => void }) => {\n                            queueMicrotask(() => {\n                                handlers.next({ type: \"signed\", txHash: \"0x\" });\n                                handlers.next({\n                                    type: \"txBestBlocksState\",\n                                    txHash: \"0x\",\n                                    found: true,\n                                    ok: true,\n                                    block: { hash: \"0xblock\", number: 1, index: 0 },\n                                    events: [],\n                                });\n                            });\n                            return { unsubscribe: vi.fn() };\n                        },\n                    }),\n                }),\n            },\n        },\n    } as unknown as BulletinApi;\n\n    const GATEWAY = \"https://test-gw/ipfs/\";\n\n    describe(\"BulletinClient\", () => {\n        test(\"from() creates client with given API and gateway\", () => {\n            const client = BulletinClient.from(mockApi, GATEWAY);\n            expect(client.api).toBe(mockApi);\n            expect(client.gateway).toBe(GATEWAY);\n        });\n\n        test(\"computeCid() is static and delegates to standalone\", () => {\n            const data = new TextEncoder().encode(\"hello\");\n            const cid = BulletinClient.computeCid(data);\n            expect(cid).toBe(computeCid(data));\n        });\n\n        test(\"hashToCid() is static and delegates to standalone\", () => {\n            const data = new TextEncoder().encode(\"hello\");\n            const cid = computeCid(data);\n            const key = cidToPreimageKey(cid);\n            expect(BulletinClient.hashToCid(key)).toBe(cid);\n        });\n\n        test(\"gatewayUrl() returns gateway + cid\", () => {\n            const client = BulletinClient.from(mockApi, GATEWAY);\n            expect(client.gatewayUrl(\"bafyabc\")).toBe(\"https://test-gw/ipfs/bafyabc\");\n        });\n\n        test(\"upload() passes gateway from client with explicit signer\", async () => {\n            const client = BulletinClient.from(mockApi, GATEWAY);\n            const data = new TextEncoder().encode(\"test\");\n            const result = await client.upload(data, {} as PolkadotSigner);\n            expect(result.gatewayUrl).toContain(GATEWAY);\n            expect(result.cid).toBeTruthy();\n        });\n\n        // Note: fetchBytes and fetchJson tests require e2e testing as they\n        // depend on the host container environment for strategy resolution.\n\n        test(\"checkAuthorization delegates to standalone\", async () => {\n            const authMockApi = {\n                ...mockApi,\n                query: {\n                    TransactionStorage: {\n                        Authorizations: {\n                            getValue: vi.fn().mockResolvedValue({\n                                extent: { transactions: 5, bytes: 2000n },\n                                expiration: 100,\n                            }),\n                        },\n                    },\n                },\n            } as unknown as BulletinApi;\n            const client = BulletinClient.from(authMockApi, GATEWAY);\n            const status = await client.checkAuthorization(\"5GrwvaEF...\");\n            expect(status.authorized).toBe(true);\n            expect(status.remainingTransactions).toBe(5);\n            expect(status.remainingBytes).toBe(2000n);\n        });\n    });\n}\n","import { createLogger } from \"@parity/product-sdk-logger\";\nimport { Enum } from \"polkadot-api\";\n\nimport { BulletinAuthorizationError } from \"./errors.js\";\nimport type { AuthorizationStatus, BulletinApi } from \"./types.js\";\n\nconst log = createLogger(\"bulletin\");\n\nconst NOT_AUTHORIZED: AuthorizationStatus = Object.freeze({\n    authorized: false,\n    remainingTransactions: 0,\n    remainingBytes: 0n,\n    expiration: 0,\n});\n\n/**\n * Check whether an account is authorized to store data on the Bulletin Chain.\n *\n * Queries `TransactionStorage.Authorizations` for the given address and returns\n * the raw authorization quota. Use this as a pre-flight check before calling\n * {@link upload} to provide clear UX (\"not authorized\" / \"insufficient quota\")\n * instead of letting the transaction fail mid-execution.\n *\n * The expiration block number is returned as-is — the chain enforces expiration\n * at submission time, so callers can optionally compare against the current\n * block for display purposes.\n *\n * @param api     - Typed Bulletin Chain API instance.\n * @param address - SS58-encoded account address to check.\n * @returns Authorization status with remaining quota.\n *\n * @example\n * ```ts\n * import { checkAuthorization } from \"@parity/product-sdk-bulletin\";\n *\n * const auth = await checkAuthorization(api, address);\n * if (!auth.authorized) {\n *     console.error(\"Account is not authorized for bulletin storage\");\n * } else if (auth.remainingBytes < BigInt(fileBytes.length)) {\n *     console.error(`Insufficient quota: ${auth.remainingBytes} bytes remaining`);\n * }\n * ```\n *\n * @see {@link BulletinClient.checkAuthorization} for the client method equivalent.\n */\nexport async function checkAuthorization(\n    api: BulletinApi,\n    address: string,\n): Promise<AuthorizationStatus> {\n    let auth;\n    try {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        auth = await (api as any).query.TransactionStorage.Authorizations.getValue(\n            Enum(\"Account\", address),\n        );\n    } catch (error) {\n        log.error(\"checkAuthorization: query failed\", { address, error });\n        throw new BulletinAuthorizationError(address, error);\n    }\n\n    if (!auth) {\n        log.debug(\"checkAuthorization: no authorization found\", { address });\n        return NOT_AUTHORIZED;\n    }\n\n    const status: AuthorizationStatus = {\n        authorized: true,\n        remainingTransactions: auth.extent.transactions,\n        remainingBytes: auth.extent.bytes,\n        expiration: auth.expiration,\n    };\n\n    log.debug(\"checkAuthorization\", {\n        address,\n        remainingTransactions: status.remainingTransactions,\n        remainingBytes: status.remainingBytes.toString(),\n        expiration: status.expiration,\n    });\n\n    return status;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    function createMockApi(authResult: unknown) {\n        return {\n            query: {\n                TransactionStorage: {\n                    Authorizations: {\n                        getValue: vi.fn().mockResolvedValue(authResult),\n                    },\n                },\n            },\n        } as unknown as BulletinApi;\n    }\n\n    describe(\"checkAuthorization\", () => {\n        test(\"returns not authorized when no authorization exists\", async () => {\n            const api = createMockApi(undefined);\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(false);\n            expect(status.remainingTransactions).toBe(0);\n            expect(status.remainingBytes).toBe(0n);\n            expect(status.expiration).toBe(0);\n        });\n\n        test(\"returns authorization with full quota\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 10, bytes: 1_000_000n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingTransactions).toBe(10);\n            expect(status.remainingBytes).toBe(1_000_000n);\n            expect(status.expiration).toBe(999);\n        });\n\n        test(\"returns authorization with zero transactions remaining\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 0, bytes: 1_000_000n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingTransactions).toBe(0);\n        });\n\n        test(\"returns authorization with zero bytes remaining\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 5, bytes: 0n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingBytes).toBe(0n);\n        });\n\n        test(\"preserves expiration block number\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 1, bytes: 500n },\n                expiration: 12345,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.expiration).toBe(12345);\n        });\n\n        test(\"throws BulletinAuthorizationError when query fails\", async () => {\n            const api = {\n                query: {\n                    TransactionStorage: {\n                        Authorizations: {\n                            getValue: vi.fn().mockRejectedValue(new Error(\"RPC connection lost\")),\n                        },\n                    },\n                },\n            } as unknown as BulletinApi;\n\n            const err = await checkAuthorization(api, \"5GrwvaEF...\").catch((e: unknown) => e);\n            expect(err).toBeInstanceOf(BulletinAuthorizationError);\n            const error = err as BulletinAuthorizationError;\n            expect(error.address).toBe(\"5GrwvaEF...\");\n            expect(error.cause).toBeInstanceOf(Error);\n            expect((error.cause as Error).message).toBe(\"RPC connection lost\");\n        });\n\n        test(\"passes correct Enum key to the query\", async () => {\n            const getValue = vi.fn().mockResolvedValue(undefined);\n            const api = {\n                query: {\n                    TransactionStorage: {\n                        Authorizations: { getValue },\n                    },\n                },\n            } as unknown as BulletinApi;\n\n            await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(getValue).toHaveBeenCalledTimes(1);\n            const arg = getValue.mock.calls[0][0];\n            expect(arg.type).toBe(\"Account\");\n            expect(arg.value).toBe(\"5GrwvaEF...\");\n        });\n    });\n}\n","/**\n * Base class for all Bulletin Chain errors.\n *\n * Use `instanceof BulletinError` to catch any bulletin-related error.\n *\n * @example\n * ```ts\n * try {\n *   await bulletin.upload(data);\n * } catch (e) {\n *   if (e instanceof BulletinError) {\n *     console.error(\"Bulletin operation failed:\", e.message);\n *   }\n * }\n * ```\n */\nexport class BulletinError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = \"BulletinError\";\n    }\n}\n\n/**\n * The host preimage API is unavailable.\n *\n * Thrown when bulletin operations require the host container but it's not available.\n * This typically means the SDK is running outside of Polkadot Browser/Desktop.\n */\nexport class BulletinHostUnavailableError extends BulletinError {\n    constructor(operation: \"upload\" | \"query\") {\n        super(\n            `Host preimage API unavailable for ${operation}. Ensure you are running inside a host container (Polkadot Browser / Desktop).`,\n        );\n        this.name = \"BulletinHostUnavailableError\";\n    }\n}\n\n/**\n * The host preimage lookup timed out.\n *\n * The host was unable to retrieve the requested content within the timeout period.\n * The content may still become available later.\n */\nexport class BulletinLookupTimeoutError extends BulletinError {\n    /** The CID that was being looked up. */\n    readonly cid: string;\n    /** The timeout duration in milliseconds. */\n    readonly timeoutMs: number;\n\n    constructor(cid: string, timeoutMs: number) {\n        super(`Host preimage lookup timed out after ${timeoutMs}ms for CID: ${cid}`);\n        this.name = \"BulletinLookupTimeoutError\";\n        this.cid = cid;\n        this.timeoutMs = timeoutMs;\n    }\n}\n\n/**\n * The host interrupted the preimage lookup.\n *\n * The host terminated the lookup subscription, typically after repeated failures\n * or when the host determines the content is unavailable.\n */\nexport class BulletinLookupInterruptedError extends BulletinError {\n    /** The CID that was being looked up. */\n    readonly cid: string;\n\n    constructor(cid: string) {\n        super(`Host preimage lookup was interrupted for CID: ${cid}`);\n        this.name = \"BulletinLookupInterruptedError\";\n        this.cid = cid;\n    }\n}\n\n/**\n * Failed to check authorization status for an account.\n *\n * Wraps RPC or query errors that occur when checking if an account\n * is authorized to store data on the Bulletin Chain.\n */\nexport class BulletinAuthorizationError extends BulletinError {\n    /** The address that was being checked. */\n    readonly address: string;\n\n    constructor(address: string, cause?: unknown) {\n        super(`Failed to check authorization for ${address}`, { cause });\n        this.name = \"BulletinAuthorizationError\";\n        this.address = address;\n    }\n}\n\n/**\n * The IPFS gateway for the specified environment is not available.\n *\n * Thrown when attempting to use gateway features for a network that\n * doesn't have a live bulletin gateway yet.\n */\nexport class BulletinGatewayUnavailableError extends BulletinError {\n    /** The environment that was requested. */\n    readonly environment: string;\n\n    constructor(environment: string) {\n        super(`Bulletin gateway for \"${environment}\" is not yet available`);\n        this.name = \"BulletinGatewayUnavailableError\";\n        this.environment = environment;\n    }\n}\n\n/**\n * An IPFS gateway request failed.\n *\n * Thrown when a fetch to the IPFS gateway returns a non-OK response.\n */\nexport class BulletinGatewayFetchError extends BulletinError {\n    /** The CID that was being fetched. */\n    readonly cid: string;\n    /** The HTTP status code returned by the gateway. */\n    readonly status: number;\n    /** The HTTP status text returned by the gateway. */\n    readonly statusText: string;\n\n    constructor(cid: string, status: number, statusText: string) {\n        super(`Gateway fetch failed for ${cid}: ${status} ${statusText}`);\n        this.name = \"BulletinGatewayFetchError\";\n        this.cid = cid;\n        this.status = status;\n        this.statusText = statusText;\n    }\n}\n\n/**\n * Invalid CID format or version.\n *\n * Thrown when a CID string cannot be parsed or has an unexpected version/codec.\n */\nexport class BulletinCidError extends BulletinError {\n    /** The invalid CID string, if available. */\n    readonly cid?: string;\n\n    constructor(message: string, cid?: string) {\n        super(message);\n        this.name = \"BulletinCidError\";\n        this.cid = cid;\n    }\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    describe(\"BulletinError hierarchy\", () => {\n        test(\"BulletinError is instanceof Error\", () => {\n            const err = new BulletinError(\"test\");\n            expect(err).toBeInstanceOf(Error);\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinError\");\n        });\n\n        test(\"BulletinHostUnavailableError\", () => {\n            const err = new BulletinHostUnavailableError(\"upload\");\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinHostUnavailableError\");\n            expect(err.message).toContain(\"upload\");\n            expect(err.message).toContain(\"Host preimage API unavailable\");\n        });\n\n        test(\"BulletinLookupTimeoutError\", () => {\n            const err = new BulletinLookupTimeoutError(\"bafyabc123\", 30000);\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinLookupTimeoutError\");\n            expect(err.cid).toBe(\"bafyabc123\");\n            expect(err.timeoutMs).toBe(30000);\n            expect(err.message).toContain(\"30000ms\");\n            expect(err.message).toContain(\"bafyabc123\");\n        });\n\n        test(\"BulletinLookupInterruptedError\", () => {\n            const err = new BulletinLookupInterruptedError(\"bafyabc123\");\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinLookupInterruptedError\");\n            expect(err.cid).toBe(\"bafyabc123\");\n            expect(err.message).toContain(\"interrupted\");\n        });\n\n        test(\"BulletinAuthorizationError with cause\", () => {\n            const cause = new Error(\"RPC timeout\");\n            const err = new BulletinAuthorizationError(\"5GrwvaEF...\", cause);\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinAuthorizationError\");\n            expect(err.address).toBe(\"5GrwvaEF...\");\n            expect(err.cause).toBe(cause);\n        });\n\n        test(\"BulletinGatewayUnavailableError\", () => {\n            const err = new BulletinGatewayUnavailableError(\"polkadot\");\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinGatewayUnavailableError\");\n            expect(err.environment).toBe(\"polkadot\");\n            expect(err.message).toContain(\"polkadot\");\n        });\n\n        test(\"BulletinGatewayFetchError\", () => {\n            const err = new BulletinGatewayFetchError(\"bafyabc\", 404, \"Not Found\");\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinGatewayFetchError\");\n            expect(err.cid).toBe(\"bafyabc\");\n            expect(err.status).toBe(404);\n            expect(err.statusText).toBe(\"Not Found\");\n            expect(err.message).toContain(\"404\");\n        });\n\n        test(\"BulletinCidError\", () => {\n            const err = new BulletinCidError(\"Expected CIDv1, got CIDv0\", \"Qmabc\");\n            expect(err).toBeInstanceOf(BulletinError);\n            expect(err.name).toBe(\"BulletinCidError\");\n            expect(err.cid).toBe(\"Qmabc\");\n        });\n\n        test(\"all errors can be caught with BulletinError\", () => {\n            const errors = [\n                new BulletinHostUnavailableError(\"query\"),\n                new BulletinLookupTimeoutError(\"cid\", 1000),\n                new BulletinLookupInterruptedError(\"cid\"),\n                new BulletinAuthorizationError(\"addr\"),\n                new BulletinGatewayUnavailableError(\"env\"),\n                new BulletinGatewayFetchError(\"cid\", 500, \"Error\"),\n                new BulletinCidError(\"bad cid\"),\n            ];\n\n            for (const err of errors) {\n                expect(err).toBeInstanceOf(BulletinError);\n            }\n        });\n    });\n}\n","import { blake2b256, bytesToHex, hexToBytes } from \"@parity/product-sdk-crypto\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport { CID } from \"multiformats/cid\";\nimport * as Digest from \"multiformats/hashes/digest\";\n\nimport { BulletinCidError } from \"./errors.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Hash algorithms supported by the Bulletin Chain.\n *\n * Values are multihash codes as defined in the\n * {@link https://github.com/multiformats/multicodec multicodec table}.\n */\nexport const HashAlgorithm = {\n    /** BLAKE2b-256 — default for product-sdk and the chain SDK. */\n    Blake2b256: 0xb220,\n    /** SHA2-256 — default for bulletin-deploy. */\n    Sha2_256: 0x12,\n    /** Keccak-256 — Ethereum compatibility. */\n    Keccak256: 0x1b,\n} as const;\n\n/** A multihash code supported by the Bulletin Chain. */\nexport type HashAlgorithm = (typeof HashAlgorithm)[keyof typeof HashAlgorithm];\n\n/**\n * CID codecs supported by the Bulletin Chain.\n *\n * Values are multicodec codes.\n */\nexport const CidCodec = {\n    /** Raw binary — default for single-chunk data. */\n    Raw: 0x55,\n    /** DAG-PB — used for multi-chunk manifests / directory structures. */\n    DagPb: 0x70,\n    /** DAG-CBOR — alternative DAG encoding. */\n    DagCbor: 0x71,\n} as const;\n\n/** A multicodec code supported by the Bulletin Chain. */\nexport type CidCodec = (typeof CidCodec)[keyof typeof CidCodec];\n\nconst SUPPORTED_HASH_CODES = new Set<number>(Object.values(HashAlgorithm));\nconst SUPPORTED_CODEC_CODES = new Set<number>(Object.values(CidCodec));\nconst EXPECTED_HEX_LENGTH = 66; // \"0x\" + 64 hex chars = 32 bytes\n\n/**\n * Compute the CIDv1 (blake2b-256, raw codec) for arbitrary data.\n * Deterministic: same input always produces the same CID.\n */\nexport function computeCid(data: Uint8Array): string {\n    const hash = blake2b256(data);\n    return CID.createV1(CidCodec.Raw, Digest.create(HashAlgorithm.Blake2b256, hash)).toString();\n}\n\n/**\n * Extract the content hash digest from a CIDv1 string and return it as a\n * `0x`-prefixed hex string — the preimage key format used by the host API.\n *\n * Accepts CIDv1 with any hash algorithm supported by the Bulletin Chain\n * (blake2b-256, sha2-256, keccak-256).\n *\n * @param cid - CIDv1 base32 string (as produced by {@link computeCid} or {@link hashToCid}).\n * @returns `0x`-prefixed hex string of the 32-byte hash digest.\n * @throws If the CID is not CIDv1 or uses an unsupported hash algorithm.\n */\nexport function cidToPreimageKey(cid: string): `0x${string}` {\n    const parsed = CID.parse(cid);\n    if (parsed.version !== 1) {\n        throw new BulletinCidError(`Expected CIDv1, got CIDv${parsed.version}`, cid);\n    }\n    if (!SUPPORTED_HASH_CODES.has(parsed.multihash.code)) {\n        throw new BulletinCidError(\n            `Unsupported hash algorithm 0x${parsed.multihash.code.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_HASH_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n            cid,\n        );\n    }\n    return `0x${bytesToHex(parsed.multihash.digest)}`;\n}\n\n/**\n * Reconstruct a CIDv1 from a `0x`-prefixed hex hash stored on-chain.\n *\n * This is the inverse of {@link cidToPreimageKey}: given a 32-byte content hash\n * and the CID configuration used when the data was stored, it rebuilds the\n * original CIDv1 so you can construct IPFS gateway URLs.\n *\n * The Bulletin Chain supports multiple hash algorithms and codecs — pass the\n * values that match the on-chain `TransactionInfo` to get the correct CID.\n * When omitted, defaults match {@link computeCid} (blake2b-256, raw).\n *\n * @param hexHash   - `0x`-prefixed hex string of a 32-byte hash digest\n *   (66 characters total: `\"0x\"` + 64 hex chars).\n * @param hashCode  - Multihash code of the hashing algorithm (default: blake2b-256 `0xb220`).\n *   Use {@link HashAlgorithm} for the supported values.\n * @param codec     - Multicodec code of the CID codec (default: raw `0x55`).\n *   Use {@link CidCodec} for the supported values.\n * @returns Base32-lower CIDv1 string.\n * @throws If `hexHash` is not exactly 66 characters, or if the hash/codec is unsupported.\n *\n * @example\n * ```ts\n * import { hashToCid, HashAlgorithm, CidCodec, gatewayUrl, getGateway } from \"@parity/product-sdk-bulletin\";\n *\n * // Default (blake2b-256, raw) — matches computeCid output\n * const cid = hashToCid(onChainHash);\n *\n * // SHA2-256 content stored via bulletin-deploy\n * const cid2 = hashToCid(onChainHash, HashAlgorithm.Sha2_256);\n *\n * // DAG-PB manifest with blake2b-256\n * const cid3 = hashToCid(manifestHash, HashAlgorithm.Blake2b256, CidCodec.DagPb);\n *\n * const url = gatewayUrl(cid, getGateway(\"paseo\"));\n * ```\n *\n * @see {@link cidToPreimageKey} for the reverse direction (CID → hex hash).\n * @see {@link computeCid} for computing a CID from raw data.\n * @see {@link HashAlgorithm} for supported hash algorithms.\n * @see {@link CidCodec} for supported CID codecs.\n */\nexport function hashToCid(\n    hexHash: `0x${string}`,\n    hashCode: HashAlgorithm = HashAlgorithm.Blake2b256,\n    codec: CidCodec = CidCodec.Raw,\n): string {\n    if (hexHash.length !== EXPECTED_HEX_LENGTH) {\n        throw new BulletinCidError(\n            `Expected a 0x-prefixed 32-byte hex hash (${EXPECTED_HEX_LENGTH} chars), ` +\n                `got ${hexHash.length} chars`,\n        );\n    }\n    if (!SUPPORTED_HASH_CODES.has(hashCode)) {\n        throw new BulletinCidError(\n            `Unsupported hash algorithm 0x${hashCode.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_HASH_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n        );\n    }\n    if (!SUPPORTED_CODEC_CODES.has(codec)) {\n        throw new BulletinCidError(\n            `Unsupported CID codec 0x${codec.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_CODEC_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n        );\n    }\n    const digest = hexToBytes(hexHash.slice(2));\n    const cid = CID.createV1(codec, Digest.create(hashCode, digest)).toString();\n    log.debug(\"hashToCid\", { hexHash, hashCode, codec, cid });\n    return cid;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    describe(\"computeCid\", () => {\n        test(\"produces known CID for known input\", () => {\n            const data = new TextEncoder().encode(\"hello bulletin\");\n            const cid = computeCid(data);\n            expect(cid).toBe(computeCid(new TextEncoder().encode(\"hello bulletin\")));\n            expect(cid).toMatch(/^b[a-z2-7]+$/);\n        });\n\n        test(\"deterministic — same input, same output\", () => {\n            const data = new Uint8Array([1, 2, 3, 4, 5]);\n            expect(computeCid(data)).toBe(computeCid(data));\n        });\n\n        test(\"different inputs produce different CIDs\", () => {\n            const a = computeCid(new Uint8Array([1]));\n            const b = computeCid(new Uint8Array([2]));\n            expect(a).not.toBe(b);\n        });\n\n        test(\"empty input produces valid CID\", () => {\n            const cid = computeCid(new Uint8Array(0));\n            expect(cid).toMatch(/^b[a-z2-7]+$/);\n        });\n\n        test(\"matches reference implementation (manual varint)\", () => {\n            const data = new TextEncoder().encode(\"test\");\n            const cid = computeCid(data);\n            expect(cid[0]).toBe(\"b\");\n            const parsed = CID.parse(cid);\n            expect(parsed.version).toBe(1);\n            expect(parsed.code).toBe(CidCodec.Raw);\n        });\n    });\n\n    describe(\"cidToPreimageKey\", () => {\n        test(\"round-trips with computeCid — returns 0x-prefixed 64-char hex\", () => {\n            const data = new TextEncoder().encode(\"hello bulletin\");\n            const cid = computeCid(data);\n            const key = cidToPreimageKey(cid);\n            expect(key).toMatch(/^0x[0-9a-f]{64}$/);\n        });\n\n        test(\"deterministic — same CID always yields same key\", () => {\n            const cid = computeCid(new Uint8Array([1, 2, 3]));\n            expect(cidToPreimageKey(cid)).toBe(cidToPreimageKey(cid));\n        });\n\n        test(\"matches raw blake2b-256 hash\", () => {\n            const data = new TextEncoder().encode(\"test\");\n            const cid = computeCid(data);\n            const key = cidToPreimageKey(cid);\n            const hash = blake2b256(data);\n            const expected = `0x${bytesToHex(hash)}`;\n            expect(key).toBe(expected);\n        });\n\n        test(\"accepts CIDv1 with sha2-256\", () => {\n            const hash = new Uint8Array(32).fill(0xcd);\n            const cidV1 = CID.createV1(CidCodec.Raw, Digest.create(HashAlgorithm.Sha2_256, hash));\n            const key = cidToPreimageKey(cidV1.toString());\n            expect(key).toMatch(/^0x[0-9a-f]{64}$/);\n            expect(key).toBe(`0x${bytesToHex(hash)}`);\n        });\n\n        test(\"accepts CIDv1 with keccak-256\", () => {\n            const hash = new Uint8Array(32).fill(0xef);\n            const cidV1 = CID.createV1(CidCodec.Raw, Digest.create(HashAlgorithm.Keccak256, hash));\n            const key = cidToPreimageKey(cidV1.toString());\n            expect(key).toBe(`0x${bytesToHex(hash)}`);\n        });\n\n        test(\"throws BulletinCidError for CIDv0 input\", () => {\n            const hash = new Uint8Array(32).fill(0xab);\n            const cidV0 = CID.create(0, 0x70, Digest.create(HashAlgorithm.Sha2_256, hash));\n            expect(() => cidToPreimageKey(cidV0.toString())).toThrow(BulletinCidError);\n        });\n\n        test(\"throws BulletinCidError for CIDv1 with unsupported hash algorithm\", () => {\n            const unsupportedCode = 0x99;\n            const hash = new Uint8Array(32).fill(0xab);\n            const cidV1 = CID.createV1(CidCodec.Raw, Digest.create(unsupportedCode, hash));\n            expect(() => cidToPreimageKey(cidV1.toString())).toThrow(BulletinCidError);\n        });\n    });\n\n    describe(\"hashToCid\", () => {\n        test(\"round-trips with cidToPreimageKey — hex → CID → hex\", () => {\n            const data = new TextEncoder().encode(\"hello bulletin\");\n            const originalCid = computeCid(data);\n            const hex = cidToPreimageKey(originalCid);\n            const reconstructed = hashToCid(hex);\n            expect(reconstructed).toBe(originalCid);\n        });\n\n        test(\"full cycle: data → CID → hex → CID\", () => {\n            const data = new Uint8Array([10, 20, 30, 40, 50]);\n            const cid1 = computeCid(data);\n            const hex = cidToPreimageKey(cid1);\n            const cid2 = hashToCid(hex);\n            expect(cid2).toBe(cid1);\n        });\n\n        test(\"deterministic — same hex always yields same CID\", () => {\n            const hex = cidToPreimageKey(computeCid(new Uint8Array([1, 2, 3])));\n            expect(hashToCid(hex)).toBe(hashToCid(hex));\n        });\n\n        test(\"produces valid base32-lower CIDv1 (default: blake2b-256, raw)\", () => {\n            const hex = cidToPreimageKey(computeCid(new TextEncoder().encode(\"test\")));\n            const cid = hashToCid(hex);\n            expect(cid).toMatch(/^b[a-z2-7]+$/);\n            const parsed = CID.parse(cid);\n            expect(parsed.version).toBe(1);\n            expect(parsed.code).toBe(CidCodec.Raw);\n            expect(parsed.multihash.code).toBe(HashAlgorithm.Blake2b256);\n        });\n\n        test(\"sha2-256 produces different CID from blake2b-256 for same hash\", () => {\n            const hex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n            const blake = hashToCid(hex, HashAlgorithm.Blake2b256);\n            const sha = hashToCid(hex, HashAlgorithm.Sha2_256);\n            expect(blake).not.toBe(sha);\n            // Both should be valid CIDv1\n            expect(CID.parse(blake).version).toBe(1);\n            expect(CID.parse(sha).version).toBe(1);\n        });\n\n        test(\"sha2-256 round-trips through cidToPreimageKey\", () => {\n            const hex = `0x${\"cd\".repeat(32)}` as `0x${string}`;\n            const cid = hashToCid(hex, HashAlgorithm.Sha2_256);\n            const extracted = cidToPreimageKey(cid);\n            expect(extracted).toBe(hex);\n        });\n\n        test(\"keccak-256 round-trips through cidToPreimageKey\", () => {\n            const hex = `0x${\"ef\".repeat(32)}` as `0x${string}`;\n            const cid = hashToCid(hex, HashAlgorithm.Keccak256);\n            const extracted = cidToPreimageKey(cid);\n            expect(extracted).toBe(hex);\n        });\n\n        test(\"dag-pb codec produces different CID from raw for same hash\", () => {\n            const hex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n            const rawCid = hashToCid(hex, HashAlgorithm.Blake2b256, CidCodec.Raw);\n            const dagPbCid = hashToCid(hex, HashAlgorithm.Blake2b256, CidCodec.DagPb);\n            expect(rawCid).not.toBe(dagPbCid);\n            expect(CID.parse(dagPbCid).code).toBe(CidCodec.DagPb);\n        });\n\n        test(\"dag-cbor codec works\", () => {\n            const hex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n            const cid = hashToCid(hex, HashAlgorithm.Blake2b256, CidCodec.DagCbor);\n            expect(CID.parse(cid).code).toBe(CidCodec.DagCbor);\n        });\n\n        test(\"throws BulletinCidError for hex that is too short\", () => {\n            expect(() => hashToCid(\"0xabcd\" as `0x${string}`)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws BulletinCidError for hex that is too long\", () => {\n            const tooLong = `0x${\"aa\".repeat(33)}` as `0x${string}`;\n            expect(() => hashToCid(tooLong)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws for non-hex characters\", () => {\n            const bad = `0x${\"zz\".repeat(32)}` as `0x${string}`;\n            expect(() => hashToCid(bad)).toThrow();\n        });\n\n        test(\"throws BulletinCidError for unsupported hash algorithm\", () => {\n            const hex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n            expect(() => hashToCid(hex, 0x99 as HashAlgorithm)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws BulletinCidError for unsupported codec\", () => {\n            const hex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n            expect(() => hashToCid(hex, HashAlgorithm.Blake2b256, 0x99 as CidCodec)).toThrow(\n                BulletinCidError,\n            );\n        });\n    });\n}\n","import { BulletinGatewayFetchError, BulletinGatewayUnavailableError } from \"./errors.js\";\nimport type { Environment, FetchOptions } from \"./types.js\";\n\n/** Add entries here as bulletin gateways go live on each network. */\nconst GATEWAYS: Partial<Record<Environment, string>> = {\n    paseo: \"https://paseo-ipfs.polkadot.io/ipfs/\",\n};\n\nconst DEFAULT_FETCH_TIMEOUT_MS = 30_000;\n\n/**\n * Get the IPFS gateway URL for an environment.\n * @throws {BulletinGatewayUnavailableError} If the network doesn't have a live gateway yet.\n */\nexport function getGateway(env: Environment): string {\n    const gw = GATEWAYS[env];\n    if (!gw) {\n        throw new BulletinGatewayUnavailableError(env);\n    }\n    return gw;\n}\n\n/** Build the full gateway URL for a CID. */\nexport function gatewayUrl(cid: string, gateway: string): string {\n    return `${gateway}${cid}`;\n}\n\n/** Check if a CID exists on the gateway (HEAD request). Returns false on any error or timeout. */\nexport async function cidExists(\n    cid: string,\n    gateway: string,\n    options?: FetchOptions,\n): Promise<boolean> {\n    const timeoutMs = options?.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    try {\n        const response = await fetch(gatewayUrl(cid, gateway), {\n            method: \"HEAD\",\n            signal: controller.signal,\n        });\n        return response.ok;\n    } catch {\n        return false;\n    } finally {\n        clearTimeout(timer);\n    }\n}\n\n/**\n * Fetch raw bytes from the gateway.\n * @throws {BulletinGatewayFetchError} If the gateway returns a non-OK response.\n */\nexport async function fetchBytes(\n    cid: string,\n    gateway: string,\n    options?: FetchOptions,\n): Promise<Uint8Array> {\n    const timeoutMs = options?.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n    try {\n        const response = await fetch(gatewayUrl(cid, gateway), { signal: controller.signal });\n        if (!response.ok) {\n            throw new BulletinGatewayFetchError(cid, response.status, response.statusText);\n        }\n        return new Uint8Array(await response.arrayBuffer());\n    } finally {\n        clearTimeout(timer);\n    }\n}\n\n/** Fetch and parse JSON from the gateway. */\nexport async function fetchJson<T>(\n    cid: string,\n    gateway: string,\n    options?: FetchOptions,\n): Promise<T> {\n    const bytes = await fetchBytes(cid, gateway, options);\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi, afterEach } = import.meta.vitest;\n\n    afterEach(() => {\n        vi.restoreAllMocks();\n    });\n\n    describe(\"getGateway\", () => {\n        test(\"returns known URL for paseo\", () => {\n            const gw = getGateway(\"paseo\");\n            expect(gw).toMatch(/^https:\\/\\//);\n            expect(gw).toMatch(/\\/ipfs\\/$/);\n        });\n\n        test(\"throws BulletinGatewayUnavailableError for environments without a live gateway\", () => {\n            expect(() => getGateway(\"polkadot\")).toThrow(BulletinGatewayUnavailableError);\n            expect(() => getGateway(\"kusama\")).toThrow(BulletinGatewayUnavailableError);\n        });\n    });\n\n    describe(\"gatewayUrl\", () => {\n        test(\"concatenates gateway and CID\", () => {\n            expect(gatewayUrl(\"bafyabc\", \"https://gw.example/ipfs/\")).toBe(\n                \"https://gw.example/ipfs/bafyabc\",\n            );\n        });\n    });\n\n    describe(\"cidExists\", () => {\n        test(\"returns true for 200 response\", async () => {\n            vi.stubGlobal(\"fetch\", vi.fn().mockResolvedValue({ ok: true }));\n            expect(await cidExists(\"bafyabc\", \"https://gw/ipfs/\")).toBe(true);\n        });\n\n        test(\"returns false for 404 response\", async () => {\n            vi.stubGlobal(\"fetch\", vi.fn().mockResolvedValue({ ok: false, status: 404 }));\n            expect(await cidExists(\"bafyabc\", \"https://gw/ipfs/\")).toBe(false);\n        });\n\n        test(\"returns false on network error\", async () => {\n            vi.stubGlobal(\"fetch\", vi.fn().mockRejectedValue(new Error(\"network\")));\n            expect(await cidExists(\"bafyabc\", \"https://gw/ipfs/\")).toBe(false);\n        });\n\n        test(\"returns false on timeout\", async () => {\n            vi.stubGlobal(\n                \"fetch\",\n                vi.fn().mockImplementation(\n                    (_url: string, init: { signal: AbortSignal }) =>\n                        new Promise((_resolve, reject) => {\n                            init.signal.addEventListener(\"abort\", () =>\n                                reject(new DOMException(\"aborted\", \"AbortError\")),\n                            );\n                        }),\n                ),\n            );\n            expect(await cidExists(\"bafyabc\", \"https://gw/ipfs/\", { timeoutMs: 10 })).toBe(false);\n        });\n    });\n\n    describe(\"fetchBytes\", () => {\n        test(\"returns bytes from response\", async () => {\n            const payload = new Uint8Array([1, 2, 3]);\n            vi.stubGlobal(\n                \"fetch\",\n                vi.fn().mockResolvedValue({\n                    ok: true,\n                    arrayBuffer: () => Promise.resolve(payload.buffer),\n                }),\n            );\n            const result = await fetchBytes(\"bafyabc\", \"https://gw/ipfs/\");\n            expect(result).toEqual(payload);\n        });\n\n        test(\"throws BulletinGatewayFetchError on non-ok response\", async () => {\n            vi.stubGlobal(\n                \"fetch\",\n                vi.fn().mockResolvedValue({\n                    ok: false,\n                    status: 500,\n                    statusText: \"Internal Server Error\",\n                }),\n            );\n            const err = await fetchBytes(\"bafyabc\", \"https://gw/ipfs/\").catch((e) => e);\n            expect(err).toBeInstanceOf(BulletinGatewayFetchError);\n            expect(err.cid).toBe(\"bafyabc\");\n            expect(err.status).toBe(500);\n        });\n\n        test(\"throws on timeout\", async () => {\n            vi.stubGlobal(\n                \"fetch\",\n                vi.fn().mockImplementation(\n                    (_url: string, init: { signal: AbortSignal }) =>\n                        new Promise((_resolve, reject) => {\n                            init.signal.addEventListener(\"abort\", () =>\n                                reject(new DOMException(\"aborted\", \"AbortError\")),\n                            );\n                        }),\n                ),\n            );\n            await expect(\n                fetchBytes(\"bafyabc\", \"https://gw/ipfs/\", { timeoutMs: 10 }),\n            ).rejects.toThrow();\n        });\n    });\n\n    describe(\"fetchJson\", () => {\n        test(\"parses JSON from response\", async () => {\n            const obj = { name: \"test\", value: 42 };\n            const bytes = new TextEncoder().encode(JSON.stringify(obj));\n            vi.stubGlobal(\n                \"fetch\",\n                vi.fn().mockResolvedValue({\n                    ok: true,\n                    arrayBuffer: () => Promise.resolve(bytes.buffer),\n                }),\n            );\n            const result = await fetchJson<{ name: string; value: number }>(\n                \"bafyabc\",\n                \"https://gw/ipfs/\",\n            );\n            expect(result).toEqual(obj);\n        });\n    });\n}\n","import { createLogger } from \"@parity/product-sdk-logger\";\n\nimport { resolveQueryStrategy, type QueryStrategy } from \"./resolve-query.js\";\nimport type { QueryOptions } from \"./types.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Fetch raw bytes for a CID using the host preimage lookup.\n *\n * Uses local cache + managed IPFS polling via the host container.\n *\n * @param cid     - CIDv1 string to fetch.\n * @param options - Query options (lookupTimeoutMs for host).\n * @returns Raw bytes of the content.\n * @throws {Error} If the host preimage API is unavailable.\n */\nexport async function queryBytes(cid: string, options?: QueryOptions): Promise<Uint8Array> {\n    const strategy = await resolveQueryStrategy();\n    return executeQuery(strategy, cid, options);\n}\n\n/**\n * Fetch and parse JSON for a CID, auto-resolving the query path.\n *\n * Delegates to {@link queryBytes} and parses the result as JSON.\n *\n * @param cid     - CIDv1 string to fetch.\n * @param options - Query options.\n * @returns Parsed JSON value.\n * @throws {Error} If the host preimage API is unavailable.\n */\nexport async function queryJson<T>(cid: string, options?: QueryOptions): Promise<T> {\n    const bytes = await queryBytes(cid, options);\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Execute a query using a pre-resolved strategy.\n *\n * Exposed so that {@link BulletinClient} can resolve the strategy once and\n * reuse it across multiple calls without re-detecting the environment.\n *\n * @param strategy - Pre-resolved query strategy.\n * @param cid      - CIDv1 string to fetch.\n * @param options  - Query options.\n * @returns Raw bytes of the content.\n */\nexport async function executeQuery(\n    strategy: QueryStrategy,\n    cid: string,\n    options?: QueryOptions,\n): Promise<Uint8Array> {\n    log.info(\"querying via host preimage lookup\", { cid });\n    return strategy.lookup(cid, options?.lookupTimeoutMs);\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    // Note: queryBytes and queryJson tests require e2e testing as they\n    // depend on the host container environment for strategy resolution.\n\n    describe(\"executeQuery\", () => {\n        const testData = new Uint8Array([1, 2, 3]);\n\n        test(\"executes host-lookup strategy\", async () => {\n            const lookup = vi.fn().mockResolvedValue(testData);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            const result = await executeQuery(strategy, \"bafytest\");\n            expect(result).toBe(testData);\n            expect(lookup).toHaveBeenCalledWith(\"bafytest\", undefined);\n        });\n\n        test(\"passes lookupTimeoutMs to host-lookup\", async () => {\n            const lookup = vi.fn().mockResolvedValue(testData);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            await executeQuery(strategy, \"bafytest\", { lookupTimeoutMs: 5000 });\n            expect(lookup).toHaveBeenCalledWith(\"bafytest\", 5000);\n        });\n    });\n}\n","import { getPreimageManager, type PreimageManager } from \"@parity/product-sdk-host\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\n\nimport { cidToPreimageKey, computeCid } from \"./cid.js\";\nimport {\n    BulletinHostUnavailableError,\n    BulletinLookupInterruptedError,\n    BulletinLookupTimeoutError,\n} from \"./errors.js\";\n\nconst log = createLogger(\"bulletin\");\n\nconst DEFAULT_LOOKUP_TIMEOUT_MS = 30_000;\n\n/**\n * Query strategy for the Bulletin Chain.\n *\n * The host manages the lookup via its preimage subscription API,\n * which includes local caching and managed IPFS polling.\n */\nexport interface QueryStrategy {\n    kind: \"host-lookup\";\n    lookup: (cid: string, timeoutMs?: number) => Promise<Uint8Array>;\n}\n\n/**\n * Determine the query strategy for the Bulletin Chain.\n *\n * Uses the host preimage lookup API which caches results and manages\n * IPFS polling automatically.\n *\n * @returns The resolved query strategy.\n * @throws {BulletinHostUnavailableError} If the host preimage manager is unavailable.\n */\nexport async function resolveQueryStrategy(): Promise<QueryStrategy> {\n    const preimageManager = await getPreimageManager();\n    if (preimageManager) {\n        log.info(\"using host preimage lookup for bulletin queries\");\n        return {\n            kind: \"host-lookup\",\n            lookup: (cid, timeoutMs) => lookupViaHost(preimageManager, cid, timeoutMs),\n        };\n    }\n\n    throw new BulletinHostUnavailableError(\"query\");\n}\n\n/**\n * Wrap `preimageManager.lookup` (subscription-based) into a one-shot Promise.\n *\n * Converts the CID to a hex preimage key, subscribes, and resolves on the\n * first non-null callback. Rejects on timeout or if the host interrupts the\n * subscription (e.g. after repeated failures). Always unsubscribes on settlement.\n *\n * @param manager   - The product-sdk preimage manager.\n * @param cid       - CIDv1 string to look up.\n * @param timeoutMs - Maximum wait time. Default: 30_000ms.\n * @returns The raw bytes of the preimage.\n */\nexport function lookupViaHost(\n    manager: PreimageManager,\n    cid: string,\n    timeoutMs: number = DEFAULT_LOOKUP_TIMEOUT_MS,\n): Promise<Uint8Array> {\n    const key = cidToPreimageKey(cid);\n\n    return new Promise<Uint8Array>((resolve, reject) => {\n        const cleanup = () => {\n            cancelInterrupt();\n            sub.unsubscribe();\n        };\n\n        const settle = (fn: () => void) => {\n            if (timer === null) return;\n            clearTimeout(timer);\n            timer = null;\n            cleanup();\n            fn();\n        };\n\n        let timer: ReturnType<typeof setTimeout> | null = setTimeout(() => {\n            settle(() => {\n                reject(new BulletinLookupTimeoutError(cid, timeoutMs));\n            });\n        }, timeoutMs);\n\n        const sub = manager.lookup(key, (preimage) => {\n            if (preimage !== null) {\n                settle(() => resolve(preimage));\n            }\n            // null means \"not found yet\" — host will keep polling\n        });\n\n        const cancelInterrupt = sub.onInterrupt(() => {\n            settle(() => {\n                reject(new BulletinLookupInterruptedError(cid));\n            });\n        });\n    });\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    // Note: resolveQueryStrategy tests require e2e testing as they\n    // depend on the host container environment.\n\n    describe(\"lookupViaHost\", () => {\n        function createMockManager(\n            behavior: \"resolve\" | \"null-then-resolve\" | \"hang\" | \"interrupt\",\n        ) {\n            const unsubscribe = vi.fn();\n            const cancelInterrupt = vi.fn();\n            let interruptCb: VoidFunction | undefined;\n\n            const lookup = vi.fn((_key: string, callback: (p: Uint8Array | null) => void) => {\n                const data = new Uint8Array([10, 20, 30]);\n                queueMicrotask(() => {\n                    if (behavior === \"resolve\") {\n                        callback(data);\n                    } else if (behavior === \"null-then-resolve\") {\n                        callback(null);\n                        queueMicrotask(() => callback(data));\n                    } else if (behavior === \"interrupt\") {\n                        interruptCb?.();\n                    }\n                    // \"hang\" does nothing\n                });\n                return {\n                    unsubscribe,\n                    onInterrupt: (cb: VoidFunction) => {\n                        interruptCb = cb;\n                        return cancelInterrupt;\n                    },\n                };\n            });\n\n            return { lookup, unsubscribe, cancelInterrupt, submit: vi.fn() };\n        }\n\n        const testCid = computeCid(new TextEncoder().encode(\"test\"));\n\n        test(\"resolves on first non-null callback\", async () => {\n            const manager = createMockManager(\"resolve\");\n            const result = await lookupViaHost(manager, testCid);\n            expect(result).toEqual(new Uint8Array([10, 20, 30]));\n        });\n\n        test(\"ignores null callbacks and resolves on subsequent data\", async () => {\n            const manager = createMockManager(\"null-then-resolve\");\n            const result = await lookupViaHost(manager, testCid);\n            expect(result).toEqual(new Uint8Array([10, 20, 30]));\n        });\n\n        test(\"rejects with BulletinLookupTimeoutError on timeout\", async () => {\n            const { BulletinLookupTimeoutError } = await import(\"./errors.js\");\n            const manager = createMockManager(\"hang\");\n            const err = await lookupViaHost(manager, testCid, 50).catch((e) => e);\n            expect(err).toBeInstanceOf(BulletinLookupTimeoutError);\n            expect(err.cid).toBe(testCid);\n            expect(err.timeoutMs).toBe(50);\n        });\n\n        test(\"rejects with BulletinLookupInterruptedError on interrupt\", async () => {\n            const { BulletinLookupInterruptedError } = await import(\"./errors.js\");\n            const manager = createMockManager(\"interrupt\");\n            const err = await lookupViaHost(manager, testCid).catch((e) => e);\n            expect(err).toBeInstanceOf(BulletinLookupInterruptedError);\n            expect(err.cid).toBe(testCid);\n        });\n\n        test(\"calls unsubscribe and cancelInterrupt on resolution\", async () => {\n            const manager = createMockManager(\"resolve\");\n            await lookupViaHost(manager, testCid);\n            expect(manager.unsubscribe).toHaveBeenCalledOnce();\n            expect(manager.cancelInterrupt).toHaveBeenCalledOnce();\n        });\n\n        test(\"calls unsubscribe on interrupt\", async () => {\n            const manager = createMockManager(\"interrupt\");\n            await lookupViaHost(manager, testCid).catch(() => {});\n            expect(manager.unsubscribe).toHaveBeenCalledOnce();\n        });\n\n        test(\"passes correct hex key to manager\", async () => {\n            const expectedKey = cidToPreimageKey(testCid);\n            const manager = createMockManager(\"resolve\");\n            await lookupViaHost(manager, testCid);\n            expect(manager.lookup).toHaveBeenCalledWith(expectedKey, expect.any(Function));\n        });\n    });\n}\n","import { createLogger } from \"@parity/product-sdk-logger\";\nimport { submitAndWatch, withRetry } from \"@parity/product-sdk-tx\";\nimport type { PolkadotSigner } from \"polkadot-api\";\nimport { Binary } from \"polkadot-api\";\n\nimport { computeCid } from \"./cid.js\";\nimport { gatewayUrl } from \"./gateway.js\";\nimport { resolveUploadStrategy } from \"./resolve-signer.js\";\nimport type {\n    BatchUploadItem,\n    BatchUploadOptions,\n    BatchUploadResult,\n    BulletinApi,\n    UploadOptions,\n    UploadResult,\n} from \"./types.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Upload data to the Bulletin Chain.\n *\n * When a signer is provided, submits a `TransactionStorage.store` transaction\n * directly. When omitted, uses the host preimage API — the host signs and\n * submits automatically.\n *\n * Computes the CIDv1 (blake2b-256, raw codec) locally.\n *\n * @param api    - Typed Bulletin Chain API.\n * @param data   - Raw bytes to store.\n * @param signer - Optional signer. When omitted, uses host preimage API.\n * @param options - Upload options (gateway, timeout, waitFor, status callback).\n * @returns Upload result with CID and either blockHash or preimageKey.\n */\nexport async function upload(\n    api: BulletinApi,\n    data: Uint8Array,\n    signer?: PolkadotSigner,\n    options?: UploadOptions,\n): Promise<UploadResult> {\n    const strategy = await resolveUploadStrategy(signer);\n    const cid = computeCid(data);\n\n    if (strategy.kind === \"preimage\") {\n        log.info(\"uploading via host preimage API\", { cid, size: data.byteLength });\n        const preimageKey = await strategy.submit(data);\n        log.info(\"preimage submitted successfully\", { cid, preimageKey });\n        return {\n            kind: \"preimage\",\n            cid,\n            preimageKey,\n            gatewayUrl: options?.gateway ? gatewayUrl(cid, options.gateway) : undefined,\n        };\n    }\n\n    log.info(\"uploading via TransactionStorage.store\", { cid, size: data.byteLength });\n    const result = await withRetry(() => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const tx = (api as any).tx.TransactionStorage.store({ data: Binary.fromBytes(data) });\n        return submitAndWatch(tx, strategy.signer, {\n            waitFor: options?.waitFor,\n            timeoutMs: options?.timeoutMs,\n            onStatus: options?.onStatus,\n        });\n    });\n\n    log.info(\"transaction included in block\", { cid, blockHash: result.block.hash });\n    return {\n        kind: \"transaction\",\n        cid,\n        blockHash: result.block.hash,\n        gatewayUrl: options?.gateway ? gatewayUrl(cid, options.gateway) : undefined,\n    };\n}\n\n/**\n * Upload multiple items sequentially to the Bulletin Chain.\n *\n * Bulletin Chain requires sequential transaction submission (nonce ordering).\n * Individual failures are captured in results — the batch does not abort.\n *\n * Signer resolution follows the same rules as {@link upload}: when omitted,\n * the strategy is auto-resolved once and reused for all items.\n *\n * @param api    - Typed Bulletin Chain API.\n * @param items  - Array of items to upload, each with data and a label.\n * @param signer - Optional signer. When omitted, auto-resolved.\n * @param options - Batch upload options (gateway, timeout, progress callback).\n * @returns Array of results, one per item, preserving input order.\n */\nexport async function batchUpload(\n    api: BulletinApi,\n    items: BatchUploadItem[],\n    signer?: PolkadotSigner,\n    options?: BatchUploadOptions,\n): Promise<BatchUploadResult[]> {\n    if (items.length === 0) return [];\n\n    const strategy = await resolveUploadStrategy(signer);\n    const results: BatchUploadResult[] = [];\n\n    for (let i = 0; i < items.length; i++) {\n        const item = items[i]!;\n        const cid = computeCid(item.data);\n\n        try {\n            if (strategy.kind === \"preimage\") {\n                log.info(\"batch: uploading item via preimage\", {\n                    label: item.label,\n                    index: i,\n                    total: items.length,\n                });\n                const preimageKey = await strategy.submit(item.data);\n\n                const entry: BatchUploadResult = {\n                    kind: \"preimage\",\n                    label: item.label,\n                    cid,\n                    success: true,\n                    preimageKey,\n                    gatewayUrl: options?.gateway ? gatewayUrl(cid, options.gateway) : undefined,\n                };\n                results.push(entry);\n                options?.onProgress?.(i + 1, items.length, entry);\n            } else {\n                log.info(\"batch: uploading item via transaction\", {\n                    label: item.label,\n                    index: i,\n                    total: items.length,\n                });\n                const result = await withRetry(() => {\n                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                    const tx = (api as any).tx.TransactionStorage.store({\n                        data: Binary.fromBytes(item.data),\n                    });\n                    return submitAndWatch(tx, strategy.signer, {\n                        waitFor: options?.waitFor,\n                        timeoutMs: options?.timeoutMs,\n                    });\n                });\n\n                const entry: BatchUploadResult = {\n                    kind: \"transaction\",\n                    label: item.label,\n                    cid,\n                    success: true,\n                    blockHash: result.block.hash,\n                    gatewayUrl: options?.gateway ? gatewayUrl(cid, options.gateway) : undefined,\n                };\n                results.push(entry);\n                options?.onProgress?.(i + 1, items.length, entry);\n            }\n        } catch (err) {\n            log.error(\"batch: item upload failed\", {\n                label: item.label,\n                index: i,\n                error: err instanceof Error ? err.message : String(err),\n            });\n            const entry: BatchUploadResult = {\n                kind: strategy.kind === \"preimage\" ? \"preimage\" : \"transaction\",\n                label: item.label,\n                cid,\n                success: false,\n                error: err instanceof Error ? err.message : String(err),\n            };\n            results.push(entry);\n            options?.onProgress?.(i + 1, items.length, entry);\n        }\n    }\n\n    return results;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    function createMockApi() {\n        return {\n            tx: {\n                TransactionStorage: {\n                    store: vi.fn().mockReturnValue({\n                        signSubmitAndWatch: () => ({\n                            subscribe: (handlers: { next: (e: unknown) => void }) => {\n                                queueMicrotask(() => {\n                                    handlers.next({ type: \"signed\", txHash: \"0xtxhash\" });\n                                    handlers.next({\n                                        type: \"txBestBlocksState\",\n                                        txHash: \"0xtxhash\",\n                                        found: true,\n                                        ok: true,\n                                        block: { hash: \"0xblockhash\", number: 1, index: 0 },\n                                        events: [],\n                                    });\n                                });\n                                return { unsubscribe: vi.fn() };\n                            },\n                        }),\n                    }),\n                },\n            },\n        };\n    }\n\n    const mockSigner = {} as PolkadotSigner;\n\n    describe(\"upload\", () => {\n        test(\"calls TransactionStorage.store and returns CID + blockHash with explicit signer\", async () => {\n            const api = createMockApi();\n            const data = new TextEncoder().encode(\"test data\");\n            const result = await upload(api as unknown as BulletinApi, data, mockSigner);\n\n            expect(api.tx.TransactionStorage.store).toHaveBeenCalledOnce();\n            expect(result.kind).toBe(\"transaction\");\n            expect(result.cid).toBeTruthy();\n            if (result.kind === \"transaction\") {\n                expect(result.blockHash).toBe(\"0xblockhash\");\n            }\n        });\n\n        test(\"includes gatewayUrl when gateway option provided\", async () => {\n            const api = createMockApi();\n            const data = new TextEncoder().encode(\"test\");\n            const result = await upload(api as unknown as BulletinApi, data, mockSigner, {\n                gateway: \"https://gw/ipfs/\",\n            });\n\n            expect(result.gatewayUrl).toBe(`https://gw/ipfs/${result.cid}`);\n        });\n\n        test(\"omits gatewayUrl when no gateway option\", async () => {\n            const api = createMockApi();\n            const data = new TextEncoder().encode(\"test\");\n            const result = await upload(api as unknown as BulletinApi, data, mockSigner);\n\n            expect(result.gatewayUrl).toBeUndefined();\n        });\n    });\n\n    describe(\"batchUpload\", () => {\n        test(\"returns empty array for empty items\", async () => {\n            const api = createMockApi();\n            const results = await batchUpload(api as unknown as BulletinApi, [], mockSigner);\n            expect(results).toEqual([]);\n        });\n\n        test(\"processes items sequentially with explicit signer\", async () => {\n            const api = createMockApi();\n            const items: BatchUploadItem[] = [\n                { data: new TextEncoder().encode(\"a\"), label: \"file-a\" },\n                { data: new TextEncoder().encode(\"b\"), label: \"file-b\" },\n            ];\n            const results = await batchUpload(api as unknown as BulletinApi, items, mockSigner);\n\n            expect(results).toHaveLength(2);\n            expect(results[0]!.kind).toBe(\"transaction\");\n            expect(results[0]!.label).toBe(\"file-a\");\n            expect(results[0]!.success).toBe(true);\n            expect(results[1]!.kind).toBe(\"transaction\");\n            expect(results[1]!.label).toBe(\"file-b\");\n            expect(results[1]!.success).toBe(true);\n        });\n\n        test(\"captures individual failures without aborting batch\", async () => {\n            const api = createMockApi();\n            // Make the second call fail with a dispatch error (non-retryable)\n            let callCount = 0;\n            api.tx.TransactionStorage.store.mockImplementation(() => {\n                callCount++;\n                if (callCount === 2) {\n                    return {\n                        signSubmitAndWatch: () => ({\n                            subscribe: (handlers: { next: (e: unknown) => void }) => {\n                                queueMicrotask(() => {\n                                    handlers.next({ type: \"signed\", txHash: \"0x\" });\n                                    handlers.next({\n                                        type: \"txBestBlocksState\",\n                                        txHash: \"0x\",\n                                        found: true,\n                                        ok: false,\n                                        block: { hash: \"0xblock\", number: 1, index: 0 },\n                                        events: [],\n                                        dispatchError: { type: \"BadOrigin\" },\n                                    });\n                                });\n                                return { unsubscribe: vi.fn() };\n                            },\n                        }),\n                    };\n                }\n                return {\n                    signSubmitAndWatch: () => ({\n                        subscribe: (handlers: { next: (e: unknown) => void }) => {\n                            queueMicrotask(() => {\n                                handlers.next({ type: \"signed\", txHash: \"0x\" });\n                                handlers.next({\n                                    type: \"txBestBlocksState\",\n                                    txHash: \"0x\",\n                                    found: true,\n                                    ok: true,\n                                    block: { hash: \"0xblock\", number: 1, index: 0 },\n                                    events: [],\n                                });\n                            });\n                            return { unsubscribe: vi.fn() };\n                        },\n                    }),\n                };\n            });\n\n            const items: BatchUploadItem[] = [\n                { data: new TextEncoder().encode(\"a\"), label: \"ok\" },\n                { data: new TextEncoder().encode(\"b\"), label: \"fail\" },\n                { data: new TextEncoder().encode(\"c\"), label: \"ok2\" },\n            ];\n            const results = await batchUpload(api as unknown as BulletinApi, items, mockSigner);\n\n            expect(results).toHaveLength(3);\n            expect(results[0]!.kind).toBe(\"transaction\");\n            expect(results[0]!.success).toBe(true);\n            const f1 = results[1]!;\n            expect(f1.kind).toBe(\"transaction\");\n            expect(f1.success).toBe(false);\n            if (!f1.success) expect(f1.error).toContain(\"BadOrigin\");\n            expect(results[2]!.success).toBe(true);\n        });\n\n        test(\"calls onProgress for each item\", async () => {\n            const api = createMockApi();\n            const items: BatchUploadItem[] = [\n                { data: new TextEncoder().encode(\"a\"), label: \"a\" },\n                { data: new TextEncoder().encode(\"b\"), label: \"b\" },\n            ];\n            const progress: Array<[number, number, string]> = [];\n            await batchUpload(api as unknown as BulletinApi, items, mockSigner, {\n                onProgress: (done, total, current) => progress.push([done, total, current.label]),\n            });\n\n            expect(progress).toEqual([\n                [1, 2, \"a\"],\n                [2, 2, \"b\"],\n            ]);\n        });\n    });\n}\n","import { getPreimageManager } from \"@parity/product-sdk-host\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport type { PolkadotSigner } from \"polkadot-api\";\n\nimport { BulletinHostUnavailableError } from \"./errors.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Discriminated union describing how data will be uploaded to the Bulletin Chain.\n *\n * - `\"preimage\"` — the host handles signing and chain submission via its preimage API.\n * - `\"signer\"`   — a `TransactionStorage.store` transaction is signed and submitted directly.\n */\nexport type UploadStrategy =\n    | { kind: \"preimage\"; submit: (data: Uint8Array) => Promise<string> }\n    | { kind: \"signer\"; signer: PolkadotSigner };\n\n/**\n * Determine the upload strategy for the Bulletin Chain.\n *\n * Resolution order:\n * 1. If an explicit signer is provided, use it directly.\n * 2. Otherwise, use the host preimage API (the SDK is designed to run inside a container).\n *\n * @param explicitSigner - Optional signer provided by the caller. When present,\n *                         skips host auto-detection entirely.\n * @returns The resolved upload strategy.\n * @throws {Error} If no signer is provided and the host preimage API is unavailable.\n */\nexport async function resolveUploadStrategy(\n    explicitSigner?: PolkadotSigner,\n): Promise<UploadStrategy> {\n    if (explicitSigner) {\n        log.debug(\"using explicit signer provided by caller\");\n        return { kind: \"signer\", signer: explicitSigner };\n    }\n\n    // Use the host preimage API (inside container)\n    const preimageManager = await getPreimageManager();\n    if (preimageManager) {\n        log.info(\"using host preimage API for bulletin upload\");\n        return { kind: \"preimage\", submit: (data) => preimageManager.submit(data) };\n    }\n\n    throw new BulletinHostUnavailableError(\"upload\");\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    describe(\"resolveUploadStrategy\", () => {\n        test(\"returns explicit signer when provided\", async () => {\n            const signer = { publicKey: new Uint8Array(32) } as PolkadotSigner;\n            const strategy = await resolveUploadStrategy(signer);\n            expect(strategy.kind).toBe(\"signer\");\n            if (strategy.kind === \"signer\") {\n                expect(strategy.signer).toBe(signer);\n            }\n        });\n\n        // Note: Tests for host preimage manager integration require e2e testing\n        // as they depend on the actual host container environment.\n        // The explicit signer path above validates the core logic.\n    });\n}\n"],"mappings":"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","names":["createMockApi","createLogger","log","createLogger","createLogger","createLogger","log","createLogger","computeCid","BulletinLookupTimeoutError","BulletinLookupInterruptedError","log","createLogger","createLogger","getPreimageManager","createLogger","log","createLogger","getPreimageManager","log","createLogger","createMockApi","cidToPreimageKey"]}
+{"version":3,"sources":["../src/errors.ts","../src/authorization.ts","../src/cid.ts","../src/resolve-query.ts","../src/query.ts","../src/verify.ts","../src/client.ts","../src/networks.ts","../src/lazy-signer.ts"],"names":["log","createLogger","CidCodec","CID","chain","inner","bulletinDescriptor"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Bulletin error types.\n *\n * Two error families coexist:\n *\n * 1. **Upstream SDK errors** — `BulletinError` and `ErrorCode` from\n *    `@parity/bulletin-sdk` cover upload/store/authorization failures\n *    surfaced by `AsyncBulletinClient`. Each carries `code`, `retryable`,\n *    and `recoveryHint`.\n * 2. **Read-side errors** declared here — host preimage availability /\n *    lookup timeouts / interrupts, plus CID format problems, surfaced by\n *    our retrieval helpers (`fetchBytes`, `fetchJson`, `verifyOnChain`).\n *\n * Catch upstream errors with `instanceof BulletinError`. Catch our read-side\n * errors with `instanceof ProductBulletinError` (or the specific subclass).\n */\nexport { BulletinError, ErrorCode } from \"@parity/bulletin-sdk\";\n\n/**\n * Base class for read-side errors raised by `@parity/product-sdk-bulletin`.\n *\n * Distinct from upstream `BulletinError` which covers upload/store failures.\n */\nexport class ProductBulletinError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = \"ProductBulletinError\";\n    }\n}\n\n/**\n * The host preimage API is unavailable.\n *\n * Thrown when bulletin operations require the host container but it's not\n * available. This typically means the SDK is running outside Polkadot\n * Browser / Desktop. The bulletin SDK is container-only by design — see\n * the README for the rationale.\n */\nexport class BulletinHostUnavailableError extends ProductBulletinError {\n    constructor(operation: \"upload\" | \"query\") {\n        super(\n            `Host preimage API unavailable for ${operation}. Ensure you are running inside a host container (Polkadot Browser / Desktop).`,\n        );\n        this.name = \"BulletinHostUnavailableError\";\n    }\n}\n\n/**\n * The host preimage lookup timed out.\n *\n * The host was unable to retrieve the requested content within the timeout\n * period. The content may still become available later.\n */\nexport class BulletinLookupTimeoutError extends ProductBulletinError {\n    /** The CID that was being looked up. */\n    readonly cid: string;\n    /** The timeout duration in milliseconds. */\n    readonly timeoutMs: number;\n\n    constructor(cid: string, timeoutMs: number) {\n        super(`Host preimage lookup timed out after ${timeoutMs}ms for CID: ${cid}`);\n        this.name = \"BulletinLookupTimeoutError\";\n        this.cid = cid;\n        this.timeoutMs = timeoutMs;\n    }\n}\n\n/**\n * The host interrupted the preimage lookup.\n *\n * The host terminated the lookup subscription, typically after repeated\n * failures or when the host determines the content is unavailable.\n */\nexport class BulletinLookupInterruptedError extends ProductBulletinError {\n    /** The CID that was being looked up. */\n    readonly cid: string;\n\n    constructor(cid: string) {\n        super(`Host preimage lookup was interrupted for CID: ${cid}`);\n        this.name = \"BulletinLookupInterruptedError\";\n        this.cid = cid;\n    }\n}\n\n/**\n * Invalid CID format or version.\n */\nexport class BulletinCidError extends ProductBulletinError {\n    /** The invalid CID string, if available. */\n    readonly cid?: string;\n\n    constructor(message: string, cid?: string) {\n        super(message);\n        this.name = \"BulletinCidError\";\n        this.cid = cid;\n    }\n}\n\n/**\n * Failed to check authorization status for an account.\n *\n * Wraps RPC or query errors that occur when checking if an account\n * is authorized to store data on the Bulletin Chain.\n */\nexport class BulletinAuthorizationError extends ProductBulletinError {\n    /** The address that was being checked. */\n    readonly address: string;\n\n    constructor(address: string, cause?: unknown) {\n        super(`Failed to check authorization for ${address}`, { cause });\n        this.name = \"BulletinAuthorizationError\";\n        this.address = address;\n    }\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    describe(\"ProductBulletinError hierarchy\", () => {\n        test(\"ProductBulletinError extends Error\", () => {\n            const err = new ProductBulletinError(\"test\");\n            expect(err).toBeInstanceOf(Error);\n            expect(err.name).toBe(\"ProductBulletinError\");\n        });\n\n        test(\"BulletinCidError\", () => {\n            const err = new BulletinCidError(\"bad\", \"Qmabc\");\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect(err.cid).toBe(\"Qmabc\");\n        });\n\n        test(\"BulletinHostUnavailableError\", () => {\n            const err = new BulletinHostUnavailableError(\"query\");\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect(err.message).toContain(\"query\");\n            expect(err.message).toContain(\"Host preimage API unavailable\");\n        });\n\n        test(\"BulletinLookupTimeoutError\", () => {\n            const err = new BulletinLookupTimeoutError(\"bafyabc123\", 30000);\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect(err.cid).toBe(\"bafyabc123\");\n            expect(err.timeoutMs).toBe(30000);\n            expect(err.message).toContain(\"30000ms\");\n        });\n\n        test(\"BulletinLookupInterruptedError\", () => {\n            const err = new BulletinLookupInterruptedError(\"bafyabc123\");\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect(err.cid).toBe(\"bafyabc123\");\n            expect(err.message).toContain(\"interrupted\");\n        });\n\n        test(\"BulletinAuthorizationError carries cause\", () => {\n            const cause = new Error(\"RPC down\");\n            const err = new BulletinAuthorizationError(\"5GrwvaEF...\", cause);\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect(err.address).toBe(\"5GrwvaEF...\");\n            expect(err.cause).toBe(cause);\n        });\n    });\n}\n","import { createLogger } from \"@parity/product-sdk-logger\";\nimport { submitAndWatch, type TxStatus, type WaitFor } from \"@parity/product-sdk-tx\";\nimport type { PolkadotSigner } from \"polkadot-api\";\nimport { Enum } from \"polkadot-api\";\n\nimport { BulletinAuthorizationError, ProductBulletinError } from \"./errors.js\";\nimport type { AuthorizationStatus, BulletinApi } from \"./types.js\";\n\nconst log = createLogger(\"bulletin\");\n\nconst NOT_AUTHORIZED: AuthorizationStatus = Object.freeze({\n    authorized: false,\n    remainingTransactions: 0,\n    remainingBytes: 0n,\n    expiration: 0,\n});\n\n/**\n * Check whether an account is authorized to store data on the Bulletin Chain.\n *\n * Queries `TransactionStorage.Authorizations` for the given address and returns\n * the raw authorization quota. Use this as a pre-flight check before calling\n * {@link upload} to provide clear UX (\"not authorized\" / \"insufficient quota\")\n * instead of letting the transaction fail mid-execution.\n *\n * The expiration block number is returned as-is — the chain enforces expiration\n * at submission time, so callers can optionally compare against the current\n * block for display purposes.\n *\n * @param api     - Typed Bulletin Chain API instance.\n * @param address - SS58-encoded account address to check.\n * @returns Authorization status with remaining quota.\n *\n * @example\n * ```ts\n * import { checkAuthorization } from \"@parity/product-sdk-bulletin\";\n *\n * const auth = await checkAuthorization(api, address);\n * if (!auth.authorized) {\n *     console.error(\"Account is not authorized for bulletin storage\");\n * } else if (auth.remainingBytes < BigInt(fileBytes.length)) {\n *     console.error(`Insufficient quota: ${auth.remainingBytes} bytes remaining`);\n * }\n * ```\n *\n * @see {@link BulletinClient.checkAuthorization} for the client method equivalent.\n */\nexport async function checkAuthorization(\n    api: BulletinApi,\n    address: string,\n): Promise<AuthorizationStatus> {\n    let auth;\n    try {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        auth = await (api as any).query.TransactionStorage.Authorizations.getValue(\n            Enum(\"Account\", address),\n        );\n    } catch (error) {\n        log.error(\"checkAuthorization: query failed\", { address, error });\n        throw new BulletinAuthorizationError(address, error);\n    }\n\n    if (!auth) {\n        log.debug(\"checkAuthorization: no authorization found\", { address });\n        return NOT_AUTHORIZED;\n    }\n\n    const status: AuthorizationStatus = {\n        authorized: true,\n        remainingTransactions: auth.extent.transactions,\n        remainingBytes: auth.extent.bytes,\n        expiration: auth.expiration,\n    };\n\n    log.debug(\"checkAuthorization\", {\n        address,\n        remainingTransactions: status.remainingTransactions,\n        remainingBytes: status.remainingBytes.toString(),\n        expiration: status.expiration,\n    });\n\n    return status;\n}\n\n/**\n * Options for {@link authorizeAccount}.\n */\nexport interface AuthorizeAccountOptions {\n    /**\n     * Wrap the extrinsic in `Sudo.sudo(...)` before submission. Default: `false`.\n     *\n     * Use `true` on networks where granting bulletin storage authorization\n     * requires sudo permissions (most production / managed test networks).\n     * Use `false` (default) when the account self-authorizes — typical for\n     * local development chains.\n     */\n    viaSudo?: boolean;\n    /** When to resolve: `\"best-block\"` (default) or `\"finalized\"`. */\n    waitFor?: WaitFor;\n    /** Timeout in ms. Default: 300_000 (5 min). */\n    timeoutMs?: number;\n    /** Lifecycle status callback for UI progress. */\n    onStatus?: (status: TxStatus) => void;\n}\n\n/**\n * Grant an account authorization to store data on the Bulletin Chain.\n *\n * Submits a `TransactionStorage.authorize_account` extrinsic, optionally\n * wrapped in `Sudo.sudo(...)` for networks that require sudo to grant\n * authorization. Mirrors the call shape of {@link upload} — top-level\n * function, takes an explicit signer, returns a block hash on success.\n *\n * Pair with {@link checkAuthorization} for a typical \"check, grant if\n * insufficient, then upload\" flow.\n *\n * ## Additive semantics — call once per authorization need\n *\n * `authorize_account` is **additive** within an unexpired authorization window\n * for `AuthorizationScope::Account` (see `pallet-bulletin-transaction-storage`,\n * `fn authorize`). Each successful call **adds** to the existing\n * `transactions_allowance` and `bytes_allowance` rather than overwriting them.\n *\n * Implications for callers:\n *\n * - Calling this function twice with `(100, 1MB)` while the previous\n *   authorization is still active leaves the account with quota for `200`\n *   transactions and `2MB` — likely unintended.\n * - **This function does NOT use `withRetry`.** Retrying a successful-but-\n *   acknowledgment-lost submission would double-grant the quota. Callers\n *   needing retry should wrap this function and use {@link checkAuthorization}\n *   to verify the post-state before retrying.\n * - To \"reset\" a quota, let the existing authorization expire\n *   (`AuthorizationPeriod` blocks). The next call after expiry creates a fresh\n *   authorization rather than adding.\n *\n * Note: `AuthorizationScope::Preimage` uses `set` semantics in the same\n * pallet. This helper is for account-scope authorization only.\n *\n * @param api          - Typed Bulletin Chain API instance.\n * @param who          - SS58-encoded account to authorize.\n * @param transactions - Number of transactions to **add** to the account's allowance.\n * @param bytes        - Byte budget to **add** to the account's allowance.\n * @param signer       - Signer for the extrinsic. On `viaSudo: true` this must be the sudo key.\n * @param options      - Optional `viaSudo` flag plus standard submission controls.\n * @returns Block hash where the extrinsic was included.\n * @throws {ProductBulletinError} If `viaSudo: true` is requested but the chain has no `Sudo` pallet.\n *\n * @example Direct (account self-authorizes — local dev)\n * ```ts\n * import { authorizeAccount } from \"@parity/product-sdk-bulletin\";\n *\n * await authorizeAccount(api, address, 100, 100n * 1024n * 1024n, signer);\n * ```\n *\n * @example Sudo-wrapped (managed test network)\n * ```ts\n * await authorizeAccount(api, userAddress, 100, 1_000_000n, sudoSigner, {\n *     viaSudo: true,\n * });\n * ```\n *\n * @see {@link checkAuthorization} for the read counterpart.\n * @see {@link BulletinClient.authorizeAccount} for the client method equivalent.\n */\nexport async function authorizeAccount(\n    api: BulletinApi,\n    who: string,\n    transactions: number,\n    bytes: bigint,\n    signer: PolkadotSigner,\n    options: AuthorizeAccountOptions = {},\n): Promise<{ blockHash: string }> {\n    const { viaSudo = false, waitFor, timeoutMs, onStatus } = options;\n\n    // Single `as any` cast for the whole function. `BulletinApi` is upstream-\n    // typed as `TypedApi<any>` (see types.ts), so member access is loose by\n    // design. Same pattern as upload.ts:57 — narrowing it requires retyping\n    // BulletinApi against a bundled descriptor (out of scope here).\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const apiTx = (api as any).tx;\n\n    log.info(\"authorizeAccount: building extrinsic\", {\n        who,\n        transactions,\n        bytes: bytes.toString(),\n        viaSudo,\n    });\n\n    if (viaSudo && !apiTx.Sudo?.sudo) {\n        throw new ProductBulletinError(\n            \"viaSudo: true requires the Sudo pallet, which is not available on this network. \" +\n                \"On production networks (Polkadot, Kusama), authorize_account requires governance or a different mechanism.\",\n        );\n    }\n\n    const authorizeTx = apiTx.TransactionStorage.authorize_account({\n        who,\n        transactions,\n        bytes,\n    });\n\n    const txToSubmit = viaSudo ? apiTx.Sudo.sudo({ call: authorizeTx.decodedCall }) : authorizeTx;\n\n    // NOTE: Intentionally NOT using `withRetry` here. `authorize_account` is\n    // additive (see JSDoc above), so a retry after a successful-but-lost\n    // submission would double-grant the quota. Caller-side retry must verify\n    // post-state via `checkAuthorization` first.\n    const result = await submitAndWatch(txToSubmit, signer, {\n        waitFor,\n        timeoutMs,\n        onStatus,\n    });\n\n    log.info(\"authorizeAccount: included in block\", {\n        who,\n        blockHash: result.block.hash,\n    });\n\n    return { blockHash: result.block.hash };\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    function createMockApi(authResult: unknown) {\n        return {\n            query: {\n                TransactionStorage: {\n                    Authorizations: {\n                        getValue: vi.fn().mockResolvedValue(authResult),\n                    },\n                },\n            },\n        } as unknown as BulletinApi;\n    }\n\n    describe(\"checkAuthorization\", () => {\n        test(\"returns not authorized when no authorization exists\", async () => {\n            const api = createMockApi(undefined);\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(false);\n            expect(status.remainingTransactions).toBe(0);\n            expect(status.remainingBytes).toBe(0n);\n            expect(status.expiration).toBe(0);\n        });\n\n        test(\"returns authorization with full quota\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 10, bytes: 1_000_000n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingTransactions).toBe(10);\n            expect(status.remainingBytes).toBe(1_000_000n);\n            expect(status.expiration).toBe(999);\n        });\n\n        test(\"returns authorization with zero transactions remaining\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 0, bytes: 1_000_000n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingTransactions).toBe(0);\n        });\n\n        test(\"returns authorization with zero bytes remaining\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 5, bytes: 0n },\n                expiration: 999,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.authorized).toBe(true);\n            expect(status.remainingBytes).toBe(0n);\n        });\n\n        test(\"preserves expiration block number\", async () => {\n            const api = createMockApi({\n                extent: { transactions: 1, bytes: 500n },\n                expiration: 12345,\n            });\n            const status = await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(status.expiration).toBe(12345);\n        });\n\n        test(\"throws BulletinAuthorizationError when query fails\", async () => {\n            const api = {\n                query: {\n                    TransactionStorage: {\n                        Authorizations: {\n                            getValue: vi.fn().mockRejectedValue(new Error(\"RPC connection lost\")),\n                        },\n                    },\n                },\n            } as unknown as BulletinApi;\n\n            const err = await checkAuthorization(api, \"5GrwvaEF...\").catch((e: unknown) => e);\n            expect(err).toBeInstanceOf(BulletinAuthorizationError);\n            const error = err as BulletinAuthorizationError;\n            expect(error.address).toBe(\"5GrwvaEF...\");\n            expect(error.cause).toBeInstanceOf(Error);\n            expect((error.cause as Error).message).toBe(\"RPC connection lost\");\n        });\n\n        test(\"passes correct Enum key to the query\", async () => {\n            const getValue = vi.fn().mockResolvedValue(undefined);\n            const api = {\n                query: {\n                    TransactionStorage: {\n                        Authorizations: { getValue },\n                    },\n                },\n            } as unknown as BulletinApi;\n\n            await checkAuthorization(api, \"5GrwvaEF...\");\n\n            expect(getValue).toHaveBeenCalledTimes(1);\n            const arg = getValue.mock.calls[0][0];\n            expect(arg.type).toBe(\"Account\");\n            expect(arg.value).toBe(\"5GrwvaEF...\");\n        });\n    });\n\n    /**\n     * Mock factory for `authorizeAccount` tests.\n     *\n     * Mirrors the mocking style used in `upload.ts` — we don't mock\n     * `submitAndWatch` (the SDK helper) directly. Instead we let it call\n     * through to a fake `signSubmitAndWatch` on the api, which emits the\n     * lifecycle events `submitAndWatch` listens for.\n     */\n    function createMockApiForAuthorize(blockHash = \"0xblockhash\") {\n        const fakeTx = {\n            decodedCall: { fakeCall: true } as unknown,\n            signSubmitAndWatch: vi.fn().mockReturnValue({\n                subscribe: (handlers: { next: (e: unknown) => void }) => {\n                    queueMicrotask(() => {\n                        handlers.next({ type: \"signed\", txHash: \"0xtxhash\" });\n                        handlers.next({\n                            type: \"txBestBlocksState\",\n                            txHash: \"0xtxhash\",\n                            found: true,\n                            ok: true,\n                            block: { hash: blockHash, number: 1, index: 0 },\n                            events: [],\n                        });\n                    });\n                    return { unsubscribe: vi.fn() };\n                },\n            }),\n        };\n\n        return {\n            api: {\n                tx: {\n                    TransactionStorage: {\n                        authorize_account: vi.fn().mockReturnValue(fakeTx),\n                    },\n                    Sudo: {\n                        sudo: vi.fn().mockReturnValue(fakeTx),\n                    },\n                },\n            },\n            fakeTx,\n        };\n    }\n\n    const mockSigner = {} as PolkadotSigner;\n\n    describe(\"authorizeAccount\", () => {\n        test(\"direct path: calls TransactionStorage.authorize_account with the right params\", async () => {\n            const { api } = createMockApiForAuthorize();\n\n            await authorizeAccount(\n                api as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                100,\n                1_000_000n,\n                mockSigner,\n            );\n\n            expect(api.tx.TransactionStorage.authorize_account).toHaveBeenCalledOnce();\n            const arg = api.tx.TransactionStorage.authorize_account.mock.calls[0][0];\n            expect(arg.who).toBe(\"5GrwvaEF...\");\n            expect(arg.transactions).toBe(100);\n            expect(arg.bytes).toBe(1_000_000n);\n        });\n\n        test(\"direct path: does NOT call Sudo.sudo when viaSudo is false (default)\", async () => {\n            const { api } = createMockApiForAuthorize();\n\n            await authorizeAccount(\n                api as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                10,\n                100n,\n                mockSigner,\n            );\n\n            expect(api.tx.Sudo.sudo).not.toHaveBeenCalled();\n        });\n\n        test(\"direct path: returns the block hash from submission\", async () => {\n            const { api } = createMockApiForAuthorize(\"0xdeadbeef\");\n\n            const result = await authorizeAccount(\n                api as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                10,\n                100n,\n                mockSigner,\n            );\n\n            expect(result).toEqual({ blockHash: \"0xdeadbeef\" });\n        });\n\n        test(\"sudo path: wraps the authorize_account call inside Sudo.sudo\", async () => {\n            const { api, fakeTx } = createMockApiForAuthorize();\n\n            await authorizeAccount(\n                api as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                10,\n                100n,\n                mockSigner,\n                { viaSudo: true },\n            );\n\n            expect(api.tx.Sudo.sudo).toHaveBeenCalledOnce();\n            const sudoArg = api.tx.Sudo.sudo.mock.calls[0][0];\n            expect(sudoArg.call).toBe(fakeTx.decodedCall);\n        });\n\n        test(\"sudo path: still returns the block hash from the sudo extrinsic\", async () => {\n            const { api } = createMockApiForAuthorize(\"0xsudoblock\");\n\n            const result = await authorizeAccount(\n                api as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                10,\n                100n,\n                mockSigner,\n                { viaSudo: true },\n            );\n\n            expect(result).toEqual({ blockHash: \"0xsudoblock\" });\n        });\n\n        test(\"throws ProductBulletinError when viaSudo is true but the chain lacks a Sudo pallet\", async () => {\n            const apiWithoutSudo = {\n                tx: {\n                    TransactionStorage: {\n                        authorize_account: vi.fn().mockReturnValue({\n                            decodedCall: {} as unknown,\n                            signSubmitAndWatch: vi.fn(),\n                        }),\n                    },\n                    // Sudo intentionally absent — represents production Polkadot/Kusama\n                },\n            };\n\n            const err = await authorizeAccount(\n                apiWithoutSudo as unknown as BulletinApi,\n                \"5GrwvaEF...\",\n                10,\n                100n,\n                mockSigner,\n                { viaSudo: true },\n            ).catch((e: unknown) => e);\n\n            expect(err).toBeInstanceOf(ProductBulletinError);\n            expect((err as Error).message).toMatch(/Sudo pallet/i);\n            // Verify we did NOT proceed to submit anything\n            expect(apiWithoutSudo.tx.TransactionStorage.authorize_account).not.toHaveBeenCalled();\n        });\n\n        // Note: submission-failure propagation is tested upstream in\n        // @parity/product-sdk-tx's own suite. Re-testing it here would just\n        // re-test submitAndWatch's error path through a brittle mock, which\n        // depends on internal event-shape details outside this file's contract.\n    });\n}\n","/**\n * CID helpers for converting between on-chain hex hashes and CIDs.\n *\n * Upstream `@parity/bulletin-sdk` exposes `calculateCid` (data → CID),\n * `parseCid` (string → CID), `cidFromBytes` (full-encoded → CID), and\n * `cidToBytes` (CID → full-encoded). The helpers here add a thin layer\n * for the `0x`-prefixed hex shape that on-chain `TransactionInfo` uses,\n * so callers don't need to do the digest plumbing themselves.\n *\n * Both helpers default to the chain default (blake2b-256, raw codec).\n * Pass `HashAlgorithm` and `CidCodec` for other configurations\n * (sha2-256, dag-pb, etc.).\n */\nimport { CID } from \"multiformats/cid\";\nimport * as Digest from \"multiformats/hashes/digest\";\n\nimport { BulletinCidError } from \"./errors.js\";\n\n/**\n * Hash algorithms supported by the Bulletin Chain.\n *\n * Values are multihash codes from the multicodec table.\n */\nexport const HashAlgorithm = {\n    /** BLAKE2b-256 — chain default. */\n    Blake2b256: 0xb220,\n    /** SHA2-256. */\n    Sha2_256: 0x12,\n    /** Keccak-256 — Ethereum compatibility. */\n    Keccak256: 0x1b,\n} as const;\nexport type HashAlgorithm = (typeof HashAlgorithm)[keyof typeof HashAlgorithm];\n\n/**\n * CID codecs supported by the Bulletin Chain.\n */\nexport const CidCodec = {\n    /** Raw binary — default for single-chunk data. */\n    Raw: 0x55,\n    /** DAG-PB — used for multi-chunk manifests / IPFS UnixFS. */\n    DagPb: 0x70,\n    /** DAG-CBOR — alternative DAG encoding. */\n    DagCbor: 0x71,\n} as const;\nexport type CidCodec = (typeof CidCodec)[keyof typeof CidCodec];\n\nconst SUPPORTED_HASH_CODES = new Set<number>(Object.values(HashAlgorithm));\nconst SUPPORTED_CODEC_CODES = new Set<number>(Object.values(CidCodec));\nconst EXPECTED_HEX_LENGTH = 66; // \"0x\" + 64 hex chars (32-byte digest)\n\n/**\n * Reconstruct a CIDv1 from a `0x`-prefixed 32-byte hex hash.\n *\n * Useful when reading on-chain `TransactionInfo.content_hash` and you need\n * the CID to look up content via an IPFS gateway.\n *\n * @param hexHash  - 66-char `0x`-prefixed hex of a 32-byte digest.\n * @param hashCode - Multihash code (default: blake2b-256).\n * @param codec    - Multicodec code (default: raw).\n */\nexport function hashToCid(\n    hexHash: `0x${string}`,\n    hashCode: HashAlgorithm = HashAlgorithm.Blake2b256,\n    codec: CidCodec = CidCodec.Raw,\n): string {\n    if (hexHash.length !== EXPECTED_HEX_LENGTH) {\n        throw new BulletinCidError(\n            `Expected a 0x-prefixed 32-byte hex hash (${EXPECTED_HEX_LENGTH} chars), ` +\n                `got ${hexHash.length} chars`,\n        );\n    }\n    if (!/^0x[0-9a-fA-F]{64}$/.test(hexHash)) {\n        throw new BulletinCidError(\n            `Invalid hash format: expected 0x-prefixed 32-byte hex string, got: ${hexHash}`,\n        );\n    }\n    if (!SUPPORTED_HASH_CODES.has(hashCode)) {\n        throw new BulletinCidError(\n            `Unsupported hash algorithm 0x${hashCode.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_HASH_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n        );\n    }\n    if (!SUPPORTED_CODEC_CODES.has(codec)) {\n        throw new BulletinCidError(\n            `Unsupported CID codec 0x${codec.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_CODEC_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n        );\n    }\n    const digest = hexToBytes(hexHash);\n    return CID.createV1(codec, Digest.create(hashCode, digest)).toString();\n}\n\n/**\n * Extract the 32-byte content hash digest from a CIDv1 and return it as a\n * `0x`-prefixed hex string.\n *\n * Useful for matching a CID against on-chain `TransactionInfo.content_hash`.\n */\nexport function cidToPreimageKey(cid: string): `0x${string}` {\n    let parsed;\n    try {\n        parsed = CID.parse(cid);\n    } catch {\n        throw new BulletinCidError(`Invalid CID: ${cid}`, cid);\n    }\n    if (parsed.version !== 1) {\n        throw new BulletinCidError(`Expected CIDv1, got CIDv${parsed.version}`, cid);\n    }\n    if (!SUPPORTED_HASH_CODES.has(parsed.multihash.code)) {\n        throw new BulletinCidError(\n            `Unsupported hash algorithm 0x${parsed.multihash.code.toString(16)}; ` +\n                `expected one of: ${[...SUPPORTED_HASH_CODES].map((c) => `0x${c.toString(16)}`).join(\", \")}`,\n            cid,\n        );\n    }\n    return `0x${bytesToHex(parsed.multihash.digest)}` as `0x${string}`;\n}\n\nfunction hexToBytes(hex: `0x${string}`): Uint8Array {\n    const out = new Uint8Array(32);\n    for (let i = 0; i < 32; i++) {\n        out[i] = Number.parseInt(hex.slice(2 + i * 2, 4 + i * 2), 16);\n    }\n    return out;\n}\n\nfunction bytesToHex(bytes: Uint8Array): string {\n    let s = \"\";\n    for (let i = 0; i < bytes.length; i++) {\n        s += bytes[i]!.toString(16).padStart(2, \"0\");\n    }\n    return s;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    describe(\"hashToCid\", () => {\n        const sampleHex = `0x${\"ab\".repeat(32)}` as `0x${string}`;\n\n        test(\"produces valid base32-lower CIDv1 (default: blake2b-256, raw)\", () => {\n            const cid = hashToCid(sampleHex);\n            expect(cid).toMatch(/^b[a-z2-7]+$/);\n            const parsed = CID.parse(cid);\n            expect(parsed.version).toBe(1);\n            expect(parsed.code).toBe(CidCodec.Raw);\n            expect(parsed.multihash.code).toBe(HashAlgorithm.Blake2b256);\n        });\n\n        test(\"supports sha2-256\", () => {\n            const cid = hashToCid(sampleHex, HashAlgorithm.Sha2_256);\n            expect(CID.parse(cid).multihash.code).toBe(HashAlgorithm.Sha2_256);\n        });\n\n        test(\"supports dag-pb codec\", () => {\n            const cid = hashToCid(sampleHex, HashAlgorithm.Blake2b256, CidCodec.DagPb);\n            expect(CID.parse(cid).code).toBe(CidCodec.DagPb);\n        });\n\n        test(\"throws on short hex\", () => {\n            expect(() => hashToCid(\"0xabcd\" as `0x${string}`)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on long hex\", () => {\n            const tooLong = `0x${\"aa\".repeat(33)}` as `0x${string}`;\n            expect(() => hashToCid(tooLong)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on non-hex characters\", () => {\n            const bad = `0x${\"zz\".repeat(32)}` as `0x${string}`;\n            expect(() => hashToCid(bad)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on unsupported hash algorithm\", () => {\n            expect(() => hashToCid(sampleHex, 0x99 as HashAlgorithm)).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on unsupported codec\", () => {\n            expect(() => hashToCid(sampleHex, HashAlgorithm.Blake2b256, 0x99 as CidCodec)).toThrow(\n                BulletinCidError,\n            );\n        });\n    });\n\n    describe(\"cidToPreimageKey\", () => {\n        test(\"round-trip with hashToCid\", () => {\n            const hex = `0x${\"cd\".repeat(32)}` as `0x${string}`;\n            const cid = hashToCid(hex);\n            expect(cidToPreimageKey(cid)).toBe(hex);\n        });\n\n        test(\"round-trip with sha2-256\", () => {\n            const hex = `0x${\"ef\".repeat(32)}` as `0x${string}`;\n            const cid = hashToCid(hex, HashAlgorithm.Sha2_256);\n            expect(cidToPreimageKey(cid)).toBe(hex);\n        });\n\n        test(\"throws on invalid CID string\", () => {\n            expect(() => cidToPreimageKey(\"not-a-cid\")).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on CIDv0 input\", () => {\n            const hash = new Uint8Array(32).fill(0xab);\n            const cidV0 = CID.create(0, 0x70, Digest.create(HashAlgorithm.Sha2_256, hash));\n            expect(() => cidToPreimageKey(cidV0.toString())).toThrow(BulletinCidError);\n        });\n\n        test(\"throws on unsupported hash algorithm\", () => {\n            const hash = new Uint8Array(32).fill(0xab);\n            const cidV1 = CID.createV1(CidCodec.Raw, Digest.create(0x99, hash));\n            expect(() => cidToPreimageKey(cidV1.toString())).toThrow(BulletinCidError);\n        });\n    });\n}\n","import { calculateCid } from \"@parity/bulletin-sdk\";\nimport { getPreimageManager, type PreimageManager } from \"@parity/product-sdk-host\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\n\nimport { cidToPreimageKey } from \"./cid.js\";\nimport {\n    BulletinHostUnavailableError,\n    BulletinLookupInterruptedError,\n    BulletinLookupTimeoutError,\n} from \"./errors.js\";\n\nconst log = createLogger(\"bulletin\");\n\nconst DEFAULT_LOOKUP_TIMEOUT_MS = 30_000;\n\n/**\n * Query strategy for the Bulletin Chain.\n *\n * The host manages the lookup via its preimage subscription API,\n * which includes local caching and managed IPFS polling.\n */\nexport interface QueryStrategy {\n    kind: \"host-lookup\";\n    lookup: (cid: string, timeoutMs?: number) => Promise<Uint8Array>;\n}\n\n/**\n * Determine the query strategy for the Bulletin Chain.\n *\n * Uses the host preimage lookup API which caches results and manages\n * IPFS polling automatically.\n *\n * @returns The resolved query strategy.\n * @throws {BulletinHostUnavailableError} If the host preimage manager is unavailable.\n */\nexport async function resolveQueryStrategy(): Promise<QueryStrategy> {\n    const preimageManager = await getPreimageManager();\n    if (preimageManager) {\n        log.info(\"using host preimage lookup for bulletin queries\");\n        return {\n            kind: \"host-lookup\",\n            lookup: (cid, timeoutMs) => lookupViaHost(preimageManager, cid, timeoutMs),\n        };\n    }\n\n    throw new BulletinHostUnavailableError(\"query\");\n}\n\n/**\n * Wrap `preimageManager.lookup` (subscription-based) into a one-shot Promise.\n *\n * Converts the CID to a hex preimage key, subscribes, and resolves on the\n * first non-null callback. Rejects on timeout or if the host interrupts the\n * subscription (e.g. after repeated failures). Always unsubscribes on settlement.\n *\n * @param manager   - The product-sdk preimage manager.\n * @param cid       - CIDv1 string to look up.\n * @param timeoutMs - Maximum wait time. Default: 30_000ms.\n * @returns The raw bytes of the preimage.\n */\nexport function lookupViaHost(\n    manager: PreimageManager,\n    cid: string,\n    timeoutMs: number = DEFAULT_LOOKUP_TIMEOUT_MS,\n): Promise<Uint8Array> {\n    const key = cidToPreimageKey(cid);\n\n    return new Promise<Uint8Array>((resolve, reject) => {\n        const cleanup = () => {\n            cancelInterrupt();\n            sub.unsubscribe();\n        };\n\n        const settle = (fn: () => void) => {\n            if (timer === null) return;\n            clearTimeout(timer);\n            timer = null;\n            cleanup();\n            fn();\n        };\n\n        let timer: ReturnType<typeof setTimeout> | null = setTimeout(() => {\n            settle(() => {\n                reject(new BulletinLookupTimeoutError(cid, timeoutMs));\n            });\n        }, timeoutMs);\n\n        const sub = manager.lookup(key, (preimage) => {\n            if (preimage !== null) {\n                settle(() => resolve(preimage));\n            }\n            // null means \"not found yet\" — host will keep polling\n        });\n\n        const cancelInterrupt = sub.onInterrupt(() => {\n            settle(() => {\n                reject(new BulletinLookupInterruptedError(cid));\n            });\n        });\n    });\n}\n\nif (import.meta.vitest) {\n    const { beforeAll, describe, test, expect, vi } = import.meta.vitest;\n\n    // Note: resolveQueryStrategy tests require e2e testing as they\n    // depend on the host container environment.\n\n    describe(\"lookupViaHost\", () => {\n        function createMockManager(\n            behavior: \"resolve\" | \"null-then-resolve\" | \"hang\" | \"interrupt\",\n        ) {\n            const unsubscribe = vi.fn();\n            const cancelInterrupt = vi.fn();\n            let interruptCb: VoidFunction | undefined;\n\n            const lookup = vi.fn((_key: string, callback: (p: Uint8Array | null) => void) => {\n                const data = new Uint8Array([10, 20, 30]);\n                queueMicrotask(() => {\n                    if (behavior === \"resolve\") {\n                        callback(data);\n                    } else if (behavior === \"null-then-resolve\") {\n                        callback(null);\n                        queueMicrotask(() => callback(data));\n                    } else if (behavior === \"interrupt\") {\n                        interruptCb?.();\n                    }\n                    // \"hang\" does nothing\n                });\n                return {\n                    unsubscribe,\n                    onInterrupt: (cb: VoidFunction) => {\n                        interruptCb = cb;\n                        return cancelInterrupt;\n                    },\n                };\n            });\n\n            return { lookup, unsubscribe, cancelInterrupt, submit: vi.fn() };\n        }\n\n        // calculateCid is async (Web Crypto), so populate lazily.\n        let testCid: string;\n        beforeAll(async () => {\n            const cid = await calculateCid(new TextEncoder().encode(\"test\"));\n            testCid = cid.toString();\n        });\n\n        test(\"resolves on first non-null callback\", async () => {\n            const manager = createMockManager(\"resolve\");\n            const result = await lookupViaHost(manager, testCid);\n            expect(result).toEqual(new Uint8Array([10, 20, 30]));\n        });\n\n        test(\"ignores null callbacks and resolves on subsequent data\", async () => {\n            const manager = createMockManager(\"null-then-resolve\");\n            const result = await lookupViaHost(manager, testCid);\n            expect(result).toEqual(new Uint8Array([10, 20, 30]));\n        });\n\n        test(\"rejects with BulletinLookupTimeoutError on timeout\", async () => {\n            const { BulletinLookupTimeoutError } = await import(\"./errors.js\");\n            const manager = createMockManager(\"hang\");\n            const err = await lookupViaHost(manager, testCid, 50).catch((e) => e);\n            expect(err).toBeInstanceOf(BulletinLookupTimeoutError);\n            expect(err.cid).toBe(testCid);\n            expect(err.timeoutMs).toBe(50);\n        });\n\n        test(\"rejects with BulletinLookupInterruptedError on interrupt\", async () => {\n            const { BulletinLookupInterruptedError } = await import(\"./errors.js\");\n            const manager = createMockManager(\"interrupt\");\n            const err = await lookupViaHost(manager, testCid).catch((e) => e);\n            expect(err).toBeInstanceOf(BulletinLookupInterruptedError);\n            expect(err.cid).toBe(testCid);\n        });\n\n        test(\"calls unsubscribe and cancelInterrupt on resolution\", async () => {\n            const manager = createMockManager(\"resolve\");\n            await lookupViaHost(manager, testCid);\n            expect(manager.unsubscribe).toHaveBeenCalledOnce();\n            expect(manager.cancelInterrupt).toHaveBeenCalledOnce();\n        });\n\n        test(\"calls unsubscribe on interrupt\", async () => {\n            const manager = createMockManager(\"interrupt\");\n            await lookupViaHost(manager, testCid).catch(() => {});\n            expect(manager.unsubscribe).toHaveBeenCalledOnce();\n        });\n\n        test(\"passes correct hex key to manager\", async () => {\n            const expectedKey = cidToPreimageKey(testCid);\n            const manager = createMockManager(\"resolve\");\n            await lookupViaHost(manager, testCid);\n            expect(manager.lookup).toHaveBeenCalledWith(expectedKey, expect.any(Function));\n        });\n    });\n}\n","import { CidCodec, parseCid, UnixFsDagBuilder } from \"@parity/bulletin-sdk\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\n\nimport type { QueryStrategy } from \"./resolve-query.js\";\nimport { resolveQueryStrategy } from \"./resolve-query.js\";\nimport type { QueryOptions } from \"./types.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Fetch raw bytes for a CID via the host's preimage lookup.\n *\n * Container-only by design: the bulletin SDK does not retrieve content\n * through public IPFS gateways. Inside a Polkadot Browser / Desktop\n * container, the host's `preimageManager` provides a cached, polling-\n * managed lookup that returns bytes when the underlying IPFS network\n * makes them available. Outside a container, this throws\n * {@link BulletinHostUnavailableError}.\n *\n * The bulletin chain stores transaction *metadata* on-chain\n * (`chunk_root`, `content_hash`, `size`, `cid_codec`, `hashing`) — the\n * content bytes themselves live in IPFS and are surfaced through the\n * host's preimage subscription, never via direct gateway fetch.\n *\n * To prove that a CID was stored on-chain (without fetching the bytes),\n * use `verifyOnChain` from `verify.ts`.\n *\n * @param cid     - CIDv1 string to fetch.\n * @param options - Query options (`lookupTimeoutMs` for host).\n * @throws {BulletinHostUnavailableError} If running outside a container.\n */\nexport async function queryBytes(cid: string, options?: QueryOptions): Promise<Uint8Array> {\n    const strategy = await resolveQueryStrategy();\n    return executeQuery(strategy, cid, options);\n}\n\n/**\n * Fetch and parse JSON for a CID via the host's preimage lookup.\n *\n * Convenience wrapper over {@link queryBytes}.\n */\nexport async function queryJson<T>(cid: string, options?: QueryOptions): Promise<T> {\n    const bytes = await queryBytes(cid, options);\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Execute a query using a pre-resolved strategy.\n *\n * Exposed so `BulletinClient` can resolve the strategy once at\n * construction time and reuse it across calls without re-detecting\n * the host environment on every fetch.\n *\n * **Reassembly is automatic.** If `cid` carries the DAG-PB codec\n * (`0x70`) — meaning the upload was chunked and a UnixFS manifest was\n * created — this function recursively fetches each chunk via `strategy\n * .lookup` and returns the concatenated bytes. Pass `noReassemble: true`\n * to get the raw manifest bytes instead.\n *\n * For raw-codec CIDs (`0x55`, single-chunk content), the bytes returned\n * by the host are returned directly — no parsing overhead.\n */\nexport async function executeQuery(\n    strategy: QueryStrategy,\n    cid: string,\n    options?: QueryOptions,\n): Promise<Uint8Array> {\n    log.info(\"query: host preimage lookup\", { cid });\n    const bytes = await strategy.lookup(cid, options?.lookupTimeoutMs);\n\n    // Skip reassembly when the caller explicitly asks for raw bytes, or\n    // when the CID's codec says this is a single-block payload (raw,\n    // 0x55) — most uploads land here, so the parseCid + Promise.all\n    // overhead is worth gating on codec rather than always paying it.\n    if (options?.noReassemble) return bytes;\n    const parsed = parseCid(cid);\n    if (parsed.code !== CidCodec.DagPb) return bytes;\n\n    log.info(\"query: reassembling DAG-PB manifest\", { cid });\n    const builder = new UnixFsDagBuilder();\n    const { chunkCids } = await builder.parse(bytes);\n\n    // Fetch chunks in parallel — the host's preimageManager caches and\n    // dedupes lookups, and order is preserved by Promise.all's input\n    // ordering, which matches the DAG-PB Links order from parse().\n    const chunks = await Promise.all(\n        chunkCids.map((c) => strategy.lookup(c.toString(), options?.lookupTimeoutMs)),\n    );\n\n    let total = 0;\n    for (const chunk of chunks) total += chunk.length;\n    const out = new Uint8Array(total);\n    let offset = 0;\n    for (const chunk of chunks) {\n        out.set(chunk, offset);\n        offset += chunk.length;\n    }\n    return out;\n}\n\nif (import.meta.vitest) {\n    const { beforeAll, describe, test, expect, vi } = import.meta.vitest;\n    const { calculateCid } = await import(\"@parity/bulletin-sdk\");\n\n    describe(\"executeQuery\", () => {\n        const testData = new Uint8Array([1, 2, 3]);\n\n        test(\"delegates to the strategy's lookup function\", async () => {\n            const lookup = vi.fn().mockResolvedValue(testData);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            // Use a real raw-codec CID so the codec check passes through\n            // without triggering reassembly.\n            const rawCid = (await calculateCid(testData)).toString();\n            const result = await executeQuery(strategy, rawCid);\n            expect(result).toBe(testData);\n            expect(lookup).toHaveBeenCalledWith(rawCid, undefined);\n        });\n\n        test(\"forwards lookupTimeoutMs to the strategy\", async () => {\n            const lookup = vi.fn().mockResolvedValue(testData);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            const rawCid = (await calculateCid(testData)).toString();\n            await executeQuery(strategy, rawCid, { lookupTimeoutMs: 5000 });\n            expect(lookup).toHaveBeenCalledWith(rawCid, 5000);\n        });\n\n        test(\"returns raw bytes directly for raw-codec CIDs (no reassembly)\", async () => {\n            const lookup = vi.fn().mockResolvedValue(testData);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            const rawCid = (await calculateCid(testData)).toString();\n            const result = await executeQuery(strategy, rawCid);\n            expect(result).toBe(testData);\n            // Single lookup, no recursion.\n            expect(lookup).toHaveBeenCalledTimes(1);\n        });\n\n        test(\"noReassemble: true short-circuits even for DAG-PB CIDs\", async () => {\n            // Manufacture a DAG-PB CID; we don't need the bytes to actually\n            // be a valid manifest because we're skipping the parse step.\n            const fakeManifestBytes = new Uint8Array([10, 20, 30]);\n            const dagPbCid = (await calculateCid(fakeManifestBytes, /* dag-pb */ 0x70)).toString();\n            const lookup = vi.fn().mockResolvedValue(fakeManifestBytes);\n            const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n            const result = await executeQuery(strategy, dagPbCid, { noReassemble: true });\n            expect(result).toBe(fakeManifestBytes);\n            expect(lookup).toHaveBeenCalledTimes(1);\n        });\n\n        describe(\"DAG-PB reassembly\", () => {\n            // Build a real manifest: two raw chunks, dag-pb root.\n            const chunkA = new Uint8Array([0xaa, 0xaa, 0xaa]);\n            const chunkB = new Uint8Array([0xbb, 0xbb]);\n            let chunkACid: string;\n            let chunkBCid: string;\n            let manifestBytes: Uint8Array;\n            let manifestCid: string;\n\n            beforeAll(async () => {\n                const { UnixFsDagBuilder: Builder } = await import(\"@parity/bulletin-sdk\");\n                chunkACid = (await calculateCid(chunkA)).toString();\n                chunkBCid = (await calculateCid(chunkB)).toString();\n                const cidA = await calculateCid(chunkA);\n                const cidB = await calculateCid(chunkB);\n                const manifest = await new Builder().build([\n                    { data: chunkA, cid: cidA, index: 0, totalChunks: 2 },\n                    { data: chunkB, cid: cidB, index: 1, totalChunks: 2 },\n                ]);\n                manifestBytes = manifest.dagBytes;\n                manifestCid = manifest.rootCid.toString();\n            });\n\n            test(\"recursively fetches chunks and concatenates\", async () => {\n                const lookup = vi.fn(async (cid: string) => {\n                    if (cid === manifestCid) return manifestBytes;\n                    if (cid === chunkACid) return chunkA;\n                    if (cid === chunkBCid) return chunkB;\n                    throw new Error(`unexpected lookup: ${cid}`);\n                });\n                const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n                const result = await executeQuery(strategy, manifestCid);\n                expect(result).toEqual(new Uint8Array([0xaa, 0xaa, 0xaa, 0xbb, 0xbb]));\n                // 1 manifest + 2 chunks = 3 lookups.\n                expect(lookup).toHaveBeenCalledTimes(3);\n            });\n\n            test(\"forwards lookupTimeoutMs to every chunk lookup\", async () => {\n                const lookup = vi.fn(async (cid: string, _timeoutMs?: number) => {\n                    if (cid === manifestCid) return manifestBytes;\n                    if (cid === chunkACid) return chunkA;\n                    if (cid === chunkBCid) return chunkB;\n                    throw new Error(\"boom\");\n                });\n                const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n                await executeQuery(strategy, manifestCid, { lookupTimeoutMs: 7777 });\n                for (const call of lookup.mock.calls) {\n                    expect(call[1]).toBe(7777);\n                }\n            });\n\n            test(\"preserves chunk order from the manifest\", async () => {\n                const lookup = vi.fn(async (cid: string) => {\n                    if (cid === manifestCid) return manifestBytes;\n                    if (cid === chunkACid) return chunkA;\n                    if (cid === chunkBCid) return chunkB;\n                    throw new Error(\"boom\");\n                });\n                const strategy: QueryStrategy = { kind: \"host-lookup\", lookup };\n                const result = await executeQuery(strategy, manifestCid);\n                // Order matters: chunkA bytes must come before chunkB bytes\n                // even though both are fetched in parallel.\n                expect(Array.from(result.slice(0, 3))).toEqual([0xaa, 0xaa, 0xaa]);\n                expect(Array.from(result.slice(3))).toEqual([0xbb, 0xbb]);\n            });\n        });\n    });\n}\n","/**\n * Chain-storage verification for stored CIDs.\n *\n * The bulletin chain doesn't store content bytes on-chain — `TransactionStorage\n * .Transactions[block]` holds metadata only (`{ chunk_root, content_hash,\n * hashing, cid_codec, size, block_chunks }`), and the bytes themselves live\n * in IPFS. So \"read by CID from chain\" isn't possible. What *is* possible is\n * proving that a given CID was stored: parse the CID's digest + multihash\n * code, then look it up in `TransactionStorage.Transactions` and confirm a\n * matching `content_hash` + `hashing`.\n *\n * Common use case: just-after-upload UX — `await client.store(data).send()`\n * gives you back `{ cid, blockNumber, extrinsicIndex? }`, and a follow-up\n * `verifyOnChain(api, cid, { block: blockNumber })` confirms the metadata\n * landed where expected.\n */\nimport { CID } from \"multiformats/cid\";\n\nimport { HashAlgorithm } from \"./cid.js\";\nimport { BulletinCidError } from \"./errors.js\";\nimport type { BulletinApi } from \"./types.js\";\n\n/**\n * Match a multihash code in a CID against the chain's `hashing` enum value.\n */\nconst HASH_CODE_TO_ENUM_TYPE: Record<number, \"Blake2b256\" | \"Sha2_256\" | \"Keccak256\"> = {\n    [HashAlgorithm.Blake2b256]: \"Blake2b256\",\n    [HashAlgorithm.Sha2_256]: \"Sha2_256\",\n    [HashAlgorithm.Keccak256]: \"Keccak256\",\n};\n\n/** A single matched entry from `TransactionStorage.Transactions`. */\nexport interface ChainStoredEntry {\n    /** Block number where the transaction was included. */\n    block: number;\n    /** Index of the entry within the block's transactions array. */\n    index: number;\n    /** Size of the stored data in bytes (from chain metadata). */\n    size: number;\n    /** Number of chunks (1 for unchunked data, >1 for chunked + manifest). */\n    blockChunks: number;\n}\n\n/**\n * Verification options for {@link verifyOnChain}.\n */\nexport interface VerifyOnChainOptions {\n    /**\n     * Block number to look up. Pass the `blockNumber` returned from a prior\n     * `store(...).send()` for an O(1) lookup.\n     *\n     * If omitted, throws — full-chain scans are not supported because\n     * `RetentionPeriod` can be many days of blocks. Use `getEntries()` on\n     * `api.query.TransactionStorage.Transactions` directly if you need that.\n     */\n    block: number;\n    /**\n     * Optional: index within the block. When provided, narrows verification\n     * to that exact slot. Useful when re-checking a known `(block, index)`\n     * tuple from an earlier receipt.\n     */\n    index?: number;\n}\n\n/**\n * Verify that a CID is recorded in the bulletin chain's `Transactions`\n * storage at the given block.\n *\n * Returns the matched entry (with block + index) when the CID's content\n * hash and hashing algorithm both match a `Transactions[block]` entry.\n * Returns `null` when no match is found at that block.\n *\n * @param api     - Typed bulletin API.\n * @param cid     - CIDv1 string to look up.\n * @param options - Verification target (block number, optional index).\n *\n * @example\n * ```ts\n * const receipt = await client.store(data).send();\n * if (receipt.blockNumber !== undefined) {\n *   const entry = await verifyOnChain(client.api, receipt.cid!.toString(), {\n *     block: receipt.blockNumber,\n *     index: receipt.extrinsicIndex,\n *   });\n *   if (!entry) console.warn(\"CID not found in expected block — chain reorg?\");\n * }\n * ```\n */\nexport async function verifyOnChain(\n    api: BulletinApi,\n    cid: string,\n    options: VerifyOnChainOptions,\n): Promise<ChainStoredEntry | null> {\n    const parsed = parseCidForVerify(cid);\n\n    const queryFn = (api as unknown as TransactionsQueryApi).query?.TransactionStorage?.Transactions\n        ?.getValue;\n    if (!queryFn) {\n        throw new Error(\n            \"Bulletin API does not expose query.TransactionStorage.Transactions — \" +\n                \"the typed API may be incomplete or the runtime version doesn't match the descriptor.\",\n        );\n    }\n\n    const entries = await queryFn(options.block);\n    if (!entries || entries.length === 0) return null;\n\n    // When an explicit index is provided, check that slot directly — no\n    // reason to walk the full array just to skip everything else.\n    if (options.index !== undefined) {\n        const entry = entries[options.index];\n        if (entry && matchesEntry(entry, parsed)) {\n            return {\n                block: options.block,\n                index: options.index,\n                size: entry.size,\n                blockChunks: entry.block_chunks,\n            };\n        }\n        return null;\n    }\n\n    for (let i = 0; i < entries.length; i++) {\n        const entry = entries[i]!;\n        if (matchesEntry(entry, parsed)) {\n            return {\n                block: options.block,\n                index: i,\n                size: entry.size,\n                blockChunks: entry.block_chunks,\n            };\n        }\n    }\n\n    return null;\n}\n\ninterface ParsedCid {\n    digest: Uint8Array;\n    hashType: \"Blake2b256\" | \"Sha2_256\" | \"Keccak256\";\n}\n\n/**\n * Hand-rolled mirror of `TransactionStorage.Transactions[block][n]` — the\n * shape PAPI returns at runtime when you call `query.TransactionStorage\n * .Transactions.getValue(block)`. Defined here (rather than derived from\n * `BulletinTypedApi`) because the typed API surfaces these values through\n * `Anonymize<I…>` codec aliases that aren't ergonomic to inline.\n *\n * **If the bulletin runtime changes the entry shape, update this here too.**\n * Source of truth: `TransactionInfo` in\n * `packages/descriptors/chains/bulletin/generated/dist/common-types.d.ts`\n * (look for `chunk_root: FixedSizeBinary<32>` to anchor it). When the\n * descriptor regenerates and the fields shift, this interface, the\n * `cid_codec`/`hashing` matching in `matchesEntry`, and the\n * `HASH_CODE_TO_ENUM_TYPE` map above all need to be re-validated together.\n *\n * `Uint8Array | { asBytes(): Uint8Array }` covers both the raw and Binary-\n * wrapped shapes the codec can return depending on configuration.\n */\ninterface ChainEntry {\n    chunk_root: { asBytes(): Uint8Array } | Uint8Array;\n    content_hash: { asBytes(): Uint8Array } | Uint8Array;\n    hashing: { type: \"Blake2b256\" | \"Sha2_256\" | \"Keccak256\" };\n    cid_codec: bigint;\n    size: number;\n    block_chunks: number;\n}\n\ninterface TransactionsQueryApi {\n    query?: {\n        TransactionStorage?: {\n            Transactions?: {\n                getValue: (block: number) => Promise<ChainEntry[] | undefined>;\n            };\n        };\n    };\n}\n\nfunction parseCidForVerify(cid: string): ParsedCid {\n    let parsed;\n    try {\n        parsed = CID.parse(cid);\n    } catch {\n        throw new BulletinCidError(`Invalid CID: ${cid}`, cid);\n    }\n    if (parsed.version !== 1) {\n        throw new BulletinCidError(`Expected CIDv1, got CIDv${parsed.version}`, cid);\n    }\n    const hashType = HASH_CODE_TO_ENUM_TYPE[parsed.multihash.code];\n    if (!hashType) {\n        throw new BulletinCidError(\n            `Unsupported hash algorithm 0x${parsed.multihash.code.toString(16)}`,\n            cid,\n        );\n    }\n    return { digest: parsed.multihash.digest, hashType };\n}\n\nfunction matchesEntry(entry: ChainEntry, target: ParsedCid): boolean {\n    if (entry.hashing.type !== target.hashType) return false;\n    const onChainBytes =\n        entry.content_hash instanceof Uint8Array\n            ? entry.content_hash\n            : entry.content_hash.asBytes();\n    if (onChainBytes.length !== target.digest.length) return false;\n    for (let i = 0; i < onChainBytes.length; i++) {\n        if (onChainBytes[i] !== target.digest[i]) return false;\n    }\n    return true;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    function makeMockApi(getValue: (block: number) => Promise<ChainEntry[] | undefined>) {\n        return {\n            query: {\n                TransactionStorage: {\n                    Transactions: { getValue },\n                },\n            },\n        } as unknown as BulletinApi;\n    }\n\n    function makeEntry(\n        digest: Uint8Array,\n        hashType: \"Blake2b256\" | \"Sha2_256\" | \"Keccak256\" = \"Blake2b256\",\n        size = 100,\n        blockChunks = 1,\n    ): ChainEntry {\n        return {\n            chunk_root: digest,\n            content_hash: digest,\n            hashing: { type: hashType },\n            cid_codec: 0x55n,\n            size,\n            block_chunks: blockChunks,\n        };\n    }\n\n    // Build a real CIDv1 (blake2b-256, raw) we can verify against\n    async function makeCidWithDigest(digest: Uint8Array, hashCode = 0xb220): Promise<string> {\n        const Digest = await import(\"multiformats/hashes/digest\");\n        return CID.createV1(0x55, Digest.create(hashCode, digest)).toString();\n    }\n\n    describe(\"verifyOnChain\", () => {\n        test(\"returns entry when CID matches at given block\", async () => {\n            const digest = new Uint8Array(32).fill(0xab);\n            const cid = await makeCidWithDigest(digest);\n            const api = makeMockApi(vi.fn().mockResolvedValue([makeEntry(digest)]));\n\n            const result = await verifyOnChain(api, cid, { block: 100 });\n            expect(result).toEqual({ block: 100, index: 0, size: 100, blockChunks: 1 });\n        });\n\n        test(\"returns null when block has no entries\", async () => {\n            const digest = new Uint8Array(32).fill(0xab);\n            const cid = await makeCidWithDigest(digest);\n            const api = makeMockApi(vi.fn().mockResolvedValue(undefined));\n\n            const result = await verifyOnChain(api, cid, { block: 100 });\n            expect(result).toBeNull();\n        });\n\n        test(\"returns null when block has entries but none match\", async () => {\n            const targetDigest = new Uint8Array(32).fill(0xab);\n            const otherDigest = new Uint8Array(32).fill(0xcd);\n            const cid = await makeCidWithDigest(targetDigest);\n            const api = makeMockApi(vi.fn().mockResolvedValue([makeEntry(otherDigest)]));\n\n            const result = await verifyOnChain(api, cid, { block: 100 });\n            expect(result).toBeNull();\n        });\n\n        test(\"returns null when hashing algorithm differs\", async () => {\n            const digest = new Uint8Array(32).fill(0xab);\n            // CID uses blake2b-256, chain entry says sha2-256 with same digest bytes\n            const cid = await makeCidWithDigest(digest, 0xb220);\n            const api = makeMockApi(vi.fn().mockResolvedValue([makeEntry(digest, \"Sha2_256\")]));\n\n            const result = await verifyOnChain(api, cid, { block: 100 });\n            expect(result).toBeNull();\n        });\n\n        test(\"finds match at correct index when multiple entries exist\", async () => {\n            const targetDigest = new Uint8Array(32).fill(0xab);\n            const filler = new Uint8Array(32).fill(0xcd);\n            const cid = await makeCidWithDigest(targetDigest);\n            const api = makeMockApi(\n                vi\n                    .fn()\n                    .mockResolvedValue([\n                        makeEntry(filler),\n                        makeEntry(filler),\n                        makeEntry(targetDigest),\n                    ]),\n            );\n\n            const result = await verifyOnChain(api, cid, { block: 100 });\n            expect(result?.index).toBe(2);\n        });\n\n        test(\"respects explicit index option\", async () => {\n            const targetDigest = new Uint8Array(32).fill(0xab);\n            const filler = new Uint8Array(32).fill(0xcd);\n            const cid = await makeCidWithDigest(targetDigest);\n            // Target is at index 2, but caller says index 0 — should not match\n            const api = makeMockApi(\n                vi\n                    .fn()\n                    .mockResolvedValue([\n                        makeEntry(filler),\n                        makeEntry(filler),\n                        makeEntry(targetDigest),\n                    ]),\n            );\n\n            const result = await verifyOnChain(api, cid, { block: 100, index: 0 });\n            expect(result).toBeNull();\n        });\n\n        test(\"returns the entry when explicit index matches\", async () => {\n            const targetDigest = new Uint8Array(32).fill(0xab);\n            const filler = new Uint8Array(32).fill(0xcd);\n            const cid = await makeCidWithDigest(targetDigest);\n            const api = makeMockApi(\n                vi\n                    .fn()\n                    .mockResolvedValue([\n                        makeEntry(filler),\n                        makeEntry(filler),\n                        makeEntry(targetDigest),\n                    ]),\n            );\n\n            const result = await verifyOnChain(api, cid, { block: 100, index: 2 });\n            expect(result?.index).toBe(2);\n        });\n\n        test(\"throws BulletinCidError on invalid CID\", async () => {\n            const api = makeMockApi(vi.fn());\n            await expect(verifyOnChain(api, \"not-a-cid\", { block: 1 })).rejects.toThrow(\n                BulletinCidError,\n            );\n        });\n\n        test(\"throws when api lacks the expected query path\", async () => {\n            const api = {} as BulletinApi;\n            const digest = new Uint8Array(32).fill(0xab);\n            const cid = await makeCidWithDigest(digest);\n            await expect(verifyOnChain(api, cid, { block: 1 })).rejects.toThrow(\n                /does not expose query/,\n            );\n        });\n\n        test(\"handles content_hash as a Binary-like wrapper\", async () => {\n            const digest = new Uint8Array(32).fill(0xab);\n            const cid = await makeCidWithDigest(digest);\n            const wrapper = { asBytes: () => digest };\n            const entry: ChainEntry = {\n                chunk_root: wrapper,\n                content_hash: wrapper,\n                hashing: { type: \"Blake2b256\" },\n                cid_codec: 0x55n,\n                size: 50,\n                block_chunks: 1,\n            };\n            const api = makeMockApi(vi.fn().mockResolvedValue([entry]));\n            const result = await verifyOnChain(api, cid, { block: 1 });\n            expect(result).toEqual({ block: 1, index: 0, size: 50, blockChunks: 1 });\n        });\n\n        test(\"passes the block number to the storage call\", async () => {\n            const digest = new Uint8Array(32).fill(0xab);\n            const cid = await makeCidWithDigest(digest);\n            const getValue = vi.fn().mockResolvedValue([makeEntry(digest)]);\n            const api = makeMockApi(getValue);\n            await verifyOnChain(api, cid, { block: 42 });\n            expect(getValue).toHaveBeenCalledWith(42);\n        });\n    });\n}\n","import {\n    AsyncBulletinClient,\n    type AuthCallBuilder,\n    type BulletinTypedApi,\n    type CallBuilder,\n    type ClientConfig,\n    type StoreBuilder,\n    type SubmitFn,\n} from \"@parity/bulletin-sdk\";\nimport { createChainClient, getChainAPI } from \"@parity/product-sdk-chain-client\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport type { PolkadotClient, PolkadotSigner } from \"polkadot-api\";\n\nimport { checkAuthorization } from \"./authorization.js\";\nimport type { BulletinChain, BulletinEnvironment } from \"./networks.js\";\nimport { executeQuery } from \"./query.js\";\nimport { resolveQueryStrategy, type QueryStrategy } from \"./resolve-query.js\";\nimport type { AuthorizationStatus, BulletinApi, QueryOptions } from \"./types.js\";\nimport { verifyOnChain, type ChainStoredEntry, type VerifyOnChainOptions } from \"./verify.js\";\n\nconst log = createLogger(\"bulletin\");\n\n/**\n * Options for {@link BulletinClient.create}.\n *\n * One of two construction shapes is supported:\n *\n * - **Environment shorthand** — pass an `environment` string keyed by\n *   {@link BulletinChain}. Wires up the chain-client automatically.\n * - **Explicit network** — pass `genesisHash` and `descriptor` directly\n *   (e.g., spread from a {@link BulletinChain} entry, or supply custom\n *   values for a private chain).\n */\nexport type CreateBulletinClientOptions =\n    | (CreateBulletinClientCommon & { environment: BulletinEnvironment })\n    | (CreateBulletinClientCommon & {\n          genesisHash: `0x${string}`;\n          descriptor: (typeof BulletinChain)[BulletinEnvironment][\"descriptor\"];\n      });\n\ninterface CreateBulletinClientCommon {\n    /** Signer for transaction submission. Required — every store needs a signer. */\n    signer: PolkadotSigner;\n    /** Optional config forwarded to {@link AsyncBulletinClient}. */\n    config?: Partial<ClientConfig>;\n}\n\n/**\n * Ergonomic entry point for Bulletin Chain operations.\n *\n * Wraps {@link AsyncBulletinClient} from `@parity/bulletin-sdk` (which handles\n * chunking, DAG-PB manifests, CID calculation, and progress events) and adds:\n *\n * - **Network presets** via {@link BulletinClient.create} and {@link BulletinChain}.\n * - **Read helpers** ({@link fetchBytes}, {@link fetchJson}) routed through\n *   the host's preimage subscription — upstream is upload-only and the SDK\n *   is container-only by design (no public-gateway fetches).\n * - **Pre-flight authorization check** ({@link checkAuthorization}) for\n *   friendlier UX before submitting a store.\n *\n * For uploads, mirror upstream's fluent builders:\n *\n * ```ts\n * const client = await BulletinClient.create({ environment: \"paseo\", signer });\n * const result = await client.store(data).send();\n * ```\n *\n * For chunked uploads with progress:\n *\n * ```ts\n * const result = await client\n *   .store(largeFile)\n *   .withChunkSize(1 << 20)\n *   .withCallback((evt) => console.log(evt))\n *   .send();\n * ```\n */\nexport class BulletinClient {\n    /** Underlying upstream client — exposed for power users. */\n    readonly inner: AsyncBulletinClient;\n    /** Typed Bulletin Chain API. */\n    readonly api: BulletinApi;\n\n    /** Lazy-resolved host-preimage query strategy, cached for the client lifetime. */\n    private queryStrategyPromise: Promise<QueryStrategy> | null = null;\n\n    /** Constructed via {@link create} or {@link from}. */\n    private constructor(inner: AsyncBulletinClient, api: BulletinApi) {\n        this.inner = inner;\n        this.api = api;\n    }\n\n    /** Resolve and cache the host query strategy on first use. */\n    private resolveQuery(): Promise<QueryStrategy> {\n        if (!this.queryStrategyPromise) {\n            this.queryStrategyPromise = resolveQueryStrategy();\n        }\n        return this.queryStrategyPromise;\n    }\n\n    /**\n     * Create a client from an environment shorthand or an explicit network.\n     *\n     * Environment form uses our `getChainAPI(env)` to resolve the typed API.\n     * Explicit form skips the environment lookup and lets you pass any\n     * genesis/descriptor combo.\n     *\n     * @example\n     * ```ts\n     * // Shorthand\n     * const client = await BulletinClient.create({ environment: \"paseo\", signer });\n     *\n     * // Explicit (custom network)\n     * const client = await BulletinClient.create({\n     *   ...BulletinChain.paseo,\n     *   signer,\n     *   config: { defaultChunkSize: 1 << 20 },\n     * });\n     * ```\n     */\n    static async create(options: CreateBulletinClientOptions): Promise<BulletinClient> {\n        if (\"environment\" in options) {\n            const chain = await getChainAPI(options.environment);\n            const inner = new AsyncBulletinClient(\n                chain.bulletin as BulletinTypedApi,\n                options.signer,\n                chain.raw.bulletin.submit as SubmitFn,\n                options.config,\n                () => chain.destroy(),\n            );\n            log.info(\"BulletinClient created (environment shorthand)\", {\n                environment: options.environment,\n            });\n            return new BulletinClient(inner, chain.bulletin);\n        }\n\n        // Explicit form — caller owns the descriptor choice. We still need a\n        // PolkadotClient to feed AsyncBulletinClient. Going through\n        // chain-client keeps connection management consistent across the SDK.\n        const { genesisHash, descriptor, signer, config } = options;\n        // Catch the obvious foot-gun where caller mixes a genesis from one\n        // network with a descriptor from another — the connection would\n        // succeed but typed calls would silently target the wrong chain.\n        // The descriptor's own `.genesis` field is the on-chain truth; the\n        // user-supplied `genesisHash` is informational today (createChainClient\n        // doesn't use it because host routes connections) but kept on the\n        // option shape for future RPC-direct paths.\n        if (descriptor.genesis && genesisHash.toLowerCase() !== descriptor.genesis.toLowerCase()) {\n            throw new Error(\n                `BulletinClient.create: genesisHash (${genesisHash}) does not match descriptor.genesis (${descriptor.genesis}). These must refer to the same network — check that you're pairing the right descriptor with the right genesis hash.`,\n            );\n        }\n        const chain = await createChainClient({\n            chains: { bulletin: descriptor },\n            rpcs: { bulletin: [] },\n        });\n        const inner = new AsyncBulletinClient(\n            chain.bulletin as BulletinTypedApi,\n            signer,\n            chain.raw.bulletin.submit as SubmitFn,\n            config,\n            () => chain.destroy(),\n        );\n        log.info(\"BulletinClient created (explicit network)\");\n        return new BulletinClient(inner, chain.bulletin);\n    }\n\n    /**\n     * Construct from a pre-built `AsyncBulletinClient` and PAPI typed API.\n     *\n     * Use this when you already own the connection lifecycle (BYOD setups,\n     * tests). The caller is responsible for calling `papiClient.destroy()`\n     * — this client's {@link destroy} only tears down the upstream's\n     * `onDestroy` hook.\n     */\n    static from(inner: AsyncBulletinClient, api: BulletinApi): BulletinClient {\n        return new BulletinClient(inner, api);\n    }\n\n    // ─── Upload + authorization (forwarded to upstream) ────────────────\n\n    /** Build a store transaction. See upstream `StoreBuilder` for chained options. */\n    store(data: Uint8Array): StoreBuilder {\n        return this.inner.store(data);\n    }\n\n    /** Authorize an account to store data on the chain (sudo required on most networks). */\n    authorizeAccount(who: string, transactions: number, bytes: bigint): AuthCallBuilder {\n        return this.inner.authorizeAccount(who, transactions, bytes);\n    }\n\n    /** Authorize content storage by hash (anyone can store; no fees). */\n    authorizePreimage(contentHash: Uint8Array, maxSize: bigint): AuthCallBuilder {\n        return this.inner.authorizePreimage(contentHash, maxSize);\n    }\n\n    /** Renew a stored transaction by block + index. */\n    renew(block: number, index: number): CallBuilder {\n        return this.inner.renew(block, index);\n    }\n\n    /** Estimate the authorization (transactions + bytes) needed for `dataSize`. */\n    estimateAuthorization(dataSize: number): { transactions: number; bytes: number } {\n        return this.inner.estimateAuthorization(dataSize);\n    }\n\n    // ─── Read side (our own helpers) ───────────────────────────────────\n\n    /**\n     * Fetch raw bytes for a CID via the host's preimage lookup.\n     *\n     * Container-only — outside a Polkadot Browser / Desktop host this\n     * throws {@link BulletinHostUnavailableError}. The chain stores\n     * content metadata (`content_hash`, size, codec) but the bytes\n     * themselves are surfaced through the host's preimage subscription.\n     *\n     * Use {@link verifyOnChain} if you only need to confirm a CID was\n     * recorded on-chain (no byte fetch).\n     */\n    async fetchBytes(cid: string, options?: QueryOptions): Promise<Uint8Array> {\n        const strategy = await this.resolveQuery();\n        return executeQuery(strategy, cid, options);\n    }\n\n    /** Fetch and parse JSON for a CID. */\n    async fetchJson<T>(cid: string, options?: QueryOptions): Promise<T> {\n        const bytes = await this.fetchBytes(cid, options);\n        return JSON.parse(new TextDecoder().decode(bytes)) as T;\n    }\n\n    /** Pre-flight: check whether `address` can store on the bulletin chain. */\n    async checkAuthorization(address: string): Promise<AuthorizationStatus> {\n        return checkAuthorization(this.api, address);\n    }\n\n    /**\n     * Verify that a CID was recorded on-chain at the given block.\n     *\n     * Common pattern: pass `blockNumber` (and optionally `extrinsicIndex`)\n     * from a `store(...).send()` receipt to confirm the upload landed.\n     * See {@link verifyOnChain} for details.\n     */\n    async verifyOnChain(\n        cid: string,\n        options: VerifyOnChainOptions,\n    ): Promise<ChainStoredEntry | null> {\n        return verifyOnChain(this.api, cid, options);\n    }\n\n    /** Tear down the underlying connection. */\n    async destroy(): Promise<void> {\n        await this.inner.destroy();\n    }\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    describe(\"BulletinClient.from\", () => {\n        test(\"constructs with given inner and api\", () => {\n            const inner = {\n                destroy: vi.fn().mockResolvedValue(undefined),\n            } as unknown as AsyncBulletinClient;\n            const api = {} as BulletinApi;\n            const client = BulletinClient.from(inner, api);\n            expect(client.inner).toBe(inner);\n            expect(client.api).toBe(api);\n        });\n\n        test(\"destroy delegates to upstream\", async () => {\n            const destroy = vi.fn().mockResolvedValue(undefined);\n            const inner = { destroy } as unknown as AsyncBulletinClient;\n            const client = BulletinClient.from(inner, {} as BulletinApi);\n            await client.destroy();\n            expect(destroy).toHaveBeenCalledOnce();\n        });\n\n        test(\"store delegates to inner\", () => {\n            const builder = {} as StoreBuilder;\n            const inner = {\n                store: vi.fn().mockReturnValue(builder),\n            } as unknown as AsyncBulletinClient;\n            const client = BulletinClient.from(inner, {} as BulletinApi);\n            const data = new Uint8Array([1, 2, 3]);\n            expect(client.store(data)).toBe(builder);\n            expect(inner.store).toHaveBeenCalledWith(data);\n        });\n    });\n\n    describe(\"BulletinClient.create (BYOD genesis assertion)\", () => {\n        // Stand-in descriptor with a known genesis. The full PAPI descriptor\n        // type is a `ChainDefinition` with a deep type-level shape; the cast\n        // below is fine for the assertion test because we never actually\n        // reach createChainClient.\n        const stubDescriptor = (\n            genesis: `0x${string}`,\n        ): (typeof BulletinChain)[BulletinEnvironment][\"descriptor\"] =>\n            ({ genesis }) as unknown as (typeof BulletinChain)[BulletinEnvironment][\"descriptor\"];\n\n        const realPaseo =\n            \"0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea\" as `0x${string}`;\n\n        test(\"throws when genesisHash and descriptor.genesis disagree\", async () => {\n            await expect(\n                BulletinClient.create({\n                    genesisHash:\n                        \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n                    descriptor: stubDescriptor(realPaseo),\n                    signer: {} as PolkadotSigner,\n                }),\n            ).rejects.toThrow(/does not match descriptor\\.genesis/i);\n        });\n    });\n}\n","/**\n * Known Bulletin Chain networks.\n *\n * Pairs each environment with the genesis hash and the PAPI descriptor needed\n * to construct an `AsyncBulletinClient`. Re-uses the descriptor exported by\n * `@parity/product-sdk-descriptors/bulletin` — the bulletin descriptor is the\n * same across all environments today, so the difference between entries is\n * the genesis hash (and, downstream, the chain RPC URL).\n */\nimport { bulletin as bulletinDescriptor } from \"@parity/product-sdk-descriptors/bulletin\";\n\nexport interface BulletinNetwork {\n    /** Genesis hash of the bulletin chain on this environment. */\n    genesisHash: `0x${string}`;\n    /** PAPI descriptor for typed API access. */\n    descriptor: typeof bulletinDescriptor;\n}\n\n/**\n * Bulletin Chain network presets.\n *\n * Use these with {@link BulletinClient.create} when you want to be explicit\n * about the network rather than passing an environment string. Reads go\n * through the host's preimage subscription (container-only); no gateway\n * URL is configured per network.\n */\nexport const BulletinChain = {\n    paseo: {\n        genesisHash: \"0x744960c32e3a3df5440e1ecd4d34096f1ce2230d7016a5ada8a765d5a622b4ea\",\n        descriptor: bulletinDescriptor,\n    },\n} as const satisfies Record<string, BulletinNetwork>;\n\n/** Network keys with built-in presets in {@link BulletinChain}. */\nexport type BulletinEnvironment = keyof typeof BulletinChain;\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    describe(\"BulletinChain\", () => {\n        test(\"paseo has a valid genesis hash\", () => {\n            expect(BulletinChain.paseo.genesisHash).toMatch(/^0x[a-f0-9]{64}$/);\n        });\n\n        test(\"paseo descriptor has matching genesis\", () => {\n            expect(BulletinChain.paseo.descriptor.genesis).toBe(BulletinChain.paseo.genesisHash);\n        });\n    });\n}\n","import type { PolkadotSigner } from \"polkadot-api\";\n\n/**\n * Build a `PolkadotSigner` whose underlying signer is resolved on every call.\n *\n * `AsyncBulletinClient` takes a fixed `PolkadotSigner` at construction, but\n * apps often build the bulletin client before any account is selected. This\n * wrapper defers signer resolution: each call to `signTx` / `signBytes`\n * invokes `getSigner()` and forwards to the result. If the getter returns\n * `null`, calls throw with a clear message.\n *\n * The `publicKey` field is *also* resolved lazily — accessing it before a\n * signer is available throws. This means callers that read `publicKey`\n * eagerly will fail fast with the same error rather than seeing a stale\n * key from a previously-selected account.\n *\n * Account changes between calls are picked up automatically: each sign\n * resolves the current signer.\n */\nexport function createLazySigner(\n    getSigner: () => PolkadotSigner | null,\n    onMissing = \"No signer available — connect a wallet and select an account first.\",\n): PolkadotSigner {\n    const resolve = (): PolkadotSigner => {\n        const inner = getSigner();\n        if (!inner) throw new Error(onMissing);\n        return inner;\n    };\n\n    // `async` on the methods is deliberate: it converts a \"no signer\" throw\n    // from `resolve()` into a rejected Promise. PolkadotSigner.signTx /\n    // signBytes are typed as returning Promises, and consumers expect a\n    // rejection rather than a synchronous escape on the failure path.\n    const lazy: PolkadotSigner = {\n        get publicKey() {\n            return resolve().publicKey;\n        },\n        signTx: async (...args: Parameters<PolkadotSigner[\"signTx\"]>) => resolve().signTx(...args),\n        signBytes: async (...args: Parameters<PolkadotSigner[\"signBytes\"]>) =>\n            resolve().signBytes(...args),\n    };\n    return lazy;\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, vi } = import.meta.vitest;\n\n    function makeMockSigner(label: string): PolkadotSigner {\n        return {\n            publicKey: new TextEncoder().encode(label),\n            signTx: vi.fn().mockResolvedValue(new Uint8Array([1])),\n            signBytes: vi.fn().mockResolvedValue(new Uint8Array([2])),\n        };\n    }\n\n    describe(\"createLazySigner\", () => {\n        test(\"publicKey throws when getter returns null\", () => {\n            const lazy = createLazySigner(() => null);\n            expect(() => lazy.publicKey).toThrow(\"No signer available\");\n        });\n\n        test(\"publicKey resolves through getter when signer is available\", () => {\n            const inner = makeMockSigner(\"alice\");\n            const lazy = createLazySigner(() => inner);\n            expect(lazy.publicKey).toBe(inner.publicKey);\n        });\n\n        test(\"signTx throws when getter returns null\", async () => {\n            const lazy = createLazySigner(() => null);\n            await expect(lazy.signTx(new Uint8Array(), {}, new Uint8Array(), 0)).rejects.toThrow(\n                \"No signer available\",\n            );\n        });\n\n        test(\"signTx forwards to current signer\", async () => {\n            const inner = makeMockSigner(\"alice\");\n            const lazy = createLazySigner(() => inner);\n            const callData = new Uint8Array([0xaa, 0xbb]);\n            const signedExtensions = {};\n            const metadata = new Uint8Array([0xcc]);\n            const atBlock = 42;\n            const result = await lazy.signTx(callData, signedExtensions, metadata, atBlock);\n            expect(inner.signTx).toHaveBeenCalledWith(\n                callData,\n                signedExtensions,\n                metadata,\n                atBlock,\n            );\n            expect(result).toEqual(new Uint8Array([1]));\n        });\n\n        test(\"signBytes forwards to current signer\", async () => {\n            const inner = makeMockSigner(\"bob\");\n            const lazy = createLazySigner(() => inner);\n            const result = await lazy.signBytes(new Uint8Array([9]));\n            expect(inner.signBytes).toHaveBeenCalledWith(new Uint8Array([9]));\n            expect(result).toEqual(new Uint8Array([2]));\n        });\n\n        test(\"picks up account changes between calls\", () => {\n            let active: PolkadotSigner | null = makeMockSigner(\"first\");\n            const lazy = createLazySigner(() => active);\n            expect(lazy.publicKey).toEqual(new TextEncoder().encode(\"first\"));\n            active = makeMockSigner(\"second\");\n            expect(lazy.publicKey).toEqual(new TextEncoder().encode(\"second\"));\n        });\n\n        test(\"custom error message\", () => {\n            const lazy = createLazySigner(() => null, \"select an account first\");\n            expect(() => lazy.publicKey).toThrow(\"select an account first\");\n        });\n    });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk-bulletin",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript SDK for uploading and retrieving data on the Polkadot Bulletin Chain",
   "type": "module",
   "sideEffects": false,
@@ -18,13 +18,14 @@
     "src"
   ],
   "dependencies": {
+    "@parity/bulletin-sdk": "^0.3.0",
     "multiformats": "^13.3.0",
-    "polkadot-api": "^1.9.0",
-    "@parity/product-sdk-chain-client": "0.1.0",
-    "@parity/product-sdk-crypto": "0.1.0",
-    "@parity/product-sdk-host": "0.1.0",
-    "@parity/product-sdk-logger": "0.1.0",
-    "@parity/product-sdk-tx": "0.1.0"
+    "polkadot-api": "^2.1.2",
+    "@parity/product-sdk-chain-client": "0.2.0",
+    "@parity/product-sdk-descriptors": "0.2.0",
+    "@parity/product-sdk-host": "0.2.0",
+    "@parity/product-sdk-logger": "0.1.1",
+    "@parity/product-sdk-tx": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0",