@arcadiasystems/morse-sdk 0.1.0

package/dist/walrus/default-read-adapter.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Read-side counterpart to `DefaultWalrusWriteAdapter`. Wraps
+ * `@mysten/walrus`'s read APIs (`readBlob`, `getBlobObject`, `getFiles`)
+ * behind an interface symmetric to the write adapter.
+ *
+ * Without this, browser dapps that need to fetch raw blob bytes (most
+ * commonly: encrypted-entry decryption flows that read ciphertext from
+ * Walrus before passing it to `seal.decrypt`) end up instantiating
+ * `WalrusClient` directly, defeating the adapter pattern.
+ */
+import { type WalrusClientConfig, type WalrusFile } from "@mysten/walrus";
+import type { BlobObjectId, BlobRef, QuiltPatchId, WalrusBlobId } from "../types.js";
+/** Optional knobs threaded through every read. */
+export interface WalrusReadOptions {
+    readonly signal?: AbortSignal;
+}
+/** Read-only Walrus client, symmetric to `WalrusWriteAdapter`. */
+export interface WalrusReadAdapter {
+    /**
+     * Read by Walrus content-addressed blob id (the 43-char URL-safe-base64
+     * identifier returned by `uploadBlob` / `uploadQuilt`). Cheapest path
+     * when you already have the content id from an upload result.
+     */
+    readBlob(blobId: WalrusBlobId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    /**
+     * Read by Sui object id of the on-chain `Blob` object. Resolves the
+     * object to its `blob_id` first, then reads. Use this when you have
+     * `Revision.blobRef.blobObjectId` from `reader.getEntry(...)` and need
+     * the bytes back (e.g. for decryption).
+     *
+     * `options.signal` cancels the underlying blob fetch but not the
+     * preceding `getBlobObject` resolution; @mysten/walrus does not accept
+     * a signal on the resolution call. Cancelling between resolve and read
+     * lets the bytes-fetch abort.
+     */
+    readBlobByObjectId(blobObjectId: BlobObjectId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    /**
+     * Read a single quilt patch by its 37-byte branded id. Use this when
+     * `BlobRef.kind === "quilt"`.
+     *
+     * `options.signal` is accepted for API symmetry with the other reads
+     * but is not forwarded: @mysten/walrus's `getFiles` and the resulting
+     * `WalrusFile.bytes()` do not accept signals at this version. Long-
+     * running quilt-patch fetches cannot currently be cancelled.
+     */
+    readQuiltPatch(patchId: QuiltPatchId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    /**
+     * Convenience: dispatch on the `BlobRef` discriminant and read the
+     * corresponding payload. Lets consumers do
+     * `await reader.readBlobRef(revision.blobRef)` without switching on
+     * `kind` themselves.
+     */
+    readBlobRef(blobRef: BlobRef, options?: WalrusReadOptions): Promise<Uint8Array>;
+}
+/** Narrow structural slice of `WalrusClient` actually used by the read adapter. */
+interface WalrusReadClient {
+    readBlob(args: {
+        blobId: string;
+        signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+    getBlobObject(blobObjectId: string): Promise<{
+        id: string;
+        blob_id: string;
+    }>;
+    getFiles(args: {
+        ids: string[];
+    }): Promise<WalrusFile[]>;
+}
+interface DefaultWalrusReadAdapterOptions {
+    readonly client: WalrusReadClient;
+}
+/** Convenience options for `DefaultWalrusReadAdapter.fromConfig`. */
+export type WalrusReadAdapterConfig = WalrusClientConfig;
+/** `WalrusReadAdapter` backed by `@mysten/walrus`'s `WalrusClient`. */
+export declare class DefaultWalrusReadAdapter implements WalrusReadAdapter {
+    private readonly client;
+    constructor(options: DefaultWalrusReadAdapterOptions);
+    /**
+     * Build an adapter from a `WalrusClientConfig`. Equivalent to
+     * constructing the `WalrusClient` yourself and passing it in.
+     */
+    static fromConfig(config: WalrusReadAdapterConfig): DefaultWalrusReadAdapter;
+    readBlob(blobId: WalrusBlobId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    readBlobByObjectId(blobObjectId: BlobObjectId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    readQuiltPatch(patchId: QuiltPatchId, _options?: WalrusReadOptions): Promise<Uint8Array>;
+    readBlobRef(blobRef: BlobRef, options?: WalrusReadOptions): Promise<Uint8Array>;
+}
+export {};
+//# sourceMappingURL=default-read-adapter.d.ts.map

package/dist/walrus/default-read-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-read-adapter.d.ts","sourceRoot":"","sources":["../../src/walrus/default-read-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGN,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAEf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EACX,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,MAAM,aAAa,CAAC;AAGrB,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IACjC;;;;OAIG;IACH,QAAQ,CACP,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,kBAAkB,CACjB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;OAQG;IACH,cAAc,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,WAAW,CACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAAC;CACvB;AAED,mFAAmF;AACnF,UAAU,gBAAgB;IACzB,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9E,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5C,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,QAAQ,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACzD;AAED,UAAU,+BAA+B;IACxC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CAClC;AAED,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD,uEAAuE;AACvE,qBAAa,wBAAyB,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,OAAO,EAAE,+BAA+B;IAIpD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,uBAAuB,GAAG,wBAAwB;IAMtE,QAAQ,CACb,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAShB,kBAAkB,CACvB,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAYhB,cAAc,CACnB,OAAO,EAAE,YAAY,EACrB,QAAQ,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC;IAchB,WAAW,CAChB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;CAMtB"}

package/dist/walrus/default-read-adapter.js

@@ -0,0 +1,81 @@
+/**
+ * Read-side counterpart to `DefaultWalrusWriteAdapter`. Wraps
+ * `@mysten/walrus`'s read APIs (`readBlob`, `getBlobObject`, `getFiles`)
+ * behind an interface symmetric to the write adapter.
+ *
+ * Without this, browser dapps that need to fetch raw blob bytes (most
+ * commonly: encrypted-entry decryption flows that read ciphertext from
+ * Walrus before passing it to `seal.decrypt`) end up instantiating
+ * `WalrusClient` directly, defeating the adapter pattern.
+ */
+import { NoBlobMetadataReceivedError, WalrusClient, NotFoundError as WalrusNotFoundError, } from "@mysten/walrus";
+import { NotFoundError, TransportError } from "../errors.js";
+import { quiltPatchIdToString } from "./quilt-patch-id.js";
+/** `WalrusReadAdapter` backed by `@mysten/walrus`'s `WalrusClient`. */
+export class DefaultWalrusReadAdapter {
+    client;
+    constructor(options) {
+        this.client = options.client;
+    }
+    /**
+     * Build an adapter from a `WalrusClientConfig`. Equivalent to
+     * constructing the `WalrusClient` yourself and passing it in.
+     */
+    static fromConfig(config) {
+        return new DefaultWalrusReadAdapter({
+            client: new WalrusClient(config),
+        });
+    }
+    async readBlob(blobId, options = {}) {
+        return runWalrusCall(() => this.client.readBlob({
+            blobId,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        }));
+    }
+    async readBlobByObjectId(blobObjectId, options = {}) {
+        const blob = await runWalrusCall(() => this.client.getBlobObject(blobObjectId));
+        return runWalrusCall(() => this.client.readBlob({
+            blobId: blob.blob_id,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        }));
+    }
+    async readQuiltPatch(patchId, _options = {}) {
+        const id = quiltPatchIdToString(patchId);
+        const files = await runWalrusCall(() => this.client.getFiles({ ids: [id] }));
+        const file = files[0];
+        if (!file) {
+            throw new TransportError(`Walrus getFiles returned no entry for quilt patch ${id}`);
+        }
+        return runWalrusCall(() => file.bytes());
+    }
+    async readBlobRef(blobRef, options = {}) {
+        if (blobRef.kind === "blob") {
+            return this.readBlobByObjectId(blobRef.blobObjectId, options);
+        }
+        return this.readQuiltPatch(blobRef.patchId, options);
+    }
+}
+async function runWalrusCall(call) {
+    try {
+        return await call();
+    }
+    catch (cause) {
+        if (cause instanceof TransportError || cause instanceof NotFoundError) {
+            throw cause;
+        }
+        if (cause instanceof WalrusNotFoundError ||
+            cause instanceof NoBlobMetadataReceivedError) {
+            throw new NotFoundError("blob", `Walrus blob: ${cause.message}`, {
+                cause,
+            });
+        }
+        throw new TransportError(walrusErrorMessage(cause), { cause });
+    }
+}
+function walrusErrorMessage(cause) {
+    if (cause instanceof Error) {
+        return `Walrus read failed: ${cause.message}`;
+    }
+    return "Walrus read failed";
+}
+//# sourceMappingURL=default-read-adapter.js.map

package/dist/walrus/default-read-adapter.js.map

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

package/dist/walrus/http-aggregator-read-adapter.d.ts

@@ -0,0 +1,107 @@
+/**
+ * `WalrusReadAdapter` that fetches blob bytes from a Walrus aggregator HTTP
+ * service instead of fanning out to ~30 storage nodes via `WalrusClient`.
+ *
+ * Why this exists: browser reads through `DefaultWalrusReadAdapter` hit the
+ * direct-protocol path, which fans out to every storage node in the
+ * committee. On testnet a subset of those nodes do not ship CORS headers,
+ * so browser fetches frequently fail with `NoBlobMetadataReceivedError`
+ * even when the blob is healthy. CLI smokes against the same blob succeed
+ * because the CLI does not enforce CORS. The aggregator HTTP service is a
+ * Walrus-operator-run wrapper that internally does the shard math and
+ * exposes a single CORS-friendly endpoint.
+ *
+ * Trust model: the aggregator returns whatever bytes it serves. The
+ * trustless guarantee of fanout-and-reconstruct is replaced with trust in
+ * the operator. Most consumers running a known Mysten / Nami / community
+ * aggregator are fine with this; consumers who need stronger guarantees
+ * should keep `DefaultWalrusReadAdapter`. A future `verifyContentHash`
+ * option is planned for v0.2.0 to recompute the blobId from returned bytes
+ * and assert it matches.
+ *
+ * On-chain Sui object lookups (resolving `blobObjectId` to its `blob_id`)
+ * still go through the supplied `ObjectReader` (gRPC). The HTTP path only
+ * substitutes the bytes-fetch step.
+ */
+import type { ObjectReader } from "../clients.js";
+import type { NetworkConfig } from "../config.js";
+import type { BlobObjectId, BlobRef, QuiltPatchId, WalrusBlobId } from "../types.js";
+import type { WalrusReadAdapter, WalrusReadOptions } from "./default-read-adapter.js";
+/** Minimal `fetch` shape the adapter calls; `globalThis.fetch` satisfies it. */
+type FetchLike = (input: string, init?: {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+/**
+ * Optional integrity check on blob bytes received from the aggregator. The
+ * callback is invoked with the bytes and the expected `blobId` after every
+ * successful blob fetch (`readBlob` and `readBlobByObjectId`). It must
+ * throw on a mismatch; the adapter rewraps the throw as a `TransportError`
+ * so consumers narrow on the SDK's error taxonomy.
+ *
+ * Why a callback: Walrus's `blobId` is derived from the encoded blob (Reed-
+ * Solomon slivers, root hash), not a simple `blake2b256(bytes)`. Computing
+ * the canonical blobId from raw bytes requires `WalrusClient.computeBlobMetadata`
+ * with the committee's `numShards`. The SDK keeps this as a callback rather
+ * than a built-in option to avoid coupling the lightweight HTTP adapter to
+ * a `WalrusClient` instance and its `numShards` lookup.
+ *
+ * Quilt patches are not verified: `readQuiltPatch` returns a sub-range of
+ * a parent blob, and per-patch hashes are not part of the canonical
+ * patch-id derivation at this version of Walrus.
+ */
+export type WalrusBlobIntegrityCheck = (bytes: Uint8Array, expectedBlobId: WalrusBlobId) => Promise<void>;
+/** Construction options for `HttpAggregatorReadAdapter`. */
+export interface HttpAggregatorReadAdapterOptions {
+    /** Aggregator base URL, e.g. `"https://aggregator.walrus-testnet.walrus.space"`. No trailing slash. */
+    readonly aggregatorUrl: string;
+    /** Sui RPC client used to resolve `blobObjectId` to `blob_id` for `readBlobByObjectId`. */
+    readonly suiClient: ObjectReader;
+    /** Optional per-request HTTP headers (auth tokens, custom origin labels). */
+    readonly headers?: HeadersInit;
+    /** Override `fetch` for testing; defaults to `globalThis.fetch`. */
+    readonly fetch?: FetchLike;
+    /**
+     * Optional trust-but-verify callback. When supplied, blob fetches verify
+     * the returned bytes match the expected `blobId` before resolving. Wire
+     * this to `WalrusClient.computeBlobMetadata({ bytes, numShards }).blobId`
+     * if you want the canonical Walrus derivation; or implement a custom
+     * application-level check.
+     */
+    readonly verifyBlobIntegrity?: WalrusBlobIntegrityCheck;
+}
+/**
+ * `WalrusReadAdapter` backed by a Walrus aggregator HTTP service.
+ * Substitutes one CORS-friendly server for the direct-protocol fanout that
+ * misbehaves on testnet from browsers. Trade trustless reads for operator
+ * trust; pick `DefaultWalrusReadAdapter` if you need the former.
+ */
+export declare class HttpAggregatorReadAdapter implements WalrusReadAdapter {
+    #private;
+    constructor(options: HttpAggregatorReadAdapterOptions);
+    /** Mirror `DefaultWalrusReadAdapter.fromConfig` for symmetry. */
+    static fromConfig(options: HttpAggregatorReadAdapterOptions): HttpAggregatorReadAdapter;
+    /**
+     * Construct against `morseConfig.walrusEndpoints.aggregator` (the canonical
+     * Mysten-run aggregator for the network). Pass `verifyBlobIntegrity` or
+     * `headers` here if you want them; everything else is inferred.
+     *
+     * @throws {ConfigurationError} If the network has no canonical aggregator
+     *   URL (e.g. mainnet pre-freeze, or a custom-deployment config without
+     *   `walrusEndpoints.aggregator` supplied).
+     */
+    static fromMorseConfig(morseConfig: Pick<NetworkConfig, "walrusEndpoints">, suiClient: ObjectReader, extras?: Pick<HttpAggregatorReadAdapterOptions, "headers" | "fetch" | "verifyBlobIntegrity">): HttpAggregatorReadAdapter;
+    readBlob(blobId: WalrusBlobId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    readBlobByObjectId(blobObjectId: BlobObjectId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    readQuiltPatch(patchId: QuiltPatchId, options?: WalrusReadOptions): Promise<Uint8Array>;
+    readBlobRef(blobRef: BlobRef, options?: WalrusReadOptions): Promise<Uint8Array>;
+    private fetchBytes;
+    private resolveBlobIdFromObject;
+}
+export {};
+//# sourceMappingURL=http-aggregator-read-adapter.d.ts.map

package/dist/walrus/http-aggregator-read-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-aggregator-read-adapter.d.ts","sourceRoot":"","sources":["../../src/walrus/http-aggregator-read-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlD,OAAO,KAAK,EACX,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACX,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,2BAA2B,CAAC;AAGnC,gFAAgF;AAChF,KAAK,SAAS,GAAG,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,KAClD,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACtC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,YAAY,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,4DAA4D;AAC5D,MAAM,WAAW,gCAAgC;IAChD,uGAAuG;IACvG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;CACxD;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;;gBAOtD,OAAO,EAAE,gCAAgC;IAgBrD,iEAAiE;IACjE,MAAM,CAAC,UAAU,CAChB,OAAO,EAAE,gCAAgC,GACvC,yBAAyB;IAI5B;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CACrB,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,EACnD,SAAS,EAAE,YAAY,EACvB,MAAM,CAAC,EAAE,IAAI,CACZ,gCAAgC,EAChC,SAAS,GAAG,OAAO,GAAG,qBAAqB,CAC3C,GACC,yBAAyB;IAkBtB,QAAQ,CACb,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAgBhB,kBAAkB,CACvB,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAQhB,cAAc,CACnB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAMhB,WAAW,CAChB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;YAOR,UAAU;YA2CV,uBAAuB;CAmDrC"}

package/dist/walrus/http-aggregator-read-adapter.js

@@ -0,0 +1,174 @@
+/**
+ * `WalrusReadAdapter` that fetches blob bytes from a Walrus aggregator HTTP
+ * service instead of fanning out to ~30 storage nodes via `WalrusClient`.
+ *
+ * Why this exists: browser reads through `DefaultWalrusReadAdapter` hit the
+ * direct-protocol path, which fans out to every storage node in the
+ * committee. On testnet a subset of those nodes do not ship CORS headers,
+ * so browser fetches frequently fail with `NoBlobMetadataReceivedError`
+ * even when the blob is healthy. CLI smokes against the same blob succeed
+ * because the CLI does not enforce CORS. The aggregator HTTP service is a
+ * Walrus-operator-run wrapper that internally does the shard math and
+ * exposes a single CORS-friendly endpoint.
+ *
+ * Trust model: the aggregator returns whatever bytes it serves. The
+ * trustless guarantee of fanout-and-reconstruct is replaced with trust in
+ * the operator. Most consumers running a known Mysten / Nami / community
+ * aggregator are fine with this; consumers who need stronger guarantees
+ * should keep `DefaultWalrusReadAdapter`. A future `verifyContentHash`
+ * option is planned for v0.2.0 to recompute the blobId from returned bytes
+ * and assert it matches.
+ *
+ * On-chain Sui object lookups (resolving `blobObjectId` to its `blob_id`)
+ * still go through the supplied `ObjectReader` (gRPC). The HTTP path only
+ * substitutes the bytes-fetch step.
+ */
+import { blobIdFromInt } from "@mysten/walrus";
+import { toWalrusBlobId } from "../codecs.js";
+import { ConfigurationError, NotFoundError, TransportError, ValidationError, } from "../errors.js";
+import { quiltPatchIdToString } from "./quilt-patch-id.js";
+/**
+ * `WalrusReadAdapter` backed by a Walrus aggregator HTTP service.
+ * Substitutes one CORS-friendly server for the direct-protocol fanout that
+ * misbehaves on testnet from browsers. Trade trustless reads for operator
+ * trust; pick `DefaultWalrusReadAdapter` if you need the former.
+ */
+export class HttpAggregatorReadAdapter {
+    #aggregatorUrl;
+    #suiClient;
+    #headers;
+    #fetch;
+    #verifyBlobIntegrity;
+    constructor(options) {
+        this.#aggregatorUrl = options.aggregatorUrl.replace(/\/+$/, "");
+        this.#suiClient = options.suiClient;
+        if (options.headers !== undefined)
+            this.#headers = options.headers;
+        // Browsers enforce that `window.fetch` is called with `window` as its
+        // receiver (WebIDL HostObject check); storing `globalThis.fetch` on
+        // the instance and calling it as `this.#fetch(...)` later throws
+        // `TypeError: Illegal invocation`. Bind to `globalThis` so the call
+        // receiver is correct in browsers.
+        this.#fetch =
+            options.fetch ?? globalThis.fetch.bind(globalThis);
+        if (options.verifyBlobIntegrity !== undefined) {
+            this.#verifyBlobIntegrity = options.verifyBlobIntegrity;
+        }
+    }
+    /** Mirror `DefaultWalrusReadAdapter.fromConfig` for symmetry. */
+    static fromConfig(options) {
+        return new HttpAggregatorReadAdapter(options);
+    }
+    /**
+     * Construct against `morseConfig.walrusEndpoints.aggregator` (the canonical
+     * Mysten-run aggregator for the network). Pass `verifyBlobIntegrity` or
+     * `headers` here if you want them; everything else is inferred.
+     *
+     * @throws {ConfigurationError} If the network has no canonical aggregator
+     *   URL (e.g. mainnet pre-freeze, or a custom-deployment config without
+     *   `walrusEndpoints.aggregator` supplied).
+     */
+    static fromMorseConfig(morseConfig, suiClient, extras) {
+        const url = morseConfig.walrusEndpoints?.aggregator ?? "";
+        if (url.length === 0) {
+            throw new ConfigurationError("morseConfig.walrusEndpoints.aggregator is empty. Pass an aggregator URL explicitly to HttpAggregatorReadAdapter.fromConfig({ aggregatorUrl, suiClient }), or use a network where the endpoint is pinned (testnet).");
+        }
+        return new HttpAggregatorReadAdapter({
+            aggregatorUrl: url,
+            suiClient,
+            ...(extras?.headers === undefined ? {} : { headers: extras.headers }),
+            ...(extras?.fetch === undefined ? {} : { fetch: extras.fetch }),
+            ...(extras?.verifyBlobIntegrity === undefined
+                ? {}
+                : { verifyBlobIntegrity: extras.verifyBlobIntegrity }),
+        });
+    }
+    async readBlob(blobId, options = {}) {
+        const url = `${this.#aggregatorUrl}/v1/blobs/${encodeURIComponent(blobId)}`;
+        const bytes = await this.fetchBytes(url, "blob", blobId, options.signal);
+        if (this.#verifyBlobIntegrity !== undefined) {
+            try {
+                await this.#verifyBlobIntegrity(bytes, blobId);
+            }
+            catch (cause) {
+                throw new TransportError(`Walrus aggregator returned bytes that fail blob-integrity check for ${blobId}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+            }
+        }
+        return bytes;
+    }
+    async readBlobByObjectId(blobObjectId, options = {}) {
+        const blobId = await this.resolveBlobIdFromObject(blobObjectId, options.signal);
+        return this.readBlob(blobId, options);
+    }
+    async readQuiltPatch(patchId, options = {}) {
+        const id = quiltPatchIdToString(patchId);
+        const url = `${this.#aggregatorUrl}/v1/blobs/by-quilt-patch-id/${encodeURIComponent(id)}`;
+        return this.fetchBytes(url, "quilt patch", id, options.signal);
+    }
+    async readBlobRef(blobRef, options = {}) {
+        if (blobRef.kind === "blob") {
+            return this.readBlobByObjectId(blobRef.blobObjectId, options);
+        }
+        return this.readQuiltPatch(blobRef.patchId, options);
+    }
+    async fetchBytes(url, kind, identifier, signal) {
+        let response;
+        try {
+            response = await this.#fetch(url, {
+                ...(signal === undefined ? {} : { signal }),
+                ...(this.#headers === undefined ? {} : { headers: this.#headers }),
+            });
+        }
+        catch (cause) {
+            throw new TransportError(`Walrus aggregator request failed: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        }
+        if (response.status === 404) {
+            throw new NotFoundError("blob", `Walrus aggregator: ${kind} ${identifier} not found`, { cause: new Error(`HTTP ${response.status} ${response.statusText}`) });
+        }
+        if (!response.ok) {
+            throw new TransportError(`Walrus aggregator returned HTTP ${response.status} ${response.statusText} for ${kind} ${identifier}`);
+        }
+        try {
+            const buffer = await response.arrayBuffer();
+            return new Uint8Array(buffer);
+        }
+        catch (cause) {
+            throw new TransportError(`Walrus aggregator response body could not be read: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        }
+    }
+    async resolveBlobIdFromObject(blobObjectId, signal) {
+        let response;
+        try {
+            response = await this.#suiClient.getObject({
+                objectId: blobObjectId,
+                include: { json: true },
+                ...(signal === undefined ? {} : { signal }),
+            });
+        }
+        catch (cause) {
+            throw new TransportError(`Sui getObject failed for blob ${blobObjectId}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        }
+        const object = response.object;
+        if (object === undefined || object === null) {
+            throw new NotFoundError("blob", `Walrus blob object not found on-chain: ${blobObjectId}`);
+        }
+        const json = object.json;
+        if (json === null || typeof json !== "object") {
+            throw new ValidationError(`Walrus blob object ${blobObjectId} has no parsed JSON content`, "blob.json");
+        }
+        const blobIdRaw = json.blob_id;
+        if (typeof blobIdRaw !== "string" && typeof blobIdRaw !== "number") {
+            throw new ValidationError(`Walrus blob object ${blobObjectId} has no string blob_id field; got ${typeof blobIdRaw}`, "blob.blob_id");
+        }
+        // Move `u256` BCS-decodes to a decimal string in Sui RPC json mode;
+        // `blobIdFromInt` converts it to the URL-safe-base64 form aggregators expect.
+        try {
+            const asBigInt = BigInt(blobIdRaw);
+            return toWalrusBlobId(blobIdFromInt(asBigInt));
+        }
+        catch (cause) {
+            throw new ValidationError(`Walrus blob_id u256 could not be converted to base64: ${cause instanceof Error ? cause.message : String(cause)}`, "blob.blob_id", { cause });
+        }
+    }
+}
+//# sourceMappingURL=http-aggregator-read-adapter.js.map

package/dist/walrus/http-aggregator-read-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-aggregator-read-adapter.js","sourceRoot":"","sources":["../../src/walrus/http-aggregator-read-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,GACf,MAAM,cAAc,CAAC;AAWtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAwD3D;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAC5B,cAAc,CAAS;IACvB,UAAU,CAAe;IACzB,QAAQ,CAAe;IACvB,MAAM,CAAY;IAClB,oBAAoB,CAA4B;IAEzD,YAAY,OAAyC;QACpD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QACnE,sEAAsE;QACtE,oEAAoE;QACpE,iEAAiE;QACjE,oEAAoE;QACpE,mCAAmC;QACnC,IAAI,CAAC,MAAM;YACV,OAAO,CAAC,KAAK,IAAK,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAe,CAAC;QACnE,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACzD,CAAC;IACF,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,UAAU,CAChB,OAAyC;QAEzC,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CACrB,WAAmD,EACnD,SAAuB,EACvB,MAGC;QAED,MAAM,GAAG,GAAG,WAAW,CAAC,eAAe,EAAE,UAAU,IAAI,EAAE,CAAC;QAC1D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAC3B,oNAAoN,CACpN,CAAC;QACH,CAAC;QACD,OAAO,IAAI,yBAAyB,CAAC;YACpC,aAAa,EAAE,GAAG;YAClB,SAAS;YACT,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACrE,GAAG,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC/D,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,SAAS;gBAC5C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE,CAAC;SACvD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACb,MAAoB,EACpB,UAA6B,EAAE;QAE/B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,aAAa,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,cAAc,CACvB,uEAAuE,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1I,EAAE,KAAK,EAAE,CACT,CAAC;YACH,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,kBAAkB,CACvB,YAA0B,EAC1B,UAA6B,EAAE;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAChD,YAAY,EACZ,OAAO,CAAC,MAAM,CACd,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,OAAqB,EACrB,UAA6B,EAAE;QAE/B,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,+BAA+B,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1F,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,OAAgB,EAChB,UAA6B,EAAE;QAE/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,UAAU,CACvB,GAAW,EACX,IAA4B,EAC5B,UAAkB,EAClB,MAA+B;QAE/B,IAAI,QAAwC,CAAC;QAC7C,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;gBACjC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;gBAC3C,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;aAClE,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,cAAc,CACvB,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC7F,EAAE,KAAK,EAAE,CACT,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,aAAa,CACtB,MAAM,EACN,sBAAsB,IAAI,IAAI,UAAU,YAAY,EACpD,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,CACtE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,cAAc,CACvB,mCAAmC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,QAAQ,IAAI,IAAI,UAAU,EAAE,CACrG,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,cAAc,CACvB,sDAAsD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9G,EAAE,KAAK,EAAE,CACT,CAAC;QACH,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACpC,YAA0B,EAC1B,MAA+B;QAE/B,IAAI,QAAwD,CAAC;QAC7D,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC1C,QAAQ,EAAE,YAAY;gBACtB,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;gBACvB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;aAC3C,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,cAAc,CACvB,iCAAiC,YAAY,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1G,EAAE,KAAK,EAAE,CACT,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC7C,MAAM,IAAI,aAAa,CACtB,MAAM,EACN,0CAA0C,YAAY,EAAE,CACxD,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,eAAe,CACxB,sBAAsB,YAAY,6BAA6B,EAC/D,WAAW,CACX,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAI,IAA8B,CAAC,OAAO,CAAC;QAC1D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACpE,MAAM,IAAI,eAAe,CACxB,sBAAsB,YAAY,qCAAqC,OAAO,SAAS,EAAE,EACzF,cAAc,CACd,CAAC;QACH,CAAC;QACD,oEAAoE;QACpE,8EAA8E;QAC9E,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,OAAO,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CACxB,yDAAyD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACjH,cAAc,EACd,EAAE,KAAK,EAAE,CACT,CAAC;QACH,CAAC;IACF,CAAC;CACD"}

package/dist/walrus/http-publisher-write-adapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * `WalrusWriteAdapter` that uploads through a Walrus publisher HTTP service
+ * instead of fanning out to ~30 storage nodes via `WalrusClient`. The
+ * publisher (an operator-run service) pays the WAL storage deposit and
+ * handles `register_blob` + `certify_blob` server-side; the consumer's
+ * wallet only signs the downstream `add_entry_to_collection` (1 popup).
+ *
+ * Trade-offs vs `DefaultWalrusWriteAdapter`:
+ *   - 1 wallet popup vs 2 (the publisher absorbs register + certify).
+ *   - Operator-paid storage vs consumer-paid storage. Consumers using a
+ *     paid publisher tier sign whatever auth the publisher requires via
+ *     the `headers` option.
+ *   - The publisher returns the blob object owned by `ownerAddress` (via
+ *     `send_object_to`), which the consumer then references in
+ *     `addEntry`.
+ *
+ * NOT compatible with `addEntryFromBytes` / `addEncryptedEntryFromBytes`,
+ * which require `WalrusFlowCapable` for the 2-popup combined PTB. The
+ * publisher-paid path is naturally a 1-popup path through the standard
+ * `uploadBlob` + `addEntry` composition; the from-bytes optimization
+ * isn't needed because there's no certify popup to combine.
+ */
+import type { BlobObjectId, SuiAddress, WalrusBlobId } from "../types.js";
+import type { QuiltPatchInput, UploadBlobOptions, UploadBlobResult, UploadQuiltOptions, UploadQuiltResult, WalrusWriteAdapter } from "./adapter.js";
+/** Minimal `fetch` shape the adapter calls; `globalThis.fetch` satisfies it. */
+type FetchLike = (input: string, init?: {
+    method?: string;
+    body?: BodyInit;
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+/**
+ * Custom response parser for non-standard publishers. Receives the raw
+ * decoded JSON from `PUT /v1/blobs` (or the inner `blobStoreResult` field
+ * on the quilt endpoint) and returns the parsed `UploadBlobResult`.
+ *
+ * Throw `ValidationError` for malformed shapes; throw `TransportError` for
+ * content-level publisher errors that the consumer should surface (e.g.
+ * `markedInvalid`, `alreadyCertified` without an owned object). Throws
+ * propagate verbatim so the consumer's typed errors reach the caller of
+ * `uploadBlob` / `uploadQuilt` unchanged.
+ *
+ * Use this when a fork of the Walrus publisher serves a response shape
+ * that the built-in parser does not recognize (the built-in handles
+ * Mysten's published binary, which serves camelCase, with a snake_case
+ * fallback for the documented schema). Most consumers do not need to set
+ * this.
+ */
+export type ParsePublisherResponse = (raw: unknown) => UploadBlobResult | Promise<UploadBlobResult>;
+/** Construction options for `HttpPublisherWriteAdapter`. */
+export interface HttpPublisherWriteAdapterOptions {
+    /** Publisher base URL, e.g. `"https://walrus-testnet-publisher.nami.cloud"`. No trailing slash. */
+    readonly publisherUrl: string;
+    /**
+     * Address that will own the resulting Sui blob object. The publisher
+     * sends the newly-created `Blob` to this address via `send_object_to`
+     * so the consumer's `addEntry` can reference it. Typically the
+     * connected wallet's address.
+     */
+    readonly ownerAddress: SuiAddress;
+    /** Optional per-request HTTP headers (auth tokens, bearer keys, custom origin labels). */
+    readonly headers?: HeadersInit;
+    /** Override `fetch` for testing; defaults to `globalThis.fetch`. */
+    readonly fetch?: FetchLike;
+    /**
+     * Optional response-shape escape hatch for non-standard publishers. When
+     * supplied, replaces the built-in parser. See `ParsePublisherResponse`
+     * for the contract. Most consumers should leave this undefined.
+     */
+    readonly parseResponse?: ParsePublisherResponse;
+}
+/**
+ * `WalrusWriteAdapter` backed by a Walrus publisher HTTP service. Substitutes
+ * an operator-run upload service for the direct-protocol shard fanout.
+ * Useful for browser dapps that want a "publisher pays storage" onboarding
+ * path (1 wallet popup total) and/or CORS-friendly uploads from environments
+ * that block direct storage-node fanout.
+ */
+export declare class HttpPublisherWriteAdapter implements WalrusWriteAdapter {
+    #private;
+    constructor(options: HttpPublisherWriteAdapterOptions);
+    /** Mirror `DefaultWalrusWriteAdapter.fromConfig` for symmetry. */
+    static fromConfig(options: HttpPublisherWriteAdapterOptions): HttpPublisherWriteAdapter;
+    uploadBlob(data: Uint8Array, options: UploadBlobOptions): Promise<UploadBlobResult>;
+    uploadQuilt(patches: readonly QuiltPatchInput[], options: UploadQuiltOptions): Promise<UploadQuiltResult>;
+    private buildBlobUrl;
+    private buildQuiltUrl;
+    private putRequest;
+}
+export type { BlobObjectId, WalrusBlobId };
+//# sourceMappingURL=http-publisher-write-adapter.d.ts.map

package/dist/walrus/http-publisher-write-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-publisher-write-adapter.d.ts","sourceRoot":"","sources":["../../src/walrus/http-publisher-write-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAElB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,cAAc,CAAC;AAMtB,gFAAgF;AAChF,KAAK,SAAS,GAAG,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IACN,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,KACG,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACpC,GAAG,EAAE,OAAO,KACR,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAElD,4DAA4D;AAC5D,MAAM,WAAW,gCAAgC;IAChD,mGAAmG;IACnG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAC;CAChD;AA+CD;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;;gBAOvD,OAAO,EAAE,gCAAgC;IAkBrD,kEAAkE;IAClE,MAAM,CAAC,UAAU,CAChB,OAAO,EAAE,gCAAgC,GACvC,yBAAyB;IAItB,UAAU,CACf,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAqBtB,WAAW,CAChB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,iBAAiB,CAAC;IA8F7B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;YAUP,UAAU;CAuCxB;AAgFD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}