@artblocks/abx-sdk 0.1.0-alpha.4 → 0.1.0-alpha.41

package/dist/tokens.js

@@ -0,0 +1,317 @@
+import { zeroAddress } from 'viem';
+import { editionCodeAbi, seriesCodeAbi } from './abi/index.js';
+import { readParamSchema } from './ops.js';
+import { AUTH_OPTIONS, decodeTag, encodeTag, PARAM_TYPES } from './spine.js';
+import { decodeParam } from './tokendata.js';
+/**
+ * The whole collection's tokens — seeds, owners, and params — read **from chain alone**.
+ *
+ * No indexer projection, no event scan, no running resolver: every input is a plain `eth_call`
+ * against the token contract, because the params store maintains its own key lists inside its
+ * write paths (`tokenParamKeys` / `contractParamKeys`) and the seed is just a reserved param.
+ * That matters for the question this answers — *for a generative collection the seed list IS the
+ * collection* — since it means the answer is available to anyone with an RPC URL, including
+ * before any indexing has happened, and it can never disagree with the chain.
+ *
+ * Deliberately not built on {@link reconstructProject}: that folds the event spine (a `getLogs`
+ * range scan, which a range-capped RPC can refuse) to recover *structure*. Here every value
+ * wanted is a head read, so a scan would be strictly more fragile for strictly less.
+ */
+/** The reserved param the seed source writes at mint. Never in the enumerable key lists (every
+ *  consumer reads it as a tokenData coordinate), so it is read by name. */
+const SEED_KEY = 'seed';
+/** How many tokens to read concurrently. Each token costs ~2 + (params) `eth_call`s, so a
+ *  1000-token collection is a few thousand reads — wide enough to be quick, narrow enough that a
+ *  free-tier RPC doesn't rate-limit. */
+const DEFAULT_CONCURRENCY = 8;
+/**
+ * Read an edition id's cap without re-deriving the rule at each call site — the derivation this
+ * protocol got wrong twice, in opposite directions: the on-chain getter overloads `0`, and the
+ * event fold used to miss the collection default entirely.
+ *
+ * Pass a folded {@link TokenState} (from `reconstructProject`) to get all three states. Pass a
+ * head-read {@link TokenRow}, which has no `maxSupplyOverridden` because a state read cannot know
+ * it, and a `'0'` cap reads `open` — the documented on-chain convention, and the reason
+ * `IAbxEditionSupply` tells an integrator rendering a buy button to consult the log.
+ *
+ * `null` ⇒ no cap information at all (a 721 token, or a row from a projection written before
+ * `DefaultMaxSupplySet` was folded).
+ */
+export function editionCapOf(token) {
+    if (token.maxSupply === undefined)
+        return null;
+    if (token.maxSupply !== '0')
+        return { kind: 'capped', cap: token.maxSupply };
+    return token.maxSupplyOverridden ? { kind: 'closed' } : { kind: 'open' };
+}
+/** Minimal ERC-165 fragment — shared by any capability check that only needs `supportsInterface`
+ *  (no need to pull in a whole token ABI just for this one function). */
+const ERC165_PROBE_ABI = [
+    {
+        type: 'function',
+        name: 'supportsInterface',
+        stateMutability: 'view',
+        inputs: [{ name: 'interfaceId', type: 'bytes4' }],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+];
+/** The standard's own ERC-165 id — the cheapest capability check that can never collide with a
+ *  721 token (which doesn't implement ERC-1155 at all, so this reverts/returns false there). */
+const ERC1155_INTERFACE_ID = '0xd9b67a26';
+/** Whether `address` is an ERC-1155 edition (vs. the 721 family) — the probe {@link listTokens}
+ *  branches on before choosing its read path. */
+async function probeIsEdition(client, address) {
+    try {
+        return (await client.readContract({
+            address,
+            abi: ERC165_PROBE_ABI,
+            functionName: 'supportsInterface',
+            args: [ERC1155_INTERFACE_ID],
+        }));
+    }
+    catch {
+        return false;
+    }
+}
+/** Every token's owner, seed, and params, straight from the contract. */
+export async function listTokens(client, address, opts = {}) {
+    if (await probeIsEdition(client, address))
+        return listEditionTokens(client, address, opts);
+    const read = async (functionName, args = []) => {
+        try {
+            // dynamic dispatch over the superset ABI — cast past viem's literal-name inference. Every
+            // getter here is absent on at least one token type, so the try/catch IS the capability probe.
+            return (await client.readContract({ address, abi: seriesCodeAbi, functionName, args }));
+        }
+        catch {
+            return null; // absent on this token type, or an unminted id — the caller decides what that means
+        }
+    };
+    const [chainId, nextTokenId, totalSupply, maxInvocations, contractKeys] = await Promise.all([
+        client.getChainId(),
+        read('nextTokenId'),
+        read('totalSupply'),
+        read('maxInvocations'),
+        read('contractParamKeys'),
+    ]);
+    // The params surface is probed by a read that only a params-bearing token answers. `seed` is the
+    // cheapest such probe that works on a LEGACY project too (deployed before enumeration shipped),
+    // so the two capabilities are detected separately rather than collapsed.
+    const seedProbe = await read('tokenParam', [0n, encodeTag(SEED_KEY)]);
+    const hasParams = seedProbe !== null || contractKeys !== null;
+    const hasParamEnumeration = contractKeys !== null;
+    // Schemas are read once per key and shared across every token — on a 1000-token collection this
+    // is the difference between one read per key and one per key PER TOKEN.
+    const schemaCache = new Map();
+    const schemaOf = (key) => {
+        let hit = schemaCache.get(key);
+        if (!hit) {
+            hit = schemaFor(client, address, key);
+            schemaCache.set(key, hit);
+        }
+        return hit;
+    };
+    const contractParams = {};
+    for (const raw of contractKeys ?? []) {
+        const key = decodeTag(raw);
+        const slot = await read('contractParam', [raw]);
+        if (!slot?.[2])
+            continue; // not set
+        const p = { key, value: slot[0], valueIsHash: slot[1], updatedBy: address };
+        contractParams[key] = (await decodeParam(client, address, '0', p, false, await schemaOf(key))).value;
+    }
+    // The id range — an ID SPACE, never a live count. `nextTokenId` is the mint frontier; a token type
+    // without one is a 1/1, whose id space is token 0 alone and stays that way forever.
+    //
+    // This used to fall back to `totalSupply`, which is live (mints − burns): burn a 1/1's only token
+    // and the listing enumerated ZERO ids, so `abx tokens` on a burned 1/1 printed nothing at all —
+    // indistinguishable from a collection with no tokens, when the honest answer is one id whose state
+    // the chain cannot pin down (see {@link TokenRow.lifecycle}'s `'unknown'`). Found by burning a real
+    // token on Sepolia rather than by a fixture, which is the only way this one shows up.
+    const count = nextTokenId !== null ? Number(nextTokenId) : 1;
+    const from = Math.max(0, opts.from ?? 0);
+    const end = opts.limit === undefined ? count : Math.min(count, from + Math.max(0, opts.limit));
+    const ids = Array.from({ length: Math.max(0, end - from) }, (_, i) => from + i);
+    let done = 0;
+    const tokens = await pool(ids, opts.concurrency ?? DEFAULT_CONCURRENCY, async (id) => {
+        const tokenId = String(id);
+        const [owner, seedSlot, keys] = await Promise.all([
+            read('ownerOf', [BigInt(id)]),
+            hasParams ? read('tokenParam', [BigInt(id), encodeTag(SEED_KEY)]) : null,
+            hasParamEnumeration ? read('tokenParamKeys', [BigInt(id)]) : null,
+        ]);
+        const params = {};
+        for (const raw of keys ?? []) {
+            const key = decodeTag(raw);
+            const slot = await read('tokenParam', [BigInt(id), raw]);
+            if (!slot?.[2])
+                continue;
+            const p = { key, value: slot[0], valueIsHash: slot[1], updatedBy: address };
+            params[key] = (await decodeParam(client, address, tokenId, p, true, await schemaOf(key))).value;
+        }
+        opts.onProgress?.(++done, ids.length);
+        // With a frontier, a missing owner below it is a burn — without one (a 1/1), it is not evidence.
+        const lifecycle = owner
+            ? 'live'
+            : nextTokenId === null
+                ? 'unknown'
+                : BigInt(id) < nextTokenId
+                    ? 'burned'
+                    : 'unminted';
+        return { tokenId, owner, lifecycle, seed: seedSlot?.[2] ? seedSlot[0] : null, params };
+    });
+    return {
+        chainId,
+        address,
+        nextTokenId: nextTokenId === null ? null : Number(nextTokenId),
+        totalSupply: totalSupply === null ? null : Number(totalSupply),
+        burnedCount: nextTokenId === null || totalSupply === null ? null : Number(nextTokenId - totalSupply),
+        maxInvocations: maxInvocations === null ? null : Number(maxInvocations),
+        hasParams,
+        hasParamEnumeration,
+        contractParams,
+        tokens,
+    };
+}
+/**
+ * The edition (ERC-1155) path {@link listTokens} delegates to once {@link probeIsEdition} says
+ * yes — a parallel implementation, not a set of `if (isEdition)` branches threaded through the
+ * 721 path above, so that path stays byte-identical. Reads against `editionCodeAbi` (the
+ * narrowest-common-superset ABI for the family, same role `seriesCodeAbi` plays on the 721
+ * side): per id, `totalSupply(id)`/`maxSupply(id)` instead of `ownerOf` — `owner` is always
+ * `null` here (a multi-holder id has no single owner, and *which* holders isn't chain-enumerable
+ * outside the event log). `params`/`seed` still apply — EditionCode composes the same Params/
+ * ConfigurableParams extensions as SeriesCode, unchanged — but are absent (every read reverts,
+ * same honest "absent" answer as a 1/1 image) on `OneOfOneEdition`/`EditionImage`.
+ */
+async function listEditionTokens(client, address, opts) {
+    const read = async (functionName, args = []) => {
+        try {
+            return (await client.readContract({ address, abi: editionCodeAbi, functionName, args }));
+        }
+        catch {
+            return null;
+        }
+    };
+    const [chainId, maxInvocations, contractKeys] = await Promise.all([
+        client.getChainId(),
+        read('maxInvocations'), // absent on OneOfOneEdition — its id space is fixed to {0}
+        read('contractParamKeys'),
+    ]);
+    const seedProbe = await read('tokenParam', [0n, encodeTag(SEED_KEY)]);
+    const hasParams = seedProbe !== null || contractKeys !== null;
+    const hasParamEnumeration = contractKeys !== null;
+    const schemaCache = new Map();
+    const schemaOf = (key) => {
+        let hit = schemaCache.get(key);
+        if (!hit) {
+            hit = schemaFor(client, address, key);
+            schemaCache.set(key, hit);
+        }
+        return hit;
+    };
+    const contractParams = {};
+    for (const raw of contractKeys ?? []) {
+        const key = decodeTag(raw);
+        const slot = await read('contractParam', [raw]);
+        if (!slot?.[2])
+            continue;
+        const p = { key, value: slot[0], valueIsHash: slot[1], updatedBy: address };
+        contractParams[key] = (await decodeParam(client, address, '0', p, false, await schemaOf(key))).value;
+    }
+    // The id space: the id-space cap (`maxInvocations`) when the token has one (EditionImage/
+    // EditionCode); `OneOfOneEdition` has no id-space extension at all — its id space is the
+    // single work, id 0 alone (mirrors the 1/1 count fallback on the 721 path above).
+    const count = maxInvocations !== null ? Number(maxInvocations) : 1;
+    const from = Math.max(0, opts.from ?? 0);
+    const end = opts.limit === undefined ? count : Math.min(count, from + Math.max(0, opts.limit));
+    const ids = Array.from({ length: Math.max(0, end - from) }, (_, i) => from + i);
+    let done = 0;
+    const tokens = await pool(ids, opts.concurrency ?? DEFAULT_CONCURRENCY, async (id) => {
+        const tokenId = String(id);
+        const [supply, maxSupply, seedSlot, keys] = await Promise.all([
+            read('totalSupply', [BigInt(id)]),
+            read('maxSupply', [BigInt(id)]),
+            hasParams ? read('tokenParam', [BigInt(id), encodeTag(SEED_KEY)]) : null,
+            hasParamEnumeration ? read('tokenParamKeys', [BigInt(id)]) : null,
+        ]);
+        const params = {};
+        for (const raw of keys ?? []) {
+            const key = decodeTag(raw);
+            const slot = await read('tokenParam', [BigInt(id), raw]);
+            if (!slot?.[2])
+                continue;
+            const p = { key, value: slot[0], valueIsHash: slot[1], updatedBy: address };
+            params[key] = (await decodeParam(client, address, tokenId, p, true, await schemaOf(key))).value;
+        }
+        opts.onProgress?.(++done, ids.length);
+        return {
+            tokenId,
+            owner: null, // not chain-enumerable for a multi-holder id — indexer territory
+            // Zero live copies. The fold says exactly this for the same id (it declines to spend its extra
+            // history knowledge on a distinction with no consumer), so the two lanes agree by construction
+            // rather than by a docstring promising they do.
+            lifecycle: (supply ?? 0n) > 0n ? 'live' : 'no-live-copies',
+            seed: seedSlot?.[2] ? seedSlot[0] : null,
+            params,
+            supply: supply === null ? undefined : supply.toString(),
+            maxSupply: maxSupply === null ? undefined : maxSupply.toString(),
+        };
+    });
+    return {
+        chainId,
+        address,
+        nextTokenId: null, // editions have no sequential mint cursor — ids are caller-named
+        totalSupply: null, // no unconditional whole-contract total; supply is per id (see each row)
+        burnedCount: null, // per id, not per contract — and undecidable at head anyway (see each row)
+        maxInvocations: maxInvocations === null ? null : Number(maxInvocations),
+        hasParams,
+        hasParamEnumeration,
+        contractParams,
+        tokens,
+    };
+}
+/**
+ * One key's declared schema in the shape {@link decodeParam} wants, or `undefined` when the key is
+ * un-governed or the contract has no schema surface. A schema-less param is a normal, supported
+ * state — its value simply stays raw, which is exactly what `seed` relies on.
+ *
+ * Delegates the read to {@link readParamSchema} (the one implementation, which also backs the
+ * read-modify-write in `set-schema`) and only maps its numeric enums onto their canonical names.
+ */
+async function schemaFor(client, address, key) {
+    try {
+        const s = await readParamSchema(client, address, key);
+        if (!s.exists)
+            return undefined;
+        return {
+            key,
+            paramType: PARAM_TYPES[s.paramType] ?? String(s.paramType),
+            auth: AUTH_OPTIONS[s.auth] ?? String(s.auth),
+            authAddress: s.authAddress === zeroAddress ? null : s.authAddress,
+            lockAfter: String(s.lockAfter),
+            min: s.min,
+            max: s.max,
+            selectOptions: s.selectOptions,
+        };
+    }
+    catch {
+        return undefined; // no schema surface on this token type
+    }
+}
+/** Bounded-concurrency map, order-preserving. */
+async function pool(items, width, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.max(1, Math.min(width, items.length)) }, async () => {
+        for (;;) {
+            const i = next++;
+            if (i >= items.length)
+                return;
+            out[i] = await fn(items[i]);
+        }
+    });
+    await Promise.all(workers);
+    return out;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

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

