> 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/protocols/occ-v1/core-concepts.md).

# Core concepts

The few ideas that explain OCC v1: one exchange is one record, identity is an account, and your keys decide who can read.

{% hint style="warning" %}
**Status: Production-ready, stable.** OCC v1 is the 4thTech protocol for on-chain mail, chat and file transfer on any EVM chain. It is supported; no new features are planned. For agent-to-agent exchange, see OCC v2 ([AgentLink](https://wiki.4thtech.io/products/agentlink.md)).
{% endhint %}

OCC v1 rests on four ideas.

## One exchange is one on-chain record

Each mail, chat message or file transfer produces one record on a blockchain. A chat message is short, so the (encrypted) message itself goes on chain. A mail carries more data, so the content is stored elsewhere and the chain records a link to it and a checksum.

{% hint style="info" %}
**Rule of thumb:** 1 mail, message or file exchange = 1 on-chain record.
{% endhint %}

See [Message flows](https://wiki.4thtech.io/protocols/occ-v1/message-flows.md) for both cases step by step.

## Identity is an account

There is no separate sign-up. A blockchain account (a wallet address) is your identity. Senders and receivers are addressed by account.

## Not your keys, not your messages

With encryption on, content is encrypted before it leaves the sender's device. Only the holders of the right keys can decrypt it. Nobody running the protocol can read your messages for you, and nobody can recover them if you lose your keys. Read [Encryption options](https://wiki.4thtech.io/protocols/occ-v1/encryption.md).

## App IDs

An integrator registers an app and gets an app ID. Messages sent through that app carry the ID, and the app's fees are tracked against it. See [Fees and app registration](https://wiki.4thtech.io/protocols/occ-v1/fees.md).

## Terms

| Term       | Meaning                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------- |
| Envelope   | The small JSON object that holds a mail's subject, content and attachment locations.        |
| Checksum   | A fingerprint of the stored envelope, recorded on chain so the receiver can detect changes. |
| Whitelist  | A list of accounts allowed to mail you.                                                     |
| Integrator | A developer or organisation that builds an app on OCC v1.                                   |
