@dxos/credentials 2.33.8 → 2.33.9-dev.0cfaca1b

package/src/greet/greeter.ts

@@ -2,8 +2,8 @@
 // Copyright 2019 DXOS.org
 //
 
-import assert from 'assert';
 import debug from 'debug';
+import assert from 'node:assert';
 
 import { ERR_EXTENSION_RESPONSE_FAILED } from '@dxos/mesh-protocol';
 import { PublicKeyLike, PublicKey } from '@dxos/protocols';
@@ -11,7 +11,7 @@ import { arraysEqual } from '@dxos/util';
 
 import { Keyring } from '../keys';
 import { getPartyCredentialMessageType } from '../party';
-import { PartyCredential, Message, KeyHint, Command, NotarizeResponse, WithTypeUrl, KeyType } from '../proto';
+import { PartyCredential, Message, Command, NotarizeResponse, WithTypeUrl } from '../proto';
 import { PeerId } from '../typedefs';
 import {
   ERR_GREET_INVALID_COMMAND,
@@ -28,7 +28,6 @@ import { Invitation, InvitationOnFinish, SecretProvider, SecretValidator } from
 const log = debug('dxos:halo:greet');
 
 export type PartyWriter = (params: Message[]) => Promise<Message[]>;
-export type HintProvider = (params: Message[]) => Promise<KeyHint[]>;
 
 /**
  * Reference Greeter that uses useable, single-use "invitations" to authenticate the invitee.
@@ -36,7 +35,6 @@ export type HintProvider = (params: Message[]) => Promise<KeyHint[]>;
 export class Greeter {
   _partyKey?: PublicKey;
   _partyWriter?: PartyWriter;
-  _hintProvider?: HintProvider;
   _invitations = new Map<string, Invitation>();
 
   /**
@@ -44,18 +42,19 @@ export class Greeter {
    * TODO(telackey): Does it make sense to separate out the Invitee functionality?
    * @param {PublicKeyLike} [partyKey] The publicKey of the target Party.
    * @param {function} [partyWriter] Callback function to write messages to the Party.
-   * @param {function} [hintProvider] Callback function to gather feed and key hints to give to the invitee.
    */
-  constructor (partyKey?: PublicKeyLike, partyWriter?: PartyWriter, hintProvider?: HintProvider) {
-    if (partyKey || partyWriter || hintProvider) {
+  constructor (
+    partyKey?: PublicKeyLike,
+    private readonly _genesisFeedKey?: PublicKey,
+    partyWriter?: PartyWriter
+  ) {
+    if (partyKey || partyWriter) {
       assert(partyKey);
       assert(partyWriter);
-      assert(hintProvider);
     }
 
     this._partyKey = partyKey ? PublicKey.from(partyKey) : undefined;
     this._partyWriter = partyWriter;
-    this._hintProvider = hintProvider;
   }
 
   /**
@@ -250,19 +249,16 @@ export class Greeter {
     log('Admitting new node after successful greeting.');
 
     assert(this._partyWriter);
-    assert(this._hintProvider);
 
     // Write the supplied messages to the target Party.
     const copies = await this._partyWriter(params);
 
-    // Retrieve the hinted feed and key info for the invitee.
-    const hints = await this._hintProvider(params);
-
     await invitation.notarize();
+    assert(this._genesisFeedKey);
     return {
       '@type': 'dxos.credentials.greet.NotarizeResponse',
       copies,
-      feedHints: hints.filter(hint => hint.type === KeyType.FEED).map(hint => hint.publicKey!)
+      genesisFeed: this._genesisFeedKey
     };
   }
 }

package/src/greet/greeting-command-plugin.ts

@@ -7,9 +7,9 @@
  *   and moved somewhere more abstract (RpcProtocolPlugin?).
  */
 
-import assert from 'assert';
 import debug from 'debug';
 import { EventEmitter } from 'events';
+import assert from 'node:assert';
 
 import { WithTypeUrl } from '@dxos/codec-protobuf';
 import { Extension, ERR_EXTENSION_RESPONSE_FAILED, Protocol } from '@dxos/mesh-protocol';

package/src/greet/greeting-message.ts

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
+import assert from 'node:assert';
 
 import { ClaimResponse, Command, SignedMessage, Message, WithTypeUrl } from '../proto';
 

package/src/greet/party-invitation-claim-handler.ts

@@ -2,8 +2,8 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
 import debug from 'debug';
+import assert from 'node:assert';
 
 import { ERR_EXTENSION_RESPONSE_FAILED } from '@dxos/mesh-protocol';
 

package/src/identity/identity-message-processor.ts

@@ -2,9 +2,9 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
 import debug from 'debug';
 import { EventEmitter } from 'events';
+import assert from 'node:assert';
 
 import { PublicKey, PublicKeyLike } from '@dxos/protocols';
 

package/src/identity/identity-message.ts

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
+import assert from 'node:assert';
 
 import { Keyring } from '../keys';
 import { unwrapEnvelopes, extractContents, unwrapMessage, wrapMessage } from '../party';

package/src/identity/seedphrase.ts

@@ -2,8 +2,8 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
 import { generateMnemonic, mnemonicToSeedSync } from 'bip39';
+import assert from 'node:assert';
 
 import { createKeyPair } from '@dxos/crypto';
 

package/src/keys/keyring-helpers.ts

@@ -6,8 +6,8 @@
 // TODO(burdon): Factor out helpers.
 //
 
-import assert from 'assert';
 import stableStringify from 'json-stable-stringify';
+import assert from 'node:assert';
 
 import { createKeyPair, KeyPair } from '@dxos/crypto';
 import { PublicKey, PublicKeyLike, PUBLIC_KEY_LENGTH, SECRET_KEY_LENGTH } from '@dxos/protocols';

package/src/keys/keyring.test.ts

@@ -4,8 +4,8 @@
 
 // DXOS testing browser.
 
-import assert from 'assert';
 import expect from 'expect';
+import assert from 'node:assert';
 
 import { createKeyPair, randomBytes, verify } from '@dxos/crypto';
 import { PublicKey } from '@dxos/protocols';

package/src/keys/keyring.ts

@@ -2,8 +2,8 @@
 // Copyright 2019 DXOS.org
 //
 
-import assert from 'assert';
 import memdown from 'memdown';
+import assert from 'node:assert';
 
 import { Event } from '@dxos/async';
 import {

package/src/keys/keystore.ts

@@ -2,12 +2,12 @@
 // Copyright 2019 DXOS.org
 //
 
-import assert from 'assert';
 import bufferJson from 'buffer-json-encoding';
 import debug from 'debug';
 import encode from 'encoding-down';
 import levelup, { LevelUp } from 'levelup';
 import memdown from 'memdown';
+import assert from 'node:assert';
 import toArray from 'stream-to-array';
 
 import { PublicKey } from '@dxos/protocols';

package/src/party/party-credential.ts

@@ -2,7 +2,7 @@
 // Copyright 2019 DXOS.org
 //
 
-import assert from 'assert';
+import assert from 'node:assert';
 
 import { randomBytes } from '@dxos/crypto';
 import { PublicKey, PublicKeyLike } from '@dxos/protocols';

package/src/party/party-invitation-manager.ts

@@ -2,8 +2,8 @@
 // Copyright 2020 DXOS.org
 //
 
-import assert from 'assert';
 import debug from 'debug';
+import assert from 'node:assert';
 
 import { PublicKey } from '@dxos/protocols';
 

package/src/party/party-state.ts

@@ -2,9 +2,9 @@
 // Copyright 2019 DXOS.org
 //
 
-import assert from 'assert';
 import debug from 'debug';
 import { EventEmitter } from 'events';
+import assert from 'node:assert';
 
 import { discoveryKey } from '@dxos/crypto';
 import { PublicKey, PublicKeyLike } from '@dxos/protocols';

package/src/proto/gen/dxos/credentials/auth.ts

@@ -8,26 +8,35 @@ import * as dxos_halo_keys from "../halo/keys";
 import * as google_protobuf from "../../google/protobuf";
 /**
  * The payload for a SignedMessage sent during handshake for replication authentication.
+ *
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/auth.proto}
  */
 export interface Auth {
     /**
      * The publicKey of the target Party for these credentials.
      */
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     /**
      * The publicKey of the authenticating Device.
      */
-    deviceKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    deviceKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     /**
      * The publicKey of the authenticating Identity.
      */
-    identityKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    identityKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     /**
      * The publicKey of the authenticating Identity.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     feedKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     /**
      * FeedAdmit message to the should be written to a control feed in case the `feedKey` is not admitted to the party.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     feedAdmit?: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
 }

package/src/proto/gen/dxos/credentials/greet.ts

@@ -8,13 +8,24 @@ import * as dxos_halo_keys from "../halo/keys";
 import * as google_protobuf from "../../google/protobuf";
 /**
  * A Greeter command.
+ *
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
  */
 export interface Command {
-    command?: Command.Type;
+    command: Command.Type;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     secret?: Uint8Array;
     params?: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>[];
 }
 export namespace Command {
+    /**
+     * Defined in:
+     *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+     */
     export enum Type {
         BEGIN = 0,
         HANDSHAKE = 1,
@@ -23,22 +34,42 @@ export namespace Command {
         CLAIM = 10
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+ */
 export interface BeginResponse {
     info?: Partial<Record<string, ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>>>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+ */
 export interface HandshakeResponse {
-    nonce?: Uint8Array;
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    nonce: Uint8Array;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+ */
 export interface NotarizeResponse {
     copies?: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>[];
-    feedHints?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>[];
+    genesisFeed: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+ */
 export interface KeyHint {
-    publicKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    type?: dxos_halo_keys.KeyType;
+    publicKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    type: dxos_halo_keys.KeyType;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/greet.proto}
+ */
 export interface ClaimResponse {
-    id?: Uint8Array;
-    rendezvousKey?: Uint8Array;
+    id: Uint8Array;
+    rendezvousKey: Uint8Array;
 }

package/src/proto/gen/dxos/credentials/identity.ts

@@ -6,11 +6,19 @@ import * as dxos_credentials_greet from "./greet";
 import * as dxos_credentials_party from "./party";
 import * as dxos_halo_keys from "../halo/keys";
 import * as google_protobuf from "../../google/protobuf";
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/identity.proto}
+ */
 export interface IdentityInfo {
-    publicKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    displayName?: string;
+    publicKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    displayName: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/identity.proto}
+ */
 export interface DeviceInfo {
-    publicKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    displayName?: string;
+    publicKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    displayName: string;
 }

package/src/proto/gen/dxos/credentials/party.ts

@@ -6,8 +6,12 @@ import * as dxos_credentials_greet from "./greet";
 import * as dxos_credentials_identity from "./identity";
 import * as dxos_halo_keys from "../halo/keys";
 import * as google_protobuf from "../../google/protobuf";
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface PartyCredential {
-    type?: PartyCredential.Type;
+    type: PartyCredential.Type;
     envelope?: Envelope;
     partyGenesis?: PartyGenesis;
     keyAdmit?: KeyAdmit;
@@ -15,6 +19,10 @@ export interface PartyCredential {
     feedGenesis?: FeedGenesis;
 }
 export namespace PartyCredential {
+    /**
+     * Defined in:
+     *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+     */
     export enum Type {
         ENVELOPE = 0,
         PARTY_GENESIS = 1,
@@ -23,32 +31,56 @@ export namespace PartyCredential {
         FEED_ADMIT = 4
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface PartyGenesis {
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    feedKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    admitKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    admitKeyType?: dxos_halo_keys.KeyType;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    feedKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    admitKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    admitKeyType: dxos_halo_keys.KeyType;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface KeyAdmit {
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    admitKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    admitKeyType?: dxos_halo_keys.KeyType;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    admitKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    admitKeyType: dxos_halo_keys.KeyType;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface FeedAdmit {
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    feedKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    feedKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface FeedGenesis {
-    feedKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    ownerKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    feedKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    ownerKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface Envelope {
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    message?: dxos_credentials.Message;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    message: dxos_credentials.Message;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/party.proto}
+ */
 export interface PartyInvitation {
-    id?: Uint8Array;
-    partyKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    issuerKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
-    inviteeKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    id: Uint8Array;
+    partyKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    issuerKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+    inviteeKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
 }

package/src/proto/gen/dxos/credentials.ts

@@ -6,25 +6,64 @@ import * as dxos_credentials_identity from "./credentials/identity";
 import * as dxos_credentials_party from "./credentials/party";
 import * as dxos_halo_keys from "./halo/keys";
 import * as google_protobuf from "../google/protobuf";
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../common/protocols/src/proto/dxos/halo/signed.proto}
+ */
 export interface Message {
     payload: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
 }
 /**
  * A generic container message used whenever messages are signed (e.g. PartyCredential)
+ *
+ * Defined in:
+ *   {@link file://./../../../../../../common/protocols/src/proto/dxos/halo/signed.proto}
  */
 export interface SignedMessage {
+    /**
+     * The signed message contents.
+     */
     signed: SignedMessage.Signed;
+    /**
+     * An array of Signatures, one for each key that signed the message.
+     */
     signatures?: SignedMessage.Signature[];
 }
 export namespace SignedMessage {
+    /**
+     * Defined in:
+     *   {@link file://./../../../../../../common/protocols/src/proto/dxos/halo/signed.proto}
+     */
     export interface Signed {
+        /**
+         * RFC-3339 datetime string.
+         */
         created: string;
         nonce: Uint8Array;
+        /**
+         * The payload to be signed.
+         */
         payload: ReturnType<(typeof substitutions)["google.protobuf.Any"]["decode"]>;
     }
+    /**
+     * Defined in:
+     *   {@link file://./../../../../../../common/protocols/src/proto/dxos/halo/signed.proto}
+     */
     export interface Signature {
+        /**
+         * The publicKey of the keypair that made this signature.
+         */
         key: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
+        /**
+         * The bytes of the signature.
+         */
         signature: Uint8Array;
+        /**
+         * The certification chain of SignedMessages for this key.
+         *
+         * Options:
+         *   - proto3_optional = true
+         */
         keyChain?: dxos_halo_keys.KeyChain;
     }
 }

package/src/proto/gen/dxos/halo/keys.ts

@@ -6,6 +6,10 @@ import * as dxos_credentials_greet from "../credentials/greet";
 import * as dxos_credentials_identity from "../credentials/identity";
 import * as dxos_credentials_party from "../credentials/party";
 import * as google_protobuf from "../../google/protobuf";
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export enum KeyType {
     UNKNOWN = 0,
     IDENTITY = 1,
@@ -14,12 +18,24 @@ export enum KeyType {
     FEED = 4,
     DXNS_ADDRESS = 5
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export interface PubKey {
-    data?: Uint8Array;
+    data: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export interface PrivKey {
-    data?: Uint8Array;
+    data: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export interface KeyRecord {
     /**
      * The `KeyType` type of the key. This is often unknown for keys from other sources.
@@ -31,33 +47,59 @@ export interface KeyRecord {
     publicKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     /**
      * The secret key as a Buffer (this will never be visible outside the Keyring).
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     secretKey?: ReturnType<(typeof substitutions)["dxos.halo.keys.PrivKey"]["decode"]>;
     /**
      * Is this key from a Greeting "hint"?
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     hint?: boolean;
     /**
      * Determines if this is our key?
      * Usually true if `secretKey` is present; may be false for "inception keys" such as the Party key.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     own?: boolean;
     /**
      * Is this key to be trusted?
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     trusted?: boolean;
     /**
      * An RFC-3339 date/time string for when the key was added to the Keyring.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     added?: string;
     /**
      * An RFC-3339 date/time string for when the key was created.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     created?: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export interface KeyRecordList {
     keys?: KeyRecord[];
 }
+/**
+ * Defined in:
+ *   {@link file://./../../../../../../../common/protocols/src/proto/dxos/halo/keys.proto}
+ */
 export interface KeyChain {
     publicKey: ReturnType<(typeof substitutions)["dxos.halo.keys.PubKey"]["decode"]>;
     message: dxos_credentials.SignedMessage;