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

package/dist/clients.d.ts

@@ -1,7 +1,12 @@
-import { type PublicClient, type WalletClient, type Account } from 'viem';
+import { type PublicClient, type WalletClient, type Account, type Hex } from 'viem';
 export interface ClientOptions {
     chainKey?: string;
+    /** A single RPC endpoint — wins outright over everything else (env included). */
     rpcUrl?: string;
+    /** Several RPC endpoints, in preference order (a viem `fallback` transport failing over
+     *  across them). Loses to `rpcUrl` when both are set; otherwise takes precedence over env
+     *  resolution — see {@link resolveRpcUrls}'s override → env → manifest precedence. */
+    rpcUrls?: string[];
 }
 /** A read-only client — all the indexer and token API ever need. */
 export declare function makePublicClient(opts?: ClientOptions): PublicClient;
@@ -21,22 +26,29 @@ export declare function makePublicClient(opts?: ClientOptions): PublicClient;
 export declare function assertChainId(chainKey?: string, opts?: {
     allowUnreachable?: boolean;
 }): Promise<void>;
+export interface WalletClientOptions extends ClientOptions {
+    /** An explicit key — bypasses `ABX_DEPLOYER_PK` (and any `.env`) entirely. For a caller that
+     *  already resolved a key itself (a browser-wallet bridge is the OTHER signing lane — this is
+     *  for a host embedding the SDK with its own key management, not that lane). */
+    privateKey?: Hex;
+}
 /**
- * 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 declare function makeWalletClient(opts?: ClientOptions): {
+export declare function makeWalletClient(opts?: WalletClientOptions): {
     wallet: WalletClient;
     account: Account;
 };
 /**
- * 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 declare function envSigningKey(): `0x${string}` | undefined;
+export declare function envSigningKey(override?: Hex): `0x${string}` | undefined;
 //# sourceMappingURL=clients.d.ts.map

package/dist/clients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,OAAO,EACb,MAAM,MAAM,CAAC;AAKd,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG,YAAY,CAEvE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,MAA0B,EACpC,IAAI,GAAE;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAM,GACtC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG;IAC1D,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,CAYA;AAOD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,KAAK,MAAM,EAAE,GAAG,SAAS,CAIzD"}
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAMd,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;0FAEsF;IACtF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAeD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG,YAAY,CAEvE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,MAA0B,EACpC,IAAI,GAAE;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAM,GACtC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;;oFAEgF;IAChF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,mBAAwB,GAAG;IAChE,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,CAOA;AAOD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,GAAG,KAAK,MAAM,EAAE,GAAG,SAAS,CAGvE"}

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/contract-generations.d.ts

@@ -0,0 +1,58 @@
+import { type Address } from 'viem';
+/** Human-facing lifecycle. Code should dispatch on `support`, not this label. */
+export type GenerationLifecycle = 'current' | 'supported' | 'deprecated' | 'quarantined';
+/** Operations that ABX software may allow for a known contract generation. */
+export interface GenerationSupport {
+    readonly newDeployments: boolean;
+    readonly reads: boolean;
+    readonly writes: boolean;
+    readonly serving: boolean;
+}
+export type GenerationOperation = keyof GenerationSupport;
+/** One immutable generation of the six clone factories. */
+export interface AnchorGeneration {
+    /** Stable registry identifier. Never reuse or rename after publication. */
+    readonly id: string;
+    /** The value clones report from `abxVersion()`. */
+    readonly coreVersion: number;
+    readonly lifecycle: GenerationLifecycle;
+    /** ISO date the generation first went live. */
+    readonly deployed: string;
+    /** ISO date it was superseded, when applicable. */
+    readonly retired?: string;
+    /** Explicit compatibility policy for SDKs, indexers, and resolvers. */
+    readonly support: GenerationSupport;
+    /** The six trust anchors. Shared singletons and libraries do not belong here. */
+    readonly factories: {
+        readonly factory: Address;
+        readonly seriesFactory: Address;
+        readonly seriesCodeFactory: Address;
+        readonly oneOfOneEditionFactory: Address;
+        readonly editionFactory: Address;
+        readonly editionCodeFactory: Address;
+    };
+    readonly note?: string;
+}
+/** Compact generation facts suitable for service responses and logs. */
+export interface ContractGenerationSummary {
+    readonly id: string;
+    readonly coreVersion: number;
+    readonly lifecycle: GenerationLifecycle;
+    readonly support: GenerationSupport;
+}
+/** Append-only, newest-first registry of published ABX contract generations. */
+export declare const ANCHOR_GENERATIONS: readonly AnchorGeneration[];
+export declare function currentAnchorGeneration(): AnchorGeneration;
+export declare function findAnchorGenerationById(id: string): AnchorGeneration | undefined;
+export declare function findAnchorGenerationByCoreVersion(coreVersion: number): AnchorGeneration | undefined;
+export declare function findAnchorGenerationByFactory(factory: Address): AnchorGeneration | undefined;
+/** Resolve official generation provenance from reconstructed project facts.
+ *  A self-reported core version or caller-supplied factory alone is not enough. */
+export declare function findAnchorGenerationForProject(project: {
+    readonly abxVersion: number | null;
+    readonly factory: Address | null;
+    readonly isCanonical: boolean | null;
+}): AnchorGeneration | undefined;
+export declare function summarizeAnchorGeneration(generation: AnchorGeneration): ContractGenerationSummary;
+export declare function supportsGenerationOperation(generation: AnchorGeneration, operation: GenerationOperation): boolean;
+//# sourceMappingURL=contract-generations.d.ts.map

