@cello-protocol/daemon 0.0.227 → 0.0.229

package/dist/registration-manager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * RegistrationManager — REG-001, ML-DSA keygen, DKG (daemon port).
+ *
+ * Ported from cello-client's RegistrationManager. Owns registration domain
+ * state (#registrationState, #mlDsaProvider). The only adaptation vs the client
+ * is the signaling seam: the client wrote directly to a raw persistent libp2p
+ * Stream, whereas the daemon's directory signaling lives behind SignalingManager.
+ * So RegistrationContext exposes `sendSignalingFrame` (→ SignalingManager.sendRaw,
+ * which CBOR/length-prefix-encodes internally) and `isSignalingConnected`, and a
+ * single daemon-owned inbound handler drives the pending dkg_ready/register
+ * resolvers (see DaemonRegistrationContext). The register() control flow is
+ * otherwise unchanged.
+ */
+import type { IThresholdSigner, MlDsaKeyProvider } from "@cello-protocol/crypto";
+import type { RegistrationState } from "@cello-protocol/protocol-types";
+import type { ConsortiumEndpoint } from "./directory-bootstrap.js";
+import type { DaemonRegistrationPersistence } from "./registration-persistence.js";
+import type { Logger } from "./types.js";
+import type { CelloNode } from "@cello-protocol/transport";
+import type { KeyProvider } from "@cello-protocol/crypto";
+/** Result of attempting to send a frame over the daemon's directory signaling stream. */
+export interface SignalingSendResult {
+    ok: boolean;
+    reason?: string;
+    /** DOD-SENDRAW-1 review F2: the transport's OperationResult carries the SPECIFIC cause here
+     *  (e.g. `Send failed: <exception text>`) while `reason` is the generic label — failure logs
+     *  must thread it through or the operator gets the label, not the cause. */
+    guidance?: string;
+}
+/**
+ * Narrow interface exposing only what RegistrationManager needs from the daemon.
+ * This avoids importing daemon internals and prevents circular dependencies.
+ */
+export interface RegistrationContext {
+    readonly keyProvider: KeyProvider;
+    readonly logger: Logger;
+    readonly persistence: DaemonRegistrationPersistence | null;
+    readonly mlDsaKeyFile: string | undefined;
+    /**
+     * The live directory-facing libp2p node FROST DKG opens streams on. May be
+     * null even when signaling reads connected (brief stream-death window) — the
+     * caller MUST null-check before constructing a NetworkDirectoryNode.
+     */
+    getNode(): CelloNode | null;
+    getMyPubkeyHex(): string | null;
+    setMyPubkeyHex(hex: string): void;
+    getDirectoryEndpoint(): {
+        peer_id: string;
+        multiaddrs: string[];
+    } | null;
+    /**
+     * DOD-MANIFEST-1/DKG-1: the consortium directory-node roster resolved from the verified
+     * manifest (one entry per resolved node), or NULL when NO consortium manifest is configured.
+     * `null` ⇒ single-node DKG against getDirectoryEndpoint() (M6/M7 back-compat). A non-null
+     * array ⇒ a consortium IS configured and the DKG must fan across exactly these nodes
+     * (T-of-N); an EMPTY array (manifest configured but the whole consortium unresolved) is NOT
+     * a fallback to single-node — it must REFUSE (the threshold gate). This null-vs-empty
+     * distinction is load-bearing (code-reviewer B1 / fallback-finder).
+     */
+    getConsortiumEndpoints(): ConsortiumEndpoint[] | null;
+    getThresholdSigner(): IThresholdSigner | undefined;
+    setThresholdSigner(signer: IThresholdSigner): void;
+    getMyPrimaryPubkey(): Uint8Array | null;
+    setMyPrimaryPubkey(pubkey: Uint8Array): void;
+    /** True when the directory signaling stream is connected and a send can be attempted. */
+    isSignalingConnected(): boolean;
+    /** Send a frame object over directory signaling (SignalingManager encodes it). */
+    sendSignalingFrame(frame: Record<string, unknown>): Promise<SignalingSendResult>;
+    setPendingDkgReadyResolve(resolve: ((frame: Record<string, unknown>) => void) | null): void;
+    setPendingRegisterResolve(resolve: ((frame: Record<string, unknown>) => void) | null): void;
+}
+/** M16: registering a broadcast channel. Both facts are fixed at registration and never change. */
+export interface ChannelRegistrationOpts {
+    channel: true;
+    /** 64 lowercase hex chars: the pubkey of the agent that administers the channel. */
+    adminPubkeyHex: string;
+}
+export declare class RegistrationManager {
+    #private;
+    constructor(ctx: RegistrationContext);
+    getRegistrationState(): RegistrationState | null;
+    setRegistrationState(state: RegistrationState | null): void;
+    getMlDsaProvider(): MlDsaKeyProvider | null;
+    setMlDsaProvider(provider: MlDsaKeyProvider | null): void;
+    /**
+     * Register this agent with the directory.
+     * REG-001: ML-DSA keygen → signaling stream → register_request → DKG → register_success.
+     */
+    register(phoneStub?: string, preAuthToken?: string, channelOpts?: ChannelRegistrationOpts): Promise<RegistrationState | {
+        error: string;
+        detail?: string;
+    }>;
+}
+//# sourceMappingURL=registration-manager.d.ts.map

package/dist/registration-manager.d.ts.map

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