> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/white-label/chat.md).

# Chat

Start one-to-one and group conversations in BlockChat, add members and send messages.

{% hint style="info" %}
**Status: Production-ready, stable.** The 4thTech SDK and the BlockMail & BlockChat white-label apps are supported; no new features are planned. Last release: SDK 0.5.13 (25 Nov 2025).
{% endhint %}

Chat messages are short. They are stored on the chain directly, so there is no storage step. One-to-one conversations are encrypted. For groups, you choose.

```mermaid
sequenceDiagram
  participant A as Sender app
  participant C as Chat contract (OCC v1)
  participant B as Recipient app
  A->>A: encrypt the message (if encryption is on)
  A->>C: send the message
  C-->>B: message-sent event
  B->>B: decrypt and show
  Note over A,C: Group conversations use a conversation hash. Member changes emit events too.
```

*Figure: How a chat message is sent and read: the message is stored on the chain directly, and the recipient's app listens for the event.*

## Start a one-to-one conversation

1. Open **Chat** and select the new conversation button.
2. In **New conversation**, choose **1 to 1**.
3. Enter the other person's address in **Receiver** and select **Create**. They must have registered with [Encryptor](https://wiki.4thtech.io/products/white-label/encryption.md); if not, the field shows an error. If your own Encryptor is not ready, the dialog shows the Encryptor widget instead.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--chat-new-conversation--one-to-one--light--1280.png`. New conversation dialog with the 1 to 1 form and a receiver address.
{% endhint %}

4. Type in **Write a message...** and send. Your wallet asks you to confirm each message as a transaction. Use a testnet while you try it out.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--chat-conversation--messages--light--1280.png`. Conversation with a list of messages and the message input.
{% endhint %}

## Start a group conversation

1. In **New conversation**, choose **Group**.
2. Turn **Use Encryption** on or off. It is on by default.
3. Enter a **Name**. Tick **Only creator can add new members** if you want to control who joins.
4. Enter each member's address in **Member**. Select **Add Member** for more fields.
5. Select **Create** and confirm in your wallet.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--chat-new-conversation--group-form--light--1280.png`. New conversation dialog with the Group form: name, options and member fields.
{% endhint %}

## Add members later

Open the conversation details, then select **Add members**. Enter addresses and confirm in your wallet. If only the creator can add members, this option is for the creator.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--chat-add-members--dialog--light--1280.png`. Add members dialog with one member address field.
{% endhint %}

## Conversation details

Open **Conversation details** to see the members, who the creator is and whether it is a group conversation.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--chat-conversation--details-members--light--1280.png`. Conversation details panel with the members list and creator.
{% endhint %}

## Good to know

* Every message and every membership change is a transaction that needs network fees.
* Messages stay on the chain. Removing a member (the remove icon in the members list, where you are allowed to) takes them off the group's member list but does not erase what was already sent.