package/dist/contract-generations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-generations.d.ts","sourceRoot":"","sources":["../src/contract-generations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAC,MAAM,MAAM,CAAC;AAG7C,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzF,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,iBAAiB,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;QACzC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAwED,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAE7D,wBAAgB,uBAAuB,IAAI,gBAAgB,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEjF;AAED,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEnG;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAK5F;AAED;mFACmF;AACnF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC,GAAG,gBAAgB,GAAG,SAAS,CAI/B;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,gBAAgB,GAAG,yBAAyB,CAOjG;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAET"}

package/dist/contract-generations.js

@@ -0,0 +1,109 @@
+import { isAddress } from 'viem';
+import registryJson from './contract-generations.json' with { type: 'json' };
+const FACTORY_KEYS = [
+    'factory',
+    'seriesFactory',
+    'seriesCodeFactory',
+    'oneOfOneEditionFactory',
+    'editionFactory',
+    'editionCodeFactory',
+];
+const LIFECYCLES = new Set(['current', 'supported', 'deprecated', 'quarantined']);
+const OPERATIONS = ['newDeployments', 'reads', 'writes', 'serving'];
+function loadRegistry(input) {
+    if (!input || typeof input !== 'object')
+        throw new Error('Invalid contract-generation registry');
+    const registry = input;
+    if (registry.schemaVersion !== 1)
+        throw new Error(`Unsupported contract-generation schema: ${registry.schemaVersion}`);
+    if (!Array.isArray(registry.generations) || registry.generations.length === 0) {
+        throw new Error('Contract-generation registry must contain at least one generation');
+    }
+    const generations = registry.generations;
+    const ids = new Set();
+    const versions = new Set();
+    for (const generation of generations) {
+        if (!generation || typeof generation !== 'object')
+            throw new Error('Invalid contract generation');
+        if (!generation.id || ids.has(generation.id))
+            throw new Error(`Duplicate or missing generation id: ${generation.id}`);
+        if (!Number.isSafeInteger(generation.coreVersion) || versions.has(generation.coreVersion)) {
+            throw new Error(`Duplicate or invalid core version: ${generation.coreVersion}`);
+        }
+        if (!LIFECYCLES.has(generation.lifecycle))
+            throw new Error(`Invalid lifecycle for ${generation.id}`);
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(generation.deployed))
+            throw new Error(`Invalid deployed date for ${generation.id}`);
+        if (generation.retired && !/^\d{4}-\d{2}-\d{2}$/.test(generation.retired)) {
+            throw new Error(`Invalid retired date for ${generation.id}`);
+        }
+        for (const operation of OPERATIONS) {
+            if (typeof generation.support?.[operation] !== 'boolean') {
+                throw new Error(`Missing ${operation} support policy for ${generation.id}`);
+            }
+        }
+        for (const key of FACTORY_KEYS) {
+            if (!isAddress(generation.factories?.[key]))
+                throw new Error(`Invalid ${key} for ${generation.id}`);
+        }
+        if (Object.keys(generation.factories).length !== FACTORY_KEYS.length) {
+            throw new Error(`Generation ${generation.id} must contain exactly six factories`);
+        }
+        ids.add(generation.id);
+        versions.add(generation.coreVersion);
+    }
+    const current = generations.filter((generation) => generation.lifecycle === 'current');
+    if (current.length !== 1 || generations[0] !== current[0]) {
+        throw new Error('Exactly one current contract generation must appear first');
+    }
+    if (!current[0].support.newDeployments || current[0].retired) {
+        throw new Error('The current contract generation must allow new deployments and cannot be retired');
+    }
+    if (generations.some((generation) => generation.lifecycle !== 'current' && generation.support.newDeployments)) {
+        throw new Error('Only the current contract generation may allow new deployments');
+    }
+    if (generations.some((generation) => generation.lifecycle !== 'current' && !generation.retired)) {
+        throw new Error('Every prior contract generation must record when it was retired');
+    }
+    for (let index = 1; index < generations.length; index += 1) {
+        if (generations[index - 1].coreVersion <= generations[index].coreVersion) {
+            throw new Error('Contract generations must be newest-first by core version');
+        }
+    }
+    return generations;
+}
+/** Append-only, newest-first registry of published ABX contract generations. */
+export const ANCHOR_GENERATIONS = loadRegistry(registryJson);
+export function currentAnchorGeneration() {
+    return ANCHOR_GENERATIONS[0];
+}
+export function findAnchorGenerationById(id) {
+    return ANCHOR_GENERATIONS.find((generation) => generation.id === id);
+}
+export function findAnchorGenerationByCoreVersion(coreVersion) {
+    return ANCHOR_GENERATIONS.find((generation) => generation.coreVersion === coreVersion);
+}
+export function findAnchorGenerationByFactory(factory) {
+    const needle = factory.toLowerCase();
+    return ANCHOR_GENERATIONS.find((generation) => Object.values(generation.factories).some((candidate) => candidate.toLowerCase() === needle));
+}
+/** Resolve official generation provenance from reconstructed project facts.
+ *  A self-reported core version or caller-supplied factory alone is not enough. */
+export function findAnchorGenerationForProject(project) {
+    if (project.isCanonical !== true || !project.factory || project.abxVersion === null)
+        return undefined;
+    const generation = findAnchorGenerationByFactory(project.factory);
+    return generation?.coreVersion === project.abxVersion ? generation : undefined;
+}
+export function summarizeAnchorGeneration(generation) {
+    return {
+        id: generation.id,
+        coreVersion: generation.coreVersion,
+        lifecycle: generation.lifecycle,
+        support: generation.support,
+    };
+}
+export function supportsGenerationOperation(generation, operation) {
+    return generation.support[operation];
+}
+//# sourceMappingURL=contract-generations.js.map

