@inversealtruism/cairn-sdk 0.1.4 → 0.2.0

package/dist/index.js

@@ -3,20 +3,20 @@ import {
 } from "./chunk-BGJZF7S2.js";
 import {
   BoardClient
-} from "./chunk-FSQZVNEM.js";
+} from "./chunk-RYZJDZLJ.js";
 import {
   Chain,
   LightClient
 } from "./chunk-C452UODV.js";
 import {
   ContentClient
-} from "./chunk-MVX7VQT4.js";
+} from "./chunk-SIUUY6FZ.js";
 import {
   IndexerClient
-} from "./chunk-OG4KA3LS.js";
+} from "./chunk-J5J4JEJ6.js";
 import {
   CairnController
-} from "./chunk-MBSPHWZG.js";
+} from "./chunk-PYREGAB3.js";
 import {
   WalletConnection,
   connect,
@@ -24,7 +24,7 @@ import {
   discoverProviders,
   getWallet,
   isInstalled
-} from "./chunk-K7SJOW3O.js";
+} from "./chunk-UIEOBVFI.js";
 import {
   CairnError,
   ContentVerificationError,
@@ -36,7 +36,7 @@ import {
   WalletLockedError,
   errorCode,
   mapProviderError
-} from "./chunk-RELP23CH.js";
+} from "./chunk-JGXD3WIC.js";
 
 // src/http.ts
 var DEFAULT_MAX_BYTES = 16 * 1024 * 1024;
