@artblocks/abx-cli 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/onchain-uri.d.ts

@@ -1,81 +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 `--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. `setTokenURIRenderer(metadataRenderer)` — tokenURI resolves ON-CHAIN from here on;
- *   3. `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.
- *
- * There is no param leg: the generator enumerates the param surface from the token itself
- * (`contractParamKeys` / `tokenParamKeys`), so there is nothing for a deploy to declare.
- */
-export declare function onchainUriSetupCalls(args: {
-    generator: Address;
-    metadataRenderer: Address;
-}): Hex[];
-/** The SET param keys: `contractParamKeys()`, plus `tokenParamKeys(tokenId)` when a token is named.
- *  Null when the getters are absent — a LEGACY project deployed before enumeration shipped (or a
- *  token type with no Params extension at all). */
-export declare function readSetParamKeys(client: GeneratorReadClient, contract: Address, tokenId?: bigint): Promise<{
-    contract: string[];
-    token: string[];
-} | null>;
-/** The DECLARED (governed) keys: `paramSchemaKeys()`, append-only — including keys declared but
- *  never yet written, which are otherwise undiscoverable. Null on a legacy project. */
-export declare function readParamSchemaKeys(client: GeneratorReadClient, contract: Address): Promise<string[] | null>;
-/** Does this token expose the enumeration surface at all? The one-call probe behind the repoint
- *  guard: the canonical generator reads params from chain, so pointing a token that lacks these
- *  getters at it makes every param silently invisible. */
-export declare function hasParamEnumeration(client: GeneratorReadClient, contract: Address): Promise<boolean>;
-/** 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>;
-/** Read a legacy project's `params.keys` CSV from chain (literal or data-backed); null when unset.
- *  Best-effort — callers must treat a throw as "no legacy list". */
-export declare function readLegacyParamsKeys(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":"AAkBA,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;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAC,GAAG,GAAG,EAAE,CAqBjG;AAQD;;mDAEmD;AACnD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,GAAG,IAAI,CAAC,CAqBvD;AAED;uFACuF;AACvF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAYlH;AAED;;0DAE0D;AAC1D,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1G;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;AAUD;oEACoE;AACpE,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAoBnH"}

package/dist/onchain-uri.js

@@ -1,251 +0,0 @@
-/**
- * The on-chain tokenURI lane for code projects (`abx deploy-code --onchain-uri`) — pure leg
- * composition + the verify-time honesty reads, all unit-testable with a mocked client.
- *
- * The lane (specs/protocol/code-projects.md → "The canonical generator — AbxGenerator" +
- * specs/protocol/onchain-metadata.md → "URI resolution"): the collection-scope `animation_url`
- * field points at the canonical generator via the `renderer` representation
- * (`abi.encode(address)`), and the token's `tokenURIRenderer` toggles tokenURI to the canonical
- * on-chain metadata renderer (`setContractURIRenderer` does the same for contractURI). Both ride
- * the EXISTING setup multicall, before the mints.
- *
- * The param surface is NOT part of that wiring: params enumerate ON-CHAIN (`contractParamKeys` /
- * `tokenParamKeys`, maintained by the write paths themselves), so the generator reads the key set
- * straight from the token. The old `params.keys` CSV convention is retired — nothing writes it any
- * more; the only thing left here is a read-only lane for LEGACY projects deployed before
- * enumeration shipped.
- */
-import { encodeFunctionData, zeroAddress } from 'viem';
-import { decodeFieldRenderer, decodeTag, encodeFieldRenderer, encodeTag, readGeneratorStatus, resolveGenerator, seriesCodeAbi, METADATA_FIELD as F, METADATA_REPRESENTATION as R, DEP_RESOLUTION, } from '@artblocks/abx-sdk';
-/**
- * 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. `setTokenURIRenderer(metadataRenderer)` — tokenURI resolves ON-CHAIN from here on;
- *   3. `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.
- *
- * There is no param leg: the generator enumerates the param surface from the token itself
- * (`contractParamKeys` / `tokenParamKeys`), so there is nothing for a deploy to declare.
- */
-export function onchainUriSetupCalls(args) {
-    const calls = [];
-    // The `animation_url` leg points at the generator (which computes the doc from a PROGRAM). A
-    // renderer-only drop (in-chain SVG, no program) has no generator — and baking this leg at a ZERO
-    // generator would make the metadata renderer staticcall a codeless address and REVERT every
-    // tokenURI. So emit it only when there's a real generator; otherwise there's simply no animation_url
-    // (optional by spec — the metadata renderer omits an unset field).
-    if (args.generator !== zeroAddress) {
-        calls.push(encodeFunctionData({
-            abi: seriesCodeAbi,
-            functionName: 'setContractField',
-            args: [encodeTag(F.animationUrl), encodeTag(R.renderer), encodeFieldRenderer(args.generator)],
-        }));
-    }
-    calls.push(encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setTokenURIRenderer', args: [args.metadataRenderer] }), encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setContractURIRenderer', args: [args.metadataRenderer] }));
-    return calls;
-}
-// ── the param surface, enumerated FROM CHAIN ──────────────────────────────────
-// `key ∈ list ⟺ the param isSet` — the contract maintains both key lists inside the write paths
-// themselves, so nothing off-chain has to be kept in step. `seed` is deliberately never listed
-// (every consumer reads it as a tokenData coordinate). Enumeration order is unspecified; the
-// canonical serialization sorts.
-/** The SET param keys: `contractParamKeys()`, plus `tokenParamKeys(tokenId)` when a token is named.
- *  Null when the getters are absent — a LEGACY project deployed before enumeration shipped (or a
- *  token type with no Params extension at all). */
-export async function readSetParamKeys(client, contract, tokenId) {
-    try {
-        const contractKeys = (await client.readContract({
-            address: contract,
-            abi: seriesCodeAbi,
-            functionName: 'contractParamKeys',
-            args: [],
-        }));
-        const tokenKeys = tokenId === undefined
-            ? []
-            : (await client.readContract({
-                address: contract,
-                abi: seriesCodeAbi,
-                functionName: 'tokenParamKeys',
-                args: [tokenId],
-            }));
-        return { contract: contractKeys.map(decodeTag), token: tokenKeys.map(decodeTag) };
-    }
-    catch {
-        return null;
-    }
-}
-/** The DECLARED (governed) keys: `paramSchemaKeys()`, append-only — including keys declared but
- *  never yet written, which are otherwise undiscoverable. Null on a legacy project. */
-export async function readParamSchemaKeys(client, contract) {
-    try {
-        const keys = (await client.readContract({
-            address: contract,
-            abi: seriesCodeAbi,
-            functionName: 'paramSchemaKeys',
-            args: [],
-        }));
-        return keys.map(decodeTag);
-    }
-    catch {
-        return null;
-    }
-}
-/** Does this token expose the enumeration surface at all? The one-call probe behind the repoint
- *  guard: the canonical generator reads params from chain, so pointing a token that lacks these
- *  getters at it makes every param silently invisible. */
-export async function hasParamEnumeration(client, contract) {
-    try {
-        await client.readContract({ address: contract, abi: seriesCodeAbi, functionName: 'tokenParamKeys', args: [0n] });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ── the chain-complete expectation (deploy-time, from the P1 dependency report) ──
-/** 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 function expectedChainComplete(deps, checks) {
-    if (deps.length === 0)
-        return { expected: true, detail: 'no dependencies — the document assembles from the script chunks alone' };
-    const registryDeps = deps.filter((d) => d.resolution === DEP_RESOLUTION.registry);
-    if (registryDeps.length === 0) {
-        return { expected: true, detail: 'all dependencies are on-chain data contracts (read directly)' };
-    }
-    const byDep = new Map(checks.map((c) => [c.dep, c]));
-    const cdnOnly = [];
-    const missing = [];
-    let unknown = false;
-    for (const d of registryDeps) {
-        const chk = byDep.get(d.display);
-        if (!chk || chk.status === 'skipped')
-            unknown = true;
-        else if (chk.status === 'not-found')
-            missing.push(d.display);
-        else if (!chk.details.availableOnChain)
-            cdnOnly.push(d.display);
-    }
-    if (missing.length)
-        return { expected: false, detail: `${missing.join(', ')} not on the registry — the generator will emit an unresolved marker` };
-    if (cdnOnly.length)
-        return { expected: false, detail: `${cdnOnly.join(', ')} CDN-served (the normal production path) — serves fine, NOT chain-complete` };
-    if (unknown)
-        return { expected: null, detail: 'registry check was skipped (RPC unreachable) — `abx verify` reads the truth from chain' };
-    return { expected: true, detail: 'every dependency has ON-CHAIN bytes — no server, gateway, or CDN in the graph' };
-}
-// ── verify: the honesty reads (`onChainStatus` + a tokenURI probe) ─────────────
-/** 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 function generatorFor(state, override) {
-    const field = state.collectionFields.find((f) => f.field === F.animationUrl && f.representation === R.renderer);
-    if (field) {
-        try {
-            return decodeFieldRenderer(field.value);
-        }
-        catch {
-            /* malformed value — fall through to the manifest */
-        }
-    }
-    return resolveGenerator(state.chainId, override) ?? 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 function hasOnChainUriLane(state) {
-    const rendererSet = !!state.tokenURIRenderer && state.tokenURIRenderer !== zeroAddress;
-    const animationRenderer = state.collectionFields.some((f) => f.field === F.animationUrl && f.representation === R.renderer);
-    return rendererSet || animationRenderer;
-}
-const erc721TokenUriAbi = [
-    {
-        type: 'function',
-        name: 'tokenURI',
-        stateMutability: 'view',
-        inputs: [{ name: 'id', type: 'uint256' }],
-        outputs: [{ name: '', type: 'string' }],
-    },
-];
-/** An HTML comment marker the generator emits on degradation (`<!-- abx:… -->`), or null. */
-function degradationMarker(html) {
-    const m = /<!--\s*abx:[^>]*-->/.exec(html);
-    return m ? m[0] : null;
-}
-function probeAnimation(animationUrl) {
-    if (!animationUrl)
-        return { form: 'missing' };
-    const dataHtml = /^data:text\/html;base64,(.*)$/.exec(animationUrl);
-    if (dataHtml) {
-        const html = Buffer.from(dataHtml[1], 'base64').toString('utf8');
-        return { form: 'data-html', bytes: Buffer.byteLength(html), marker: degradationMarker(html) };
-    }
-    if (animationUrl.startsWith('data:'))
-        return { form: 'data-other', prefix: animationUrl.slice(0, 40) };
-    return { form: 'url', url: animationUrl };
-}
-/**
- * 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 async function onChainUriReport(client, state, generatorOverride) {
-    const generator = generatorFor(state, generatorOverride);
-    if (!generator) {
-        throw new Error(`no AbxGenerator known for chain ${state.chainId} — set ABX_GENERATOR=0x… (or update @artblocks/abx-sdk's deployments manifest)`);
-    }
-    const status = await readGeneratorStatus(client, generator, state.address);
-    const minted = state.tokens.filter((t) => t.minted).map((t) => BigInt(t.tokenId));
-    let probe = null;
-    if (minted.length) {
-        const tokenId = minted.reduce((a, b) => (b < a ? b : a));
-        const uri = (await client.readContract({
-            address: state.address,
-            abi: erc721TokenUriAbi,
-            functionName: 'tokenURI',
-            args: [tokenId],
-        }));
-        const m = /^data:application\/json;base64,(.*)$/.exec(uri);
-        let animation = { form: 'missing' };
-        if (m) {
-            try {
-                const json = JSON.parse(Buffer.from(m[1], 'base64').toString('utf8'));
-                animation = probeAnimation(typeof json.animation_url === 'string' ? json.animation_url : undefined);
-            }
-            catch {
-                /* undecodable JSON — reported as onChainJson with a missing animation */
-            }
-        }
-        probe = { tokenId: tokenId.toString(), onChainJson: !!m, uriPrefix: uri.slice(0, 48), animation };
-    }
-    return { generator, status, probe };
-}
-// ── LEGACY: the retired `params.keys` convention, READ-ONLY ───────────────────
-// Projects deployed before on-chain enumeration declared their param surface in a `params.keys`
-// contract param, and their (old) generator read that CSV. Nothing writes it any more — this reader
-// exists purely so `abx state` still describes those live testnet projects. A `params.keys` value
-// written on a NEW project is just an ordinary param: enumerated and emitted like any other.
-const LEGACY_PARAMS_KEYS = 'params.keys';
-/** Read a legacy project's `params.keys` CSV from chain (literal or data-backed); null when unset.
- *  Best-effort — callers must treat a throw as "no legacy list". */
-export async function readLegacyParamsKeys(client, contract) {
-    const [value, valueIsHash, isSet] = (await client.readContract({
-        address: contract,
-        abi: seriesCodeAbi,
-        functionName: 'contractParam',
-        args: [encodeTag(LEGACY_PARAMS_KEYS)],
-    }));
-    if (!isSet)
-        return null;
-    const csv = valueIsHash
-        ? Buffer.from((await client.readContract({
-            address: contract,
-            abi: seriesCodeAbi,
-            functionName: 'contractParamData',
-            args: [encodeTag(LEGACY_PARAMS_KEYS)],
-        })).slice(2), 'hex').toString('utf8')
-        : decodeTag(value);
-    return csv.split(',').map((k) => k.trim()).filter((k) => k && k !== LEGACY_PARAMS_KEYS);
-}
-//# sourceMappingURL=onchain-uri.js.map

