Quickstart

Check out the replit live code example:

• Javascript Live Example

Get started

yarn install @xmtp/xmtp-js ethers@5.7.0

Import libraries

To start with XMTP, install the XMTP client SDK:

const { Wallet } = require("ethers");
const { Client } = require("@xmtp/xmtp-js");

Initialize the wallet

You'll want to replace this with a wallet from your application

// You'll want to replace this with a wallet from your application
const wallet = Wallet.createRandom();
console.log("Wallet address: " + wallet.address);
//eg. Wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37

Create a client

A client is created that requires passing in a connected wallet that implements the Signer interface. Use client configuration options to change parameters of a client's network connection.

const xmtp = await Client.create(signer, { env: "dev" });
console.log("Client created", xmtp.address);
//eg. Client created 0xd8dA6BF26964aF9D7eEd9e03E53415D37

Example:

Check if an address is on the network

First, you need to check if the address you want to message is on the XMTP network. You can do this by calling client.canMessage with the address you want to message.

//Message this XMTP message bot to get an immediate automated reply:
//gm.xmtp.eth (0x937C0d4a6294cdfa575de17382c7076b579DC176) env:production
const WALLET_TO = "0x20B572bE48527a770479744AeC6fE5644F97678B";
const isOnProdNetwork = await xmtp.canMessage(WALLET_TO);
console.log("Can message: " + isOnProdNetwork);
//eg. Can message: true

Start a new conversation

You can create a new conversation with any EVM address activated on the XMTP network. For now, we are compatible with EVM wallets only.

const conversation = await xmtp.conversations.newConversation(WALLET_TO);
console.log("Conversation created", conversation);
//eg. Conversation created: {Object}

Send a message

To send a message, the recipient must have already started their client at least once and consequently advertised their key bundle on the network.

const message = await conversation.send("gm");
console.log("Message sent", message);
//eg. Message sent: {Object}

Stream messages

You can receive the complete message history in all conversations.

for await (const message of await xmtp.conversations.streamAllMessages()) {
  console.log(`New message from ${message.senderAddress}: ${message.content}`);
}
//eg. New message from 0xd8dA6BF26964aF9D7eEd9e03E53415D37: gm