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

package/dist/deployments.d.ts

@@ -20,9 +20,8 @@
  *     shipped yet, or a private deployment — the operator declares it, the tool never writes it)
  *   - manifest: the canonical address below
  *
- * ALPHA SCOPE: the initial npm alpha ships **testnet only** — Base Sepolia (the default,
- * chainId 84532) and Sepolia (11155111). Mainnet entries are intentionally absent until the
- * canonical set is deployed + funded on mainnet (Distribution roadmap step 4).
+ * ALPHA SCOPE: the npm alpha supports Base Sepolia (the default, chainId 84532) and Sepolia
+ * (11155111). Mainnet entries are absent until canonical infrastructure is deployed and recorded.
  *
  * Changing a contract → redeploy → repoint here: see contracts/README.md#changing-a-contract.
  */
@@ -36,9 +35,71 @@ export interface ChainDeployment {
     fixedPriceMinter?: Address;
     seedSource?: Address;
     generator?: Address;
+    oneOfOneEditionFactory?: Address;
+    editionFactory?: Address;
+    editionCodeFactory?: Address;
+    fixedPriceMinter1155?: Address;
+    metadataLib?: Address;
+    paramsLib?: Address;
+    codeLib?: Address;
+    editionLib?: Address;
 }
+/**
+ * One generation of the six trust anchors — a single redeploy batch of the token layer.
+ *
+ * **Identified by the on-chain core version**, and that choice is the whole design. `abxVersion()`
+ * is on every clone and in its `AbxDeployed` beacon, so a collection can say what it is by reading
+ * *itself* — which keeps working after its factory is retired, and cannot be an assertion our
+ * manifest makes on a contract's behalf. The alternative (a semver label we mint here) would be a
+ * third version dial next to core v2 and renderer spec v11, and unverifiable.
+ *
+ * The invariant that makes the identity work — **one core version, one anchor generation** — is a
+ * step in the redeploy checklist (`contracts/README.md`) and is enforced by `deployments.test.ts`:
+ * the recorded generations must have unique, increasing `coreVersion`s, and the newest must match
+ * `AbxVersion.CORE_VERSION` in the contracts. A batch that forgets to bump fails the suite instead
+ * of shipping two generations that both claim to be v2.
+ *
+ * Not backfilled. The generations that preceded this one were testnet-only and are deliberately
+ * unenumerated (greenfield: a pre-launch collection re-registers or redeploys, and reads as
+ * not-canonical until it does). The shape ships now so the *forward* answer exists from the first
+ * batch that retires one.
+ */
+export interface AnchorGeneration {
+    /** The core spec version clones of this generation report as `abxVersion()`. */
+    coreVersion: number;
+    /** ISO date the batch went live on chain (same date on every chain — CREATE2). */
+    deployed: string;
+    /** ISO date it was superseded. Absent ⇒ this is the current generation. */
+    retired?: string;
+    /** The six trust anchors, and nothing else. Never libraries or shared singletons. */
+    factories: {
+        factory: Address;
+        seriesFactory: Address;
+        seriesCodeFactory: Address;
+        oneOfOneEditionFactory: Address;
+        editionFactory: Address;
+        editionCodeFactory: Address;
+    };
+    /** What this generation is, for a human reading a provenance answer. Never dispatched on. */
+    note?: string;
+}
+/**
+ * Every anchor generation, newest first. `[0]` is current (no `retired` date).
+ *
+ * The addresses are *referenced* from {@link CANONICAL} rather than re-typed, so the current
+ * generation cannot drift from the live record — there is one literal per address in this file. When
+ * a batch retires this generation, its six literals move into a new entry below (the only place a
+ * superseded anchor is allowed to appear), it gains a `retired` date, and the new batch takes the
+ * live record. See {@link AnchorGeneration} for why the core version is the identity.
+ */
+export declare const ANCHOR_GENERATIONS: readonly AnchorGeneration[];
+/** The generation currently stamping clones — {@link ANCHOR_GENERATIONS}`[0]`, by construction. */
+export declare function currentAnchorGeneration(): AnchorGeneration;
 export declare const DEPLOYMENTS: Record<number, ChainDeployment>;
