@artblocks/abx-cli 0.1.0-alpha.0

package/dist/migrate.js

@@ -0,0 +1,180 @@
+/**
+ * Migrate a contract's OFF-CHAIN operator state from one resolver to another — the
+ * toolkit's portability guarantee, made operational.
+ *
+ * Everything on-chain a new resolver gets for free: it replays the event spine from any
+ * RPC (that's what the admin control plane's `POST /admin/projects` already does). The only
+ * thing it can't reconstruct from chain is the operator's off-chain state — the four fields
+ * on the registration row: `description`, `externalUrl`, off-chain `attributes`, and the
+ * `keccak → gateway-URL` content locators.
+ *
+ * The key property: each resolver's served JSON is **self-describing** via `abx_provenance`,
+ * which makes it self-MIGRATING. By reading the SOURCE resolver's public token/contract API
+ * (plus the chain, for the locator KEYS — the on-chain hashes, which aren't in any served
+ * JSON), we reconstruct exactly that off-chain state and bridge it to the destination through
+ * the same control plane. The two resolvers never talk to each other; the operator's CLI
+ * orchestrates from public endpoints alone — no shared database, no private channel.
+ *
+ * Two cases this can't paper over, both surfaced honestly:
+ *  - **Stitched attributes** — an off-chain trait shadowed by an on-chain one of the same
+ *    `trait_type` was never *served*, so it can't be recovered. We migrate the off-chain
+ *    remainder (served traits whose `trait_type` has no on-chain entry), which is byte-exact
+ *    for everything that was ever visible.
+ *  - **Node-custody images** — an image committed by hash but never pinned to a durable
+ *    backend is served from the source node's own `/image` route. There's no portable URL to
+ *    copy; the bytes live only on the old host. We list these so the operator re-pins them
+ *    (fetch → verify against the on-chain hash → re-upload) BEFORE tearing the old host down.
+ */
+import { fieldOf, inlineText, normalizeAttributes, METADATA_REPRESENTATION as R } from '@artblocks/abx-sdk';
+import { hashContent } from '@artblocks/abx-storage';
+const trim = (base) => base.replace(/\/+$/, '');
+export const tokenApiUrl = (base, chainId, addr, id) => `${trim(base)}/t/${chainId}/${addr.toLowerCase()}/${id}`;
+export const contractApiUrl = (base, chainId, addr) => `${trim(base)}/c/${chainId}/${addr.toLowerCase()}`;
+async function getJson(url) {
+    let resp;
+    try {
+        resp = await fetch(url);
+    }
+    catch (err) {
+        throw new Error(`couldn't reach the source resolver at ${url}: ${err.message}`);
+    }
+    if (resp.status === 404)
+        return null; // unknown project / unminted token — not fatal per-token
+    if (!resp.ok)
+        throw new Error(`source resolver ${url} → ${resp.status} ${resp.statusText}`);
+    return (await resp.json());
+}
+const provOf = (json, field) => json?.abx_provenance?.find((p) => p.field === field);
+/** Off-chain attribute trait_types present on-chain (case-insensitive) — these are NOT migrated as
+ *  off-chain (the destination re-derives them from chain and they win the stitch). */
+function onChainTraitTypes(fields) {
+    const entry = fieldOf(fields, 'attributes');
+    if (!entry || entry.representation !== R.inline)
+        return new Set();
+    try {
+        const parsed = JSON.parse(inlineText(entry));
+        if (!Array.isArray(parsed))
+            return new Set();
+        return new Set(parsed.map((a) => String(a.trait_type).toLowerCase()));
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Build the migration plan by reading the SOURCE resolver's public API, using the locally
+ * reconstructed on-chain state (`local`) for the hash KEYS the served JSON doesn't expose.
+ */
+export async function buildMigrationPlan(sourceBase, chainId, local) {
+    const addr = local.address;
+    const plan = { contentLocators: {}, nodeCustody: [], tokensRead: 0 };
+    // ── operator-level fields (one registration row applies across the collection) ──
+    // Prefer the contract API; fall back to token #0. Take a value only when its provenance
+    // says it's off-chain (a plain operator value) — on-chain values are re-derived by replay.
+    const contractJson = await getJson(contractApiUrl(sourceBase, chainId, addr));
+    const firstToken = local.tokens.find((t) => t.minted) ?? local.tokens[0];
+    const tokenZeroJson = firstToken
+        ? await getJson(tokenApiUrl(sourceBase, chainId, addr, firstToken.tokenId))
+        : null;
+    const offChainText = (json, field, value) => (value != null && provOf(json, field)?.status === 'off-chain' ? value : undefined);
+    plan.description =
+        offChainText(tokenZeroJson, 'description', tokenZeroJson?.description) ??
+            offChainText(contractJson, 'description', contractJson?.description);
+    plan.externalUrl =
+        offChainText(tokenZeroJson, 'external_url', tokenZeroJson?.external_url) ??
+            offChainText(contractJson, 'external_link', contractJson?.external_link);
+    // attributes: the off-chain remainder = served traits whose trait_type has NO on-chain entry.
+    if (tokenZeroJson?.attributes?.length && provOf(tokenZeroJson, 'attributes')?.status !== 'on-chain') {
+        const onChain = onChainTraitTypes(firstToken?.fields ?? []);
+        const offChain = tokenZeroJson.attributes.filter((a) => !onChain.has(String(a.trait_type).toLowerCase()));
+        if (offChain.length)
+            plan.attributes = normalizeAttributes(offChain);
+    }
+    // ── per-token content locators (image bytes that live off-chain by hash) ──
+    for (const token of local.tokens) {
+        const image = fieldOf(token.fields, 'image');
+        if (!image || (image.representation !== R.keccak256 && image.representation !== R.sha256)) {
+            continue; // on-chain content or an on-chain locator — the destination derives it from chain
+        }
+        const json = await getJson(tokenApiUrl(sourceBase, chainId, addr, token.tokenId));
+        if (!json)
+            continue; // unminted / not served
+        plan.tokensRead++;
+        const prov = provOf(json, 'image');
+        const hash = image.value.toLowerCase();
+        // A durable locator: the resolver served a portable URL (ipfs/arweave/url source). Node-custody:
+        // the source served the bytes from its own host (source === the hash kind), so there's nothing to copy.
+        if (json.image && prov && prov.onChain === false && (prov.source === 'ipfs' || prov.source === 'arweave' || prov.source === 'url')) {
+            plan.contentLocators[hash] = json.image;
+        }
+        else if (json.image) {
+            plan.nodeCustody.push({ tokenId: token.tokenId, hash, imageUrl: json.image });
+        }
+    }
+    return plan;
+}
+export async function repinNodeCustody(images, backend) {
+    const result = { repinned: {}, repinnedTokens: [], mismatched: [], unreachable: [], needsDurableBackend: [] };
+    if (!images.length)
+        return result;
+    // A backend is "durable" for migration iff it can hand back a node-independent locator.
+    if (!backend.locator) {
+        result.needsDurableBackend = [...images];
+        return result;
+    }
+    for (const img of images) {
+        let bytes;
+        let contentType;
+        try {
+            const resp = await fetch(img.imageUrl);
+            if (!resp.ok) {
+                result.unreachable.push(img);
+                continue;
+            }
+            bytes = new Uint8Array(await resp.arrayBuffer());
+            contentType = resp.headers.get('content-type') ?? 'application/octet-stream';
+        }
+        catch {
+            result.unreachable.push(img);
+            continue;
+        }
+        // Trustless: re-hash the fetched bytes and compare to the ON-CHAIN commitment.
+        if (hashContent(bytes).toLowerCase() !== img.hash.toLowerCase()) {
+            result.mismatched.push(img);
+            continue;
+        }
+        await backend.put(img.hash, { bytes, contentType });
+        const loc = await backend.locator(img.hash);
+        if (loc) {
+            result.repinned[img.hash.toLowerCase()] = loc;
+            result.repinnedTokens.push(img.tokenId);
+        }
+        else {
+            // Stored, but the backend still can't produce a portable locator — treat as not durable.
+            result.needsDurableBackend.push(img);
+        }
+    }
+    return result;
+}
+const sameAttrs = (a = [], b = []) => {
+    const key = (xs) => xs
+        .map((x) => `${String(x.trait_type).toLowerCase()}=${String(x.value)}`)
+        .sort()
+        .join('|');
+    return key(a) === key(b);
+};
+export async function verifyParity(sourceBase, destBase, chainId, addr, tokenId) {
+    const [src, dst] = await Promise.all([
+        getJson(tokenApiUrl(sourceBase, chainId, addr, tokenId)),
+        getJson(tokenApiUrl(destBase, chainId, addr, tokenId)),
+    ]);
+    return {
+        tokenId,
+        imageMatch: !!src && !!dst && src.image === dst.image,
+        descriptionMatch: (src?.description ?? null) === (dst?.description ?? null),
+        attributesMatch: sameAttrs(src?.attributes, dst?.attributes),
+        sourceImage: src?.image,
+        destImage: dst?.image,
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/mintpage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mint-page scaffolding — a **self-contained** Next.js starter a creator stands up to sell a drop,
+ * compatible with the shared {AbxFixedPriceMinter}. The sibling of `deploy-resolver`: a buildable
+ * artifact the creator OWNS and customizes (with the agent's help), not a service we run.
+ *
+ * SELF-CONTAINED + BACKEND-FREE by design:
+ *   - Reads live sale state (price · sold/allocation · paused · supply) straight from chain, and each
+ *     token's image/name from `tokenURI(id)` — no server, no database. Fully-on-chain collections need
+ *     nothing else; off-chain ones rely on their `tokenURI` resolving (same as any marketplace).
+ *   - Wallet connect + mint use viem + the injected browser wallet (`window.ethereum`) — NO API keys,
+ *     no WalletConnect projectId. The README shows how to swap in RainbowKit for multi-wallet.
+ *   - Reads use a PUBLIC RPC (never the creator's keyed endpoint — that would leak a secret into a
+ *     `NEXT_PUBLIC_` var); the mint tx uses the wallet's own RPC. Config rides `NEXT_PUBLIC_*` env vars,
+ *     prefilled by the CLI into `.env.local`.
+ *
+ * V1 scope (deliberately minimal — customize from here): ETH sales, one mint per click, a paginated
+ * gallery of minted tokens. ERC-20 sales (need an `approve` step) are flagged as a customization.
+ *
+ * Pure module: returns the artifact files + the exact next-step commands. The CLI writes the files and
+ * prints the steps; `vercel` / `next dev` run in the creator's own account/machine — they own that step.
+ */
+export interface MintPageOptions {
+    /** The ABX token (collection) contract to sell. */
+    token: string;
+    /** The shared fixed-price minter for the chain. */
+    minter: string;
+    chainId: number;
+    chainName: string;
+    /** A PUBLIC read RPC (no API key — it is embedded in a NEXT_PUBLIC_ var / a public site). */
+    rpcUrl: string;
+    /** Display name for the collection (defaults from the token's on-chain name). */
+    collectionName: string;
+    /** Block explorer base (e.g. https://sepolia.etherscan.io), for a "view contract" link. */
+    explorer?: string;
+}
+export interface MintPageArtifact {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    steps: string[];
+}
+/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added. */
+export declare const PUBLIC_RPC: Record<number, string>;
+export declare function mintPageArtifact(o: MintPageOptions): MintPageArtifact;
+//# sourceMappingURL=mintpage.d.ts.map

package/dist/mintpage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintpage.d.ts","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uFAAuF;AACvF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG7C,CAAC;AAubF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CA0BrE"}