@inversealtruism/csd-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 InverseAltruism
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,115 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CsdClient: () => CsdClient,
+  rpcHeaderToHeader: () => rpcHeaderToHeader,
+  rpcTxToTx: () => rpcTxToTx
+});
+module.exports = __toCommonJS(index_exports);
+var CsdClient = class {
+  base;
+  f;
+  timeoutMs;
+  constructor(opts) {
+    this.base = opts.baseUrl.replace(/\/+$/, "");
+    this.f = opts.fetch ?? globalThis.fetch;
+    this.timeoutMs = opts.timeoutMs ?? 1e4;
+    if (!this.f) throw new Error("no fetch available \u2014 pass opts.fetch");
+  }
+  async get(path) {
+    const r = await this.f(`${this.base}${path}`, { signal: AbortSignal.timeout(this.timeoutMs) });
+    if (!r.ok) throw new Error(`GET ${path} \u2192 HTTP ${r.status}`);
+    return r.json();
+  }
+  async post(path, body) {
+    const r = await this.f(`${this.base}${path}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (!r.ok) throw new Error(`POST ${path} \u2192 HTTP ${r.status}`);
+    return r.json();
+  }
+  tip() {
+    return this.get("/tip");
+  }
+  health() {
+    return this.get("/health");
+  }
+  blockByHeight(h) {
+    return this.get(`/block/height/${h}`);
+  }
+  blockByHash(hash) {
+    return this.get(`/block/${hash}`);
+  }
+  tx(id) {
+    return this.get(`/tx/${id}`);
+  }
+  utxos(addr) {
+    return this.get(`/utxos/${addr}`);
+  }
+  proposal(id) {
+    return this.get(`/proposal/${id}`);
+  }
+  proposals(domain, limit = 40) {
+    return this.get(`/proposals/${encodeURIComponent(domain)}/${limit}`);
+  }
+  topDomain(domain, epoch) {
+    return this.get(epoch == null ? `/top/${encodeURIComponent(domain)}` : `/top/${encodeURIComponent(domain)}/${epoch}`);
+  }
+  domains() {
+    return this.get("/domains");
+  }
+  mempool() {
+    return this.get("/mempool");
+  }
+  /** Broadcast a node-JSON tx (from @inversealtruism/csd-tx `txToNodeJson`). */
+  submit(nodeJsonTx) {
+    return this.post("/tx/submit", { tx: nodeJsonTx });
+  }
+  templatePropose(body) {
+    return this.post("/tx/template/propose", body);
+  }
+  templateAttest(body) {
+    return this.post("/tx/template/attest", body);
+  }
+};
+function rpcTxToTx(j) {
+  const app = j.app.type === "None" ? { type: "None" } : j.app.type === "Propose" ? { type: "Propose", domain: j.app.domain, payloadHash: j.app.payload_hash, uri: j.app.uri, expiresEpoch: j.app.expires_epoch } : { type: "Attest", proposalId: j.app.proposal_id, score: j.app.score, confidence: j.app.confidence };
+  return {
+    version: j.version,
+    locktime: j.locktime,
+    app,
+    inputs: j.inputs.map((i) => ({ prevTxid: i.prev_txid, vout: i.vout, scriptSig: i.script_sig })),
+    outputs: j.outputs.map((o) => ({ value: o.value, scriptPubkey: o.script_pubkey }))
+  };
+}
+function rpcHeaderToHeader(h) {
+  return { version: h.version, prev: h.prev, merkle: h.merkle, time: h.time, bits: h.bits, nonce: h.nonce };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CsdClient,
+  rpcHeaderToHeader,
+  rpcTxToTx
+});

package/dist/index.d.cts

@@ -0,0 +1,115 @@
+import { BlockHeader, Tx } from '@inversealtruism/csd-codec';
+
+interface RpcHeaderJson {
+    version: number;
+    prev: string;
+    merkle: string;
+    time: number;
+    bits: number;
+    nonce: number;
+}
+interface RpcTxJson {
+    txid: string;
+    version: number;
+    inputs: {
+        prev_txid: string;
+        vout: number;
+        script_sig: string;
+        script_sig_text?: string | null;
+    }[];
+    outputs: {
+        value: number;
+        script_pubkey: string;
+    }[];
+    locktime: number;
+    app: {
+        type: "None";
+    } | {
+        type: "Propose";
+        domain: string;
+        payload_hash: string;
+        uri: string;
+        expires_epoch: number;
+    } | {
+        type: "Attest";
+        proposal_id: string;
+        score: number;
+        confidence: number;
+    };
+}
+interface RpcBlock {
+    ok: boolean;
+    hash: string;
+    height?: number;
+    chainwork?: string;
+    header: RpcHeaderJson;
+    txs: RpcTxJson[];
+}
+interface RpcTip {
+    tip: string;
+    height: number;
+    chainwork: string;
+}
+interface RpcUtxo {
+    txid: string;
+    vout: number;
+    value: number;
+    height: number;
+    confirmations: number;
+    coinbase: boolean;
+}
+interface RpcUtxos {
+    ok: boolean;
+    addr20: string;
+    count: number;
+    confirmed_balance: number;
+    utxos: RpcUtxo[];
+}
+interface RpcSubmit {
+    ok: boolean;
+    txid: string;
+    mempool_len?: number;
+    err?: string | null;
+}
+interface ClientOptions {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class CsdClient {
+    private readonly base;
+    private readonly f;
+    private readonly timeoutMs;
+    constructor(opts: ClientOptions);
+    private get;
+    private post;
+    tip(): Promise<RpcTip>;
+    health(): Promise<any>;
+    blockByHeight(h: number): Promise<RpcBlock>;
+    blockByHash(hash: string): Promise<RpcBlock>;
+    tx(id: string): Promise<{
+        ok: boolean;
+        txid: string;
+        block_hash?: string;
+        height?: number;
+        time?: number;
+        tx?: RpcTxJson;
+        err?: string;
+    }>;
+    utxos(addr: string): Promise<RpcUtxos>;
+    proposal(id: string): Promise<any>;
+    proposals(domain: string, limit?: number): Promise<any>;
+    topDomain(domain: string, epoch?: number): Promise<any>;
+    domains(): Promise<any>;
+    mempool(): Promise<any>;
+    /** Broadcast a node-JSON tx (from @inversealtruism/csd-tx `txToNodeJson`). */
+    submit(nodeJsonTx: unknown): Promise<RpcSubmit>;
+    templatePropose(body: unknown): Promise<any>;
+    templateAttest(body: unknown): Promise<any>;
+}
+/** Convert a node /tx or /block tx JSON back into the codec's Tx struct (for re-verification). */
+declare function rpcTxToTx(j: RpcTxJson): Tx;
+/** Convert a node /block header JSON into the codec's BlockHeader. */
+declare function rpcHeaderToHeader(h: RpcHeaderJson): BlockHeader;
+
+export { type ClientOptions, CsdClient, type RpcBlock, type RpcHeaderJson, type RpcSubmit, type RpcTip, type RpcTxJson, type RpcUtxo, type RpcUtxos, rpcHeaderToHeader, rpcTxToTx };

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { BlockHeader, Tx } from '@inversealtruism/csd-codec';
+
+interface RpcHeaderJson {
+    version: number;
+    prev: string;
+    merkle: string;
+    time: number;
+    bits: number;
+    nonce: number;
+}
+interface RpcTxJson {
+    txid: string;
+    version: number;
+    inputs: {
+        prev_txid: string;
+        vout: number;
+        script_sig: string;
+        script_sig_text?: string | null;
+    }[];
+    outputs: {
+        value: number;
+        script_pubkey: string;
+    }[];
+    locktime: number;
+    app: {
+        type: "None";
+    } | {
+        type: "Propose";
+        domain: string;
+        payload_hash: string;
+        uri: string;
+        expires_epoch: number;
+    } | {
+        type: "Attest";
+        proposal_id: string;
+        score: number;
+        confidence: number;
+    };
+}
+interface RpcBlock {
+    ok: boolean;
+    hash: string;
+    height?: number;
+    chainwork?: string;
+    header: RpcHeaderJson;
+    txs: RpcTxJson[];
+}
+interface RpcTip {
+    tip: string;
+    height: number;
+    chainwork: string;
+}
+interface RpcUtxo {
+    txid: string;
+    vout: number;
+    value: number;
+    height: number;
+    confirmations: number;
+    coinbase: boolean;
+}
+interface RpcUtxos {
+    ok: boolean;
+    addr20: string;
+    count: number;
+    confirmed_balance: number;
+    utxos: RpcUtxo[];
+}
+interface RpcSubmit {
+    ok: boolean;
+    txid: string;
+    mempool_len?: number;
+    err?: string | null;
+}
+interface ClientOptions {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+declare class CsdClient {
+    private readonly base;
+    private readonly f;
+    private readonly timeoutMs;
+    constructor(opts: ClientOptions);
+    private get;
+    private post;
+    tip(): Promise<RpcTip>;
+    health(): Promise<any>;
+    blockByHeight(h: number): Promise<RpcBlock>;
+    blockByHash(hash: string): Promise<RpcBlock>;
+    tx(id: string): Promise<{
+        ok: boolean;
+        txid: string;
+        block_hash?: string;
+        height?: number;
+        time?: number;
+        tx?: RpcTxJson;
+        err?: string;
+    }>;
+    utxos(addr: string): Promise<RpcUtxos>;
+    proposal(id: string): Promise<any>;
+    proposals(domain: string, limit?: number): Promise<any>;
+    topDomain(domain: string, epoch?: number): Promise<any>;
+    domains(): Promise<any>;
+    mempool(): Promise<any>;
+    /** Broadcast a node-JSON tx (from @inversealtruism/csd-tx `txToNodeJson`). */
+    submit(nodeJsonTx: unknown): Promise<RpcSubmit>;
+    templatePropose(body: unknown): Promise<any>;
+    templateAttest(body: unknown): Promise<any>;
+}
+/** Convert a node /tx or /block tx JSON back into the codec's Tx struct (for re-verification). */
+declare function rpcTxToTx(j: RpcTxJson): Tx;
+/** Convert a node /block header JSON into the codec's BlockHeader. */
+declare function rpcHeaderToHeader(h: RpcHeaderJson): BlockHeader;
+
+export { type ClientOptions, CsdClient, type RpcBlock, type RpcHeaderJson, type RpcSubmit, type RpcTip, type RpcTxJson, type RpcUtxo, type RpcUtxos, rpcHeaderToHeader, rpcTxToTx };

package/dist/index.js

@@ -0,0 +1,88 @@
+// src/index.ts
+var CsdClient = class {
+  base;
+  f;
+  timeoutMs;
+  constructor(opts) {
+    this.base = opts.baseUrl.replace(/\/+$/, "");
+    this.f = opts.fetch ?? globalThis.fetch;
+    this.timeoutMs = opts.timeoutMs ?? 1e4;
+    if (!this.f) throw new Error("no fetch available \u2014 pass opts.fetch");
+  }
+  async get(path) {
+    const r = await this.f(`${this.base}${path}`, { signal: AbortSignal.timeout(this.timeoutMs) });
+    if (!r.ok) throw new Error(`GET ${path} \u2192 HTTP ${r.status}`);
+    return r.json();
+  }
+  async post(path, body) {
+    const r = await this.f(`${this.base}${path}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (!r.ok) throw new Error(`POST ${path} \u2192 HTTP ${r.status}`);
+    return r.json();
+  }
+  tip() {
+    return this.get("/tip");
+  }
+  health() {
+    return this.get("/health");
+  }
+  blockByHeight(h) {
+    return this.get(`/block/height/${h}`);
+  }
+  blockByHash(hash) {
+    return this.get(`/block/${hash}`);
+  }
+  tx(id) {
+    return this.get(`/tx/${id}`);
+  }
+  utxos(addr) {
+    return this.get(`/utxos/${addr}`);
+  }
+  proposal(id) {
+    return this.get(`/proposal/${id}`);
+  }
+  proposals(domain, limit = 40) {
+    return this.get(`/proposals/${encodeURIComponent(domain)}/${limit}`);
+  }
+  topDomain(domain, epoch) {
+    return this.get(epoch == null ? `/top/${encodeURIComponent(domain)}` : `/top/${encodeURIComponent(domain)}/${epoch}`);
+  }
+  domains() {
+    return this.get("/domains");
+  }
+  mempool() {
+    return this.get("/mempool");
+  }
+  /** Broadcast a node-JSON tx (from @inversealtruism/csd-tx `txToNodeJson`). */
+  submit(nodeJsonTx) {
+    return this.post("/tx/submit", { tx: nodeJsonTx });
+  }
+  templatePropose(body) {
+    return this.post("/tx/template/propose", body);
+  }
+  templateAttest(body) {
+    return this.post("/tx/template/attest", body);
+  }
+};
+function rpcTxToTx(j) {
+  const app = j.app.type === "None" ? { type: "None" } : j.app.type === "Propose" ? { type: "Propose", domain: j.app.domain, payloadHash: j.app.payload_hash, uri: j.app.uri, expiresEpoch: j.app.expires_epoch } : { type: "Attest", proposalId: j.app.proposal_id, score: j.app.score, confidence: j.app.confidence };
+  return {
+    version: j.version,
+    locktime: j.locktime,
+    app,
+    inputs: j.inputs.map((i) => ({ prevTxid: i.prev_txid, vout: i.vout, scriptSig: i.script_sig })),
+    outputs: j.outputs.map((o) => ({ value: o.value, scriptPubkey: o.script_pubkey }))
+  };
+}
+function rpcHeaderToHeader(h) {
+  return { version: h.version, prev: h.prev, merkle: h.merkle, time: h.time, bits: h.bits, nonce: h.nonce };
+}
+export {
+  CsdClient,
+  rpcHeaderToHeader,
+  rpcTxToTx
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@inversealtruism/csd-client",
+  "version": "0.1.0",
+  "description": "Typed HTTP RPC client for a Compute Substrate node (or the Cairn proxy / a discovered gateway) — tip/block/tx/utxos/proposals/top/domains/mempool/submit/templates.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@inversealtruism/csd-codec": "0.1.0"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "devDependencies": {
+    "@inversealtruism/csd-vectors": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/InverseAltruism/csd-sdk.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://cairn-substrate.com",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "test": "tsx test/client.test.ts"
+  }
+}