package/dist/onchain-uri.js.map

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

package/dist/resume.d.ts

@@ -1,96 +0,0 @@
-import type { Address, Hex } from 'viem';
-/**
- * Finish a `deploy-code` whose **setup transaction** never landed.
- *
- * A code project deploys in two transactions: create the clone, then one atomic `multicall` carrying
- * the script chunks, the PostParam schemas, the dependency declarations, the on-chain-URI legs, and
- * any reserve mints. There is no rollback. When the second one fails you own a live-but-unusable
- * contract, and the CREATE2 salt reserved for that address is spent — so the dry run's pinned-salt
- * reproduce command can never be run again. One reporter session produced three orphaned contracts
- * from three attempts; another produced five.
- *
- * The useful half of that report is that those contracts were **recoverable, not lost**: resending the
- * setup with an adequate gas limit completed one, after which `abx verify` reported chain-complete.
- * The tester did it by hand with `cast`. We deliberately do not document that as a recipe — telling a
- * creator to hand-assemble a multicall is worse than telling them nothing — so this is the verb.
- *
- * **Why it diffs instead of just re-sending everything.** The setup multicall is atomic, so in the
- * common case every leg is absent and the diff finds nothing to skip. But two cases make the diff
- * earn its keep: a creator who already repaired part of it by hand (which is exactly what happened),
- * and the gas cost of re-storing script chunks that already landed — EVM code deposit is 200 gas per
- * byte, so blindly re-sending a large program is the most expensive way to be safe. Every leg is also
- * idempotent by construction (index-addressed chunks and dependencies, an upsert for schemas), so the
- * diff is an optimisation on top of a safe operation rather than the thing that makes it safe.
- *
- * The one leg that is NOT idempotent is `mint`, which is why it is computed as a **shortfall** against
- * current supply rather than re-sent: minting again would mint more tokens, and a token cannot be
- * un-minted.
- */
-/** The reads the plan needs. An interface, not a client, so the diff is testable without a chain. */
-export interface ResumeReader {
-    scriptChunkCount(): Promise<number>;
-    /** The stored bytes at `index`, or `null` when unset/unreadable. */
-    scriptChunk(index: number): Promise<Hex | null>;
-    schemaExists(key: string): Promise<boolean>;
-    dependencyCount(): Promise<number>;
-    dependencyRegistry(): Promise<Address | null>;
-    tokenURIRenderer(): Promise<Address | null>;
-    contractURIRenderer(): Promise<Address | null>;
-    /** Whether a collection-scope field has any active representation. */
-    contractFieldSet(field: string): Promise<boolean>;
-    totalSupply(): Promise<number>;
-}
-/** The intended setup, grouped so each group can be skipped independently. */
-export interface SetupLegs {
-    /** One entry per script chunk, in index order. `hex` is the intended content, for comparison. */
-    chunks: Array<{
-        index: number;
-        hex: Hex;
-        data: Hex;
-    }>;
-    schemas: Array<{
-        key: string;
-        data: Hex;
-    }>;
-    /** Dependency legs ride as one group — `count` is how many `setDependency` calls it carries. */
-    deps: {
-        count: number;
-        registry: Address | null;
-        calls: Hex[];
-    };
-    /** The on-chain-URI legs. `animationField` names the collection field they set, when they set one. */
-    uri: {
-        calls: Hex[];
-        animationField: string | null;
-    };
-    /** Reserve mints as an INTENDED TOTAL SUPPLY, not a count to add — see the shortfall note above. */
-    mints: {
-        intendedTotal: number;
-        data: Hex;
-    };
-}
-export interface ResumePlan {
-    /** The calls to send, in the original setup's order. Empty ⇒ nothing is missing. */
-    calls: Hex[];
-    /** Human lines for what is already on-chain — the reassurance half of the readout. */
-    done: string[];
-    /** Human lines for what this will send. */
-    todo: string[];
-    /**
-     * What the selected calls actually consist of, so the caller can label the transaction and compute
-     * its gas floor without re-deriving the selection (matching call bytes back to legs would be both
-     * fragile and quadratic).
-     */
-    sending: {
-        chunkIndices: number[];
-        /** Byte length of each chunk being stored — the 200-gas-per-byte deposit floor. */
-        chunkBytes: number[];
-        schemaKeys: string[];
-        deps: boolean;
-        uri: boolean;
-        mints: number;
-    };
-}
-/** Diff the intended setup against what the contract already holds. */
-export declare function planResume(read: ResumeReader, legs: SetupLegs): Promise<ResumePlan>;
-//# sourceMappingURL=resume.d.ts.map

