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

package/dist/chains.d.ts

@@ -21,6 +21,11 @@ export declare function chainById(chainId: number): Chain | undefined;
  * to an explorer where the contract does not exist.
  */
 export declare function explorerUrl(chainId: number): string;
+/** Env-name suffix for a user-facing key: uppercased, any run of non-alphanumerics collapsed to
+ *  one `_` (`base-sepolia` → `BASE_SEPOLIA`, `my.provider` → `MY_PROVIDER`). Shared by every
+ *  `ABX_<FAMILY>_<NAME>_*` convention (`ABX_RPC_URLS_<CHAIN>`, `ABX_REMOTE_<NAME>_URL/_TOKEN`) so
+ *  the conventions can't drift. Lossy — the normalized form is the canonical name. */
+export declare function envSuffix(name: string): string;
 /** The env var holding RPC endpoints for a chain: per-chain `ABX_RPC_URLS_<CHAIN>` (e.g.
  *  `ABX_RPC_URLS_SEPOLIA`) when set, else the bare `ABX_RPC_URLS` (the active `ABX_CHAIN`). */
 export declare function rpcEnvVar(chainKey: string): string;

package/dist/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,MAAM,CAAC;AAGhC;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAGxC,CAAC;AAEF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAShD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAA0B,GAAG,KAAK,CAInE;AAED;wFACwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;+FAC+F;AAC/F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,EAAE,CAY7E;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAE1E;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,MAAM,CAAC;AAGhC;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAGxC,CAAC;AAEF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAShD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAA0B,GAAG,KAAK,CAInE;AAED;wFACwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;sFAGsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;+FAC+F;AAC/F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,EAAE,CAY7E;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAE1E;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD"}

package/dist/chains.js

@@ -40,12 +40,17 @@ export function chainById(chainId) {
 export function explorerUrl(chainId) {
     return chainById(chainId)?.blockExplorers?.default?.url ?? 'https://sepolia.etherscan.io';
 }
+/** Env-name suffix for a user-facing key: uppercased, any run of non-alphanumerics collapsed to
+ *  one `_` (`base-sepolia` → `BASE_SEPOLIA`, `my.provider` → `MY_PROVIDER`). Shared by every
+ *  `ABX_<FAMILY>_<NAME>_*` convention (`ABX_RPC_URLS_<CHAIN>`, `ABX_REMOTE_<NAME>_URL/_TOKEN`) so
+ *  the conventions can't drift. Lossy — the normalized form is the canonical name. */
+export function envSuffix(name) {
+    return name.toUpperCase().replace(/[^A-Z0-9]+/g, '_');
+}
 /** The env var holding RPC endpoints for a chain: per-chain `ABX_RPC_URLS_<CHAIN>` (e.g.
  *  `ABX_RPC_URLS_SEPOLIA`) when set, else the bare `ABX_RPC_URLS` (the active `ABX_CHAIN`). */
 export function rpcEnvVar(chainKey) {
-    // Env var names can't contain hyphens, so a key like `base-sepolia` becomes
-    // `ABX_RPC_URLS_BASE_SEPOLIA` (any non-alphanumeric collapses to `_`).
-    return `ABX_RPC_URLS_${chainKey.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}`;
+    return `ABX_RPC_URLS_${envSuffix(chainKey)}`;
 }
 /**
  * The ordered, de-duplicated RPC endpoints for `chainKey`. **Network-scoped**: a

package/dist/chains.js.map

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

package/dist/env.d.ts

@@ -1,2 +1,13 @@
 export declare function loadDotEnv(startDir?: string): void;
+/**
+ * Parse `.env` text into ordered entries plus any keys the file sets MORE THAN ONCE (pure — the
+ * testable half of {@link loadDotEnv}). First occurrence wins, matching the loader; duplicates are
+ * returned rather than swallowed, because a stale duplicate (two `ABX_RPC_URLS_SEPOLIA` lines, one
+ * pointing at a different network) leaves every downstream check passing while the tool talks to
+ * somewhere unintended — and the symptom surfaces far away as "no contract at that address".
+ */
+export declare function parseEnvContent(content: string): {
+    entries: Array<[string, string]>;
+    duplicates: string[];
+};
 //# sourceMappingURL=env.d.ts.map

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"}
+{"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"}

package/dist/env.js

@@ -24,7 +24,17 @@ export function loadDotEnv(startDir = process.cwd()) {
         dir = parent;
     }
 }
