@artblocks/abx-storage 0.1.0-alpha.0

package/dist/ipfs.js

@@ -0,0 +1,135 @@
+import { ContentIndex } from './content-index.js';
+const trim = (u) => u.replace(/\/+$/, '');
+export class IpfsBackend {
+    cfg;
+    id = 'ipfs';
+    index;
+    constructor(cfg, dataDir) {
+        this.cfg = cfg;
+        this.index = new ContentIndex(dataDir);
+    }
+    async put(hash, content) {
+        const cid = this.cfg.mode === 'pinata' ? await this.addPinata(content) : await this.addKubo(content);
+        this.index.set(hash, { pointer: cid, contentType: content.contentType });
+    }
+    async get(hash) {
+        const entry = this.index.get(hash);
+        if (!entry)
+            return null;
+        const res = await fetch(`${trim(this.cfg.gateway)}/ipfs/${entry.pointer}`);
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`IPFS gateway GET failed (${res.status})`);
+        // Gateways don't reliably echo the original content type — use what we stored.
+        return { bytes: new Uint8Array(await res.arrayBuffer()), contentType: entry.contentType };
+    }
+    async has(hash) {
+        return this.index.has(hash);
+    }
+    /**
+     * The **gateway HTTPS URL** for the pinned bytes (`<gateway>/ipfs/<cid>`) — the production-safe
+     * form an NFT `image` needs, since browsers, wallets, and most marketplaces can't render a raw
+     * `ipfs://<cid>`. The CID is content-addressed so the bytes are resolvable through *any* gateway
+     * (and verifiable against the on-chain keccak256); we serve a concrete, reachable one. A pinning
+     * service + a public gateway is therefore part of operating IPFS custody — a local gateway
+     * (`127.0.0.1`/`localhost`) produces a URL only this machine can resolve. Null until pinned.
+     */
+    async locator(hash) {
+        const entry = this.index.get(hash);
+        return entry ? `${trim(this.cfg.gateway)}/ipfs/${entry.pointer}` : null;
+    }
+    /**
+     * Pin a directory of files as ONE IPFS object and return its gateway base
+     * (`<gateway>/ipfs/<dirCID>`), so `<base>/0.png` resolves. The CID is content-addressed →
+     * gateway-agnostic integrity for the whole set. Pinata only (kubo directory add is deferred).
+     */
+    async putDirectory(entries) {
+        if (this.cfg.mode !== 'pinata') {
+            throw new Error('IPFS directory upload currently requires pinata mode (kubo recursive add is not yet wired)');
+        }
+        if (!this.cfg.pinataJwt)
+            throw new Error('IPFS pinata mode needs PINATA_JWT');
+        const fd = new FormData();
+        // Each file is appended under a common wrapping folder; Pinata returns that folder's CID,
+        // so the entries are addressable as `<gateway>/ipfs/<cid>/<name>`.
+        for (const e of entries) {
+            fd.append('file', new Blob([e.bytes], { type: e.contentType }), `abx/${e.name}`);
+        }
+        fd.append('pinataOptions', JSON.stringify({ cidVersion: 1 }));
+        const res = await fetch(`${trim(this.cfg.pinataEndpoint ?? 'https://api.pinata.cloud')}/pinning/pinFileToIPFS`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${this.cfg.pinataJwt}` },
+            body: fd,
+        });
+        if (!res.ok)
+            throw new Error(`Pinata directory pin failed (${res.status}): ${await res.text()}`);
+        const cid = (await res.json()).IpfsHash;
+        if (!cid)
+            throw new Error('Pinata directory pin returned no CID');
+        return { base: `${trim(this.cfg.gateway)}/ipfs/${cid}` };
+    }
+    async health() {
+        try {
+            if (this.cfg.mode === 'pinata') {
+                if (!this.cfg.pinataJwt)
+                    return { ok: false, detail: 'PINATA_JWT not set' };
+                const res = await fetch(`${trim(this.cfg.pinataEndpoint ?? 'https://api.pinata.cloud')}/data/testAuthentication`, {
+                    headers: { authorization: `Bearer ${this.cfg.pinataJwt}` },
+                });
+                return { ok: res.ok, detail: res.ok ? `pinata auth ok · gateway ${this.cfg.gateway}` : `pinata auth failed (${res.status})` };
+            }
+            if (!this.cfg.apiUrl)
+                return { ok: false, detail: 'kubo apiUrl not set' };
+            const res = await fetch(`${trim(this.cfg.apiUrl)}/api/v0/version`, { method: 'POST' });
+            return { ok: res.ok, detail: res.ok ? `kubo ${this.cfg.apiUrl} · gateway ${this.cfg.gateway}` : `kubo unreachable (${res.status})` };
+        }
+        catch (e) {
+            return { ok: false, detail: e.message };
+        }
+    }
+    form(content) {
+        const fd = new FormData();
+        fd.set('file', new Blob([content.bytes], { type: content.contentType }), 'content');
+        return fd;
+    }
+    async addKubo(content) {
+        if (!this.cfg.apiUrl)
+            throw new Error('IPFS kubo mode needs an apiUrl (e.g. http://127.0.0.1:5001)');
+        const res = await fetch(`${trim(this.cfg.apiUrl)}/api/v0/add?pin=true&cid-version=1`, { method: 'POST', body: this.form(content) });
+        if (!res.ok)
+            throw new Error(`IPFS add failed (${res.status}): ${await res.text()}`);
+        const last = (await res.text()).trim().split('\n').pop() ?? '';
+        const cid = JSON.parse(last).Hash;
+        if (!cid)
+            throw new Error('IPFS add returned no CID');
+        return cid;
+    }
+    async addPinata(content) {
+        if (!this.cfg.pinataJwt)
+            throw new Error('IPFS pinata mode needs PINATA_JWT');
+        const res = await fetch(`${trim(this.cfg.pinataEndpoint ?? 'https://api.pinata.cloud')}/pinning/pinFileToIPFS`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${this.cfg.pinataJwt}` },
+            body: this.form(content),
+        });
+        if (!res.ok)
+            throw new Error(`Pinata pin failed (${res.status}): ${await res.text()}`);
+        const cid = (await res.json()).IpfsHash;
+        if (!cid)
+            throw new Error('Pinata pin returned no CID');
+        return cid;
+    }
+}
+/** Build an IPFS config from the environment (non-secret values; PINATA_JWT is the secret). */
+export function ipfsConfigFromEnv() {
+    const mode = (process.env.ABX_IPFS_MODE ?? (process.env.PINATA_JWT ? 'pinata' : 'kubo'));
+    return {
+        mode,
+        gateway: process.env.ABX_IPFS_GATEWAY ?? (mode === 'pinata' ? 'https://gateway.pinata.cloud' : 'http://127.0.0.1:8080'),
+        apiUrl: process.env.ABX_IPFS_API_URL ?? 'http://127.0.0.1:5001',
+        pinataEndpoint: process.env.ABX_PINATA_ENDPOINT ?? 'https://api.pinata.cloud',
+        pinataJwt: process.env.PINATA_JWT,
+    };
+}
+//# sourceMappingURL=ipfs.js.map

