@artblocks/abx-sdk 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/clients.js

@@ -1,7 +1,8 @@
 import { createPublicClient, createWalletClient, fallback, http, } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { DEFAULT_CHAIN_KEY, resolveChain, resolveRpcUrls, rpcEnvVar } from './chains.js';
-import { loadDotEnv } from './env.js';
+import { readEnv } from './util.js';
+import { MissingSigningKeyError } from './errors.js';
 /**
  * A transport over one or more endpoints. With several, a viem `fallback` fails
  * over on error — so a request one endpoint rejects (e.g. a too-wide `eth_getLogs`)
@@ -11,7 +12,7 @@ import { loadDotEnv } from './env.js';
 function makeTransport(opts) {
     if (opts.rpcUrl)
         return http(opts.rpcUrl);
-    const urls = resolveRpcUrls(opts.chainKey);
+    const urls = resolveRpcUrls(opts.chainKey, opts.rpcUrls);
     if (urls.length <= 1)
         return http(urls[0]);
     return fallback(urls.map((u) => http(u, { retryCount: 0 })));
@@ -55,18 +56,17 @@ export async function assertChainId(chainKey = DEFAULT_CHAIN_KEY, opts = {}) {
     verifiedChains.add(chainKey);
 }
 /**
- * A signing client, backed by a private key from the environment. The SDK never
- * takes custody of keys beyond reading them from the operator's own env — there
- * is no key storage, no prompt, no remote signer here.
+ * A signing client, backed by a private key. The SDK never takes custody of keys beyond
+ * reading them from the operator's own env (or an explicit override) — there is no key
+ * storage, no prompt, no remote signer here.
  *
- * Key precedence: `ABX_DEPLOYER_PK` → `SEPOLIA_FUNDED_PK` → `SEPOLIA_WALLET_PK`.
+ * Key resolution: `opts.privateKey` → `ABX_DEPLOYER_PK`. That is the ONLY env name read —
+ * `SEPOLIA_FUNDED_PK` / `SEPOLIA_WALLET_PK` (earlier alphas) are no longer consulted.
  */
 export function makeWalletClient(opts = {}) {
-    loadDotEnv();
-    const pk = process.env.ABX_DEPLOYER_PK ?? process.env.SEPOLIA_FUNDED_PK ?? process.env.SEPOLIA_WALLET_PK;
-    if (!pk) {
-        throw new Error('No signing key found. Set ABX_DEPLOYER_PK, SEPOLIA_FUNDED_PK, or SEPOLIA_WALLET_PK in your .env.');
-    }
+    const pk = opts.privateKey ?? readEnv('ABX_DEPLOYER_PK');
+    if (!pk)
+        throw new MissingSigningKeyError();
     const account = privateKeyToAccount(normalizePk(pk));
     const chain = resolveChain(opts.chainKey);
     const wallet = createWalletClient({ account, chain, transport: makeTransport(opts) });
@@ -77,14 +77,13 @@ function normalizePk(pk) {
     return (trimmed.startsWith('0x') ? trimmed : `0x${trimmed}`);
 }
 /**
- * The env signing key (0x-normalized), same precedence as {@link makeWalletClient}
- * (`ABX_DEPLOYER_PK` → `SEPOLIA_FUNDED_PK` → `SEPOLIA_WALLET_PK`), or `undefined` if none is set.
- * For reusing the hot key as a *storage* signing identity (an Ethereum Turbo identity) without
- * constructing a wallet client. Never throws.
+ * The signing key (0x-normalized), same resolution as {@link makeWalletClient}
+ * (`override` → `ABX_DEPLOYER_PK`), or `undefined` if none is set. For reusing the hot key as
+ * a *storage* signing identity (an Ethereum Turbo identity) without constructing a wallet
+ * client. Never throws.
  */
-export function envSigningKey() {
-    loadDotEnv();
-    const pk = process.env.ABX_DEPLOYER_PK ?? process.env.SEPOLIA_FUNDED_PK ?? process.env.SEPOLIA_WALLET_PK;
+export function envSigningKey(override) {
+    const pk = override ?? readEnv('ABX_DEPLOYER_PK');
     return pk ? normalizePk(pk) : undefined;
 }
 //# sourceMappingURL=clients.js.map

package/dist/clients.js.map

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

package/dist/create2.d.ts

@@ -11,7 +11,9 @@ import { type Address, type Hex } from 'viem';
 /** The keyless CREATE2 proxy (Arachnid deterministic-deployment-proxy). Same address on every chain. */
 export declare const CREATE2_PROXY: Address;
 /** Canonical salt strings — MUST stay byte-identical to `contracts/script/AbxSalts.sol`, since the
- *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`. */
+ *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`.
+ *  `test/create2-salts.test.ts` diffs this table against that file, both ways, so drift can't be
+ *  quiet: the two halves have to be one fact. */
 export declare const ABX_SALT: {
     readonly oneOfOneFactory: "abx.factory.one-of-one.v1";
     readonly seriesFactory: "abx.factory.series.v1";
@@ -21,6 +23,14 @@ export declare const ABX_SALT: {
     readonly fixedPriceMinter: "abx.minter.fixed-price.v1";
     readonly seedSource: "abx.seed-source.v1";
     readonly generator: "abx.generator.v1";
+    readonly oneOfOneEditionFactory: "abx.one-of-one-edition-factory.v1";
+    readonly editionFactory: "abx.edition-factory.v1";
+    readonly editionCodeFactory: "abx.edition-code-factory.v1";
+    readonly fixedPriceMinter1155: "abx.fixed-price-minter-1155.v1";
+    readonly paramsLib: "abx.lib.params.v1";
+    readonly codeLib: "abx.lib.code.v1";
+    readonly editionLib: "abx.lib.edition.v1";
+    readonly metadataLib: "abx.lib.metadata.v1";
 };
 /** The 32-byte salt a CREATE2 deploy uses (`keccak256` of the canonical string). */
 export declare const saltHash: (salt: string) => Hex;
@@ -39,4 +49,78 @@ export declare const predictFixedPriceMinter: () => Address;
  *  (`DeploySeedSource.s.sol`) so it compiles at the default profile — bundling it with the
  *  SeriesCode factory's `clone-impl` unit yields a different, non-canonical bytecode + address. */
 export declare const predictSeedSource: () => Address;
+/** The canonical (cross-chain-identical) `OneOfOneImageFactory` address for the current bytecode —
+ *  the 721 1/1 trust anchor. */
+export declare const predictFactory: () => Address;
+/** The canonical (cross-chain-identical) `SeriesImageFactory` address for the current bytecode —
+ *  the 721 multi-token trust anchor. */
+export declare const predictSeriesFactory: () => Address;
+/** The canonical (cross-chain-identical) `AbxFixedPriceMinter1155` address for the current
+ *  bytecode — the shared, ownerless edition sale singleton. */
+export declare const predictFixedPriceMinter1155: () => Address;
+/** Fully-qualified library names (solc's link keys — path-sensitive, so they must match how the
+ *  contracts are compiled: `src/libraries/…` as `foundry.toml` sees them). */
+export declare const LIB_FQN: {
+    readonly paramsLib: "src/libraries/AbxParamsLib.sol:AbxParamsLib";
+    readonly codeLib: "src/libraries/AbxCodeLib.sol:AbxCodeLib";
+    readonly editionLib: "src/libraries/AbxEditionLib.sol:AbxEditionLib";
+    readonly metadataLib: "src/libraries/AbxMetadataLib.sol:AbxMetadataLib";
+};
+/** The solc link placeholder for a fully-qualified library name: `__$<keccak(fqn)[0:34]>$__`. */
+export declare const libPlaceholder: (fullyQualified: string) => string;
+/**
+ * Link `bytecode` against deployed libraries — the post-compile placeholder substitution `forge`
+ * does at build time, done here so a sandbox / fresh chain needs no forge. Throws if any
+ * placeholder is left over, since an unlinked `__$…$__` is not valid hex and the RPC would reject
+ * the transaction with an opaque `Invalid byte sequence`.
+ */
+export declare function linkLibraries(bytecode: Hex, links: ReadonlyArray<readonly [fqn: string, address: Address]>): Hex;
+/** The canonical (cross-chain-identical) `AbxParamsLib` address — the params write path both code
+ *  token types delegatecall. */
+export declare const predictParamsLib: () => Address;
+/** The canonical (cross-chain-identical) `AbxCodeLib` address — the script/code write path. */
+export declare const predictCodeLib: () => Address;
+/** The canonical (cross-chain-identical) `AbxEditionLib` address — the 1155 uri / creator-token /
+ *  edition-supply write path that **all three** edition token types (`OneOfOneEdition`,
+ *  `EditionImage`, `EditionCode`) delegatecall.
+ *  `AbxEditionLib` itself delegatecalls `AbxParamsLib`, so it is linked before it is deployed: the
+ *  one library here whose own initcode depends on another library's address. */
+export declare const predictEditionLib: () => Address;
+/** The canonical `AbxMetadataLib` address. Linked by ALL SIX token types — the metadata field store
+ *  was inlined into every one of them until the 2026-08-14 audit asked for EIP-170 headroom before
+ *  further remediation, so externalizing it is what made even the plainest 721 factory
+ *  library-linked. It links nothing itself, so it is deployed first. */
+export declare const predictMetadataLib: () => Address;
+/** `AbxEditionLib`'s canonical initcode: its shipped bytecode linked against `AbxParamsLib`. */
+export declare const linkEditionLib: () => Hex;
+/** `OneOfOneEditionFactory`'s canonical initcode: linked against `AbxEditionLib` (the only library
+ *  its embedded `OneOfOneEdition` implementation delegates into). `AbxEditionLib`'s own address
+ *  already accounts for its `AbxParamsLib` link — see {@link predictEditionLib}. */
+export declare const linkOneOfOneEditionFactory: () => Hex;
+/** `EditionImageFactory`'s canonical initcode: linked against `AbxEditionLib`, the sibling of
+ *  {@link linkOneOfOneEditionFactory}. */
+export declare const linkEditionFactory: () => Hex;
+/** `SeriesCodeFactory`'s canonical initcode: linked against the two write-path libraries. */
+export declare const linkSeriesCodeFactory: () => Hex;
+/** `EditionCodeFactory`'s canonical initcode: linked against all three write-path libraries. */
+export declare const linkEditionCodeFactory: () => Hex;
+/** The two ERC-721 image factories' canonical initcode. They linked NOTHING until the metadata
+ *  field store was externalized; now every token type is library-linked. */
+export declare const linkFactory: () => Hex;
+export declare const linkSeriesFactory: () => Hex;
+/** The canonical (cross-chain-identical) `SeriesCodeFactory` address — the code-project trust
+ *  anchor. Predictable because its libraries are (see the section note above). */
+export declare const predictSeriesCodeFactory: () => Address;
+/** The canonical (cross-chain-identical) `EditionCodeFactory` address — the code-project EDITION
+ *  trust anchor. */
+export declare const predictEditionCodeFactory: () => Address;
+/** The canonical (cross-chain-identical) `OneOfOneEditionFactory` address — the 1/1-edition trust
+ *  anchor. Predicted from LINKED initcode: `OneOfOneEdition` delegates its uri / creator-token /
+ *  edition-supply bodies into `AbxEditionLib`, so the shipped factory bytecode carries a link
+ *  placeholder (hashing it unlinked yields a plausible-looking address for a trust anchor that
+ *  nothing can ever be deployed to — see the section note). */
+export declare const predictOneOfOneEditionFactory: () => Address;
+/** The canonical (cross-chain-identical) `EditionImageFactory` address — the multi-work edition
+ *  trust anchor, the sibling of {@link predictOneOfOneEditionFactory} (same single library link). */
+export declare const predictEditionFactory: () => Address;
 //# sourceMappingURL=create2.d.ts.map

package/dist/create2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create2.d.ts","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,OAAO,EAAE,KAAK,GAAG,EAAC,MAAM,MAAM,CAAC;AAQ5F;;;;;;;;GAQG;AAEH,wGAAwG;AACxG,eAAO,MAAM,aAAa,EAAE,OAAsD,CAAC;AAEnF;qGACqG;AACrG,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,oFAAoF;AACpF,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,GAA+B,CAAC;AAExE;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAE1E;AAED,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,CAEhE;AAED,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC;AAElH,kGAAkG;AAClG,eAAO,MAAM,eAAe,QAAO,OAAgF,CAAC;AAEpH,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,QAAO,OACoC,CAAC;AAEhF;;mGAEmG;AACnG,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC"}
+{"version":3,"file":"create2.d.ts","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,OAAO,EAAE,KAAK,GAAG,EAAC,MAAM,MAAM,CAAC;AAmB5F;;;;;;;;GAQG;AAEH,wGAAwG;AACxG,eAAO,MAAM,aAAa,EAAE,OAAsD,CAAC;AAEnF;;;iDAGiD;AACjD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;CAoBX,CAAC;AAEX,oFAAoF;AACpF,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,GAA+B,CAAC;AAExE;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAE1E;AAED,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,CAEhE;AAED,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC;AAElH,kGAAkG;AAClG,eAAO,MAAM,eAAe,QAAO,OAAgF,CAAC;AAEpH,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,QAAO,OACoC,CAAC;AAEhF;;mGAEmG;AACnG,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC;AAYlH;gCACgC;AAChC,eAAO,MAAM,cAAc,QAAO,OAC8B,CAAC;AAEjE;wCACwC;AACxC,eAAO,MAAM,oBAAoB,QAAO,OAC4B,CAAC;AAErE;+DAC+D;AAC/D,eAAO,MAAM,2BAA2B,QAAO,OACwC,CAAC;AA0CxF;8EAC8E;AAC9E,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,KAAG,MACI,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAKhH;AAED;gCACgC;AAChC,eAAO,MAAM,gBAAgB,QAAO,OAA0E,CAAC;AAE/G,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAO,OAAsE,CAAC;AAEzG;;;;gFAIgF;AAChF,eAAO,MAAM,iBAAiB,QAAO,OACyB,CAAC;AAE/D;;;wEAGwE;AACxE,eAAO,MAAM,kBAAkB,QAAO,OAC+B,CAAC;AAEtE,gGAAgG;AAChG,eAAO,MAAM,cAAc,QAAO,GAC+C,CAAC;AAElF;;oFAEoF;AACpF,eAAO,MAAM,0BAA0B,QAAO,GAI1C,CAAC;AAEL;0CAC0C;AAC1C,eAAO,MAAM,kBAAkB,QAAO,GAIlC,CAAC;AAEL,6FAA6F;AAC7F,eAAO,MAAM,qBAAqB,QAAO,GAKrC,CAAC;AAEL,gGAAgG;AAChG,eAAO,MAAM,sBAAsB,QAAO,GAMtC,CAAC;AAEL;4EAC4E;AAC5E,eAAO,MAAM,WAAW,QAAO,GAC6D,CAAC;AAE7F,eAAO,MAAM,iBAAiB,QAAO,GACqD,CAAC;AAE3F;kFACkF;AAClF,eAAO,MAAM,wBAAwB,QAAO,OACgC,CAAC;AAE7E;oBACoB;AACpB,eAAO,MAAM,yBAAyB,QAAO,OACiC,CAAC;AAE/E;;;;+DAI+D;AAC/D,eAAO,MAAM,6BAA6B,QAAO,OACqC,CAAC;AAEvF;qGACqG;AACrG,eAAO,MAAM,qBAAqB,QAAO,OAC6B,CAAC"}

package/dist/create2.js

@@ -1,5 +1,5 @@
 import { concat, getContractAddress, keccak256, toBytes } from 'viem';
-import { abxChunkStoreBytecode, abxFixedPriceMinterBytecode, abxMetadataRendererBytecode, abxSeedSourceBytecode, } from './abi/index.js';
+import { abxChunkStoreBytecode, abxCodeLibBytecode, abxEditionLibBytecode, abxMetadataLibBytecode, abxFixedPriceMinterBytecode, abxFixedPriceMinter1155Bytecode, abxMetadataRendererBytecode, abxParamsLibBytecode, abxSeedSourceBytecode, editionCodeFactoryBytecode, editionImageFactoryBytecode, oneOfOneEditionFactoryBytecode, oneOfOneImageFactoryBytecode, seriesCodeFactoryBytecode, seriesImageFactoryBytecode, } from './abi/index.js';
 /**
  * Keyless CREATE2 deployment — the TS twin of `contracts/script/AbxSalts.sol`.
  *
@@ -12,7 +12,9 @@ import { abxChunkStoreBytecode, abxFixedPriceMinterBytecode, abxMetadataRenderer
 /** The keyless CREATE2 proxy (Arachnid deterministic-deployment-proxy). Same address on every chain. */
 export const CREATE2_PROXY = '0x4e59b44847b379578588920cA78FbF26c0B4956C';
 /** Canonical salt strings — MUST stay byte-identical to `contracts/script/AbxSalts.sol`, since the
- *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`. */
+ *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`.
+ *  `test/create2-salts.test.ts` diffs this table against that file, both ways, so drift can't be
+ *  quiet: the two halves have to be one fact. */
 export const ABX_SALT = {
     oneOfOneFactory: 'abx.factory.one-of-one.v1',
     seriesFactory: 'abx.factory.series.v1',
@@ -22,6 +24,17 @@ export const ABX_SALT = {
     fixedPriceMinter: 'abx.minter.fixed-price.v1',
     seedSource: 'abx.seed-source.v1',
     generator: 'abx.generator.v1',
+    // ERC-1155 editions (twins of the above; naming follows the parity plan verbatim).
+    oneOfOneEditionFactory: 'abx.one-of-one-edition-factory.v1',
+    editionFactory: 'abx.edition-factory.v1',
+    editionCodeFactory: 'abx.edition-code-factory.v1',
+    fixedPriceMinter1155: 'abx.fixed-price-minter-1155.v1',
+    // Delegatecalled write-path libraries — CREATE2 like everything else here (see the
+    // "delegatecalled write-path libraries" note below, and `DeployLibraries.s.sol`).
+    paramsLib: 'abx.lib.params.v1',
+    codeLib: 'abx.lib.code.v1',
+    editionLib: 'abx.lib.edition.v1',
+    metadataLib: 'abx.lib.metadata.v1',
 };
 /** The 32-byte salt a CREATE2 deploy uses (`keccak256` of the canonical string). */
 export const saltHash = (salt) => keccak256(toBytes(salt));
@@ -44,4 +57,148 @@ export const predictFixedPriceMinter = () => predictCreate2Address(ABX_SALT.fixe
  *  (`DeploySeedSource.s.sol`) so it compiles at the default profile — bundling it with the
  *  SeriesCode factory's `clone-impl` unit yields a different, non-canonical bytecode + address. */
 export const predictSeedSource = () => predictCreate2Address(ABX_SALT.seedSource, abxSeedSourceBytecode);
+// ── ERC-1155 editions ──────────────────────────────────────────────────────────
+//
+// `DeployOneOfOneEdition.s.sol` / `DeployEdition.s.sol` / `DeployMinter1155.s.sol` each deploy
+// their contract with a fixed `AbxSalts` salt and NO constructor args, so the salt + this build's
+// bytecode fix the address before any deploy. `AbxFixedPriceMinter1155` is a plain singleton and is
+// predicted right below; the two edition IMAGE factories are not — `OneOfOneEdition`/`EditionImage`
+// both delegate bodies into `AbxEditionLib`, so their factories carry a link placeholder and their
+// predictions live with the library-linked factories in the write-path-library section below
+// (`predictOneOfOneEditionFactory`/`predictEditionFactory`), next to the two code factories.
+/** The canonical (cross-chain-identical) `OneOfOneImageFactory` address for the current bytecode —
+ *  the 721 1/1 trust anchor. */
+export const predictFactory = () => predictCreate2Address(ABX_SALT.oneOfOneFactory, linkFactory());
+/** The canonical (cross-chain-identical) `SeriesImageFactory` address for the current bytecode —
+ *  the 721 multi-token trust anchor. */
+export const predictSeriesFactory = () => predictCreate2Address(ABX_SALT.seriesFactory, linkSeriesFactory());
+/** The canonical (cross-chain-identical) `AbxFixedPriceMinter1155` address for the current
+ *  bytecode — the shared, ownerless edition sale singleton. */
+export const predictFixedPriceMinter1155 = () => predictCreate2Address(ABX_SALT.fixedPriceMinter1155, abxFixedPriceMinter1155Bytecode);
+// ── delegatecalled write-path libraries ────────────────────────────────────────
+//
+// A `public` library function is compiled as a `delegatecall` to a SEPARATELY deployed copy of the
+// library, and solc leaves a `__$<id>$__` placeholder in the caller's bytecode where that copy's
+// address goes. Linking is the substitution of an address into that placeholder.
+//
+// **Linking does not cost determinism.** These libraries are deployed through the same keyless
+// CREATE2 proxy at the canonical salts above (`DeployLibraries.s.sol` is the forge twin), so a
+// library's address is `f(proxy, salt, creation bytecode)` and nothing else — the deployer's nonce
+// is not an input to a CREATE2 address (it is an input to plain `CREATE`, which is where the
+// confusion came from). Predict the libraries, substitute them, and the linked factory's initcode
+// is fixed too — hence the FOUR `predict*Factory` helpers at the bottom of this section.
+//
+// Worth stating plainly, because the opposite belief was load-bearing: two ERC-1155 token types
+// (`OneOfOneEdition`/`EditionImage`) were held library-free and an EIP-170 size floor was relaxed to
+// avoid "losing" a factory's deterministic address. What was actually true was narrower and
+// self-inflicted — the SDK deployed its libraries with a plain EOA `CREATE` (`to: null`) by its own
+// choice, so *it* could not predict them, and that local limitation was written up as a property of
+// libraries in general. It isn't one. The broadcast artifacts always said so: every recorded library
+// deploy went through the keyless proxy, and `AbxParamsLib` landed at ONE address on Sepolia and
+// Base Sepolia from deployer nonces 215 apart. Both of those token types now delegate into
+// `AbxEditionLib` exactly as `EditionCode` does, so FOUR factories here are library-linked, not two.
+//
+// **Losing track of that is a bug class, not a footnote.** Three separate times a contract became
+// library-linked and this file went on hashing its UNLINKED bytecode, and the failure is silent:
+// viem does not reject a `__$…$__` placeholder, it UTF-8-encodes it — so the prediction is a
+// real-looking address that is the hash of ASCII garbage, for the addresses platforms allowlist, and
+// the same bytes would go out as initcode. `link.test.ts`'s "nothing deployable carries a
+// placeholder" guard derives its subject set from the exported bytecodes rather than a list of
+// names, precisely so the next contract to become library-linked cannot escape the same way.
+//
+// **The real trap is compile-time linking, not linking.** Substituting into the placeholder happens
+// AFTER compilation, so it cannot change the library's own creation bytecode. Handing solc the
+// addresses at build time instead (`forge build/script --libraries src/…:Lib:0x…`) writes the
+// library map into `settings.libraries` in every artifact's metadata, and the metadata hash is
+// appended to the creation bytecode — so the library's own address moves, and so does the linked
+// factory's. Optimizer settings do the same (the code tokens compile at `optimizer_runs = 200`,
+// everything else at 1,000,000). One canonical bytecode per library, therefore: the one
+// `sync-abis` reads from a plain `forge build`, which is what these predictions use.
+/** Fully-qualified library names (solc's link keys — path-sensitive, so they must match how the
+ *  contracts are compiled: `src/libraries/…` as `foundry.toml` sees them). */
+export const LIB_FQN = {
+    paramsLib: 'src/libraries/AbxParamsLib.sol:AbxParamsLib',
+    codeLib: 'src/libraries/AbxCodeLib.sol:AbxCodeLib',
+    editionLib: 'src/libraries/AbxEditionLib.sol:AbxEditionLib',
+    metadataLib: 'src/libraries/AbxMetadataLib.sol:AbxMetadataLib',
+};
+/** The solc link placeholder for a fully-qualified library name: `__$<keccak(fqn)[0:34]>$__`. */
+export const libPlaceholder = (fullyQualified) => `__$${keccak256(toBytes(fullyQualified)).slice(2, 36)}$__`;
+/**
+ * Link `bytecode` against deployed libraries — the post-compile placeholder substitution `forge`
+ * does at build time, done here so a sandbox / fresh chain needs no forge. Throws if any
+ * placeholder is left over, since an unlinked `__$…$__` is not valid hex and the RPC would reject
+ * the transaction with an opaque `Invalid byte sequence`.
+ */
+export function linkLibraries(bytecode, links) {
+    let out = bytecode;
+    for (const [fqn, address] of links)
+        out = out.split(libPlaceholder(fqn)).join(address.slice(2).toLowerCase());
+    if (out.includes('__$'))
+        throw new Error(`unlinked library placeholder remains: ${/__\$[0-9a-f]{34}\$__/.exec(out)?.[0]}`);
+    return out;
+}
+/** The canonical (cross-chain-identical) `AbxParamsLib` address — the params write path both code
+ *  token types delegatecall. */
+export const predictParamsLib = () => predictCreate2Address(ABX_SALT.paramsLib, abxParamsLibBytecode);
+/** The canonical (cross-chain-identical) `AbxCodeLib` address — the script/code write path. */
+export const predictCodeLib = () => predictCreate2Address(ABX_SALT.codeLib, abxCodeLibBytecode);
+/** The canonical (cross-chain-identical) `AbxEditionLib` address — the 1155 uri / creator-token /
+ *  edition-supply write path that **all three** edition token types (`OneOfOneEdition`,
+ *  `EditionImage`, `EditionCode`) delegatecall.
+ *  `AbxEditionLib` itself delegatecalls `AbxParamsLib`, so it is linked before it is deployed: the
+ *  one library here whose own initcode depends on another library's address. */
+export const predictEditionLib = () => predictCreate2Address(ABX_SALT.editionLib, linkEditionLib());
+/** The canonical `AbxMetadataLib` address. Linked by ALL SIX token types — the metadata field store
+ *  was inlined into every one of them until the 2026-08-14 audit asked for EIP-170 headroom before
+ *  further remediation, so externalizing it is what made even the plainest 721 factory
+ *  library-linked. It links nothing itself, so it is deployed first. */
+export const predictMetadataLib = () => predictCreate2Address(ABX_SALT.metadataLib, abxMetadataLibBytecode);
+/** `AbxEditionLib`'s canonical initcode: its shipped bytecode linked against `AbxParamsLib`. */
+export const linkEditionLib = () => linkLibraries(abxEditionLibBytecode, [[LIB_FQN.paramsLib, predictParamsLib()]]);
+/** `OneOfOneEditionFactory`'s canonical initcode: linked against `AbxEditionLib` (the only library
+ *  its embedded `OneOfOneEdition` implementation delegates into). `AbxEditionLib`'s own address
+ *  already accounts for its `AbxParamsLib` link — see {@link predictEditionLib}. */
+export const linkOneOfOneEditionFactory = () => linkLibraries(oneOfOneEditionFactoryBytecode, [
+    [LIB_FQN.editionLib, predictEditionLib()],
+    [LIB_FQN.metadataLib, predictMetadataLib()],
+]);
+/** `EditionImageFactory`'s canonical initcode: linked against `AbxEditionLib`, the sibling of
+ *  {@link linkOneOfOneEditionFactory}. */
+export const linkEditionFactory = () => linkLibraries(editionImageFactoryBytecode, [
+    [LIB_FQN.editionLib, predictEditionLib()],
+    [LIB_FQN.metadataLib, predictMetadataLib()],
+]);
+/** `SeriesCodeFactory`'s canonical initcode: linked against the two write-path libraries. */
+export const linkSeriesCodeFactory = () => linkLibraries(seriesCodeFactoryBytecode, [
+    [LIB_FQN.paramsLib, predictParamsLib()],
+    [LIB_FQN.codeLib, predictCodeLib()],
+    [LIB_FQN.metadataLib, predictMetadataLib()],
+]);
+/** `EditionCodeFactory`'s canonical initcode: linked against all three write-path libraries. */
+export const linkEditionCodeFactory = () => linkLibraries(editionCodeFactoryBytecode, [
+    [LIB_FQN.paramsLib, predictParamsLib()],
+    [LIB_FQN.codeLib, predictCodeLib()],
+    [LIB_FQN.editionLib, predictEditionLib()],
+    [LIB_FQN.metadataLib, predictMetadataLib()],
+]);
+/** The two ERC-721 image factories' canonical initcode. They linked NOTHING until the metadata
+ *  field store was externalized; now every token type is library-linked. */
+export const linkFactory = () => linkLibraries(oneOfOneImageFactoryBytecode, [[LIB_FQN.metadataLib, predictMetadataLib()]]);
+export const linkSeriesFactory = () => linkLibraries(seriesImageFactoryBytecode, [[LIB_FQN.metadataLib, predictMetadataLib()]]);
+/** The canonical (cross-chain-identical) `SeriesCodeFactory` address — the code-project trust
+ *  anchor. Predictable because its libraries are (see the section note above). */
+export const predictSeriesCodeFactory = () => predictCreate2Address(ABX_SALT.seriesCodeFactory, linkSeriesCodeFactory());
+/** The canonical (cross-chain-identical) `EditionCodeFactory` address — the code-project EDITION
+ *  trust anchor. */
+export const predictEditionCodeFactory = () => predictCreate2Address(ABX_SALT.editionCodeFactory, linkEditionCodeFactory());
+/** The canonical (cross-chain-identical) `OneOfOneEditionFactory` address — the 1/1-edition trust
+ *  anchor. Predicted from LINKED initcode: `OneOfOneEdition` delegates its uri / creator-token /
+ *  edition-supply bodies into `AbxEditionLib`, so the shipped factory bytecode carries a link
+ *  placeholder (hashing it unlinked yields a plausible-looking address for a trust anchor that
+ *  nothing can ever be deployed to — see the section note). */
+export const predictOneOfOneEditionFactory = () => predictCreate2Address(ABX_SALT.oneOfOneEditionFactory, linkOneOfOneEditionFactory());
+/** The canonical (cross-chain-identical) `EditionImageFactory` address — the multi-work edition
+ *  trust anchor, the sibling of {@link predictOneOfOneEditionFactory} (same single library link). */
+export const predictEditionFactory = () => predictCreate2Address(ABX_SALT.editionFactory, linkEditionFactory());
 //# sourceMappingURL=create2.js.map

package/dist/create2.js.map

@@ -1 +1 @@
-{"version":3,"file":"create2.js","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAyB,MAAM,MAAM,CAAC;AAC5F,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;GAQG;AAEH,wGAAwG;AACxG,MAAM,CAAC,MAAM,aAAa,GAAY,4CAA4C,CAAC;AAEnF;qGACqG;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,eAAe,EAAE,2BAA2B;IAC5C,aAAa,EAAE,uBAAuB;IACtC,iBAAiB,EAAE,4BAA4B;IAC/C,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,oBAAoB;IAChC,gBAAgB,EAAE,2BAA2B;IAC7C,UAAU,EAAE,oBAAoB;IAChC,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAEX,oFAAoF;AACpF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAO,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAExE;6CAC6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,QAAa;IAC/D,OAAO,kBAAkB,CAAC,EAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAC;AACtG,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAa;IACzD,OAAO,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAElH,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAEpH,kGAAkG;AAClG,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAY,EAAE,CACnD,qBAAqB,CAAC,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;AAEhF;;mGAEmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"create2.js","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"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"}

package/dist/creator-token.d.ts

@@ -0,0 +1,132 @@
+/**
+ * ERC-721C creator-token support — the opt-in transfer-validation surface.
+ *
+ * An ABX token enrolls at deploy, permanently, by passing a non-zero `transferValidator` in
+ * its InitParams (see `deploy.ts`); zero leaves a plain ERC-721 forever, indistinguishable
+ * from a pre-721C token (ERC-165 and the extension beacon both branch on enrollment). Within
+ * an enrolled token the owner re-points the validator freely or suspends enforcement with
+ * zero — never un-enrolls. Every transfer that isn't a mint/burn (or the validator's own)
+ * staticcalls `validateTransfer(caller, from, to, tokenId)` on the validator; a policy
+ * violation reverts and bubbles.
+ *
+ * **`setTransferValidator` is owner-only only while the collection has an owner.** Once
+ * `owner() == address(0)` the contract opens one asymmetric door: **anyone** may suspend
+ * enforcement by passing `zeroAddress`, and nobody — including that caller — may ever arm a
+ * validator again. That is the dead-man release for the worst reachable state (a validator that
+ * reverts every transfer on a collection with nobody left to re-point it, which would otherwise
+ * strand every collector's token forever). An integrator building for collectors should expose
+ * that suspension path on a renounced collection rather than gating it behind an owner check that
+ * can no longer be satisfied — see {@link prepareSetTransferValidator}.
+ */
+import { type Address, type PublicClient } from 'viem';
+import type { PreparedTx } from './ops.js';
+/** ERC-165 id of `ICreatorToken` — advertised (with the legacy id) only when enrolled. */
+export declare const CREATOR_TOKEN_INTERFACE_ID: "0xad0d7f6c";
+/** ERC-165 id of `ICreatorTokenLegacy` — the subset older marketplaces probe for. */
+export declare const CREATOR_TOKEN_LEGACY_INTERFACE_ID: "0xa07d229a";
+/** keccak256("abx.extension.creator-token") — `extensionVersion(id)` is 1 only when enrolled. */
+export declare const CREATOR_TOKEN_EXTENSION_ID: "0x0839e7ed7fc1f5db3f253851d61b10f852045c5520c2936138b121b73e7e27c0";
+/**
+ * The recommended transfer validator per chain — OpenSea's
+ * **StrictAuthorizedTransferSecurityRegistry**, the validator their creator-fee-enforcement
+ * doc recommends for enforcement eligibility (docs.opensea.io "Creator Fee Enforcement",
+ * checked 2026-08; the named alternative is Limit Break's CreatorTokenTransferValidator
+ * 0x721C0078c2328597Ca70F5451ffF5A7B38D4E947). Verified empirically against the LIVE
+ * contracts on 2026-08-04 (`cast call --from <collection>` on the 4-arg
+ * `validateTransfer(address,address,address,uint256)` overload, both chains):
+ * an owner-initiated (OTC) transfer succeeds; an unauthorized operator reverts
+ * `StrictAuthorizedTransferSecurityRegistry__UnauthorizedTransfer()`.
+ *
+ * CREATE2-style vanity address, identical on both shipped chains — kept per-chain anyway
+ * (keyed like `deployments.ts`) because presence-on-chain is the fact that matters, and a
+ * future chain may recommend a different validator.
+ */
+export declare const RECOMMENDED_TRANSFER_VALIDATOR: Record<number, Address>;
+/** The recommended validator for a chain (undefined if none is known — never guess one). */
+export declare function resolveRecommendedTransferValidator(chainId: number): Address | undefined;
+/** A token's creator-token (ERC-721C) status, read from chain. */
+export interface CreatorTokenStatus {
+    /** True iff the token enrolled at deploy (permanent). False = plain ERC-721, forever. */
+    enrolled: boolean;
+    /** The active validator (`zeroAddress` when unenrolled, or enrolled-but-suspended). */
+    validator: Address;
+}
+/**
+ * Read whether `contract` is an enrolled ERC-721C creator token, and its active validator.
+ * Enrollment comes from ERC-165 (`ICreatorToken`, which the token advertises only when
+ * enrolled); the validator from `getTransferValidator()`. Both reads are defensive — a
+ * pre-721C ABX token has neither branch (no `getTransferValidator` selector at all), and
+ * must read as `{enrolled: false, validator: zeroAddress}`, not as an error.
+ */
+export declare function readCreatorTokenStatus(client: PublicClient, contract: Address): Promise<CreatorTokenStatus>;
+/** What {@link probeTransferValidator} found. Only `ok` may be written to a live collection.
+ *
+ *  - `ok`                  — the address has code and refuses a selector no validator implements,
+ *                            which is what every live validator does (see the probe's doc).
+ *  - `no-code`             — nothing deployed at this address on this chain. Enforcement would read
+ *                            as ON everywhere and check nothing.
+ *  - `permissive-fallback` — it has code, but it answers an unknown selector *successfully*. A
+ *                            Safe, an uninitialised proxy, or a 7702-delegated EOA does this, and
+ *                            because `validateTransfer` returns nothing there is no ABI decode to
+ *                            fail — so every transfer would silently pass validation.
+ *  - `unreachable`         — the RPC didn't answer. Says nothing about the address; retry.
+ */
+export type TransferValidatorVerdict = 'ok' | 'no-code' | 'permissive-fallback' | 'unreachable';
+/** The result of {@link probeTransferValidator} — verdict plus what was observed, for a message. */
+export interface TransferValidatorProbe {
+    verdict: TransferValidatorVerdict;
+    address: Address;
+    /** First line of the revert/transport error, when there was one. */
+    error?: string;
+}
+/**
+ * Ask a candidate transfer validator a question no validator can answer, and require it to FAIL.
+ *
+ * **`code.length > 0` is not enough**, which is why this exists and why the on-chain guard was
+ * rewritten to match. Two shapes enforce nothing while every read surface — ERC-165,
+ * `getTransferValidator()`, the extension beacon — reports enforcement as on: no code at all, and a
+ * *permissive fallback* that succeeds for any selector. `validateTransfer` returns nothing, so
+ * there is no ABI decode to fail; a Safe (its `FallbackManager.fallback()` returns empty when no
+ * handler is set), an uninitialised proxy, and an EIP-7702-delegated EOA all pass a has-code check
+ * and then wave every transfer through. A creator pasting their own Safe is the likely real case.
+ *
+ * So the probe inverts the question: a real validator **reverts** here (verified against OpenSea's
+ * SATSR and three Limit Break deployments on mainnet and Sepolia), and a permissive one returns
+ * empty success. This mirrors the contract exactly — the same selector, the same "must fail" rule —
+ * so an address that passes here is an address the token will accept, and the CLI stops reporting
+ * "no code on this chain" for an address that plainly has code.
+ *
+ * An ERC-165 gate was measured and rejected: none of those four live validators advertises
+ * `ITransferValidator`/`ITransferValidator1155`, so requiring an id would refuse the entire
+ * ecosystem, including the validator ABX itself recommends.
+ *
+ * **A misconfiguration guard, not a security boundary** — a contract can always be written to pass
+ * this and enforce nothing. It catches the honest mistake. Never throws for an on-chain reason:
+ * every failure is a verdict (mirrors `probeSeedSource`).
+ */
+export declare function probeTransferValidator(client: PublicClient, validator: Address, 
+/** The enrolling/enrolled token, when known — the probe is made as the token, because that is
+ *  the `msg.sender` the contract's own staticcall presents. */
+opts?: {
+    as?: Address;
+}): Promise<TransferValidatorProbe>;
+/**
+ * Re-point an enrolled token's transfer validator, or suspend enforcement with
+ * `zeroAddress` (the token stays enrolled). Reverts `NotCreatorToken()` on a token that didn't
+ * enroll at deploy — enrollment can never be added later — and `InvalidTransferValidator()` on a
+ * validator the chain's own probe refuses (no code on this chain, **or** a permissive fallback that
+ * would enforce nothing); call {@link probeTransferValidator} first and refuse those before gas.
+ *
+ * **Who may sign:** the owner, while there is one. On a collection whose `owner()` is
+ * `address(0)`, **any** signer may send this with `validator = zeroAddress` to suspend enforcement
+ * permanently — the dead-man release described in this module's header. Arming a validator is still
+ * owner-only, so an ownerless collection can only move toward transferability, never back. A UX for
+ * collectors should offer that suspension when it sees a renounced, enforcing collection; gating it
+ * on `owner()` would hide the one recovery a stranded holder has.
+ */
+export declare function prepareSetTransferValidator(args: {
+    contract: Address;
+    validator: Address;
+    chainId: number;
+}): PreparedTx;
+//# sourceMappingURL=creator-token.d.ts.map

package/dist/creator-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-token.d.ts","sourceRoot":"","sources":["../src/creator-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAkC,KAAK,OAAO,EAAY,KAAK,YAAY,EAAC,MAAM,MAAM,CAAC;AAEhG,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEzC,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAChE,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,EAAG,YAAqB,CAAC;AACvE,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,EACrC,oEAA6E,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAKlE,CAAC;AAEF,4FAA4F;AAC5F,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAExF;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,QAAQ,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAAG,qBAAqB,GAAG,aAAa,CAAC;AAEhG,oGAAoG;AACpG,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,wBAAwB,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,OAAO;AAClB;+DAC+D;AAC/D,IAAI,GAAE;IAAC,EAAE,CAAC,EAAE,OAAO,CAAA;CAAM,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC;AAoBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAiBb"}