@artblocks/abx-sdk 0.1.0-alpha.0

package/dist/deployments.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Canonical, shared ABX infrastructure — shipped as constants, keyed by EIP-155 chainId.
+ *
+ * The clone **factories** (trust anchors) and the stateless singletons (renderer, chunk store,
+ * minter, seed source) are deployed as public goods and recorded here, so the toolkit resolves
+ * them with zero local state — no per-user cache, no `config.json`. This is what lets the CLI be
+ * stateless about which infrastructure to use.
+ *
+ * DETERMINISTIC ADDRESSES: everything except the generator is deployed through the keyless CREATE2
+ * proxy (`0x4e59b44847b379578588920cA78FbF26c0B4956C`) with canonical salts (see
+ * `contracts/script/AbxSalts.sol`), so a given contract has the **same address on every chain** —
+ * that's why `CANONICAL` below is a single record, spread into each chain. Adding a chain deploys
+ * the same salts + initcode → the same addresses (computable before the first tx). The one
+ * exception is the **generator**: its constructor bakes chain-specific immutables (per-chain
+ * runtime-asset pointers + dependency registry), so it's recorded per chain.
+ *
+ * Precedence for every address is **explicit override → env → this manifest**:
+ *   - override: a `--factory` / `--renderer` / `--chunk-store` flag (advanced / one-off)
+ *   - env: `ABX_FACTORY` / `ABX_RENDERER` / `ABX_CHUNK_STORE` (a chain you run that isn't
+ *     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).
+ *
+ * Changing a contract → redeploy → repoint here: see contracts/README.md#changing-a-contract.
+ */
+import type { Address } from 'viem';
+export interface ChainDeployment {
+    factory?: Address;
+    seriesFactory?: Address;
+    seriesCodeFactory?: Address;
+    renderer?: Address;
+    chunkStore?: Address;
+    fixedPriceMinter?: Address;
+    seedSource?: Address;
+    generator?: Address;
+}
+export declare const DEPLOYMENTS: Record<number, ChainDeployment>;
+/** The canonical deployment record for a chain (empty if the chain isn't shipped yet). */
+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;
+export declare function resolveRenderer(chainId: number, override?: string): Address | undefined;
+export declare function resolveChunkStore(chainId: number, override?: string): Address | undefined;
+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 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;
+ * 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.
+ */
+export declare const AB_DEPENDENCY_REGISTRY: Record<number, Address>;
+export declare function resolveDependencyRegistry(chainId: number, override?: string): Address | undefined;
+//# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -0,0 +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"}

package/dist/deployments.js

