@mcsherrylabs/evolver-client 0.8.0

package/dist/types.js

@@ -0,0 +1,44 @@
+// Shared types for the Evolver client SDK.
+// ── Submit results (POST /api/tx/submit) ─────────────────────────────────────
+/**
+ * Every machine-readable refusal code a node can put in a submit response, in ONE
+ * declaration — the runtime list and the type are the same statement, so they cannot
+ * drift apart (the type is derived from the array, not written beside it).
+ *
+ * The authority is the node: `SubmitResponder.mapRejection` maps each
+ * `SubmitRejectReason` to one of these strings, and `ChannelSubmitDaHandler` adds
+ * `da_unavailable`. `src/dev/transfer-checks.ts` reads that Scala file and fails if it
+ * emits a code this list does not carry.
+ *
+ * ⚠️ Before 154 this list held SIX of them, so `insufficient_balance`,
+ * `invalid_identity_body`, `duplicate`, `ttl_expired`, `unknown_key` and the rest were
+ * all reported to callers as `internal` — found by driving a real refusal on a rig,
+ * where a 400 `invalid_identity_body` arrived as `{"reason":"internal"}`.
+ */
+export const FAILURE_REASONS = [
+    "malformed_signed_tx",
+    "unknown_ledger_id",
+    "node_not_ready",
+    "queue_full",
+    "duplicate",
+    "invalid_signature",
+    "insufficient_balance",
+    "invalid_identity_body",
+    "invalid_group_body",
+    "invalid_owners_body",
+    "invalid_list_body",
+    "rejected",
+    "confirmation_timeout",
+    "ttl_expired",
+    "ttl_too_far",
+    "unknown_key",
+    "unauthorized",
+    "toll_ceiling_too_low", // 153 — the channel's committed toll exceeds the sender's signed max_toll
+    "insufficient_da",
+    "too_many_auths",
+    "da_unavailable",
+    // client-side only: the node never sends this. Set when the response could not be
+    // read at all (transport failure, unparseable JSON, unrecognised shape).
+    "internal",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AA2B3C,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qBAAqB;IACrB,mBAAmB;IACnB,gBAAgB;IAChB,YAAY;IACZ,WAAW;IACX,mBAAmB;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;IACnB,UAAU;IACV,sBAAsB;IACtB,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,sBAAsB,EAAG,0EAA0E;IACnG,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,kFAAkF;IAClF,yEAAyE;IACzE,UAAU;CACF,CAAC"}

package/dist/wire.d.ts

@@ -0,0 +1,13 @@
+/** length-delimited string; omitted when empty (proto3 default). */
+export declare function fString(field: number, s: string): number[];
+/** length-delimited bytes; omitted when empty (proto3 default). */
+export declare function fBytes(field: number, b: Uint8Array): number[];
+/** an explicitly-present sub-message (always emitted, even if inner is empty). */
+export declare function fMessage(field: number, inner: Uint8Array): number[];
+/** non-negative varint scalar (uint64/int64); omitted when 0 (proto3 default). */
+export declare function fVarint(field: number, n: number | bigint): number[];
+/** bool; omitted when false (proto3 default). */
+export declare function fBool(field: number, v: boolean): number[];
+/** Concatenate partial encodings into the final byte string. */
+export declare function concat(...parts: number[][]): Uint8Array;
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AA8BA,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1D;AAED,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAG7D;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAEnE;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAGnE;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAGzD;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,UAAU,CAUvD"}

package/dist/wire.js

@@ -0,0 +1,71 @@
+// proto3 wire-format primitives.
+//
+// proto3 semantics: default-valued scalar fields (0 / "" / empty bytes / false)
+// are OMITTED on the wire. This matters for the proof-of-possession recipe (a
+// body re-encoded with pop_signature omitted) and for byte-exact digests.
+//
+// Encode only — the client never parses proto; the server does that. Field
+// numbers mirror src/main/protobuf/evolver/**; this codec is the single place
+// the wire contract is reproduced.
+const WIRE_VARINT = 0;
+const WIRE_LEN = 2;
+function varint(n) {
+    let v = typeof n === "bigint" ? n : BigInt(n);
+    if (v < 0n)
+        throw new Error("varint: negative value");
+    const out = [];
+    do {
+        let b = Number(v & 0x7fn);
+        v >>= 7n;
+        if (v > 0n)
+            b |= 0x80;
+        out.push(b);
+    } while (v > 0n);
+    return out;
+}
+function tag(field, wire) {
+    return varint((field << 3) | wire);
+}
+/** length-delimited string; omitted when empty (proto3 default). */
+export function fString(field, s) {
+    if (s.length === 0)
+        return [];
+    const bytes = new TextEncoder().encode(s);
+    return [...tag(field, WIRE_LEN), ...varint(bytes.length), ...bytes];
+}
+/** length-delimited bytes; omitted when empty (proto3 default). */
+export function fBytes(field, b) {
+    if (b.length === 0)
+        return [];
+    return [...tag(field, WIRE_LEN), ...varint(b.length), ...Array.from(b)];
+}
+/** an explicitly-present sub-message (always emitted, even if inner is empty). */
+export function fMessage(field, inner) {
+    return [...tag(field, WIRE_LEN), ...varint(inner.length), ...Array.from(inner)];
+}
+/** non-negative varint scalar (uint64/int64); omitted when 0 (proto3 default). */
+export function fVarint(field, n) {
+    if ((typeof n === "bigint" ? n : BigInt(n)) === 0n)
+        return [];
+    return [...tag(field, WIRE_VARINT), ...varint(n)];
+}
+/** bool; omitted when false (proto3 default). */
+export function fBool(field, v) {
+    if (!v)
+        return [];
+    return [...tag(field, WIRE_VARINT), 1];
+}
+/** Concatenate partial encodings into the final byte string. */
+export function concat(...parts) {
+    let len = 0;
+    for (const p of parts)
+        len += p.length;
+    const out = new Uint8Array(len);
+    let i = 0;
+    for (const p of parts) {
+        out.set(p, i);
+        i += p.length;
+    }
+    return out;
+}
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mcsherrylabs/evolver-client",
+  "version": "0.8.0",
+  "description": "Client SDK for an Evolver node: proto3 wire codec, transaction signing (AuthBodySignable), on-chain + group crypto, and the node HTTP API.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@noble/curves": "1.9.7",
+    "@noble/hashes": "1.8.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/openstar/evolver.git",
+    "directory": "npm-libs/client"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}