@artblocks/abx-storage 0.1.0-alpha.0

package/dist/arweave.js

@@ -0,0 +1,458 @@
+import { privateKeyToAccount } from 'viem/accounts';
+import { ContentIndex } from './content-index.js';
+import { arweaveAddress } from './arweave-identity.js';
+/**
+ * Best-effort USD estimate for a Turbo (Arweave) upload of `bytes`, from Turbo's PUBLIC price API
+ * (no key, no SDK). Returns null on ANY failure (offline, timeout, API change) — callers treat it
+ * as a bonus and carry on. Rough by design: linear in bytes, current rates.
+ */
+export async function turboUploadCostUsd(bytes) {
+    if (!Number.isFinite(bytes) || bytes <= 0)
+        return null;
+    const base = 'https://payment.ardrive.io/v1';
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 4000);
+    try {
+        const [priceRes, ratesRes] = await Promise.all([
+            fetch(`${base}/price/bytes/${Math.floor(bytes)}`, { signal: ctrl.signal }),
+            fetch(`${base}/rates`, { signal: ctrl.signal }),
+        ]);
+        if (!priceRes.ok || !ratesRes.ok)
+            return null;
+        const price = (await priceRes.json());
+        const rates = (await ratesRes.json());
+        const uploadWinc = Number(price.winc);
+        const refWinc = Number(rates.winc);
+        const usdPerRef = rates.fiat?.usd;
+        if (!uploadWinc || !refWinc || !usdPerRef)
+            return null;
+        return (uploadWinc / refWinc) * usdPerRef;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * The Winston-credit (winc) cost of a Turbo upload of `bytes`, from the PUBLIC price API (no key,
+ * no SDK). Returns null on any failure — callers treat null as "couldn't check". For the pre-upload
+ * funds guard: compare against the identity's balance winc. 1 credit = 1e12 winc.
+ */
+export async function turboUploadWinc(bytes) {
+    if (!Number.isFinite(bytes) || bytes <= 0)
+        return null;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 4000);
+    try {
+        const res = await fetch(`https://payment.ardrive.io/v1/price/bytes/${Math.floor(bytes)}`, { signal: ctrl.signal });
+        if (!res.ok)
+            return null;
+        const price = (await res.json());
+        return Number(price.winc) || null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * The Turbo credit balance of ANY address, from the PUBLIC payment API — **no key, no signature**.
+ * So the CLI can check whether a creator's *Ethereum wallet* holds Turbo credits (to recommend
+ * `--storage-signer eth`) before ever suggesting a top-up. `token` is the address's chain
+ * (`ethereum` for an EVM wallet, `arweave` for a JWK address). Returns null on any failure
+ * (offline, unknown address) — callers treat it as "couldn't check". 1 credit = 1e12 winc.
+ */
+export async function turboBalanceForAddress(address, token = 'ethereum') {
+    if (!address)
+        return null;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 4000);
+    try {
+        const res = await fetch(`https://payment.ardrive.io/v1/account/balance/${token}?address=${encodeURIComponent(address)}`, { signal: ctrl.signal });
+        if (!res.ok)
+            return null; // 404 = address has never had a Turbo balance
+        const winc = ((await res.json()).winc ?? '').toString();
+        if (!/^\d+$/.test(winc))
+            return null;
+        return { winc, credits: wincToCredits(winc) };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Turbo's free-upload ceiling: data items under 100 KiB upload for free — no credits, no prior
+ *  top-up, no setup. Most single 1/1 SVGs/PNGs fall under it. */
+export const ARWEAVE_FREE_UPLOAD_LIMIT = 100 * 1024;
+/** The Turbo identity a config selects (precedence: remote → eth key → arweave jwk), or null if
+ *  none is available yet (e.g. Turbo before its managed key is created). */
+export function turboIdentity(cfg) {
+    if (cfg.remoteEth)
+        return { kind: 'ethereum-remote', ...cfg.remoteEth };
+    if (cfg.ethSignerKey)
+        return { kind: 'ethereum', privateKey: cfg.ethSignerKey };
+    if (cfg.jwk)
+        return { kind: 'arweave', jwk: cfg.jwk };
+    return null;
+}
+/**
+ * The Turbo identity for an operation — {@link turboIdentity}, but when it would be null and this is
+ * a WRITE (`opts.mint`), lazily mint the managed key via `cfg.ensureJwk` (creating + persisting it).
+ * This is the ONLY implicit key-creation path, and it's gated on `mint` so reads/probes never mint.
+ * Pure aside from the injected `ensureJwk` side effect — the write/read distinction is the caller's.
+ */
+export function resolveTurboIdentity(cfg, opts = {}) {
+    const existing = turboIdentity(cfg);
+    if (existing)
+        return existing;
+    if (opts.mint && cfg.ensureJwk)
+        return { kind: 'arweave', jwk: cfg.ensureJwk() };
+    return null;
+}
+/** Whether an identity is an Ethereum one (local key or remote wallet) — its address is `0x…`. */
+export function isEthIdentity(id) {
+    return id.kind === 'ethereum' || id.kind === 'ethereum-remote';
+}
+const withHexPrefix = (k) => (k.startsWith('0x') ? k : `0x${k}`);
+const stripHexPrefix = (k) => (k.startsWith('0x') ? k.slice(2) : k);
+/** The credit-holding / signing address for an identity — Arweave `base64url(sha256(n))` or an
+ *  EVM `0x…`. Pure derivation, no network. Its balance is what `abx storage balance` reports. */
+export function turboIdentityAddress(id) {
+    switch (id.kind) {
+        case 'arweave':
+            return arweaveAddress(id.jwk);
+        case 'ethereum':
+            return privateKeyToAccount(withHexPrefix(id.privateKey)).address;
+        case 'ethereum-remote':
+            return id.address;
+    }
+}
+const trim = (u) => u.replace(/\/+$/, '');
+/** Coerce a Turbo `uploadFile` response to text. It's normally an object, but the idempotent
+ *  "already uploaded" path returns a plain string (which JSON/stream layers may surface as a
+ *  char-indexed object) — Object.values(...).join('') recovers it either way. */
+function turboResponseText(res) {
+    if (typeof res === 'string')
+        return res;
+    if (res && typeof res === 'object') {
+        if ('id' in res && res.id)
+            return String(res.id);
+        try {
+            return Object.values(res).join('');
+        }
+        catch {
+            return '';
+        }
+    }
+    return '';
+}
+/**
+ * The Arweave data-item id from a Turbo `uploadFile` response. Normally `res.id`; but Turbo
+ * **deduplicates identical bytes** — a re-upload of the same data item (same signer + tags + bytes →
+ * same deterministic id) returns a plain-text `"Data item with ID <id> has already been uploaded to
+ * this service!"` instead of the usual JSON. Both are success: the bytes ARE on Turbo. We extract
+ * the 43-char base64url txid so idempotent re-uploads (retries, redeploys, duplicate images in a
+ * series) resolve to the real locator instead of throwing. Returns null if no id is present.
+ */
+export function turboUploadId(res) {
+    if (res && typeof res === 'object' && 'id' in res && res.id) {
+        return String(res.id);
+    }
+    const m = turboResponseText(res).match(/\bID\s+([A-Za-z0-9_-]{43})\b/);
+    return m ? m[1] : null;
+}
+/** Optional deps, loaded lazily via indirect specifiers so they're not required to install/build. */
+const TURBO_SDK_PACKAGE = '@ardrive/turbo-sdk';
+const ARBUNDLES_PACKAGE = '@dha-team/arbundles';
+const WINC_PER_CREDIT = 1e12;
+const wincToCredits = (winc) => {
+    const n = Number(winc) / WINC_PER_CREDIT;
+    return n.toFixed(6).replace(/\.?0+$/, '') || '0';
+};
+/** Dep-free uploader for token-authenticated managed Arweave upload endpoints. */
+export class HttpBundlerUploader {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    async upload(bytes, contentType) {
+        if (!this.cfg.uploadUrl) {
+            throw new Error('Arweave http-bundler needs an upload endpoint — pass `--backend arweave --provider http-bundler --upload-url <bundler>` (or set ABX_ARWEAVE_UPLOAD_URL), or use the default `turbo` provider.');
+        }
+        const headers = { 'content-type': contentType };
+        if (this.cfg.token)
+            headers.authorization = `Bearer ${this.cfg.token}`;
+        const res = await fetch(this.cfg.uploadUrl, { method: 'POST', headers, body: bytes });
+        if (!res.ok)
+            throw new Error(`Arweave upload failed (${res.status}): ${await res.text()}`);
+        const json = (await res.json());
+        const id = json.id ?? json.txId ?? json.transactionId ?? json.arweaveTxId;
+        if (!id)
+            throw new Error('Arweave upload returned no transaction id');
+        return { id: String(id) };
+    }
+}
+/**
+ * ArDrive Turbo uploader — the recommended Arweave path. Lazy-loads the optional
+ * `@ardrive/turbo-sdk` only when an upload / balance / top-up actually runs (the retrieve-only
+ * resolver never touches it). The signing {@link TurboIdentity} is multi-chain: the CLI-managed
+ * Arweave JWK (default), an `.env` EVM key, or a remote browser wallet — each both signs uploads
+ * and holds the prepaid credits at its own address.
+ */
+export class TurboUploader {
+    identity;
+    constructor(identity) {
+        this.identity = identity;
+        if (identity.kind === 'arweave' && !identity.jwk?.n) {
+            throw new Error('Turbo needs an Arweave identity key (JWK). The CLI manages one at `.abx-self-host/arweave-key.json` — or set ARWEAVE_JWK, or use `--provider http-bundler`.');
+        }
+        if (identity.kind === 'ethereum' && !identity.privateKey) {
+            throw new Error('Turbo Ethereum identity needs a private key.');
+        }
+    }
+    async sdk() {
+        try {
+            // Indirect specifier: keeps the OPTIONAL dep out of the type graph so the package
+            // type-checks and runs without it installed (the retrieve-only resolver path never calls this).
+            return await import(/* @vite-ignore */ TURBO_SDK_PACKAGE);
+        }
+        catch {
+            throw new Error("The Turbo provider needs the optional '@ardrive/turbo-sdk' package — install it (`pnpm add @ardrive/turbo-sdk`), or switch with `--backend arweave --provider http-bundler --upload-url <bundler>`.");
+        }
+    }
+    /** arbundles (the signing lib Turbo uses) — for `InjectedEthereumSigner`, which turbo-sdk does NOT
+     *  re-export. Optional dep, loaded only on the remote-wallet upload path. */
+    async arbundles() {
+        try {
+            return await import(/* @vite-ignore */ ARBUNDLES_PACKAGE);
+        }
+        catch {
+            throw new Error("The browser-wallet Arweave upload lane needs the optional '@dha-team/arbundles' package — install it (`pnpm add @dha-team/arbundles`), or use `--storage-signer eth` with a key in .env, or the managed Arweave key.");
+        }
+    }
+    clientPromise;
+    client() {
+        return (this.clientPromise ??= this.buildClient());
+    }
+    /** Authenticate a Turbo client for the selected identity. Arweave uses the JWK directly; an EVM
+     *  identity uses an arbundles `EthereumSigner` (local key) or `InjectedEthereumSigner` (remote
+     *  wallet) — the SDK re-exports both, so no direct arbundles dependency. */
+    async buildClient() {
+        const m = await this.sdk();
+        const id = this.identity;
+        if (id.kind === 'arweave') {
+            return m.TurboFactory.authenticated({ privateKey: id.jwk, token: 'arweave' });
+        }
+        if (id.kind === 'ethereum') {
+            const signer = new m.EthereumSigner(stripHexPrefix(id.privateKey));
+            return m.TurboFactory.authenticated({ signer, token: 'ethereum' });
+        }
+        // ethereum-remote: drive arbundles' own InjectedEthereumSigner via a provider shim that
+        // round-trips each signMessage to the browser wallet. arbundles calls `signer.signMessage(msg)`
+        // with a STRING challenge (setPublicKey → pubkey recovery, one prompt) and a Uint8Array per data
+        // item, and expects back a `0x…` hex signature (it does `sig.slice(2)`). ethers'
+        // signMessage(string) ≡ signMessage(utf8Bytes(string)), so normalizing to bytes is faithful.
+        // NOTE: turbo-sdk re-exports EthereumSigner but NOT InjectedEthereumSigner — import it from
+        // arbundles (the same package turbo signs with) directly.
+        const { InjectedEthereumSigner } = await this.arbundles();
+        const signMessage = id.signMessage;
+        const provider = {
+            getSigner: () => ({
+                signMessage: (message) => signMessage(typeof message === 'string' ? new TextEncoder().encode(message) : Uint8Array.from(message)),
+            }),
+        };
+        const signer = new InjectedEthereumSigner(provider);
+        await signer.setPublicKey();
+        return m.TurboFactory.authenticated({ signer, token: 'ethereum' });
+    }
+    async upload(bytes, contentType) {
+        const turbo = await this.client();
+        const { Readable } = await import('node:stream');
+        const buf = Buffer.from(bytes);
+        const res = await turbo.uploadFile({
+            fileStreamFactory: () => Readable.from(buf),
+            fileSizeFactory: () => buf.byteLength,
+            dataItemOpts: { tags: [{ name: 'Content-Type', value: contentType }] },
+        });
+        const id = turboUploadId(res);
+        if (!id)
+            throw new Error(`Turbo upload returned no transaction id (response: ${turboResponseText(res).slice(0, 200)})`);
+        return { id };
+    }
+    funding = {
+        address: async () => turboIdentityAddress(this.identity),
+        balance: async () => {
+            const turbo = await this.client();
+            const { winc } = (await turbo.getBalance());
+            return { winc: String(winc), credits: wincToCredits(winc) };
+        },
+        topup: async ({ usd }) => {
+            const [turbo, m] = await Promise.all([this.client(), this.sdk()]);
+            const session = (await turbo.createCheckoutSession({ amount: m.USD(usd), owner: turboIdentityAddress(this.identity) }));
+            if (!session?.url)
+                throw new Error('Turbo top-up returned no checkout URL');
+            return { url: String(session.url), winc: String(session.winc ?? '') };
+        },
+    };
+}
+/** The upload route for a config: explicit `provider`, else `http-bundler` when an `uploadUrl`
+ *  is set, else the recommended `turbo`. */
+export function arweaveProvider(cfg) {
+    return cfg.provider ?? (cfg.uploadUrl ? 'http-bundler' : 'turbo');
+}
+function buildUploader(cfg, opts = {}) {
+    if (arweaveProvider(cfg) === 'http-bundler') {
+        return new HttpBundlerUploader({ uploadUrl: cfg.uploadUrl, token: cfg.token });
+    }
+    // On a WRITE (opts.mint), a managed default with no key yet is minted here (cfg.ensureJwk); on a
+    // read/probe (no mint) an absent identity stays null → the throw below. So the managed default
+    // "just works" for an upload without a prior setup step, and reads never create a key.
+    const id = resolveTurboIdentity(cfg, opts);
+    if (!id) {
+        throw new Error('Arweave via Turbo needs an identity. Run an upload through the CLI (it creates a managed key at `.abx-self-host/arweave-key.json`), set ARWEAVE_JWK, sign with an EVM key/wallet (`--storage-signer eth`), or use `--provider http-bundler --upload-url <bundler>`.');
+    }
+    return new TurboUploader(id);
+}
+/**
+ * The funding capability for a config's provider, or throw a clear reason if that provider has
+ * none — capability negotiation, so `abx storage topup`/`balance` dispatch through one verb and
+ * a crypto-only provider says "fund the wallet directly" rather than pretending.
+ */
+export function arweaveFunding(cfg) {
+    const f = buildUploader(cfg).funding;
+    if (!f)
+        throw new Error(`The '${arweaveProvider(cfg)}' Arweave provider has no prepaid balance — fund its wallet directly.`);
+    return f;
+}
+export class ArweaveBackend {
+    cfg;
+    id = 'arweave';
+    index;
+    uploaderInstance;
+    injectedUploader;
+    constructor(cfg, dataDir, uploader) {
+        this.cfg = cfg;
+        this.index = new ContentIndex(dataDir);
+        this.injectedUploader = uploader;
+    }
+    /** Built lazily on first use — retrieval (get/locator/health, the resolver path) needs only the
+     *  gateway, never an upload identity or the Turbo SDK. `mint` (passed by the write ops) lets a
+     *  managed default create its key here; reads/probes pass false so they never mint. */
+    uploader(mint = false) {
+        return (this.uploaderInstance ??= this.injectedUploader ?? buildUploader(this.cfg, { mint }));
+    }
+    /** Funding capability of the active provider, or null if it has none (e.g. http-bundler) or
+     *  can't yet be built (e.g. Turbo without an identity key). The CLI uses {@link arweaveFunding}
+     *  directly for an actionable error; this accessor is the safe boolean-ish capability probe. */
+    funding() {
+        try {
+            return this.uploader(false).funding ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async put(hash, content) {
+        const { id } = await this.uploader(true).upload(content.bytes, content.contentType);
+        this.index.set(hash, { pointer: id, contentType: content.contentType });
+    }
+    async get(hash) {
+        const entry = this.index.get(hash);
+        if (!entry)
+            return null;
+        const res = await fetch(`${trim(this.cfg.gateway)}/${entry.pointer}`);
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`Arweave gateway GET failed (${res.status})`);
+        return { bytes: new Uint8Array(await res.arrayBuffer()), contentType: entry.contentType };
+    }
+    async has(hash) {
+        return this.index.has(hash);
+    }
+    /** The gateway HTTPS URL for the bytes (`<gateway>/<txid>`) — the production-safe form an NFT
+     *  `image` needs (a raw `ar://` doesn't render in browsers/most wallets). The txid is permanent,
+     *  so the bytes resolve through any Arweave gateway and verify against the on-chain keccak256;
+     *  we serve a concrete reachable one. Null until the bytes are uploaded. */
+    async locator(hash) {
+        const entry = this.index.get(hash);
+        return entry ? `${trim(this.cfg.gateway)}/${entry.pointer}` : null;
+    }
+    /**
+     * Upload a directory of files as an Arweave **path manifest**: each file is uploaded to its own
+     * txid, then a manifest (`arweave/paths`) mapping `name → txid` is uploaded, and its txid is the
+     * directory root. `<gateway>/<manifestTxid>/0.png` then resolves. The manifest txid is a
+     * permanent, content-addressed root → integrity for the whole set, no per-file keccak needed.
+     */
+    async putDirectory(entries) {
+        const up = this.uploader(true);
+        const paths = {};
+        for (const e of entries) {
+            const { id } = await up.upload(e.bytes, e.contentType);
+            paths[e.name] = { id };
+        }
+        const manifest = {
+            manifest: 'arweave/paths',
+            version: '0.1.0',
+            index: entries[0] ? { path: entries[0].name } : undefined,
+            paths,
+        };
+        const { id: manifestId } = await up.upload(new TextEncoder().encode(JSON.stringify(manifest)), 'application/x.arweave-manifest+json');
+        return { base: `${trim(this.cfg.gateway)}/${manifestId}` };
+    }
+    async health() {
+        const provider = arweaveProvider(this.cfg);
+        try {
+            const res = await fetch(trim(this.cfg.gateway), { method: 'HEAD' });
+            const reachable = res.status < 500;
+            let detail = `provider ${provider} · gateway ${this.cfg.gateway}`;
+            if (provider === 'http-bundler') {
+                if (!this.cfg.uploadUrl) {
+                    return { ok: false, detail: `${detail} · no upload endpoint — set --upload-url <bundler> (or use --provider turbo)` };
+                }
+                detail += ` · upload ${this.cfg.uploadUrl}${this.cfg.token ? ' (token set)' : ' (no token)'}`;
+            }
+            else {
+                const id = turboIdentity(this.cfg);
+                detail += id
+                    ? ` · identity ${isEthIdentity(id) ? 'eth' : 'arweave'} ${turboIdentityAddress(id)}`
+                    : ' · identity created on first upload (free under 100 KiB)';
+            }
+            return { ok: reachable, detail };
+        }
+        catch (e) {
+            return { ok: false, detail: e.message };
+        }
+    }
+}
+/** Build an Arweave config from the environment (non-secret values; the token/JWK/eth-key are
+ *  secrets). `ABX_ARWEAVE_ETH_SIGNER_KEY` selects an EVM Turbo identity (the CLI usually sets this
+ *  from the resolved signing key instead). */
+export function arweaveConfigFromEnv() {
+    return {
+        gateway: process.env.ABX_ARWEAVE_GATEWAY ?? 'https://arweave.net',
+        provider: process.env.ABX_ARWEAVE_PROVIDER,
+        uploadUrl: process.env.ABX_ARWEAVE_UPLOAD_URL,
+        token: process.env.ARWEAVE_UPLOAD_TOKEN,
+        jwk: parseJwkEnv(process.env.ARWEAVE_JWK),
+        ethSignerKey: process.env.ABX_ARWEAVE_ETH_SIGNER_KEY,
+    };
+}
+function parseJwkEnv(raw) {
+    if (!raw)
+        return undefined;
+    const text = raw.trim().startsWith('{') ? raw : Buffer.from(raw, 'base64').toString('utf8');
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error('ARWEAVE_JWK is not valid JSON (or base64 of JSON).');
+    }
+}
+//# sourceMappingURL=arweave.js.map

package/dist/arweave.js.map

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

package/dist/backend.d.ts

@@ -0,0 +1,87 @@
+import { type Hex } from 'viem';
+/**
+ * Byte custody for ABX content.
+ *
+ * The protocol's central asymmetry: **state replays from chain, but source
+ * bytes do not.** A token's content commitment is an on-chain `keccak256` of the
+ * bytes that *are* the work; this service holds those bytes and serves them.
+ *
+ * Content is **addressed by its commitment hash** — `put(hash, …)` stores under
+ * the same `keccak256` the contract committed, and `get(hash)` returns it. So the
+ * pointer lives on-chain (the commitment), storage stays off-chain, and the bytes
+ * are both locatable (by hash) and verifiable (re-hash, compare) with no trust in
+ * any server. Custody is *switchable, never lapsable*: move backends freely
+ * (re-put, verify, drop the old), but never let the bytes go.
+ */
+export interface StoredContent {
+    bytes: Uint8Array;
+    /** MIME type, e.g. `image/png` — served back verbatim. */
+    contentType: string;
+}
+/** One file in a directory upload — `name` is the path under the directory (e.g. `0.png`). */
+export interface DirEntry {
+    name: string;
+    bytes: Uint8Array;
+    contentType: string;
+}
+export interface StorageBackend {
+    /** Short backend id, e.g. `fs` · `s3` · `ipfs` · `arweave`. */
+    readonly id: string;
+    /** Store bytes under their commitment hash. Idempotent (content-addressed). */
+    put(hash: Hex, content: StoredContent): Promise<void>;
+    /** Fetch bytes previously stored under this hash, or null if this backend lacks them. */
+    get(hash: Hex): Promise<StoredContent | null>;
+    /** Whether this backend currently holds content for the hash. */
+    has(hash: Hex): Promise<boolean>;
+    /** Optional liveness + credentials check for `abx doctor`. */
+    health?(): Promise<{
+        ok: boolean;
+        detail?: string;
+    }>;
+    /**
+     * Optional content-addressed locator for the hash — a gateway-agnostic URI a client can
+     * resolve WITHOUT this server (e.g. `ipfs://<cid>`, `ar://<txid>`). Backends that only
+     * serve bytes through this node (fs, cloud) omit it, and the resolver falls back to its
+     * own `/…/image` URL. Lets the served metadata point the heavy asset straight at a
+     * durable, peer-to-peer locator while the node serves only thin JSON.
+     */
+    locator?(hash: Hex): Promise<string | null>;
+    /**
+     * Optional: upload a whole directory of files in ONE shot and return the **gateway base URL**
+     * for it (no trailing slash) — an IPFS directory CID (`<gateway>/ipfs/<cid>`) or an Arweave
+     * path manifest (`<gateway>/<manifestTxid>`). A file named `0.png` is then reachable at
+     * `<base>/0.png`. This is what powers the O(1) directory pattern: N files → one on-chain
+     * `url-template` (`<base>/{id}.<ext>`), no per-token on-chain data. Content-addressed roots
+     * (CID / manifest txid) give integrity without a per-file keccak anchor. Backends that serve
+     * only through this node (fs, cloud) omit it.
+     */
+    putDirectory?(entries: DirEntry[]): Promise<{
+        base: string;
+    }>;
+    /**
+     * The public READ base for this backend (no trailing slash) such that `<publicBase>/<key>`
+     * fetches an object written by {@link putObject}, or undefined if objects are only reachable
+     * through this node. Present only on **mutable, path-addressed** hosts (S3/R2/CDN) — the ones
+     * that can serve a STABLE per-token URL an on-chain `url-template` names. Content-addressed
+     * backends (ipfs/arweave) omit it: their locator changes with the bytes, so they can't back a
+     * deterministic `/{id}` path without rewriting chain state on every update.
+     */
+    readonly publicBase?: string;
+    /**
+     * Optional: write bytes at a CALLER-CHOSEN key (NOT content-addressed), overwriting in place.
+     * This is the deterministic-thumbnail primitive: the effect runner writes token N's still to the
+     * exact key an on-chain `image` `url-template` points at (`<publicBase>/<key>`), overwriting on
+     * re-render — so the on-chain pointer is stable while the pixels update, with no chain write and
+     * no metadata resolver. Only mutable path-addressed backends (cloud) implement it.
+     */
+    putObject?(key: string, content: StoredContent): Promise<void>;
+    /** Optional: read bytes previously written by {@link putObject} at `key`, or null if absent. */
+    getObject?(key: string): Promise<StoredContent | null>;
+}
+/** keccak256 of arbitrary content bytes — the value committed on-chain (the image `keccak256` field). */
+export declare function hashContent(bytes: Uint8Array): Hex;
+/** Best-effort MIME type from a file path — a *labeled* extension-map fallback (the data plane's
+ *  declared-type rule permits it for locator forms; bytes are never sniffed). Unknown → the
+ *  honest floor, `application/octet-stream`. */
+export declare function contentTypeFromPath(path: string): string;
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAC,MAAM,MAAM,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,yFAAyF;IACzF,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC9C,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,8DAA8D;IAC9D,MAAM,CAAC,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,gGAAgG;IAChG,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACxD;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAElD;AAED;;gDAEgD;AAChD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6BxD"}

package/dist/backend.js

@@ -0,0 +1,39 @@
+import { keccak256 } from 'viem';
+/** keccak256 of arbitrary content bytes — the value committed on-chain (the image `keccak256` field). */
+export function hashContent(bytes) {
+    return keccak256(bytes);
+}
+/** Best-effort MIME type from a file path — a *labeled* extension-map fallback (the data plane's
+ *  declared-type rule permits it for locator forms; bytes are never sniffed). Unknown → the
+ *  honest floor, `application/octet-stream`. */
+export function contentTypeFromPath(path) {
+    const ext = path.toLowerCase().slice(path.lastIndexOf('.') + 1);
+    const map = {
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        svg: 'image/svg+xml',
+        avif: 'image/avif',
+        tiff: 'image/tiff',
+        tif: 'image/tiff',
+        psd: 'image/vnd.adobe.photoshop',
+        mp4: 'video/mp4',
+        webm: 'video/webm',
+        html: 'text/html; charset=utf-8',
+        json: 'application/json',
+        glb: 'model/gltf-binary',
+        gltf: 'model/gltf+json',
+        mp3: 'audio/mpeg',
+        wav: 'audio/wav',
+        flac: 'audio/flac',
+        pdf: 'application/pdf',
+        txt: 'text/plain; charset=utf-8',
+        md: 'text/markdown; charset=utf-8',
+        csv: 'text/csv; charset=utf-8',
+        zip: 'application/zip',
+    };
+    return map[ext] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAW,MAAM,MAAM,CAAC;AAkFzC,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED;;gDAEgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,GAA2B;QAClC,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,2BAA2B;QAChC,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,iBAAiB;QACtB,GAAG,EAAE,2BAA2B;QAChC,EAAE,EAAE,8BAA8B;QAClC,GAAG,EAAE,yBAAyB;QAC9B,GAAG,EAAE,iBAAiB;KACvB,CAAC;IACF,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AAChD,CAAC"}