@@ -82,6 +82,7 @@ var Http = class {
   timeoutMs;
   maxBytes;
   headers;
+  retries;
   constructor(opts) {
     this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
     const f = opts.fetch ?? globalThis.fetch;
@@ -90,6 +91,7 @@ var Http = class {
     this.timeoutMs = opts.timeoutMs ?? 15e3;
     this.maxBytes = opts.maxBytes ?? DEFAULT_MAX_BYTES;
     this.headers = opts.headers ?? {};
+    this.retries = Math.min(10, Math.max(0, Math.floor(opts.retries ?? 0)));
   }
   /** Build an absolute URL from a path + optional query params. */
   url(path, query) {
@@ -126,15 +128,38 @@ var Http = class {
       clearTimeout(timer);
     }
   }
+  // A malformed 2xx body must surface as a TYPED HttpError, not a leaked SyntaxError (B10: dApp
+  // code branches on `instanceof CairnError`; a raw parse error escaped that contract).
+  parseJson(res, text, url) {
+    try {
+      return JSON.parse(text);
+    } catch (e) {
+      throw new HttpError(res.status, url, `invalid JSON body: ${text.slice(0, 120)}`);
+    }
+  }
   async getJson(path, query) {
-    const res = await this.raw("GET", path, { query });
-    if (!res.ok) throw new HttpError(res.status, this.url(path, query), await safeText(res));
-    return JSON.parse(new TextDecoder().decode(await readCapped(res, this.maxBytes)));
+    const url = this.url(path, query);
+    for (let attempt = 0; ; attempt++) {
+      try {
+        const res = await this.raw("GET", path, { query });
+        if (!res.ok) {
+          const err = new HttpError(res.status, url, await safeText(res));
+          if (!(res.status >= 500 && attempt < this.retries)) throw err;
+        } else {
+          return this.parseJson(res, new TextDecoder().decode(await readCapped(res, this.maxBytes)), url);
+        }
+      } catch (e) {
+        if (e instanceof HttpError && e.status < 500) throw e;
+        if (attempt >= this.retries) throw e;
+      }
+      await new Promise((r) => setTimeout(r, Math.floor(Math.random() * Math.min(4e3, 250 * 2 ** attempt))));
+    }
   }
   async postJson(path, body, headers) {
+    const url = this.url(path);
     const res = await this.raw("POST", path, { body, headers });
-    if (!res.ok) throw new HttpError(res.status, this.url(path), await safeText(res));
-    return JSON.parse(new TextDecoder().decode(await readCapped(res, this.maxBytes)));
+    if (!res.ok) throw new HttpError(res.status, url, await safeText(res));
+    return this.parseJson(res, new TextDecoder().decode(await readCapped(res, this.maxBytes)), url);
   }
   /** GET raw bytes (for content retrieval). Returns null on 404. */
   async getBytes(path) {
@@ -152,8 +177,98 @@ async function safeText(res) {
   }
 }
 
+// src/names.ts
+import { NAME_RE, RESERVED_NAMES } from "@inversealtruism/cairnx-core";
+var nameOk = (n) => typeof n === "string" && NAME_RE.test(n) && !RESERVED_NAMES.has(n);
+var NamesClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Resolve a .csd name for DISPLAY (server-trusted; see the module trust note). null = unknown/invalid name. */
+  async resolve(name) {
+    if (!nameOk(name)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/resolve/${name}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** Full detail for one name (lease, lock, resting offer, recapture). null = not registered/invalid. */
+  async name(name) {
+    if (!nameOk(name)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/name/${name}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** The event history of one name (registrations, transfers, sets, renewals). null = invalid name. */
+  async nameHistory(name) {
+    if (!nameOk(name)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/name-history/${name}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** Reverse lookup: an address's chosen primary .csd name (null name = none set). */
+  async primary(addr) {
+    if (typeof addr !== "string" || !/^0x[0-9a-fA-F]{40}$/.test(addr)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/primary/${addr.toLowerCase()}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** All names an address owns (plus its primary), as served by `/cairnx/address/:addr`. */
+  async namesOf(addr) {
+    if (typeof addr !== "string" || !/^0x[0-9a-fA-F]{40}$/.test(addr)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/address/${addr.toLowerCase()}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** All registered names (display list; short-edge-cached server-side). */
+  names() {
+    return this.http.getJson(`/trade/api/cairnx/names`);
+  }
+  /** All deployed tokens. */
+  tokens() {
+    return this.http.getJson(`/trade/api/cairnx/tokens`);
+  }
+  /** One token by ticker. null = unknown/invalid ticker. */
+  async token(ticker) {
+    if (typeof ticker !== "string" || !/^[A-Z][A-Z0-9]{2,11}$/.test(ticker)) return null;
+    try {
+      return await this.http.getJson(`/trade/api/cairnx/token/${ticker}`);
+    } catch (e) {
+      if (e?.status === 404) return null;
+      throw e;
+    }
+  }
+  /** Open offers (the market's display list). */
+  offers() {
+    return this.http.getJson(`/trade/api/cairnx/offers`);
+  }
+  /** Open bids. */
+  bids() {
+    return this.http.getJson(`/trade/api/cairnx/bids`);
+  }
+  /** The full canonical CairnX state (large; prefer the scoped reads above). */
+  state() {
+    return this.http.getJson(`/trade/api/cairnx/state`);
+  }
+};
+
 // src/index.ts
-var DEFAULT_SPV_CHECKPOINT = { height: 31310, hash: "0x000000000000138bd3eee4b8d2fbacb8d5433ac3040ddbf1c45a5e3e0cc9e814" };
+var DEFAULT_SPV_CHECKPOINT = { height: 38142, hash: "0x00000000000140f023cc0ee1457a40833f2fcb4de44291b9d373e50f17b97232" };
 var DEFAULT_CAIRN = "https://cairn-substrate.com";
 var Cairn = class {
   config;
@@ -161,6 +276,8 @@ var Cairn = class {
   index;
   content;
   registry;
+  /** .csd names + CairnX market READS (server-trusted display reads; see names.ts trust note). */
+  names;
   board;
   wallet;
   cairnHttp;
@@ -189,6 +306,7 @@ var Cairn = class {
     });
     this.content = new ContentClient({ swarm: swarmHttp, indexer: indexerHttp, cairn: this.cairnHttp });
     this.registry = new RegistryClient({ baseUrl: indexer, fetch });
+    this.names = new NamesClient(this.cairnHttp);
   }
   /**
    * PoW-VERIFIED header merkle at a height (audit M3 — the no-PoW half). Lazily seeds a light
@@ -244,6 +362,7 @@ export {
   Http,
   HttpError,
   IndexerClient,
+  NamesClient,
   NotInstalledError,
   RegistryClient,
   SDK_VERSION,

package/dist/indexer.cjs

@@ -245,7 +245,7 @@ var IndexerClient = class {
           handlers.onError?.(err);
         }
         if (closed) return;
-        await new Promise((r) => setTimeout(r, 2e3));
+        await new Promise((r) => setTimeout(r, 1e3 + Math.floor(Math.random() * 2e3)));
       }
     };
     void run();

package/dist/indexer.d.cts

@@ -1,4 +1,4 @@
-import { H as Http, F as FetchLike } from './http-CQsNL8w9.cjs';
+import { H as Http, F as FetchLike } from './http-C9C4L4hz.cjs';
 
 interface MerkleProof {
     block_height: number;

package/dist/indexer.d.ts

@@ -1,4 +1,4 @@
-import { H as Http, F as FetchLike } from './http-CQsNL8w9.js';
+import { H as Http, F as FetchLike } from './http-C9C4L4hz.js';
 
 interface MerkleProof {
     block_height: number;

package/dist/indexer.js

@@ -1,6 +1,6 @@
 import {
   IndexerClient
-} from "./chunk-OG4KA3LS.js";
+} from "./chunk-J5J4JEJ6.js";
 export {
   IndexerClient
 };

package/dist/react.cjs

@@ -26,7 +26,7 @@ __export(react_exports, {
 module.exports = __toCommonJS(react_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.1.4";
+var SDK_VERSION = "0.2.0";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */
@@ -83,7 +83,12 @@ var UnsupportedMethodError = class extends CairnError {
     super(message, { code: "UNSUPPORTED_METHOD", docsPath: "/errors#unsupported-method" });
   }
 };
-function mapProviderError(error) {
+var NATIVE_CODES = /* @__PURE__ */ new Set(["ACCOUNT_CHANGED", "FIRST_PARTY_ONLY", "RATE_LIMITED", "APPROVAL_CLOSED", "FORBIDDEN", "INTERNAL"]);
+function mapProviderError(error, code) {
+  if (code === "USER_REJECTED" || code === "APPROVAL_CLOSED") return new UserRejectedError(error);
+  if (code === "WALLET_LOCKED") return new WalletLockedError(error);
+  if (code === "UNSUPPORTED_METHOD" || code === "UNKNOWN_KIND") return new UnsupportedMethodError(error);
+  if (code && NATIVE_CODES.has(code)) return new CairnError(error || code, { code });
   const e = String(error || "").toLowerCase();
   if (e.includes("rejected by user")) return new UserRejectedError(error);
   if (e.includes("wallet locked")) return new WalletLockedError(error);
@@ -136,7 +141,7 @@ function detectProvider(opts = {}) {
 }
 function unwrap(reply) {
   if (reply && reply.ok) return reply.result;
-  throw mapProviderError(reply?.error ?? "Unknown wallet error");
+  throw mapProviderError(reply?.error ?? "Unknown wallet error", reply?.code);
 }
 var WalletConnection = class {
   provider;
@@ -170,6 +175,9 @@ var WalletConnection = class {
    * Passwordless sign-in: a signature over a login nonce (always prompts; structurally cannot sign a tx).
    */
   signIn() {
+    if (typeof this.provider.signIn !== "function") {
+      return Promise.reject(new UnsupportedMethodError("this wallet does not expose signIn()"));
+    }
     return Promise.resolve(this.provider.signIn()).then(unwrap);
   }
   /**
@@ -203,6 +211,9 @@ var WalletConnection = class {
   }
   /** Atomic fill (CairnX DvP): pay + attest in ONE tx. Always prompts with clear-signing. */
   fillOffer(params) {
+    if (typeof this.provider.fillOffer !== "function") {
+      return Promise.reject(new UnsupportedMethodError("this wallet predates fillOffer() \u2014 ask the user to update the Cairn Wallet"));
+    }
     return Promise.resolve(this.provider.fillOffer(params)).then(unwrap);
   }
   /** This origin's current permission grant (EIP-2255-style). Silent; [] if none / unsupported. */

package/dist/react.js

@@ -1,8 +1,8 @@
 import {
   CairnController
-} from "./chunk-MBSPHWZG.js";
-import "./chunk-K7SJOW3O.js";
-import "./chunk-RELP23CH.js";
+} from "./chunk-PYREGAB3.js";
+import "./chunk-UIEOBVFI.js";
+import "./chunk-JGXD3WIC.js";
 
 // src/react.ts
 function createCairnHooks(React, controllerOrOpts) {

package/dist/registry.d.cts

@@ -1,6 +1,6 @@
 import * as _inversealtruism_csd_registry from '@inversealtruism/csd-registry';
 export { BuiltRecord, ChainRecord, DOMAINS, RankedGateway, RankedPeer, ResolveOpts, ResolvedIdentity, buildGatewayRecord, buildIdentityCommit, buildIdentityReveal, buildPeerRecord, epochOf, fromRecords, verifyGateway, verifyIdentitySig, verifyPeer } from '@inversealtruism/csd-registry';
-import { F as FetchLike } from './http-CQsNL8w9.cjs';
+import { F as FetchLike } from './http-C9C4L4hz.cjs';
 
 interface RegistryClientOptions {
     /** Indexer base URL exposing /registry/* + /identity/* (e.g. https://cairn-substrate.com/indexer). */

package/dist/registry.d.ts

@@ -1,6 +1,6 @@
 import * as _inversealtruism_csd_registry from '@inversealtruism/csd-registry';
 export { BuiltRecord, ChainRecord, DOMAINS, RankedGateway, RankedPeer, ResolveOpts, ResolvedIdentity, buildGatewayRecord, buildIdentityCommit, buildIdentityReveal, buildPeerRecord, epochOf, fromRecords, verifyGateway, verifyIdentitySig, verifyPeer } from '@inversealtruism/csd-registry';
-import { F as FetchLike } from './http-CQsNL8w9.js';
+import { F as FetchLike } from './http-C9C4L4hz.js';
 
 interface RegistryClientOptions {
     /** Indexer base URL exposing /registry/* + /identity/* (e.g. https://cairn-substrate.com/indexer). */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inversealtruism/cairn-sdk",
-  "version": "0.1.4",
-  "description": "The Compute Substrate dApp kit — one cohesive toolkit to connect the Cairn Wallet, read the chain/board, publish self-certifying content, and resolve registries. Composes the published csd-* primitives.",
+  "version": "0.2.0",
+  "description": "The Compute Substrate dApp kit \u2014 one cohesive toolkit to connect the Cairn Wallet, read the chain/board, publish self-certifying content, and resolve registries. Composes the published csd-* primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -60,7 +60,7 @@
   ],
   "scripts": {
     "build": "tsup src/index.ts src/connect.ts src/board.ts src/indexer.ts src/content.ts src/registry.ts src/chain.ts src/controller.ts src/react.ts --format esm,cjs --dts --clean",
-    "test": "tsx test/sdk.test.ts && tsx test/connect.test.ts && tsx test/errors.test.ts && tsx test/controller.test.ts && tsx test/react.test.ts && tsx test/hardening.test.ts && tsx test/spv-checkpoint.test.ts",
+    "test": "tsx test/sdk.test.ts && tsx test/connect.test.ts && tsx test/errors.test.ts && tsx test/controller.test.ts && tsx test/react.test.ts && tsx test/hardening.test.ts && tsx test/spv-checkpoint.test.ts && tsx test/names-b10.test.ts",
     "test:live": "node examples/read-only.mjs",
     "build:example": "node scripts/build-example.mjs",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
@@ -68,15 +68,17 @@
     "test:e2e:wallet": "xvfb-run -a node test/e2e/e2e-wallet-connect.mjs",
     "test:e2e:write": "node test/e2e/e2e-write.mjs",
     "test:e2e": "node test/e2e/e2e-read.mjs && xvfb-run -a node test/e2e/e2e-wallet-connect.mjs",
-    "test:all": "pnpm test && pnpm test:e2e"
+    "test:all": "pnpm test && pnpm test:e2e",
+    "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@inversealtruism/csd-client": "0.1.14",
-    "@inversealtruism/csd-codec": "0.1.14",
-    "@inversealtruism/csd-crypto": "0.1.14",
-    "@inversealtruism/csd-light": "0.1.14",
-    "@inversealtruism/csd-registry": "0.1.14",
-    "@inversealtruism/csd-tx": "0.1.14"
+    "@inversealtruism/cairnx-core": "0.1.31",
+    "@inversealtruism/csd-client": "0.1.15",
+    "@inversealtruism/csd-codec": "0.1.15",
+    "@inversealtruism/csd-crypto": "0.1.15",
+    "@inversealtruism/csd-light": "0.1.15",
+    "@inversealtruism/csd-registry": "0.1.15",
+    "@inversealtruism/csd-tx": "0.1.15"
   },
   "devDependencies": {
     "esbuild": "^0.27.0",
@@ -84,7 +86,7 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.2",
     "typescript": "^5.6.0",
-    "@inversealtruism/csd-siwc": "0.1.14"
+    "@inversealtruism/csd-siwc": "0.1.15"
   },
   "sideEffects": false,
   "packageManager": "pnpm@10.32.1",