package/dist/contract-generations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-generations.js","sourceRoot":"","sources":["../src/contract-generations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAe,MAAM,MAAM,CAAC;AAC7C,OAAO,YAAY,MAAM,6BAA6B,CAAC,OAAM,IAAI,EAAE,MAAM,EAAC,CAAC;AAgD3E,MAAM,YAAY,GAAG;IACnB,SAAS;IACT,eAAe;IACf,mBAAmB;IACnB,wBAAwB;IACxB,gBAAgB;IAChB,oBAAoB;CACZ,CAAC;AAEX,MAAM,UAAU,GAAG,IAAI,GAAG,CAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AACvG,MAAM,UAAU,GAAmC,CAAC,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEpG,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,KAAyD,CAAC;IAC3E,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IACvH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,WAA4C,CAAC;IAC1E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAClG,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACtH,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,KAAK,CAAC,sCAAsC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACpH,IAAI,UAAU,CAAC,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,OAAO,UAAU,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,uBAAuB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,QAAQ,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,CAAC,EAAE,qCAAqC,CAAC,CAAC;QACpF,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9G,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,IAAI,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAE7D,MAAM,UAAU,uBAAuB;IACrC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,WAAmB;IACnE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAC5C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED;mFACmF;AACnF,MAAM,UAAU,8BAA8B,CAAC,OAI9C;IACC,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACtG,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,UAAU,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,UAA4B;IACpE,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAA4B,EAC5B,SAA8B;IAE9B,OAAO,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC"}

package/dist/contract-generations.json

@@ -0,0 +1,48 @@
+{
+    "schemaVersion": 1,
+    "generations": [
+        {
+            "id": "abx-core-v3",
+            "coreVersion": 3,
+            "lifecycle": "current",
+            "deployed": "2026-09-10",
+            "support": {
+                "newDeployments": true,
+                "reads": true,
+                "writes": true,
+                "serving": true
+            },
+            "factories": {
+                "factory": "0x2ff8828a9150401225bB217CAA8b9b5e666a1c97",
+                "seriesFactory": "0x83222f791cA243FEb0c1Fef93a8732eCe3001b4b",
+                "seriesCodeFactory": "0xEAB8a19fEada0DDba2FDE324715eBbB6234B5616",
+                "oneOfOneEditionFactory": "0x4e9dFcC70dCC02FA5bad113Bc2CF0A2218358B1E",
+                "editionFactory": "0xCC29eD68f26693dc9Aa5f090B21F37985206cc19",
+                "editionCodeFactory": "0x86f9CFe597ab145452f4A66ac102291d54e8EB46"
+            },
+            "note": "Current production-candidate factory generation. Runtime behavior matches the final v2 generation apart from its reported core version."
+        },
+        {
+            "id": "abx-core-v2",
+            "coreVersion": 2,
+            "lifecycle": "supported",
+            "deployed": "2026-08-20",
+            "retired": "2026-09-10",
+            "support": {
+                "newDeployments": false,
+                "reads": true,
+                "writes": true,
+                "serving": true
+            },
+            "factories": {
+                "factory": "0x2824F4b4b4301dB2FcA10b2D80D45b4d463Ba57E",
+                "seriesFactory": "0x685B4DfC835b6854590B5437C79D62BB7D52698b",
+                "seriesCodeFactory": "0xdDA5174A868A8e099E159E67569900a4F936CFFe",
+                "oneOfOneEditionFactory": "0x6ecc7fAd2186965BaECD0Aa215b00239a3459ddF",
+                "editionFactory": "0xB6a8f051B08A8d6Fb0B6DA53BD23006CE2da31b7",
+                "editionCodeFactory": "0x9441Cc75318E20Ae6237EDb213b4C3019d756Bf0"
+            },
+            "note": "Prior supported testnet generation. Existing collections remain readable, writable, indexable, and serveable."
+        }
+    ]
+}

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,77 @@ 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 to preserve EIP-170
+ *  headroom; externalizing the metadata field store makes 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;;wEAEwE;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"}