@xmtp/browser-sdk 2.2.1 → 3.0.1

package/dist/workers/utils.js

@@ -1,2 +1,2 @@
-import t,{generateInboxId as e,getInboxIdForIdentifier as i}from"@xmtp/wasm-bindings";const a={local:"http://localhost:5555",dev:"https://dev.xmtp.network",production:"https://production.xmtp.network"},o=t=>{self.postMessage(t)};let s=!1;self.onmessage=async n=>{const{action:r,id:d,data:c}=n.data;s&&console.log("utils worker received event data",n.data),await t();try{switch(r){case"utils.init":s=c.enableLogging,o({id:d,action:r,result:void 0});break;case"utils.generateInboxId":{const t=e(c.identifier);o({id:d,action:r,result:t});break}case"utils.getInboxIdForIdentifier":{const t=await(async(t,e)=>i(e?a[e]:a.dev,t))(c.identifier,c.env);o({id:d,action:r,result:t});break}}}catch(t){(t=>{self.postMessage(t)})({id:d,action:r,error:t})}};
+import e,{inboxStateFromInboxIds as t,revokeInstallationsSignatureRequest as i,applySignatureRequest as a,generateInboxId as n,getInboxIdForIdentifier as s}from"@xmtp/wasm-bindings";import"@xmtp/content-type-primitives";const o={local:"http://localhost:5555",dev:"https://dev.xmtp.network",production:"https://production.xmtp.network"},r=e=>({bytes:e.bytes,clientTimestampNs:e.clientTimestampNs,id:e.id}),d=e=>{self.postMessage(e)};let c=!1;self.onmessage=async l=>{const{action:g,id:b,data:u}=l.data;c&&console.log("utils worker received event data",l.data),await e();try{switch(g){case"utils.init":c=u.enableLogging,d({id:b,action:g,result:void 0});break;case"utils.generateInboxId":{const e=n(u.identifier);d({id:b,action:g,result:e});break}case"utils.getInboxIdForIdentifier":{const e=await(async(e,t)=>s(t?o[t]:o.dev,e))(u.identifier,u.env);d({id:b,action:g,result:e});break}case"utils.revokeInstallationsSignatureText":{const e=o[u.env??"dev"],t=await i(e,u.identifier,u.inboxId,u.installationIds),a=await t.signatureText();d({id:b,action:g,result:a});break}case"utils.revokeInstallations":{const e=o[u.env??"dev"],t=await i(e,u.signer.identifier,u.inboxId,u.installationIds);switch(u.signer.type){case"EOA":await t.addEcdsaSignature(u.signer.signature);break;case"SCW":await t.addScwSignature(u.signer.identifier,u.signer.signature,u.signer.chainId,u.signer.blockNumber)}await a(e,t),d({id:b,action:g,result:void 0});break}case"utils.inboxStateFromInboxIds":{const e=o[u.env??"dev"],i=(await t(e,u.inboxIds)).map((e=>(e=>({identifiers:e.accountIdentifiers,inboxId:e.inboxId,installations:e.installations.map(r),recoveryIdentifier:e.recoveryIdentifier}))(e)));d({id:b,action:g,result:i});break}}}catch(e){(e=>{self.postMessage(e)})({id:b,action:g,error:e})}};
 //# sourceMappingURL=utils.js.map

