@inversealtruism/cairn-sdk 0.4.6 → 0.6.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inversealtruism/cairn-sdk",
-  "version": "0.4.6",
-  "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.6.0",
+  "description": "The Compute Substrate dApp kit: one cohesive toolkit to connect the Cairn Wallet, read the chain, the indexer and .csd names, verify self-certifying content, and resolve registries. Composes the published csd-* primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -17,11 +17,6 @@
       "import": "./dist/connect.js",
       "require": "./dist/connect.cjs"
     },
-    "./board": {
-      "types": "./dist/board.d.ts",
-      "import": "./dist/board.js",
-      "require": "./dist/board.cjs"
-    },
     "./indexer": {
       "types": "./dist/indexer.d.ts",
       "import": "./dist/indexer.js",
@@ -59,16 +54,16 @@
     "README.md"
   ],
   "dependencies": {
-    "@inversealtruism/cairnx-core": "0.1.42",
-    "@inversealtruism/csd-client": "0.1.16",
-    "@inversealtruism/csd-codec": "0.1.16",
-    "@inversealtruism/csd-crypto": "0.1.16",
-    "@inversealtruism/csd-light": "0.1.21",
-    "@inversealtruism/csd-registry": "0.1.18",
-    "@inversealtruism/csd-tx": "0.1.19"
+    "@inversealtruism/cairnx-core": "0.2.0",
+    "@inversealtruism/csd-client": "0.1.18",
+    "@inversealtruism/csd-codec": "0.1.18",
+    "@inversealtruism/csd-crypto": "0.1.18",
+    "@inversealtruism/csd-light": "0.1.23",
+    "@inversealtruism/csd-registry": "0.1.20",
+    "@inversealtruism/csd-tx": "0.1.21"
   },
   "devDependencies": {
-    "@inversealtruism/csd-siwc": "0.1.17",
+    "@inversealtruism/csd-siwc": "0.1.19",
     "esbuild": "^0.27.0",
     "playwright-core": "^1.49.0",
     "tsup": "^8.5.1",
@@ -95,14 +90,13 @@
     "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",
+    "build": "tsup src/index.ts src/connect.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": "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})\"",
     "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"
   }

package/dist/board.cjs