@@ -0,0 +1,81 @@
+/**
+ * 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.
+ */
+const CANONICAL = {
+    factory: '0xB9eEE39DB7D03E0b94CE403F69E928e2a5F134Ca', // impl 0xf1F0893897CC19e75d829fa550a5228c5119cA39
+    seriesFactory: '0x9d97C00100351682e6625961e033b6F43E60639A', // impl 0x58D8b9F7ABa3043734cBeBfaa9c46875070E16ed
+    seriesCodeFactory: '0x77f61Ead461f368dbF3788EeFe9693bA5a73Bd87', // impl 0xfd2034B6af517AD019f0dD7b007F07eF358D4053
+    renderer: '0x837A5cF907E7a6727B08acfE2A865F2bD5C50b1D', // spec v3
+    chunkStore: '0x03d3a962602093a937B96ee9C0b5C54cec3e701E',
+    fixedPriceMinter: '0xd970A2c936FFbb2130c2e4Ddf4245FF92465fEA5',
+    seedSource: '0x53eDFD2047e00C133378DEb430183DEE285E652e',
+};
+export const DEPLOYMENTS = {
+    // Sepolia (testnet) — CANONICAL infra + its own generator. Generator wired to AB's Sepolia
+    // dependency registry; default gateways ipfs.io / arweave.net.
+    11155111: {
+        ...CANONICAL,
+        generator: '0x819D26830E1FbD1a3b383EcA1C24bc2770000910',
+    },
+    // 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.
+    84532: {
+        ...CANONICAL,
+        generator: '0x229337CA6A442b266BD43B7C70F0f24A2E378cB2',
+    },
+};
+/** The canonical deployment record for a chain (empty if the chain isn't shipped yet). */
+export function getDeployment(chainId) {
+    return DEPLOYMENTS[chainId] ?? {};
+}
+// override → env → manifest. Returns undefined when none of the three has a value.
+function pick(override, env, manifest) {
+    return (override ?? env ?? manifest);
+}
+export function resolveFactory(chainId, override) {
+    return pick(override, process.env.ABX_FACTORY, getDeployment(chainId).factory);
+}
+export function resolveSeriesFactory(chainId, override) {
+    return pick(override, process.env.ABX_SERIES_FACTORY, getDeployment(chainId).seriesFactory);
+}
+export function resolveRenderer(chainId, override) {
+    return pick(override, process.env.ABX_RENDERER, getDeployment(chainId).renderer);
+}
+export function resolveChunkStore(chainId, override) {
+    return pick(override, process.env.ABX_CHUNK_STORE, getDeployment(chainId).chunkStore);
+}
+export function resolveFixedPriceMinter(chainId, override) {
+    return pick(override, process.env.ABX_FIXED_PRICE_MINTER, getDeployment(chainId).fixedPriceMinter);
+}
+export function resolveSeriesCodeFactory(chainId, override) {
+    return pick(override, process.env.ABX_SERIES_CODE_FACTORY, getDeployment(chainId).seriesCodeFactory);
+}
+export function resolveSeedSource(chainId, override) {
+    return pick(override, process.env.ABX_SEED_SOURCE, getDeployment(chainId).seedSource);
+}
+export function resolveGenerator(chainId, override) {
+    return pick(override, process.env.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;
+ * 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.
+ */
+export const AB_DEPENDENCY_REGISTRY = {
+    1: '0x37861f95882ACDba2cCD84F5bFc4598e2ECDDdAF', // mainnet
+    11155111: '0x5Fcc415BCFb164C5F826B5305274749BeB684e9b', // Sepolia
+};
+export function resolveDependencyRegistry(chainId, override) {
+    return pick(override, process.env.ABX_DEPENDENCY_REGISTRY, AB_DEPENDENCY_REGISTRY[chainId]);
+}
+//# sourceMappingURL=deployments.js.map

package/dist/deployments.js.map

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

package/dist/deps.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Dependencies extension helpers — the vocabulary of a code project's ordered library
+ * declarations (`IAbxDependencies`): `(Resolution, bytes32 ref)` pairs, index 0 = the
+ * runtime by convention.
+ *
+ * Two ref shapes, auto-detectable from the human form:
+ *   - `name@version` (e.g. `p5@1.0.0` — AB registry naming convention) → `Resolution.Registry`;
+ *     encoded as readable-ASCII bytes32, left-aligned + zero-padded (a Solidity `bytes32`
+ *     string literal) — resolved through the collection's soft `dependencyRegistry()` pointer.
+ *   - `0x` + 40 hex (a raw data contract) → `Resolution.OnChain`; the address left-aligned
+ *     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.
+ */
+import { type Address, type Hex } from 'viem';
+/** `IAbxDependencies.Resolution` — index-aligned with the Solidity enum. */
+export declare const DEP_RESOLUTION: {
+    readonly registry: 0;
+    readonly onchain: 1;
+};
+export type DepResolution = (typeof DEP_RESOLUTION)[keyof typeof DEP_RESOLUTION];
+/** One parsed dependency ref: the enum value + the bytes32 the contract stores + the human form. */
+export interface ParsedDependencyRef {
+    resolution: DepResolution;
+    ref: Hex;
+    display: string;
+}
+/** Encode a registry `name@version` as its readable-ASCII bytes32 (left-aligned, zero-padded —
+ *  exactly `bytes32("p5@1.0.0")` in Solidity). Validates the AB naming convention: printable
+ *  non-space ASCII, ≤ 32 bytes, exactly one `@` with a non-empty name and version. */
+export declare function encodeDependencyName(nameAndVersion: string): Hex;
+/**
+ * Parse a human `--dep` ref into its `(Resolution, bytes32)` pair — the one auto-detection
+ * rule: `0x` + 40 hex ⇒ `OnChain` (address left-aligned in bytes32); anything else must be a
+ * valid registry `name@version` ⇒ `Registry`.
+ */
+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 [{
+    readonly type: "function";
+    readonly name: "getDependencyDetails";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "dependencyNameAndVersion";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "nameAndVersion";
+        readonly type: "string";
+    }, {
+        readonly name: "licenseType";
+        readonly type: "string";
+    }, {
+        readonly name: "preferredCDN";
+        readonly type: "string";
+    }, {
+        readonly name: "additionalCDNCount";
+        readonly type: "uint24";
+    }, {
+        readonly name: "preferredRepository";
+        readonly type: "string";
+    }, {
+        readonly name: "additionalRepositoryCount";
+        readonly type: "uint24";
+    }, {
+        readonly name: "dependencyWebsite";
+        readonly type: "string";
+    }, {
+        readonly name: "availableOnChain";
+        readonly type: "bool";
+    }, {
+        readonly name: "scriptCount";
+        readonly type: "uint24";
+    }];
+}];
+/** What the selection-time check cares about from a registry record. */
+export interface RegistryDependencyDetails {
+    nameAndVersion: string;
+    licenseType: string;
+    preferredCDN: string;
+    availableOnChain: boolean;
+    scriptCount: number;
+}
+/** The one read this module needs — structurally satisfied by a viem `PublicClient` or a test mock. */
+export interface DependencyReadClient {
+    readContract(args: {
+        address: Address;
+        abi: readonly unknown[];
+        functionName: string;
+        args: readonly unknown[];
+    }): Promise<unknown>;
+}
+/**
+ * Read one dependency's registry record. Returns `null` when the registry doesn't know the
+ * ref — AB's registry doesn't revert for an unknown dependency: it ECHOES the requested
+ * `nameAndVersion` back with every other field zero-valued (verified against Sepolia), so
+ * existence is "any substantive field set" (license is required at registration upstream,
+ * so a real record always has at least that — e.g. `js@na` is license-only). Any
+ * transport/revert error propagates — the caller decides whether that means "not found"
+ * (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>;
+//# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -0,0 +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"}

package/dist/deps.js

@@ -0,0 +1,103 @@
+/**
+ * Dependencies extension helpers — the vocabulary of a code project's ordered library
+ * declarations (`IAbxDependencies`): `(Resolution, bytes32 ref)` pairs, index 0 = the
+ * runtime by convention.
+ *
+ * Two ref shapes, auto-detectable from the human form:
+ *   - `name@version` (e.g. `p5@1.0.0` — AB registry naming convention) → `Resolution.Registry`;
+ *     encoded as readable-ASCII bytes32, left-aligned + zero-padded (a Solidity `bytes32`
+ *     string literal) — resolved through the collection's soft `dependencyRegistry()` pointer.
+ *   - `0x` + 40 hex (a raw data contract) → `Resolution.OnChain`; the address left-aligned
+ *     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.
+ */
+import { padHex, toHex } from 'viem';
+import { decodeTag } from './spine.js';
+/** `IAbxDependencies.Resolution` — index-aligned with the Solidity enum. */
+export const DEP_RESOLUTION = { registry: 0, onchain: 1 };
+// Printable non-space ASCII — what a readable bytes32 tag can carry unambiguously
+// (trailing spaces are stripped by the tag decode, so a space anywhere is refused).
+const PRINTABLE_ASCII = /^[\x21-\x7E]+$/;
+/** Encode a registry `name@version` as its readable-ASCII bytes32 (left-aligned, zero-padded —
+ *  exactly `bytes32("p5@1.0.0")` in Solidity). Validates the AB naming convention: printable
+ *  non-space ASCII, ≤ 32 bytes, exactly one `@` with a non-empty name and version. */
+export function encodeDependencyName(nameAndVersion) {
+    const tag = nameAndVersion.trim();
+    if (!PRINTABLE_ASCII.test(tag)) {
+        throw new Error(`dependency ref '${nameAndVersion}' must be printable non-space ASCII (a registry ref is a readable bytes32)`);
+    }
+    if (tag.length > 32) {
+        throw new Error(`dependency ref '${tag}' is ${tag.length} bytes — a bytes32 ref holds at most 32`);
+    }
+    const at = tag.indexOf('@');
+    if (at <= 0 || at !== tag.lastIndexOf('@') || at === tag.length - 1) {
+        throw new Error(`dependency ref '${tag}' must be name@version with exactly one '@' (e.g. p5@1.0.0), or a 0x… data-contract address`);
+    }
+    return toHex(tag, { size: 32 });
+}
+/**
+ * Parse a human `--dep` ref into its `(Resolution, bytes32)` pair — the one auto-detection
+ * rule: `0x` + 40 hex ⇒ `OnChain` (address left-aligned in bytes32); anything else must be a
+ * valid registry `name@version` ⇒ `Registry`.
+ */
+export function parseDependencyRef(input) {
+    const t = input.trim();
+    if (/^0x[0-9a-fA-F]{40}$/.test(t)) {
+        const addr = t.toLowerCase();
+        return { resolution: DEP_RESOLUTION.onchain, ref: padHex(addr, { size: 32, dir: 'right' }), display: addr };
+    }
+    return { resolution: DEP_RESOLUTION.registry, ref: encodeDependencyName(t), display: t };
+}
+/** 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 function decodeDependencyRef(resolution, ref) {
+    return resolution === DEP_RESOLUTION.onchain ? '0x' + ref.slice(2, 42) : decodeTag(ref);
+}
+// ── the AB-compatible registry read (IDependencyRegistryV0) ───────────────────
+/** 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 const dependencyRegistryReadAbi = [
+    {
+        type: 'function',
+        name: 'getDependencyDetails',
+        stateMutability: 'view',
+        inputs: [{ name: 'dependencyNameAndVersion', type: 'bytes32' }],
+        outputs: [
+            { name: 'nameAndVersion', type: 'string' },
+            { name: 'licenseType', type: 'string' },
+            { name: 'preferredCDN', type: 'string' },
+            { name: 'additionalCDNCount', type: 'uint24' },
+            { name: 'preferredRepository', type: 'string' },
+            { name: 'additionalRepositoryCount', type: 'uint24' },
+            { name: 'dependencyWebsite', type: 'string' },
+            { name: 'availableOnChain', type: 'bool' },
+            { name: 'scriptCount', type: 'uint24' },
+        ],
+    },
+];
+/**
+ * Read one dependency's registry record. Returns `null` when the registry doesn't know the
+ * ref — AB's registry doesn't revert for an unknown dependency: it ECHOES the requested
+ * `nameAndVersion` back with every other field zero-valued (verified against Sepolia), so
+ * existence is "any substantive field set" (license is required at registration upstream,
+ * so a real record always has at least that — e.g. `js@na` is license-only). Any
+ * transport/revert error propagates — the caller decides whether that means "not found"
+ * (a revert) or "check unavailable" (RPC down); this stays a pure read.
+ */
+export async function readRegistryDependency(client, registry, ref) {
+    const out = (await client.readContract({
+        address: registry,
+        abi: dependencyRegistryReadAbi,
+        functionName: 'getDependencyDetails',
+        args: [ref],
+    }));
+    const [nameAndVersion, licenseType, preferredCDN, , preferredRepository, , website, availableOnChain, scriptCount] = out;
+    const exists = Boolean(licenseType || preferredCDN || preferredRepository || website || availableOnChain || Number(scriptCount) > 0);
+    if (!nameAndVersion || !exists)
+        return null;
+    return { nameAndVersion, licenseType, preferredCDN, availableOnChain, scriptCount: Number(scriptCount) };
+}
+//# sourceMappingURL=deps.js.map