-/** The canonical deployment record for a chain (empty if the chain isn't shipped yet). */
+/** The canonical deployment record a *new* deploy on this chain should use (empty if the chain
+ *  isn't shipped yet). Not "what this already-deployed collection points at" — reconstruct that
+ *  collection, then read `state.tokenURIRenderer` and `generatorFor(state)`. Later releases can
+ *  move the canonical singletons without changing addresses already stored by a collection. */
 export declare function getDeployment(chainId: number): ChainDeployment;
 export declare function resolveFactory(chainId: number, override?: string): Address | undefined;
 export declare function resolveSeriesFactory(chainId: number, override?: string): Address | undefined;
@@ -47,10 +108,14 @@ export declare function resolveChunkStore(chainId: number, override?: string): A
 export declare function resolveFixedPriceMinter(chainId: number, override?: string): Address | undefined;
 export declare function resolveSeriesCodeFactory(chainId: number, override?: string): Address | undefined;
 export declare function resolveSeedSource(chainId: number, override?: string): Address | undefined;
+export declare function resolveOneOfOneEditionFactory(chainId: number, override?: string): Address | undefined;
+export declare function resolveEditionFactory(chainId: number, override?: string): Address | undefined;
+export declare function resolveEditionCodeFactory(chainId: number, override?: string): Address | undefined;
+export declare function resolveFixedPriceMinter1155(chainId: number, override?: string): Address | undefined;
 export declare function resolveGenerator(chainId: number, override?: string): Address | undefined;
 /**
  * The known `name@version` resolution roots per chain — Art Blocks' DependencyRegistryV0
- * (specs/protocol/dependency-registry.md). ABX points at it and speaks its READ interface;
+ * (site/content/docs/protocol/code-projects.mdx). ABX points at it and speaks its READ interface;
  * we never deploy our own. The pointer a collection stores is soft and non-validating, so
  * a chain with no entry simply deploys without one (the resolver falls back to its built-in
  * CDN map) — never a blocker.

package/dist/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,MAAM,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAqBD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAevD,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE9D;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE/F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAExF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG1D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEjG"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,MAAM,CAAC;AAGlC,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAK/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,sBAAsB,EAAE,OAAO,CAAC;QAChC,cAAc,EAAE,OAAO,CAAC;QACxB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgFD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAczD,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,uBAAuB,IAAI,gBAAgB,CAE1D;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAsBvD,CAAC;AAEF;;;+FAG+F;AAC/F,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE9D;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE/F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzF;AAID,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAErG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEjG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEnG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAExF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG1D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEjG"}

package/dist/deployments.js

@@ -1,38 +1,134 @@
+import { readEnv } from './util.js';
 /**
  * The cross-chain-identical set — CREATE2 (keyless proxy + `AbxSalts`), so these addresses are the
  * SAME on every chain. Factory addresses list their EIP-1167 implementation; the implementations are
  * identical cross-chain too (a factory does exactly one CREATE at nonce 1 from its own — identical —
- * address). The renderer is spec v3 (artifacts manifest + authorship/rights contractURI fields).
- * SeriesCode's delegatecalled write-path libraries are also CREATE2-deterministic and identical
- * everywhere: AbxParamsLib 0x7DAa26bADD99812a77384B461b6375e0c04F2865,
- * AbxCodeLib 0xCd12078E81A3BDEACdcd57AE390f4D59F832766B.
+ * address). The renderer is **spec v11** — the version `isCurrentRenderer` gates on, and the reason a
+ * behind-spec renderer is treated as stale rather than merely older: each bump changed what the
+ * document actually contains (v5 escaped the provenance note, v6 changed rendered output for hostile
+ * input, v7 renamed the `artist` collection field to `creator`, v8 retired the `abx_params` block and
+ * narrowed provenance to the route a field took rather than a claim about its destination, v9 stopped
+ * duplicating a computed image into `artifacts`, which changes what the document contains, v10 added
+ * four reserved keys neither plane emitted, and v11 moved `ipfs`/`arweave` out of the fallback set:
+ * a v10 renderer serves the placeholder SVG for chain state a v11 renderer resolves).
+ *
+ * The delegatecalled write-path libraries are CREATE2-deterministic and identical everywhere too —
+ * that is a property of CREATE2, not a lucky accident, and linking a library does not cost the
+ * linking factory its own deterministic address (see `create2.ts`'s write-path-library note, which
+ * explains what IS a real trap here). They are deployed EXPLICITLY at `AbxSalts.METADATA_LIB` /
+ * `.PARAMS_LIB` / `.CODE_LIB` / `.EDITION_LIB` (`abx.lib.metadata.v1` / `abx.lib.params.v1` /
+ * `abx.lib.code.v1` / `abx.lib.edition.v1`) by
+ * `DeployLibraries.s.sol` and by the SDK's own bootstrap — not by forge's automatic linking, which
+ * routes through the same proxy but at its own salt of zero. So every library address below is
+ * recomputable from (proxy, salt, creation bytecode) alone: `predictMetadataLib()` /
+ * `predictParamsLib()` / `predictCodeLib()` / `predictEditionLib()`.
+ *
+ * NO SUPERSEDED ADDRESS IS EVER LIVE STATE IN THIS FILE, deliberately — and the rule is narrower and
+ * more useful than "no old addresses anywhere", which is what it used to say while the entries below
+ * carried `replaces 0x…` notes. The hazard was never provenance; it is a stale address sitting where
+ * something might *bind* it, because several superseded contracts still have code on chain and a
+ * factory bound to an un-manifested library is the exact failure this file exists to prevent. So:
+ *
+ *   · The live record ({@link CANONICAL} + the per-chain blocks) holds only what is current. A
+ *     superseded address may appear beside it as a `replaces 0x…` note, which is prose, and inside
+ *     {@link ANCHOR_GENERATIONS}, which is typed to hold nothing but the six FACTORY anchors — never
+ *     a library, renderer, minter or seed source, the entries where a wrong bind would do damage.
+ *   · {@link ANCHOR_GENERATIONS} is **provenance, never trust.** It answers "was this deployed by an
+ *     ABX factory, and which generation" — it must never widen an allowlist or feed
+ *     `verifyCanonical`.
+ *
  */
 const CANONICAL = {
-    factory: '0xB9eEE39DB7D03E0b94CE403F69E928e2a5F134Ca', // impl 0xf1F0893897CC19e75d829fa550a5228c5119cA39
-    seriesFactory: '0x9d97C00100351682e6625961e033b6F43E60639A', // impl 0x58D8b9F7ABa3043734cBeBfaa9c46875070E16ed
-    seriesCodeFactory: '0x77f61Ead461f368dbF3788EeFe9693bA5a73Bd87', // impl 0xfd2034B6af517AD019f0dD7b007F07eF358D4053
-    renderer: '0x837A5cF907E7a6727B08acfE2A865F2bD5C50b1D', // spec v3
-    chunkStore: '0x03d3a962602093a937B96ee9C0b5C54cec3e701E',
-    fixedPriceMinter: '0xd970A2c936FFbb2130c2e4Ddf4245FF92465fEA5',
-    seedSource: '0x53eDFD2047e00C133378DEb430183DEE285E652e',
+    // Superseded addresses stay out of the live manifest. Two properties hold for every entry:
+    //   1. Identical on Sepolia and Base Sepolia — CREATE2 through the keyless proxy at the canonical
+    //      salts in `AbxSalts.sol` / `ABX_SALT`. Only `generator` differs per chain (its constructor
+    //      bakes chain-specific immutables), which is why it lives in the per-chain blocks below.
+    //   2. Recomputable from this build alone — `predictFactory()`, `predictRenderer()`,
+    //      `predictSeriesCodeFactory()` and friends reproduce every one of them, and the write-path
+    //      libraries are now deployed EXPLICITLY by `DeployLibraries.s.sol` at named salts rather
+    //      than by forge's automatic linking at salt zero.
+    //
+    // Implementations are noted inline because a factory's implementation is the code a clone runs;
+    // `abxVersion()` reads 2 on all six, and `specVersion()` reads 11 on the renderer.
+    factory: '0x2824F4b4b4301dB2FcA10b2D80D45b4d463Ba57E', // impl 0x58b5CA27C76c0a1FA00b6ebe28d55d3A98eB1425
+    seriesFactory: '0x685B4DfC835b6854590B5437C79D62BB7D52698b', // impl 0x1A8d16407247E801bf15e3c6Dbf2000673Ff474d
+    seriesCodeFactory: '0xdDA5174A868A8e099E159E67569900a4F936CFFe', // impl 0xdaEF4B7068c07E380068895aCb48a210cdA30297
+    oneOfOneEditionFactory: '0x6ecc7fAd2186965BaECD0Aa215b00239a3459ddF', // impl 0xCbD54eb6781F7A430C974fcbe125B48d4dF1f415
+    editionFactory: '0xB6a8f051B08A8d6Fb0B6DA53BD23006CE2da31b7', // impl 0x90A674bce7540eBae92CAa3Ea77ccE1b7eb15f61
+    editionCodeFactory: '0x9441Cc75318E20Ae6237EDb213b4C3019d756Bf0', // impl 0x68E57D289288dcAf31256d91c64583254bBb6601
+    renderer: '0x85C1aE1F076d808fF7c1729F21B85038Fa16105E', // spec v11
+    chunkStore: '0x1Ca63a4ADEeF5e722ADA25b892BA40E3b2bcB905',
+    seedSource: '0xD01d4eDc17F8b4493A43A5e70DCD9813FB1b9A0A',
+    fixedPriceMinter: '0x1E321A12386cF6BEe49d1270A5EC54DecA88db48',
+    fixedPriceMinter1155: '0x8FcC37dCb00A02367838Fa5B37347dCEec060981',
+    // The delegatecalled write-path libraries. Every one of the six token implementations links
+    // `AbxMetadataLib` — the on-chain metadata field store is external as of this generation, which is
+    // what bought the two code types their EIP-170 headroom (and is why the two ERC-721 image
+    // factories, which linked NOTHING before, link one now). On top of that: `AbxParamsLib` +
+    // `AbxCodeLib` for the two code types, `AbxEditionLib` for all three ERC-1155 types (and
+    // `AbxEditionLib` itself links `AbxParamsLib`, which is why it is deployed after it).
+    // Recomputable via `predictMetadataLib()` / `predictParamsLib()` / `predictCodeLib()` /
+    // `predictEditionLib()`.
+    metadataLib: '0x02b819Bb9065cAf0c598A5CB2f5D37A4eb07460f',
+    paramsLib: '0x396848cD90aDAbE1F463Cb825ed6507A026dC833',
+    codeLib: '0x8dF597246C851E2DF264C8a322c07657395415fc',
+    editionLib: '0x7c7D213383D6FC3F1e26A0cB3Ad554c1Aa0011dA',
 };