@@ -1,231 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/board.ts
-var board_exports = {};
-__export(board_exports, {
-  BoardClient: () => BoardClient
-});
-module.exports = __toCommonJS(board_exports);
-var import_csd_codec = require("@inversealtruism/csd-codec");
-var import_csd_codec2 = require("@inversealtruism/csd-codec");
-
-// src/errors.ts
-var SDK_VERSION = "0.4.6";
-var DOCS_BASE = "https://cairn-substrate.com/docs/sdk";
-var CairnError = class extends Error {
-  /** Stable machine code for programmatic branching. */
-  code;
-  /** The human message without the appended docs/version footer. */
-  shortMessage;
-  /** Relative docs path (under the SDK docs base), if any. */
-  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(
-      [shortMessage, docs ? `Docs: ${DOCS_BASE}${docs}` : "", `Version: cairn-sdk@${SDK_VERSION}`].filter(Boolean).join("\n"),
-      { cause: opts.cause }
-    );
-    this.name = new.target.name;
-    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,
-   * returns the DEEPEST cause (the root). Mirrors viem's `BaseError.walk()`.
-   */
-  walk(fn) {
-    let current = this;
-    let last = this;
-    while (current != null) {
-      if (fn && fn(current)) return current;
-      last = current;
-      current = current?.cause;
-    }
-    return fn ? null : last;
-  }
-};
-
-// src/board.ts
-var BoardClient = class {
-  http;
-  wallet;
-  constructor(http, wallet) {
-    this.http = http;
-    this.wallet = wallet;
-  }
-  requireWallet() {
-    if (!this.wallet) {
-      throw new CairnError("This action needs a connected wallet. Construct Cairn with a wallet, or call cairn.connect() first.");
-    }
-    return this.wallet;
-  }
-  // ---- reads (public) ----------------------------------------------------
-  /** Ranked board for a domain + time window. */
-  board(opts = {}) {
-    return this.http.getJson("/api/board", { domain: opts.domain ?? "all", window: opts.window ?? "all" });
-  }
-  /** Alias for `board()` — the top items. */
-  top(opts = {}) {
-    return this.board(opts);
-  }
-  /** A single item with its supports + pledges + integrity flag. */
-  item(id) {
-    return this.http.getJson(`/api/item/${encodeURIComponent(id)}`);
-  }
-  /** Known + discovered domains. */
-  domains() {
-    return this.http.getJson("/api/domains");
-  }
-  /** All quests (work-graph items). */
-  quests() {
-    return this.http.getJson("/api/quests");
-  }
-  /** A single quest with claims/submissions/payouts. */
-  quest(id) {
-    return this.http.getJson(`/api/quest/${encodeURIComponent(id)}`);
-  }
-  /** An address's on-chain-derived profile + identity + reputation. */
-  profile(addr, opts = {}) {
-    return this.http.getJson(`/api/profile/${encodeURIComponent(addr)}`, opts.live ? { live: 1 } : void 0);
-  }
-  /** Reputation leaderboard (top 50). */
-  leaderboard() {
-    return this.http.getJson("/api/leaderboard");
-  }
-  /** Network dashboard snapshot. */
-  network() {
-    return this.http.getJson("/api/network");
-  }
-  /** Network time-series for charts. */
-  networkSeries(range = "24h") {
-    return this.http.getJson("/api/network/series", { range });
-  }
-  /** Recent blocks with miner/reward. */
-  networkBlocks(limit = 15) {
-    return this.http.getJson("/api/network/blocks", { limit });
-  }
-  /** Per-miner hashrate estimate. */
-  miner(addr) {
-    return this.http.getJson(`/api/miner/${encodeURIComponent(addr)}`);
-  }
-  /** Recent activity feed. */
-  activity() {
-    return this.http.getJson("/api/activity");
-  }
-  /** The gamified cairn wall. */
-  wall() {
-    return this.http.getJson("/api/wall");
-  }
-  /** Server health + chain reachability. */
-  health() {
-    return this.http.getJson("/api/health");
-  }
-  // ---- writes (wallet-signed) -------------------------------------------
-  /**
-   * Publish a board item: compute the canonical payload hash, have the WALLET
-   * build/sign/submit the Propose (clear-signed approval), then register the
-   * off-chain content. The payload hash is byte-identical to what the cairn
-   * server verifies (csd-codec.payloadHash over { v:1, domain, title, body, links }).
-   */
-  async propose(input) {
-    const wallet = this.requireWallet();
-    const content = {
-      v: 1,
-      domain: input.domain,
-      title: input.title,
-      body: input.body ?? "",
-      links: input.links ?? []
-    };
-    const ph = (0, import_csd_codec.payloadHash)(content);
-    const uri = `cairn:v1:${ph.slice(2, 14)}`;
-    const lifetime = input.lifetimeEpochs ?? 720;
-    const height = await this.tipHeight();
-    const expiresEpoch = Math.floor(height / import_csd_codec2.EPOCH_LEN) + lifetime;
-    const fee = input.fee ?? import_csd_codec2.MIN_FEE_PROPOSE;
-    const r = await wallet.propose({ domain: content.domain, payloadHash: ph, uri, expiresEpoch, fee });
-    const txid = String(r.txid ?? "");
-    if (!txid) throw new CairnError("Propose submitted but no txid was returned by the wallet.");
-    const reg = await this.tryRegister(content, txid);
-    return { txid, payloadHash: ph, content, registered: reg.ok, registerError: reg.error };
-  }
-  /**
-   * Register off-chain content for an already-submitted proposal txid. Idempotent.
-   * Returns { ok } — the cairn server verifies sha256(canonical) == on-chain payload_hash.
-   */
-  async registerContent(content, txid) {
-    try {
-      const res = await this.http.postJson("/api/content", {
-        domain: content.domain,
-        title: content.title,
-        body: content.body,
-        links: content.links,
-        txid
-      });
-      return { ok: !!res.ok, error: res.ok ? void 0 : res.error };
-    } catch (e) {
-      return { ok: false, error: e instanceof Error ? e.message : String(e) };
-    }
-  }
-  /** Support/attest a proposal (wallet-signed; always clear-signed). */
-  async support(proposalId, opts = {}) {
-    const wallet = this.requireWallet();
-    return wallet.attest({
-      proposalId,
-      score: opts.score ?? 80,
-      confidence: opts.confidence ?? 70,
-      fee: opts.fee ?? import_csd_codec2.MIN_FEE_ATTEST
-    });
-  }
-  // ---- internal ----------------------------------------------------------
-  async tipHeight() {
-    const tip = await this.http.getJson("/api/rpc/tip");
-    const h = Number(tip?.height);
-    if (!Number.isFinite(h)) throw new CairnError("Could not read chain tip height for expiry computation.");
-    return h;
-  }
-  async tryRegister(content, txid) {
-    const delays = [0, 1500, 3e3, 5e3];
-    let last = { ok: false, error: "not attempted" };
-    for (const d of delays) {
-      if (d) await sleep(d);
-      last = await this.registerContent(content, txid);
-      if (last.ok) return last;
-      if (!/not found yet|not found/i.test(last.error ?? "")) return last;
-    }
-    return last;
-  }
-};
-function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BoardClient
-});