package/dist/resume.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,GAAG,EAAC,MAAM,MAAM,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,oEAAoE;IACpE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9C,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,mBAAmB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/C,sEAAsE;IACtE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,iGAAiG;IACjG,MAAM,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAC,CAAC,CAAC;IACpD,OAAO,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAC,CAAC,CAAC;IACzC,gGAAgG;IAChG,IAAI,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,GAAG,EAAE,CAAA;KAAC,CAAC;IAC9D,sGAAsG;IACtG,GAAG,EAAE;QAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAC;IACnD,oGAAoG;IACpG,KAAK,EAAE;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAC,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,sFAAsF;IACtF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;OAIG;IACH,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,mFAAmF;QACnF,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAwFzF"}

package/dist/resume.js

@@ -1,95 +0,0 @@
-/** Diff the intended setup against what the contract already holds. */
-export async function planResume(read, legs) {
-    const calls = [];
-    const done = [];
-    const todo = [];
-    const sending = { chunkIndices: [], chunkBytes: [], schemaKeys: [], deps: false, uri: false, mints: 0 };
-    // ── script chunks ───────────────────────────────────────────────────────────
-    // Compared by CONTENT, not by count. A count check would call a chunk "present" when a hand-repair
-    // wrote different bytes at that index, and re-sending is the cheap, correct answer to any doubt.
-    if (legs.chunks.length) {
-        const count = await read.scriptChunkCount();
-        const missing = [];
-        for (const chunk of legs.chunks) {
-            const stored = chunk.index < count ? await read.scriptChunk(chunk.index) : null;
-            if (stored !== null && stored.toLowerCase() === chunk.hex.toLowerCase())
-                continue;
-            missing.push(chunk.index);
-            calls.push(chunk.data);
-            sending.chunkIndices.push(chunk.index);
-            sending.chunkBytes.push((chunk.hex.length - 2) / 2);
-        }
-        if (missing.length === 0)
-            done.push(`script: all ${legs.chunks.length} chunk(s) already stored on-chain`);
-        else if (missing.length === legs.chunks.length)
-            todo.push(`script: store ${missing.length} chunk(s)`);
-        else
-            todo.push(`script: store ${missing.length} of ${legs.chunks.length} chunk(s) (indices ${missing.join(', ')} — the rest already match)`);
-    }
-    // ── PostParam schemas ───────────────────────────────────────────────────────
-    // `exists` is the whole test. A schema cannot have landed with different content than the leg that
-    // wrote it (the multicall is atomic), so present ⇒ correct — and re-writing one is an upsert with
-    // real value-stranding risk, which belongs to `set-schema` and its guard, never to a resume.
-    if (legs.schemas.length) {
-        const absent = [];
-        for (const s of legs.schemas) {
-            if (await read.schemaExists(s.key))
-                continue;
-            absent.push(s.key);
-            calls.push(s.data);
-            sending.schemaKeys.push(s.key);
-        }
-        if (absent.length === 0)
-            done.push(`params: all ${legs.schemas.length} schema(s) already declared`);
-        else
-            todo.push(`params: declare ${absent.join(', ')}`);
-    }
-    // ── dependencies ────────────────────────────────────────────────────────────
-    // One group: the legs are index-addressed and the registry pointer rides with them, so "as many as
-    // intended, pointing at the intended registry" is the honest test.
-    if (legs.deps.calls.length) {
-        const count = await read.dependencyCount();
-        const registry = await read.dependencyRegistry();
-        const registryOk = legs.deps.registry === null || (registry ?? '').toLowerCase() === legs.deps.registry.toLowerCase();
-        if (count >= legs.deps.count && registryOk) {
-            done.push(`dependencies: ${count} already declared${legs.deps.registry ? ' (registry matches)' : ''}`);
-        }
-        else {
-            calls.push(...legs.deps.calls);
-            sending.deps = true;
-            todo.push(`dependencies: declare ${legs.deps.count}${registryOk ? '' : ' + re-point the registry'}`);
-        }
-    }
-    // ── the on-chain URI legs ───────────────────────────────────────────────────
-    // All-or-nothing as a group: a token whose renderers are set but whose animation field is not is
-    // the half-wired state this verb exists to finish, and the legs are all idempotent setters.
-    if (legs.uri.calls.length) {
-        const [tokenR, contractR] = await Promise.all([read.tokenURIRenderer(), read.contractURIRenderer()]);
-        const animationOk = legs.uri.animationField === null || (await read.contractFieldSet(legs.uri.animationField));
-        if (tokenR && contractR && animationOk) {
-            done.push('on-chain URI: renderers wired and the animation field is set');
-        }
-        else {
-            calls.push(...legs.uri.calls);
-            sending.uri = true;
-            todo.push('on-chain URI: wire the metadata renderers + the animation field');
-        }
-    }
-    // ── reserve mints ───────────────────────────────────────────────────────────
-    // A SHORTFALL, never a re-send: mint is the one non-idempotent leg, and a token cannot be un-minted.
-    if (legs.mints.intendedTotal > 0) {
-        const supply = await read.totalSupply();
-        const shortfall = Math.max(0, legs.mints.intendedTotal - supply);
-        if (shortfall === 0) {
-            done.push(`mints: ${supply} token(s) already minted (intended ${legs.mints.intendedTotal})`);
-        }
-        else {
-            for (let i = 0; i < shortfall; i++)
-                calls.push(legs.mints.data);
-            sending.mints = shortfall;
-            todo.push(`mints: mint ${shortfall} more token(s) — ${supply} of ${legs.mints.intendedTotal} exist`);
-        }
-    }
-    return { calls, done, todo, sending };
-}
-//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

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

