@cello-protocol/daemon 0.0.226 → 0.0.227

package/dist/registration-manager.d.ts

@@ -1,94 +0,0 @@
-/**
- * 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

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