package/dist/board.d.cts

@@ -1,151 +0,0 @@
-import { H as Http } from './http-C9C4L4hz.cjs';
-import { WalletConnection, TxResult } from './connect.cjs';
-
-type BoardWindow = "24h" | "7d" | "30d" | "all";
-/** A ranked board item (loose — the server returns a rich object). */
-interface RankedItem {
-    id: string;
-    title: string;
-    body: string;
-    domain: string;
-    proposer: string;
-    score: number;
-    totalWeight: number;
-    [k: string]: unknown;
-}
-interface BoardItemContent {
-    v: 1;
-    domain: string;
-    title: string;
-    body: string;
-    links: string[];
-}
-interface ProposeInput {
-    domain: string;
-    title: string;
-    body?: string;
-    links?: string[];
-    /** Fee in base units (default MIN_FEE_PROPOSE = 0.25 CSD). */
-    fee?: number;
-    /** Lifetime in epochs before expiry (default 720 ≈ 30 days, matching cairn). */
-    lifetimeEpochs?: number;
-}
-interface ProposeResult {
-    txid: string;
-    payloadHash: string;
-    content: BoardItemContent;
-    /** Whether the off-chain content was registered with the cairn origin yet. */
-    registered: boolean;
-    /** If registration is still pending, call `registerContent(content, txid)` again later. */
-    registerError?: string;
-}
-interface SupportInput {
-    /** 0–100 quality score (default 80). */
-    score?: number;
-    /** 0–100 confidence (default 70). */
-    confidence?: number;
-    /** Fee in base units (default MIN_FEE_ATTEST = 0.05 CSD). */
-    fee?: number;
-}
-declare class BoardClient {
-    private readonly http;
-    private readonly wallet?;
-    constructor(http: Http, wallet?: WalletConnection);
-    private requireWallet;
-    /** Ranked board for a domain + time window. */
-    board(opts?: {
-        domain?: string;
-        window?: BoardWindow;
-    }): Promise<{
-        window: string;
-        domain: string;
-        count: number;
-        items: RankedItem[];
-    }>;
-    /** Alias for `board()` — the top items. */
-    top(opts?: {
-        domain?: string;
-        window?: BoardWindow;
-    }): Promise<{
-        window: string;
-        domain: string;
-        count: number;
-        items: RankedItem[];
-    }>;
-    /** A single item with its supports + pledges + integrity flag. */
-    item(id: string): Promise<{
-        ok: boolean;
-        item: RankedItem;
-        supports: unknown[];
-        pledges: unknown[];
-        integrityOk: boolean;
-    }>;
-    /** Known + discovered domains. */
-    domains(): Promise<{
-        prefix: string;
-        total: number;
-        domains: unknown[];
-        discovered: unknown[];
-    }>;
-    /** All quests (work-graph items). */
-    quests(): Promise<{
-        count: number;
-        quests: unknown[];
-    }>;
-    /** A single quest with claims/submissions/payouts. */
-    quest(id: string): Promise<{
-        ok: boolean;
-        quest: unknown;
-    }>;
-    /** An address's on-chain-derived profile + identity + reputation. */
-    profile(addr: string, opts?: {
-        live?: boolean;
-    }): Promise<{
-        ok: boolean;
-        profile: unknown;
-        identity: unknown;
-        reputation: unknown;
-    }>;
-    /** Reputation leaderboard (top 50). */
-    leaderboard(): Promise<{
-        count: number;
-        leaderboard: unknown[];
-    }>;
-    /** Network dashboard snapshot. */
-    network(): Promise<unknown>;
-    /** Network time-series for charts. */
-    networkSeries(range?: "24h" | "1w" | "1m" | "all"): Promise<unknown>;
-    /** Recent blocks with miner/reward. */
-    networkBlocks(limit?: number): Promise<unknown>;
-    /** Per-miner hashrate estimate. */
-    miner(addr: string): Promise<unknown>;
-    /** Recent activity feed. */
-    activity(): Promise<{
-        activity: unknown[];
-    }>;
-    /** The gamified cairn wall. */
-    wall(): Promise<unknown>;
-    /** Server health + chain reachability. */
-    health(): Promise<unknown>;
-    /**
-     * Publish a board item: compute the canonical payload hash, have the WALLET
-     * build/sign/submit the Propose (clear-signed approval), then register the
-     * off-chain content. The payload hash is byte-identical to what the cairn
-     * server verifies (csd-codec.payloadHash over { v:1, domain, title, body, links }).
-     */
-    propose(input: ProposeInput): Promise<ProposeResult>;
-    /**
-     * Register off-chain content for an already-submitted proposal txid. Idempotent.
-     * Returns { ok } — the cairn server verifies sha256(canonical) == on-chain payload_hash.
-     */
-    registerContent(content: BoardItemContent, txid: string): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Support/attest a proposal (wallet-signed; always clear-signed). */
-    support(proposalId: string, opts?: SupportInput): Promise<TxResult>;
-    private tipHeight;
-    private tryRegister;
-}
-
-export { BoardClient, type BoardItemContent, type BoardWindow, type ProposeInput, type ProposeResult, type RankedItem, type SupportInput };

