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

package/dist/deps.js

@@ -12,10 +12,19 @@
  *
  * 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.
+ * load-bearing read behind the CLI's best-effort selection-time check, and
+ * `getDependencyScript(bytes32, index)` is the resolver's own read for on-chain bytes (see the
+ * "resolver's registry-aware serving lane" section below — hoisted from
+ * `@artblocks/abx-token-api` in the abx-services integrator ask, because it shares this exact
+ * vocabulary end to end).
  */
-import { padHex, toHex } from 'viem';
+import { encodeFunctionData, hexToString, padHex, toHex } from 'viem';
 import { decodeTag } from './spine.js';
+import { seriesCodeAbi } from './abi/index.js';
+import { resolveDependencyRegistry } from './deployments.js';
+import { escapeInlineScript } from './generator-document.js';
+import { base64ToBytes } from './util.js';
+import { InflateRequiredError } from './errors.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
@@ -57,9 +66,16 @@ 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 = [
+/**
+ * The load-bearing reads of AB's `IDependencyRegistryV0` — the exact upstream signatures (any
+ * registry ABX consumers read from speaks this shape; see the dependency-registry spec).
+ * `getDependencyDetails` backs both the CLI's best-effort selection-time check and the
+ * resolver's own resolution; `getDependencyScript` is the resolver-only per-chunk read for a
+ * dep whose bytes live on chain. (Merging this hoist: token-api's `DEPENDENCY_REGISTRY_ABI` and
+ * this module's prior `dependencyRegistryReadAbi` declared the identical `getDependencyDetails`
+ * entry twice — one array now backs both callers.)
+ */
+export const DEPENDENCY_REGISTRY_ABI = [
     {
         type: 'function',
         name: 'getDependencyDetails',
@@ -77,6 +93,16 @@ export const dependencyRegistryReadAbi = [
             { name: 'scriptCount', type: 'uint24' },
         ],
     },
+    {
+        type: 'function',
+        name: 'getDependencyScript',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'dependencyNameAndVersion', type: 'bytes32' },
+            { name: 'index', type: 'uint256' },
+        ],
+        outputs: [{ type: 'string' }],
+    },
 ];
 /**
  * Read one dependency's registry record. Returns `null` when the registry doesn't know the
@@ -90,7 +116,7 @@ export const dependencyRegistryReadAbi = [
 export async function readRegistryDependency(client, registry, ref) {
     const out = (await client.readContract({
         address: registry,
-        abi: dependencyRegistryReadAbi,
+        abi: DEPENDENCY_REGISTRY_ABI,
         functionName: 'getDependencyDetails',
         args: [ref],
     }));
@@ -100,4 +126,220 @@ export async function readRegistryDependency(client, registry, ref) {
         return null;
     return { nameAndVersion, licenseType, preferredCDN, availableOnChain, scriptCount: Number(scriptCount) };
 }
+// ── the deploy-time dependency lane (registry pointer, setup legs, selection-time check) ──────
+// The rest of a code project's dependency handling: resolving which registry a deploy should point
+// at, composing the setup-multicall legs, and the best-effort existence check against that registry.
+// `parseDepFlag` (the `--dep` CLI flag grammar) is CLI-local and stays there — everything downstream
+// of a parsed `ParsedDependencyRef[]` lives here.
+/**
+ * The registry pointer a deploy with ≥1 Registry-resolution dep should set: an explicit
+ * `--dep-registry` wins (validated), else the chain's known AB registry (env-overridable),
+ * else none — the caller WARNS and skips the leg (soft pointer; the resolver falls back to
+ * its built-in CDN map). Never a blocker.
+ */
+export function resolveDepRegistryPointer(flagValue, chainId) {
+    if (flagValue !== undefined) {
+        if (flagValue === 'true' || !/^0x[0-9a-fA-F]{40}$/.test(flagValue)) {
+            throw new Error(`--dep-registry must be an address (0x + 40 hex); got '${flagValue}'`);
+        }
+        return { registry: flagValue, source: 'flag' };
+    }
+    const known = resolveDependencyRegistry(chainId);
+    return known ? { registry: known, source: 'default' } : { registry: null, source: 'none' };
+}
+/**
+ * The dependency legs of the setup multicall: one `setDependency(i, resolution, ref)` per
+ * dep in index order, plus the `setDependencyRegistry` leg when a pointer resolved. These
+ * ride the SAME atomic setup multicall as script chunks/schemas/mints, in every signing lane.
+ */
+export function dependencySetupCalls(deps, registry) {
+    const calls = deps.map((d, i) => encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setDependency', args: [BigInt(i), d.resolution, d.ref] }));
+    if (deps.length && registry) {
+        calls.push(encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setDependencyRegistry', args: [registry] }));
+    }
+    return calls;
+}
+/**
+ * Best-effort existence/on-chain-ness check of every Registry-resolution dep against the
+ * pointer registry. A revert or an empty record ⇒ `not-found` (a warning — the owner may
+ * intend a custom registry). A transport failure ⇒ the remaining checks are `skipped` and
+ * `rpcOk: false` — one info line, never an error: the deploy proceeds regardless.
+ */
+export async function checkRegistryDeps(client, registry, deps) {
+    const registryDeps = deps.filter((d) => d.resolution === DEP_RESOLUTION.registry);
+    const checks = [];
+    let rpcOk = true;
+    for (const d of registryDeps) {
+        if (!rpcOk) {
+            checks.push({ dep: d.display, status: 'skipped' });
+            continue;
+        }
+        try {
+            const details = await readRegistryDependency(client, registry, d.ref);
+            checks.push(details ? { dep: d.display, status: 'found', details } : { dep: d.display, status: 'not-found' });
+        }
+        catch (e) {
+            // A contract revert means the registry answered "no such dependency"; anything else
+            // (DNS, timeout, HTTP) means we couldn't ask — degrade to skipped, not failed.
+            const msg = `${e.name ?? ''} ${e.message ?? ''}`;
+            if (/ContractFunction|revert|returned no data/i.test(msg)) {
+                checks.push({ dep: d.display, status: 'not-found' });
+            }
+            else {
+                rpcOk = false;
+                checks.push({ dep: d.display, status: 'skipped' });
+            }
+        }
+    }
+    return { checks, rpcOk };
+}
+// Resolved registry entries are effectively immutable (admin-gated writes), so an in-process
+// cache is safe; the TTL only guards admin updates. Failures negative-cache briefly so a dead
+// registry doesn't cost an eth_call (and a warn) per request.
+const REGISTRY_CACHE_TTL_MS = 60 * 60 * 1000; // 1h
+const REGISTRY_NEGATIVE_TTL_MS = 60 * 1000; // 1min
+const registryCache = new Map();
+/** Reset the in-process registry-resolution cache — for tests. */
+export function resetRegistryDependencyCache() {
+    registryCache.clear();
+}
+/** The collection's registry pointer, if set to a real address (zero/undefined ⇒ none). */
+export function activeRegistry(state) {
+    const registry = state.dependencies?.registry ?? null;
+    if (!registry || /^0x0{40}$/i.test(registry))
+        return null;
+    return registry;
+}
+/**
+ * Resolve one `name@version` ref through the collection's registry. Returns the resolution
+ * (or null when the registry couldn't answer — caller falls back to the built-in map) plus
+ * whether it was served from cache. Never throws for a resolution failure; a fresh one logs ONE
+ * warn (the negative cache rate-limits it) naming the dep and why. DOES throw
+ * {@link InflateRequiredError} when the resolution needs decompression and `opts.inflate` is
+ * absent — that is a caller-configuration bug, not a resolution outcome.
+ */
+export async function resolveRegistryDep(client, registry, dep, opts = {}) {
+    const key = `${registry.toLowerCase()}|${dep.refDecoded}`;
+    const hit = registryCache.get(key);
+    if (hit && hit.expiresAt > Date.now()) {
+        return { resolution: hit.value, cached: true, error: hit.error };
+    }
+    try {
+        // nameAndVersion rides as readable-ASCII bytes32 — the raw evented ref, right-padded.
+        const ref = padHex(dep.ref, { size: 32, dir: 'right' });
+        const details = (await client.readContract({
+            address: registry,
+            abi: DEPENDENCY_REGISTRY_ABI,
+            functionName: 'getDependencyDetails',
+            args: [ref],
+        }));
+        const [nameAndVersion, , preferredCDN, , , , , availableOnChain, scriptCount] = details;
+        if (availableOnChain && scriptCount > 0) {
+            // Per-chunk reads; the concatenated chunk strings form one base64(gzip(script)) stream.
+            const chunks = (await Promise.all(Array.from({ length: Number(scriptCount) }, (_, i) => client.readContract({
+                address: registry,
+                abi: DEPENDENCY_REGISTRY_ABI,
+                functionName: 'getDependencyScript',
+                args: [ref, BigInt(i)],
+            }))));
+            if (!opts.inflate)
+                throw new InflateRequiredError();
+            const gz = base64ToBytes(chunks.join(''));
+            const script = new TextDecoder().decode(opts.inflate(gz));
+            const value = { kind: 'onchain', script };
+            registryCache.set(key, { value, expiresAt: Date.now() + REGISTRY_CACHE_TTL_MS });
+            return { resolution: value, cached: false };
+        }
+        if (preferredCDN) {
+            const value = { kind: 'cdn', url: preferredCDN };
+            registryCache.set(key, { value, expiresAt: Date.now() + REGISTRY_CACHE_TTL_MS });
+            return { resolution: value, cached: false };
+        }
+        // An empty struct back means the entry simply isn't registered.
+        const why = nameAndVersion
+            ? 'registered but has neither on-chain bytes nor a preferredCDN'
+            : 'not registered in the registry';
+        return failRegistryResolution(key, dep, registry, why);
+    }
+    catch (err) {
+        // A missing inflate is a host-configuration bug, not a resolution outcome — surface it
+        // rather than mis-reporting it as "registry read failed" and quietly falling back.
+        if (err instanceof InflateRequiredError)
+            throw err;
+        return failRegistryResolution(key, dep, registry, `registry read failed: ${err.message}`);
+    }
+}
+/** Negative-cache a failed resolution + one warn (per negative-TTL window). Never throws. */
+function failRegistryResolution(key, dep, registry, why) {
+    registryCache.set(key, { value: null, error: why, expiresAt: Date.now() + REGISTRY_NEGATIVE_TTL_MS });
+    console.warn(`[deps] registry resolution failed for ${dep.refDecoded} via ${registry}: ${why} — falling back to the built-in CDN map`);
+    return { resolution: null, cached: false, error: why };
+}
+/**
+ * Resolve a `name@version` registry ref to a CDN URL — the built-in reference convention,
+ * the LAST-resort rung of the resolution order (the soft registry pointer stays
+ * non-validating). Known runtimes get their real dist paths; anything else is best-effort npm.
+ */
+export function registryDepUrl(ref) {
+    const at = ref.lastIndexOf('@');
+    if (at <= 0)
+        return null;
+    const name = ref.slice(0, at);
+    const version = ref.slice(at + 1);
+    const known = {
+        p5js: `https://cdn.jsdelivr.net/npm/p5@${version}/lib/p5.min.js`,
+        p5: `https://cdn.jsdelivr.net/npm/p5@${version}/lib/p5.min.js`,
+        threejs: `https://cdn.jsdelivr.net/npm/three@${version}/build/three.min.js`,
+        three: `https://cdn.jsdelivr.net/npm/three@${version}/build/three.min.js`,
+        tonejs: `https://cdn.jsdelivr.net/npm/tone@${version}/build/Tone.js`,
+    };
+    return known[name] ?? `https://cdn.jsdelivr.net/npm/${name}@${version}`;
+}
+/**
+ * The ordered dependency `<script>` tags for the generator document, each dep resolved per
+ * the Consumers table: registry on-chain bytes → registry preferredCDN → built-in map;
+ * `onchain`-resolution refs read their SSTORE2 data contract directly (never a registry).
+ * Never throws for a resolution failure — an unresolvable dep is skipped (after the warn) and
+ * the document assembles. DOES propagate {@link InflateRequiredError} (see
+ * {@link resolveRegistryDep}) — a missing `inflate` is a host wiring bug, not a bad dep.
+ */
+export async function dependencyScriptTags(client, state, opts = {}) {
+    const registry = activeRegistry(state);
+    const tags = [];
+    for (const dep of state.dependencies?.list ?? []) {
+        if (dep.resolution === 'registry') {
+            if (registry) {
+                const { resolution } = await resolveRegistryDep(client, registry, dep, opts);
+                if (resolution?.kind === 'onchain') {
+                    tags.push(`<script>${escapeInlineScript(resolution.script)}</script>`);
+                    continue;
+                }
+                if (resolution?.kind === 'cdn') {
+                    tags.push(`<script src="${resolution.url}"></script>`);
+                    continue;
+                }
+                // fell through — resolveRegistryDep already warned; last resort below
+            }
+            const url = registryDepUrl(dep.refDecoded);
+            if (url)
+                tags.push(`<script src="${url}"></script>`);
+        }
+        else {
+            // on-chain dep: an SSTORE2 data contract holding the JS (code = 0x00 ‖ content). No
+            // inflate needed here — raw bytecode, never gzip'd — so this branch never touches `opts`.
+            const bytecode = await client.getCode({ address: dep.refDecoded });
+            if (bytecode && bytecode.length > 4) {
+                tags.push(`<script>${escapeInlineScript(hexToString(('0x' + bytecode.slice(4))))}</script>`);
+            }
+        }
+    }
+    return tags;
+}
+/** The spec's URL-carried tokenData size budget: gateway front-ends commonly cap request lines
+ *  near 8KB. Applies to URL-carried `?abx=` payloads (a resolver's directory-mode 302 fallback);
+ *  inline document serving is unaffected. Hoisted alongside the rest of this lane — the
+ *  budget-tracking/observability surface built on it (`checkUrlBudget`, `urlBudgetStatus`) stays
+ *  resolver-local (token-api/src/deps.ts), since it's a serving-observability concern rather than
+ *  a resolution rule. */
+export const URL_BUDGET_BYTES = 8192;
 //# sourceMappingURL=deps.js.map

package/dist/deps.js.map

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

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAWA,wBAAgB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,IAAI,CAcjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAC,CA6BzG"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAmBA,wBAAgB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,IAAI,CAcjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAC,CA6BzG"}

package/dist/env.js

@@ -5,6 +5,14 @@ import { dirname, resolve } from 'node:path';
  * 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.
+ *
+ * Node-only (needs `node:fs` + `node:path`) — reached exclusively through the
+ * `@artblocks/abx-sdk/node` subpath, never the package's main entry (which a browser
+ * bundle must be able to import — see `test/browser-bundle.test.ts`). A host calls
+ * {@link loadDotEnv} once at startup; the SDK core never calls it itself (it reads
+ * whatever's already in `process.env` via `util.ts`'s `readEnv`). Because this module is
+ * Node-subpath-only, `parseInto`'s `console.error` on a conflicting duplicate key is fine
+ * to leave as a direct console write — there is no browser caller to surprise.
  */
 let loaded = false;
 export function loadDotEnv(startDir = process.cwd()) {

package/dist/env.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,94 @@
+import type { Address, Hex } from 'viem';
+import type { SeedSourceProbe, SeedSourceVerdict } from './ops.js';
+/**
+ * The SDK's error taxonomy — deliberately minimal. A caller that wants to react to a SPECIFIC
+ * failure (retry a stale estimate, surface a revert's tx hash) should catch by TYPE, not by
+ * parsing `.message`; every SDK-thrown error a caller is expected to distinguish extends this,
+ * following the same `name` + typed-fields convention `AbxServiceError` already uses (service.ts).
+ * This module stays small on purpose — it grows only when a real caller needs a new type to catch,
+ * not as a speculative taxonomy of everything that could go wrong.
+ */
+export declare class AbxSdkError extends Error {
+    constructor(message: string);
+}
+/**
+ * A sent transaction MINED with `status: 'reverted'`. Thrown by {@link makeHotSender} (and anything
+ * else driving `SendTx`) instead of letting a revert masquerade as a "confirmed" send — carries the
+ * tx hash so a caller can look it up on an explorer without re-parsing a message string.
+ */
+export declare class TxRevertedError extends AbxSdkError {
+    readonly op: string;
+    readonly txHash: Hex;
+    constructor(op: string, txHash: Hex);
+}
+/**
+ * `pinGas`'s refusal: every estimate attempt came back below the transaction's PROVABLE gas floor
+ * (`PreparedTx.gasFloor` — EVM code deposit at exactly 200 gas/byte, and nothing else is physics).
+ * That is proof the node answering the estimate hasn't seen the target's deploy block yet, not that
+ * the floor is wrong — see `pinGas` in `execute.ts` for the full reasoning. Carries both numbers so a
+ * caller can decide to retry against a different RPC rather than re-parse the message.
+ */
+export declare class GasEstimateBelowFloorError extends AbxSdkError {
+    readonly estimate: bigint;
+    readonly floor: bigint;
+    constructor(estimate: bigint, floor: bigint);
+}
+/**
+ * No signing key resolved. SINGLE env name: `ABX_DEPLOYER_PK` — thrown by {@link makeWalletClient}
+ * and {@link envSigningKey} (clients.ts). Names the two retired names explicitly (`SEPOLIA_FUNDED_PK`
+ * / `SEPOLIA_WALLET_PK`) rather than just omitting them, because a caller upgrading from an older
+ * alpha has one of those set in their `.env` and would otherwise see a plain "no key found" with no
+ * clue that the key IS there, just under a name the SDK no longer reads.
+ */
+export declare class MissingSigningKeyError extends AbxSdkError {
+    constructor();
+}
+/**
+ * A registry-resolved dependency's on-chain bytes are gzip'd, and no `inflate` was supplied to
+ * decompress them (`resolveRegistryDep`/`dependencyScriptTags`, deps.ts). SDK core carries no
+ * `node:zlib` — it has to stay reachable from a browser bundle (see `test/browser-bundle.test.ts`)
+ * — so decompression is an injected function rather than a direct call. Thrown instead of letting
+ * the caller either crash on `opts.inflate(...)` being undefined or silently serve a broken
+ * document; names the exact fix instead of a generic "cannot read properties of undefined".
+ */
+export declare class InflateRequiredError extends AbxSdkError {
+    constructor();
+}
+/** The bootstrap-or-refuse trust anchors / singletons `ensureFactory` & co. (anchors.ts) resolve —
+ *  the 721 set (five) plus the ERC-1155 editions twins (`ensureOneOfOneEditionFactory`/
+ *  `ensureEditionFactory`/`ensureEditionCodeFactory`). */
+export type AnchorKind = 'factory' | 'series-factory' | 'series-code-factory' | 'renderer' | 'seed-source' | 'one-of-one-edition-factory' | 'edition-factory' | 'edition-code-factory';
+/**
+ * A trust anchor {@link AnchorKind} that `ensureFactory`/`ensureSeriesFactory`/
+ * `ensureSeriesCodeFactory` (anchors.ts) could not resolve to a usable address, with
+ * `allowBootstrap` false — the caller must either point at a working one (override / env /
+ * manifest) or opt in to deploying a private one. Carries structured `detail` + `address` instead
+ * of a formatted sentence: the SDK doesn't know a UX's flag names or chain-key strings, so it never
+ * composes the actual guidance text itself — that's the CLI's `refuseMissingFactory`, which catches
+ * this and names the env var / `--bootstrap-factory` / the chain.
+ */
+export declare class AnchorUnavailableError extends AbxSdkError {
+    readonly anchor: AnchorKind;
+    readonly detail: 'no-code' | 'stale-version' | 'not-configured';
+    readonly address?: Address;
+    constructor(anchor: AnchorKind, detail: 'no-code' | 'stale-version' | 'not-configured', address?: Address);
+}
+/**
+ * A candidate seed source that {@link probeSeedSource} found unusable — thrown by
+ * `assertSeedSourceUsable` (ops.ts). Carries the whole probe (verdict + what was observed) rather
+ * than a formatted sentence, same reason as {@link AnchorUnavailableError}: the SDK doesn't know
+ * whether the caller got this address from a `--seed-source` flag, an env var, or a form field, so
+ * it never composes the guidance itself.
+ *
+ * Worth catching by type: this is the ONE misconfiguration whose consequence is "every mint of the
+ * collection reverts", and it is invisible on every read surface (`seedSource()` returns exactly
+ * what was set; the `SeedSourceSet` event fires) — so a UX should treat it as a hard stop, not a
+ * warning it can proceed past.
+ */
+export declare class SeedSourceUnusableError extends AbxSdkError {
+    readonly verdict: SeedSourceVerdict;
+    readonly address: Address;
+    readonly probe: SeedSourceProbe;
+    constructor(probe: SeedSourceProbe);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,GAAG,EAAC,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAC,eAAe,EAAE,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAEjE;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;gBACT,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;CAMpC;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,WAAW;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAW5C;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;;CAQtD;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;;CAUpD;AAED;;0DAE0D;AAC1D,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,gBAAgB,GAChB,qBAAqB,GACrB,UAAU,GACV,aAAa,GACb,4BAA4B,GAC5B,iBAAiB,GACjB,sBAAsB,CAAC;AAE3B;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBACf,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,eAAe,GAAG,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO;CAO1G;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;gBACpB,KAAK,EAAE,eAAe;CAOnC"}

package/dist/errors.js

@@ -0,0 +1,126 @@
+/**
+ * The SDK's error taxonomy — deliberately minimal. A caller that wants to react to a SPECIFIC
+ * failure (retry a stale estimate, surface a revert's tx hash) should catch by TYPE, not by
+ * parsing `.message`; every SDK-thrown error a caller is expected to distinguish extends this,
+ * following the same `name` + typed-fields convention `AbxServiceError` already uses (service.ts).
+ * This module stays small on purpose — it grows only when a real caller needs a new type to catch,
+ * not as a speculative taxonomy of everything that could go wrong.
+ */
+export class AbxSdkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AbxSdkError';
+    }
+}
+/**
+ * A sent transaction MINED with `status: 'reverted'`. Thrown by {@link makeHotSender} (and anything
+ * else driving `SendTx`) instead of letting a revert masquerade as a "confirmed" send — carries the
+ * tx hash so a caller can look it up on an explorer without re-parsing a message string.
+ */
+export class TxRevertedError extends AbxSdkError {
+    op;
+    txHash;
+    constructor(op, txHash) {
+        super(`${op} reverted (${txHash})`);
+        this.name = 'TxRevertedError';
+        this.op = op;
+        this.txHash = txHash;
+    }
+}
+/**
+ * `pinGas`'s refusal: every estimate attempt came back below the transaction's PROVABLE gas floor
+ * (`PreparedTx.gasFloor` — EVM code deposit at exactly 200 gas/byte, and nothing else is physics).
+ * That is proof the node answering the estimate hasn't seen the target's deploy block yet, not that
+ * the floor is wrong — see `pinGas` in `execute.ts` for the full reasoning. Carries both numbers so a
+ * caller can decide to retry against a different RPC rather than re-parse the message.
+ */
+export class GasEstimateBelowFloorError extends AbxSdkError {
+    estimate;
+    floor;
+    constructor(estimate, floor) {
+        super(`Refusing to send: the RPC estimated ${estimate} gas for a transaction that provably needs at least ${floor} ` +
+            `(storing ${floor / 200n} bytes on-chain costs 200 gas/byte in code deposit alone). An estimate below the floor means the node ` +
+            `is answering from stale state — usually it has not seen the contract's deploy block yet, so the call looks like it is going to ` +
+            `an empty account. Sending this would revert DeploymentFailed() and burn the gas. Retry in a few seconds, or use a different RPC.`);
+        this.name = 'GasEstimateBelowFloorError';
+        this.estimate = estimate;
+        this.floor = floor;
+    }
+}
+/**
+ * No signing key resolved. SINGLE env name: `ABX_DEPLOYER_PK` — thrown by {@link makeWalletClient}
+ * and {@link envSigningKey} (clients.ts). Names the two retired names explicitly (`SEPOLIA_FUNDED_PK`
+ * / `SEPOLIA_WALLET_PK`) rather than just omitting them, because a caller upgrading from an older
+ * alpha has one of those set in their `.env` and would otherwise see a plain "no key found" with no
+ * clue that the key IS there, just under a name the SDK no longer reads.
+ */
+export class MissingSigningKeyError extends AbxSdkError {
+    constructor() {
+        super('No signing key found. Set ABX_DEPLOYER_PK in your .env. ' +
+            '(SEPOLIA_FUNDED_PK and SEPOLIA_WALLET_PK are no longer read — rename the key to ABX_DEPLOYER_PK.)');
+        this.name = 'MissingSigningKeyError';
+    }
+}
+/**
+ * A registry-resolved dependency's on-chain bytes are gzip'd, and no `inflate` was supplied to
+ * decompress them (`resolveRegistryDep`/`dependencyScriptTags`, deps.ts). SDK core carries no
+ * `node:zlib` — it has to stay reachable from a browser bundle (see `test/browser-bundle.test.ts`)
+ * — so decompression is an injected function rather than a direct call. Thrown instead of letting
+ * the caller either crash on `opts.inflate(...)` being undefined or silently serve a broken
+ * document; names the exact fix instead of a generic "cannot read properties of undefined".
+ */
+export class InflateRequiredError extends AbxSdkError {
+    constructor() {
+        super("A registry-resolved dependency's on-chain bytes are gzip-compressed, but no `inflate` was " +
+            'provided to decompress them. On a Node host, pass `nodeInflate` from `@artblocks/abx-sdk/node` ' +
+            "(e.g. `dependencyScriptTags(client, state, {inflate: nodeInflate})`). In a browser, pass a " +
+            'DecompressionStream-based implementation — SDK core carries no `node:zlib` so it never assumes one.');
+        this.name = 'InflateRequiredError';
+    }
+}
+/**
+ * A trust anchor {@link AnchorKind} that `ensureFactory`/`ensureSeriesFactory`/
+ * `ensureSeriesCodeFactory` (anchors.ts) could not resolve to a usable address, with
+ * `allowBootstrap` false — the caller must either point at a working one (override / env /
+ * manifest) or opt in to deploying a private one. Carries structured `detail` + `address` instead
+ * of a formatted sentence: the SDK doesn't know a UX's flag names or chain-key strings, so it never
+ * composes the actual guidance text itself — that's the CLI's `refuseMissingFactory`, which catches
+ * this and names the env var / `--bootstrap-factory` / the chain.
+ */
+export class AnchorUnavailableError extends AbxSdkError {
+    anchor;
+    detail;
+    address;
+    constructor(anchor, detail, address) {
+        super(`${anchor} trust anchor unavailable (${detail}${address ? `: ${address}` : ''})`);
+        this.name = 'AnchorUnavailableError';
+        this.anchor = anchor;
+        this.detail = detail;
+        this.address = address;
+    }
+}
+/**
+ * A candidate seed source that {@link probeSeedSource} found unusable — thrown by
+ * `assertSeedSourceUsable` (ops.ts). Carries the whole probe (verdict + what was observed) rather
+ * than a formatted sentence, same reason as {@link AnchorUnavailableError}: the SDK doesn't know
+ * whether the caller got this address from a `--seed-source` flag, an env var, or a form field, so
+ * it never composes the guidance itself.
+ *
+ * Worth catching by type: this is the ONE misconfiguration whose consequence is "every mint of the
+ * collection reverts", and it is invisible on every read surface (`seedSource()` returns exactly
+ * what was set; the `SeedSourceSet` event fires) — so a UX should treat it as a hard stop, not a
+ * warning it can proceed past.
+ */
+export class SeedSourceUnusableError extends AbxSdkError {
+    verdict;
+    address;
+    probe;
+    constructor(probe) {
+        super(`seed source ${probe.address} is not usable (${probe.verdict}${probe.error ? `: ${probe.error}` : ''})`);
+        this.name = 'SeedSourceUnusableError';
+        this.verdict = probe.verdict;
+        this.address = probe.address;
+        this.probe = probe;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACrC,EAAE,CAAS;IACX,MAAM,CAAM;IACrB,YAAY,EAAU,EAAE,MAAW;QACjC,KAAK,CAAC,GAAG,EAAE,cAAc,MAAM,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,0BAA2B,SAAQ,WAAW;IAChD,QAAQ,CAAS;IACjB,KAAK,CAAS;IACvB,YAAY,QAAgB,EAAE,KAAa;QACzC,KAAK,CACH,uCAAuC,QAAQ,uDAAuD,KAAK,GAAG;YAC5G,YAAY,KAAK,GAAG,IAAI,wGAAwG;YAChI,iIAAiI;YACjI,kIAAkI,CACrI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD;QACE,KAAK,CACH,0DAA0D;YACxD,mGAAmG,CACtG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD;QACE,KAAK,CACH,4FAA4F;YAC1F,iGAAiG;YACjG,6FAA6F;YAC7F,qGAAqG,CACxG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAeD;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IAC5C,MAAM,CAAa;IACnB,MAAM,CAAiD;IACvD,OAAO,CAAW;IAC3B,YAAY,MAAkB,EAAE,MAAsD,EAAE,OAAiB;QACvG,KAAK,CAAC,GAAG,MAAM,8BAA8B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IAC7C,OAAO,CAAoB;IAC3B,OAAO,CAAU;IACjB,KAAK,CAAkB;IAChC,YAAY,KAAsB;QAChC,KAAK,CAAC,eAAe,KAAK,CAAC,OAAO,mBAAmB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}