package/dist/ipfs.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,29 @@
+import { type CloudStorageConfig } from './cloud.js';
+import { type IpfsConfig } from './ipfs.js';
+import { type ArweaveConfig } from './arweave.js';
+import type { StorageBackend } from './backend.js';
+export interface ResolveStorageOptions {
+    /** Backend id; defaults to `ABX_STORAGE_BACKEND`, then `fs`. */
+    backend?: string;
+    /** Data directory for the `fs` backend and the `ipfs` content index. */
+    dataDir?: string;
+    /** Full cloud config (the CLI merges non-secret config + env secrets). Falls back to env. */
+    cloud?: CloudStorageConfig;
+    /** Full IPFS config (the CLI merges non-secret config + env secrets). Falls back to env. */
+    ipfs?: IpfsConfig;
+    /** Full Arweave config (the CLI merges non-secret config + env secrets). Falls back to env. */
+    arweave?: ArweaveConfig;
+}
+/**
+ * Pick a storage backend. Built backends: **`fs`** (local disk, zero-dep floor) ·
+ * **`cloud`** / `s3` (S3-compatible: AWS S3, R2, B2, MinIO) · **`ipfs`** (self-hosted
+ * Kubo node or managed Pinata). Each implements the same {@link StorageBackend}
+ * interface, so the indexer and token API never change. Non-secret config is passed
+ * in via `opts` (the CLI resolves it from flags → env → default); secrets come from env.
+ * With no `opts`, every backend falls back to building entirely from env.
+ *
+ * `arweave` is pay-once permanent storage — retrieval dep-free via a gateway,
+ * upload through an injectable bundler.
+ */
+export declare function resolveBackend(opts?: ResolveStorageOptions): StorageBackend;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAiC,KAAK,UAAU,EAAC,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAuC,KAAK,aAAa,EAAC,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,4FAA4F;IAC5F,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,cAAc,CAkB/E"}

