@mcsherrylabs/evolver-mcp 0.12.0 → 0.14.0

package/dist/identity.d.ts

@@ -1,87 +0,0 @@
-import type { Signer } from "@mcsherrylabs/evolver-client";
-import type { ChainReads } from "./read.js";
-import type { SignedIdentity, SignedGroup, SignedChannel, SignedRecord } from "./write.js";
-import type { ToolResult } from "./result.js";
-/** What the identity verbs need from the world. NO `submitTx` — deliberately: the five signing
- *  verbs submit nothing, so the capability is not present to reach for (SIGN-20 is structural). */
-export interface IdentityOpsDeps {
-    readonly identity: string;
-    readonly signer: Signer;
-    readonly ttlOffset?: number;
-    readonly reads: ChainReads;
-}
-/** A signed identity operation, as returned by a signing verb. Always `ok` once composed. */
-export type IdentitySignResult = ToolResult<SignedIdentity>;
-/** Decode a starting credit from a decimal string, refusing `< 1`, non-integers, and negative/hex
- *  forms. The chain FINES a zero- or negative-credit creation rather than refusing it, so the whole
- *  point is this refusal happening BEFORE anything is signed (Pitfall 4). */
-export declare function parseInitialCredit(input: string): {
-    ok: true;
-    value: bigint;
-} | {
-    ok: false;
-    error: string;
-};
-/**
- * Compose a body into a signed identity transaction and record it — in ONE call. Mirrors
- * `signTransfer`'s inline compose→sign→record: `buildSignedTx` → `txIdHex` → record into the two
- * session stores via `recordSigned`. It SUBMITS NOTHING.
- *
- * This is the single compose implementation, re-exported from `src/write.ts` as `composeAndSign`
- * (one compose path, never two). The `ledgerId` is always `LEDGER.identity` at the call sites.
- */
-export declare function composeIdentityTx(deps: IdentityOpsDeps, args: {
-    ledgerId: string;
-    body: Uint8Array;
-    ttlRound: number;
-    signedAtRound: number;
-    verb: SignedIdentity["verb"] | SignedGroup["verb"] | SignedChannel["verb"];
-    fields: Record<string, string>;
-    maxToll?: bigint;
-}): ToolResult<SignedRecord>;
-/**
- * Sponsor a new identity, paid for by this agent — signed for `deps.identity`, the configured host
- * identity as `senderNodeId` (never a caller-chosen node id).
- *
- * ⚠️ THE CHAIN'S KEY RULES ARE ENFORCED HERE, not left to it, because its answer arrives too late
- * to help: a body with the wrong keys is ORDERED and FINED 100, not refused. Exactly one
- * BLS12-381-G1 and one Ed25519, each at label "", a starting credit >= 1, and both keys carrying a
- * proof of possession from their holder.
- */
-export declare function signCreateIdentity(deps: IdentityOpsDeps, params: {
-    keys: Array<{
-        keyType: string;
-        keyLabel: string;
-        publicKey: string;
-        popSignature: string;
-    }>;
-    initialCredit: string;
-}): Promise<ToolResult<SignedRecord>>;
-/**
- * Delete the identity this agent signs as. SELF-DELETION ONLY (Pitfall 5): `confirmName` must match
- * `deps.identity`, else the chain would fine a deletion naming another identity.
- */
-export declare function signDeleteIdentity(deps: IdentityOpsDeps, params: {
-    confirmName: string;
-}): Promise<ToolResult<SignedRecord>>;
-export declare const signAddKey: (deps: IdentityOpsDeps, p: {
-    keyType: string;
-    keyLabel: string;
-    publicKey: string;
-    popSignature: string;
-}) => Promise<ToolResult<SignedRecord>>;
-export declare const signReplaceKey: (deps: IdentityOpsDeps, p: {
-    keyType: string;
-    keyLabel: string;
-    publicKey: string;
-    popSignature: string;
-}) => Promise<ToolResult<SignedRecord>>;
-/**
- * Remove one of this identity's own keys. ⚠️ THE CHAIN WILL NOT STOP YOU LOCKING YOURSELF OUT — its
- * only guard refuses a committee member deleting its default consensus key.
- */
-export declare function signDeleteKey(deps: IdentityOpsDeps, p: {
-    keyType: string;
-    keyLabel: string;
-}): Promise<ToolResult<SignedRecord>>;
-//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;mGACmG;AACnG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AAE5D;;6EAE6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU5G;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,UAAU,CAAC,YAAY,CAAC,CA0B1B;AAYD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC7H,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CA6DnC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAuBnC;AAmDD,eAAO,MAAM,UAAU,GAAI,MAAM,eAAe,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,sCACpG,CAAC;AAEhC,eAAO,MAAM,cAAc,GAAI,MAAM,eAAe,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,sCACpG,CAAC;AAEpC;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,eAAe,EACrB,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAiBnC"}

