@xmtp/node-sdk 5.0.0-rc1 → 5.0.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { ContentCodec, ContentTypeId as ContentTypeId$1 } from '@xmtp/content-type-primitives';
+import { ContentCodec, ContentTypeId } from '@xmtp/content-type-primitives';
 import * as _xmtp_node_bindings from '@xmtp/node-bindings';
-import { LogLevel, ContentTypeId, DecodedMessage as DecodedMessage$1, StreamCloser, Conversation as Conversation$1, Message, EncodedContent, SendMessageOpts, Reaction, Reply, TransactionReference, WalletSendCalls, Actions, Intent, Attachment, MultiRemoteAttachment, RemoteAttachment, ListMessagesOptions, ConsentState, PermissionUpdateType, PermissionPolicy, MetadataField, Identifier, Conversations as Conversations$1, CreateGroupOptions, CreateDmOptions, ListConversationsOptions, ConversationType, Client as Client$1, Consent, ConsentEntityType, UserPreferenceUpdate, LeaveRequest, ReadReceipt, GroupUpdated, SignatureRequestHandle } from '@xmtp/node-bindings';
-export { Consent, ConsentEntityType, ConsentState, ContentType, ContentTypeId, ConversationListItem, ConversationType, CreateDmOptions, CreateGroupOptions, DeliveryStatus, EncodedContent, GroupMember, GroupMembershipState, GroupMessageKind, GroupMetadata, GroupPermissions, GroupPermissionsOptions, GroupSyncSummary, HmacKey, Identifier, IdentifierKind, InboxState, Installation, KeyPackageStatus, Lifetime, ListConversationsOptions, ListMessagesOptions, LogLevel, LogOptions, Message, MessageDisappearingSettings, MetadataField, PermissionLevel, PermissionPolicy, PermissionPolicySet, PermissionUpdateType, SignatureRequestHandle, SortDirection, UserPreferenceUpdate } from '@xmtp/node-bindings';
+import { ContentTypeId as ContentTypeId$1, DeliveryStatus, GroupMessageKind, Reaction, DecodedMessage as DecodedMessage$1, LeaveRequest, ReadReceipt, Attachment, RemoteAttachment, TransactionReference, WalletSendCalls, Actions, Intent, MultiRemoteAttachment, GroupUpdated, LogLevel, Identifier, StreamCloser, Conversation as Conversation$1, Message, EncodedContent, SendMessageOpts, Reply, ListMessagesOptions, ConsentState, PermissionUpdateType, PermissionPolicy, MetadataField, Conversations as Conversations$1, CreateGroupOptions, CreateDmOptions, ListConversationsOptions, ConversationType, Client as Client$1, Consent, ConsentEntityType, UserPreferenceUpdate, SignatureRequestHandle } from '@xmtp/node-bindings';
+export { Action, ActionStyle, Actions, ApiStats, Attachment, Consent, ConsentEntityType, ConsentState, ContentType, ConversationDebugInfo, ConversationListItem, ConversationType, CreateDmOptions, CreateGroupOptions, Cursor, DeliveryStatus, EncryptedAttachment, GroupMember, GroupMembershipState, GroupMessageKind, GroupMetadata, GroupPermissions, GroupPermissionsOptions, GroupSyncSummary, GroupUpdated, HmacKey, Identifier, IdentifierKind, IdentityStats, Inbox, InboxState, Installation, Intent, KeyPackageStatus, LeaveRequest, Lifetime, ListConversationsOptions, ListConversationsOrderBy, ListMessagesOptions, LogLevel, LogOptions, Message, MessageDisappearingSettings, MessageSortBy, MetadataField, MetadataFieldChange, MultiRemoteAttachment, PermissionLevel, PermissionPolicy, PermissionPolicySet, PermissionUpdateType, Reaction, ReactionAction, ReactionSchema, ReadReceipt, RemoteAttachment, RemoteAttachmentInfo, Reply, SendMessageOpts, SignatureRequestHandle, SortDirection, TransactionMetadata, TransactionReference, UserPreferenceUpdate, WalletCall, WalletSendCalls, contentTypeActions, contentTypeAttachment, contentTypeGroupUpdated, contentTypeIntent, contentTypeLeaveRequest, contentTypeMarkdown, contentTypeMultiRemoteAttachment, contentTypeReaction, contentTypeReadReceipt, contentTypeRemoteAttachment, contentTypeReply, contentTypeText, contentTypeTransactionReference, contentTypeWalletSendCalls, decryptAttachment, encodeActions, encodeAttachment, encodeIntent, encodeMarkdown, encodeMultiRemoteAttachment, encodeReaction, encodeReadReceipt, encodeRemoteAttachment, encodeText, encodeTransactionReference, encodeWalletSendCalls, encryptAttachment } from '@xmtp/node-bindings';
 
 /**
  * Pre-configured URLs for the XMTP network based on the environment
@@ -30,6 +30,55 @@ declare const HistorySyncUrls: {
     readonly production: "https://message-history.production.ephemera.network";
 };
 
+declare class CodecRegistry {
+    #private;
+    constructor(codecs: ContentCodec[]);
+    /**
+     * Gets the codec for a given content type
+     *
+     * @param contentType - The content type to get the codec for
+     * @returns The codec, if found
+     */
+    getCodec<ContentType = unknown>(contentType: ContentTypeId): ContentCodec<ContentType> | undefined;
+}
+
+/**
+ * Represents a decoded XMTP message
+ *
+ * @class
+ * @property {unknown} content - The decoded content of the message
+ * @property {ContentTypeId} contentType - The content type of the message content
+ * @property {string} conversationId - Unique identifier for the conversation
+ * @property {MessageDeliveryStatus} deliveryStatus - Current delivery status of the message ("unpublished" | "published" | "failed")
+ * @property {bigint} expiresAtNs - Timestamp when the message will expire (in nanoseconds)
+ * @property {Date} expiresAt - Timestamp when the message will expire
+ * @property {string} [fallback] - Optional fallback text for the message
+ * @property {string} id - Unique identifier for the message
+ * @property {MessageKind} kind - Type of message ("application" | "membership_change")
+ * @property {number} numReplies - Number of replies to the message
+ * @property {DecodedMessage<Reaction>[]} reactions - Reactions to the message
+ * @property {string} senderInboxId - Identifier for the sender's inbox
+ * @property {Date} sentAt - Timestamp when the message was sent
+ * @property {bigint} sentAtNs - Timestamp when the message was sent (in nanoseconds)
+ */
+declare class DecodedMessage<ContentTypes = unknown> {
+    content: ContentTypes | undefined;
+    contentType: ContentTypeId$1;
+    conversationId: string;
+    deliveryStatus: DeliveryStatus;
+    expiresAtNs?: bigint;
+    expiresAt?: Date;
+    fallback?: string;
+    id: string;
+    kind: GroupMessageKind;
+    numReplies: number;
+    reactions: DecodedMessage<Reaction>[];
+    senderInboxId: string;
+    sentAt: Date;
+    sentAtNs: bigint;
+    constructor(codecRegistry: CodecRegistry, message: DecodedMessage$1);
+}
+
 type HexString = `0x${string}`;
 declare function isHexString(value: unknown): value is HexString;
 declare function validHex(value: unknown): HexString;