-function parseInto(content) {
+/**
+ * Parse `.env` text into ordered entries plus any keys the file sets MORE THAN ONCE (pure — the
+ * testable half of {@link loadDotEnv}). First occurrence wins, matching the loader; duplicates are
+ * returned rather than swallowed, because a stale duplicate (two `ABX_RPC_URLS_SEPOLIA` lines, one
+ * pointing at a different network) leaves every downstream check passing while the tool talks to
+ * somewhere unintended — and the symptom surfaces far away as "no contract at that address".
+ */
+export function parseEnvContent(content) {
+    const entries = [];
+    const seen = new Map();
+    const duplicates = [];
     for (const rawLine of content.split('\n')) {
         const line = rawLine.trim();
         if (!line || line.startsWith('#'))
@@ -38,8 +48,30 @@ function parseInto(content) {
             (value.startsWith("'") && value.endsWith("'"))) {
             value = value.slice(1, -1);
         }
-        if (key && process.env[key] === undefined)
+        if (!key)
+            continue;
+        if (seen.has(key)) {
+            // Only a duplicate with a DIFFERENT value is worth reporting. A repeated identical line is
+            // harmless, and warning on it turns a real signal into per-invocation noise (every `abx`
+            // command is its own process, so there is nowhere to throttle a genuine warning to "once").
+            if (seen.get(key) !== value && !duplicates.includes(key))
+                duplicates.push(key);
+            continue;
+        }
+        seen.set(key, value);
+        entries.push([key, value]);
+    }
+    return { entries, duplicates };
+}
+function parseInto(content) {
+    const { entries, duplicates } = parseEnvContent(content);
+    for (const [key, value] of entries) {
+        if (process.env[key] === undefined)
             process.env[key] = value;
     }
+    if (duplicates.length) {
+        console.error(`⚠ .env sets ${duplicates.length === 1 ? 'this key' : 'these keys'} to CONFLICTING values: ${duplicates.join(', ')}. ` +
+            `The FIRST value wins and the later one is ignored — delete the stale line, or you may be pointed somewhere you didn't intend.`);
+    }
 }
 //# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -26,6 +26,7 @@ export * from './create2.js';
 export * from './deployments.js';
 export * from './deps.js';
 export * from './generator.js';
-export { loadDotEnv } from './env.js';
+export * from './service.js';
+export { loadDotEnv, parseEnvContent } from './env.js';
 export { oneOfOneImageAbi, oneOfOneImageFactoryAbi, seriesImageAbi, seriesImageFactoryAbi, seriesCodeAbi, seriesCodeFactoryAbi, abxSeedSourceAbi, abxMetadataRendererAbi, abxChunkStoreAbi, abxFixedPriceMinterAbi, spineEventAbi, } from './abi/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAC,MAAM,MAAM,CAAC;AAE5E,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAC,MAAM,MAAM,CAAC;AAE5E,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,UAAU,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -15,6 +15,7 @@ export * from './create2.js';
 export * from './deployments.js';
 export * from './deps.js';
 export * from './generator.js';
-export { loadDotEnv } from './env.js';
+export * from './service.js';
+export { loadDotEnv, parseEnvContent } from './env.js';
 export { oneOfOneImageAbi, oneOfOneImageFactoryAbi, seriesImageAbi, seriesImageFactoryAbi, seriesCodeAbi, seriesCodeFactoryAbi, abxSeedSourceAbi, abxMetadataRendererAbi, abxChunkStoreAbi, abxFixedPriceMinterAbi, spineEventAbi, } from './abi/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,UAAU,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,328 @@
+/**
+ * The remote-service client — the SDK's one HTTP surface, speaking the provider-neutral
+ * control plane pinned by specs/self-host-toolkit/remote-services.md. A client is bound to an
+ * endpoint + an injected bearer token, never to a brand: the reference CLI, the effects runner,
+ * and any hosted agent drive a self-hosted node and a managed provider through this same class.
+ *
+ * The token authorizes index/metadata control only — never on-chain signing. No env reads here;
+ * credential resolution is the caller's concern (the CLI's named-remote convention lives in
+ * packages/cli/src/remote.ts).
+ */
+import type { Hex } from 'viem';
+import type { OpenSeaAttribute } from './traits.js';
+export declare const WELL_KNOWN_SERVICE_PATH = "/.well-known/abx-service";
+/** Versioned interface ids a service declares in its descriptor. Versions ride these ids
+ *  (they track the `/v1` path prefix); the descriptor has no separate format version. */
+export declare const TOKEN_API_INTERFACE = "abx-token-api/v1";
+export declare const CONTROL_PLANE_INTERFACE = "abx-control-plane/v1";
+export declare const EFFECTS_PUBLISH_INTERFACE = "abx-effects-publish/v1";
+/**
+ * The indexing lifecycle a registration moves through, closed and provider-neutral
+ * (specs/self-host-toolkit/remote-services.md → The indexing lifecycle). One vocabulary for a
+ * managed provider and for your own node — the reference resolver stamps these too.
+ *
+ *   queued       registered + accepted; catch-up hasn't started
+ *   backfilling  actively catching up (initial sync or a forced replay); may already serve partial state
+ *   live         caught up to head; tracking head incrementally
+ *   stale        was live, now lagging (watcher behind, or transient RPC trouble) — still serving
+ *   failed       catch-up errored; carries `error`; will be retried
+ *
+ * Observability, never a source of truth: token resolution never consults it, and a project
+ * reconstructs from chain regardless.
+ */
+export type IndexStatus = 'queued' | 'backfilling' | 'live' | 'stale' | 'failed';
+/** Statuses a caller can stop waiting on — see {@link AbxServiceClient.awaitIndexed}. */
+export declare const TERMINAL_INDEX_STATUSES: readonly IndexStatus[];
+/**
+ * Why catch-up failed, as a closed machine class — never free-form prose the client must parse.
+ * Deliberately NOT extended with a reorg class: the protocol defines no reorg detection (the repair
+ * is the deterministic full replay), so no implementation could emit one honestly.
+ */
+export type IndexErrorClass = 
+/** The RPC didn't answer (down, timing out, network). Retryable — nothing is wrong with the add. */
+'rpc_unavailable'
+/** The RPC answered "too many requests". Retryable, slower — the usual cause of a long backfill. */
+ | 'rpc_rate_limited'
+/** The address doesn't look like an ABX contract on this chain. NOT emitted by the reference
+ *  (it indexes what its operator tells it); a provider that validates clone-ness SHOULD refuse
+ *  synchronously at register instead of accepting and failing here. */
+ | 'not_abx_contract'
+/** Anything else. Carries no detail — the service logs the cause. */
+ | 'internal';
+/** A catch-up failure as it crosses the wire: a machine class plus a short, CREDENTIAL-FREE hint.
+ *  Messages come from a closed set (see {@link classifyIndexError}) rather than from a scrubber, so
+ *  "no RPC URL can leak through here" is checkable by reading the code. */
+export interface IndexError {
+    class: IndexErrorClass;
+    message?: string;
+}
+/** Map a catch-up failure to its wire form. Sniffs the underlying error's shape only to CHOOSE a
+ *  class — nothing from it reaches the returned message. */
+export declare function classifyIndexError(err: unknown): IndexError;
+/** Machine error codes every conforming service uses — clients key off these, never off prose. */
+export type ServiceErrorCode = 'invalid_request' | 'unsupported_chain' | 'unauthorized' | 'forbidden' | 'not_registered' | 'disabled'
+/** 500 — an unexpected server-side failure. Never carries internal detail (it could embed the
+ *  operator's own credentials); the node logs the cause. Retryable. */
+ | 'internal_error';
+/** `GET /.well-known/abx-service` — what a service supports, agent-readably. */
+export interface ServiceDescriptor {
+    /** Display name + implementation version, for humans and directories — never dispatch. */
+    service?: {
+        name?: string;
+        version?: string;
+    };
+    /** The load-bearing declaration: which interface families this endpoint serves. */
+    interfaces: string[];
+    /** EIP-155 chain ids served; the control plane rejects others with `unsupported_chain`. */
+    chains: number[];
+    /** Present iff the control plane is enabled. `signupUrl`/`docsUrl` are for humans —
+     *  where a customer gets a key. */
+    auth?: {
+        scheme: 'bearer';
+        signupUrl?: string;
+        docsUrl?: string;
+    };
+    /** Present when rendering runs behind this service (the resolver fronts its runner).
+     *  `effects: null` = attached but unverified (the health probe didn't answer). */
+    render?: {
+        attached: boolean;
+        effects: Array<{
+            key: string;
+            outputs: Array<{
+                key: string;
+                mimeType: string;
+            }>;
+        }> | null;
+    };
+    /** The public base this node believes it serves — a sanity echo for misconfig detection. */
+    baseUrl?: string;
+}
+/** `POST /v1/projects` — the off-chain bridge: everything the host can't derive from chain. */
+export interface RegisterProjectBody {
+    chainId: number;
+    address: string;
+    /** Scan floor — the deploy block. Omit on a re-POST (the nudge) to keep the stored floor + reindex incrementally. */
+    fromBlock?: string;
+    factory?: string;
+    label?: string;
+    description?: string;
+    externalUrl?: string;
+    /** Off-chain operator traits (OpenSea attribute array) — stitched UNDER any on-chain `attributes`. */
+    attributes?: OpenSeaAttribute[];
+    /** Off-chain PER-TOKEN operator traits, `{ "<tokenId>": OpenSeaAttribute[] }` — a Series' editable
+     *  traits (a token's entry wins over the collection-scope `attributes`; on-chain wins over both). */
+    tokenAttributes?: Record<string, OpenSeaAttribute[]>;
+    /** Durable locators keyed by on-chain hash, `{ "0x<keccak>": "ipfs://<cid>" }` — lets the resolver
+     *  point `image` at IPFS/Arweave without holding the bytes. Merged over any already stored. */
+    contentLocators?: Record<string, string>;
+    /** Force a full replay even on a re-POST. */
+    full?: boolean;
+}
+/** `200` — catch-up finished inside the request; the counts are facts. */
+export interface RegisterProjectSummary {
+    ok: boolean;
+    /** Discriminator. Normalized from the HTTP status by {@link AbxServiceClient.registerProject}. */
+    accepted: false;
+    mode: 'full' | 'incremental';
+    elapsedMs: number;
+    project: {
+        address: string;
+        name: string | null;
+        eventCount: number;
+        tokenCount: number;
+        mintedCount: number;
+        status?: IndexStatus;
+    };
+}
+/** `202` — the registration is durable and catch-up is deferred; there are no counts yet. Poll
+ *  {@link AbxServiceClient.projectStatus} (or {@link AbxServiceClient.awaitIndexed}) for progress. */
+export interface RegisterProjectAccepted {
+    ok: boolean;
+    accepted: true;
+    project: {
+        address: string;
+        name?: string | null;
+        status: IndexStatus;
+    };
+}
+/**
+ * `POST /v1/projects` answers in one of two shapes and **the HTTP status code is the discriminator**
+ * (200 = done, 202 = accepted). Both are conformant; a client MUST handle both, which is why this is
+ * a union rather than a shape with everything optional. Narrow with {@link isAccepted}.
+ */
+export type RegisterProjectResult = RegisterProjectSummary | RegisterProjectAccepted;
+/** Narrow a register response to the deferred-catch-up branch. */
+export declare function isAccepted(r: RegisterProjectResult): r is RegisterProjectAccepted;
+/** One row of `GET /v1/projects` — the projects visible to this token. */
+export interface RemoteProjectSummary {
+    chainId: number;
+    address: string;
+    label?: string | null;
+    name?: string | null;
+    eventCount?: number;
+    tokenCount?: number;
+    mintedCount?: number;
+    reconstructedAt?: string | null;
+    /** Where this project is in the indexing lifecycle — so a list renders "3 live, 1 backfilling,
+     *  1 failed" with no per-project round trip. */
+    status?: IndexStatus;
+    /** Present on `stale`/`failed` — the class only; the full hint lives on the status route. */
+    error?: {
+        class: IndexErrorClass;
+    };
+}
+/** `GET /v1/projects/{chainId}/{address}/status` — indexing freshness + lifecycle. */
+export interface RemoteProjectStatus {
+    chainId: number;
+    address: string;
+    /** Where this project is in the lifecycle. */
+    status: IndexStatus;
+    fromBlock: string;
+    toBlock: string | null;
+    /** Chain head as the service last saw it — so a client computes lag / % complete without knowing
+     *  anything about the service's watcher. `null` when the service can't say. */
+    headBlock?: string | null;
+    eventCount: number;
+    tokenCount: number;
+    mintedCount: number;
+    reconstructedAt: string | null;
+    /** Present on `stale`/`failed`. Credential-free by contract. */
+    error?: IndexError;
+    /** Catch-up attempts since the last success. */
+    attempts?: number;
+    watcher?: {
+        watching: boolean;
+        pollAt: string | null;
+        head: string | null;
+        intervalMs?: number;
+    };
+}
+/**
+ * How far along a BACKFILL is, from a status read — `null` when there is no meaningful ratio.
+ *
+ * Deliberately `null` for anything but `backfilling`, because `toBlock` measures two different things
+ * depending on the state. During an initial sync it advances monotonically, so `toBlock` vs head IS
+ * progress. Once a project is `live` it only moves when that project has *events* — so a perfectly
+ * current project on a busy chain sits at a tiny fraction of head, and rendering that as "3%" reads
+ * as broken when nothing is wrong. Same reason the reference measures staleness against its watcher's
+ * watermark rather than a project's `toBlock`.
+ */
+export declare function indexProgress(s: RemoteProjectStatus): {
+    done: bigint;
+    total: bigint;
+    percent: number;
+} | null;
+/** `POST /v1/effect-artifacts` — a render producer publishes one output (locator or bytes). */
+export interface PublishEffectArtifactBody {
+    chainId: number;
+    address: string;
+    tokenId: string;
+    /** The hash of the inputs this render depicts — the service never re-addresses to current state. */
+    inputsHash: Hex;
+    output?: string;
+    effectKey?: string;
+    contentType?: string;
+    /** A durable `ipfs://` / `ar://` / `https://` pointer — the service stores it and redirects. */
+    locator?: string;
+    /** The raw output, stored in the service's own byte custody (what traits use). */
+    bytes_base64?: string;
+}
+/** `POST /v1/effect-status` — a producer reports one run's transient state. */
+export interface ReportEffectStatusBody {
+    chainId: number;
+    key: Hex;
+    address: string;
+    tokenId: string;
+    effectKey: string;
+    status: 'rendering' | 'failed' | 'done';
+    error?: string;
+    attempts?: number;
+}
+/** A non-2xx control-plane response (or an unreachable service, after retries). `code` is the
+ *  spec's machine code when the service sent one — key behavior off it, never off `message`. */
+export declare class AbxServiceError extends Error {
+    readonly status: number;
+    readonly code?: ServiceErrorCode;
+    readonly url: string;
+    /** The failure CLASS when the service volunteered one (a credential-free hint about *why* — an
+     *  exhausted RPC reads very differently from a broken service). Optional on the wire. */
+    readonly class?: IndexErrorClass;
+    constructor(message: string, opts: {
+        status: number;
+        code?: ServiceErrorCode;
+        url: string;
+        class?: IndexErrorClass;
+    });
+}
+/** Waiting for a project to reach a terminal status ran out of time. The registration is durable —
+ *  this is "still working", never "the add failed". */
+export declare class AbxIndexTimeoutError extends Error {
+    readonly last?: RemoteProjectStatus;
+    constructor(message: string, last?: RemoteProjectStatus);
+}
+export interface AwaitIndexedOptions {
+    /** Give up after this long (default 5 min). The registration stays durable regardless. */
+    timeoutMs?: number;
+    /** Poll cadence (default 3s). */
+    intervalMs?: number;
+    /** Called on every poll — drive a progress line from it. */
+    onProgress?: (status: RemoteProjectStatus) => void;
+}
+export interface ServiceClientOptions {
+    baseUrl: string;
+    /** Bearer token for the control plane. Omit for descriptor-only use. */
+    token?: string;
+    /** Per-attempt timeout. A hung provider must not hang the caller. */
+    timeoutMs?: number;
+    /** Backoff unit between retries (`delay = retryDelayMs × attempt`). Tests shrink it. */
+    retryDelayMs?: number;
+}
+export declare class AbxServiceClient {
+    readonly baseUrl: string;
+    private readonly token?;
+    private readonly timeoutMs;
+    private readonly retryDelayMs;
+    constructor(opts: ServiceClientOptions);
+    /** The public service descriptor — no auth, safe to fetch before trusting a provider. */
+    descriptor(): Promise<ServiceDescriptor>;
+    /**
+     * Register + index a project (the HTTP form of `abx add`; a re-POST is the nudge). Returns the
+     * completed summary (HTTP 200) or the accepted-and-still-working shape (HTTP 202) — narrow with
+     * {@link isAccepted}, and follow a 202 with {@link awaitIndexed}.
+     *
+     * A timed-out register is NOT retried blind. A conforming service persists the registration before
+     * it starts catching up, so a timeout usually means "it's in there, still working" — and re-POSTing
+     * would kick off a *second* full reconstruct against the RPC that was already too slow to answer.
+     * So we ask the status route whether it landed, and if it did we return the async shape instead.
+     */
+    registerProject(body: RegisterProjectBody): Promise<RegisterProjectResult>;
+    /**
+     * Poll a project's status until it reaches a terminal lifecycle state (`live` or `failed`) — the
+     * one implementation of the wait loop, so the CLI, the effects runner, and any hosted agent all
+     * behave identically against any provider. `stale` keeps polling: it means lagging, not caught up.
+     */
+    awaitIndexed(chainId: number, address: string, opts?: AwaitIndexedOptions): Promise<RemoteProjectStatus>;
+    /** The projects this token may see. */
+    listProjects(): Promise<RemoteProjectSummary[]>;
+    /** Deregister (remote `abx forget`). `not_registered` means "already gone" — reported, not
+     *  thrown — but `disabled` still throws: a node that can't accept removals hasn't removed it. */
+    removeProject(chainId: number, address: string): Promise<{
+        removed: boolean;
+    }>;
+    /** Nudge a re-index. Answers in the same two shapes as {@link registerProject} — a full replay is
+     *  the *most* likely call to outlive one HTTP request. */
+    reindexProject(chainId: number, address: string): Promise<RegisterProjectResult>;
+    /** Indexing freshness for one project. */
+    projectStatus(chainId: number, address: string): Promise<RemoteProjectStatus>;
+    /** Publish a render output so a resolver that doesn't share the producer's disk can serve it. */
+    publishEffectArtifact(body: PublishEffectArtifactBody): Promise<{
+        ok: boolean;
+        mode: 'locator' | 'bytes';
+        key: Hex;
+    }>;
+    /** Report a run's transient state for the artifact key it is producing. */
+    reportEffectStatus(body: ReportEffectStatusBody): Promise<void>;
+    private request;
+    private requestWithStatus;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -0,0 +1,319 @@
+/**
+ * The remote-service client — the SDK's one HTTP surface, speaking the provider-neutral
+ * control plane pinned by specs/self-host-toolkit/remote-services.md. A client is bound to an
+ * endpoint + an injected bearer token, never to a brand: the reference CLI, the effects runner,
+ * and any hosted agent drive a self-hosted node and a managed provider through this same class.
+ *
+ * The token authorizes index/metadata control only — never on-chain signing. No env reads here;
+ * credential resolution is the caller's concern (the CLI's named-remote convention lives in
+ * packages/cli/src/remote.ts).
+ */
+export const WELL_KNOWN_SERVICE_PATH = '/.well-known/abx-service';
+/** Versioned interface ids a service declares in its descriptor. Versions ride these ids
+ *  (they track the `/v1` path prefix); the descriptor has no separate format version. */
+export const TOKEN_API_INTERFACE = 'abx-token-api/v1';
+export const CONTROL_PLANE_INTERFACE = 'abx-control-plane/v1';
+export const EFFECTS_PUBLISH_INTERFACE = 'abx-effects-publish/v1';
+/** Statuses a caller can stop waiting on — see {@link AbxServiceClient.awaitIndexed}. */
+export const TERMINAL_INDEX_STATUSES = ['live', 'failed'];
+/** The one message per class. Fixed strings — an upstream error is never interpolated, because a
+ *  keyed RPC URL *is* a credential and upstream messages routinely embed one. */
+const INDEX_ERROR_MESSAGES = {
+    rpc_unavailable: 'upstream RPC unavailable; will retry',
+    rpc_rate_limited: 'upstream RPC rate-limited; will retry',
+    not_abx_contract: 'address emits no ABX event spine on this chain',
+    internal: 'indexing failed; see the service operator’s logs',
+};
+/** Map a catch-up failure to its wire form. Sniffs the underlying error's shape only to CHOOSE a
+ *  class — nothing from it reaches the returned message. */
+export function classifyIndexError(err) {
+    const raw = err instanceof Error ? `${err.name} ${err.message}` : String(err);
+    const text = raw.toLowerCase();
+    let cls = 'internal';
+    if (/rate.?limit|too many requests|\b429\b|quota|exceeded .*(?:compute|cu)|throttl/.test(text)) {
+        cls = 'rpc_rate_limited';
+    }
+    else if (/timeout|timed out|econnrefused|econnreset|enotfound|eai_again|socket hang up|fetch failed|network|502|503|504|http request failed/.test(text)) {
+        cls = 'rpc_unavailable';
+    }
+    return { class: cls, message: INDEX_ERROR_MESSAGES[cls] };
+}
+/** Narrow a register response to the deferred-catch-up branch. */
+export function isAccepted(r) {
+    return r.accepted === true;
+}
+/**
+ * How far along a BACKFILL is, from a status read — `null` when there is no meaningful ratio.
+ *
+ * Deliberately `null` for anything but `backfilling`, because `toBlock` measures two different things
+ * depending on the state. During an initial sync it advances monotonically, so `toBlock` vs head IS
+ * progress. Once a project is `live` it only moves when that project has *events* — so a perfectly
+ * current project on a busy chain sits at a tiny fraction of head, and rendering that as "3%" reads
+ * as broken when nothing is wrong. Same reason the reference measures staleness against its watcher's
+ * watermark rather than a project's `toBlock`.
+ */
+export function indexProgress(s) {
+    if (s.status !== 'backfilling')
+        return null;
+    if (!s.headBlock || !s.toBlock)
+        return null;
+    try {
+        const from = BigInt(s.fromBlock);
+        const to = BigInt(s.toBlock);
+        const head = BigInt(s.headBlock);
+        if (head <= from || to < from)
+            return null;
+        const total = head - from;
+        const done = (to > head ? head : to) - from;
+        return { done, total, percent: Number((done * 100n) / total) };
+    }
+    catch {
+        return null;
+    }
+}
+/** A non-2xx control-plane response (or an unreachable service, after retries). `code` is the
+ *  spec's machine code when the service sent one — key behavior off it, never off `message`. */
+export class AbxServiceError extends Error {
+    status;
+    code;
+    url;
+    /** The failure CLASS when the service volunteered one (a credential-free hint about *why* — an
+     *  exhausted RPC reads very differently from a broken service). Optional on the wire. */
+    class;
+    constructor(message, opts) {
+        super(message);
+        this.name = 'AbxServiceError';
+        this.status = opts.status;
+        this.code = opts.code;
+        this.url = opts.url;
+        this.class = opts.class;
+    }
+}
+/** Waiting for a project to reach a terminal status ran out of time. The registration is durable —
+ *  this is "still working", never "the add failed". */
+export class AbxIndexTimeoutError extends Error {
+    last;
+    constructor(message, last) {
+        super(message);
+        this.name = 'AbxIndexTimeoutError';
+        this.last = last;
+    }
+}
+/**
+ * Retry discipline (shared with the effects runner's read lane): a hosted node can cold-start or
+ * briefly 502, so network errors / 5xx / 429 get 4 attempts with linear backoff — but a genuine
+ * 4xx is an answer, not weather, and throws immediately with the parsed `{error, code}` body.
+ */
+const ATTEMPTS = 4;
+/** The descriptor is a cheap PUBLIC read used to decide whether a URL is even a service — usually
+ *  interactively, often against a typo. Grinding the full ladder there just makes a wrong URL take
+ *  five seconds to say so, so it gets one retry for a blip and no more. */
+const DESCRIPTOR_ATTEMPTS = 2;
+export class AbxServiceClient {
+    baseUrl;
+    token;
+    timeoutMs;
+    retryDelayMs;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.token = opts.token;
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+        this.retryDelayMs = opts.retryDelayMs ?? 750;
+    }
+    /** The public service descriptor — no auth, safe to fetch before trusting a provider. */
+    async descriptor() {
+        return (await this.request('GET', WELL_KNOWN_SERVICE_PATH, undefined, { attempts: DESCRIPTOR_ATTEMPTS }));
+    }
+    /**
+     * Register + index a project (the HTTP form of `abx add`; a re-POST is the nudge). Returns the
+     * completed summary (HTTP 200) or the accepted-and-still-working shape (HTTP 202) — narrow with
+     * {@link isAccepted}, and follow a 202 with {@link awaitIndexed}.
+     *
+     * A timed-out register is NOT retried blind. A conforming service persists the registration before
+     * it starts catching up, so a timeout usually means "it's in there, still working" — and re-POSTing
+     * would kick off a *second* full reconstruct against the RPC that was already too slow to answer.
+     * So we ask the status route whether it landed, and if it did we return the async shape instead.
+     */
+    async registerProject(body) {
+        const landed = async () => {
+            const st = await this.projectStatus(body.chainId, body.address).catch(() => null);
+            if (!st)
+                return undefined; // not there (or the service is truly unreachable) — keep retrying
+            return { ok: true, accepted: true, project: { address: body.address, status: st.status } };
+        };
+        const { status, body: out } = await this.requestWithStatus('POST', '/v1/projects', body, { onTimeout: landed });
+        return normalizeRegisterResult(status, out, body.address);
+    }
+    /**
+     * Poll a project's status until it reaches a terminal lifecycle state (`live` or `failed`) — the
+     * one implementation of the wait loop, so the CLI, the effects runner, and any hosted agent all
+     * behave identically against any provider. `stale` keeps polling: it means lagging, not caught up.
+     */
+    async awaitIndexed(chainId, address, opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 300_000;
+        const intervalMs = opts.intervalMs ?? 3_000;
+        const deadline = Date.now() + timeoutMs;
+        let last;
+        for (;;) {
+            last = await this.projectStatus(chainId, address);
+            opts.onProgress?.(last);
+            if (TERMINAL_INDEX_STATUSES.includes(last.status))
+                return last;
+            if (Date.now() + intervalMs > deadline) {
+                throw new AbxIndexTimeoutError(`${address} was still '${last.status}' after ${Math.round(timeoutMs / 1000)}s — the registration is durable and the service keeps working; check back with \`abx status ${address} --remote\``, last);
+            }
+            await sleep(intervalMs);
+        }
+    }
+    /** The projects this token may see. */
+    async listProjects() {
+        const out = (await this.request('GET', '/v1/projects'));
+        return out.projects ?? [];
+    }
+    /** Deregister (remote `abx forget`). `not_registered` means "already gone" — reported, not
+     *  thrown — but `disabled` still throws: a node that can't accept removals hasn't removed it. */
+    async removeProject(chainId, address) {
+        try {
+            await this.request('DELETE', `/v1/projects/${chainId}/${address}`);
+            return { removed: true };
+        }
+        catch (err) {
+            if (err instanceof AbxServiceError && err.code === 'not_registered')
+                return { removed: false };
+            throw err;
+        }
+    }
+    /** Nudge a re-index. Answers in the same two shapes as {@link registerProject} — a full replay is
+     *  the *most* likely call to outlive one HTTP request. */
+    async reindexProject(chainId, address) {
+        const { status, body } = await this.requestWithStatus('POST', `/v1/projects/${chainId}/${address}/reindex`, undefined, {
+            onTimeout: async () => {
+                const st = await this.projectStatus(chainId, address).catch(() => null);
+                return st ? { ok: true, accepted: true, project: { address, status: st.status } } : undefined;
+            },
+        });
+        return normalizeRegisterResult(status, body, address);
+    }
+    /** Indexing freshness for one project. */
+    async projectStatus(chainId, address) {
+        return (await this.request('GET', `/v1/projects/${chainId}/${address}/status`));
+    }
+    /** Publish a render output so a resolver that doesn't share the producer's disk can serve it. */
+    async publishEffectArtifact(body) {
+        return (await this.request('POST', '/v1/effect-artifacts', body));
+    }
+    /** Report a run's transient state for the artifact key it is producing. */
+    async reportEffectStatus(body) {
+        await this.request('POST', '/v1/effect-status', body);
+    }
+    async request(method, path, body, opts) {
+        return (await this.requestWithStatus(method, path, body, opts)).body;
+    }
+    async requestWithStatus(method, path, body, opts) {
+        const attempts = opts?.attempts ?? ATTEMPTS;
+        const url = this.baseUrl + path;
+        const headers = {};
+        if (this.token)
+            headers['authorization'] = `Bearer ${this.token}`;
+        if (body !== undefined)
+            headers['content-type'] = 'application/json';
+        let lastFailure = '';
+        let lastStatus = 0;
+        let lastCode;
+        let lastClass;
+        for (let attempt = 1; attempt <= attempts; attempt++) {
+            let resp;
+            try {
+                resp = await fetch(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+            }
+            catch (err) {
+                lastFailure = err.message;
+                lastStatus = 0;
+                // "We waited the full timeout" and "nothing is listening" are different failures, and for a
+                // mutating POST the difference decides whether retrying is safe: the request may still be
+                // running on the service. Let the caller check before we hammer it again.
+                if (opts?.onTimeout && err.name === 'TimeoutError') {
+                    const resolved = await opts.onTimeout();
+                    if (resolved !== undefined)
+                        return { status: 202, body: resolved };
+                }
+                if (attempt < attempts)
+                    await sleep(this.retryDelayMs * attempt);
+                continue;
+            }
+            if (resp.ok) {
+                const text = await resp.text();
+                return { status: resp.status, body: text ? JSON.parse(text) : {} };
+            }
+            if (resp.status >= 500 || resp.status === 429) {
+                // Retryable — but KEEP the service's own words. A 5xx body carries the actual cause (an
+                // exhausted RPC, a misconfigured node); discarding it left the caller with a bare status and
+                // nothing to act on, which is the worst kind of error.
+                const said = await bodyMessage(resp);
+                lastStatus = resp.status;
+                lastCode = said.code;
+                lastClass = said.class;
+                lastFailure = said.error ? `${resp.status} ${said.error}` : `${resp.status} ${resp.statusText}`;
+                if (attempt < attempts)
+                    await sleep(this.retryDelayMs * attempt);
+                continue;
+            }
+            // A genuine 4xx is an answer, not weather — surface the service's own words + code.
+            const detail = await bodyMessage(resp);
+            throw new AbxServiceError(`${method} ${url}: ${resp.status} ${detail.error ?? resp.statusText}`, {
+                status: resp.status,
+                code: detail.code,
+                class: detail.class,
+                url,
+            });
+        }
+        // Retries exhausted. Distinguish "nothing answered" from "it answered, badly" — a 500 is not
+        // unreachable, and saying so sends the caller looking for a network problem that isn't there.
+        const summary = lastStatus
+            ? `service failed after ${attempts} attempt(s) — last response ${lastFailure}`
+            : `nothing responded after ${attempts} attempt(s) (${lastFailure})`;
+        throw new AbxServiceError(`${method} ${url}: ${summary}`, { status: lastStatus, code: lastCode, class: lastClass, url });
+    }
+}
+/** Normalize a register/reindex response: the HTTP status is the authoritative discriminator, and
+ *  the `accepted` flag is derived from it so callers switch on one field even against a service that
+ *  doesn't send it. */
+function normalizeRegisterResult(status, out, fallbackAddress) {
+    if (status === 202) {
+        const r = out;
+        return {
+            ok: r.ok ?? true,
+            accepted: true,
+            project: {
+                address: r.project?.address ?? fallbackAddress,
+                name: r.project?.name ?? null,
+                status: r.project?.status ?? 'backfilling',
+            },
+        };
+    }
+    return { ...out, accepted: false };
+}
+/** The service's own `{error, code, class?}` from a non-2xx body (never throws — a body may be
+ *  empty/HTML). `class` is the optional credential-free failure hint. */
+async function bodyMessage(resp) {
+    try {
+        const parsed = (await resp.json());
+        return {
+            error: parsed.error,
+            code: parsed.code,
+            class: parsed.class,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artblocks/abx-sdk",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "license": "MIT",
   "description": "ABX SDK (Layer 2) — the neutral, low-level library that turns protocol operations into typed function calls. No provider, no chain, no UX baked in.",
   "type": "module",