+/**
+ * Every anchor generation, newest first. `[0]` is current (no `retired` date).
+ *
+ * The addresses are *referenced* from {@link CANONICAL} rather than re-typed, so the current
+ * generation cannot drift from the live record — there is one literal per address in this file. When
+ * a batch retires this generation, its six literals move into a new entry below (the only place a
+ * superseded anchor is allowed to appear), it gains a `retired` date, and the new batch takes the
+ * live record. See {@link AnchorGeneration} for why the core version is the identity.
+ */
+export const ANCHOR_GENERATIONS = [
+    {
+        coreVersion: 2,
+        deployed: '2026-08-20',
+        factories: {
+            factory: CANONICAL.factory,
+            seriesFactory: CANONICAL.seriesFactory,
+            seriesCodeFactory: CANONICAL.seriesCodeFactory,
+            oneOfOneEditionFactory: CANONICAL.oneOfOneEditionFactory,
+            editionFactory: CANONICAL.editionFactory,
+            editionCodeFactory: CANONICAL.editionCodeFactory,
+        },
+        note: 'Current canonical testnet factory generation.',
+    },
+];
+/** The generation currently stamping clones — {@link ANCHOR_GENERATIONS}`[0]`, by construction. */
+export function currentAnchorGeneration() {
+    return ANCHOR_GENERATIONS[0];
+}
 export const DEPLOYMENTS = {
-    // Sepolia (testnet) — CANONICAL infra + its own generator. Generator wired to AB's Sepolia
-    // dependency registry; default gateways ipfs.io / arweave.net.
+    // Sepolia (testnet). Generator wired to Art Blocks' Sepolia DependencyRegistryV0
+    // (0x5Fcc415BCFb164C5F826B5305274749BeB684e9b); SSTORE2 asset pointers
+    // abxJsPointer 0xe34D9e7054c85E5dCfAFBD0c1E8ff48E206ebBf7,
+    // gunzipScriptPointer 0xC8739F87eDE0278532ACE0f51936b4A3fA8d5C55.
     11155111: {
         ...CANONICAL,
-        generator: '0x819D26830E1FbD1a3b383EcA1C24bc2770000910',
+        // Replaces 0xf099C8fc301340dE2C4D1D2b76fcA05D852dF14A: the directory branch reads the
+        // collection's `abx_gateway_*` field instead of the `display.gateway` param. Redeployed with the
+        // pointers above PINNED, so only the generator moved — the assets did not have to be rewritten.
+        generator: '0xb7104ADfa6fb5615E46e2a681A2Ff043B08fADB5',
     },
-    // Base Sepolia (testnet) — same CANONICAL infra; its own generator (no AB DependencyRegistry on
-    // this chain, so deployed with defaultDependencyRegistry = address(0); collections point at
-    // their own). Runtime asset pointers (SSTORE2): abxJsPointer 0x4525c352EFaeb3F3124399706Ec33B95f2230410,
-    // gunzipScriptPointer 0xa8Bc1339781deEbeb1eC949cD0641eb53D1044a6.
+    // Base Sepolia (testnet). No Art Blocks DependencyRegistry on this chain, so the generator is
+    // deployed with defaultDependencyRegistry = address(0) — collections point at their own. SSTORE2
+    // asset pointers: abxJsPointer 0xF5c9CE4486574c962fA61EdB297845085B6736Ab,
+    // gunzipScriptPointer 0xB162Fa1B55b9Ad6e1c211c02f4c3f60c87036f03. Recorded here because they are
+    // the ONLY way to re-run `DeployAbxGenerator` idempotently — without them the script writes fresh
+    // pointers, which moves the generator's CREATE2 address and quietly deploys a second one.
     84532: {
         ...CANONICAL,
-        generator: '0x229337CA6A442b266BD43B7C70F0f24A2E378cB2',
+        generator: '0x2C1B7Cf6c54E4ACbcB54FCC395f7Af88eb4fc8CE',
     },
 };
