@mcsherrylabs/evolver-client 0.8.0

package/dist/generated/codecs.js

@@ -0,0 +1,240 @@
+// ⚠️ GENERATED FILE — DO NOT EDIT. Regenerate with `sbt-evolver generateSignables`.
+//
+// 149 — one description per signed message, and this is its TypeScript interpreter. The
+// source is `Codecs.all` in the Scala tree; this file is emitted from the schema that
+// `SchemaExport` derives from it, so the node and the SDK cannot disagree about a format
+// without one of them failing to build.
+//
+// Hand-editing this file is caught by `GeneratedSourcesSpec`, which regenerates and diffs.
+// If a digest here is wrong, the description is wrong: fix
+// `src/main/scala/ce/evolver/signable/` (or wherever the description lives) and regenerate.
+//
+// ⚠️ WHAT THE CALLER STILL DECIDES. A `oneOf` field's BRANCH CONDITION is not in the
+// description — `Branch.select` is a Scala function, so no schema can carry it and no
+// generator can emit it. The caller therefore says WHICH fold applies and supplies the
+// pre-image; the generated code applies it. That is strictly more than the hand-written
+// SDK did (it took an already-folded slot and computed `sha256` at the call site), and it
+// is the honest boundary of what generation can reach.
+import { dst, lpString, lengthPrefixed, int32BE, int64BE, count, encoded } from "../crypto/canonical.js";
+import { sha256 } from "../crypto/hash.js";
+function foldBytes(c) {
+    switch (c.fold) {
+        case "sha256Of": return sha256(c.bytes);
+        case "verbatim": return c.bytes;
+        case "empty": return new Uint8Array(0);
+    }
+}
+/** A fixed-width slot, written BARE. The width is checked because that is the whole
+ *  justification for omitting the prefix: a short value runs into the next field and the
+ *  encoding stops being injective. */
+function fixedWidth(field, b, width) {
+    if (b.length !== width) {
+        throw new Error(`field '${field}': expected ${width} bytes, got ${b.length}. An unprefixed field of ` +
+            `the wrong width runs into the next one and the encoding stops being injective.`);
+    }
+    return b;
+}
+/** `ce.evolver/153/tx-auth/v2` — digest. */
+export function authBody(f) {
+    return sha256(encoded(dst("ce.evolver/153/tx-auth/v2"), lpString(f.ledgerId), lpString(f.senderNodeId), int64BE(f.ttlRound), int64BE(f.maxToll), lengthPrefixed(foldBytes(f.bodySlot))));
+}
+/** `ce.evolver/148/auths-digest/v1` — digest. */
+export function authsDigest(f) {
+    return sha256(encoded(dst("ce.evolver/148/auths-digest/v1"), count(f.auths.length), ...f.auths.flatMap((e) => [lpString(e.nodeId), lpString(e.keyType), lpString(e.keyLabel), int32BE(e.purpose), lengthPrefixed(e.signature)])));
+}
+/** `ce.evolver/148/vote/v1` — material (signed as-is, NOT hashed). */
+export function vote(f) {
+    return encoded(dst("ce.evolver/148/vote/v1"), int32BE(f.roundNum), fixedWidth("blockId", f.blockId, 32));
+}
+/** `ce.evolver/148/new-view/v1` — material (signed as-is, NOT hashed). */
+export function newView(f) {
+    return encoded(dst("ce.evolver/148/new-view/v1"), int32BE(f.roundNum), fixedWidth("highQcBlockId", f.highQcBlockId, 32), int32BE(f.highQcRoundNum));
+}
+/** `ce.evolver/145/p2p-msg/v1` — digest. */
+export function p2pSignable(f) {
+    return sha256(encoded(dst("ce.evolver/145/p2p-msg/v1"), lpString(f.sender), lpString(f.keyType), lpString(f.keyLabel), lpString(f.recipient), lpString(f.channel), int64BE(f.timestamp), lengthPrefixed(f.nonce), fixedWidth("payload", sha256(f.payload), 32)));
+}
+/** `ce.evolver/148/pop-create-identity/v1` — digest. */
+export function popCreateIdentity(f) {
+    return sha256(encoded(dst("ce.evolver/148/pop-create-identity/v1"), lpString(f.nodeId), int64BE(f.initialCredit), count(f.keys.length), ...f.keys.flatMap((e) => [lpString(e.keyType), lengthPrefixed(e.publicKey), lpString(e.keyLabel)])));
+}
+/** `ce.evolver/148/pop-add-key/v1` — digest. */
+export function popAddKey(f) {
+    return sha256(encoded(dst("ce.evolver/148/pop-add-key/v1"), lengthPrefixed(f.publicKey), lpString(f.keyType), lpString(f.keyLabel)));
+}
+/** `ce.evolver/148/pop-replace-key/v1` — digest. */
+export function popReplaceKey(f) {
+    return sha256(encoded(dst("ce.evolver/148/pop-replace-key/v1"), lengthPrefixed(f.publicKey), lpString(f.keyType), lpString(f.keyLabel)));
+}
+/** `ce.evolver/149/proposal-id-admission/v1` — digest. */
+export function proposalIdAdmission(f) {
+    return sha256(encoded(dst("ce.evolver/149/proposal-id-admission/v1"), lpString(f.candidateNodeId), int32BE(f.startBlockHeight), lpString(f.proposerNodeId), int32BE(f.donatedStake)));
+}
+/** `ce.evolver/149/proposal-id-removal/v1` — digest. */
+export function proposalIdRemoval(f) {
+    return sha256(encoded(dst("ce.evolver/149/proposal-id-removal/v1"), lpString(f.targetNodeId), int32BE(f.removalBlockHeight), lpString(f.proposerNodeId)));
+}
+/** `ce.evolver/148/block-id/v1` — digest. */
+export function blockId(f) {
+    return sha256(encoded(dst("ce.evolver/148/block-id/v1"), int32BE(f.roundNum), fixedWidth("parentId", f.parentId, 32), fixedWidth("merkleRoot", f.merkleRoot, 32), lengthPrefixed(f.parentQcSigners)));
+}
+/** `ce.evolver/149/list-tx-id/v1` — digest. */
+export function listTxId(f) {
+    return sha256(encoded(dst("ce.evolver/149/list-tx-id/v1"), count(f.txIds.length), ...f.txIds.flatMap((e) => [fixedWidth("txIds.txId", e.txId, 32)])));
+}
+/** `ce.evolver/149/list-context/v1` — digest. */
+export function listContext(f) {
+    return sha256(encoded(dst("ce.evolver/149/list-context/v1"), fixedWidth("listTxId", f.listTxId, 32), fixedWidth("txId", f.txId, 32)));
+}
+export const CODECS = [
+    {
+        name: "auth-body",
+        tag: "ce.evolver/153/tx-auth/v2",
+        output: "digest",
+        fields: [
+            { name: "ledgerId", kind: "string", derivation: "direct" },
+            { name: "senderNodeId", kind: "string", derivation: "direct" },
+            { name: "ttlRound", kind: "int64", derivation: "direct" },
+            { name: "maxToll", kind: "int64", derivation: "direct" },
+            { name: "bodySlot", kind: "bytes", derivation: { oneOf: ["sha256Of", "verbatim", "empty"] } },
+        ],
+    },
+    {
+        name: "auths-digest",
+        tag: "ce.evolver/148/auths-digest/v1",
+        output: "digest",
+        fields: [
+            { name: "auths", kind: "list(string,string,string,int32,bytes)", elements: [{ name: "nodeId", kind: "string" }, { name: "keyType", kind: "string" }, { name: "keyLabel", kind: "string" }, { name: "purpose", kind: "int32" }, { name: "signature", kind: "bytes" }], derivation: "direct" },
+        ],
+    },
+    {
+        name: "vote",
+        tag: "ce.evolver/148/vote/v1",
+        output: "material",
+        fields: [
+            { name: "roundNum", kind: "int32", derivation: "direct" },
+            { name: "blockId", kind: "fixed(32)", derivation: "direct" },
+        ],
+    },
+    {
+        name: "new-view",
+        tag: "ce.evolver/148/new-view/v1",
+        output: "material",
+        fields: [
+            { name: "roundNum", kind: "int32", derivation: "direct" },
+            { name: "highQcBlockId", kind: "fixed(32)", derivation: "direct" },
+            { name: "highQcRoundNum", kind: "int32", derivation: "direct" },
+        ],
+    },
+    {
+        name: "p2p-signable",
+        tag: "ce.evolver/145/p2p-msg/v1",
+        output: "digest",
+        fields: [
+            { name: "sender", kind: "string", derivation: "direct" },
+            { name: "keyType", kind: "string", derivation: "direct" },
+            { name: "keyLabel", kind: "string", derivation: "direct" },
+            { name: "recipient", kind: "string", derivation: "direct" },
+            { name: "channel", kind: "string", derivation: "direct" },
+            { name: "timestamp", kind: "int64", derivation: "direct" },
+            { name: "nonce", kind: "bytes", derivation: "direct" },
+            { name: "payload", kind: "fixed(32)", derivation: "sha256Of" },
+        ],
+    },
+    {
+        name: "pop-create-identity",
+        tag: "ce.evolver/148/pop-create-identity/v1",
+        output: "digest",
+        fields: [
+            { name: "nodeId", kind: "string", derivation: "direct" },
+            { name: "initialCredit", kind: "int64", derivation: "direct" },
+            { name: "keys", kind: "list(string,bytes,string)", elements: [{ name: "keyType", kind: "string" }, { name: "publicKey", kind: "bytes" }, { name: "keyLabel", kind: "string" }], derivation: "direct" },
+        ],
+    },
+    {
+        name: "pop-add-key",
+        tag: "ce.evolver/148/pop-add-key/v1",
+        output: "digest",
+        fields: [
+            { name: "publicKey", kind: "bytes", derivation: "direct" },
+            { name: "keyType", kind: "string", derivation: "direct" },
+            { name: "keyLabel", kind: "string", derivation: "direct" },
+        ],
+    },
+    {
+        name: "pop-replace-key",
+        tag: "ce.evolver/148/pop-replace-key/v1",
+        output: "digest",
+        fields: [
+            { name: "publicKey", kind: "bytes", derivation: "direct" },
+            { name: "keyType", kind: "string", derivation: "direct" },
+            { name: "keyLabel", kind: "string", derivation: "direct" },
+        ],
+    },
+    {
+        name: "proposal-id-admission",
+        tag: "ce.evolver/149/proposal-id-admission/v1",
+        output: "digest",
+        fields: [
+            { name: "candidateNodeId", kind: "string", derivation: "direct" },
+            { name: "startBlockHeight", kind: "int32", derivation: "direct" },
+            { name: "proposerNodeId", kind: "string", derivation: "direct" },
+            { name: "donatedStake", kind: "int32", derivation: "direct" },
+        ],
+    },
+    {
+        name: "proposal-id-removal",
+        tag: "ce.evolver/149/proposal-id-removal/v1",
+        output: "digest",
+        fields: [
+            { name: "targetNodeId", kind: "string", derivation: "direct" },
+            { name: "removalBlockHeight", kind: "int32", derivation: "direct" },
+            { name: "proposerNodeId", kind: "string", derivation: "direct" },
+        ],
+    },
+    {
+        name: "block-id",
+        tag: "ce.evolver/148/block-id/v1",
+        output: "digest",
+        fields: [
+            { name: "roundNum", kind: "int32", derivation: "direct" },
+            { name: "parentId", kind: "fixed(32)", derivation: "direct" },
+            { name: "merkleRoot", kind: "fixed(32)", derivation: "direct" },
+            { name: "parentQcSigners", kind: "bytes", derivation: "direct" },
+        ],
+    },
+    {
+        name: "list-tx-id",
+        tag: "ce.evolver/149/list-tx-id/v1",
+        output: "digest",
+        fields: [
+            { name: "txIds", kind: "list(fixed(32))", elements: [{ name: "txId", kind: "fixed(32)" }], derivation: "direct" },
+        ],
+    },
+    {
+        name: "list-context",
+        tag: "ce.evolver/149/list-context/v1",
+        output: "digest",
+        fields: [
+            { name: "listTxId", kind: "fixed(32)", derivation: "direct" },
+            { name: "txId", kind: "fixed(32)", derivation: "direct" },
+        ],
+    },
+];
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const ENCODERS = {
+    "auth-body": (row) => authBody(row),
+    "auths-digest": (row) => authsDigest(row),
+    "vote": (row) => vote(row),
+    "new-view": (row) => newView(row),
+    "p2p-signable": (row) => p2pSignable(row),
+    "pop-create-identity": (row) => popCreateIdentity(row),
+    "pop-add-key": (row) => popAddKey(row),
+    "pop-replace-key": (row) => popReplaceKey(row),
+    "proposal-id-admission": (row) => proposalIdAdmission(row),
+    "proposal-id-removal": (row) => proposalIdRemoval(row),
+    "block-id": (row) => blockId(row),
+    "list-tx-id": (row) => listTxId(row),
+    "list-context": (row) => listContext(row),
+};
+//# sourceMappingURL=codecs.js.map

