@artblocks/abx-cli 0.1.0-alpha.0

package/dist/remote.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Talk to a REMOTE resolver's admin control plane — the HTTP form of `abx add` /
+ * `abx index` / `abx forget`, pointed at a hosted node (fly/render/vps) instead of
+ * this machine's local projection. This is the bridge the toolkit was missing: a
+ * contract you deploy here is registered with the *local* store; the resolver baked
+ * into your on-chain tokenURI is a *different* store and must be told separately, or
+ * it answers "unknown project". These helpers do the telling.
+ *
+ * The admin token authorizes indexing control only — never on-chain signing — so the
+ * "no signing key on the host" rule is intact. It lives in `.env` as
+ * ABX_RESOLVER_ADMIN_TOKEN and must match the token set on the resolver.
+ */
+export interface RemoteAddBody {
+    address: string;
+    /** Scan floor — the deploy block. Omit on a re-POST (the nudge) to keep the stored floor + reindex incrementally. */
+    fromBlock?: string;
+    factory?: string;
+    label?: string;
+    description?: string;
+    externalUrl?: string;
+    /** Off-chain operator traits (OpenSea attribute array) — stitched UNDER any on-chain `attributes`. */
+    attributes?: Array<{
+        trait_type: string;
+        value: string | number;
+        display_type?: string;
+    }>;
+    /** Off-chain PER-TOKEN operator traits, `{ "<tokenId>": OpenSeaAttribute[] }` — a Series' editable
+     *  traits (a token's entry wins over the collection-scope `attributes`; on-chain wins over both). */
+    tokenAttributes?: Record<string, Array<{
+        trait_type: string;
+        value: string | number;
+        display_type?: string;
+    }>>;
+    /** Durable locators keyed by on-chain hash, `{ "0x<keccak>": "ipfs://<cid>" }` — lets the resolver
+     *  point `image` at IPFS/Arweave without holding the bytes. Merged over any already stored. */
+    contentLocators?: Record<string, string>;
+    /** Force a full replay even on a re-POST. */
+    full?: boolean;
+}
+export interface RemoteAddResult {
+    ok: boolean;
+    mode: 'full' | 'incremental';
+    elapsedMs: number;
+    project: {
+        address: string;
+        name: string | null;
+        eventCount: number;
+        tokenCount: number;
+        mintedCount: number;
+    };
+}
+/** Normalize a resolver base URL to its `/admin/projects` control-plane endpoint. */
+export declare function adminProjectsUrl(base: string): string;
+/** Register + index a project with a remote resolver (remote `abx add`/`index`). */
+export declare function remoteAddProject(base: string, token: string, body: RemoteAddBody): Promise<RemoteAddResult>;
+/** Stop a remote resolver from indexing a project (remote `abx forget`). */
+export declare function remoteRemoveProject(base: string, token: string, address: string): Promise<void>;
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,UAAU,CAAC,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACxF;yGACqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC,CAAC;IAC7G;mGAC+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC;CAC9G;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAuBD,oFAAoF;AACpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAQjH;AAED,4EAA4E;AAC5E,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrG"}

package/dist/remote.js