@@ -136,6 +185,60 @@ type OtherOptions = {
     nonce?: bigint;
 };
 type ClientOptions = NetworkOptions & StorageOptions & ContentOptions & OtherOptions;
+type EnrichedReply<T = unknown, U = unknown> = {
+    referenceId: string;
+    content: T;
+    inReplyTo: DecodedMessage<U> | null;
+};
+type BuiltInContentTypes = string | LeaveRequest | Reaction | ReadReceipt | Attachment | RemoteAttachment | TransactionReference | WalletSendCalls | Actions | Intent | MultiRemoteAttachment | GroupUpdated;
+type ExtractCodecContentTypes<C extends ContentCodec[] = []> = C extends readonly [] ? BuiltInContentTypes : [...C][number] extends ContentCodec<infer T> ? T | BuiltInContentTypes | EnrichedReply<T | BuiltInContentTypes, T | BuiltInContentTypes> : BuiltInContentTypes;
+
+declare class InboxReassignError extends Error {
+    constructor();
+}
+declare class AccountAlreadyAssociatedError extends Error {
+    constructor(inboxId: string);
+}
+declare class MissingContentTypeError extends Error {
+    constructor();
+}
+declare class SignerUnavailableError extends Error {
+    constructor();
+}
+declare class ClientNotInitializedError extends Error {
+    constructor();
+}
+declare class StreamFailedError extends Error {
+    constructor(retryAttempts: number);
+}
+declare class StreamInvalidRetryAttemptsError extends Error {
+    constructor();
+}
+
+declare const generateInboxId: (identifier: Identifier, nonce?: bigint) => string;
+declare const getInboxIdForIdentifier: (identifier: Identifier, env?: XmtpEnv, gatewayHost?: string) => Promise<string | null>;
+
+type SignMessage = (message: string) => Promise<Uint8Array> | Uint8Array;
+type GetIdentifier = () => Promise<Identifier> | Identifier;
+type GetChainId = () => bigint;
+type GetBlockNumber = () => bigint;
+type Signer = {
+    type: "EOA";
+    signMessage: SignMessage;
+    getIdentifier: GetIdentifier;
+} | {
+    type: "SCW";
+    signMessage: SignMessage;
+    getIdentifier: GetIdentifier;
+    getBlockNumber?: GetBlockNumber;
+    getChainId: GetChainId;
+};
+type EOASigner = Extract<Signer, {
+    type: "EOA";
+}>;
+type SCWSigner = Extract<Signer, {
+    type: "SCW";
+}>;
 
 type ResolveValue<T> = {
     value: T;
@@ -148,38 +251,6 @@ interface AsyncStreamProxy<T> extends AsyncIterable<T> {
     isDone: boolean;
 }
 
-type MessageKind = "application" | "membership_change";
-type MessageDeliveryStatus = "unpublished" | "published" | "failed";
-/**
- * Represents a decoded XMTP message
- *
- * @class
- * @property {unknown} content - The decoded content of the message
- * @property {ContentTypeId} contentType - The content type of the message content
- * @property {string} conversationId - Unique identifier for the conversation
- * @property {MessageDeliveryStatus} deliveryStatus - Current delivery status of the message ("unpublished" | "published" | "failed")
- * @property {string} [fallback] - Optional fallback text for the message
- * @property {string} id - Unique identifier for the message
- * @property {MessageKind} kind - Type of message ("application" | "membership_change")
- * @property {string} senderInboxId - Identifier for the sender's inbox
- * @property {Date} sentAt - Timestamp when the message was sent
- * @property {number} sentAtNs - Timestamp when the message was sent (in nanoseconds)
- */
-declare class DecodedMessage<ContentTypes = unknown> {
-    #private;
-    content: ContentTypes | undefined;
-    contentType: ContentTypeId;
-    conversationId: string;
-    deliveryStatus: MessageDeliveryStatus;
-    fallback?: string;
-    id: string;
-    kind: MessageKind;
-    senderInboxId: string;
-    sentAt: Date;
-    sentAtNs: number;
-    constructor(client: Client<ContentTypes>, message: DecodedMessage$1);
-}
-
 declare const DEFAULT_RETRY_DELAY = 60000;
 declare const DEFAULT_RETRY_ATTEMPTS = 10;
 type StreamOptions<T = unknown, V = T> = {
@@ -259,10 +330,10 @@ declare class Conversation<ContentTypes = unknown> {
      * Creates a new conversation instance
      *
      * @param client - The client instance managing the conversation
+     * @param codecRegistry - The codec registry instance
      * @param conversation - The underlying conversation instance
-     * @param isCommitLogForked
      */
-    constructor(client: Client<ContentTypes>, conversation: Conversation$1, isCommitLogForked?: boolean | null);
+    constructor(client: Client<ContentTypes>, codecRegistry: CodecRegistry, conversation: Conversation$1);
     /**
      * Gets the unique identifier for this conversation
      */
@@ -271,7 +342,6 @@ declare class Conversation<ContentTypes = unknown> {
      * Gets whether this conversation is currently active
      */
     get isActive(): boolean;
-    get isCommitLogForked(): boolean | null;
     /**
      * Gets the inbox ID that added this client's inbox to the conversation
      */
@@ -279,11 +349,18 @@ declare class Conversation<ContentTypes = unknown> {
     /**
      * Gets the timestamp when the conversation was created in nanoseconds
      */
-    get createdAtNs(): number;
+    get createdAtNs(): bigint;
     /**
      * Gets the date when the conversation was created
      */
     get createdAt(): Date;
+    pausedForVersion(): string | undefined;
+    /**
+     * Gets HMAC keys for this conversation
+     *
+     * @returns The HMAC keys for this conversation
+     */
+    hmacKeys(): Record<string, _xmtp_node_bindings.HmacKey[]>;
     /**
      * Gets the metadata for this conversation
      *
@@ -291,7 +368,7 @@ declare class Conversation<ContentTypes = unknown> {
      */
     metadata(): Promise<{
         creatorInboxId: string;
-        conversationType: string;
+        conversationType: _xmtp_node_bindings.ConversationType;
     }>;
     /**
      * Gets the members of this conversation
@@ -325,7 +402,7 @@ declare class Conversation<ContentTypes = unknown> {
      * @param sendOptions - Options for sending the message
      * @param sendOptions.shouldPush - Indicates whether this message should be
      * included in push notifications
-     * @param sendOptions.optimistic - Indicates whether this message should be
+     * @param sendOptions.isOptimistic - Indicates whether this message should be
      * sent optimistically and published later via `publishMessages`
      * @returns Promise that resolves with the message ID after it has been sent
      */
@@ -334,98 +411,98 @@ declare class Conversation<ContentTypes = unknown> {
      * Sends a text message
      *
      * @param text - The text to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendText(text: string, optimistic?: boolean): Promise<string>;
+    sendText(text: string, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a markdown message
      *
      * @param markdown - The markdown to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendMarkdown(markdown: string, optimistic?: boolean): Promise<string>;
+    sendMarkdown(markdown: string, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a reaction message
      *
      * @param reaction - The reaction to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReaction(reaction: Reaction, optimistic?: boolean): Promise<string>;
+    sendReaction(reaction: Reaction, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a read receipt message
      *
      * @param readReceipt - The read receipt to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReadReceipt(optimistic?: boolean): Promise<string>;
+    sendReadReceipt(isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a reply message
      *
      * @param reply - The reply to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReply(reply: Reply, optimistic?: boolean): Promise<string>;
+    sendReply(reply: Reply, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a transaction reference message
      *
      * @param transactionReference - The transaction reference to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendTransactionReference(transactionReference: TransactionReference, optimistic?: boolean): Promise<string>;
+    sendTransactionReference(transactionReference: TransactionReference, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a wallet send calls message
      *
      * @param walletSendCalls - The wallet send calls to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendWalletSendCalls(walletSendCalls: WalletSendCalls, optimistic?: boolean): Promise<string>;
+    sendWalletSendCalls(walletSendCalls: WalletSendCalls, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a actions message
      *
      * @param actions - The actions to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendActions(actions: Actions, optimistic?: boolean): Promise<string>;
+    sendActions(actions: Actions, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a intent message
      *
      * @param intent - The intent to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendIntent(intent: Intent, optimistic?: boolean): Promise<string>;
+    sendIntent(intent: Intent, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends an attachment message
      *
      * @param attachment - The attachment to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendAttachment(attachment: Attachment, optimistic?: boolean): Promise<string>;
+    sendAttachment(attachment: Attachment, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a multi remote attachment message
      *
      * @param multiRemoteAttachment - The multi remote attachment to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, optimistic?: boolean): Promise<string>;
+    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, isOptimistic?: boolean): Promise<string>;
     /**
      * Sends a remote attachment message
      *
      * @param remoteAttachment - The remote attachment to send
-     * @param optimistic - Whether to send the message optimistically
+     * @param isOptimistic - Whether to send the message optimistically
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendRemoteAttachment(remoteAttachment: RemoteAttachment, optimistic?: boolean): Promise<string>;
+    sendRemoteAttachment(remoteAttachment: RemoteAttachment, isOptimistic?: boolean): Promise<string>;
     /**
      * Lists messages in this conversation
      *
@@ -449,7 +526,7 @@ declare class Conversation<ContentTypes = unknown> {
     /**
      * Gets the consent state for this conversation
      */
-    get consentState(): ConsentState;
+    consentState(): ConsentState;
     /**
      * Updates the consent state for this conversation
      *
@@ -469,7 +546,7 @@ declare class Conversation<ContentTypes = unknown> {
      * @param inNs - The duration after which messages should disappear
      * @returns Promise that resolves when the update is complete
      */
-    updateMessageDisappearingSettings(fromNs: number, inNs: number): Promise<void>;
+    updateMessageDisappearingSettings(fromNs: bigint, inNs: bigint): Promise<void>;
     /**
      * Removes message disappearing settings from this conversation
      *
@@ -482,19 +559,19 @@ declare class Conversation<ContentTypes = unknown> {
      * @returns Whether message disappearing is enabled
      */
     isMessageDisappearingEnabled(): boolean;
-    pausedForVersion(): string | undefined;
-    /**
-     * Retrieves HMAC keys for this conversation
-     *
-     * @returns The HMAC keys for this conversation
-     */
-    getHmacKeys(): Record<string, _xmtp_node_bindings.HmacKey[]>;
     /**
      * Retrieves information for this conversation to help with debugging
      *
      * @returns The debug information for this conversation
      */
     debugInfo(): Promise<_xmtp_node_bindings.ConversationDebugInfo>;
+    /**
+     * Retrieves the last read times for this conversation
+     *
+     * @returns A map keyed by inbox ID with the last read timestamp
+     * (nanoseconds since epoch)
+     */
+    lastReadTimes(): Promise<Record<string, number>>;
 }
 
 /**
@@ -508,17 +585,17 @@ declare class Dm<ContentTypes = unknown> extends Conversation<ContentTypes> {
      * Creates a new direct message conversation instance
      *
      * @param client - The client instance managing this direct message conversation
+     * @param codecRegistry - The codec registry instance
      * @param conversation - The underlying conversation instance
-     * @param isCommitLogForked
      */
-    constructor(client: Client<ContentTypes>, conversation: Conversation$1, isCommitLogForked?: boolean | null);
+    constructor(client: Client<ContentTypes>, codecRegistry: CodecRegistry, conversation: Conversation$1);
     /**
      * Retrieves the inbox ID of the other participant in the DM
      *
      * @returns Promise that resolves with the peer's inbox ID
      */
     get peerInboxId(): string;
-    getDuplicateDms(): Promise<Dm<ContentTypes>[]>;
+    duplicateDms(): Promise<Dm<ContentTypes>[]>;
 }
 
 /**
@@ -532,10 +609,10 @@ declare class Group<ContentTypes = unknown> extends Conversation<ContentTypes> {
      * Creates a new group conversation instance
      *
      * @param client - The client instance managing this group conversation
+     * @param codecRegistry - The codec registry instance
      * @param conversation - The underlying conversation object
-     * @param isCommitLogForked
      */
-    constructor(client: Client<ContentTypes>, conversation: Conversation$1, isCommitLogForked?: boolean | null);
+    constructor(client: Client<ContentTypes>, codecRegistry: CodecRegistry, conversation: Conversation$1);
     /**
      * The name of the group
      */
@@ -579,7 +656,7 @@ declare class Group<ContentTypes = unknown> extends Conversation<ContentTypes> {
     /**
      * The permissions of the group
      */
-    get permissions(): {
+    permissions(): {
         policyType: _xmtp_node_bindings.GroupPermissionsOptions;
         policySet: _xmtp_node_bindings.PermissionPolicySet;
     };
@@ -594,11 +671,11 @@ declare class Group<ContentTypes = unknown> extends Conversation<ContentTypes> {
     /**
      * The list of admins of the group
      */
-    get admins(): string[];
+    listAdmins(): string[];
     /**
      * The list of super admins of the group
      */
-    get superAdmins(): string[];
+    listSuperAdmins(): string[];
     /**
      * Checks if an inbox is an admin of the group
      *
@@ -670,7 +747,7 @@ declare class Group<ContentTypes = unknown> extends Conversation<ContentTypes> {
      *
      * @returns Boolean
      */
-    get isPendingRemoval(): boolean;
+    isPendingRemoval(): boolean;
 }
 
 /**
@@ -684,9 +761,10 @@ declare class Conversations<ContentTypes = unknown> {
      * Creates a new conversations instance
      *
      * @param client - The client instance managing the conversations
+     * @param codecRegistry - The codec registry instance
      * @param conversations - The underlying conversations instance
      */
-    constructor(client: Client<ContentTypes>, conversations: Conversations$1);
+    constructor(client: Client<ContentTypes>, codecRegistry: CodecRegistry, conversations: Conversations$1);
     /**
      * Retrieves a conversation by its ID
      *
@@ -710,7 +788,7 @@ declare class Conversations<ContentTypes = unknown> {
      * @returns Promise that resolves with the DM, if found
      * @see https://docs.xmtp.org/chat-apps/core-messaging/create-conversations#conversation-helper-methods
      */
-    getDmByIdentifier(identifier: Identifier): Promise<Dm<ContentTypes> | undefined>;
+    fetchDmByIdentifier(identifier: Identifier): Promise<Dm<ContentTypes> | undefined>;
     /**
      * Retrieves a message by its ID
      *
@@ -720,13 +798,13 @@ declare class Conversations<ContentTypes = unknown> {
      */
     getMessageById(id: string): DecodedMessage<ContentTypes> | undefined;
     /**
-     * Creates a new group conversation without syncing to the network
+     * Creates a new group conversation without publishing to the network
      *
      * @param options - Optional group creation options
      * @returns The new group
      * @see https://docs.xmtp.org/chat-apps/core-messaging/create-conversations#optimistically-create-a-new-group-chat
      */
-    newGroupOptimistic(options?: CreateGroupOptions): Group<ContentTypes>;
+    createGroupOptimistic(options?: CreateGroupOptions): Group<ContentTypes>;
     /**
      * Creates a new group conversation with the specified identifiers
      *
@@ -735,7 +813,7 @@ declare class Conversations<ContentTypes = unknown> {
      * @returns The new group
      * @see https://docs.xmtp.org/chat-apps/core-messaging/create-conversations#create-a-new-group-chat
      */
-    newGroupWithIdentifiers(identifiers: Identifier[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
+    createGroupWithIdentifiers(identifiers: Identifier[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
     /**
      * Creates a new group conversation with the specified inbox IDs
      *
@@ -744,7 +822,7 @@ declare class Conversations<ContentTypes = unknown> {
      * @returns The new group
      * @see https://docs.xmtp.org/chat-apps/core-messaging/create-conversations#create-a-new-group-chat
      */
-    newGroup(inboxIds: string[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
+    createGroup(inboxIds: string[], options?: CreateGroupOptions): Promise<Group<ContentTypes>>;
     /**
      * Creates a new DM conversation with the specified identifier
      *
@@ -753,7 +831,7 @@ declare class Conversations<ContentTypes = unknown> {
      * @returns The new DM
      * @see https://docs.xmtp.org/agents/build-agents/create-conversations#by-ethereum-address-1
      */
-    newDmWithIdentifier(identifier: Identifier, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
+    createDmWithIdentifier(identifier: Identifier, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
     /**
      * Creates a new DM conversation with the specified inbox ID
      *
@@ -762,7 +840,7 @@ declare class Conversations<ContentTypes = unknown> {
      * @returns The new DM
      * @see https://docs.xmtp.org/agents/build-agents/create-conversations#by-inbox-id-1
      */
-    newDm(inboxId: string, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
+    createDm(inboxId: string, options?: CreateDmOptions): Promise<Dm<ContentTypes>>;
     /**
      * Lists all conversations with optional filtering
      *
@@ -876,7 +954,7 @@ declare class Conversations<ContentTypes = unknown> {
      */
     streamMessageDeletions(options?: Omit<StreamOptions<string>, "disableSync" | "onFail" | "onRetry" | "onRestart" | "retryAttempts" | "retryDelay" | "retryOnFail">): Promise<AsyncStreamProxy<string>>;
     /**
-     * Retrieves HMAC keys for all conversations
+     * Gets the HMAC keys for all conversations
      *
      * @returns The HMAC keys for all conversations
      * @see https://docs.xmtp.org/chat-apps/push-notifs/push-notifs#get-hmac-keys-for-a-conversation
@@ -914,27 +992,32 @@ declare class Preferences {
     constructor(client: Client$1, conversations: Conversations$1);
     sync(): Promise<_xmtp_node_bindings.GroupSyncSummary>;
     /**
-     * Retrieves the current inbox state
+     * Retrieves the current inbox state of this client from the local database
+     *
+     * @returns Promise that resolves with the inbox state
+     */
+    inboxState(): Promise<_xmtp_node_bindings.InboxState>;
+    /**
+     * Retrieves the latest inbox state of this clientfrom the network
      *
-     * @param refreshFromNetwork - Optional flag to force refresh from network
      * @returns Promise that resolves with the inbox state
      */
-    inboxState(refreshFromNetwork?: boolean): Promise<_xmtp_node_bindings.InboxState>;
+    fetchInboxState(): Promise<_xmtp_node_bindings.InboxState>;
     /**
-     * Gets the latest inbox state for a specific inbox
+     * Retrieves the current inbox states for specified inbox IDs from the local
+     * database
      *
-     * @param inboxId - The inbox ID to get state for
-     * @returns Promise that resolves with the latest inbox state
+     * @param inboxIds - Array of inbox IDs to get state for
+     * @returns Promise that resolves with the inbox states for the inbox IDs
      */
-    getLatestInboxState(inboxId: string): Promise<_xmtp_node_bindings.InboxState>;
+    getInboxStates(inboxIds: string[]): Promise<_xmtp_node_bindings.InboxState[]>;
     /**
-     * Retrieves inbox state for specific inbox IDs
+     * Retrieves the latest inbox states for specified inbox IDs from the network
      *
      * @param inboxIds - Array of inbox IDs to get state for
-     * @param refreshFromNetwork - Optional flag to force refresh from network
-     * @returns Promise that resolves with the inbox state for the inbox IDs
+     * @returns Promise that resolves with the inbox states for the inbox IDs
      */
-    inboxStateFromInboxIds(inboxIds: string[], refreshFromNetwork?: boolean): Promise<_xmtp_node_bindings.InboxState[]>;
+    fetchInboxStates(inboxIds: string[]): Promise<_xmtp_node_bindings.InboxState[]>;
     /**
      * Updates consent states for multiple records
      *
@@ -966,24 +1049,6 @@ declare class Preferences {
     streamPreferences(options?: StreamOptions<UserPreferenceUpdate[]>): Promise<AsyncStreamProxy<UserPreferenceUpdate[]>>;
 }
 
-type SignMessage = (message: string) => Promise<Uint8Array> | Uint8Array;
-type GetIdentifier = () => Promise<Identifier> | Identifier;
-type GetChainId = () => bigint;
-type GetBlockNumber = () => bigint;
-type Signer = {
-    type: "EOA";
-    signMessage: SignMessage;
-    getIdentifier: GetIdentifier;
-} | {
-    type: "SCW";
-    signMessage: SignMessage;
-    getIdentifier: GetIdentifier;
-    getBlockNumber?: GetBlockNumber;
-    getChainId: GetChainId;
-};
-
-type BuiltInContentTypes = string | LeaveRequest | Reaction | ReadReceipt | Attachment | RemoteAttachment | Reply | TransactionReference | WalletSendCalls | Actions | Intent | MultiRemoteAttachment | GroupUpdated;
-type ExtractCodecContentTypes<C extends ContentCodec[] = []> = C extends readonly [] ? BuiltInContentTypes : [...C][number] extends ContentCodec<infer T> ? T | BuiltInContentTypes : BuiltInContentTypes;
 /**
  * Client for interacting with the XMTP network
  */
@@ -1274,14 +1339,6 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
      * @param installationIds - The installation IDs to revoke
      */
     static revokeInstallations(signer: Signer, inboxId: string, installationIds: Uint8Array[], env?: XmtpEnv, gatewayHost?: string): Promise<void>;
-    /**
-     * Gets the inbox state for the specified inbox IDs without a client
-     *
-     * @param env - The environment to use
-     * @param inboxIds - The inbox IDs to get the state for
-     * @returns The inbox state for the specified inbox IDs
-     */
-    static inboxStateFromInboxIds(inboxIds: string[], env?: XmtpEnv, gatewayHost?: string): Promise<_xmtp_node_bindings.InboxState[]>;
     /**
      * Changes the recovery identifier for the client's inbox
      *
@@ -1301,67 +1358,23 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
      */
     canMessage(identifiers: Identifier[]): Promise<Map<string, boolean>>;
     /**
-     * Checks if the specified identifiers can be messaged
-     *
-     * @param identifiers - The identifiers to check
-     * @param env - Optional XMTP environment
-     * @returns Map of identifiers to whether they can be messaged
-     */
-    static canMessage(identifiers: Identifier[], env?: XmtpEnv): Promise<Map<string, boolean>>;
-    /**
-     * Gets the key package statuses for the specified installation IDs
+     * Fetches the key package statuses from the network for the specified
+     * installation IDs
      *
      * @param installationIds - The installation IDs to check
      * @returns The key package statuses
      * @throws {ClientNotInitializedError} if the client is not initialized
      */
-    getKeyPackageStatusesForInstallationIds(installationIds: string[]): Promise<Record<string, _xmtp_node_bindings.KeyPackageStatus>>;
-    /**
-     * Gets the codec for a given content type
-     *
-     * @param contentType - The content type to get the codec for
-     * @returns The codec, if found
-     */
-    codecFor<ContentType = unknown>(contentType: ContentTypeId$1): ContentCodec<ContentType> | undefined;
-    /**
-     * Encodes content for a given content type
-     *
-     * @param content - The content to encode
-     * @param contentType - The content type to encode for
-     * @returns The encoded content
-     * @throws {CodecNotFoundError} if no codec is found for the content type
-     */
-    encodeContent(content: ContentTypes, contentType: ContentTypeId$1): _xmtp_node_bindings.EncodedContent;
+    fetchKeyPackageStatuses(installationIds: string[]): Promise<Record<string, _xmtp_node_bindings.KeyPackageStatus>>;
     /**
-     * Prepares content for sending by encoding it and generating send options from the codec
-     *
-     * @param content - The message content to prepare for sending
-     * @param contentType - The content type identifier for the appropriate codec
-     * @returns An object containing the encoded content and send options
-     * @throws {CodecNotFoundError} When no codec is registered for the specified content type
-     */
-    prepareForSend(content: ContentTypes, contentType: ContentTypeId$1): {
-        encodedContent: _xmtp_node_bindings.EncodedContent;
-        sendOptions: SendMessageOpts;
-    };
-    /**
-     * Decodes a message for a given content type
-     *
-     * @param message - The message to decode
-     * @param contentType - The content type to decode for
-     * @returns The decoded content
-     * @throws {CodecNotFoundError} if no codec is found for the content type
-     * @throws {InvalidGroupMembershipChangeError} if the message is an invalid group membership change
-     */
-    decodeContent<ContentType = unknown>(message: Message, contentType: ContentTypeId$1): ContentType;
-    /**
-     * Finds the inbox ID for a given identifier
+     * Fetches the inbox ID for a given identifier from the local database
+     * If not found, fetches from the network
      *
      * @param identifier - The identifier to look up
      * @returns The inbox ID, if found
      * @throws {ClientNotInitializedError} if the client is not initialized
      */
-    getInboxIdByIdentifier(identifier: Identifier): Promise<string | null>;
+    fetchInboxIdByIdentifier(identifier: Identifier): Promise<string | null>;
     /**
      * Signs a message with the installation key
      *
@@ -1379,6 +1392,23 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
      * @throws {ClientNotInitializedError} if the client is not initialized
      */
     verifySignedWithInstallationKey(signatureText: string, signatureBytes: Uint8Array): boolean;
+    /**
+     * Fetches the inbox states for the specified inbox IDs from the network
+     * without a client
+     *
+     * @param env - The environment to use
+     * @param inboxIds - The inbox IDs to get the state for
+     * @returns The inbox states for the specified inbox IDs
+     */
+    static fetchInboxStates(inboxIds: string[], env?: XmtpEnv, gatewayHost?: string): Promise<_xmtp_node_bindings.InboxState[]>;
+    /**
+     * Checks if the specified identifiers can be messaged
+     *
+     * @param identifiers - The identifiers to check
+     * @param env - Optional XMTP environment
+     * @returns Map of identifiers to whether they can be messaged
+     */
+    static canMessage(identifiers: Identifier[], env?: XmtpEnv): Promise<Map<string, boolean>>;
     /**
      * Verifies a signature was made with a public key
      *
@@ -1408,36 +1438,5 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
     static isInstallationAuthorized(inboxId: string, installation: Uint8Array, env?: XmtpEnv, gatewayHost?: string): Promise<boolean>;
 }
 
-declare const generateInboxId: (identifier: Identifier, nonce?: bigint) => string;
-declare const getInboxIdForIdentifier: (identifier: Identifier, env?: XmtpEnv, gatewayHost?: string) => Promise<string | null>;
-
-declare class CodecNotFoundError extends Error {
-    constructor(contentType: ContentTypeId$1);
-}
-declare class InboxReassignError extends Error {
-    constructor();
-}
-declare class AccountAlreadyAssociatedError extends Error {
-    constructor(inboxId: string);
-}
-declare class InvalidGroupMembershipChangeError extends Error {
-    constructor(messageId: string);
-}
-declare class MissingContentTypeError extends Error {
-    constructor();
-}
-declare class SignerUnavailableError extends Error {
-    constructor();
-}
-declare class ClientNotInitializedError extends Error {
-    constructor();
-}
-declare class StreamFailedError extends Error {
-    constructor(retryAttempts: number);
-}
-declare class StreamInvalidRetryAttemptsError extends Error {
-    constructor();
-}
-
-export { AccountAlreadyAssociatedError, ApiUrls, Client, ClientNotInitializedError, CodecNotFoundError, Conversation, Conversations, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY, DecodedMessage, Dm, Group, HistorySyncUrls, InboxReassignError, InvalidGroupMembershipChangeError, MissingContentTypeError, SignerUnavailableError, StreamFailedError, StreamInvalidRetryAttemptsError, createStream, generateInboxId, getInboxIdForIdentifier, isHexString, validHex };
-export type { AsyncStreamProxy, ClientOptions, ExtractCodecContentTypes, HexString, NetworkOptions, OtherOptions, Signer, StorageOptions, StreamCallback, StreamFunction, StreamOptions, StreamValueMutator, XmtpEnv };
+export { AccountAlreadyAssociatedError, ApiUrls, Client, ClientNotInitializedError, Conversation, Conversations, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY, DecodedMessage, Dm, Group, HistorySyncUrls, InboxReassignError, MissingContentTypeError, SignerUnavailableError, StreamFailedError, StreamInvalidRetryAttemptsError, createStream, generateInboxId, getInboxIdForIdentifier, isHexString, validHex };
+export type { AsyncStreamProxy, BuiltInContentTypes, ClientOptions, ContentOptions, EOASigner, EnrichedReply, ExtractCodecContentTypes, HexString, NetworkOptions, OtherOptions, SCWSigner, Signer, StorageOptions, StreamCallback, StreamFunction, StreamOptions, StreamValueMutator, XmtpEnv };