package/dist/generated/codecs.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,17 @@
+import { type BlsKeypair, type EdKeypair } from "./crypto/auth.js";
+export interface Identity {
+    nodeId: string;
+    bls: BlsKeypair;
+    ed: EdKeypair;
+}
+export declare function newIdentity(nodeId: string): Identity;
+/** Sponsored initial credit of a faucet claim — MUST mirror the node's
+ *  IdentityApiHandler (5000): it is part of the PoP digest recomputed locally. */
+export declare const FAUCET_SPONSORED_CREDIT = 5000;
+/** PoP digest of the faucet-sponsored CreateIdentity for `id` — the exact bytes the
+ *  node's /api/identity/prepare returns as tx_hash_hex. Recomputing it locally lets
+ *  the claimer refuse to PoP-sign server-chosen bytes. */
+export declare function faucetClaimDigest(id: Identity): Uint8Array;
+/** CreateIdentity tx_body for `id`, with PoP signed by `id`'s own keys. */
+export declare function createIdentityBodyFor(id: Identity, initialCredit: number | bigint): Uint8Array;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGhH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,UAAU,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEpD;AAED;kFACkF;AAClF,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;0DAE0D;AAC1D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,CAa1D;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAgB9F"}

package/dist/identity.js

@@ -0,0 +1,52 @@
+// Identity creation: fresh identities with on-chain auth keys + proof-of-possession.
+//
+// Each identity gets two mandatory auth keys (BLS12-381-G1 + Ed25519, both empty
+// label). PoP: every new key signs the SAME message — the `pop-create-identity` digest, whose
+// description deliberately excludes `pop_signature` so no key's proof is inside the thing the
+// others are proving. (It was "SHA-256 of the serialized body" until 148; this header said so
+// until 149.)
+import { createIdentityInner, createIdentityBody } from "./bodies.js";
+import { popCreateIdentity } from "./generated/codecs.js";
+import { genBls, genEd, blsSign, edSign, edPubToSpki } from "./crypto/auth.js";
+export function newIdentity(nodeId) {
+    return { nodeId, bls: genBls(), ed: genEd() };
+}
+/** Sponsored initial credit of a faucet claim — MUST mirror the node's
+ *  IdentityApiHandler (5000): it is part of the PoP digest recomputed locally. */
+export const FAUCET_SPONSORED_CREDIT = 5000;
+/** PoP digest of the faucet-sponsored CreateIdentity for `id` — the exact bytes the
+ *  node's /api/identity/prepare returns as tx_hash_hex. Recomputing it locally lets
+ *  the claimer refuse to PoP-sign server-chosen bytes. */
+export function faucetClaimDigest(id) {
+    const keysNoPoP = [
+        { keyType: "BLS12-381-G1", publicKey: id.bls.pub, keyLabel: "" },
+        { keyType: "Ed25519", publicKey: edPubToSpki(id.ed.pub), keyLabel: "" },
+    ];
+    // 148 — canonical PoP encoding, matching the node. This value is recomputed locally and
+    // compared against the server's tx_hash before signing, so a mismatch REFUSES rather than
+    // signs bytes we cannot reproduce.
+    return popCreateIdentity({
+        nodeId: id.nodeId,
+        initialCredit: BigInt(FAUCET_SPONSORED_CREDIT),
+        keys: keysNoPoP,
+    });
+}
+/** CreateIdentity tx_body for `id`, with PoP signed by `id`'s own keys. */
+export function createIdentityBodyFor(id, initialCredit) {
+    const keysNoPoP = [
+        { keyType: "BLS12-381-G1", publicKey: id.bls.pub, keyLabel: "" }, // raw 48-byte G1
+        { keyType: "Ed25519", publicKey: edPubToSpki(id.ed.pub), keyLabel: "" }, // X.509 SPKI
+    ];
+    // Every new key signs this ONE message; no pop_signature is inside it.
+    const popHash = popCreateIdentity({
+        nodeId: id.nodeId,
+        initialCredit: BigInt(initialCredit),
+        keys: keysNoPoP,
+    });
+    const keysWithPoP = [
+        { ...keysNoPoP[0], popSig: blsSign(popHash, id.bls.priv) }, // 96-byte G2
+        { ...keysNoPoP[1], popSig: edSign(popHash, id.ed.priv) }, // 64-byte ed25519
+    ];
+    return createIdentityBody(createIdentityInner(id.nodeId, initialCredit, keysWithPoP, true));
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,EAAE;AACF,iFAAiF;AACjF,8FAA8F;AAC9F,8FAA8F;AAC9F,8FAA8F;AAC9F,cAAc;AAEd,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAmC,MAAM,kBAAkB,CAAC;AAShH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;AAChD,CAAC;AAED;kFACkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;0DAE0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,MAAM,SAAS,GAAe;QAC5B,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;QAChE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;KACxE,CAAC;IACF,wFAAwF;IACxF,0FAA0F;IAC1F,mCAAmC;IACnC,OAAO,iBAAiB,CAAC;QACvB,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,aAAa,EAAE,MAAM,CAAC,uBAAuB,CAAC;QAC9C,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,EAAY,EAAE,aAA8B;IAChF,MAAM,SAAS,GAAe;QAC5B,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,iBAAiB;QACnF,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,aAAa;KACvF,CAAC;IACF,uEAAuE;IACvE,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC;QACpC,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;IACH,MAAM,WAAW,GAAe;QAC9B,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa;QACzE,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB;KAC7E,CAAC;IACF,OAAO,kBAAkB,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./types.js";
+export * from "./wire.js";
+export * from "./crypto/hash.js";
+export * from "./crypto/auth.js";
+export * from "./crypto/group.js";
+export * from "./crypto/stream.js";
+export * from "./generated/codecs.js";
+export * from "./envelope.js";
+export * from "./bodies.js";
+export * from "./identity.js";
+export * from "./signers.js";
+export * from "./api.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAInC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// @mcsherrylabs/evolver-client — isomorphic client SDK for an Evolver node.
+export * from "./types.js";
+export * from "./wire.js";
+export * from "./crypto/hash.js";
+export * from "./crypto/auth.js";
+export * from "./crypto/group.js";
+export * from "./crypto/stream.js";
+// 149 — the generated encoders: one per described message, emitted from the node's own
+// descriptions. Exported before ./envelope and ./bodies because those two now COMPOSE these
+// rather than restating them.
+export * from "./generated/codecs.js";
+export * from "./envelope.js";
+export * from "./bodies.js";
+export * from "./identity.js";
+export * from "./signers.js";
+export * from "./api.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,uFAAuF;AACvF,4FAA4F;AAC5F,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/signers.d.ts

@@ -0,0 +1,52 @@
+import { type P2pSignableFields } from "./generated/codecs.js";
+import type { Signer } from "./types.js";
+/**
+ * The default BLS auth key ("BLS12-381-G1", ""). `nodeId` "" means the auth
+ * resolves to the tx sender; pass an explicit nodeId for a co-signer.
+ */
+export declare function blsDefaultSigner(blsPriv: Uint8Array, nodeId?: string): Signer;
+/**
+ * 147 — the default Ed25519 auth key (`"Ed25519"`, `""`), closing over the private half so
+ * no caller holds it.
+ *
+ * Why Ed25519 and not BLS for the peer-to-peer path: verification is cheaper, there is
+ * nothing to aggregate in a point-to-point message, and it keeps the consensus BLS key off
+ * an application surface entirely. It is also the key an identity's `create-identity`
+ * already registers on-chain, so a user's p2p messages are attributable with no extra
+ * enrolment.
+ */
+export declare function edDefaultSigner(edPriv: Uint8Array, nodeId?: string): Signer;
+/** The fields a peer-to-peer signature covers. One object, so the digest and the body it
+ *  travels in can never disagree about what was signed. */
+export type P2PMessageFields = P2pSignableFields;
+/** Exactly what the node's relay route (`POST /api/p2p/send`) reads: flat, all strings. */
+export interface P2PRelayBody extends Record<string, string> {
+    sender: string;
+    keyType: string;
+    keyLabel: string;
+    recipient: string;
+    channel: string;
+    timestamp: string;
+    nonce: string;
+    payload: string;
+    signature: string;
+}
+/**
+ * 147 — build the relay body for one peer-to-peer message: compute the material with the
+ * GENERATED encoder, sign it through the handle, and lay the fields out the way the node
+ * parses them.
+ *
+ * ⚠️ This function contains **no byte encoding of its own**, and must not gain any. The
+ * digest comes from `p2pSignable()` in `generated/codecs.ts`, emitted from the node's own
+ * description of this message — so "byte-identical to the node" is structural rather than
+ * something asserted after the fact. A hand-rolled second encoder here is exactly the
+ * failure 149 exists to prevent (the TypeScript half of PoP drifted from the Scala half for
+ * a whole release while `npm test` stayed green), and the discipline gate refuses it:
+ * *no hand-written encoder shadows a generated one*.
+ *
+ * `timestamp` crosses as a DECIMAL STRING and is held as `bigint` (Constitution VIII):
+ * epoch millis is a large integer, and a float round-trip would corrupt the one field whose
+ * corruption is invisible until the far end silently refuses the signature.
+ */
+export declare function p2pRelayBody(signer: Signer, fields: P2PMessageFields): P2PRelayBody;
+//# sourceMappingURL=signers.d.ts.map

package/dist/signers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../src/signers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAK,GAAG,MAAM,CAOzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAK,GAAG,MAAM,CAOvE;AAED;2DAC2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAEjD,2FAA2F;AAC3F,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAanF"}

package/dist/signers.js

@@ -0,0 +1,75 @@
+// Signer constructors. A Signer turns the 32-byte signing digest into one TxAuth.
+import { blsSign, edSign } from "./crypto/auth.js";
+import { bytesToHex } from "./crypto/hash.js";
+import { p2pSignable } from "./generated/codecs.js";
+/**
+ * The default BLS auth key ("BLS12-381-G1", ""). `nodeId` "" means the auth
+ * resolves to the tx sender; pass an explicit nodeId for a co-signer.
+ */
+export function blsDefaultSigner(blsPriv, nodeId = "") {
+    return {
+        keyType: "BLS12-381-G1",
+        keyLabel: "",
+        nodeId,
+        sign: (digest) => blsSign(digest, blsPriv),
+    };
+}
+/**
+ * 147 — the default Ed25519 auth key (`"Ed25519"`, `""`), closing over the private half so
+ * no caller holds it.
+ *
+ * Why Ed25519 and not BLS for the peer-to-peer path: verification is cheaper, there is
+ * nothing to aggregate in a point-to-point message, and it keeps the consensus BLS key off
+ * an application surface entirely. It is also the key an identity's `create-identity`
+ * already registers on-chain, so a user's p2p messages are attributable with no extra
+ * enrolment.
+ */
+export function edDefaultSigner(edPriv, nodeId = "") {
+    return {
+        keyType: "Ed25519",
+        keyLabel: "",
+        nodeId,
+        sign: (digest) => edSign(digest, edPriv),
+    };
+}
+/**
+ * 147 — build the relay body for one peer-to-peer message: compute the material with the
+ * GENERATED encoder, sign it through the handle, and lay the fields out the way the node
+ * parses them.
+ *
+ * ⚠️ This function contains **no byte encoding of its own**, and must not gain any. The
+ * digest comes from `p2pSignable()` in `generated/codecs.ts`, emitted from the node's own
+ * description of this message — so "byte-identical to the node" is structural rather than
+ * something asserted after the fact. A hand-rolled second encoder here is exactly the
+ * failure 149 exists to prevent (the TypeScript half of PoP drifted from the Scala half for
+ * a whole release while `npm test` stayed green), and the discipline gate refuses it:
+ * *no hand-written encoder shadows a generated one*.
+ *
+ * `timestamp` crosses as a DECIMAL STRING and is held as `bigint` (Constitution VIII):
+ * epoch millis is a large integer, and a float round-trip would corrupt the one field whose
+ * corruption is invisible until the far end silently refuses the signature.
+ */
+export function p2pRelayBody(signer, fields) {
+    const signature = signer.sign(p2pSignable(fields));
+    return {
+        sender: fields.sender,
+        keyType: fields.keyType,
+        keyLabel: fields.keyLabel,
+        recipient: fields.recipient,
+        channel: fields.channel,
+        timestamp: fields.timestamp.toString(10),
+        nonce: bytesToHex(fields.nonce),
+        payload: bytesToBase64(fields.payload),
+        signature: bytesToHex(signature),
+    };
+}
+/** `btoa`, not `Buffer` — this package is isomorphic and `api.ts` already decodes with
+ *  `atob` for the same reason. A `Buffer` here would work in every test and fail in a
+ *  browser, which is the worst available outcome. */
+function bytesToBase64(bytes) {
+    let bin = "";
+    for (let i = 0; i < bytes.length; i++)
+        bin += String.fromCharCode(bytes[i]);
+    return btoa(bin);
+}
+//# sourceMappingURL=signers.js.map

package/dist/signers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signers.js","sourceRoot":"","sources":["../src/signers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAA0B,MAAM,uBAAuB,CAAC;AAG5E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB,EAAE,MAAM,GAAG,EAAE;IAC/D,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,EAAE;QACZ,MAAM;QACN,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,MAAM,GAAG,EAAE;IAC7D,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM;QACN,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;KACzC,CAAC;AACJ,CAAC;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAwB;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QACtC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;qDAEqD;AACrD,SAAS,aAAa,CAAC,KAAiB;IACtC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/** A key that signs the 32-byte tx signing digest, producing one TxAuth. */
+export interface Signer {
+    keyType: string;
+    keyLabel: string;
+    /** "" ⇒ resolves to sender_node_id; set ⇒ a co-signer identity. */
+    nodeId: string;
+    sign(digest: Uint8Array): Uint8Array;
+}
+/** A produced TxAuth entry (TxAuth: 1 key_type | 2 key_label | 3 signature | 4 node_id). */
+export interface Auth {
+    keyType: string;
+    keyLabel: string;
+    signature: Uint8Array;
+    nodeId: string;
+}
+/** One key in a CreateIdentityTxBody (KeyEntryWithPoP). */
+export interface KeyEntry {
+    keyType: string;
+    publicKey: Uint8Array;
+    keyLabel: string;
+    popSig?: Uint8Array;
+}
+/**
+ * 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 declare const FAILURE_REASONS: readonly ["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", "insufficient_da", "too_many_auths", "da_unavailable", "internal"];
+export type FailureReason = (typeof FAILURE_REASONS)[number];
+export interface Committed {
+    kind: "committed";
+    txIdHex: string;
+}
+export interface Failed {
+    kind: "failed";
+    reason: FailureReason;
+    message: string;
+}
+export interface Timeout {
+    kind: "timeout";
+    txIdHex: string;
+}
+export type SubmitResult = Committed | Failed | Timeout;
+export interface NodeKey {
+    nodeId: string;
+    keyType: string;
+    label: string;
+    publicKeyHex: string;
+}
+export interface PullResp {
+    httpStatus: number;
+    status: string;
+    round?: string;
+    index?: string;
+    txId?: string;
+    ledgerId?: string;
+    sender?: string;
+    ttlRound?: string;
+    body?: string;
+    tip?: string;
+    message?: string;
+}
+export interface Delivery {
+    round: number;
+    index: number;
+    txId: string;
+    ledgerId: string;
+    sender: string;
+    body: Uint8Array;
+}
+export interface WrappedKey {
+    ephPub: Uint8Array;
+    blob: Uint8Array;
+}
+/**
+ * A handle that recovers a group key from a wrap addressed to ONE member — peer to
+ * [[Signer]], for key agreement instead of signature.
+ *
+ * It exists for the same reason Signer does: the private half stays inside the
+ * implementation. Callers pass wraps in and get group keys out, and never see a scalar.
+ * It is not a Signer because it produces no signature; the operation is ECDH.
+ *
+ * Build one with `edGroupKeyUnwrapper` (an Ed25519 identity key, what every member uses
+ * today) or `x25519GroupKeyUnwrapper` (a native X25519 key). A future remote/phone-held
+ * implementation slots in here — see issue #53, and note that today's mobile signer
+ * offers signing but no ECDH, so that is a service-side change, not just a new class.
+ */
+export interface GroupKeyUnwrapper {
+    /** Diagnostic: which key this unwraps with, and how it was obtained. */
+    keyType: string;
+    unwrap(w: WrappedKey): Promise<Uint8Array>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AAED,4FAA4F;AAC5F,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAID;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,waAyBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACjE,MAAM,WAAW,MAAM;IAAG,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAClF,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC7D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAIxD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5C"}