@@ -0,0 +1,54 @@
+/**
+ * Talk to a REMOTE resolver's admin control plane — the HTTP form of `abx add` /
+ * `abx index` / `abx forget`, pointed at a hosted node (fly/render/vps) instead of
+ * this machine's local projection. This is the bridge the toolkit was missing: a
+ * contract you deploy here is registered with the *local* store; the resolver baked
+ * into your on-chain tokenURI is a *different* store and must be told separately, or
+ * it answers "unknown project". These helpers do the telling.
+ *
+ * The admin token authorizes indexing control only — never on-chain signing — so the
+ * "no signing key on the host" rule is intact. It lives in `.env` as
+ * ABX_RESOLVER_ADMIN_TOKEN and must match the token set on the resolver.
+ */
+/** Normalize a resolver base URL to its `/admin/projects` control-plane endpoint. */
+export function adminProjectsUrl(base) {
+    return base.replace(/\/+$/, '') + '/admin/projects';
+}
+function authHeaders(token) {
+    return { authorization: `Bearer ${token}`, 'content-type': 'application/json' };
+}
+/** Map a non-2xx admin response into a useful Error (surfaces the server's message). */
+async function asError(label, resp) {
+    let detail = '';
+    try {
+        detail = (await resp.json()).error ?? '';
+    }
+    catch {
+        /* non-JSON body */
+    }
+    if (resp.status === 401) {
+        return new Error(`${label}: 401 unauthorized — ABX_RESOLVER_ADMIN_TOKEN doesn't match the token on the resolver.`);
+    }
+    if (resp.status === 404 && detail.includes('disabled')) {
+        return new Error(`${label}: the resolver has no admin token set — it can't accept remote add/remove. ${detail}`);
+    }
+    return new Error(`${label}: ${resp.status} ${detail || resp.statusText}`);
+}
+/** Register + index a project with a remote resolver (remote `abx add`/`index`). */
+export async function remoteAddProject(base, token, body) {
+    const resp = await fetch(adminProjectsUrl(base), {
+        method: 'POST',
+        headers: authHeaders(token),
+        body: JSON.stringify(body),
+    });
+    if (!resp.ok)
+        throw await asError('remote add', resp);
+    return (await resp.json());
+}
+/** Stop a remote resolver from indexing a project (remote `abx forget`). */
+export async function remoteRemoveProject(base, token, address) {
+    const resp = await fetch(`${adminProjectsUrl(base)}/${address}`, { method: 'DELETE', headers: authHeaders(token) });
+    if (!resp.ok && resp.status !== 404)
+        throw await asError('remote remove', resp);
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6BH,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,iBAAiB,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,EAAC,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAC,CAAC;AAChF,CAAC;AAED,wFAAwF;AACxF,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,IAAc;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAsB,CAAC,KAAK,IAAI,EAAE,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACxB,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,wFAAwF,CAAC,CAAC;IACrH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,8EAA8E,MAAM,EAAE,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa,EAAE,IAAmB;IACrF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAC/C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,MAAM,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAoB,CAAC;AAChD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAa,EAAE,OAAe;IACpF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,EAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAC,CAAC,CAAC;IAClH,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,MAAM,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AAClF,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,15 @@
+import type { Hex } from 'viem';
+export interface ParsedSchema {
+    key: string;
+    paramType: number;
+    auth: number;
+    min: Hex;
+    max: Hex;
+    selectOptions: string[];
+}
+export declare function parseSchemaSpec(spec: string): ParsedSchema;
+/** Parse a full `--schema` value: comma-separated specs. */
+export declare function parseSchemaSpecs(raw: string | undefined): ParsedSchema[];
+/** A human one-line rendering of a parsed schema (for the confirm readout). */
+export declare function describeSchema(s: ParsedSchema): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,MAAM,CAAC;AAO9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAQD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAyD1D;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE,CAMxE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAWtD"}

package/dist/schema.js

@@ -0,0 +1,125 @@
+/**
+ * `--schema` spec parsing for `deploy-code` PostParams.
+ *
+ * The on-chain `setParamSchema(key, paramType, auth, authAddress, lockAfter, min, max, selectOptions)`
+ * carries more than the old CLI format (`key:Type:Auth`) could express — a `Select` REQUIRES its
+ * option list (the contract reverts `InvalidParamSchema` without it), and the Range types carry
+ * `min`/`max` bounds. This parser extends the format with an optional bracket suffix on the Type
+ * token so a single, backwards-compatible string expresses all of it:
+ *
+ *   key:HexColor:TokenOwner                         simple type (unchanged)
+ *   key:Select[Spring|Summer|Autumn|Winter]:Auth    Select — options, pipe-delimited (REQUIRED)
+ *   key:Uint256Range[0..100]:Auth                    Range — inclusive min..max bounds (optional)
+ *   key:Int256Range[-50..50]:Auth
+ *   key:DecimalRange[0..1]:Auth                       decimals, ≤10 places (÷1e10 fixed-point)
+ *   key:Timestamp[2026-01-01..2026-12-31]:Auth        unix seconds OR ISO dates
+ *
+ * Delimiters can't collide: params are comma-separated, fields colon-separated, options
+ * pipe-separated, bounds `..`-separated — and options/bounds live inside `[...]`, so none of the
+ * outer delimiters appear there. Omit the bracket on a Range → unbounded (min=max=0, the prior
+ * behavior). A Select with no bracket, or a bracket on a type that takes none, is a clear error.
+ */
+import { PARAM_TYPES, AUTH_OPTIONS, encodeScalarParam } from '@artblocks/abx-sdk';
+const ZERO32 = `0x${'0'.repeat(64)}`;
+/** The types that accept a `[min..max]` bound (the contract's min/max fields are meaningful here). */
+const BOUNDED_TYPES = new Set(['Uint256Range', 'Int256Range', 'DecimalRange', 'Timestamp']);
+/** min ≤ max in the type's own ordering (mirrors AbxParamsLib's on-chain check, but earlier + clearer). */
+function orderedBounds(typeName, min, max) {
+    if (typeName === 'Int256Range')
+        return BigInt.asIntN(256, BigInt(min)) <= BigInt.asIntN(256, BigInt(max));
+    return BigInt(min) <= BigInt(max);
+}
+export function parseSchemaSpec(spec) {
+    const parts = spec.split(':');
+    if (parts.length !== 3) {
+        throw new Error(`--schema "${spec}" — expected key:Type:Auth (a Select adds options: key:Select[A|B|C]:Auth; a Range adds bounds: key:Uint256Range[0..100]:Auth).`);
+    }
+    const [key, typeToken, authName] = parts;
+    const m = typeToken.match(/^([A-Za-z0-9]+)(?:\[(.*)\])?$/);
+    if (!key || !m)
+        throw new Error(`--schema "${spec}" — malformed type "${typeToken}".`);
+    const typeName = m[1];
+    const bracket = m[2]; // undefined when there is no [...]
+    const paramType = PARAM_TYPES.indexOf(typeName);
+    const auth = AUTH_OPTIONS.indexOf(authName);
+    if (paramType < 0 || auth < 0) {
+        throw new Error(`--schema "${spec}" — Type ∈ {${PARAM_TYPES.join('|')}}, Auth ∈ {${AUTH_OPTIONS.join('|')}}.`);
+    }
+    if (AUTH_OPTIONS[auth].includes('Address')) {
+        throw new Error(`--schema "${spec}" — Address-auth legs need an authAddress; set that schema post-deploy via the contract.`);
+    }
+    let min = ZERO32;
+    let max = ZERO32;
+    let selectOptions = [];
+    if (typeName === 'Select') {
+        if (bracket === undefined) {
+            throw new Error(`--schema "${spec}" — a Select needs its options: ${key}:Select[Option A|Option B|Option C]:${authName}.`);
+        }
+        selectOptions = bracket.split('|').map((o) => o.trim());
+        if (selectOptions.length === 0 || selectOptions.some((o) => o === '')) {
+            throw new Error(`--schema "${spec}" — Select options must be non-empty, e.g. ${key}:Select[A|B|C]:${authName}.`);
+        }
+        if (new Set(selectOptions).size !== selectOptions.length) {
+            throw new Error(`--schema "${spec}" — duplicate Select option in [${selectOptions.join('|')}].`);
+        }
+        for (const o of selectOptions) {
+            if (/[,:\]]/.test(o))
+                throw new Error(`--schema "${spec}" — a Select option can't contain , : or ] (got "${o}"). Use simpler labels.`);
+        }
+    }
+    else if (bracket !== undefined) {
+        if (!BOUNDED_TYPES.has(typeName)) {
+            throw new Error(`--schema "${spec}" — ${typeName} takes no [...]; only ${[...BOUNDED_TYPES].join('/')} take [min..max], and Select takes [options].`);
+        }
+        const mm = bracket.split('..');
+        if (mm.length !== 2)
+            throw new Error(`--schema "${spec}" — bounds are [min..max], e.g. ${key}:${typeName}[0..100]:${authName}.`);
+        try {
+            min = encodeScalarParam(typeName, mm[0].trim(), []).value;
+            max = encodeScalarParam(typeName, mm[1].trim(), []).value;
+        }
+        catch (e) {
+            throw new Error(`--schema "${spec}" — bad bound: ${e.message}`);
+        }
+        if (!orderedBounds(typeName, min, max)) {
+            throw new Error(`--schema "${spec}" — min must be ≤ max (got ${mm[0].trim()}..${mm[1].trim()}).`);
+        }
+    }
+    return { key, paramType, auth, min, max, selectOptions };
+}
+/** Parse a full `--schema` value: comma-separated specs. */
+export function parseSchemaSpecs(raw) {
+    return String(raw ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map(parseSchemaSpec);
+}
+/** A human one-line rendering of a parsed schema (for the confirm readout). */
+export function describeSchema(s) {
+    const type = PARAM_TYPES[s.paramType];
+    const auth = AUTH_OPTIONS[s.auth];
+    let detail = '';
+    if (type === 'Select')
+        detail = `[${s.selectOptions.join(' | ')}]`;
+    else if (s.min !== ZERO32 || s.max !== ZERO32) {
+        const lo = decodeBound(type, s.min);
+        const hi = decodeBound(type, s.max);
+        detail = `[${lo}..${hi}]`;
+    }
+    return `${s.key}:${type}${detail}:${auth}`;
+}
+function decodeBound(typeName, v) {
+    // Cheap display-only decode (the SDK's decodeScalarParam is the canonical one, but this keeps the
+    // readout dependency-light for the two Range cases that matter in a bound).
+    if (typeName === 'Int256Range')
+        return BigInt.asIntN(256, BigInt(v)).toString();
+    if (typeName === 'DecimalRange') {
+        const scaled = BigInt(v);
+        const whole = scaled / 10000000000n;
+        const frac = (scaled % 10000000000n).toString().padStart(10, '0').replace(/0+$/, '');
+        return frac ? `${whole}.${frac}` : `${whole}`;
+    }
+    return BigInt(v).toString();
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/series-traits.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-token marketplace traits for a Series (`deploy-series --attributes <file.json>`).
+ *
+ * The contract already carries per-token `attributes` fields (`SeriesImage.InitParams.tokenFields`,
+ * keyed by tokenId) — exactly like the per-token `image` fields deploy-series already writes. This is
+ * purely the CLI ergonomics of supplying them for a folder of media, so it's extracted here (main.ts
+ * runs the CLI on import, so its helpers aren't unit-testable). The manifest is EITHER:
+ *   • an ARRAY indexed by token id — `[[{trait_type,value}…], …]` (element i = token i); OR
+ *   • an OBJECT keyed by the media FILENAME (with or without extension) or the token-id string.
+ * Each value is an OpenSea attributes array OR a `{name: value}` map (normalized either way).
+ */
+import { type OpenSeaAttribute } from '@artblocks/abx-sdk';
+/** Parse the `--attributes` manifest CONTENT (not a path) into a sparse tokenId → attributes map. */
+export declare function parseSeriesTraits(rawJson: string | undefined, slots: string[]): Map<number, OpenSeaAttribute[]>;
+/**
+ * True when a `--attributes` payload is the Series PER-TOKEN shape — an array whose elements are
+ * themselves attribute arrays/maps (element i = token i), or an object whose VALUES are attribute
+ * arrays/maps (keyed by token id / filename) — as opposed to a flat 1/1 payload (an OpenSea attributes
+ * array `[{trait_type,value}…]` or a single `{name: value}` map). Ambiguity defaults to flat, so a
+ * 1/1's `--attributes` at `abx add` is never mis-read as per-token. Content, not a path.
+ */
+export declare function looksPerTokenAttributes(rawJson: string): boolean;
+/**
+ * Parse a PER-TOKEN `--attributes` payload for an EDIT at `abx add` — no media folder is present, so
+ * only token-id keys resolve (an array indexes by token id; an object's numeric keys are token ids;
+ * filename-only keys can't be mapped and are dropped). Returns a `{ "<tokenId>": OpenSeaAttribute[] }`
+ * map ready for the `tokenAttributes` column. Content, not a path.
+ */
+export declare function parseSeriesTraitsById(rawJson: string): Record<string, OpenSeaAttribute[]>;
+//# sourceMappingURL=series-traits.d.ts.map

package/dist/series-traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"series-traits.d.ts","sourceRoot":"","sources":["../src/series-traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAsB,KAAK,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAE9E,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CA0B/G;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAmBhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAgBzF"}

package/dist/series-traits.js

@@ -0,0 +1,103 @@
+/**
+ * Per-token marketplace traits for a Series (`deploy-series --attributes <file.json>`).
+ *
+ * The contract already carries per-token `attributes` fields (`SeriesImage.InitParams.tokenFields`,
+ * keyed by tokenId) — exactly like the per-token `image` fields deploy-series already writes. This is
+ * purely the CLI ergonomics of supplying them for a folder of media, so it's extracted here (main.ts
+ * runs the CLI on import, so its helpers aren't unit-testable). The manifest is EITHER:
+ *   • an ARRAY indexed by token id — `[[{trait_type,value}…], …]` (element i = token i); OR
+ *   • an OBJECT keyed by the media FILENAME (with or without extension) or the token-id string.
+ * Each value is an OpenSea attributes array OR a `{name: value}` map (normalized either way).
+ */
+import { normalizeAttributes } from '@artblocks/abx-sdk';
+/** Parse the `--attributes` manifest CONTENT (not a path) into a sparse tokenId → attributes map. */
+export function parseSeriesTraits(rawJson, slots) {
+    const out = new Map();
+    if (!rawJson)
+        return out;
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch (e) {
+        throw new Error(`--attributes: not valid JSON (${e.message})`);
+    }
+    const put = (i, v) => {
+        if (v == null)
+            return;
+        const attrs = normalizeAttributes(v);
+        if (attrs.length)
+            out.set(i, attrs);
+    };
+    if (Array.isArray(parsed)) {
+        parsed.forEach((v, i) => { if (i < slots.length)
+            put(i, v); });
+    }
+    else if (parsed && typeof parsed === 'object') {
+        const obj = parsed;
+        slots.forEach((name, i) => {
+            const base = name.replace(/\.[^.]+$/, '');
+            put(i, obj[name] ?? obj[base] ?? obj[String(i)]);
+        });
+    }
+    else {
+        throw new Error('--attributes for a Series expects a JSON array (indexed by token id) or an object keyed by filename / token id — each value an attributes array or a {name: value} map.');
+    }
+    return out;
+}
+/**
+ * True when a `--attributes` payload is the Series PER-TOKEN shape — an array whose elements are
+ * themselves attribute arrays/maps (element i = token i), or an object whose VALUES are attribute
+ * arrays/maps (keyed by token id / filename) — as opposed to a flat 1/1 payload (an OpenSea attributes
+ * array `[{trait_type,value}…]` or a single `{name: value}` map). Ambiguity defaults to flat, so a
+ * 1/1's `--attributes` at `abx add` is never mis-read as per-token. Content, not a path.
+ */
+export function looksPerTokenAttributes(rawJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch {
+        return false;
+    }
+    const isAttr = (v) => v != null && typeof v === 'object' && !Array.isArray(v) && 'trait_type' in v;
+    const isScalar = (v) => v == null || typeof v !== 'object';
+    if (Array.isArray(parsed)) {
+        // Flat = array of {trait_type,value}; per-token = array of arrays/maps (no top-level trait_type).
+        return parsed.length > 0 && parsed.every((v) => Array.isArray(v) || (v != null && typeof v === 'object' && !isAttr(v)));
+    }
+    if (parsed && typeof parsed === 'object') {
+        const vals = Object.values(parsed);
+        // Flat `{name: value}` map = scalar values; per-token = every value is an array/map of traits.
+        return vals.length > 0 && vals.every((v) => !isScalar(v));
+    }
+    return false;
+}
+/**
+ * Parse a PER-TOKEN `--attributes` payload for an EDIT at `abx add` — no media folder is present, so
+ * only token-id keys resolve (an array indexes by token id; an object's numeric keys are token ids;
+ * filename-only keys can't be mapped and are dropped). Returns a `{ "<tokenId>": OpenSeaAttribute[] }`
+ * map ready for the `tokenAttributes` column. Content, not a path.
+ */
+export function parseSeriesTraitsById(rawJson) {
+    const parsed = JSON.parse(rawJson);
+    const out = {};
+    const put = (id, v) => {
+        if (v == null)
+            return;
+        const attrs = normalizeAttributes(v);
+        if (attrs.length)
+            out[id] = attrs;
+    };
+    if (Array.isArray(parsed)) {
+        parsed.forEach((v, i) => put(String(i), v));
+    }
+    else if (parsed && typeof parsed === 'object') {
+        for (const [k, v] of Object.entries(parsed)) {
+            if (/^\d+$/.test(k))
+                put(k, v); // token-id keys only — filenames need the deploy's --dir
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=series-traits.js.map

package/dist/series-traits.js.map

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

package/dist/signer.d.ts

@@ -0,0 +1,80 @@
+import { type Address, type Hex, type PreparedTx } from '@artblocks/abx-sdk';
+import type { TransactionReceipt } from 'viem';
+/**
+ * The signing harness — the one place a write transaction turns into a signature.
+ *
+ * The CLI builds an unsigned {@link PreparedTx}; this picks the *lane* that signs it:
+ *
+ *   • send (hot)     — sign with the env key and broadcast. Autonomous agents, testnet, low stakes.
+ *   • sign (wallet)  — serve a one-shot, operation-aware localhost page; a human approves in their
+ *                      own wallet (the key never touches this process). Real value, mainnet.
+ *   • unsigned (cold)— print the tx data to sign elsewhere (a multisig / offline signer).
+ *
+ * The agent picks the lane; the CLI owns the mechanics. Signing is the only step
+ * that ever differs — everything up to the prepared tx, and the re-index after,
+ * is identical across lanes.
+ */
+export type Lane = 'send' | 'sign' | 'unsigned';
+/** A prepared tx, or — when the signer's address is needed to build it (deploy) — a builder of one. */
+export type TxProvider = PreparedTx | ((signer: Address) => PreparedTx | Promise<PreparedTx>);
+export interface SignOptions {
+    lane: Lane;
+    chainKey: string;
+    /** The address that must sign (onlyOwner / token holder). Shown to the human; guards the hot lane. */
+    expectedSigner?: Address;
+    /** Allow the hot lane on a non-testnet chain (a deliberate mainnet spend). */
+    yes?: boolean;
+    /** Port for the wallet-lane sign page. */
+    port?: number;
+    /** Write the sign-page URL to this file the instant the server is ready — a deterministic,
+     *  race-free way for an agent driving this in the background to capture + relay the URL. */
+    signUrlFile?: string;
+}
+export interface SignResult {
+    txHash: Hex;
+    prepared: PreparedTx;
+    blockNumber: bigint;
+}
+/**
+ * Sign and (for hot/wallet) broadcast a prepared tx via the chosen lane. Returns
+ * the broadcast tx hash, or `null` for the cold lane (nothing is sent — the
+ * caller hands the printed tx to an external signer).
+ */
+export declare function signTx(provider: TxProvider, opts: SignOptions): Promise<SignResult | null>;
+/**
+ * The one sign-page implementation behind the whole wallet lane — single owner ops AND
+ * multi-tx staged deploys both run through it ({@link signWallet} just opens one with
+ * `total: 1`). It keeps a single page open: the human connects once, then approves each tx as
+ * the CLI produces it (`Transaction 1 of N`, …). Each tx's receipt can feed the next (a
+ * chunk's pointers determine the manifest), so the CLI drives the sequence and the page just
+ * follows. Every signature is gated on the right NETWORK and the right SIGNING WALLET, checked
+ * live in the page (and re-checked at sign time) and enforced server-side on `/connect`, so a
+ * wrong-chain or wrong-wallet tx can never be queued. The key never touches this process.
+ */
+export interface SignedReceipt {
+    txHash: Hex;
+    receipt: TransactionReceipt;
+}
+export interface WalletSession {
+    /** Resolves once the human connects a wallet in the browser; yields the connected address. */
+    connect(): Promise<Address>;
+    /** Show + sign the next tx through the open page; resolves with its hash + mined receipt. */
+    send(tx: PreparedTx): Promise<SignedReceipt>;
+    /** Show + `personal_sign` a message through the open page; resolves with the `0x` signature. Used
+     *  to sign Arweave/Turbo upload data-items with the connected wallet (its credits then pay). */
+    signMessage(message: Uint8Array, summary?: string): Promise<Hex>;
+    /** No more items — the page shows "all done", then the server closes. */
+    close(): void;
+}
+export interface WalletSessionOptions {
+    chainKey: string;
+    /** The address that should sign (owner / deployer). Shown to the human; mismatch warns. */
+    expectedSigner?: Address;
+    port?: number;
+    /** Total tx count if known up front — rendered as "Transaction N of total". */
+    total?: number;
+    /** Write the sign-page URL to this file the instant the server is ready (agent capture). */
+    signUrlFile?: string;
+}
+export declare function openWalletSession(opts: WalletSessionOptions): Promise<WalletSession>;
+//# sourceMappingURL=signer.d.ts.map

package/dist/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,MAAM,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhD,uGAAuG;AACvG,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;gGAC4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAShG;AAyFD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,6FAA6F;IAC7F,IAAI,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C;oGACgG;IAChG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjE,yEAAyE;IACzE,KAAK,IAAI,IAAI,CAAC;CACf;AASD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8I1F"}