@artblocks/abx-cli 0.1.0-alpha.3 → 0.1.0-alpha.30

package/dist/inspect.js

@@ -1,184 +0,0 @@
-/**
- * `abx inspect <script.js>` — static analysis of a generative script, BEFORE picking a lane.
- *
- * The membrane fix behind this: an agent (or creator) should DERIVE the deployment lane from what
- * the script actually needs — are there traits? are they reproducible on-chain? how big is the
- * assembled document (does a single `tokenURI` eth_call even fit)? — instead of guessing "fully
- * on-chain!" and walking it back. This module is the pure analysis; `cmdInspect` formats it.
- *
- * Static only — it never executes the script (that's the resolver/runner's job, and executing
- * untrusted art in the CLI would be a footgun). Everything here is regex/heuristic over the source.
- */
-/** Approx bytes a known on-chain dependency adds to the ASSEMBLED document (gzip'd + base64'd, as it
- *  rides in the inline data-URI). Measured from real drops; used only for the RPC-size estimate. */
-const KNOWN_DEP_DOC_BYTES = {
-    'p5@1.0.0': 200_000, // p5 1.0.0 (~623KB raw) rides ~200KB gzip+base64 in the document
-};
-/** The on-chain runtime the generator always inlines (abx.js + the gunzip bootstrap), base64'd. */
-const RUNTIME_DOC_BYTES = 13_000;
-/** A single `eth_call` returning `tokenURI` comfortably carries this much document on a default node
- *  (geth's 50M gas cap; memory expansion is ~quadratic). Past it, marketplaces that call `tokenURI`
- *  once may time out — prefer the generator's piecewise getters, directory mode, or a CDN dep. */
-const SINGLE_CALL_DOC_CEILING = 1_500_000;
-/** PostParam keys the script READS from tokenData — the palette-style customization inputs. A deploy
- *  that omits these from `--schema` silently drops them (the render sees `undefined` → its default),
- *  which is exactly how a real session "forgot" the palette it had itself identified. Heuristic (the
- *  script isn't executed): find identifiers aliased to `abx.tokenData`, then their property reads;
- *  plus direct `abx.tokenData.key`, destructuring, and `tokenData['key']`. `seed` is intrinsic, not a
- *  PostParam, so it's excluded. Advisory — over- or under-detection is a hint, never a hard gate. */
-function paramKeys(source) {
-    const keys = new Set();
-    const add = (k) => { if (k && k !== 'seed')
-        keys.add(k); };
-    // Identifiers aliased to the token-data object — either `abx.tokenData` (via abx.js) or the raw
-    // injected global `window.abxTokenData` (e.g. `var td = (window.abx && abx.tokenData) || {}`).
-    const aliases = new Set();
-    // The `(?!…\.[A-Za-z_$])` guard: only alias when the RHS is the tokenData OBJECT, not a PROPERTY of
-    // it — `const seed = abx.tokenData.seed` aliases `seed` to a scalar, so its method calls
-    // (`seed.startsWith(…)`) must NOT be read as params (the false-positive that flagged startsWith/slice).
-    const aliasRe = /\b([A-Za-z_$][\w$]*)\s*=\s*[^;\n]*(?:abx\s*\??\s*\.\s*tokenData|window\s*\??\s*\.\s*abxTokenData)(?!\s*\??\s*\.\s*[A-Za-z_$])/g;
-    let m;
-    while ((m = aliasRe.exec(source)) !== null)
-        aliases.add(m[1]);
-    for (const a of aliases) {
-        // `(?!\s*\()` excludes method CALLS (`td.slice(…)`) — a param read is a bare property, never a call.
-        const dotRe = new RegExp(`\\b${a.replace(/[$]/g, '\\$')}\\s*\\??\\s*\\.\\s*([A-Za-z_$][\\w$]*)(?!\\s*\\()`, 'g');
-        let d;
-        while ((d = dotRe.exec(source)) !== null)
-            add(d[1]);
-    }
-    // Direct `abx.tokenData.key` and `abx.tokenData['key']`.
-    const directRe = /abx\s*\??\s*\.\s*tokenData\s*\??\s*(?:\.\s*([A-Za-z_$][\w$]*)|\[\s*['"]([^'"]+)['"]\s*\])/g;
-    while ((m = directRe.exec(source)) !== null)
-        add(m[1] ?? m[2]);
-    // Destructuring: `const { palette, foo } = abx.tokenData` (or an alias).
-    const destrRe = /(?:const|let|var)\s*\{([^}]*)\}\s*=\s*[^;\n]*(?:abx\s*\.\s*tokenData|\b(?:tokenData|td)\b)/g;
-    while ((m = destrRe.exec(source)) !== null) {
-        for (const part of m[1].split(','))
-            add(part.split(':')[0].trim().replace(/\.\.\./, '') || undefined);
-    }
-    return [...keys];
-}
-/** Extract the key names from the first `abx.traits({ ... })` object literal (flat objects only). */
-function traitKeys(source) {
-    const m = source.match(/abx\s*\??\s*\.\s*traits\s*\(\s*\{([^}]*)\}/);
-    if (!m)
-        return [];
-    const keys = [];
-    // A key sits at the start of the object or right after a comma (so a ternary VALUE like
-    // `? 'Sparse' : 'Dense'` — a `:` not preceded by `,`/`{` — is never mistaken for a key). Allow
-    // leading whitespace after `^` so the FIRST key (preceded only by the newline after `{`) is caught.
-    // A key is EITHER a quoted string (arbitrary content — `'Plant Count'`, a spaced trait_type a
-    // marketplace shows) OR a bare identifier; a bare-identifier-only match silently dropped quoted
-    // keys, and "believe inspect" then sent authors chasing a phantom missing trait.
-    const re = /(?:^\s*|[,{]\s*)(?:(['"])([^'"]+)\1|([A-Za-z_$][\w$]*))\s*:/g;
-    let k;
-    while ((k = re.exec(m[1])) !== null)
-        keys.push(k[2] ?? k[3]);
-    return [...new Set(keys)];
-}
-export function analyzeScript(source, declaredDeps = []) {
-    const bytes = new TextEncoder().encode(source).length;
-    const keys = traitKeys(source);
-    const usesMathRandom = /Math\s*\.\s*random\s*\(/.test(source);
-    // p5's bare random(...) — a `random(` NOT preceded by `.` or a word char (so not Math.random / obj.random)
-    const usesBareRandom = /(^|[^.\w])random\s*\(/.test(source);
-    const seeded = /\brandomSeed\s*\(/.test(source);
-    const usesNoise = /\bnoise\s*\(/.test(source);
-    const looksP5 = /\bcreateCanvas\s*\(|function\s+setup\s*\(|function\s+draw\s*\(|\bp5\b/.test(source);
-    const depHints = [];
-    if (looksP5)
-        depHints.push('p5');
-    if (/\bTHREE\b/.test(source))
-        depHints.push('three');
-    if (/\bTone\b/.test(source))
-        depHints.push('tone');
-    // The abx.js runtime data contract — does the script read state + report traits the ONE way the
-    // toolkit injects/captures them? A near-miss global deploys fine but is silently broken.
-    // `\??\s*\.` tolerates optional chaining (`abx?.tokenData`) — a common, correct way to read it.
-    const readsTokenData = /abx\s*\??\s*\.\s*tokenData\b/.test(source) || /window\s*\??\s*\.\s*abxTokenData\b/.test(source);
-    const reportsTraits = /abx\s*\??\s*\.\s*traits\s*\(/.test(source);
-    let wrongGlobal = null;
-    if (!readsTokenData) {
-        if (/window\s*\.\s*tokenTraits\b/.test(source))
-            wrongGlobal = 'window.tokenTraits — traits are reported by CALLING abx.traits({…}), never by writing a global';
-        else if (/window\s*\.\s*tokenData\b/.test(source))
-            wrongGlobal = 'window.tokenData — abx injects window.abxTokenData (read it via abx.tokenData), not window.tokenData';
-        else if (/\btokenData\b/.test(source))
-            wrongGlobal = 'a bare `tokenData` — read abx.tokenData (via abx.js) or the raw window.abxTokenData global';
-    }
-    // Trait-reproducibility rubric (see docs/research/onchain-traits-feasibility.md).
-    let verdict;
-    let reason;
-    if (keys.length === 0) {
-        verdict = 'none';
-        reason = 'no abx.traits({…}) call → NO marketplace traits on ANY lane. A resolver captures the keys you pass to abx.traits(); it does not invent traits from internal variables or a global. Call abx.traits({…}) in the sketch if you want filterable traits.';
-    }
-    else if (usesMathRandom && !seeded) {
-        verdict = 'infeasible';
-        reason = 'traits derive from Math.random() (unseeded) — non-deterministic, reproducible nowhere. Serve attributes via a resolver, or ship without marketplace traits.';
-    }
-    else if (seeded && looksP5) {
-        verdict = 'exact-likely';
-        reason = 'seeded p5 random() is a documented LCG — integer floor/threshold/select traits port EXACTLY to Solidity. Confirm no trait keys off a raw float value. Wire with --attributes-renderer (see docs/research/onchain-traits-feasibility.md).';
-    }
-    else if (seeded) {
-        verdict = 'careful';
-        reason = "seeded, but the PRNG isn't identified as p5 — reproducible on-chain if you port that generator + the exact call order.";
-    }
-    else if (usesBareRandom) {
-        verdict = 'unknown';
-        reason = 'traits present and random() is used, but no randomSeed() was found — check the art is deterministic before attempting on-chain traits.';
-    }
-    else {
-        verdict = 'exact-likely';
-        reason = 'traits look derived from the seed/params directly (no PRNG) — reproducible on-chain via an attributes field-renderer.';
-    }
-    const deps = declaredDeps;
-    let unknownDepSizes = false;
-    let depDocBytes = 0;
-    for (const d of deps) {
-        if (d in KNOWN_DEP_DOC_BYTES)
-            depDocBytes += KNOWN_DEP_DOC_BYTES[d];
-        else
-            unknownDepSizes = true;
-    }
-    const estBytes = bytes + RUNTIME_DOC_BYTES + depDocBytes;
-    return {
-        bytes,
-        estChunks: Math.max(1, Math.ceil(bytes / 22_000)),
-        traits: { present: keys.length > 0, keys },
-        paramHints: paramKeys(source),
-        prng: { seeded, usesBareRandom, usesMathRandom, usesNoise },
-        depHints,
-        looksP5,
-        feasibility: { verdict, reason },
-        doc: { estBytes, deps, fitsSingleCall: estBytes <= SINGLE_CALL_DOC_CEILING && !unknownDepSizes, unknownDepSizes },
-        runtime: { readsTokenData, reportsTraits, wrongGlobal },
-    };
-}
-/** A one-line lane recommendation derived from the analysis (the decision-tree output). */
-export function recommendLane(a) {
-    const bigDoc = !a.doc.fitsSingleCall && !a.doc.unknownDepSizes;
-    if (bigDoc) {
-        return 'DIRECTORY mode (--code-dir) or a CDN dependency — the assembled document is too large for a single tokenURI eth_call to be reliable.';
-    }
-    if (a.feasibility.verdict === 'infeasible') {
-        return 'RESOLVER lane (--public-base-url) if marketplace traits matter (a server serves the JS-derived attributes), OR --onchain-uri and accept no marketplace traits (the tokenURI + animation are still fully on-chain).';
-    }
-    if (a.feasibility.verdict === 'exact-likely' || a.feasibility.verdict === 'none') {
-        const dep = a.depHints.length ? ` --dep ${a.depHints[0]}@<version>` : '';
-        const docKb = Math.round(a.doc.estBytes / 1000);
-        // Owner call (real-world experience): for a generative drop meant to sell, LEAD with the off-chain
-        // resolver — maneuverable over time + marketplaces fetch a SMALL tokenURI reliably. Fully-on-chain
-        // is the durability-max alternative, but its ~docKb tokenURI (whole doc per call) strains some
-        // marketplace/indexer reads. Traits are NOT a free flag on the on-chain lane (deployed renderer).
-        const traits = a.traits.present
-            ? ` Traits (${a.traits.keys.join(', ')}): the resolver serves them from the render with no Solidity; on the on-chain lane they need a DEPLOYED --attributes-renderer (fork SeedTraitsRenderer.sol) or they're omitted.`
-            : ``;
-        return (`RECOMMENDED for a drop you'll sell — OFF-CHAIN RESOLVER (--public-base-url + an effects runner): maneuverable (metadata/serving can evolve without on-chain surgery) and marketplaces fetch a SMALL tokenURI reliably.${traits}\n` +
-            `  ALTERNATIVE — FULLY ON-CHAIN (--onchain-uri${dep} --image-base <bucket>): maximal durability / no server, but the tokenURI carries the whole ~${docKb}KB document per call (some marketplace + indexer reads choke on a doc this big), stills are MANUAL, and later changes are on-chain re-points. Pick it when permanence + zero-infra outweigh maneuverability.`);
-    }
-    return (`RECOMMENDED — an OFF-CHAIN RESOLVER (--public-base-url): maneuverable, and it serves traits from the render regardless of the PRNG. --onchain-uri also works for tokenURI + animation, but first verify the script is deterministic (see the feasibility note), and note the large-tokenURI marketplace-read tradeoff; on that lane traits need a DEPLOYED --attributes-renderer or are omitted.`);
-}
-//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

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

package/dist/migrate.d.ts

@@ -1,65 +0,0 @@
-import type { OpenSeaAttribute, ProjectState } from '@artblocks/abx-sdk';
-import { type StorageBackend } from '@artblocks/abx-storage';
-/** An image that lives ONLY on the source host (committed by hash, never pinned to a durable
- *  backend) — there's no portable URL to copy, so its bytes must be re-pinned before cutover. */
-export interface NodeCustodyImage {
-    tokenId: string;
-    /** On-chain content hash (the `keccak256`/`sha256` commitment) — what we verify re-pinned bytes against. */
-    hash: string;
-    /** The source's served image URL — the old host's own `/…/image` route; where we fetch the bytes. */
-    imageUrl: string;
-}
-/** The off-chain state to bridge to the destination resolver + what couldn't be carried cleanly. */
-export interface MigrationPlan {
-    description?: string;
-    externalUrl?: string;
-    attributes?: OpenSeaAttribute[];
-    /** `{ "0x<keccak>": "https://gw/ipfs/<cid>" }` — durable image locators recovered from the source. */
-    contentLocators: Record<string, string>;
-    /** Images served only by the source host (no durable locator) — re-pin before cutover. */
-    nodeCustody: NodeCustodyImage[];
-    /** Tokens whose served JSON we read to build this plan. */
-    tokensRead: number;
-}
-export declare const tokenApiUrl: (base: string, chainId: number, addr: string, id: string) => string;
-export declare const contractApiUrl: (base: string, chainId: number, addr: string) => string;
-/**
- * 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 declare function buildMigrationPlan(sourceBase: string, chainId: number, local: ProjectState): Promise<MigrationPlan>;
-/**
- * Re-pin node-custody images to a DURABLE backend so the destination never depends on the
- * (soon-to-be-decommissioned) source host. For each image: fetch the bytes from the source,
- * **verify** them against the on-chain hash (trustless — we trust the chain, not the old node),
- * then `put` them to the destination operator's own backend and read back a portable locator.
- *
- * If the configured backend isn't durable (no `locator` — fs/cloud serve only through their own
- * node, so re-pinning there just moves the single-host dependency), we re-pin NOTHING and report
- * every image as `needsDurableBackend`: the right move is to configure IPFS/Arweave and re-run,
- * never to bridge a URL that points back at the dying host.
- */
-export interface RepinResult {
-    /** hash → new durable locator, ready to bridge to the destination. */
-    repinned: Record<string, string>;
-    /** Re-pinned token ids (for reporting). */
-    repinnedTokens: string[];
-    /** Bytes fetched but their hash didn't match the on-chain commitment — NOT trusted, NOT pinned. */
-    mismatched: NodeCustodyImage[];
-    /** Couldn't fetch the bytes from the source (host down, 404). */
-    unreachable: NodeCustodyImage[];
-    /** Skipped because no durable backend is configured — these need IPFS/Arweave + a re-run. */
-    needsDurableBackend: NodeCustodyImage[];
-}
-export declare function repinNodeCustody(images: NodeCustodyImage[], backend: StorageBackend): Promise<RepinResult>;
-/** A parity check after bridging: does the destination now serve the same image/description/traits? */
-export interface ParityResult {
-    tokenId: string;
-    imageMatch: boolean;
-    descriptionMatch: boolean;
-    attributesMatch: boolean;
-    sourceImage?: string;
-    destImage?: string;
-}
-export declare function verifyParity(sourceBase: string, destBase: string, chainId: number, addr: string, tokenId: string): Promise<ParityResult>;
-//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAc,KAAK,cAAc,EAAC,MAAM,wBAAwB,CAAC;AA4BxE;iGACiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,sGAAsG;IACtG,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,0FAA0F;IAC1F,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,MAC5B,CAAC;AAC3D,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,MAAM,MAAM,KAAG,MACzB,CAAC;AA+BrD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,aAAa,CAAC,CAsDxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2CAA2C;IAC3C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mGAAmG;IACnG,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,iEAAiE;IACjE,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,6FAA6F;IAC7F,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAyChH;AAED,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAavB"}

package/dist/migrate.js

@@ -1,180 +0,0 @@
-/**
- * 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

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

package/dist/onchain-uri.d.ts

@@ -1,97 +0,0 @@
-import { type Address, type GeneratorReadClient, type GeneratorStatus, type Hex, type ParsedDependencyRef, type ProjectState } from '@artblocks/abx-sdk';
-import type { DepCheck } from './deps.js';
-/** The self-referential key: the CSV lists it too (the resolver's tokenData carries every
- *  evented param — including `params.keys` itself — so the generator must list it to stay
- *  byte-aligned; inputsHash parity is load-bearing). */
-export declare const PARAMS_KEYS = "params.keys";
-/** ≤ this many chars rides as a literal readable-ASCII bytes32; longer takes the data path. */
-export declare const PARAMS_KEYS_LITERAL_MAX = 31;
-/**
- * Compose the `params.keys` CSV: every param key the deploy writes ∪ the `--schema` keys ∪
- * `params.keys` itself — deduped, sorted lexicographically, comma-joined. Sorted because the
- * canonical tokenData serialization sorts keys; deterministic composition keeps the value
- * reproducible from the same flags.
- */
-export declare function composeParamsKeys(writtenParamKeys: string[], schemaKeys: string[]): string;
-/** Whether a CSV fits the literal bytes32 lane (printable ASCII, ≤ 31 bytes). */
-export declare function paramsKeysIsLiteral(csv: string): boolean;
-/** The `params.keys` write leg: `setContractParam` (literal bytes32) when the CSV fits,
- *  else `setContractParamData` (one blob; hash evented — the generator reads it back whole). */
-export declare function paramsKeysCall(csv: string): {
-    call: Hex;
-    encoding: 'literal' | 'data';
-};
-/**
- * The `--onchain-uri` legs of the setup multicall, in order:
- *   1. collection-scope `animation_url` field → representation `renderer`,
- *      value `abi.encode(generator)` (the canonical generator computes the live view on-chain);
- *   2. the `params.keys` contract param (the generator's tokenData enumeration seam);
- *   3. `setTokenURIRenderer(metadataRenderer)` — tokenURI resolves ON-CHAIN from here on;
- *   4. `setContractURIRenderer(metadataRenderer)` — contractURI too (parity with the 1/1 lane).
- * Placed BEFORE the mint legs so every token is born with the on-chain lane fully configured.
- */
-export declare function onchainUriSetupCalls(args: {
-    generator: Address;
-    metadataRenderer: Address;
-    paramsKeys: string;
-}): {
-    calls: Hex[];
-    paramsKeysEncoding: 'literal' | 'data';
-};
-/** What the deploy can honestly promise about the generator's template branch, derived from
- *  the selection-time dependency report (never a new RPC): chain-complete iff every registry
- *  dep has proven ON-CHAIN bytes (OnChain refs read their data contract directly, so they
- *  count as on-chain; `abx verify` is the from-chain confirmation either way). */
-export declare function expectedChainComplete(deps: ParsedDependencyRef[], checks: DepCheck[]): {
-    expected: boolean | null;
-    detail: string;
-};
-/** The generator this project's on-chain lane actually uses: the collection `animation_url`
- *  field's `renderer` value when set (that address is what the metadata renderer staticcalls),
- *  else the chain's canonical generator. Null when neither exists. */
-export declare function generatorFor(state: ProjectState, override?: string): Address | null;
-/** Whether verify should run the on-chain-URI report: the tokenURIRenderer toggle is on, or
- *  the collection `animation` field points at a field renderer (the generator). */
-export declare function hasOnChainUriLane(state: ProjectState): boolean;
-export interface TokenUriProbe {
-    tokenId: string;
-    /** tokenURI(id) is a `data:application/json;base64,` URI (resolves on-chain, any RPC). */
-    onChainJson: boolean;
-    uriPrefix: string;
-    animation: {
-        form: 'data-html';
-        bytes: number;
-        marker: string | null;
-    } | {
-        form: 'url';
-        url: string;
-    } | {
-        form: 'data-other';
-        prefix: string;
-    } | {
-        form: 'missing';
-    };
-}
-export interface OnChainUriReport {
-    generator: Address;
-    status: GeneratorStatus;
-    /** Null when no token is minted yet (tokenURI would revert). */
-    probe: TokenUriProbe | null;
-}
-/**
- * The verify-time on-chain-URI report: `generator.onChainStatus(token)` (branch ·
- * chain-completeness · unresolved refs · URL budget) plus a `tokenURI` probe of the lowest
- * minted token — decoded, with the `animation_url` form checked against the branch.
- */
-export declare function onChainUriReport(client: GeneratorReadClient, state: ProjectState, generatorOverride?: string): Promise<OnChainUriReport>;
-/**
- * After a param write: if the project's `params.keys` CSV exists but doesn't list the
- * configured key, the on-chain generator's tokenData will silently omit it (breaking byte
- * parity with the resolver's). Returns the fixed CSV to suggest, or null when no nudge is
- * warranted (no CSV = not on the on-chain lane; already listed = fine).
- */
-export declare function paramsKeysNudge(existingCsv: string | null, configuredKey: string): string | null;
-/** Read the project's `params.keys` contract param from chain (literal or data-backed);
- *  null when unset. Best-effort — callers must treat a throw as "no nudge". */
-export declare function readParamsKeys(client: GeneratorReadClient, contract: Address): Promise<string | null>;
-//# sourceMappingURL=onchain-uri.d.ts.map

package/dist/onchain-uri.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"onchain-uri.d.ts","sourceRoot":"","sources":["../src/onchain-uri.ts"],"names":[],"mappings":"AAaA,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,GAAG,EACR,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAC;AAExC;;wDAEwD;AACxD,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ1F;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;gGACgG;AAChG,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAA;CAAC,CAmBrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG;IAAC,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM,CAAA;CAAC,CAuBzD;AAID;;;kFAGkF;AAClF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,MAAM,EAAE,QAAQ,EAAE,GACjB;IAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAoB5C;AAID;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUnF;AAED;mFACmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAM9D;AAYD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EACL;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,GACzD;QAAC,IAAI,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,GAC1B;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,GACpC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAC,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,gEAAgE;IAChE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7B;AAmBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,YAAY,EACnB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhG;AAED;+EAC+E;AAC/E,wBAAsB,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB3G"}