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

package/dist/util.js

@@ -0,0 +1,106 @@
+/** `process.env[name]`, or `undefined` — safe to call even where `process` doesn't exist
+ *  (a browser bundle). The SDK core never assumes Node; a host (the CLI, the effects
+ *  runner) is where `process.env` is actually meaningful. */
+export function readEnv(name) {
+    if (typeof process === 'undefined' || !process.env)
+        return undefined;
+    return process.env[name];
+}
+/** Wait `ms` milliseconds. The one place the SDK debounces/retries, so every caller shares
+ *  the same primitive instead of re-declaring `new Promise((r) => setTimeout(r, ms))`. */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** The delay before retry `attempt` (1-indexed) under a LINEAR backoff: `attempt * baseMs`.
+ *  Matches the shape `service.ts`'s request ladder already used (`retryDelayMs * attempt`) —
+ *  pulled out here so every linear-backoff retry loop (the service client, the effects
+ *  runner's resolver poll) computes the same delay the same way. */
+export function linearBackoffDelay(attempt, baseMs) {
+    return attempt * baseMs;
+}
+/**
+ * The delay before retry `attempt` (1-indexed) under an EXPONENTIAL backoff, capped:
+ * `min(baseMs * 2^(attempt-1), capMs)`. Attempt 1 waits `baseMs`, attempt 2 waits `2*baseMs`,
+ * attempt 3 `4*baseMs`, and so on until the cap takes over.
+ *
+ * Prefer this over {@link linearBackoffDelay} for a SUSTAINED rate limit or an overloaded
+ * upstream, where a caller wants each retry to back off faster than the last so a burst of
+ * callers doesn't keep landing on the same wall-clock second (linear backoff's delays grow by a
+ * constant step, which under sustained pressure just re-synchronizes the retry storm at a lower
+ * frequency instead of spreading it out). Prefer `linearBackoffDelay` for a transient/one-off
+ * failure (a dropped connection, a single flaky read) where the retry ladder just needs to not
+ * hammer immediately — exponential growth there overshoots into multi-minute waits for what was
+ * likely a one-time blip.
+ */
+export function exponentialBackoffDelay(attempt, baseMs, capMs) {
+    return Math.min(baseMs * 2 ** (attempt - 1), capMs);
+}
+const DATA_URI_RE = /^data:([^;,]*)((?:;[^,]*)?),([\s\S]*)$/;
+/** Parse a `data:` URI, or `null` if `uri` isn't one. */
+export function parseDataUri(uri) {
+    const m = DATA_URI_RE.exec(uri);
+    if (!m)
+        return null;
+    const params = m[2] ?? '';
+    return {
+        mime: m[1] || 'text/plain',
+        base64: /(^|;)base64(;|$)/.test(params),
+        body: m[3],
+    };
+}
+/**
+ * Read a contract, swallowing any failure ("no data" from a codeless address, a revert on
+ * an extension the target doesn't compose) into `undefined` rather than a throw — the shape
+ * every "does this getter exist / is there even a contract here" caller wants. Replaces the
+ * three near-identical try/catch wrappers this SDK's callers each hand-rolled (a resume
+ * planner's field-by-field read, a state dump's per-getter read, an owner-op's diagnostic
+ * read) with one implementation.
+ *
+ * A caller that wants to DISTINGUISH "no contract at all" from "contract exists but this
+ * call reverted" (the CLI's `assertContractExists` diagnostic) still does that itself — this
+ * helper only knows "did the read come back", not why it didn't.
+ */
+export async function tryReadContract(client, args) {
+    try {
+        return (await client.readContract(args));
+    }
+    catch {
+        return undefined;
+    }
+}
+const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/** Bytes → base64 (RFC 4648). No `Buffer`, no `btoa` — both are runtime-conditional (Node
+ *  lacks the latter, and a stricter embedder than a browser can lack the former too), and the
+ *  SDK core needs exactly one behavior everywhere it runs. */
+export function bytesToBase64(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const b0 = bytes[i];
+        const b1 = bytes[i + 1];
+        const b2 = bytes[i + 2];
+        out += BASE64_CHARS[b0 >> 2];
+        out += BASE64_CHARS[((b0 & 0x03) << 4) | (b1 === undefined ? 0 : b1 >> 4)];
+        out += b1 === undefined ? '=' : BASE64_CHARS[((b1 & 0x0f) << 2) | (b2 === undefined ? 0 : b2 >> 6)];
+        out += b2 === undefined ? '=' : BASE64_CHARS[b2 & 0x3f];
+    }
+    return out;
+}
+/** base64 → bytes — the inverse of {@link bytesToBase64}. */
+export function base64ToBytes(b64) {
+    const clean = b64.replace(/=+$/, '');
+    const out = new Uint8Array(Math.floor((clean.length * 3) / 4));
+    let p = 0;
+    for (let i = 0; i < clean.length; i += 4) {
+        const c0 = BASE64_CHARS.indexOf(clean[i]);
+        const c1 = BASE64_CHARS.indexOf(clean[i + 1]);
+        const c2 = clean[i + 2] === undefined ? -1 : BASE64_CHARS.indexOf(clean[i + 2]);
+        const c3 = clean[i + 3] === undefined ? -1 : BASE64_CHARS.indexOf(clean[i + 3]);
+        out[p++] = (c0 << 2) | (c1 >> 4);
+        if (c2 >= 0)
+            out[p++] = ((c1 & 0x0f) << 4) | (c2 >> 2);
+        if (c3 >= 0)
+            out[p++] = ((c2 & 0x03) << 6) | c3;
+    }
+    return out;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artblocks/abx-sdk",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.21",
   "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",
@@ -13,10 +13,16 @@
     "./abi": {
       "types": "./dist/abi/index.d.ts",
       "import": "./dist/abi/index.js"
-    }
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "sideEffects": false,
@@ -45,6 +51,9 @@
   "dependencies": {
     "viem": "^2.21.0"
   },
+  "devDependencies": {
+    "esbuild": "^0.28.1"
+  },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",
     "sync-abis": "tsx scripts/sync-abis.ts"