package/dist/upload.d.ts

@@ -1,28 +0,0 @@
-/**
- * `abx storage upload` core — upload ONE file and return a public locator that PRESERVES the
- * filename, so the declared mimeType survives when the locator is later attached (`abx attach`).
- * The on-chain metadata field has no MIME slot: the URL extension IS the type declaration, so a
- * bare content-addressed locator (`ar://<txid>`, `<gw>/ipfs/<cid>`) — which has no extension —
- * would make the attached artifact `application/octet-stream`. Extracted from main.ts so the
- * capability-based branch (the exact bug this guards) is unit-testable with fake backends.
- */
-import type { StorageBackend, StoredContent } from '@artblocks/abx-storage';
-export interface UploadResult {
-    /** A fetchable public URL for the file. */
-    locator: string;
-    /** True when `locator` carries the filename (extension → correct declared type on attach). */
-    filenamePreserved: boolean;
-    /** Set when we had to fall back to a bare (extension-less) locator — the caller warns. */
-    fallbackReason?: string;
-}
-/**
- * Store `content` under `name` and return the best available public locator. Preference order:
- *  1. path-addressed host (cloud/S3/R2): the object key IS the filename → `<publicBase>/<name>`.
- *  2. content-addressed host with directory support (ipfs/arweave): wrap the single file in a
- *     one-entry directory → `<base>/<name>` (filename preserved).
- *  3. bare content-addressed locator (e.g. kubo IPFS with no dir-add): `<gw>/ipfs/<cid>` — no
- *     extension; `filenamePreserved: false` so the caller can warn about the octet-stream type.
- * Throws for a backend that can't produce any public URL (e.g. `fs`).
- */
-export declare function uploadAndLocate(backend: StorageBackend, name: string, content: StoredContent): Promise<UploadResult>;
-//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAC,cAAc,EAAE,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAG1E,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB1H"}

