Class MarmotClient<THistory, TMedia>

constructor

• new MarmotClient<
      THistory extends BaseGroupHistory
      | undefined = any,
      TMedia extends BaseGroupMedia | undefined = any,
  >(
      options: MarmotClientOptions<THistory, TMedia>,
  ): MarmotClient<THistory, TMedia>

  Type Parameters

  • THistory extends BaseGroupHistory | undefined = any
  • TMedia extends BaseGroupMedia | undefined = any

  Parameters

  • options: MarmotClientOptions<THistory, TMedia>

  Returns MarmotClient<THistory, TMedia>

Readonlycapabilities

cryptoProvider

Readonlygroups

Readonlyinvites

ReadonlykeyPackages

Readonlynetwork

Readonlysigner

joinGroupFromWelcome

• joinGroupFromWelcome(
      options: { welcomeRumor: Rumor },
  ): Promise<{ group: MarmotGroup<THistory, TMedia> }>

  Joins a group from a Welcome message received via NIP-59 gift wrap.

  This method:

  1. Decodes the Welcome message from the kind 444 event
  2. Finds the matching local KeyPackage private material from the store
  3. Calls ts-mls joinGroup() to create a new ClientState
  4. Persists the resulting ClientState via this.groups.adoptClientState()
  5. Marks the consumed key package as used via this.keyPackages.markUsed()
  6. Returns a MarmotGroup instance

  After joining, callers can list used key packages with (await client.keyPackages.list()).filter(p => p.used) and rotate them via client.keyPackages.rotate(ref) to publish fresh ones to relays.

  Parameters

  • options: { welcomeRumor: Rumor }

    • welcomeRumor: Rumor

      The unwrapped kind 444 rumor event containing the Welcome message

  Returns Promise<{ group: MarmotGroup<THistory, TMedia> }>

  Promise resolving to the joined group

  Throws

  Error if no matching KeyPackage is found or if joining fails

readInviteGroupInfo

• readInviteGroupInfo(welcomeRumor: Rumor | Welcome): Promise<GroupInfo | null>

  Reads the GroupInfo from a Welcome rumor without joining the group.

  Finds the local key package that matches one of the welcome's recipient slots, then decrypts the group info using that key package. Useful for previewing group metadata (name, relays, admins) before deciding to join.

  Parameters

  • welcomeRumor: Rumor | Welcome

    The decrypted kind 444 welcome rumor

  Returns Promise<GroupInfo | null>

  The decrypted GroupInfo, or null if no matching key package is found or decryption fails