package/dist/identity.js

@@ -1,236 +0,0 @@
-// Identity-lifecycle signing verbs (SIGN-03..07): sign create/delete identity and add/replace/delete
-// key. Each is a compose→sign→record→return-txId operation with ZERO submit, mirroring Phase 2's
-// `signTransfer` (SIGN-20) and resolving in the SAME `submitSigned`/`inspectSigned` path (SIGN-19).
-//
-// The ledger is pinned to `LEDGER.identity` (never a caller-chosen channel or core-ledger id), so
-// nothing here can reach a node before `evolver_submit`. The costly local refusals — create-identity
-// key rules, delete-identity self-check, empty-PoP refusal — fire BEFORE anything is signed, because
-// the chain's answer for a malformed body arrives as a FINE, too late to refuse (Pitfalls 4/5).
-//
-// ⚠️ KEY MATERIAL NEVER REACHES A RECORD OR A REFUSAL. Records carry key `type`/`label` and the txId
-// only; the caller supplies the holder-produced `popSignature` bytes, which are folded into the
-// composed body by the SDK encoder — this process never computes a PoP digest and never signs for a
-// key it does not hold.
-import { LEDGER, buildSignedTx, txIdHex, hexToBytes, createIdentityInner, createIdentityBody, deleteIdentityBody, addKeyBody, replaceKeyBody, deleteKeyBody, } from "@mcsherrylabs/evolver-client";
-import { DEFAULT_TTL_OFFSET, recordSigned } from "./write.js";
-/** Decode a starting credit from a decimal string, refusing `< 1`, non-integers, and negative/hex
- *  forms. The chain FINES a zero- or negative-credit creation rather than refusing it, so the whole
- *  point is this refusal happening BEFORE anything is signed (Pitfall 4). */
-export function parseInitialCredit(input) {
-    const s = String(input ?? "").trim();
-    if (!/^[1-9][0-9]*$/.test(s))
-        return {
-            ok: false,
-            error: `initialCredit "${s}" is not a positive decimal integer — it must be at least 1, because ` +
-                `a zero- or negative-credit creation is ordered and FINED rather than refused`,
-        };
-    return { ok: true, value: BigInt(s) };
-}
-/**
- * Compose a body into a signed identity transaction and record it — in ONE call. Mirrors
- * `signTransfer`'s inline compose→sign→record: `buildSignedTx` → `txIdHex` → record into the two
- * session stores via `recordSigned`. It SUBMITS NOTHING.
- *
- * This is the single compose implementation, re-exported from `src/write.ts` as `composeAndSign`
- * (one compose path, never two). The `ledgerId` is always `LEDGER.identity` at the call sites.
- */
-export function composeIdentityTx(deps, args) {
-    // Resolve once for the envelope, digest and inspection. Call-site metadata must not override
-    // the channel write's effective signed consent (including the SDK's zero default).
-    const maxToll = args.maxToll ?? 0n;
-    const fields = args.verb === "channel_write"
-        ? { ...args.fields, maxToll: maxToll.toString() }
-        : { ...args.fields };
-    const bytes = buildSignedTx({
-        ledgerId: args.ledgerId,
-        senderNodeId: deps.identity,
-        body: args.body,
-        ttlRound: args.ttlRound,
-        signers: [deps.signer],
-        maxToll,
-    });
-    const id = txIdHex(args.ledgerId, deps.identity, args.ttlRound, args.body, maxToll);
-    const signed = {
-        txId: id,
-        expiresAtRound: args.ttlRound,
-        signedAtRound: args.signedAtRound,
-        verb: args.verb,
-        fields,
-        summary: { sender: deps.identity, ...fields },
-    };
-    recordSigned(signed, bytes);
-    return { kind: "ok", value: signed };
-}
-/** Read the chain tip to bound a transaction's life; an unreachable chain is `unreachable`, never a
- *  submit. */
-async function tipOrUnreachable(deps) {
-    try {
-        return await deps.reads.currentRound();
-    }
-    catch (e) {
-        return { kind: "unreachable", chain: "", cause: e instanceof Error ? e.message : String(e) };
-    }
-}
-/**
- * Sponsor a new identity, paid for by this agent — signed for `deps.identity`, the configured host
- * identity as `senderNodeId` (never a caller-chosen node id).
- *
- * ⚠️ THE CHAIN'S KEY RULES ARE ENFORCED HERE, not left to it, because its answer arrives too late
- * to help: a body with the wrong keys is ORDERED and FINED 100, not refused. Exactly one
- * BLS12-381-G1 and one Ed25519, each at label "", a starting credit >= 1, and both keys carrying a
- * proof of possession from their holder.
- */
-export async function signCreateIdentity(deps, params) {
-    const credit = parseInitialCredit(params.initialCredit);
-    if (!credit.ok)
-        return { kind: "partial", what: "initialCredit", cause: credit.error };
-    const keys = Array.isArray(params.keys) ? params.keys : [];
-    const bls = keys.filter((k) => k.keyType === "BLS12-381-G1");
-    const ed = keys.filter((k) => k.keyType === "Ed25519");
-    if (bls.length !== 1 || ed.length !== 1 || keys.length !== 2)
-        return {
-            kind: "partial",
-            what: "keys",
-            cause: "exactly one BLS12-381-G1 and one Ed25519 are required, each at the default label. " +
-                "A body without both is ordered and FINED 100 rather than refused, so it is refused here.",
-        };
-    if (keys.some((k) => String(k.keyLabel ?? "") !== ""))
-        return {
-            kind: "partial",
-            what: "keys",
-            cause: "both keys must be at the default (empty) label — a non-empty label is refused here rather than fined on-chain",
-        };
-    // Empty-PoP refusal: this agent signs for NO key it does not hold (T-03-01). Named by field, never bytes.
-    const empty = keys.findIndex((k) => !k.popSignature || String(k.popSignature).length === 0);
-    if (empty !== -1)
-        return {
-            kind: "partial",
-            what: `keys.${empty}.popSignature`,
-            cause: "each key needs a proof of possession from its holder — this agent signs for no key it does not hold",
-        };
-    // Hex-decode each key, refusing (naming the PATH) on non-hex/odd-length input (T-03-07). The
-    // refusal names the field, never echoes the bytes.
-    const decoded = [];
-    for (let i = 0; i < keys.length; i++) {
-        const k = keys[i];
-        try {
-            const publicKey = hexToBytes(String(k.publicKey ?? ""));
-            // Empty-publicKey refusal: zero bytes, not an error — refused for free rather than fined.
-            if (publicKey.length === 0)
-                return { kind: "partial", what: `keys.${i}.publicKey`, cause: "a key is needed" };
-            const popSig = hexToBytes(String(k.popSignature ?? ""));
-            decoded.push({ keyType: k.keyType, publicKey, keyLabel: String(k.keyLabel ?? ""), popSig });
-        }
-        catch (e) {
-            return { kind: "partial", what: `keys.${i}`, cause: e instanceof Error ? e.message : String(e) };
-        }
-    }
-    const tip = await tipOrUnreachable(deps);
-    if (typeof tip !== "number")
-        return tip;
-    const expiresAtRound = tip + (deps.ttlOffset ?? DEFAULT_TTL_OFFSET);
-    const body = createIdentityBody(createIdentityInner(deps.identity, credit.value, decoded, true));
-    return composeIdentityTx(deps, {
-        ledgerId: LEDGER.identity,
-        body,
-        ttlRound: expiresAtRound,
-        signedAtRound: tip,
-        verb: "create_identity",
-        fields: { initialCredit: credit.value.toString() },
-    });
-}
-/**
- * Delete the identity this agent signs as. SELF-DELETION ONLY (Pitfall 5): `confirmName` must match
- * `deps.identity`, else the chain would fine a deletion naming another identity.
- */
-export async function signDeleteIdentity(deps, params) {
-    const confirmName = String(params.confirmName ?? "").trim();
-    if (confirmName !== deps.identity)
-        return {
-            kind: "partial",
-            what: "confirmName",
-            cause: `this deletes THIS identity and nothing else — the chain fines a deletion naming another. ` +
-                `Pass "${deps.identity}" to mean it.`,
-        };
-    const tip = await tipOrUnreachable(deps);
-    if (typeof tip !== "number")
-        return tip;
-    const expiresAtRound = tip + (deps.ttlOffset ?? DEFAULT_TTL_OFFSET);
-    return composeIdentityTx(deps, {
-        ledgerId: LEDGER.identity,
-        body: deleteIdentityBody(deps.identity),
-        ttlRound: expiresAtRound,
-        signedAtRound: tip,
-        verb: "delete_identity",
-        fields: { target: deps.identity },
-    });
-}
-/** Add/replace share one shape, differing only by verb tag and encoder. The SDK encoders keep them
- *  distinct (a shared hand-rolled digest would make an AddKey proof valid for a ReplaceKey). */
-async function signKeyOp(deps, verb, p) {
-    const keyType = String(p.keyType ?? "").trim();
-    const keyLabel = String(p.keyLabel ?? "");
-    let publicKey, popSignature;
-    try {
-        publicKey = hexToBytes(String(p.publicKey ?? ""));
-    }
-    catch (e) {
-        return { kind: "partial", what: "publicKey", cause: e instanceof Error ? e.message : String(e) };
-    }
-    // Empty-publicKey refusal: `hexToBytes("")` is zero bytes, not an error — a body carrying an
-    // empty key would be ordered and fined on-chain, so it is refused for free before anything is
-    // signed (reference: admin.ts signKeyOp refuses `publicKey.length === 0`).
-    if (publicKey.length === 0)
-        return { kind: "partial", what: "publicKey", cause: "a key is needed" };
-    try {
-        popSignature = hexToBytes(String(p.popSignature ?? ""));
-    }
-    catch (e) {
-        return { kind: "partial", what: "popSignature", cause: e instanceof Error ? e.message : String(e) };
-    }
-    // Empty-PoP refusal: this agent signs for NO key it does not hold.
-    if (popSignature.length === 0)
-        return {
-            kind: "partial",
-            what: "popSignature",
-            cause: "the key's holder must prove possession — this agent cannot sign for a key it does not hold",
-        };
-    const tip = await tipOrUnreachable(deps);
-    if (typeof tip !== "number")
-        return tip;
-    const expiresAtRound = tip + (deps.ttlOffset ?? DEFAULT_TTL_OFFSET);
-    const args = { publicKey, keyType, keyLabel, popSignature };
-    return composeIdentityTx(deps, {
-        ledgerId: LEDGER.identity,
-        body: verb === "add_key" ? addKeyBody(args) : replaceKeyBody(args),
-        ttlRound: expiresAtRound,
-        signedAtRound: tip,
-        verb,
-        fields: { keyType, keyLabel },
-    });
-}
-export const signAddKey = (deps, p) => signKeyOp(deps, "add_key", p);
-export const signReplaceKey = (deps, p) => signKeyOp(deps, "replace_key", p);
-/**
- * Remove one of this identity's own keys. ⚠️ THE CHAIN WILL NOT STOP YOU LOCKING YOURSELF OUT — its
- * only guard refuses a committee member deleting its default consensus key.
- */
-export async function signDeleteKey(deps, p) {
-    const keyType = String(p.keyType ?? "").trim();
-    if (keyType.length === 0)
-        return { kind: "partial", what: "keyType", cause: "which key?" };
-    const keyLabel = String(p.keyLabel ?? "");
-    const tip = await tipOrUnreachable(deps);
-    if (typeof tip !== "number")
-        return tip;
-    const expiresAtRound = tip + (deps.ttlOffset ?? DEFAULT_TTL_OFFSET);
-    return composeIdentityTx(deps, {
-        ledgerId: LEDGER.identity,
-        body: deleteKeyBody({ keyType, keyLabel }),
-        ttlRound: expiresAtRound,
-        signedAtRound: tip,
-        verb: "delete_key",
-        fields: { keyType, keyLabel },
-    });
-}
-//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/read.d.ts