package/dist/resolve.js

@@ -0,0 +1,43 @@
+import { LocalFsBackend } from './fs.js';
+import { CloudStorageBackend, cloudConfigFromEnv } from './cloud.js';
+import { IpfsBackend, ipfsConfigFromEnv } from './ipfs.js';
+import { ArweaveBackend, arweaveConfigFromEnv } from './arweave.js';
+function assertCloud(cfg) {
+    const missing = ['endpoint', 'bucket', 'accessKeyId', 'secretAccessKey'].filter((k) => !cfg[k]);
+    if (missing.length) {
+        throw new Error(`Cloud storage is missing ${missing.join(', ')}. Pass non-secret values as flags ` +
+            `(\`--backend cloud --endpoint <url> --bucket <b> --region <r>\`) or set env vars ` +
+            `(ABX_S3_ENDPOINT / ABX_S3_BUCKET / ABX_S3_REGION); credentials in .env (ABX_S3_ACCESS_KEY_ID / ABX_S3_SECRET_ACCESS_KEY).`);
+    }
+}
+/**
+ * Pick a storage backend. Built backends: **`fs`** (local disk, zero-dep floor) ·
+ * **`cloud`** / `s3` (S3-compatible: AWS S3, R2, B2, MinIO) · **`ipfs`** (self-hosted
+ * Kubo node or managed Pinata). Each implements the same {@link StorageBackend}
+ * interface, so the indexer and token API never change. Non-secret config is passed
+ * in via `opts` (the CLI resolves it from flags → env → default); secrets come from env.
+ * With no `opts`, every backend falls back to building entirely from env.
+ *
+ * `arweave` is pay-once permanent storage — retrieval dep-free via a gateway,
+ * upload through an injectable bundler.
+ */
+export function resolveBackend(opts = {}) {
+    const id = opts.backend ?? process.env.ABX_STORAGE_BACKEND ?? 'fs';
+    switch (id) {
+        case 'fs':
+            return new LocalFsBackend(opts.dataDir);
+        case 'cloud':
+        case 's3': {
+            const cfg = opts.cloud ?? cloudConfigFromEnv();
+            assertCloud(cfg);
+            return new CloudStorageBackend(cfg);
+        }
+        case 'ipfs':
+            return new IpfsBackend(opts.ipfs ?? ipfsConfigFromEnv(), opts.dataDir);
+        case 'arweave':
+            return new ArweaveBackend(opts.arweave ?? arweaveConfigFromEnv(), opts.dataDir);
+        default:
+            throw new Error(`Unknown storage backend '${id}'. Built: fs | cloud (alias s3) | ipfs | arweave.`);
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAA0B,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAkB,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAqB,MAAM,cAAc,CAAC;AAgBtF,SAAS,WAAW,CAAC,GAAuB;IAC1C,MAAM,OAAO,GAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,CAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,4BAA4B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC;YAChF,mFAAmF;YACnF,2HAA2H,CAC9H,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B,EAAE;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC;IACnE,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,IAAI;YACP,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,OAAO,CAAC;QACb,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,kBAAkB,EAAE,CAAC;YAC/C,WAAW,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,iBAAiB,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACzE,KAAK,SAAS;YACZ,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,IAAI,oBAAoB,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,mDAAmD,CAAC,CAAC;IACvG,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@artblocks/abx-storage",
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "description": "ABX Self-Host Toolkit (Layer 3) — the reference byte-custody / storage service. Holds the source-of-truth bytes a token's content commitment points at, content-addressed by hash, behind a pluggable backend interface.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArtBlocks/abx.git",
+    "directory": "packages/storage"
+  },
+  "homepage": "https://github.com/ArtBlocks/abx#readme",
+  "bugs": "https://github.com/ArtBlocks/abx/issues",
+  "keywords": [
+    "abx",
+    "nft",
+    "storage",
+    "ipfs",
+    "arweave",
+    "art-blocks"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "viem": "^2.21.0",
+    "@artblocks/abx-sdk": "0.1.0-alpha.0"
+  },
+  "optionalDependencies": {
+    "@ardrive/turbo-sdk": "^1.23.0",
+    "@dha-team/arbundles": "^1.0.4"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json"
+  },
+  "types": "./dist/index.d.ts"
+}