package/dist/board.d.ts

@@ -1,151 +0,0 @@
-import { H as Http } from './http-C9C4L4hz.js';
-import { WalletConnection, TxResult } from './connect.js';
-
-type BoardWindow = "24h" | "7d" | "30d" | "all";
-/** A ranked board item (loose — the server returns a rich object). */
-interface RankedItem {
-    id: string;
-    title: string;
-    body: string;
-    domain: string;
-    proposer: string;
-    score: number;
-    totalWeight: number;
-    [k: string]: unknown;
-}
-interface BoardItemContent {
-    v: 1;
-    domain: string;
-    title: string;
-    body: string;
-    links: string[];
-}
-interface ProposeInput {
-    domain: string;
-    title: string;
-    body?: string;
-    links?: string[];
-    /** Fee in base units (default MIN_FEE_PROPOSE = 0.25 CSD). */
-    fee?: number;
-    /** Lifetime in epochs before expiry (default 720 ≈ 30 days, matching cairn). */
-    lifetimeEpochs?: number;
-}
-interface ProposeResult {
-    txid: string;
-    payloadHash: string;
-    content: BoardItemContent;
-    /** Whether the off-chain content was registered with the cairn origin yet. */
-    registered: boolean;
-    /** If registration is still pending, call `registerContent(content, txid)` again later. */
-    registerError?: string;
-}
-interface SupportInput {
-    /** 0–100 quality score (default 80). */
-    score?: number;
-    /** 0–100 confidence (default 70). */
-    confidence?: number;
-    /** Fee in base units (default MIN_FEE_ATTEST = 0.05 CSD). */
-    fee?: number;
-}
-declare class BoardClient {
-    private readonly http;
-    private readonly wallet?;
-    constructor(http: Http, wallet?: WalletConnection);
-    private requireWallet;
-    /** Ranked board for a domain + time window. */
-    board(opts?: {
-        domain?: string;
-        window?: BoardWindow;
-    }): Promise<{
-        window: string;
-        domain: string;
-        count: number;
-        items: RankedItem[];
-    }>;
-    /** Alias for `board()` — the top items. */
-    top(opts?: {
-        domain?: string;
-        window?: BoardWindow;
-    }): Promise<{
-        window: string;
-        domain: string;
-        count: number;
-        items: RankedItem[];
-    }>;
-    /** A single item with its supports + pledges + integrity flag. */
-    item(id: string): Promise<{
-        ok: boolean;
-        item: RankedItem;
-        supports: unknown[];
-        pledges: unknown[];
-        integrityOk: boolean;
-    }>;
-    /** Known + discovered domains. */
-    domains(): Promise<{
-        prefix: string;
-        total: number;
-        domains: unknown[];
-        discovered: unknown[];
-    }>;
-    /** All quests (work-graph items). */
-    quests(): Promise<{
-        count: number;
-        quests: unknown[];
-    }>;
-    /** A single quest with claims/submissions/payouts. */
-    quest(id: string): Promise<{
-        ok: boolean;
-        quest: unknown;
-    }>;
-    /** An address's on-chain-derived profile + identity + reputation. */
-    profile(addr: string, opts?: {
-        live?: boolean;
-    }): Promise<{
-        ok: boolean;
-        profile: unknown;
-        identity: unknown;
-        reputation: unknown;
-    }>;
-    /** Reputation leaderboard (top 50). */
-    leaderboard(): Promise<{
-        count: number;
-        leaderboard: unknown[];
-    }>;
-    /** Network dashboard snapshot. */
-    network(): Promise<unknown>;
-    /** Network time-series for charts. */
-    networkSeries(range?: "24h" | "1w" | "1m" | "all"): Promise<unknown>;
-    /** Recent blocks with miner/reward. */
-    networkBlocks(limit?: number): Promise<unknown>;
-    /** Per-miner hashrate estimate. */
-    miner(addr: string): Promise<unknown>;
-    /** Recent activity feed. */
-    activity(): Promise<{
-        activity: unknown[];
-    }>;
-    /** The gamified cairn wall. */
-    wall(): Promise<unknown>;
-    /** Server health + chain reachability. */
-    health(): Promise<unknown>;
-    /**
-     * Publish a board item: compute the canonical payload hash, have the WALLET
-     * build/sign/submit the Propose (clear-signed approval), then register the
-     * off-chain content. The payload hash is byte-identical to what the cairn
-     * server verifies (csd-codec.payloadHash over { v:1, domain, title, body, links }).
-     */
-    propose(input: ProposeInput): Promise<ProposeResult>;
-    /**
-     * Register off-chain content for an already-submitted proposal txid. Idempotent.
-     * Returns { ok } — the cairn server verifies sha256(canonical) == on-chain payload_hash.
-     */
-    registerContent(content: BoardItemContent, txid: string): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Support/attest a proposal (wallet-signed; always clear-signed). */
-    support(proposalId: string, opts?: SupportInput): Promise<TxResult>;
-    private tipHeight;
-    private tryRegister;
-}
-
-export { BoardClient, type BoardItemContent, type BoardWindow, type ProposeInput, type ProposeResult, type RankedItem, type SupportInput };

package/dist/board.js

@@ -1,7 +0,0 @@
-import {
-  BoardClient
-} from "./chunk-E2MA75S3.js";
-import "./chunk-ZFVE6MU7.js";
-export {
-  BoardClient
-};