keri-ts 0.4.0 → 0.6.0

package/esm/keri/src/core/logger.js

@@ -1,3 +1,4 @@
+/** Supported logger severity names in ascending verbosity order. */
 export const LOG_LEVELS = ["debug", "info", "warn", "error"];
 const LEVEL_PRIORITY = {
     debug: 10,
@@ -9,12 +10,15 @@ let currentLogLevel = "warn";
 function shouldLog(level) {
     return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[currentLogLevel];
 }
+/** Set the process-local minimum log level for the built-in console logger. */
 export function setLogLevel(level) {
     currentLogLevel = level;
 }
+/** Read the current process-local minimum log level. */
 export function getLogLevel() {
     return currentLogLevel;
 }
+/** Default logger that forwards to `console.*` with level gating. */
 export const consoleLogger = {
     debug: (message, ...meta) => {
         if (shouldLog("debug")) {
@@ -37,6 +41,7 @@ export const consoleLogger = {
         }
     },
 };
+/** Logger implementation that discards all messages. */
 export const noopLogger = {
     debug: () => { },
     info: () => { },

package/esm/keri/src/core/mailbox-topics.js

@@ -0,0 +1,30 @@
+/**
+ * Shared mailbox topic and cursor types.
+ *
+ * These types keep the mailbox query and streaming contract explicit:
+ * configured topics are human-facing lists, while runtime work uses cursor maps
+ * keyed by topic name and storing the next wanted mailbox index.
+ */
+/** Raw delegated event mailbox topic used for delegation approval flows. */
+export const DELEGATE_MAILBOX_TOPIC = "/delegate";
+/** Peer OOBI request mailbox topic used by KERIpy `/oobis` EXNs. */
+export const OOBI_MAILBOX_TOPIC = "/oobi";
+/** Core receipt mailbox topic used for witness/controller correspondence. */
+export const RECEIPT_MAILBOX_TOPIC = "/receipt";
+/** Core replay mailbox topic used for witness-backed query/log replay. */
+export const REPLAY_MAILBOX_TOPIC = "/replay";
+/** Core reply mailbox topic used for query reply correspondence such as `/ksn`. */
+export const REPLY_MAILBOX_TOPIC = "/reply";
+export function normalizeMbxTopicCursor(value) {
+    if (Array.isArray(value)) {
+        return Object.fromEntries(value
+            .filter((topic) => typeof topic === "string")
+            .map((topic) => [topic, 0]));
+    }
+    if (typeof value !== "object" || value === null) {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(value)
+        .filter(([topic]) => typeof topic === "string")
+        .map(([topic, idx]) => [topic, typeof idx === "number" ? idx : Number(idx) || 0]));
+}

package/esm/keri/src/core/protocol-eventing.js

@@ -0,0 +1,450 @@
+import { DigDex, DIGEST_CODES, Ilks, Kinds, NonceDex, Noncer, parseMatter, PREFIX_CODES, SerderKERI, Tholder, Vrsn_1_0, Vrsn_2_0, } from "../../../cesr/mod.js";
+import { makeNowIso8601 } from "../time/mod.js";
+import { ValidationError } from "./errors.js";
+import { KeyStateRecord, StateEERecord } from "./records.js";
+import { deriveRotatedWitnessSet, hasUniqueWitnesses } from "./witnesses.js";
+const MAX_INTIVE_THRESHOLD = 0xffff;
+function resolveVersionOptions(options, fallback = Vrsn_1_0) {
+    const pvrsn = options?.pvrsn ?? options?.version ?? fallback;
+    return {
+        pvrsn,
+        gvrsn: options?.gvrsn ?? (pvrsn.major >= 2 ? Vrsn_2_0 : null),
+        kind: options?.kind ?? Kinds.json,
+    };
+}
+function defaultThreshold(count, min) {
+    return Math.max(min, Math.ceil(count / 2)).toString(16);
+}
+function ample(count, faults, weak = true) {
+    const n = Math.max(0, count);
+    if (faults === undefined) {
+        const f1 = Math.max(1, Math.floor(Math.max(0, n - 1) / 3));
+        const f2 = Math.max(1, Math.ceil(Math.max(0, n - 1) / 3));
+        if (weak) {
+            return Math.min(n, Math.ceil((n + f1 + 1) / 2), Math.ceil((n + f2 + 1) / 2));
+        }
+        return Math.min(n, Math.max(0, n - f1, Math.ceil((n + f1 + 1) / 2)));
+    }
+    const f = Math.max(0, faults);
+    const m1 = Math.ceil((n + f + 1) / 2);
+    const m2 = Math.max(0, n - f);
+    if (m2 < m1 && n > 0) {
+        throw new ValidationError(`Invalid faults ${faults} for witness count ${count}.`);
+    }
+    return weak ? Math.min(n, m1, m2) : Math.min(n, Math.max(m1, m2));
+}
+function cloneDataList(data) {
+    return [...(data ?? [])];
+}
+function cloneStringList(values) {
+    return [...(values ?? [])];
+}
+function coerceWholeNumber(value, label) {
+    if (typeof value === "number") {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new ValidationError(`Invalid ${label} ${value}.`);
+        }
+        return value;
+    }
+    if (!/^[0-9a-f]+$/i.test(value)) {
+        throw new ValidationError(`Invalid ${label} ${value}.`);
+    }
+    return Number.parseInt(value, 16);
+}
+function validateThreshold(value, count, label, minimum) {
+    const tholder = new Tholder({
+        sith: value ?? defaultThreshold(count, minimum),
+    });
+    if (tholder.num !== null && tholder.num < BigInt(minimum)) {
+        throw new ValidationError(`Invalid ${label} threshold ${String(value ?? "")}.`);
+    }
+    if (tholder.size > count) {
+        throw new ValidationError(`Invalid ${label} threshold for ${count} keys.`);
+    }
+    return tholder;
+}
+function encodeThreshold(tholder, intive = false) {
+    if (intive
+        && tholder.num !== null
+        && tholder.num <= BigInt(MAX_INTIVE_THRESHOLD)) {
+        return Number(tholder.num);
+    }
+    return tholder.sith;
+}
+function encodeCount(value, intive = false) {
+    return intive && value <= MAX_INTIVE_THRESHOLD ? value : value.toString(16);
+}
+function resolveInceptiveSaidCodes(ked, explicitPrefixCode) {
+    const saids = {
+        d: DigDex.Blake3_256,
+        i: DigDex.Blake3_256,
+    };
+    if (explicitPrefixCode && PREFIX_CODES.has(explicitPrefixCode)) {
+        saids.i = explicitPrefixCode;
+        return saids;
+    }
+    if (typeof ked.i === "string" && ked.i.length > 0) {
+        try {
+            saids.i = parseMatter(new TextEncoder().encode(ked.i), "txt").code;
+        }
+        catch {
+            // Keep the default digest code when the provided prefix is not parseable.
+        }
+    }
+    return saids;
+}
+export function state(pre, sn, pig, dig, fn, eilk, keys, eevt, { stamp, sith, ndigs, nsith, toad, wits, cnfg, dpre, version, pvrsn, intive = false, } = {}) {
+    const currentVersion = pvrsn ?? version ?? Vrsn_1_0;
+    const snNum = coerceWholeNumber(sn, "sn");
+    const fnNum = coerceWholeNumber(fn, "fn");
+    if (!(new Set([Ilks.icp, Ilks.rot, Ilks.ixn, Ilks.dip, Ilks.drt])).has(eilk)) {
+        throw new ValidationError(`Invalid event type et=${eilk} in key state.`);
+    }
+    const actualStamp = stamp ?? makeNowIso8601();
+    const currentTholder = validateThreshold(sith, keys.length, "current", 1);
+    const nextDigs = cloneStringList(ndigs);
+    const nextTholder = validateThreshold(nsith, nextDigs.length, "next", 0);
+    const witnessList = cloneStringList(wits);
+    if (!hasUniqueWitnesses(witnessList)) {
+        throw new ValidationError(`Invalid wits = ${witnessList}, has duplicates.`);
+    }
+    const resolvedToad = toad === undefined
+        ? (witnessList.length === 0
+            ? 0
+            : Math.max(1, Math.ceil(witnessList.length / 2)))
+        : coerceWholeNumber(toad, "toad");
+    if (witnessList.length === 0 && resolvedToad !== 0) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${witnessList}.`);
+    }
+    if (witnessList.length > 0
+        && (resolvedToad < 1 || resolvedToad > witnessList.length)) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${witnessList}.`);
+    }
+    const latestEst = StateEERecord.fromDict(eevt);
+    if (!latestEst.s || !latestEst.d) {
+        throw new ValidationError(`Missing or invalid latest est event = ${String(eevt)} for key state.`);
+    }
+    const cuts = cloneStringList(latestEst.br);
+    const adds = cloneStringList(latestEst.ba);
+    if (!hasUniqueWitnesses(cuts)) {
+        throw new ValidationError(`Invalid cuts = ${cuts}, has duplicates.`);
+    }
+    if (!hasUniqueWitnesses(adds)) {
+        throw new ValidationError(`Invalid adds = ${adds}, has duplicates.`);
+    }
+    if (cuts.some((cut) => adds.includes(cut))) {
+        throw new ValidationError(`Intersecting cuts = ${cuts} and adds = ${adds}.`);
+    }
+    return new KeyStateRecord({
+        vn: [currentVersion.major, currentVersion.minor],
+        i: pre,
+        s: snNum.toString(16),
+        p: pig,
+        d: dig,
+        f: fnNum.toString(16),
+        dt: actualStamp,
+        et: eilk,
+        kt: encodeThreshold(currentTholder, intive),
+        k: [...keys],
+        nt: encodeThreshold(nextTholder, intive),
+        n: nextDigs,
+        bt: encodeCount(resolvedToad, intive).toString(),
+        b: witnessList,
+        c: cloneStringList(cnfg),
+        ee: new StateEERecord({
+            s: latestEst.s,
+            d: latestEst.d,
+            br: cuts,
+            ba: adds,
+        }),
+        di: dpre ?? "",
+    });
+}
+export function incept(keys, { isith, ndigs, nsith, toad, wits, cnfg, data, code, delpre, intive = false, ...versions } = {}) {
+    const resolved = resolveVersionOptions(versions);
+    const nextDigs = cloneStringList(ndigs);
+    const witnessList = cloneStringList(wits);
+    if (!hasUniqueWitnesses(witnessList)) {
+        throw new ValidationError(`Invalid wits = ${witnessList}, has duplicates.`);
+    }
+    const tholder = validateThreshold(isith, keys.length, "current", 1);
+    const ntholder = validateThreshold(nsith, nextDigs.length, "next", 0);
+    const resolvedToad = toad === undefined
+        ? (witnessList.length === 0 ? 0 : ample(witnessList.length))
+        : coerceWholeNumber(toad, "toad");
+    if (witnessList.length === 0 && resolvedToad !== 0) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${witnessList}`);
+    }
+    if (witnessList.length > 0
+        && (resolvedToad < 1 || resolvedToad > witnessList.length)) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${witnessList}`);
+    }
+    const sad = {
+        t: delpre ? Ilks.dip : Ilks.icp,
+        d: "",
+        i: "",
+        s: "0",
+        kt: encodeThreshold(tholder, intive),
+        k: [...keys],
+        nt: encodeThreshold(ntholder, intive),
+        n: nextDigs,
+        bt: encodeCount(resolvedToad, intive),
+        b: witnessList,
+        c: cloneStringList(cnfg),
+        a: cloneDataList(data),
+    };
+    if (delpre) {
+        sad.di = delpre;
+    }
+    else if ((!code || !DIGEST_CODES.has(code)) && keys.length === 1) {
+        sad.i = keys[0];
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+        saids: resolveInceptiveSaidCodes(sad, code),
+    });
+}
+export function delcept(keys, delpre, options = {}) {
+    return incept(keys, { ...options, delpre });
+}
+export function rotate(pre, keys, dig, { ilk = Ilks.rot, sn = 1, isith, ndigs, nsith, toad, wits, cuts, adds, cnfg, data, intive = false, ...versions } = {}) {
+    const resolved = resolveVersionOptions(versions);
+    if (!(new Set([Ilks.rot, Ilks.drt])).has(ilk)) {
+        throw new ValidationError(`Invalid ilk=${ilk} for rot or drt.`);
+    }
+    const snNum = coerceWholeNumber(sn, "sn");
+    if (snNum < 1) {
+        throw new ValidationError(`Invalid sn = 0x${snNum.toString(16)} for rot or drt.`);
+    }
+    const currentTholder = validateThreshold(isith, keys.length, "current", 1);
+    const nextDigs = cloneStringList(ndigs);
+    const nextTholder = validateThreshold(nsith, nextDigs.length, "next", 0);
+    const currentWits = cloneStringList(wits);
+    if (!hasUniqueWitnesses(currentWits)) {
+        throw new ValidationError(`Invalid wits = ${currentWits}, has duplicates.`);
+    }
+    const cutsList = cloneStringList(cuts);
+    const addsList = cloneStringList(adds);
+    const derived = deriveRotatedWitnessSet(currentWits, cutsList, addsList);
+    if (derived.kind === "reject") {
+        throw new ValidationError(`Invalid witness cut/add combination: ${derived.reason}.`);
+    }
+    const nextWits = derived.value.wits;
+    const resolvedToad = toad === undefined
+        ? (nextWits.length === 0 ? 0 : ample(nextWits.length))
+        : coerceWholeNumber(toad, "toad");
+    if (nextWits.length === 0 && resolvedToad !== 0) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${nextWits}`);
+    }
+    if (nextWits.length > 0 && (resolvedToad < 1 || resolvedToad > nextWits.length)) {
+        throw new ValidationError(`Invalid toad = ${resolvedToad} for wits = ${nextWits}`);
+    }
+    const sad = {
+        t: ilk,
+        d: "",
+        i: pre,
+        s: snNum.toString(16),
+        p: dig,
+        kt: encodeThreshold(currentTholder, intive),
+        k: [...keys],
+        nt: encodeThreshold(nextTholder, intive),
+        n: nextDigs,
+        bt: encodeCount(resolvedToad, intive),
+        br: cutsList,
+        ba: addsList,
+    };
+    if (resolved.pvrsn.major >= 2) {
+        sad.c = cloneStringList(cnfg);
+        sad.a = cloneDataList(data);
+    }
+    else {
+        sad.a = cloneDataList(data);
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function deltate(pre, keys, dig, options = {}) {
+    return rotate(pre, keys, dig, { ...options, ilk: Ilks.drt });
+}
+export function interact(pre, dig, sn = 1, data = [], versions = {}) {
+    const resolved = resolveVersionOptions(versions);
+    const snNum = coerceWholeNumber(sn, "sn");
+    if (snNum < 1) {
+        throw new ValidationError(`Invalid sn = 0x${snNum.toString(16)} for ixn.`);
+    }
+    return new SerderKERI({
+        sad: {
+            t: Ilks.ixn,
+            d: "",
+            i: pre,
+            s: snNum.toString(16),
+            p: dig,
+            a: cloneDataList(data),
+        },
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function receipt(pre, sn, said, versions = {}) {
+    const resolved = resolveVersionOptions(versions);
+    const snNum = coerceWholeNumber(sn, "sn");
+    return new SerderKERI({
+        sad: {
+            t: Ilks.rct,
+            d: said,
+            i: pre,
+            s: snNum.toString(16),
+        },
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function query(route = "", queryData = {}, stampOrOptions = {}) {
+    const options = typeof stampOrOptions === "string"
+        ? { stamp: stampOrOptions }
+        : stampOrOptions;
+    const resolved = resolveVersionOptions(options);
+    const sad = {
+        t: Ilks.qry,
+        d: "",
+        dt: options.stamp ?? makeNowIso8601(),
+        r: route,
+        rr: options.replyRoute ?? "",
+        q: { ...queryData },
+    };
+    if (resolved.pvrsn.major >= 2) {
+        sad.i = options.pre ?? "";
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function reply(route = "", data = {}, stampOrOptions = {}) {
+    const options = typeof stampOrOptions === "string"
+        ? { stamp: stampOrOptions }
+        : stampOrOptions;
+    const resolved = resolveVersionOptions(options);
+    const sad = {
+        t: Ilks.rpy,
+        d: "",
+        dt: options.stamp ?? makeNowIso8601(),
+        r: route,
+        a: { ...data },
+    };
+    if (resolved.pvrsn.major >= 2) {
+        sad.i = options.pre ?? "";
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function prod(route = "", queryData = {}, stampOrOptions = {}) {
+    const options = typeof stampOrOptions === "string"
+        ? { stamp: stampOrOptions }
+        : stampOrOptions;
+    const resolved = resolveVersionOptions(options);
+    const sad = {
+        t: Ilks.pro,
+        d: "",
+        dt: options.stamp ?? makeNowIso8601(),
+        r: route,
+        rr: options.replyRoute ?? "",
+        q: { ...queryData },
+    };
+    if (resolved.pvrsn.major >= 2) {
+        sad.i = options.pre ?? "";
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function bare(route = "", data = {}, stampOrOptions = {}) {
+    const options = typeof stampOrOptions === "string"
+        ? { stamp: stampOrOptions }
+        : stampOrOptions;
+    const resolved = resolveVersionOptions(options);
+    const sad = {
+        t: Ilks.bar,
+        d: "",
+        dt: options.stamp ?? makeNowIso8601(),
+        r: route,
+        a: { ...data },
+    };
+    if (resolved.pvrsn.major >= 2) {
+        sad.i = options.pre ?? "";
+    }
+    return new SerderKERI({
+        sad,
+        pvrsn: resolved.pvrsn,
+        gvrsn: resolved.gvrsn ?? undefined,
+        kind: resolved.kind,
+        makify: true,
+    });
+}
+export function exchept(route = "", { sender = "", receiver = "", modifiers, attributes, nonce, stamp, pvrsn = Vrsn_2_0, gvrsn, kind = Kinds.json, } = {}) {
+    return new SerderKERI({
+        sad: {
+            t: Ilks.xip,
+            d: "",
+            u: nonce ?? new Noncer({
+                code: NonceDex.Salt_128,
+                raw: crypto.getRandomValues(new Uint8Array(16)),
+            }).qb64,
+            i: sender,
+            ri: receiver,
+            dt: stamp ?? makeNowIso8601(),
+            r: route,
+            q: { ...(modifiers ?? {}) },
+            a: { ...(attributes ?? {}) },
+        },
+        pvrsn,
+        gvrsn: gvrsn ?? Vrsn_2_0,
+        kind,
+        makify: true,
+    });
+}
+export function exchange(route = "", { sender = "", receiver = "", xid = "", prior = "", modifiers, attributes, stamp, pvrsn = Vrsn_2_0, gvrsn, kind = Kinds.json, } = {}) {
+    return new SerderKERI({
+        sad: {
+            t: Ilks.exn,
+            d: "",
+            i: sender,
+            ri: receiver,
+            x: xid,
+            p: prior,
+            dt: stamp ?? makeNowIso8601(),
+            r: route,
+            q: { ...(modifiers ?? {}) },
+            a: { ...(attributes ?? {}) },
+        },
+        pvrsn,
+        gvrsn: gvrsn ?? Vrsn_2_0,
+        kind,
+        makify: true,
+    });
+}

package/esm/keri/src/core/protocol-exchanging.js

@@ -0,0 +1,124 @@
+import { concatBytes, Counter, CtrDexV1, Ilks, Kinds, makePather, NonceDex, Noncer, Saider, Serder, SerderKERI, Vrsn_1_0, Vrsn_2_0, } from "../../../cesr/mod.js";
+import { makeNowIso8601 } from "../time/mod.js";
+import { serializeMessage as serializeExchangeMessage } from "./protocol-serialization.js";
+function resolveVersion(version, pvrsn, gvrsn, kind) {
+    const actualPvrsn = pvrsn ?? version ?? Vrsn_1_0;
+    return {
+        pvrsn: actualPvrsn,
+        gvrsn: gvrsn ?? (actualPvrsn.major >= 2 ? Vrsn_2_0 : null),
+        kind: kind ?? Kinds.json,
+    };
+}
+function encodePathedEmbeds(embeds) {
+    const e = {};
+    const groups = [];
+    for (const [label, msg] of Object.entries(embeds)) {
+        const serder = new Serder({ raw: msg });
+        e[label] = serder.ked;
+        const atc = msg.slice(serder.size);
+        if (atc.length === 0) {
+            continue;
+        }
+        const pathed = concatBytes(makePather(["e", label]).qb64b, atc);
+        const code = pathed.length / 4 < 4096
+            ? CtrDexV1.PathedMaterialCouples
+            : CtrDexV1.BigPathedMaterialCouples;
+        groups.push(concatBytes(new Counter({
+            code,
+            count: pathed.length / 4,
+            version: Vrsn_1_0,
+        }).qb64b, pathed));
+    }
+    if (Object.keys(e).length > 0) {
+        const saidified = Saider.saidify({ ...e, d: "" }, { label: "d" }).sad;
+        return {
+            e: saidified,
+            end: groups.length === 0 ? new Uint8Array() : concatBytes(...groups),
+        };
+    }
+    return { e, end: new Uint8Array() };
+}
+export function exincept(route = "", { sender = "", receiver = "", modifiers, attributes, nonce, stamp, pvrsn = Vrsn_2_0, gvrsn, kind = Kinds.json, } = {}) {
+    return new SerderKERI({
+        sad: {
+            t: Ilks.xip,
+            d: "",
+            u: nonce ?? new Noncer({
+                code: NonceDex.Salt_128,
+                raw: crypto.getRandomValues(new Uint8Array(16)),
+            }).qb64,
+            i: sender,
+            ri: receiver,
+            dt: stamp ?? makeNowIso8601(),
+            r: route,
+            q: { ...(modifiers ?? {}) },
+            a: { ...(attributes ?? {}) },
+        },
+        pvrsn,
+        gvrsn: gvrsn ?? Vrsn_2_0,
+        kind,
+        makify: true,
+    });
+}
+export function exchange(route, payload = {}, { sender, diger, recipient, date, stamp, dig = "", xid = "", modifiers, embeds, version, pvrsn, gvrsn, kind, }) {
+    const resolved = resolveVersion(version, pvrsn, gvrsn, kind);
+    const dt = date ?? stamp ?? makeNowIso8601();
+    const { e, end } = encodePathedEmbeds(embeds ?? {});
+    const actualModifiers = { ...(modifiers ?? {}) };
+    if (resolved.pvrsn.major === 1) {
+        const attrs = diger ? diger.qb64 : {
+            ...(recipient === undefined ? {} : { i: recipient }),
+            ...payload,
+        };
+        return [
+            new SerderKERI({
+                sad: {
+                    t: Ilks.exn,
+                    d: "",
+                    i: sender,
+                    rp: recipient ?? "",
+                    p: dig ?? "",
+                    dt,
+                    r: route,
+                    q: actualModifiers,
+                    a: attrs,
+                    e,
+                },
+                pvrsn: resolved.pvrsn,
+                gvrsn: resolved.gvrsn ?? undefined,
+                kind: resolved.kind,
+                makify: true,
+            }),
+            end,
+        ];
+    }
+    const attrs = {};
+    if (Object.keys(e).length > 0) {
+        attrs.e = e;
+    }
+    Object.assign(attrs, payload);
+    return [
+        new SerderKERI({
+            sad: {
+                t: Ilks.exn,
+                d: "",
+                i: sender,
+                ri: recipient ?? "",
+                x: xid ?? "",
+                p: dig ?? "",
+                dt,
+                r: route,
+                q: actualModifiers,
+                a: attrs,
+            },
+            pvrsn: resolved.pvrsn,
+            gvrsn: resolved.gvrsn ?? undefined,
+            kind: resolved.kind,
+            makify: true,
+        }),
+        end,
+    ];
+}
+export function serializeMessage(serder, { tsgs, cigars, pathed, pipelined = false, } = {}) {
+    return serializeExchangeMessage(serder, { tsgs, cigars, pathed, pipelined });
+}