Class Client<ContentTypes>

constructor

• new Client<ContentTypes>(address, inboxId, installationId, dbPath, codecs?): Client<ContentTypes>

• Type Parameters

  • ContentTypes extends DefaultContentTypes = DefaultContentTypes

  Parameters

  • address: string

  • inboxId: InboxId

  • installationId: string

  • dbPath: string

  • codecs: ContentCodec<ContentTypes>[] = []

  Returns Client<ContentTypes>

address

codecRegistry

conversations

dbPath

inboxId

installationId

preferences

addAccount

• addAccount(newAccount): Promise<void>

• Add this account to the current inboxId.

  Parameters

  • newAccount: Signer | {}

    The signer of the new account to be added.

  Returns Promise<void>

canMessage

• canMessage(addresses): Promise<{
      [key: Address]: boolean;
  }>

• Determines whether the current user can send messages to the specified peers over groups.

  This method checks if the specified peers are using clients that support group messaging.

  Parameters

  • addresses: string[]

    The addresses of the peers to check for messaging eligibility.

  Returns Promise<{
      [key: Address]: boolean;
  }>

  A Promise resolving to a hash of addresses and booleans if they can message on the V3 network.

decryptAttachment

• decryptAttachment(encryptedFile): Promise<DecryptedLocalAttachment>

• Decrypts an encrypted local attachment.

  This asynchronous method takes an encrypted local attachment and decrypts it.

  Parameters

  • encryptedFile: EncryptedLocalAttachment

    The encrypted local attachment to be decrypted.

  Returns Promise<DecryptedLocalAttachment>

  A Promise that resolves to the decrypted local attachment.

  Throws

  Throws an error if the attachment is not a local file URI (must start with "file://").

deleteLocalDatabase

• deleteLocalDatabase(): Promise<any>

• Deletes the local database. This cannot be undone and these stored messages will not be refetched from the network.

  Returns Promise<any>

dropLocalDatabaseConnection

• dropLocalDatabaseConnection(): Promise<any>

• Drop the local database connection. This function is delicate and should be used with caution. App will error if database not properly reconnected. See: reconnectLocalDatabase()

  Returns Promise<any>

encryptAttachment

• encryptAttachment(file): Promise<EncryptedLocalAttachment>

• Encrypts a local attachment for secure transmission.

  This asynchronous method takes a file, checks if it's a local file URI, and encrypts the attachment for secure transmission.

  Parameters

  • file: DecryptedLocalAttachment

    The local attachment to be encrypted.

  Returns Promise<EncryptedLocalAttachment>

  A Promise that resolves to the encrypted local attachment.

  Throws

  Throws an error if the attachment is not a local file URI (must start with "file://").

findInboxIdFromAddress

• findInboxIdFromAddress(peerAddress): Promise<undefined | InboxId>

• Find the Address associated with this address

  Parameters

  • peerAddress: string

    The address of the peer to check for inboxId.

  Returns Promise<undefined | InboxId>

  A Promise resolving to the InboxId.

inboxState

• inboxState(refreshFromNetwork): Promise<InboxState>

• Make a request for your inbox state.

  Parameters

  • refreshFromNetwork: boolean

    If you want to refresh the current state of in the inbox from the network or not.

  Returns Promise<InboxState>

  A Promise resolving to a InboxState.

inboxStates

• inboxStates(refreshFromNetwork, inboxIds): Promise<InboxState[]>

• Make a request for a list of inbox states.

  Parameters

  • refreshFromNetwork: boolean

    If you want to refresh the current state the inbox from the network or not.

  • inboxIds: InboxId[]

    The inboxIds to get the associate inbox states for.

  Returns Promise<InboxState[]>

  A Promise resolving to a list of InboxState.

reconnectLocalDatabase

• reconnectLocalDatabase(): Promise<any>

• Reconnects the local database after being dropped.

  Returns Promise<any>

register

• register<T, Codec>(contentCodec): void

• Type Parameters

  • T

  • Codec extends ContentCodec<T>

  Parameters

  • contentCodec: Codec

  Returns void

removeAccount

• removeAccount(wallet, addressToRemove): Promise<void>

• Remove this account from the current inboxId.

  Parameters

  • wallet: Signer | {}

    The signer object used for authenticate the removal.

  • addressToRemove: string

    The address of the wallet you'd like to remove from the account.

  Returns Promise<void>

requestMessageHistorySync

• requestMessageHistorySync(): Promise<any>

• Make a request for a message history sync.

  Returns Promise<any>

revokeAllOtherInstallations

• revokeAllOtherInstallations(wallet): Promise<void>

• Revoke all other installations but the current one.

  Parameters

  • wallet: null | Signer | {}

  Returns Promise<void>

signWithInstallationKey

• signWithInstallationKey(message): Promise<Uint8Array>

• Sign this message with the current installation key.

  Parameters

  • message: string

    The message to sign.

  Returns Promise<Uint8Array>

  A Promise resolving to the signature bytes.

verifySignature

• verifySignature(message, signature): Promise<boolean>

• Verify the signature was signed with this clients installation key.

  Parameters

  • message: string

    The message that was signed.

  • signature: Uint8Array

    The signature.

  Returns Promise<boolean>

  A Promise resolving to a boolean if the signature verified or not.

Static build

• build<ContentCodecs>(address, options): Promise<Client<ContentCodecs>>

• Builds a instance of the Client class using the provided address and chainId if SCW.

  Type Parameters

  • ContentCodecs extends DefaultContentTypes = DefaultContentTypes

  Parameters

  • address: string

    The address of the account to build

  • options: ClientOptions & {
        codecs?: ContentCodecs;
    }

  Returns Promise<Client<ContentCodecs>>

  A Promise that resolves to a new Client instance.

  See XMTP Docs for more information.

Static create

• create<ContentCodecs>(wallet, options): Promise<Client<ContentCodecs>>

• Creates a new instance of the Client class using the provided signer.

  Type Parameters

  • ContentCodecs extends DefaultContentTypes = DefaultContentTypes

  Parameters

  • wallet: null | Signer | {}

  • options: ClientOptions & {
        codecs?: ContentCodecs;
    }

  Returns Promise<Client<ContentCodecs>>

  A Promise that resolves to a new Client instance.

  See XMTP Docs for more information.

Static createRandom

• createRandom<ContentTypes>(options): Promise<Client<ContentTypes>>

• Creates a new instance of the XMTP Client with a randomly generated address.

  Type Parameters

  • ContentTypes extends DefaultContentTypes

  Parameters

  • options: ClientOptions & {
        codecs?: ContentTypes;
    }

  Returns Promise<Client<ContentTypes>>

  A Promise that resolves to a new Client instance with a random address.

Static dropClient

• dropClient(inboxId): Promise<any>

• Drop the client from memory. Use when you want to remove the client from memory and are done with it.

  Parameters

  • inboxId: InboxId

  Returns Promise<any>

Static exportNativeLogs

• exportNativeLogs(): Promise<any>

• Returns Promise<any>

Static getOrCreateInboxId

• getOrCreateInboxId(address, env): Promise<InboxId>

• Static method to determine the inboxId for the address.

  Parameters

  • address: string

  • env: XMTPEnvironment

  Returns Promise<InboxId>