-/** The canonical deployment record for a chain (empty if the chain isn't shipped yet). */
+/** The canonical deployment record a *new* deploy on this chain should use (empty if the chain
+ *  isn't shipped yet). Not "what this already-deployed collection points at" — reconstruct that
+ *  collection, then read `state.tokenURIRenderer` and `generatorFor(state)`. Later releases can
+ *  move the canonical singletons without changing addresses already stored by a collection. */
 export function getDeployment(chainId) {
     return DEPLOYMENTS[chainId] ?? {};
 }
@@ -41,32 +137,45 @@ function pick(override, env, manifest) {
     return (override ?? env ?? manifest);
 }
 export function resolveFactory(chainId, override) {
-    return pick(override, process.env.ABX_FACTORY, getDeployment(chainId).factory);
+    return pick(override, readEnv('ABX_FACTORY'), getDeployment(chainId).factory);
 }
 export function resolveSeriesFactory(chainId, override) {
-    return pick(override, process.env.ABX_SERIES_FACTORY, getDeployment(chainId).seriesFactory);
+    return pick(override, readEnv('ABX_SERIES_FACTORY'), getDeployment(chainId).seriesFactory);
 }
 export function resolveRenderer(chainId, override) {
-    return pick(override, process.env.ABX_RENDERER, getDeployment(chainId).renderer);
+    return pick(override, readEnv('ABX_RENDERER'), getDeployment(chainId).renderer);
 }
 export function resolveChunkStore(chainId, override) {
-    return pick(override, process.env.ABX_CHUNK_STORE, getDeployment(chainId).chunkStore);
+    return pick(override, readEnv('ABX_CHUNK_STORE'), getDeployment(chainId).chunkStore);
 }
 export function resolveFixedPriceMinter(chainId, override) {
-    return pick(override, process.env.ABX_FIXED_PRICE_MINTER, getDeployment(chainId).fixedPriceMinter);
+    return pick(override, readEnv('ABX_FIXED_PRICE_MINTER'), getDeployment(chainId).fixedPriceMinter);
 }
 export function resolveSeriesCodeFactory(chainId, override) {
-    return pick(override, process.env.ABX_SERIES_CODE_FACTORY, getDeployment(chainId).seriesCodeFactory);
+    return pick(override, readEnv('ABX_SERIES_CODE_FACTORY'), getDeployment(chainId).seriesCodeFactory);
 }
 export function resolveSeedSource(chainId, override) {
-    return pick(override, process.env.ABX_SEED_SOURCE, getDeployment(chainId).seedSource);
+    return pick(override, readEnv('ABX_SEED_SOURCE'), getDeployment(chainId).seedSource);
+}
+// ERC-1155 editions — same override → env → manifest precedence as every resolver above.
+export function resolveOneOfOneEditionFactory(chainId, override) {
+    return pick(override, readEnv('ABX_ONE_OF_ONE_EDITION_FACTORY'), getDeployment(chainId).oneOfOneEditionFactory);
+}
+export function resolveEditionFactory(chainId, override) {
+    return pick(override, readEnv('ABX_EDITION_FACTORY'), getDeployment(chainId).editionFactory);
+}
+export function resolveEditionCodeFactory(chainId, override) {
+    return pick(override, readEnv('ABX_EDITION_CODE_FACTORY'), getDeployment(chainId).editionCodeFactory);
+}
+export function resolveFixedPriceMinter1155(chainId, override) {
+    return pick(override, readEnv('ABX_FIXED_PRICE_MINTER_1155'), getDeployment(chainId).fixedPriceMinter1155);
 }
 export function resolveGenerator(chainId, override) {
-    return pick(override, process.env.ABX_GENERATOR, getDeployment(chainId).generator);
+    return pick(override, readEnv('ABX_GENERATOR'), getDeployment(chainId).generator);
 }
 /**
  * The known `name@version` resolution roots per chain — Art Blocks' DependencyRegistryV0
- * (specs/protocol/dependency-registry.md). ABX points at it and speaks its READ interface;
+ * (site/content/docs/protocol/code-projects.mdx). ABX points at it and speaks its READ interface;
  * we never deploy our own. The pointer a collection stores is soft and non-validating, so
  * a chain with no entry simply deploys without one (the resolver falls back to its built-in
  * CDN map) — never a blocker.
@@ -76,6 +185,6 @@ export const AB_DEPENDENCY_REGISTRY = {
     11155111: '0x5Fcc415BCFb164C5F826B5305274749BeB684e9b', // Sepolia
 };
 export function resolveDependencyRegistry(chainId, override) {
-    return pick(override, process.env.ABX_DEPENDENCY_REGISTRY, AB_DEPENDENCY_REGISTRY[chainId]);
+    return pick(override, readEnv('ABX_DEPENDENCY_REGISTRY'), AB_DEPENDENCY_REGISTRY[chainId]);
 }
 //# sourceMappingURL=deployments.js.map

package/dist/deployments.js.map

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

package/dist/deps.d.ts

@@ -11,10 +11,15 @@
  *     in bytes32 — read directly, never through a registry.
  *
  * Also speaks the AB-compatible registry READ interface (`IDependencyRegistryV0`,
- * specs/protocol/dependency-registry.md): `getDependencyDetails(bytes32)` is the
- * load-bearing read behind the CLI's best-effort selection-time check.
+ * site/content/docs/protocol/code-projects.mdx): `getDependencyDetails(bytes32)` is the
+ * load-bearing read behind the CLI's best-effort selection-time check, and
+ * `getDependencyScript(bytes32, index)` is the resolver's own read for on-chain bytes (see the
+ * "resolver's registry-aware serving lane" section below — shared with
+ * `@artblocks/abx-token-api`, because it uses this exact
+ * vocabulary end to end).
  */
