@inversealtruism/cairn-sdk 0.2.3 → 0.3.2

package/dist/react.cjs

@@ -26,7 +26,7 @@ __export(react_exports, {
 module.exports = __toCommonJS(react_exports);
 
 // src/errors.ts
-var SDK_VERSION = "0.2.3";
+var SDK_VERSION = "0.3.2";
 var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
 var CairnError = class extends Error {
   /** Stable machine code for programmatic branching. */
@@ -37,6 +37,12 @@ var CairnError = class extends Error {
   docsPath;
   /** The cairn-sdk version that produced this error. */
   version = SDK_VERSION;
+  /**
+   * Whether a dApp may safely AUTO-retry this failure. `false` for fund-safety refusals and user-intent
+   * declines (the default); `true` only for provably transient infra faults where nothing was signed.
+   * A `SubmitInFlightError` is `false` too: reconcile its `txid`, never blind-retry.
+   */
+  retryable;
   constructor(shortMessage, opts = {}) {
     const docs = opts.docsPath;
     super(
@@ -47,6 +53,7 @@ var CairnError = class extends Error {
     this.code = opts.code ?? "UNKNOWN";
     this.shortMessage = shortMessage;
     this.docsPath = docs;
+    this.retryable = opts.retryable ?? false;
   }
   /**
    * Walk the `cause` chain. With a predicate, returns the FIRST matching error (or null). Without one,
@@ -83,11 +90,43 @@ var UnsupportedMethodError = class extends CairnError {
     super(message, { code: "UNSUPPORTED_METHOD", docsPath: "/errors#unsupported-method" });
   }
 };
+var SubmitInFlightError = class extends CairnError {
+  /** The locally-computed consensus txid to reconcile against the chain (may be undefined if the wallet omitted it). */
+  txid;
+  /** Always true: the tx MAY be in the mempool. Reconcile via `txid`; never blind-retry. */
+  maybeSent = true;
+  constructor(message, code, txid) {
+    super(message, { code, docsPath: "/errors#submit-inflight", retryable: false });
+    this.txid = txid;
+  }
+};
 var NATIVE_CODES = /* @__PURE__ */ new Set(["ACCOUNT_CHANGED", "FIRST_PARTY_ONLY", "RATE_LIMITED", "APPROVAL_CLOSED", "FORBIDDEN", "INTERNAL"]);
+var NESTED_TRANSIENT = /* @__PURE__ */ new Set(["VERIFY_UNAVAILABLE", "OFFER_UNKNOWN"]);
+var NESTED_TERMINAL = /* @__PURE__ */ new Set([
+  "FILL_UNSAFE",
+  "FILL_WRONG_TARGET",
+  "SOURCE_DIVERGENCE",
+  "VERIFY_TAMPER",
+  "SUBMIT_REJECTED",
+  "BAD_REQUEST",
+  "BAD_FEE",
+  "BAD_OUTPUTS",
+  "NO_OUTPUTS",
+  "ZERO_ADDR_REFUSED",
+  "TOO_MANY_INPUTS",
+  "INSUFFICIENT",
+  "FEE_CAP",
+  "FEE_TOO_LOW",
+  "ACCOUNT_CHANGED",
+  "GHOST_INPUTS_SKIPPED",
+  "NOTHING_TO_CONSOLIDATE"
+]);
 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 && NESTED_TRANSIENT.has(code)) return new CairnError(error || code, { code, retryable: true });
+  if (code && NESTED_TERMINAL.has(code)) return new CairnError(error || code, { code, retryable: false });
   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);
@@ -95,6 +134,14 @@ function mapProviderError(error, code) {
   if (e.includes("unsupported dapp method") || e.includes("predates") || e.includes("too old")) return new UnsupportedMethodError(error);
   return new CairnError(error || "Unknown wallet error");
 }
+function mapSubmitResultError(result) {
+  const code = result?.code;
+  const msg = typeof result?.error === "string" && result.error || code || "The wallet refused the transaction.";
+  if (code === "SUBMIT_MAYBE_INFLIGHT" || code === "SUBMIT_DUPLICATE") {
+    return new SubmitInFlightError(msg, code, typeof result?.txid === "string" ? result.txid : void 0);
+  }
+  return mapProviderError(msg, code);
+}
 
 // src/connect.ts
 function detectProvider(opts = {}) {
@@ -143,6 +190,13 @@ function unwrap(reply) {
   if (reply && reply.ok) return reply.result;
   throw mapProviderError(reply?.error ?? "Unknown wallet error", reply?.code);
 }
+function unwrapWrite(reply) {
+  const result = unwrap(reply);
+  if (result && typeof result === "object" && result.ok === false) {
+    throw mapSubmitResultError(result);
+  }
+  return result;
+}
 var WalletConnection = class {
   provider;
   _addr = null;
@@ -209,12 +263,18 @@ var WalletConnection = class {
       return null;
     }
   }
-  /** Atomic fill (CairnX DvP): pay + attest in ONE tx. Always prompts with clear-signing. */
+  /**
+   * CairnX fill: pay + attest in ONE tx (atomic SETTLEMENT SHAPE, both revert together). Always prompts with
+   * clear-signing. The payment recipient in `params.outputs` is RESOLVER-TRUSTED here: this SDK does NOT
+   * SPV-verify it, so a lying resolver can redirect the payment. A dApp settling real value MUST corroborate
+   * the offer on-chain before building `outputs` (F13). The wallet's own fill-SPV boundary (cairn-wallet
+   * 0.2.60+, which binds payment/rebate/fee to the merkle-proven offer) is the payment-grade check; see FillParams.
+   */
   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);
+    return Promise.resolve(this.provider.fillOffer(params)).then(unwrapWrite);
   }
   /** This origin's current permission grant (EIP-2255-style). Silent; [] if none / unsupported. */
   async getPermissions() {
@@ -247,26 +307,26 @@ var WalletConnection = class {
   }
   /** Send CSD (always prompts with clear-signing; wallet picks inputs + returns change to itself). */
   send(params) {
-    return Promise.resolve(this.provider.send(params)).then(unwrap);
+    return Promise.resolve(this.provider.send(params)).then(unwrapWrite);
   }
   /** Low-level Propose (always prompts). Prefer `cairn.board.propose()` which computes the hash/uri/expiry. */
   propose(params) {
-    return Promise.resolve(this.provider.propose(params)).then(unwrap);
+    return Promise.resolve(this.provider.propose(params)).then(unwrapWrite);
   }
   /** Attest/support a proposal (always prompts). */
   attest(params) {
-    return Promise.resolve(this.provider.attest(params)).then(unwrap);
+    return Promise.resolve(this.provider.attest(params)).then(unwrapWrite);
   }
   /** Seal a commit-reveal claim (always prompts; salt stays inside the wallet). */
   sealClaim(params) {
-    return Promise.resolve(this.provider.sealClaim(params)).then(unwrap);
+    return Promise.resolve(this.provider.sealClaim(params)).then(unwrapWrite);
   }
   /** Reveal a previously sealed claim by its sealing txid (always prompts). */
   revealClaim(txid) {
     if (typeof txid !== "string" || !txid) {
       return Promise.reject(new UnsupportedMethodError("revealClaim requires the sealing txid"));
     }
-    return Promise.resolve(this.provider.revealClaim(txid)).then(unwrap);
+    return Promise.resolve(this.provider.revealClaim(txid)).then(unwrapWrite);
   }
 };
 async function getWallet(opts = {}) {

package/dist/react.js

@@ -1,8 +1,8 @@
 import {
   CairnController
-} from "./chunk-72YSLTLO.js";
-import "./chunk-TKZXUBDX.js";
-import "./chunk-M6OSWJVC.js";
+} from "./chunk-AGU6K5EZ.js";
+import "./chunk-BN3PFJDY.js";
+import "./chunk-FMXNJQWL.js";
 
 // src/react.ts
 function createCairnHooks(React, controllerOrOpts) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inversealtruism/cairn-sdk",
-  "version": "0.2.3",
-  "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.3.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",
@@ -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 && tsx test/names-b10.test.ts",
+    "test": "node test/run.mjs",
     "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})\"",
@@ -72,13 +72,13 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@inversealtruism/cairnx-core": "0.1.37",
+    "@inversealtruism/cairnx-core": "0.1.38",
     "@inversealtruism/csd-client": "0.1.15",
     "@inversealtruism/csd-codec": "0.1.15",
     "@inversealtruism/csd-crypto": "0.1.15",
     "@inversealtruism/csd-light": "0.1.18",
     "@inversealtruism/csd-registry": "0.1.16",
-    "@inversealtruism/csd-tx": "0.1.16"
+    "@inversealtruism/csd-tx": "0.1.17"
   },
   "devDependencies": {
     "esbuild": "^0.27.0",