package/dist/workers/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../src/constants.ts","../../src/workers/utils.ts"],"sourcesContent":[null,null],"names":["ApiUrls","local","dev","production","postMessage","data","self","enableLogging","onmessage","async","event","action","id","console","log","init","result","undefined","generateInboxId","identifier","env","get_inbox_id_for_identifier","getInboxIdForIdentifier","e","postMessageError","error"],"mappings":"sFAQO,MAAMA,EAAU,CACrBC,MAAO,wBACPC,IAAK,2BACLC,WAAY,mCCORC,EACJC,IAEAC,KAAKF,YAAYC,EAAK,EAkBxB,IAAIE,GAAgB,EAEpBD,KAAKE,UAAYC,MACfC,IAEA,MAAMC,OAAEA,EAAMC,GAAEA,EAAEP,KAAEA,GAASK,EAAML,KAE/BE,GACFM,QAAQC,IAAI,mCAAoCJ,EAAML,YAIlDU,IAEN,IACE,OAAQJ,GACN,IAAK,aACHJ,EAAgBF,EAAKE,cACrBH,EAAY,CAAEQ,KAAID,SAAQK,YAAQC,IAClC,MAEF,IAAK,wBAAyB,CAC5B,MAAMD,EAASE,EAAgBb,EAAKc,YACpCf,EAAY,CACVQ,KACAD,SACAK,WAEF,MAEF,IAAK,gCAAiC,CACpC,MAAMA,OAvCkBP,OAC9BU,EACAC,IAGOC,EADMD,EAAMpB,EAAQoB,GAAOpB,EAAQE,IACDiB,GAkCdG,CAAwBjB,EAAKc,WAAYd,EAAKe,KACnEhB,EAAY,CAAEQ,KAAID,SAAQK,WAC1B,QAGJ,MAAOO,GAhDc,CAAClB,IACxBC,KAAKF,YAAYC,EAAK,EAgDpBmB,CAAiB,CAAEZ,KAAID,SAAQc,MAAOF"}
+{"version":3,"file":"utils.js","sources":["../../src/constants.ts","../../src/utils/conversions.ts","../../src/workers/utils.ts"],"sourcesContent":[null,null,null],"names":["ApiUrls","local","dev","production","toSafeInstallation","installation","bytes","clientTimestampNs","id","postMessage","data","self","enableLogging","onmessage","async","event","action","console","log","init","result","undefined","generateInboxId","identifier","env","get_inbox_id_for_identifier","getInboxIdForIdentifier","host","signatureRequest","revokeInstallationsSignatureRequest","inboxId","installationIds","signatureText","signer","type","addEcdsaSignature","signature","addScwSignature","chainId","blockNumber","applySignatureRequest","inboxStateFromInboxIds","inboxIds","map","inboxState","identifiers","accountIdentifiers","installations","recoveryIdentifier","toSafeInboxState","e","postMessageError","error"],"mappings":"4NAQO,MAAMA,EAAU,CACrBC,MAAO,wBACPC,IAAK,2BACLC,WAAY,mCCiYDC,EACXC,IACsB,CACtBC,MAAOD,EAAaC,MACpBC,kBAAmBF,EAAaE,kBAChCC,GAAIH,EAAaG,KC3XbC,EACJC,IAEAC,KAAKF,YAAYC,EAAK,EAkBxB,IAAIE,GAAgB,EAEpBD,KAAKE,UAAYC,MACfC,IAEA,MAAMC,OAAEA,EAAMR,GAAEA,EAAEE,KAAEA,GAASK,EAAML,KAE/BE,GACFK,QAAQC,IAAI,mCAAoCH,EAAML,YAIlDS,IAEN,IACE,OAAQH,GACN,IAAK,aACHJ,EAAgBF,EAAKE,cACrBH,EAAY,CAAED,KAAIQ,SAAQI,YAAQC,IAClC,MAEF,IAAK,wBAAyB,CAC5B,MAAMD,EAASE,EAAgBZ,EAAKa,YACpCd,EAAY,CACVD,KACAQ,SACAI,WAEF,MAEF,IAAK,gCAAiC,CACpC,MAAMA,OAvCkBN,OAC9BS,EACAC,IAGOC,EADMD,EAAMxB,EAAQwB,GAAOxB,EAAQE,IACDqB,GAkCdG,CAAwBhB,EAAKa,WAAYb,EAAKc,KACnEf,EAAY,CAAED,KAAIQ,SAAQI,WAC1B,MAEF,IAAK,yCAA0C,CAC7C,MAAMO,EAAO3B,EAAQU,EAAKc,KAAO,OAC3BI,QAAyBC,EAC7BF,EACAjB,EAAKa,WACLb,EAAKoB,QACLpB,EAAKqB,iBAEDC,QAAsBJ,EAAiBI,gBAC7CvB,EAAY,CAAED,KAAIQ,SAAQI,OAAQY,IAClC,MAEF,IAAK,4BAA6B,CAChC,MAAML,EAAO3B,EAAQU,EAAKc,KAAO,OAC3BI,QAAyBC,EAC7BF,EACAjB,EAAKuB,OAAOV,WACZb,EAAKoB,QACLpB,EAAKqB,iBAEP,OAAQrB,EAAKuB,OAAOC,MAClB,IAAK,YACGN,EAAiBO,kBAAkBzB,EAAKuB,OAAOG,WACrD,MACF,IAAK,YACGR,EAAiBS,gBACrB3B,EAAKuB,OAAOV,WACZb,EAAKuB,OAAOG,UACZ1B,EAAKuB,OAAOK,QACZ5B,EAAKuB,OAAOM,mBAIZC,EAAsBb,EAAMC,GAClCnB,EAAY,CAAED,KAAIQ,SAAQI,YAAQC,IAClC,MAEF,IAAK,+BAAgC,CACnC,MAAMM,EAAO3B,EAAQU,EAAKc,KAAO,OAE3BJ,SADoBqB,EAAuBd,EAAMjB,EAAKgC,WACjCC,KAAKC,GDqSR,CAACA,IAA4C,CAC3EC,YAAaD,EAAWE,mBACxBhB,QAASc,EAAWd,QACpBiB,cAAeH,EAAWG,cAAcJ,IAAIvC,GAC5C4C,mBAAoBJ,EAAWI,qBCxSvBC,CAAiBL,KAEnBnC,EAAY,CAAED,KAAIQ,SAAQI,WAC1B,QAGJ,MAAO8B,GA9Fc,CAACxC,IACxBC,KAAKF,YAAYC,EAAK,EA8FpByC,CAAiB,CAAE3C,KAAIQ,SAAQoC,MAAOF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmtp/browser-sdk",
-  "version": "2.2.1",
+  "version": "3.0.1",
   "description": "XMTP client SDK for browsers written in TypeScript",
   "keywords": [
     "xmtp",
@@ -63,7 +63,7 @@
     "@xmtp/content-type-group-updated": "^2.0.2",
     "@xmtp/content-type-primitives": "^2.0.2",
     "@xmtp/content-type-text": "^2.0.2",
-    "@xmtp/wasm-bindings": "1.2.2",
+    "@xmtp/wasm-bindings": "1.2.5",
     "uuid": "^11.1.0"
   },
   "devDependencies": {

package/src/Client.ts

@@ -7,13 +7,11 @@ import type {
   ContentTypeId,
 } from "@xmtp/content-type-primitives";
 import { TextCodec } from "@xmtp/content-type-text";
-import {
-  GroupMessageKind,
-  SignatureRequestType,
-  type Identifier,
-} from "@xmtp/wasm-bindings";
+import { GroupMessageKind, type Identifier } from "@xmtp/wasm-bindings";
+import { v4 } from "uuid";
 import { ClientWorkerClass } from "@/ClientWorkerClass";
 import { Conversations } from "@/Conversations";
+import { DebugInformation } from "@/DebugInformation";
 import { Preferences } from "@/Preferences";
 import type { ClientOptions, XmtpEnv } from "@/types/options";
 import { Utils } from "@/Utils";
@@ -25,12 +23,11 @@ import {
 import {
   AccountAlreadyAssociatedError,
   CodecNotFoundError,
-  GenerateSignatureError,
   InboxReassignError,
   InvalidGroupMembershipChangeError,
   SignerUnavailableError,
 } from "@/utils/errors";
-import { type Signer } from "@/utils/signer";
+import { toSafeSigner, type SafeSigner, type Signer } from "@/utils/signer";
 
 export type ExtractCodecContentTypes<C extends ContentCodec[] = []> =
   [...C, GroupUpdatedCodec, TextCodec][number] extends ContentCodec<infer T>
@@ -45,6 +42,7 @@ export class Client<
 > extends ClientWorkerClass {
   #codecs: Map<string, ContentCodec>;
   #conversations: Conversations<ContentTypes>;
+  #debugInformation: DebugInformation<ContentTypes>;
   #identifier?: Identifier;
   #inboxId: string | undefined;
   #installationId: string | undefined;
@@ -72,6 +70,7 @@ export class Client<
     );
     this.#options = options;
     this.#conversations = new Conversations(this);
+    this.#debugInformation = new DebugInformation(this);
     this.#preferences = new Preferences(this);
     const codecs = [
       new GroupUpdatedCodec(),
@@ -208,6 +207,13 @@ export class Client<
     return this.#conversations;
   }
 
+  /**
+   * Gets the debug information helpers for this client
+   */
+  get debugInformation() {
+    return this.#debugInformation;
+  }
+
   /**
    * Gets the preferences manager for this client
    */
@@ -224,10 +230,12 @@ export class Client<
    *
    * It is highly recommended to use the `register` method instead.
    *
-   * @returns The signature text
+   * @returns The signature text and signature request ID
    */
   async unsafe_createInboxSignatureText() {
-    return this.sendMessage("client.createInboxSignatureText", undefined);
+    return this.sendMessage("client.createInboxSignatureText", {
+      signatureRequestId: v4(),
+    });
   }
 
   /**
@@ -241,7 +249,8 @@ export class Client<
    *
    * @param newIdentifier - The identifier of the new account
    * @param allowInboxReassign - Whether to allow inbox reassignment
-   * @returns The signature text
+   * @throws {InboxReassignError} if `allowInboxReassign` is false
+   * @returns The signature text and signature request ID
    */
   async unsafe_addAccountSignatureText(
     newIdentifier: Identifier,
@@ -253,6 +262,7 @@ export class Client<
 
     return this.sendMessage("client.addAccountSignatureText", {
       newIdentifier,
+      signatureRequestId: v4(),
     });
   }
 
@@ -266,11 +276,12 @@ export class Client<
    * It is highly recommended to use the `removeAccount` method instead.
    *
    * @param identifier - The identifier of the account to remove
-   * @returns The signature text
+   * @returns The signature text and signature request ID
    */
   async unsafe_removeAccountSignatureText(identifier: Identifier) {
     return this.sendMessage("client.removeAccountSignatureText", {
       identifier,
+      signatureRequestId: v4(),
     });
   }
 
@@ -284,13 +295,12 @@ export class Client<
    *
    * It is highly recommended to use the `revokeAllOtherInstallations` method instead.
    *
-   * @returns The signature text
+   * @returns The signature text and signature request ID
    */
   async unsafe_revokeAllOtherInstallationsSignatureText() {
-    return this.sendMessage(
-      "client.revokeAllOtherInstallationsSignatureText",
-      undefined,
-    );
+    return this.sendMessage("client.revokeAllOtherInstallationsSignatureText", {
+      signatureRequestId: v4(),
+    });
   }
 
   /**
@@ -304,11 +314,12 @@ export class Client<
    * It is highly recommended to use the `revokeInstallations` method instead.
    *
    * @param installationIds - The installation IDs to revoke
-   * @returns The signature text
+   * @returns The signature text and signature request ID
    */
   async unsafe_revokeInstallationsSignatureText(installationIds: Uint8Array[]) {
     return this.sendMessage("client.revokeInstallationsSignatureText", {
       installationIds,
+      signatureRequestId: v4(),
     });
   }
 
@@ -323,68 +334,37 @@ export class Client<
    * It is highly recommended to use the `changeRecoveryIdentifier` method instead.
    *
    * @param identifier - The new recovery identifier
-   * @returns The signature text
+   * @returns The signature text and signature request ID
    */
   async unsafe_changeRecoveryIdentifierSignatureText(identifier: Identifier) {
     return this.sendMessage("client.changeRecoveryIdentifierSignatureText", {
       identifier,
+      signatureRequestId: v4(),
     });
   }
 
   /**
-   * Adds a signature for a specific request type
+   * Applies a signature request to the client
    *
    * WARNING: This function should be used with caution. It is only provided
    * for use in special cases where the provided workflows do not meet the
    * requirements of an application.
    *
    * It is highly recommended to use the `register`, `unsafe_addAccount`,
-   * `removeAccount`, `revokeAllOtherInstallations`, or `revokeInstallations`
-   * methods instead.
+   * `removeAccount`, `revokeAllOtherInstallations`, `revokeInstallations`,
+   * or `changeRecoveryIdentifier` method instead.
    *
-   * @param signatureType - The type of signature request
-   * @param signatureText - The text to sign
    * @param signer - The signer to use
-   * @warning This is an unsafe operation and should be used with caution
+   * @param signatureRequestId - The ID of the signature request to apply
    */
-  async unsafe_addSignature(
-    signatureType: SignatureRequestType,
-    signatureText: string,
-    signer: Signer,
+  async unsafe_applySignatureRequest(
+    signer: SafeSigner,
+    signatureRequestId: string,
   ) {
-    const signature = await signer.signMessage(signatureText);
-
-    switch (signer.type) {
-      case "SCW":
-        await this.sendMessage("client.addScwSignature", {
-          type: signatureType,
-          bytes: signature,
-          chainId: signer.getChainId(),
-          blockNumber: signer.getBlockNumber?.(),
-        });
-        break;
-      case "EOA":
-        await this.sendMessage("client.addEcdsaSignature", {
-          type: signatureType,
-          bytes: signature,
-        });
-        break;
-    }
-  }
-
-  /**
-   * Applies all pending signatures
-   *
-   * WARNING: This function should be used with caution. It is only provided
-   * for use in special cases where the provided workflows do not meet the
-   * requirements of an application.
-   *
-   * It is highly recommended to use the `register`, `unsafe_addAccount`,
-   * `removeAccount`, `revokeAllOtherInstallations`, or `revokeInstallations`
-   * methods instead.
-   */
-  async unsafe_applySignatures() {
-    return this.sendMessage("client.applySignatures", undefined);
+    return this.sendMessage("client.applySignatureRequest", {
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -399,20 +379,21 @@ export class Client<
       throw new SignerUnavailableError();
     }
 
-    const signatureText = await this.unsafe_createInboxSignatureText();
+    const { signatureText, signatureRequestId } =
+      await this.unsafe_createInboxSignatureText();
 
-    // if the signature text is not available, the client is already registered
-    if (!signatureText) {
+    // if the signature text or request ID is not available, don't register
+    if (!signatureText || !signatureRequestId) {
       return;
     }
 
-    await this.unsafe_addSignature(
-      SignatureRequestType.CreateInbox,
-      signatureText,
-      this.#signer,
-    );
+    const signature = await this.#signer.signMessage(signatureText);
+    const signer = await toSafeSigner(this.#signer, signature);
 
-    return this.sendMessage("client.registerIdentity", undefined);
+    return this.sendMessage("client.registerIdentity", {
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -429,39 +410,43 @@ export class Client<
    *
    * @param newAccountSigner - The signer for the new account
    * @param allowInboxReassign - Whether to allow inbox reassignment
-   * @throws {AccountAlreadyAssociatedError} if the account is already associated with an inbox ID
-   * @throws {GenerateSignatureError} if the signature cannot be generated
    * @throws {SignerUnavailableError} if no signer is available
+   * @throws {InboxReassignError} if `allowInboxReassign` is false
+   * @throws {AccountAlreadyAssociatedError} if the account is already associated with an inbox ID
    */
   async unsafe_addAccount(
     newAccountSigner: Signer,
     allowInboxReassign: boolean = false,
   ) {
-    // check for existing inbox id
-    const existingInboxId = await this.findInboxIdByIdentifier(
-      await newAccountSigner.getIdentifier(),
-    );
+    if (!this.#signer) {
+      throw new SignerUnavailableError();
+    }
 
-    if (existingInboxId && !allowInboxReassign) {
-      throw new AccountAlreadyAssociatedError(existingInboxId);
+    if (!allowInboxReassign) {
+      throw new InboxReassignError();
     }
 
-    const signatureText = await this.unsafe_addAccountSignatureText(
+    // check for existing inbox id
+    const existingInboxId = await this.findInboxIdByIdentifier(
       await newAccountSigner.getIdentifier(),
-      true,
     );
 
-    if (!signatureText) {
-      throw new GenerateSignatureError(SignatureRequestType.AddWallet);
+    if (existingInboxId) {
+      throw new AccountAlreadyAssociatedError(existingInboxId);
     }
 
-    await this.unsafe_addSignature(
-      SignatureRequestType.AddWallet,
-      signatureText,
-      newAccountSigner,
-    );
-
-    await this.unsafe_applySignatures();
+    const { signatureText, signatureRequestId } =
+      await this.unsafe_addAccountSignatureText(
+        await newAccountSigner.getIdentifier(),
+        true,
+      );
+    const signature = await newAccountSigner.signMessage(signatureText);
+    const signer = await toSafeSigner(newAccountSigner, signature);
+    return this.sendMessage("client.addAccount", {
+      identifier: signer.identifier,
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -470,28 +455,23 @@ export class Client<
    * Requires a signer, use `Client.create` to create a client with a signer.
    *
    * @param accountIdentifier - The identifier of the account to remove
-   * @throws {GenerateSignatureError} if the signature cannot be generated
    * @throws {SignerUnavailableError} if no signer is available
    */
-  async removeAccount(accountIdentifier: Identifier) {
+  async removeAccount(identifier: Identifier) {
     if (!this.#signer) {
       throw new SignerUnavailableError();
     }
 
-    const signatureText =
-      await this.unsafe_removeAccountSignatureText(accountIdentifier);
-
-    if (!signatureText) {
-      throw new GenerateSignatureError(SignatureRequestType.RevokeWallet);
-    }
-
-    await this.unsafe_addSignature(
-      SignatureRequestType.RevokeWallet,
-      signatureText,
-      this.#signer,
-    );
+    const { signatureText, signatureRequestId } =
+      await this.unsafe_removeAccountSignatureText(identifier);
+    const signature = await this.#signer.signMessage(signatureText);
+    const signer = await toSafeSigner(this.#signer, signature);
 
-    await this.unsafe_applySignatures();
+    return this.sendMessage("client.removeAccount", {
+      identifier,
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -499,7 +479,6 @@ export class Client<
    *
    * Requires a signer, use `Client.create` to create a client with a signer.
    *
-   * @throws {GenerateSignatureError} if the signature cannot be generated
    * @throws {SignerUnavailableError} if no signer is available
    */
   async revokeAllOtherInstallations() {
@@ -507,22 +486,15 @@ export class Client<
       throw new SignerUnavailableError();
     }
 
-    const signatureText =
+    const { signatureText, signatureRequestId } =
       await this.unsafe_revokeAllOtherInstallationsSignatureText();
+    const signature = await this.#signer.signMessage(signatureText);
+    const signer = await toSafeSigner(this.#signer, signature);
 
-    if (!signatureText) {
-      throw new GenerateSignatureError(
-        SignatureRequestType.RevokeInstallations,
-      );
-    }
-
-    await this.unsafe_addSignature(
-      SignatureRequestType.RevokeInstallations,
-      signatureText,
-      this.#signer,
-    );
-
-    await this.unsafe_applySignatures();
+    return this.sendMessage("client.revokeAllOtherInstallations", {
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -531,7 +503,6 @@ export class Client<
    * Requires a signer, use `Client.create` to create a client with a signer.
    *
    * @param installationIds - The installation IDs to revoke
-   * @throws {GenerateSignatureError} if the signature cannot be generated
    * @throws {SignerUnavailableError} if no signer is available
    */
   async revokeInstallations(installationIds: Uint8Array[]) {
@@ -539,22 +510,49 @@ export class Client<
       throw new SignerUnavailableError();
     }
 
-    const signatureText =
+    const { signatureText, signatureRequestId } =
       await this.unsafe_revokeInstallationsSignatureText(installationIds);
+    const signature = await this.#signer.signMessage(signatureText);
+    const signer = await toSafeSigner(this.#signer, signature);
 
-    if (!signatureText) {
-      throw new GenerateSignatureError(
-        SignatureRequestType.RevokeInstallations,
-      );
-    }
+    return this.sendMessage("client.revokeInstallations", {
+      installationIds,
+      signer,
+      signatureRequestId,
+    });
+  }
 
-    await this.unsafe_addSignature(
-      SignatureRequestType.RevokeInstallations,
-      signatureText,
-      this.#signer,
-    );
+  /**
+   * Revokes specific installations of the client's inbox without a client
+   *
+   * @param env - The environment to use
+   * @param signer - The signer to use
+   * @param inboxId - The inbox ID to revoke installations for
+   * @param installationIds - The installation IDs to revoke
+   */
+  static async revokeInstallations(
+    signer: Signer,
+    inboxId: string,
+    installationIds: Uint8Array[],
+    env?: XmtpEnv,
+  ) {
+    const utils = new Utils();
+    await utils.revokeInstallations(signer, inboxId, installationIds, env);
+    utils.close();
+  }
 
-    await this.unsafe_applySignatures();
+  /**
+   * Gets the inbox state for the specified inbox IDs without a client
+   *
+   * @param inboxIds - The inbox IDs to get the state for
+   * @param env - The environment to use
+   * @returns The inbox state for the specified inbox IDs
+   */
+  static async inboxStateFromInboxIds(inboxIds: string[], env?: XmtpEnv) {
+    const utils = new Utils();
+    const result = await utils.inboxStateFromInboxIds(inboxIds, env);
+    utils.close();
+    return result;
   }
 
   /**
@@ -563,7 +561,6 @@ export class Client<
    * Requires a signer, use `Client.create` to create a client with a signer.
    *
    * @param identifier - The new recovery identifier
-   * @throws {GenerateSignatureError} if the signature cannot be generated
    * @throws {SignerUnavailableError} if no signer is available
    */
   async changeRecoveryIdentifier(identifier: Identifier) {
@@ -571,22 +568,16 @@ export class Client<
       throw new SignerUnavailableError();
     }
 
-    const signatureText =
+    const { signatureText, signatureRequestId } =
       await this.unsafe_changeRecoveryIdentifierSignatureText(identifier);
+    const signature = await this.#signer.signMessage(signatureText);
+    const signer = await toSafeSigner(this.#signer, signature);
 
-    if (!signatureText) {
-      throw new GenerateSignatureError(
-        SignatureRequestType.ChangeRecoveryIdentifier,
-      );
-    }
-
-    await this.unsafe_addSignature(
-      SignatureRequestType.ChangeRecoveryIdentifier,
-      signatureText,
-      this.#signer,
-    );
-
-    await this.unsafe_applySignatures();
+    return this.sendMessage("client.changeRecoveryIdentifier", {
+      identifier,
+      signer,
+      signatureRequestId,
+    });
   }
 
   /**
@@ -763,26 +754,4 @@ export class Client<
       installationIds,
     });
   }
-
-  apiStatistics() {
-    return this.sendMessage("client.apiStatistics", undefined);
-  }
-
-  apiIdentityStatistics() {
-    return this.sendMessage("client.apiIdentityStatistics", undefined);
-  }
-
-  apiAggregateStatistics() {
-    return this.sendMessage("client.apiAggregateStatistics", undefined);
-  }
-
-  clearAllStatistics() {
-    return this.sendMessage("client.clearAllStatistics", undefined);
-  }
-
-  async uploadDebugArchive(serverUrl?: string) {
-    return this.sendMessage("client.uploadDebugArchive", {
-      serverUrl,
-    });
-  }
 }

package/src/DebugInformation.ts

@@ -0,0 +1,48 @@
+import type { Client } from "./Client";
+
+/**
+ * Debug information helpers for the client
+ *
+ * This class is not intended to be initialized directly.
+ */
+export class DebugInformation<ContentTypes = unknown> {
+  #client: Client<ContentTypes>;
+
+  constructor(client: Client<ContentTypes>) {
+    this.#client = client;
+  }
+
+  apiStatistics() {
+    return this.#client.sendMessage(
+      "debugInformation.apiStatistics",
+      undefined,
+    );
+  }
+
+  apiIdentityStatistics() {
+    return this.#client.sendMessage(
+      "debugInformation.apiIdentityStatistics",
+      undefined,
+    );
+  }
+
+  apiAggregateStatistics() {
+    return this.#client.sendMessage(
+      "debugInformation.apiAggregateStatistics",
+      undefined,
+    );
+  }
+
+  clearAllStatistics() {
+    return this.#client.sendMessage(
+      "debugInformation.clearAllStatistics",
+      undefined,
+    );
+  }
+
+  uploadDebugArchive(serverUrl?: string) {
+    return this.#client.sendMessage("debugInformation.uploadDebugArchive", {
+      serverUrl,
+    });
+  }
+}