@artblocks/abx-cli 0.1.0-alpha.4 → 0.1.0-alpha.40

package/dist/onchain-uri.js

@@ -1,243 +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)`), the `params.keys` contract param enumerates the declared param
- * surface (the params store is unenumerable by design — the generator reads this CSV to build
- * on-chain tokenData), and the token's `tokenURIRenderer` toggles tokenURI to the canonical
- * on-chain metadata renderer. All three ride the EXISTING setup multicall, before the mints.
- */
-import { encodeFunctionData, toHex, 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 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 const PARAMS_KEYS = 'params.keys';
-/** ≤ this many chars rides as a literal readable-ASCII bytes32; longer takes the data path. */
-export 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 function composeParamsKeys(writtenParamKeys, schemaKeys) {
-    const keys = new Set([...writtenParamKeys, ...schemaKeys, PARAMS_KEYS]);
-    return [...keys]
-        .map((k) => k.trim())
-        .filter(Boolean)
-        .sort()
-        .filter((k, i, all) => i === 0 || k !== all[i - 1])
-        .join(',');
-}
-/** Whether a CSV fits the literal bytes32 lane (printable ASCII, ≤ 31 bytes). */
-export function paramsKeysIsLiteral(csv) {
-    return csv.length <= PARAMS_KEYS_LITERAL_MAX && /^[\x20-\x7e]+$/.test(csv);
-}
-/** 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 function paramsKeysCall(csv) {
-    if (paramsKeysIsLiteral(csv)) {
-        return {
-            call: encodeFunctionData({
-                abi: seriesCodeAbi,
-                functionName: 'setContractParam',
-                args: [encodeTag(PARAMS_KEYS), encodeTag(csv)],
-            }),
-            encoding: 'literal',
-        };
-    }
-    return {
-        call: encodeFunctionData({
-            abi: seriesCodeAbi,
-            functionName: 'setContractParamData',
-            args: [encodeTag(PARAMS_KEYS), toHex(csv)],
-        }),
-        encoding: '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 function onchainUriSetupCalls(args) {
-    const { call: paramsLeg, encoding } = paramsKeysCall(args.paramsKeys);
-    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(paramsLeg, encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setTokenURIRenderer', args: [args.metadataRenderer] }), encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setContractURIRenderer', args: [args.metadataRenderer] }));
-    return { calls, paramsKeysEncoding: encoding };
-}
-// ── 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 };
-}
-// ── the configure-param nudge (params.keys drift) ──────────────────────────────
-/**
- * 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 function paramsKeysNudge(existingCsv, configuredKey) {
-    if (existingCsv === null || configuredKey === PARAMS_KEYS)
-        return null;
-    const listed = existingCsv.split(',').map((k) => k.trim()).filter(Boolean);
-    if (listed.includes(configuredKey))
-        return null;
-    return composeParamsKeys([...listed, configuredKey], []);
-}
-/** 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 async function readParamsKeys(client, contract) {
-    const [value, valueIsHash, isSet] = (await client.readContract({
-        address: contract,
-        abi: seriesCodeAbi,
-        functionName: 'contractParam',
-        args: [encodeTag(PARAMS_KEYS)],
-    }));
-    if (!isSet)
-        return null;
-    if (!valueIsHash)
-        return decodeTag(value);
-    const data = (await client.readContract({
-        address: contract,
-        abi: seriesCodeAbi,
-        functionName: 'contractParamData',
-        args: [encodeTag(PARAMS_KEYS)],
-    }));
-    return Buffer.from(data.slice(2), 'hex').toString('utf8');
-}
-//# 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/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

package/dist/upload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAWnD,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB,EAAE,IAAY,EAAE,OAAsB;IACjG,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,EAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAC,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAC,CAAC,CAAC,CAAC;YAC5G,OAAO,EAAC,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG;gBAAE,MAAM,CAAC,CAAC;YAClB,OAAO,EAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,EAAG,CAAW,CAAC,OAAO,EAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,EAAE,mDAAmD,CAAC,CAAC;QACrG,OAAO,EAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,EAAE,uGAAuG,CAAC,CAAC;AACjJ,CAAC"}