package/dist/types.d.ts

@@ -8,7 +8,7 @@ export interface ExtensionInfo {
 /**
  * One on-chain metadata value, decoded from the spine: a `field` (the *what*, e.g.
  * "image") carried in a `representation` (the *how*, e.g. "inline" / "keccak256" /
- * "arweave"). See the protocol registry (specs/protocol/onchain-metadata.md).
+ * "arweave"). See the protocol registry (site/content/docs/protocol/metadata.mdx).
  */
 export interface MetadataField {
     field: string;
@@ -33,11 +33,18 @@ export interface ParamSchema {
     max: Hex;
     selectOptions: string[];
 }
-/** The three param lifecycle hooks (any may be null = none). */
+/** The three param lifecycle hooks (any may be null = none), plus whether the set is frozen. */
 export interface ParamHooks {
     configureHook: Address | null;
     augmentHook: Address | null;
+    /** Ownership-change lifecycle — a **VETO**: its revert fails the transfer, and a mint is a
+     *  transfer from `0x0`, so a reverting hook also stops minting. Read `locked` next to it. */
     transferHook: Address | null;
+    /** `lockParamHooks()` was sent: the three addresses above can never change again. The read that
+     *  turns "the hooks are whatever the owner currently says" into something a buyer can verify —
+     *  it matters most for `transferHook`, an unlocked one being a standing power over a collector's
+     *  ability to sell. Folded from `ParamHooksFrozen`. */
+    locked: boolean;
 }
 /** One declared code dependency (Dependencies extension); index 0 = the runtime. */
 export interface DependencyInfo {
@@ -71,13 +78,76 @@ export interface SpineEvent {
 }
 export interface TokenState {
     tokenId: string;
-    minted: boolean;
+    /**
+     * Does a token exist at this id **right now** — the one question a consumer is actually asking.
+     *
+     * - `'unminted'` — ERC-721: a valid id never issued (the deployed-but-unminted state a resolver
+     *   serves warming metadata for). Valid state, not a gap.
+     * - `'live'` — a token exists: a 721 with a holder, or an edition id with `supply > 0`.
+     * - `'burned'` — **terminal, and ERC-721 only.** The id was issued and destroyed, the contract
+     *   disowns it (`tokenURI` reverts `NonexistentToken`), and it can never come back: ABX mints from
+     *   a monotonic `nextTokenId`, so no mint path can reissue that id. This is the word a consumer
+     *   may act on irreversibly — drop it from a gallery, answer `410 Gone`.
+     * - `'no-live-copies'` — **ERC-1155 editions only, and never terminal.** Zero live copies of this
+     *   id right now: never minted, or every copy burned, or minted and fully burned twice over. It
+     *   makes no claim about history *because the two have no different consequence* — the id can mint
+     *   again either way, so anything that treats it as gone forever is wrong. `supply`/`holders`
+     *   carry the numbers; the event log carries the history.
+     *
+     * **Why `'burned'` is not shared across the standards**, though the first draft of this enum shared
+     * it: the correct response to destruction differs by standard, so one word covering both put every
+     * consumer one forgotten branch away from serving `410 Gone` for an edition id that can mint again.
+     * Splitting the word moves the rule out of prose that must be
+     * remembered and into the type: **`lifecycle === 'burned'` is safe to treat as permanent on either
+     * standard, with no carve-out**, which is the only version of this rule that survives a refactor.
+     *
+     * It replaced a `minted: boolean` that latched `true` at mint and was never recomputed on the 721
+     * lane, so a burned token reconstructed as live, held by `0x0`. "Was it ever issued" is
+     * `lifecycle !== 'unminted'` on a 721; on an edition, ask the log.
+     */
+    lifecycle: 'unminted' | 'live' | 'burned' | 'no-live-copies';
+    /** 721 only — the current holder; `null` when `'unminted'` or `'burned'` (a destroyed token has
+     *  no holder — the zero address is never written here, so this field never has to be read as a
+     *  sentinel). Always `null` for an edition (an id can have many concurrent holders; see
+     *  {@link holders}). */
     owner: Address | null;
     tokenURI: string | null;
     fields: MetadataField[];
     lockedFields: string[];
     /** Token-scope params (Params extension) — `seed`, PostParam values, … Absent/empty ⇒ none. */
     params?: ParamValue[];
+    /** ERC-1155 editions only — total live copies of this id (minted − burned), folded from
+     *  `TransferSingle`/`TransferBatch`. Absent for a 721 token. */
+    supply?: string;
+    /**
+     * ERC-1155 editions only — this id's **effective** supply cap: its own override when one exists,
+     * otherwise the collection default ({@link ProjectState.defaultMaxSupply}). Absent for a 721
+     * token. Equals the on-chain `maxSupply(id)` view, and therefore its head-read twin
+     * (`TokenRow.maxSupply` in `tokens.ts`) — one field name, one meaning, whichever lane produced it.
+     *
+     * It used to fold `MaxSupplyUpdated` alone, which made the two lanes disagree on the DEFAULT
+     * shape: `--copies 10` sets the cap at `initialize` and never calls `setMaxSupply`, so no id had
+     * an event of its own and this read *absent* — "open, uncapped" — for every capped edition ever
+     * deployed. The head read said `10`. That is the sibling-drift class, on the field that decides
+     * whether a buy button renders.
+     *
+     * `'0'` carries the on-chain overload deliberately: **open** when {@link maxSupplyOverridden} is
+     * false, **closed forever** when it is true.
+     */
+    maxSupply?: string;
+    /** ERC-1155 editions only — has this id ever been explicitly overridden (`setMaxSupply`)? The
+     *  distinction the on-chain getter cannot make and the log can, now that `DefaultMaxSupplySet`
+     *  completes the log: it disambiguates a `'0'` cap (open vs deliberately closed) and tells you
+     *  whether the monotonic never-increase rule is already in force for this id. Absent ⇒ false. */
+    maxSupplyOverridden?: boolean;
+    /** ERC-1155 editions only — current balances by holder address, folded from
+     *  `TransferSingle`/`TransferBatch`. Zero balances are deleted, so a key's presence IS "holds
+     *  at least one copy." Omitted/empty when unknown (a 721 token, or an edition with no folded
+     *  history). Not chain-enumerable outside the event log — this is why {@link owner} can't
+     *  simply generalize to "the current holders": a chain-only head read (no event scan) has no
+     *  way to list them (see `tokens.ts`'s `listTokens`, which is exactly that head-read-only path
+     *  and therefore never populates this field). */
+    holders?: Record<Address, string>;
 }
 /**
  * The full reconstructed state of an ABX project — rebuilt from the event log
@@ -102,16 +172,48 @@ export interface ProjectState {
         receiver: Address;
         bps: number;
     } | null;
+    /**
+     * The royalty **ceiling** — owner-set at deploy, reduce-only forever after, folded from
+     * `MaxRoyaltyBpsUpdated` (last-writer-wins, so a later `reduceMaxRoyaltyBps` beats the deploy-time
+     * value). Tri-state, and the third state carries weight: `null` means **the spine never stated
+     * one** — an implementation with no `maxRoyaltyBps()` at all — which is a different fact from a
+     * collection that published a ceiling of 1000. Never report a default for a ceiling the contract
+     * never published.
+     *
+     * Deliberately NOT nested inside {@link royalty}: clearing the royalty to `(0x0, 0)` sets that
+     * field to `null`, and the ceiling survives that on chain — nesting would drop a still-binding
+     * fact. Present them together in any readout, though: a rate without its ceiling is half the fact
+     * (a ceiling above the live rate means the owner can raise the rate unilaterally, and a buyer
+     * cannot see that from a listing — so reducing the cap to the current rate is what turns "5%
+     * today" into a promise).
+     */
+    maxRoyaltyBps?: number | null;
+    /**
+     * Did this collection opt into burning (`BurnConfigured`, emitted once at deploy and fixed
+     * thereafter)? Tri-state on the same rule as {@link maxRoyaltyBps}: `null` = the spine never
+     * stated it, which is not `false`. An implementation predating the opt-in has no `burn`
+     * entrypoint at all; a collection with `burnable: false` has one that refuses.
+     */
+    burnable?: boolean | null;
     tokenURIRenderer: Address | null;
     tokenURILocked: boolean | null;
     contractURIRenderer: Address | null;
     contractURILocked: boolean | null;
     collectionFields: MetadataField[];
     lockedCollectionFields: string[];
-    /** Which concrete token type this is, inferred from the enabled extensions. */
-    contractType?: '1of1' | 'series' | 'code';
+    /** Which concrete token type this is, inferred from the enabled extensions. The `-edition`
+     *  suffix is the ERC-1155 family (detected via the Edition Supply extension), a parallel
+     *  ladder to the ERC-721 one: `1of1-edition` ↔ `1of1`, `edition` ↔ `series`,
+     *  `edition-code` ↔ `code`. */
+    contractType?: '1of1' | 'series' | 'code' | '1of1-edition' | 'edition' | 'edition-code';
     /** Supply cap "X of Y" (Max Invocations extension); null/absent ⇒ uncapped 1/1. */
     maxInvocations?: string | null;
+    /** ERC-1155 editions only — the collection-wide DEFAULT per-id cap (`editionSize` at
+     *  `initialize`), folded from `DefaultMaxSupplySet`. `'0'` ⇒ open by default; null ⇒ not an
+     *  edition. The 1155 analogue of {@link maxInvocations}: it is the project-level ceiling, while
+     *  {@link TokenState.maxSupply} is a single id's. Every id that has never been overridden carries
+     *  this, which is why the event exists — see `IAbxEditionSupply`. */
+    defaultMaxSupply?: string | null;
     /** The single authorized minter (External Minter extension); null ⇒ owner-only. */
     minter?: Address | null;
     /** Whether minting is paused (Paused extension) — true ⇒ owner-only. Absent/false ⇒ open. */

package/dist/types.d.ts.map

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

package/dist/util.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Small, environment-neutral helpers shared across the SDK core. Nothing here imports
+ * `node:*` or references a Node-only global (`Buffer`, `process` unguarded) — this module
+ * is reachable from the browser bundle (see `test/browser-bundle.test.ts`), so it has to
+ * run identically wherever a caller (Node, a bundler, a browser tab) loads it.
+ */
+import type { Address, PublicClient } from 'viem';
+/** `process.env[name]`, or `undefined` — safe to call even where `process` doesn't exist
+ *  (a browser bundle). The SDK core never assumes Node; a host (the CLI, the effects
+ *  runner) is where `process.env` is actually meaningful. */
+export declare function readEnv(name: string): string | undefined;
+/** Wait `ms` milliseconds. The one place the SDK debounces/retries, so every caller shares
+ *  the same primitive instead of re-declaring `new Promise((r) => setTimeout(r, ms))`. */
+export declare function sleep(ms: number): Promise<void>;
+/** The delay before retry `attempt` (1-indexed) under a LINEAR backoff: `attempt * baseMs`.
+ *  Matches the shape `service.ts`'s request ladder already used (`retryDelayMs * attempt`) —
+ *  pulled out here so every linear-backoff retry loop (the service client, the effects
+ *  runner's resolver poll) computes the same delay the same way. */
+export declare function linearBackoffDelay(attempt: number, baseMs: number): number;
+/**
+ * The delay before retry `attempt` (1-indexed) under an EXPONENTIAL backoff, capped:
+ * `min(baseMs * 2^(attempt-1), capMs)`. Attempt 1 waits `baseMs`, attempt 2 waits `2*baseMs`,
+ * attempt 3 `4*baseMs`, and so on until the cap takes over.
+ *
+ * Prefer this over {@link linearBackoffDelay} for a SUSTAINED rate limit or an overloaded
+ * upstream, where a caller wants each retry to back off faster than the last so a burst of
+ * callers doesn't keep landing on the same wall-clock second (linear backoff's delays grow by a
+ * constant step, which under sustained pressure just re-synchronizes the retry storm at a lower
+ * frequency instead of spreading it out). Prefer `linearBackoffDelay` for a transient/one-off
+ * failure (a dropped connection, a single flaky read) where the retry ladder just needs to not
+ * hammer immediately — exponential growth there overshoots into multi-minute waits for what was
+ * likely a one-time blip.
+ */
+export declare function exponentialBackoffDelay(attempt: number, baseMs: number, capMs: number): number;
+/**
+ * A parsed `data:` URI (RFC 2397) — the most permissive of the three ad hoc parses this
+ * replaces (a bare `data:,...`, a `;base64` flag anywhere in the parameter list, and an
+ * arbitrary `;charset=...` alongside it). `mime` is empty-string-normalized to `text/plain`
+ * (RFC 2397's own default); `body` is returned VERBATIM — still percent-encoded for a
+ * non-base64 URI, still base64 text for one that is — so the caller decodes it exactly the
+ * way it always did (`decodeURIComponent` vs a base64 decode).
+ */
+export interface ParsedDataUri {
+    mime: string;
+    base64: boolean;
+    body: string;
+}
+/** Parse a `data:` URI, or `null` if `uri` isn't one. */
+export declare function parseDataUri(uri: string): ParsedDataUri | null;
+/**
+ * Read a contract, swallowing any failure ("no data" from a codeless address, a revert on
+ * an extension the target doesn't compose) into `undefined` rather than a throw — the shape
+ * every "does this getter exist / is there even a contract here" caller wants. Replaces the
+ * three near-identical try/catch wrappers this SDK's callers each hand-rolled (a resume
+ * planner's field-by-field read, a state dump's per-getter read, an owner-op's diagnostic
+ * read) with one implementation.
+ *
+ * A caller that wants to DISTINGUISH "no contract at all" from "contract exists but this
+ * call reverted" (the CLI's `assertContractExists` diagnostic) still does that itself — this
+ * helper only knows "did the read come back", not why it didn't.
+ */
+export declare function tryReadContract<T>(client: PublicClient, args: {
+    address: Address;
+    abi: readonly unknown[];
+    functionName: string;
+    args?: readonly unknown[];
+}): Promise<T | undefined>;
+/** Bytes → base64 (RFC 4648). No `Buffer`, no `btoa` — both are runtime-conditional (Node
+ *  lacks the latter, and a stricter embedder than a browser can lack the former too), and the
+ *  SDK core needs exactly one behavior everywhere it runs. */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/** base64 → bytes — the inverse of {@link bytesToBase64}. */
+export declare function base64ToBytes(b64: string): Uint8Array;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,MAAM,CAAC;AAEhD;;6DAE6D;AAC7D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxD;AAED;0FAC0F;AAC1F,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;oEAGoE;AACpE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAS9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CAAC,GACjG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAMxB;AAID;;8DAE8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAYvD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAcrD"}