@artblocks/abx-cli 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/mintpage.d.ts

@@ -22,7 +22,8 @@
 export interface MintPageOptions {
     /** The ABX token (collection) contract to sell. */
     token: string;
-    /** The shared fixed-price minter for the chain. */
+    /** The shared fixed-price minter for the chain — the 721 `AbxFixedPriceMinter`, or (when
+     *  {@link isEdition}) its 1155 sibling `AbxFixedPriceMinter1155`. */
     minter: string;
     chainId: number;
     chainName: string;
@@ -32,6 +33,18 @@ export interface MintPageOptions {
     collectionName: string;
     /** Block explorer base (e.g. https://sepolia.etherscan.io), for a "view contract" link. */
     explorer?: string;
+    /**
+     * The target is an ERC-1155 edition (OneOfOneEdition/EditionImage/EditionCode) rather than a 721
+     * Series/SeriesCode — sales are keyed `(token, id)`, so the generated page takes a token-id +
+     * quantity input and pays `price × quantity`, instead of the 721 page's one project-wide sale.
+     *
+     * v1 scope (deliberately minimal — the 721 page's gallery/pagination is NOT ported): a purchase
+     * of "copies" of one id doesn't have the 721 page's "one owner per token" gallery to show, and
+     * building a per-id browsing UI is real design work this pass didn't take on. The purchase
+     * controls (price, sold/allocation, per-id supply/cap, paused) are fully live from chain either
+     * way — just without a tile grid underneath them.
+     */
+    isEdition?: boolean;
 }
 export interface MintPageArtifact {
     files: Array<{
@@ -40,7 +53,9 @@ export interface MintPageArtifact {
     }>;
     steps: string[];
 }
-/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added. */
+/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added.
+ *  base-sepolia is the toolkit's DEFAULT chain — its absence here meant every default-chain
+ *  deploy needed a manual --rpc just to scaffold its own mint page (integrator-reported). */
 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

@@ -1 +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"}
+{"version":3,"file":"mintpage.d.ts","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd;yEACqE;IACrE,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;IAClB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;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;;6FAE6F;AAC7F,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK7C,CAAC;AAqlBF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CA2BrE"}

package/dist/mintpage.js

@@ -19,10 +19,15 @@
  * 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.
  */
-/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added. */
+import { readSdkVersion } from './update-check.js';
+/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added.
+ *  base-sepolia is the toolkit's DEFAULT chain — its absence here meant every default-chain
+ *  deploy needed a manual --rpc just to scaffold its own mint page (integrator-reported). */
 export const PUBLIC_RPC = {
     1: 'https://ethereum-rpc.publicnode.com',
     11155111: 'https://ethereum-sepolia-rpc.publicnode.com',
+    8453: 'https://mainnet.base.org',
+    84532: 'https://sepolia.base.org',
 };
 const slug = (s) => s
     .toLowerCase()
@@ -43,6 +48,11 @@ function packageJson(o) {
             react: '^19.0.0',
             'react-dom': '^19.0.0',
             viem: '^2.21.0',
+            // Pinned to THIS CLI's own version, caret-ranged — the CLI and sdk version-bump together in
+            // this repo's changesets flow, so "the version that scaffolded this app" is exactly the
+            // floor that's guaranteed to have makePublicClient/readSaleConfig/the `/abi` subpath (this
+            // refactor). INVARIANT: an sdk older than that will be missing one of those exports.
+            '@artblocks/abx-sdk': '^' + readSdkVersion(),
         },
         devDependencies: {
             typescript: '^5.6.0',
@@ -130,55 +140,63 @@ export const chain = defineChain({
   rpcUrls: {default: {http: [RPC_URL]}},
 });
 `;
-const LIB_ABI = `// Minimal ABIs — only what the mint page reads/writes.
-export const minterAbi = [
-  {
-    type: 'function',
-    name: 'sales',
-    stateMutability: 'view',
-    inputs: [{name: 'token', type: 'address'}],
-    outputs: [
-      {name: 'configured', type: 'bool'},
-      {name: 'paymentToken', type: 'address'},
-      {name: 'price', type: 'uint256'},
-      {name: 'allocation', type: 'uint256'},
-      {name: 'sold', type: 'uint256'},
-    ],
-  },
-  {type: 'function', name: 'purchase', stateMutability: 'payable', inputs: [{name: 'token', type: 'address'}], outputs: [{name: 'tokenId', type: 'uint256'}]},
-  {type: 'function', name: 'purchaseTo', stateMutability: 'payable', inputs: [{name: 'token', type: 'address'}, {name: 'to', type: 'address'}], outputs: [{name: 'tokenId', type: 'uint256'}]},
-] as const;
+const LIB_ABI = `// Minter + token ABIs, sourced from the shared SDK instead of hand-typed here — one definition
+// that tracks the deployed contracts (the ABX repo's 'pnpm sync-abis' regenerates it from the
+// contracts themselves), so this file can never drift the way a hand-copied fragment can.
+//
+// name / totalSupply / maxInvocations / paused / tokenURI are identical fragments on every ABX
+// Series contract type (Image or Code) — importing both and spreading is harmless (duplicate
+// fragments, byte-identical shape) and keeps this working whichever Series type backs your
+// collection, without this app needing to know which one it is.
+// (A rename re-export — 'export {x as y} from …' — of a subpath import tripped up Next's bundler
+// here; a plain import + local const assignment is the form that survives the production build.)
+import {abxFixedPriceMinterAbi, seriesImageAbi, seriesCodeAbi} from '@artblocks/abx-sdk/abi';
 
-export const tokenAbi = [
-  {type: 'function', name: 'name', stateMutability: 'view', inputs: [], outputs: [{type: 'string'}]},
-  {type: 'function', name: 'totalSupply', stateMutability: 'view', inputs: [], outputs: [{type: 'uint256'}]},
-  {type: 'function', name: 'maxInvocations', stateMutability: 'view', inputs: [], outputs: [{type: 'uint256'}]},
-  {type: 'function', name: 'paused', stateMutability: 'view', inputs: [], outputs: [{type: 'bool'}]},
-  {type: 'function', name: 'tokenURI', stateMutability: 'view', inputs: [{name: 'id', type: 'uint256'}], outputs: [{type: 'string'}]},
-] as const;
+export const minterAbi = abxFixedPriceMinterAbi;
+export const tokenAbi = [...seriesImageAbi, ...seriesCodeAbi] as const;
+`;
+// The edition twin of LIB_ABI — same reasoning (one SDK-sourced definition, never hand-typed), the
+// 1155 sale singleton + the narrowest-common-superset edition token ABI (covers OneOfOneEdition/
+// EditionImage/EditionCode — see the SDK's ops.ts for why one ABI serves the whole family).
+const LIB_ABI_EDITION = `// Minter + token ABIs for an EDITION target (ERC-1155 copies) — see the non-edition lib/abi.ts's
+// twin for the "why sourced from the SDK, never hand-typed" note.
+import {abxFixedPriceMinter1155Abi, oneOfOneEditionAbi} from '@artblocks/abx-sdk/abi';
+
+export const minterAbi = abxFixedPriceMinter1155Abi;
+export const tokenAbi = oneOfOneEditionAbi;
 `;
 const LIB_META = `// Read a token's image + name from tokenURI(id), directly from chain. Handles data: URIs
 // (on-chain tokens) and http/ipfs/ar locators (off-chain custody). No backend.
-import {createPublicClient, http} from 'viem';
-import {chain} from './chain';
-import {TOKEN} from './config';
+//
+// The read client is the SDK's browser-safe makePublicClient, given an EXPLICIT rpcUrls list —
+// never env resolution (there is no server .env in a static site, and the SDK's own
+// ABX_RPC_URLS/ABX_CHAIN conventions would silently no-op in a browser bundle anyway; an explicit
+// override short-circuits that lookup entirely). One URL behaves exactly like a plain http()
+// transport; paste a comma-separated NEXT_PUBLIC_RPC_URL to get the same fallback-transport
+// failover the CLI/indexer get. Its attached chain metadata is the SDK's own default and is
+// informational only for these plain reads — the WALLET's chain (used for the mint tx) is the one
+// built in ./chain from your real NEXT_PUBLIC_CHAIN_ID/NAME, unaffected by this.
+//
+// Gateway + data: URI parsing go through the SAME sdk helpers the CLI/indexer use
+// (gatewayUrlFor/resolveGatewayBase, parseDataUri) instead of a hand-rolled 'ipfs://'-slicing body —
+// one implementation of "how to read a locator" instead of this app quietly re-deriving its own.
+import {makePublicClient, gatewayUrlFor, resolveGatewayBase, parseDataUri} from '@artblocks/abx-sdk';
+import {RPC_URL, TOKEN} from './config';
 import {tokenAbi} from './abi';
 
-export const publicClient = createPublicClient({chain, transport: http()});
+export const publicClient = makePublicClient({rpcUrls: RPC_URL.split(',').map((u) => u.trim()).filter(Boolean)});
 
 export function toGateway(u: string): string {
   if (!u) return '';
-  if (u.startsWith('ipfs://')) return 'https://ipfs.io/ipfs/' + u.slice(7);
-  if (u.startsWith('ar://')) return 'https://arweave.net/' + u.slice(5);
+  if (u.startsWith('ipfs://')) return gatewayUrlFor('ipfs', u.slice(7), resolveGatewayBase('ipfs'));
+  if (u.startsWith('ar://')) return gatewayUrlFor('arweave', u.slice(5), resolveGatewayBase('arweave'));
   return u;
 }
 
 async function fetchJson(uri: string): Promise<any> {
-  if (uri.startsWith('data:')) {
-    const comma = uri.indexOf(',');
-    const header = uri.slice(5, comma);
-    const body = uri.slice(comma + 1);
-    const text = header.includes('base64') ? atob(body) : decodeURIComponent(body);
+  const parsed = parseDataUri(uri);
+  if (parsed) {
+    const text = parsed.base64 ? atob(parsed.body) : decodeURIComponent(parsed.body);
     return JSON.parse(text);
   }
   const res = await fetch(toGateway(uri));
@@ -252,22 +270,15 @@ const APP_MINT_CLIENT = `'use client';
 import {useCallback, useEffect, useState} from 'react';
 import {createWalletClient, custom, formatEther} from 'viem';
 import {chain} from '../lib/chain';
+import {readSaleConfig, type SaleConfig} from '@artblocks/abx-sdk';
 import {CHAIN_ID, CHAIN_NAME, COLLECTION_NAME, EXPLORER, MINTER, PAGE_SIZE, TOKEN} from '../lib/config';
 import {minterAbi, tokenAbi} from '../lib/abi';
 import {publicClient, readTokenMeta, type TokenMeta} from '../lib/meta';
 
 const ZERO = '0x0000000000000000000000000000000000000000';
 
-interface Sale {
-  configured: boolean;
-  paymentToken: string;
-  price: bigint;
-  allocation: bigint;
-  sold: bigint;
-}
-
 export default function Mint() {
-  const [sale, setSale] = useState<Sale | null>(null);
+  const [sale, setSale] = useState<SaleConfig | null>(null);
   const [supply, setSupply] = useState(0);
   const [maxInv, setMaxInv] = useState(0);
   const [paused, setPaused] = useState(false);
@@ -278,8 +289,7 @@ export default function Mint() {
   const [msg, setMsg] = useState('');
 
   const refresh = useCallback(async () => {
-    const s = (await publicClient.readContract({address: MINTER, abi: minterAbi, functionName: 'sales', args: [TOKEN]})) as any;
-    setSale({configured: s[0], paymentToken: s[1], price: s[2], allocation: s[3], sold: s[4]});
+    setSale(await readSaleConfig(publicClient, MINTER, TOKEN));
     const [ts, mx, pz] = await Promise.all([
       publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'totalSupply'}),
       publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'maxInvocations'}),
@@ -406,6 +416,156 @@ export default function Mint() {
   );
 }
 `;
+// The edition twin of APP_MINT_CLIENT — a token-id + quantity purchase against the shared 1155
+// minter (sales are keyed (token, id)), price × quantity computed live. No gallery/pagination (see
+// MintPageOptions.isEdition's own scope note) — the purchase controls are the whole page.
+const APP_MINT_CLIENT_EDITION = `'use client';
+import {useCallback, useEffect, useState} from 'react';
+import {createWalletClient, custom, formatEther} from 'viem';
+import {chain} from '../lib/chain';
+import {readSaleConfig1155, type SaleConfig1155} from '@artblocks/abx-sdk';
+import {CHAIN_ID, CHAIN_NAME, COLLECTION_NAME, EXPLORER, MINTER, TOKEN} from '../lib/config';
+import {minterAbi, tokenAbi} from '../lib/abi';
+import {publicClient} from '../lib/meta';
+
+const ZERO = '0x0000000000000000000000000000000000000000';
+
+export default function Mint() {
+  const [tokenId, setTokenId] = useState(0);
+  const [quantity, setQuantity] = useState(1);
+  const [sale, setSale] = useState<SaleConfig1155 | null>(null);
+  const [supply, setSupply] = useState(0);
+  const [maxSupply, setMaxSupply] = useState(0);
+  const [paused, setPaused] = useState(false);
+  const [account, setAccount] = useState<string>('');
+  const [busy, setBusy] = useState(false);
+  const [msg, setMsg] = useState('');
+
+  const refresh = useCallback(async (id: number) => {
+    const [s, ts, ms, pz] = await Promise.all([
+      readSaleConfig1155(publicClient, MINTER, TOKEN, BigInt(id)),
+      publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'totalSupply', args: [BigInt(id)]}),
+      publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'maxSupply', args: [BigInt(id)]}),
+      publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'paused'}),
+    ]);
+    setSale(s);
+    setSupply(Number(ts));
+    setMaxSupply(Number(ms));
+    setPaused(Boolean(pz));
+  }, []);
+
+  useEffect(() => {
+    refresh(tokenId).catch((e) => setMsg(String(e)));
+  }, [tokenId, refresh]);
+
+  async function connect() {
+    const eth = (window as any).ethereum;
+    if (!eth) {
+      setMsg('No injected wallet found — install MetaMask (or another browser wallet).');
+      return;
+    }
+    const accts = (await eth.request({method: 'eth_requestAccounts'})) as string[];
+    setAccount(accts[0] || '');
+    try {
+      await eth.request({method: 'wallet_switchEthereumChain', params: [{chainId: '0x' + CHAIN_ID.toString(16)}]});
+    } catch (e) {
+      /* user can switch manually; the mint call will surface a wrong-network error */
+    }
+  }
+
+  async function mint() {
+    if (!sale) return;
+    const eth = (window as any).ethereum;
+    if (!eth || !account) return connect();
+    setBusy(true);
+    setMsg('');
+    try {
+      const wallet = createWalletClient({account: account as any, chain, transport: custom(eth)});
+      const value = sale.price * BigInt(quantity);
+      const hash = await wallet.writeContract({
+        address: MINTER,
+        abi: minterAbi,
+        functionName: 'purchase',
+        args: [TOKEN, BigInt(tokenId), BigInt(quantity)],
+        value,
+        account: account as any,
+        chain,
+      });
+      setMsg('Minting… tx ' + hash.slice(0, 10) + '…');
+      await publicClient.waitForTransactionReceipt({hash});
+      setMsg('Minted! ✦');
+      await refresh(tokenId);
+    } catch (e: any) {
+      setMsg(e && e.shortMessage ? e.shortMessage : String(e && e.message ? e.message : e));
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  const isEth = !sale || sale.paymentToken === ZERO;
+  const remaining = maxSupply > 0 ? Math.max(0, maxSupply - supply) : null;
+  const soldOut = !!sale && (sale.sold >= sale.allocation || (remaining !== null && remaining <= 0));
+  const canMint = !!sale && sale.configured && !paused && !soldOut && isEth && !busy && quantity > 0;
+  const totalPrice = sale ? sale.price * BigInt(quantity) : 0n;
+
+  return (
+    <main className="wrap">
+      <div className="row" style={{marginBottom: 20}}>
+        <div>
+          <h1>{COLLECTION_NAME}</h1>
+          <div className="muted">
+            {EXPLORER ? <a href={EXPLORER + '/address/' + TOKEN} target="_blank" rel="noreferrer">contract ↗</a> : TOKEN}
+            {' · '}
+            {CHAIN_NAME}
+            {' · edition (ERC-1155)'}
+          </div>
+        </div>
+        {account ? <span className="muted">{account.slice(0, 6) + '…' + account.slice(-4)}</span> : <button className="ghost" onClick={connect}>Connect wallet</button>}
+      </div>
+
+      <div className="card">
+        <div className="row" style={{marginBottom: 14}}>
+          <label className="muted">
+            Token ID
+            <input
+              type="number"
+              min={0}
+              value={tokenId}
+              onChange={(e) => setTokenId(Math.max(0, Number(e.target.value) || 0))}
+              style={{marginLeft: 8, width: 90}}
+            />
+          </label>
+          <label className="muted">
+            Quantity
+            <input
+              type="number"
+              min={1}
+              value={quantity}
+              onChange={(e) => setQuantity(Math.max(1, Number(e.target.value) || 1))}
+              style={{marginLeft: 8, width: 90}}
+            />
+          </label>
+        </div>
+        <div className="row">
+          <div className="stat">
+            {sale ? <>Price <b>{isEth ? formatEther(sale.price) + ' ETH' : sale.price.toString() + ' units'}</b> / copy</> : 'Loading…'}
+            {sale ? <> &nbsp;·&nbsp; Total <b>{isEth ? formatEther(totalPrice) + ' ETH' : totalPrice.toString() + ' units'}</b></> : null}
+            {sale ? <> &nbsp;·&nbsp; Sold <b>{sale.sold.toString()}/{sale.allocation.toString()}</b></> : null}
+            {maxSupply > 0 ? <> &nbsp;·&nbsp; Copies <b>{supply}/{maxSupply}</b></> : <> &nbsp;·&nbsp; Copies <b>{supply}</b> (open)</>}
+            {' '}
+            <span className={'pill ' + (paused || soldOut ? 'closed' : 'open')}>{soldOut ? 'sold out' : paused ? 'paused' : 'open'}</span>
+          </div>
+          <button onClick={mint} disabled={!canMint}>
+            {busy ? 'Minting…' : soldOut ? 'Sold out' : paused ? 'Paused' : !isEth ? 'ERC-20 — see README' : account ? 'Mint' : 'Connect & mint'}
+          </button>
+        </div>
+        {msg ? <div className="muted" style={{marginTop: 12}}>{msg}</div> : null}
+        {sale && !sale.configured ? <div className="muted" style={{marginTop: 12}}>No sale configured yet for id #{tokenId}.</div> : null}
+      </div>
+    </main>
+  );
+}
+`;
 function readme(o) {
     return ('# ' +
         o.collectionName +
@@ -428,10 +588,12 @@ function readme(o) {
         '- **Multi-wallet** — V1 uses the injected wallet (`window.ethereum`) with zero config. For WalletConnect/Coinbase/etc., swap in [RainbowKit](https://rainbowkit.com) + wagmi (needs a WalletConnect projectId).\n' +
         '- **ERC-20 sales** — the mint button handles ETH. For an ERC-20-priced sale, add an `approve(minter, price)` step before `purchase` (see `lib/abi.ts`).\n' +
         '- **RPC** — `NEXT_PUBLIC_RPC_URL` is a public endpoint (may rate-limit). Use your own **keyless** endpoint if you like; never put a secret-keyed URL in a `NEXT_PUBLIC_` var — it ships to the browser.\n' +
-        '- **Gallery** — shows minted tokens newest-first, ' +
-        'paginated. It reads `tokenURI(id)`; on-chain collections resolve with no backend, off-chain ones need their resolver/gateway reachable.\n');
+        (o.isEdition
+            ? '- **Gallery** — NOT included for an edition (v1 scope). Sales are keyed `(token, id)` — a "copies of one id" page has no single "minted tokens" list the way a 721 Series does; the purchase card (price, sold/allocation, per-id supply/cap, paused) is fully live from chain. Add a gallery yourself (or ask your agent) if you want one — e.g. loop `uri(id)` over the id range you care about.\n'
+            : '- **Gallery** — shows minted tokens newest-first, paginated. It reads `tokenURI(id)`; on-chain collections resolve with no backend, off-chain ones need their resolver/gateway reachable.\n'));
 }
 export function mintPageArtifact(o) {
+    const isEdition = !!o.isEdition;
     return {
         files: [
             { path: 'package.json', content: packageJson(o) },
@@ -443,12 +605,12 @@ export function mintPageArtifact(o) {
             { path: '.env.example', content: envFile({ ...o, token: '0xYourCollection', minter: o.minter }) },
             { path: 'lib/config.ts', content: LIB_CONFIG },
             { path: 'lib/chain.ts', content: LIB_CHAIN },
-            { path: 'lib/abi.ts', content: LIB_ABI },
+            { path: 'lib/abi.ts', content: isEdition ? LIB_ABI_EDITION : LIB_ABI },
             { path: 'lib/meta.ts', content: LIB_META },
             { path: 'app/globals.css', content: APP_GLOBALS },
             { path: 'app/layout.tsx', content: APP_LAYOUT },
             { path: 'app/page.tsx', content: APP_PAGE },
-            { path: 'app/mint-client.tsx', content: APP_MINT_CLIENT },
+            { path: 'app/mint-client.tsx', content: isEdition ? APP_MINT_CLIENT_EDITION : APP_MINT_CLIENT },
             { path: 'README.md', content: readme(o) },
         ],
         steps: [

package/dist/mintpage.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,148 @@
+import { SelfHostIndexer } from '@artblocks/abx-indexer';
+import { type Address, type ProjectState, type PublicClient, type SendTx } from '@artblocks/abx-sdk';
+import { type Flags } from './flags.js';
+export declare const c: {
+    reset: string;
+    dim: string;
+    bold: string;
+    green: string;
+    purple: string;
+    orange: string;
+    red: string;
+};
+export declare const g: (s: string) => string;
+export declare const p: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare let stepN: number;
+export declare const step: (s: string) => void;
+export declare const ok: (s: string) => void;
+export declare const info: (s: string) => void;
+export declare const warn: (s: string) => void;
+export declare function allowLargeScan(flags: Flags): void;
+/**
+ * Resolve the scan floor (fromBlock) for an add/index — the CLI-side shell around the SDK's
+ * {@link sdkResolveScanFloor}: builds the client, forwards `--from-block`, and narrates its two
+ * possible events (the SDK never prints). See the SDK function's doc comment for the "why" (never
+ * a silent genesis default).
+ */
+export declare function resolveScanFloor(address: Address, localFromBlock: string | undefined, flags: Flags): Promise<string>;
+/**
+ * The trust-anchor gate: a factory is THE address platforms allowlist by, so a missing
+ * manifest entry must NEVER silently mint a new "canonical" — that fragments trust (and
+ * a stale SDK would duplicate factories on real chains). Degrade to guidance; deploying
+ * a private trust anchor is an explicit choice (`--bootstrap-factory`).
+ */
+export declare function refuseMissingFactory(kind: string, envVar: string, reason: string): never;
+/** A `SendTx` that defers `makeWalletClient`/`makeHotSender` construction until the first actual
+ *  send — trust-anchor bootstrap is rare (an existing, current anchor is the common case), so the
+ *  happy path must never require a signing key. Memoized so a multi-tx bootstrap (the SeriesCode
+ *  factory: 2 libraries + the linked factory itself) reuses ONE sender — and its nonce tracking —
+ *  rather than a fresh one per send. */
+export declare function lazyBootstrapSender(publicClient: PublicClient): SendTx;
+/** Get (or deploy) the chain's canonical 1/1 clone factory — narrates the SDK's `ensureFactory`
+ *  (anchors.ts), which owns the resolve/verify/bootstrap logic; this keeps only the exact console
+ *  output plus the exit-messaging refusal (`refuseMissingFactory`), which stays CLI-side since the
+ *  SDK doesn't know a UX's flag names. `quiet` suppresses only the happy-path reuse line (the demo
+ *  resolves the factory without making a teaching moment of it) — everything else always prints. */
+export declare function ensureFactory(override?: string, allowBootstrap?: boolean, quiet?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's `SeriesImageFactory` — the sibling of {@link ensureFactory}.
+ *  Narrates the SDK's `ensureSeriesFactory` (anchors.ts), which owns the resolve/verify/bootstrap
+ *  logic. */
+export declare function ensureSeriesFactory(override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's shared `AbxMetadataRenderer` — narrates the SDK's `ensureRenderer`
+ *  (anchors.ts), which also self-heals to the CREATE2-deterministic address before deploying. No
+ *  `allowBootstrap` gate here (unlike the three clone factories) — the renderer isn't a platform
+ *  allowlist entry, so there's nothing to refuse; a stale/missing one always just gets redeployed. */
+export declare function ensureRenderer(override?: string): Promise<Address>;
+/** The code-project trust anchor — narrates the SDK's `ensureSeriesCodeFactory` (anchors.ts),
+ *  which owns the resolve/bootstrap logic (a sandbox / fresh chain links + deploys the two
+ *  write-path libraries then the factory in-flight; see {@link deploySeriesCodeFactory}). */
+export declare function ensureSeriesCodeFactory(publicClient: PublicClient, override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's canonical 1/1-edition clone factory — narrates the SDK's
+ *  `ensureOneOfOneEditionFactory` (anchors.ts), the edition twin of {@link ensureFactory}. */
+export declare function ensureOneOfOneEditionFactory(override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's `EditionImageFactory` — narrates the SDK's `ensureEditionFactory`
+ *  (anchors.ts), the edition twin of {@link ensureSeriesFactory}. */
+export declare function ensureEditionFactory(override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** The code-project EDITION trust anchor — narrates the SDK's `ensureEditionCodeFactory`
+ *  (anchors.ts), the edition twin of {@link ensureSeriesCodeFactory} (three linked libraries
+ *  instead of two — see `deployEditionCodeFactory`'s doc note). */
+export declare function ensureEditionCodeFactory(publicClient: PublicClient, override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** The canonical seed source — narrates the SDK's `ensureSeedSource` (anchors.ts): a clean keyless
+ *  singleton (like the renderer / chunk store / minter), so CREATE2 lands at THE canonical address
+ *  on any chain. Resolves from the manifest, self-heals to the predicted address (deployed but not
+ *  yet repointed), else auto-deploys via CREATE2. */
+export declare function ensureSeedSource(publicClient: PublicClient): Promise<Address>;
+/**
+ * Refuse a port that's already bound, with a formatted one-liner naming the port and the fix.
+ *
+ * Without this, `listen()` has no `'error'` handler and EADDRINUSE reaches Node's default handler:
+ * the creator gets a raw stack trace through `node:net` and our own `dist/` paths, which reads as a
+ * crash inside abx rather than "something else is on this port" — and it's the one unformatted error
+ * surface in a CLI where every other error is formatted. `preview`'s default port colliding with a
+ * studio left running in another terminal was reported as especially hard to diagnose.
+ */
+export declare function assertPortFree(port: number, cmd: string): Promise<void>;
+/** Is a TCP port already bound on localhost? Used to preflight a serve BEFORE spending a tx. */
+export declare function portInUse(port: number): Promise<boolean>;
+/**
+ * Index a project we *just* deployed — and don't believe a zero.
+ *
+ * `eth_getLogs` is read-after-write inconsistent on load-balanced RPCs: `waitForTransactionReceipt`
+ * resolves against a node that has the block, then the log query lands on one that doesn't yet, and
+ * returns an empty set for a block we KNOW contains our deploy. The old code took that single read at
+ * face value, printed `✓ reconstructed 0 events`, stored the empty projection, and served an empty
+ * dashboard — a first-run that looks like the toolkit simply doesn't work. It reproduced 100% of the
+ * time on `https://sepolia.base.org`, which is the DEFAULT endpoint when there's no `.env`, i.e. the
+ * documented first run was the broken path. The same block returned all 9 logs seconds later.
+ *
+ * We have the one thing that makes this checkable: we just minted, so the spine cannot be empty.
+ * So verify instead of trusting — re-scan at a constant delay until events appear, and if they
+ * never do, say so as a FAILURE with the recovery command rather than dressing a zero up as a ✓.
+ */
+export declare function reindexAfterDeploy(indexer: SelfHostIndexer, address: Address, opts?: {
+    attempts?: number;
+    delayMs?: number;
+    readUriDocuments?: boolean;
+}): Promise<{
+    state: ProjectState;
+    elapsedMs: number;
+}>;
+export declare function loadEffects(): Promise<typeof import('@artblocks/abx-effects')>;
+/**
+ * The publish topology's one hard prerequisite, checked BEFORE any capture.
+ *
+ * A resolver that doesn't share this machine's disk serves referenced output (the still, a video, a
+ * model) by **redirect** — so it needs a URL, and it refuses the bytes (`specs/protocol/effects.md →
+ * Bound vs referenced`). A backend that can't name a locator therefore has no publish lane at all,
+ * and every render against one would be work spent to earn a 400.
+ *
+ * So this refuses up front and names the ways out, rather than warning and letting the render run.
+ * It deliberately does NOT pick a backend for the operator: which store holds their art — and which
+ * gateway serves it — is theirs to decide. The three that work are peers, not a ranking: `https://`
+ * from S3/R2, an IPFS gateway, and Arweave are all fine, because derived output is re-creatable and
+ * the only real requirement is that a third party can fetch it.
+ */
+export declare function requirePublishableBackend(flags: Flags, what: string): void;
+export declare function printServing(url: string, address?: Address): void;
+/** Walk up from the CLI source to the workspace root (the dir with pnpm-workspace.yaml). Returns
+ *  null when running from a published install (no workspace) — where --from-source doesn't apply. */
+export declare function findRepoRoot(): string | null;
+export declare function keepAlive(): Promise<void>;
+/**
+ * Pick the canonical factory for a clone being added — the CLI-side shell around the SDK's
+ * {@link sdkDetectCanonicalFactory} (which does the actual multicall probe; see its doc comment).
+ * Shared by `add`'s local + remote paths (project.ts) and the deploy family's post-setup local
+ * register (deploy.ts, via {@link registerAndIndexLocally}).
+ */
+export declare function detectCanonicalFactory(address: Address, override?: string, stored?: string | null): Promise<Address | undefined>;
+/**
+ * Register + index a project LOCALLY (this node's own SQLite-backed projection) — the core of
+ * `abx add`'s non-`--remote` path, factored out here because it's ALSO how `deploy` / `deploy-series`
+ * / `deploy-code` register the project they just deployed (see cmdAdd in commands/project.ts, whose
+ * local branch is a thin call to this). Kept self-sufficient (recomputes any `--attributes`/`--traits`
+ * edit from `flags` itself) so it never depends on a caller's local variables.
+ */
+export declare function registerAndIndexLocally(address: Address, flags: Flags): Promise<void>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAYA,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,KAAK,OAAO,EAIZ,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,MAAM,EAkBZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,YAAY,CAAC;AAItC,eAAO,MAAM,CAAC;;;;;;;;CAGb,CAAC;AACF,eAAO,MAAM,CAAC,GAAI,GAAG,MAAM,WAA+B,CAAC;AAC3D,eAAO,MAAM,CAAC,GAAI,GAAG,MAAM,WAAgC,CAAC;AAC5D,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAA6B,CAAC;AAC3D,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAA8B,CAAC;AAC7D,eAAO,IAAI,KAAK,QAAI,CAAC;AACrB,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAqD,CAAC;AACpF,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,SAAsC,CAAC;AACnE,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAiC,CAAC;AAChE,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAoD,CAAC;AAKnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEjD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAU1H;AAGD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAQxF;AAED;;;;wCAIwC;AACxC,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAStE;AAED;;;;oGAIoG;AACpG,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC9G;AAGD;;aAEa;AACb,wBAAsB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BrG;AAGD;;;sGAGsG;AACtG,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBxE;AAED;;6FAE6F;AAC7F,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BrI;AAQD;8FAC8F;AAC9F,wBAAsB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAsC9G;AAED;qEACqE;AACrE,wBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAsCtG;AAED;;mEAEmE;AACnE,wBAAsB,wBAAwB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BtI;AAED;;;qDAGqD;AACrD,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CASnF;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,gGAAgG;AAChG,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAM,GAC3E,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAyBnD;AAMD,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,wBAAwB,CAAC,CAAC,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA8B1E;AAGD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,QAkB1D;AAED;qGACqG;AACrG,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAS5C;AAED,wBAAgB,SAAS,kBAMxB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAG9B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA2E3F"}