package/dist/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAC,MAAM,EAAE,KAAK,EAAyB,MAAM,MAAM,CAAC;AAC3D,OAAO,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAErC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,EAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAU,CAAC;AAUjE,kFAAkF;AAClF,oFAAoF;AACpF,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC;;sFAEsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,cAAsB;IACzD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,cAAc,4EAA4E,CAAC,CAAC;IACjI,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,QAAQ,GAAG,CAAC,MAAM,yCAAyC,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,6FAA6F,CAAC,CAAC;IACvI,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,EAAE,EAAC,IAAI,EAAE,EAAE,EAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAa,CAAC;QACxC,OAAO,EAAC,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;IAC1G,CAAC;IACD,OAAO,EAAC,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAC,CAAC;AACzF,CAAC;AAED;qFACqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,UAAyB,EAAE,GAAQ;IACrE,OAAO,UAAU,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED,iFAAiF;AAEjF;kGACkG;AAClG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,sBAAsB;QAC5B,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAC,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC;QAC7D,OAAO,EAAE;YACP,EAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAC;YACxC,EAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAC;YACrC,EAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAC;YACtC,EAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAC;YAC5C,EAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAC;YAC7C,EAAC,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,EAAC;YACnD,EAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAC;YAC3C,EAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAC;YACxC,EAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAC;SACtC;KACF;CACO,CAAC;AAgBX;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA4B,EAC5B,QAAiB,EACjB,GAAQ;IAER,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;QACrC,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,yBAAyB;QAC9B,YAAY,EAAE,sBAAsB;QACpC,IAAI,EAAE,CAAC,GAAG,CAAC;KACZ,CAAC,CAA8E,CAAC;IACjF,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,AAAD,EAAG,mBAAmB,EAAE,AAAD,EAAG,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,GAAG,GAAG,CAAC;IACzH,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,IAAI,mBAAmB,IAAI,OAAO,IAAI,gBAAgB,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACrI,IAAI,CAAC,cAAc,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,EAAC,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,EAAC,CAAC;AACzG,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,2 @@
+export declare function loadDotEnv(startDir?: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAWA,wBAAgB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,IAAI,CAcjE"}

package/dist/env.js

@@ -0,0 +1,45 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+/**
+ * Minimal, dependency-free .env loader. Walks up from `startDir` to the repo
+ * root looking for a `.env`, and sets any keys not already present in the
+ * environment. Deliberately tiny — the toolkit must run with `pnpm install`
+ * and nothing else.
+ */
+let loaded = false;
+export function loadDotEnv(startDir = process.cwd()) {
+    if (loaded)
+        return;
+    loaded = true;
+    let dir = resolve(startDir);
+    for (let i = 0; i < 8; i++) {
+        const candidate = resolve(dir, '.env');
+        if (existsSync(candidate)) {
+            parseInto(readFileSync(candidate, 'utf8'));
+            return;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+}
+function parseInto(content) {
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key && process.env[key] === undefined)
+            process.env[key] = value;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,UAAU,EAAC,MAAM,SAAS,CAAC;AACjD,OAAO,EAAC,OAAO,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAE3C;;;;;GAKG;AACH,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,MAAM,UAAU,UAAU,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACzD,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,GAAG,IAAI,CAAC;IACd,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/fastlz.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FastLZ (level 1) — a pure, dependency-free codec whose output is byte-compatible with
+ * Solady `LibZip.flzDecompress` (the on-chain decompressor the `AbxChunkStore` reader uses).
+ *
+ * We encode off-chain (cheaper than compressing on-chain) and the reader decompresses on
+ * read, so a FastLZ chunk stays fully on-chain-renderable — the compression is purely a
+ * storage-gas optimization, invisible above the reader. The token never sees FastLZ; it's
+ * an internal codec of the chunk store.
+ *
+ * Token format (what flzDecompress expects):
+ *  - literal run: control byte `c` (top 3 bits 0, so `c` in 0..31) ⇒ `c+1` literal bytes follow.
+ *  - short match: top 3 bits `t` in 1..6 ⇒ length `t+2` (3..8); distance-1 = `((c&0x1f)<<8)|next`.
+ *  - long  match: top 3 bits == 7 ⇒ length `9 + lenByte` (9..264); distance-1 = `((c&0x1f)<<8)|distByte`.
+ *  Min match length 3, max back-distance 8192.
+ */
+/** Compress `input` to a FastLZ stream `LibZip.flzDecompress` (and our reader) will inflate. */
+export declare function flzCompress(input: Uint8Array): Uint8Array;
+/** Inflate a FastLZ stream — the JS mirror of `LibZip.flzDecompress` (for tests + off-chain serve). */
+export declare function flzDecompress(input: Uint8Array): Uint8Array;
+//# sourceMappingURL=fastlz.d.ts.map

package/dist/fastlz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastlz.d.ts","sourceRoot":"","sources":["../src/fastlz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAgEzD;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CA6B3D"}

package/dist/fastlz.js

@@ -0,0 +1,123 @@
+/**
+ * FastLZ (level 1) — a pure, dependency-free codec whose output is byte-compatible with
+ * Solady `LibZip.flzDecompress` (the on-chain decompressor the `AbxChunkStore` reader uses).
+ *
+ * We encode off-chain (cheaper than compressing on-chain) and the reader decompresses on
+ * read, so a FastLZ chunk stays fully on-chain-renderable — the compression is purely a
+ * storage-gas optimization, invisible above the reader. The token never sees FastLZ; it's
+ * an internal codec of the chunk store.
+ *
+ * Token format (what flzDecompress expects):
+ *  - literal run: control byte `c` (top 3 bits 0, so `c` in 0..31) ⇒ `c+1` literal bytes follow.
+ *  - short match: top 3 bits `t` in 1..6 ⇒ length `t+2` (3..8); distance-1 = `((c&0x1f)<<8)|next`.
+ *  - long  match: top 3 bits == 7 ⇒ length `9 + lenByte` (9..264); distance-1 = `((c&0x1f)<<8)|distByte`.
+ *  Min match length 3, max back-distance 8192.
+ */
+const MAX_DISTANCE = 8192;
+const MAX_MATCH = 264; // 9 + 255 (one extended-length byte)
+const MIN_MATCH = 3;
+const MAX_LITERAL_RUN = 32;
+const HASH_SIZE = 8192;
+function hash3(b, p) {
+    const v = (b[p] << 16) | (b[p + 1] << 8) | b[p + 2];
+    // 32-bit multiplicative hash → top 13 bits.
+    return (Math.imul(v, 0x9e3779b1) >>> 19) & (HASH_SIZE - 1);
+}
+/** Compress `input` to a FastLZ stream `LibZip.flzDecompress` (and our reader) will inflate. */
+export function flzCompress(input) {
+    const n = input.length;
+    if (n === 0)
+        return new Uint8Array(0);
+    const out = [];
+    const table = new Int32Array(HASH_SIZE).fill(-1);
+    let anchor = 0; // first byte of the pending literal run
+    let p = 0;
+    const emitLiterals = (from, to) => {
+        let i = from;
+        while (i < to) {
+            const run = Math.min(MAX_LITERAL_RUN, to - i);
+            out.push(run - 1); // control byte 0..31
+            for (let k = 0; k < run; k++)
+                out.push(input[i + k]);
+            i += run;
+        }
+    };
+    while (p + MIN_MATCH <= n) {
+        const h = hash3(input, p);
+        const ref = table[h];
+        table[h] = p;
+        const dist = ref >= 0 ? p - ref : 0;
+        if (ref >= 0 &&
+            dist >= 1 &&
+            dist <= MAX_DISTANCE &&
+            input[ref] === input[p] &&
+            input[ref + 1] === input[p + 1] &&
+            input[ref + 2] === input[p + 2]) {
+            let len = MIN_MATCH;
+            const maxLen = Math.min(MAX_MATCH, n - p);
+            while (len < maxLen && input[ref + len] === input[p + len])
+                len++;
+            emitLiterals(anchor, p);
+            const dm1 = dist - 1;
+            if (len <= 8) {
+                out.push(((len - 2) << 5) | (dm1 >> 8)); // t = len-2 in 1..6
+                out.push(dm1 & 0xff);
+            }
+            else {
+                out.push((7 << 5) | (dm1 >> 8));
+                out.push(len - 9); // 0..255
+                out.push(dm1 & 0xff);
+            }
+            // index the consumed region (better matches downstream), then jump past it.
+            const end = p + len;
+            let q = p + 1;
+            while (q < end && q + MIN_MATCH <= n) {
+                table[hash3(input, q)] = q;
+                q++;
+            }
+            p = end;
+            anchor = end;
+        }
+        else {
+            p++;
+        }
+    }
+    emitLiterals(anchor, n); // tail literals (incl. the last <3 bytes that can't start a match)
+    return Uint8Array.from(out);
+}
+/** Inflate a FastLZ stream — the JS mirror of `LibZip.flzDecompress` (for tests + off-chain serve). */
+export function flzDecompress(input) {
+    const n = input.length;
+    const out = [];
+    let i = 0;
+    while (i < n) {
+        const c = input[i];
+        const t = c >> 5;
+        if (t === 0) {
+            const count = c + 1; // literal run
+            for (let k = 0; k < count; k++)
+                out.push(input[i + 1 + k]);
+            i += 2 + c;
+        }
+        else {
+            const extended = t === 7;
+            let len;
+            let dm1;
+            if (!extended) {
+                len = 2 + t;
+                dm1 = ((c & 0x1f) << 8) + input[i + 1];
+                i += 2;
+            }
+            else {
+                len = 9 + input[i + 1];
+                dm1 = ((c & 0x1f) << 8) + input[i + 2];
+                i += 3;
+            }
+            const start = out.length - (dm1 + 1);
+            for (let k = 0; k < len; k++)
+                out.push(out[start + k]); // overlap-safe (RLE)
+        }
+    }
+    return Uint8Array.from(out);
+}
+//# sourceMappingURL=fastlz.js.map

package/dist/fastlz.js.map

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