@inversealtruism/cairn-sdk 0.2.0 → 0.2.2

package/README.md

@@ -10,6 +10,7 @@ The **Compute Substrate dApp kit:** one cohesive toolkit for building apps on CS
 | `cairn.index` | The L2 **explorer/indexer**: REST + merkle proofs + live SSE/WS feeds. |
 | `cairn.content` | **Self-certifying content:** publish via the board, fetch with client-side verification. |
 | `cairn.registry` | L3 **peer / gateway / identity** resolution. |
+| `cairn.names` | **.csd names + CairnX reads:** name resolution, reverse/primary lookup, tokens, offers, bids, canonical state. |
 
 ```bash
 npm i @inversealtruism/cairn-sdk
@@ -65,6 +66,8 @@ try {
 
 **`cairn.index`:** `tipHeight()`, `block()/blockTxids()`, `tx()/txStatus()/txMerkleProof()`, `address()/addressTxs()/addressUtxo()`, `proposal()/attestations()`, `reputation()`, `registryPeers()/registryGateways()/identity()`, **`verifyInclusion(txid)`** (trust-minimized), `streamAll()/streamBlocks()/streamDomain()` (SSE), `subscribe()` (WS).
 
+**`cairn.names`:** `resolve(name)` (display-path name to address), `name(name)`/`nameHistory(name)`, `primary(addr)` (reverse lookup)/`namesOf(addr)`, `names()`, `tokens()/token(ticker)`, `offers()`, `bids()`, `state()` (the canonical CairnX state). Reads go through the public `/trade/api/cairnx/*` proxy; for payment-grade name resolution verify through the wallet or a replaying resolver, not a bare read (see `src/names.ts` header).
+
 **`cairn.content`:** `prepare(obj)`/`put(obj)` → `{ payloadHash, canonical, bytes }`; `get(hash)` / `getBytes(hash)` (fetch **and verify** `sha256(bytes) === hash`, throws `ContentVerificationError` on tamper); `hash(obj)`.
 
 **`cairn.chain`:** `tip()`, `utxos(addr)`, `submit(nodeJsonTx)`, `.client` (full `CsdClient`), `.light()` (verifying light client). The package also re-exports the primitives under the `/chain` subpath: `buildSend/buildPropose/buildAttest`, `signTx`, `keygen`, `payloadHash`, `verifyMerkleProof`, `LightClient`, etc.
@@ -84,7 +87,7 @@ Subpath imports are available for tree-shaking: `@inversealtruism/cairn-sdk/{con
 - **Merkle inclusion is trust-minimized, to the strength of your header source.** `verifyInclusion()` folds the proof and, when a header-merkle source is wired, cross-checks the root against it → `trustLevel: "verified-inclusion"`; otherwise `"proof-consistent"` (indexer trusted). That cross-check only means something against an *independent* header, so the default `Cairn` wiring enables it ONLY when your node RPC is a different origin than the indexer (the default same-origin proxy stays at `"proof-consistent"`, a single compromised server can't be cross-checked against itself). For full trust-minimization against a lying node too, supply a PoW-verifying `headerMerkleAt` (e.g. backed by `cairn.chain.light()`).
 - **Balances are RPC-trusted.** Headers don't commit to the UTXO set; balance reads trust the node/proxy (same as every light client).
 - **Indexer/swarm run behind the cairn proxy.** By default `cairn.index` and content resolution use the cairn server's hardened, read-only, rate-limited `/explorer/api` reverse proxy (no separate public indexer needed). **SSE works through it; `subscribe()` (WebSocket) needs a direct indexer endpoint:** set `baseUrls.indexer` to a private/localhost indexer for WS.
-- **Today the wallet injects only on `cairn-substrate.com` + localhost.** Connecting from an arbitrary third-party origin requires the wallet's "connect anywhere" release (broadened injection), which ships after the per-origin consent layer is proven.
+- **The wallet injects on every site** (connect-anywhere shipped in 0.2.4x) behind a per-origin consent gate: a site sees nothing until the user approves the connection, and some request kinds stay first-party-only (the `FIRST_PARTY_ONLY` error code).
 
 ## Configuration
 

package/dist/board.cjs

@@ -27,7 +27,7 @@ var import_csd_codec = require("@inversealtruism/csd-codec");
 var import_csd_codec2 = require("@inversealtruism/csd-codec");
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/board.js

@@ -1,7 +1,7 @@
 import {
   BoardClient
-} from "./chunk-RYZJDZLJ.js";
-import "./chunk-JGXD3WIC.js";
+} from "./chunk-HI5STMH3.js";
+import "./chunk-ZJURNM5P.js";
 export {
   BoardClient
 };

package/dist/{chunk-SIUUY6FZ.js → chunk-3EXZQPPT.js}

@@ -1,6 +1,6 @@
 import {
   ContentVerificationError
-} from "./chunk-JGXD3WIC.js";
+} from "./chunk-ZJURNM5P.js";
 
 // src/content.ts
 import { payloadHash, canonicalJson, verifyContentBytes } from "@inversealtruism/csd-codec";

package/dist/{chunk-RYZJDZLJ.js → chunk-HI5STMH3.js}

@@ -1,6 +1,6 @@
 import {
   CairnError
-} from "./chunk-JGXD3WIC.js";
+} from "./chunk-ZJURNM5P.js";
 
 // src/board.ts
 import { payloadHash } from "@inversealtruism/csd-codec";

package/dist/{chunk-PYREGAB3.js → chunk-LCE4IWMW.js}

@@ -1,6 +1,6 @@
 import {
   getWallet
-} from "./chunk-UIEOBVFI.js";
+} from "./chunk-QRVMYGSL.js";
 
 // src/controller.ts
 var DISCONNECTED = Object.freeze({ status: "disconnected", account: null, error: null });

package/dist/{chunk-UIEOBVFI.js → chunk-QRVMYGSL.js}

@@ -2,7 +2,7 @@ import {
   NotInstalledError,
   UnsupportedMethodError,
   mapProviderError
-} from "./chunk-JGXD3WIC.js";
+} from "./chunk-ZJURNM5P.js";
 
 // src/connect.ts
 function discoverProviders(opts = {}) {

package/dist/{chunk-JGXD3WIC.js → chunk-ZJURNM5P.js}

@@ -1,5 +1,5 @@
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/connect.cjs

@@ -30,7 +30,7 @@ __export(connect_exports, {
 module.exports = __toCommonJS(connect_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/connect.js

@@ -5,8 +5,8 @@ import {
   discoverProviders,
   getWallet,
   isInstalled
-} from "./chunk-UIEOBVFI.js";
-import "./chunk-JGXD3WIC.js";
+} from "./chunk-QRVMYGSL.js";
+import "./chunk-ZJURNM5P.js";
 export {
   WalletConnection,
   connect,

package/dist/content.cjs

@@ -26,7 +26,7 @@ module.exports = __toCommonJS(content_exports);
 var import_csd_codec = require("@inversealtruism/csd-codec");
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/content.js

@@ -1,7 +1,7 @@
 import {
   ContentClient
-} from "./chunk-SIUUY6FZ.js";
-import "./chunk-JGXD3WIC.js";
+} from "./chunk-3EXZQPPT.js";
+import "./chunk-ZJURNM5P.js";
 export {
   ContentClient
 };

package/dist/controller.cjs

@@ -25,7 +25,7 @@ __export(controller_exports, {
 module.exports = __toCommonJS(controller_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/controller.js

@@ -1,8 +1,8 @@
 import {
   CairnController
-} from "./chunk-PYREGAB3.js";
-import "./chunk-UIEOBVFI.js";
-import "./chunk-JGXD3WIC.js";
+} from "./chunk-LCE4IWMW.js";
+import "./chunk-QRVMYGSL.js";
+import "./chunk-ZJURNM5P.js";
 export {
   CairnController
 };

package/dist/index.cjs

@@ -50,7 +50,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/index.d.cts

@@ -106,7 +106,7 @@ declare class NamesClient {
 
 /** Stable machine-readable error codes (branch on these, not the message text). */
 type CairnErrorCode = "NOT_INSTALLED" | "USER_REJECTED" | "WALLET_LOCKED" | "UNSUPPORTED_METHOD" | "HTTP_ERROR" | "CONTENT_VERIFICATION" | "ACCOUNT_CHANGED" | "FIRST_PARTY_ONLY" | "RATE_LIMITED" | "APPROVAL_CLOSED" | "FORBIDDEN" | "INTERNAL" | "UNKNOWN";
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.2.2";
 interface CairnErrorOptions {
     code?: CairnErrorCode;
     docsPath?: string;
@@ -120,7 +120,7 @@ declare class CairnError extends Error {
     /** Relative docs path (under the SDK docs base), if any. */
     readonly docsPath?: string;
     /** The cairn-sdk version that produced this error. */
-    readonly version = "0.2.0";
+    readonly version = "0.2.2";
     constructor(shortMessage: string, opts?: CairnErrorOptions);
     /**
      * Walk the `cause` chain. With a predicate, returns the FIRST matching error (or null). Without one,

package/dist/index.d.ts

@@ -106,7 +106,7 @@ declare class NamesClient {
 
 /** Stable machine-readable error codes (branch on these, not the message text). */
 type CairnErrorCode = "NOT_INSTALLED" | "USER_REJECTED" | "WALLET_LOCKED" | "UNSUPPORTED_METHOD" | "HTTP_ERROR" | "CONTENT_VERIFICATION" | "ACCOUNT_CHANGED" | "FIRST_PARTY_ONLY" | "RATE_LIMITED" | "APPROVAL_CLOSED" | "FORBIDDEN" | "INTERNAL" | "UNKNOWN";
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.2.2";
 interface CairnErrorOptions {
     code?: CairnErrorCode;
     docsPath?: string;
@@ -120,7 +120,7 @@ declare class CairnError extends Error {
     /** Relative docs path (under the SDK docs base), if any. */
     readonly docsPath?: string;
     /** The cairn-sdk version that produced this error. */
-    readonly version = "0.2.0";
+    readonly version = "0.2.2";
     constructor(shortMessage: string, opts?: CairnErrorOptions);
     /**
      * Walk the `cause` chain. With a predicate, returns the FIRST matching error (or null). Without one,

package/dist/index.js

@@ -3,20 +3,20 @@ import {
 } from "./chunk-BGJZF7S2.js";
 import {
   BoardClient
-} from "./chunk-RYZJDZLJ.js";
+} from "./chunk-HI5STMH3.js";
 import {
   Chain,
   LightClient
 } from "./chunk-C452UODV.js";
 import {
   ContentClient
-} from "./chunk-SIUUY6FZ.js";
+} from "./chunk-3EXZQPPT.js";
 import {
   IndexerClient
 } from "./chunk-J5J4JEJ6.js";
 import {
   CairnController
-} from "./chunk-PYREGAB3.js";
+} from "./chunk-LCE4IWMW.js";
 import {
   WalletConnection,
   connect,
@@ -24,7 +24,7 @@ import {
   discoverProviders,
   getWallet,
   isInstalled
-} from "./chunk-UIEOBVFI.js";
+} from "./chunk-QRVMYGSL.js";
 import {
   CairnError,
   ContentVerificationError,
@@ -36,7 +36,7 @@ import {
   WalletLockedError,
   errorCode,
   mapProviderError
-} from "./chunk-JGXD3WIC.js";
+} from "./chunk-ZJURNM5P.js";
 
 // src/http.ts
 var DEFAULT_MAX_BYTES = 16 * 1024 * 1024;

package/dist/react.cjs

@@ -26,7 +26,7 @@ __export(react_exports, {
 module.exports = __toCommonJS(react_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.2.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */

package/dist/react.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inversealtruism/cairn-sdk",
-  "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.",
+  "version": "0.2.2",
+  "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.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -58,27 +58,14 @@
     "LICENSE",
     "README.md"
   ],
-  "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 && 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})\"",
-    "test:e2e:read": "node test/e2e/e2e-read.mjs",
-    "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",
-    "prepublishOnly": "npm run build && npm test"
-  },
   "dependencies": {
-    "@inversealtruism/cairnx-core": "0.1.31",
+    "@inversealtruism/cairnx-core": "0.1.36",
     "@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"
+    "@inversealtruism/csd-light": "0.1.17",
+    "@inversealtruism/csd-registry": "0.1.16",
+    "@inversealtruism/csd-tx": "0.1.16"
   },
   "devDependencies": {
     "esbuild": "^0.27.0",
@@ -89,12 +76,6 @@
     "@inversealtruism/csd-siwc": "0.1.15"
   },
   "sideEffects": false,
-  "packageManager": "pnpm@10.32.1",
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
-  },
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -112,5 +93,17 @@
     "dapp",
     "sdk",
     "blockchain"
-  ]
-}
+  ],
+  "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 && 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})\"",
+    "test:e2e:read": "node test/e2e/e2e-read.mjs",
+    "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"
+  }
+}