-import { type Address, type Hex } from 'viem';
+import { type Address, type Hex, type PublicClient } from 'viem';
+import type { DependencyInfo, ProjectState } from './types.js';
 /** `IAbxDependencies.Resolution` — index-aligned with the Solidity enum. */
 export declare const DEP_RESOLUTION: {
     readonly registry: 0;
@@ -40,9 +45,16 @@ export declare function parseDependencyRef(input: string): ParsedDependencyRef;
 /** The reverse read: an evented `(resolution, bytes32)` back to its human form (the twin of
  *  the reconstruction fold's decode — registry ⇒ the tag, onchain ⇒ the address). */
 export declare function decodeDependencyRef(resolution: DepResolution, ref: Hex): string;
-/** The load-bearing read of AB's `IDependencyRegistryV0` — the exact upstream signature
- *  (any registry ABX consumers read from speaks this shape; see the dependency-registry spec). */
-export declare const dependencyRegistryReadAbi: readonly [{
+/**
+ * The load-bearing reads of AB's `IDependencyRegistryV0` — the exact upstream signatures (any
+ * registry ABX consumers read from speaks this shape; see the dependency-registry spec).
+ * `getDependencyDetails` backs both the CLI's best-effort selection-time check and the
+ * resolver's own resolution; `getDependencyScript` is the resolver-only per-chunk read for a
+ * dep whose bytes live on chain. (Merging this hoist: token-api's `DEPENDENCY_REGISTRY_ABI` and
+ * this module's prior `dependencyRegistryReadAbi` declared the identical `getDependencyDetails`
+ * entry twice — one array now backs both callers.)
+ */
+export declare const DEPENDENCY_REGISTRY_ABI: readonly [{
     readonly type: "function";
     readonly name: "getDependencyDetails";
     readonly stateMutability: "view";
@@ -78,6 +90,20 @@ export declare const dependencyRegistryReadAbi: readonly [{
         readonly name: "scriptCount";
         readonly type: "uint24";
     }];
+}, {
+    readonly type: "function";
+    readonly name: "getDependencyScript";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "dependencyNameAndVersion";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
 }];
 /** What the selection-time check cares about from a registry record. */
 export interface RegistryDependencyDetails {
@@ -106,4 +132,95 @@ export interface DependencyReadClient {
  * (a revert) or "check unavailable" (RPC down); this stays a pure read.
  */
 export declare function readRegistryDependency(client: DependencyReadClient, registry: Address, ref: Hex): Promise<RegistryDependencyDetails | null>;
+/**
+ * The registry pointer a deploy with ≥1 Registry-resolution dep should set: an explicit
+ * `--dep-registry` wins (validated), else the chain's known AB registry (env-overridable),
+ * else none — the caller WARNS and skips the leg (soft pointer; the resolver falls back to
+ * its built-in CDN map). Never a blocker.
+ */
+export declare function resolveDepRegistryPointer(flagValue: string | undefined, chainId: number): {
+    registry: Address | null;
+    source: 'flag' | 'default' | 'none';
+};
+/**
+ * The dependency legs of the setup multicall: one `setDependency(i, resolution, ref)` per
+ * dep in index order, plus the `setDependencyRegistry` leg when a pointer resolved. These
+ * ride the SAME atomic setup multicall as script chunks/schemas/mints, in every signing lane.
+ */
+export declare function dependencySetupCalls(deps: ParsedDependencyRef[], registry: Address | null): Hex[];
+/** One dep's selection-time verdict (Registry-resolution deps only — OnChain refs never touch a registry). */
+export type DepCheck = {
+    dep: string;
+    status: 'found';
+    details: RegistryDependencyDetails;
+} | {
+    dep: string;
+    status: 'not-found';
+} | {
+    dep: string;
+    status: 'skipped';
+};
+/**
+ * Best-effort existence/on-chain-ness check of every Registry-resolution dep against the
+ * pointer registry. A revert or an empty record ⇒ `not-found` (a warning — the owner may
+ * intend a custom registry). A transport failure ⇒ the remaining checks are `skipped` and
+ * `rpcOk: false` — one info line, never an error: the deploy proceeds regardless.
+ */
+export declare function checkRegistryDeps(client: DependencyReadClient, registry: Address, deps: ParsedDependencyRef[]): Promise<{
+    checks: DepCheck[];
+    rpcOk: boolean;
+}>;
+/** What a registry ref resolved to: on-chain bytes (decompressed, inline-ready JS) or a CDN URL. */
+export type RegistryResolution = {
+    kind: 'onchain';
+    script: string;
+} | {
+    kind: 'cdn';
+    url: string;
+};
+export interface RegistryResolveOptions {
+    /** Decompress gzip bytes — required only when the resolved dependency is on-chain bytes
+     *  (`availableOnChain` with `scriptCount > 0`); a CDN-resolved or unresolved dep never needs
+     *  it. Omitting it in that case throws {@link InflateRequiredError} naming the fix. */
+    inflate?: (bytes: Uint8Array) => Uint8Array;
+}
+/** Reset the in-process registry-resolution cache — for tests. */
+export declare function resetRegistryDependencyCache(): void;
+/** The collection's registry pointer, if set to a real address (zero/undefined ⇒ none). */
+export declare function activeRegistry(state: ProjectState): Address | null;
+/**
+ * Resolve one `name@version` ref through the collection's registry. Returns the resolution
+ * (or null when the registry couldn't answer — caller falls back to the built-in map) plus
+ * whether it was served from cache. Never throws for a resolution failure; a fresh one logs ONE
+ * warn (the negative cache rate-limits it) naming the dep and why. DOES throw
+ * {@link InflateRequiredError} when the resolution needs decompression and `opts.inflate` is
+ * absent — that is a caller-configuration bug, not a resolution outcome.
+ */
+export declare function resolveRegistryDep(client: PublicClient, registry: Address, dep: DependencyInfo, opts?: RegistryResolveOptions): Promise<{
+    resolution: RegistryResolution | null;
+    cached: boolean;
+    error?: string;
+}>;
+/**
+ * Resolve a `name@version` registry ref to a CDN URL — the built-in reference convention,
+ * the LAST-resort rung of the resolution order (the soft registry pointer stays
+ * non-validating). Known runtimes get their real dist paths; anything else is best-effort npm.
+ */
+export declare function registryDepUrl(ref: string): string | null;
+/**
+ * The ordered dependency `<script>` tags for the generator document, each dep resolved per
+ * the Consumers table: registry on-chain bytes → registry preferredCDN → built-in map;
+ * `onchain`-resolution refs read their SSTORE2 data contract directly (never a registry).
+ * Never throws for a resolution failure — an unresolvable dep is skipped (after the warn) and
+ * the document assembles. DOES propagate {@link InflateRequiredError} (see
+ * {@link resolveRegistryDep}) — a missing `inflate` is a host wiring bug, not a bad dep.
+ */
+export declare function dependencyScriptTags(client: PublicClient, state: ProjectState, opts?: RegistryResolveOptions): Promise<string[]>;
+/** The spec's URL-carried tokenData size budget: gateway front-ends commonly cap request lines
+ *  near 8KB. Applies to URL-carried `?abx=` payloads (a resolver's directory-mode 302 fallback);
+ *  inline document serving is unaffected. Hoisted alongside the rest of this lane — the
+ *  budget-tracking/observability surface built on it (`checkUrlBudget`, `urlBudgetStatus`) stays
+ *  resolver-local (token-api/src/deps.ts), since it's a serving-observability concern rather than
+ *  a resolution rule. */
+export declare const URL_BUDGET_BYTES = 8192;
 //# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAC,MAAM,MAAM,CAAC;AAG3D,4EAA4E;AAC5E,eAAO,MAAM,cAAc;;;CAAqC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEjF,oGAAoG;AACpG,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;sFAEsF;AACtF,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,GAAG,CAahE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAOrE;AAED;qFACqF;AACrF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAE/E;AAID;kGACkG;AAClG,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB5B,CAAC;AAEX,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uGAAuG;AACvG,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,IAAI,EAAE;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;KAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnI;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAW3C"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"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"}