package/dist/upload.js

@@ -1,41 +0,0 @@
-import { hashContent } from '@artblocks/abx-storage';
-const trimSlash = (s) => s.replace(/\/+$/, '');
-/**
- * Store `content` under `name` and return the best available public locator. Preference order:
- *  1. path-addressed host (cloud/S3/R2): the object key IS the filename → `<publicBase>/<name>`.
- *  2. content-addressed host with directory support (ipfs/arweave): wrap the single file in a
- *     one-entry directory → `<base>/<name>` (filename preserved).
- *  3. bare content-addressed locator (e.g. kubo IPFS with no dir-add): `<gw>/ipfs/<cid>` — no
- *     extension; `filenamePreserved: false` so the caller can warn about the octet-stream type.
- * Throws for a backend that can't produce any public URL (e.g. `fs`).
- */
-export async function uploadAndLocate(backend, name, content) {
-    if (backend.publicBase && backend.putObject) {
-        await backend.putObject(name, content);
-        return { locator: `${trimSlash(backend.publicBase)}/${name}`, filenamePreserved: true };
-    }
-    if (backend.putDirectory && backend.locator) {
-        try {
-            const { base } = await backend.putDirectory([{ name, bytes: content.bytes, contentType: content.contentType }]);
-            return { locator: `${trimSlash(base)}/${name}`, filenamePreserved: true };
-        }
-        catch (e) {
-            const hash = hashContent(content.bytes);
-            await backend.put(hash, content);
-            const loc = await backend.locator(hash);
-            if (!loc)
-                throw e;
-            return { locator: loc, filenamePreserved: false, fallbackReason: e.message };
-        }
-    }
-    if (backend.locator) {
-        const hash = hashContent(content.bytes);
-        await backend.put(hash, content);
-        const loc = await backend.locator(hash);
-        if (!loc)
-            throw new Error(`backend '${backend.id}' stored the file but returned no durable locator`);
-        return { locator: loc, filenamePreserved: false };
-    }
-    throw new Error(`backend '${backend.id}' can't produce a public URL for an attached file — use ipfs, arweave, or cloud (with a public base).`);
-}
-//# sourceMappingURL=upload.js.map