@@ -1,252 +0,0 @@
-import type { ChannelOwner, ChannelTerms, TransactionObservation } from "@mcsherrylabs/evolver-client";
-import type { ToolResult } from "./result.js";
-/** One row of the chain's recent-transaction feed, as the client returns it. */
-export interface FeedTx {
-    readonly txId: string;
-    readonly roundNum: number;
-    readonly ledgerId: string;
-    readonly txType: string;
-    readonly sender: string;
-    readonly details: ReadonlyArray<{
-        label: string;
-        value: string;
-    }>;
-}
-/** Only what this module needs from a chain. `NodeClient` satisfies it structurally, which is what
- *  lets the rules be exercised without a node — a rule only checked against a live chain is a rule
- *  that drifts. */
-export interface ChainReads {
-    currentRound(): Promise<number>;
-    /** All three heights. Required, not optional: an optional one would let a build that forgot
-     *  it silently report only the held tip, which is the exact defect this closes — a node can
-     *  HOLD 8147 and have applied only 5253, and every committed-state read answers as of the
-     *  latter. */
-    nodeStatus(): Promise<{
-        nodeId: string;
-        blockHeight: number;
-        appliedRound: number | null;
-        heardRound: number;
-        /** #9 — `true` only from a node that refuses any tx lacking its sender's AUTHORIZE auth.
-         *  Absent (older SDK/node), `null` or `false` all mean unsupported; never defaulted. */
-        senderAuthorizationRequired?: boolean | null;
-    }>;
-    getIdentity(name: string): Promise<{
-        nodeId: string;
-        balance: bigint;
-    } | null>;
-    getGroup(name: string): Promise<{
-        ledgerId: string;
-        members: string[];
-    } | null>;
-    recentTransactions(limit?: number, offset?: number): Promise<FeedTx[]>;
-    getIdentityKeys(name: string): Promise<Array<{
-        nodeId: string;
-        keyType: string;
-        label: string;
-        publicKeyHex: string;
-    }> | null>;
-    getChannelTerms(ledgerId: string): Promise<ChannelTerms>;
-    listGroups(): Promise<Array<{
-        ledgerId: string;
-        memberCount: number;
-        owner: string;
-    }>>;
-    /** SDK 0.21+ page contract. Old installed SDKs fail closed, never fall back to scans. */
-    searchPrincipalPage?(q: string, options?: SearchOptions): Promise<SearchPage>;
-    /** SDK 0.21+ / node #101. Missing API refuses, never falls back to a feed scan. */
-    getTransaction?(txId: string): Promise<TransactionObservation>;
-    /** #10 — one explorer page each. Optional so a client without them refuses, never scans. */
-    listLedgerOwners?(limit?: number, offset?: number): Promise<{
-        owners: Array<{
-            ledgerId: string;
-            ownerNodeId: string;
-        }>;
-        total: number;
-    }>;
-    getKeys?(limit?: number, offset?: number): Promise<Array<{
-        nodeId: string;
-        keyType: string;
-        label: string;
-        publicKeyHex: string;
-    }>>;
-}
-export interface SearchOptions {
-    mode?: "prefix" | "contains";
-    kind?: "all" | "identity" | "group" | "validator";
-    limit?: number;
-    offset?: number;
-}
-export interface SearchPage {
-    results: Array<{
-        type: "identity" | "group";
-        nodeId: string;
-        summary: string;
-        balance: bigint | null;
-        memberCount: number | null;
-        owner: string | null;
-        validator: boolean;
-        weight: number | null;
-    }>;
-    total: number;
-    limit: number;
-    offset: number;
-    truncated: boolean;
-    mode: "prefix" | "contains";
-    kind: "all" | "identity" | "group" | "validator";
-    stateRound: number;
-}
-/** Small on purpose: the reader is a model, and a page it did not need is context it cannot get
- *  back. 200 is the node's own clamp, so the tool never asks for what it cannot get. */
-export declare const DEFAULT_LIMIT = 20;
-export declare const MAX_LIMIT = 200;
-/** The node's clamp for the ledger-owners and keys explorer pages (`ExplorerApiHandler`). */
-export declare const INVENTORY_MAX_LIMIT = 100;
-/** The node parses `offset` as a JVM Int and reads anything larger as 0 — page one, silently. */
-export declare const MAX_OFFSET = 2147483647;
-/** Exact page arguments, or why not. Only an ABSENT value takes the default; a present one must
- *  already be an in-range safe integer. Nothing is clamped, coerced or rounded: the node would
- *  clamp silently, and an answer to a page nobody asked for reads as the page they did. */
-export declare function pageArgs(limit: unknown, offset: unknown, maxLimit: number): {
-    limit: number;
-    offset: number;
-} | string;
-/** The three heights a node actually has, and what each one answers.
- *
- *  ⚠️ `height` ALONE IS THE TRAP THIS REPLACES. It used to return one number — the held tip —
- *  and a model reading it concluded the node was current. A processing node answers every
- *  committed-state read AS OF `applied`, so a name created above that round reads `not_found`
- *  while the node holds the block containing it. */
-export interface NodeHeights {
-    readonly held: number;
-    readonly applied: number | null;
-    readonly heard: number;
-}
-export interface HeightReport extends NodeHeights {
-    /** held - applied, or null when this is not a processing node (nothing to be behind). */
-    readonly applyLag: number | null;
-    /** heard - held: how far the world is known to be ahead of what we hold. */
-    readonly syncLag: number;
-    readonly note: string;
-}
-export declare function chainHeight(reads: ChainReads): Promise<ToolResult<HeightReport>>;
-export declare function transaction(reads: Pick<ChainReads, "getTransaction">, txId: unknown): Promise<ToolResult<TransactionObservation>>;
-/** One newest-first page of the explorer feed at the exact validated offset. A display tail, never
- *  a lookup: an empty page says nothing about whether a transaction exists. */
-export declare function recent(reads: ChainReads, limit?: unknown, offset?: unknown): Promise<ToolResult<{
-    transactions: FeedTx[];
-    limit: number;
-    offset: number;
-}>>;
-/** One page of the chain-wide ledger-owner listing, exactly as the node orders and reports it.
- *  `ownerNodeId` carries no identity/group kind on this row, so none is invented here.
- *
- *  ⚠️ NO TOTAL. SDK 0.21.0 substitutes `0` for an absent node total, so a zero cannot be told from
- *  a missing field; a count that may be fabricated is not reported. */
-export declare function ledgerOwnersPage(reads: ChainReads, limit?: unknown, offset?: unknown): Promise<ToolResult<{
-    owners: Array<{
-        ledgerId: string;
-        ownerNodeId: string;
-    }>;
-    limit: number;
-    offset: number;
-}>>;
-/** One page of the chain-wide registered PUBLIC key metadata. Never the route to one identity's
- *  keys — that is `keys(name)`, a direct read. The SDK returns no total for this page. */
-export declare function chainKeysPage(reads: ChainReads, limit?: unknown, offset?: unknown): Promise<ToolResult<{
-    keys: Array<{
-        nodeId: string;
-        keyType: string;
-        label: string;
-        publicKeyHex: string;
-    }>;
-    limit: number;
-    offset: number;
-}>>;
-/** The one read with a DEFINITIVE negative: the chain answered and has no such identity. The
- *  height it answered at travels with it, so a lagging node is visible rather than confident.
- *
- *  ⚠️ AND A NEGATIVE IS CHECKED AGAINST THE OTHER KIND BEFORE IT IS REPORTED. `/api/identity`
- *  answers only for identities, so a GROUP name 404s there — and reporting that as `not_found`
- *  tells a model "no such thing" about a name the chain holds. A name is one kind or the other
- *  (the two share one namespace, with uniqueness enforced across both), so the second read
- *  settles it. */
-export declare function identity(reads: ChainReads, name: string): Promise<ToolResult<{
-    nodeId: string;
-    balance: bigint;
-}>>;
-/** The mirror read: one group and who is in it.
- *
- *  ⚠️ IT REPORTS THE OTHER KIND TOO, in the other direction. Asking about an identity by this
- *  verb is the same mistake and deserves the same answer — otherwise closing half the gap would
- *  leave a model told "no such group" about an identity it can see elsewhere.
- *
- *  ⚠️ AN EMPTY MEMBER LIST IS AN ANSWER, NOT AN ABSENCE: a group exists before anyone is added to
- *  it, and `members: []` is what that looks like. The existence question is answered by the read
- *  returning at all. */
-export declare function group(reads: ChainReads, name: string): Promise<ToolResult<{
-    ledgerId: string;
-    members: string[];
-}>>;
-/** An identity's complete registered keys, read directly.
- *
- *  ⚠️ AN EMPTY LIST IS AN ANSWER AND NOT AN ABSENCE: an identity exists before it holds keys, and
- *  an empty set is what that looks like. `not_found` means the chain has no such identity. */
-export declare function keys(reads: ChainReads, identityName: string): Promise<ToolResult<{
-    identity: string;
-    keys: Array<{
-        keyType: string;
-        label: string;
-        publicKeyHex: string;
-    }>;
-    complete: boolean;
-    scanned: number;
-}>>;
-/** A channel's terms: who owns it, who may write, what a write costs, who holds the bodies.
- *
- *  ⚠️ `owners: []` IS AN ANSWER AND IT IS NOT AN ERROR. A channel is not a registered entity —
- *  an unclaimed ledger id simply has no owner and no terms, and is therefore open to everyone.
- *  So this never reports `not_found`: it reports `claimed: false`, which is the fact. */
-export declare function channelTerms(reads: ChainReads, ledgerId: string): Promise<ToolResult<{
-    ledgerId: string;
-    claimed: boolean;
-    owners: ChannelOwner[];
-    toll: {
-        amount: string;
-        recipient: string;
-    } | null;
-    da: {
-        group: string;
-        thresholdM: number;
-    } | null;
-    writePolicy: string;
-}>>;
-/** Every group on the chain, each with its owner.
- *
- *  ⚠️ THIS IS THE ONLY READ THAT CARRIES AN OWNER. Reading one group by name returns its members
- *  and NOT who owns it, so "who owns this group?" is answered here or nowhere. The node returns
- *  the whole listing, so the slice below is local and `total` says what it was sliced from. */
-export declare function groups(reads: ChainReads, limit?: number, offset?: number): Promise<ToolResult<{
-    groups: Array<{
-        ledgerId: string;
-        memberCount: number;
-        owner: string;
-    }>;
-    total: number;
-    limit: number;
-    offset: number;
-}>>;
-/** One bounded node page. Total is the NODE's filtered count, not an array length. */
-export declare function searchPrincipals(reads: ChainReads, q: string, limit?: number, offset?: number, mode?: SearchOptions["mode"], kind?: SearchOptions["kind"]): Promise<ToolResult<{
-    query: string;
-    matches: Array<Omit<SearchPage["results"][number], "balance"> & {
-        balance: string | null;
-    }>;
-    total: number;
-    limit: number;
-    offset: number;
-    truncated: boolean;
-    mode: string;
-    kind: string;
-    stateRound: number;
-}>>;
-//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

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