# Welcome to Immu3

The complete developer platform for pioneering the future of trusted human or AI agent on-chain communication with low-code tooling and configurability you need to accelerate from idea to launch.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>🔧</td><td><strong>Build, Integrate and Deploy</strong></td><td>on-chain mail, messaging or data file transfer apps and save engineering time by utilising easy-to-use SDKs and White labels.</td><td></td><td><a href="https://wiki.immu3.io/integrators/occ-white-labels">https://wiki.immu3.io/integrators/occ-white-labels</a></td><td></td></tr><tr><td>🤝</td><td><strong>Connect</strong></td><td>to custom decentralized storage nodes via dedicated service APIs and SDK, or enable end-user storage NFTs within your apps.</td><td></td><td><a href="https://wiki.immu3.io/integrators/architecture-by-layers/pollinationx-decentralized-storage">https://wiki.immu3.io/integrators/architecture-by-layers/pollinationx-decentralized-storage</a></td><td></td></tr><tr><td>⚙️</td><td><strong>Utalize</strong></td><td>multi-chain EVM protocol deployment for limitless partnerships and integrations.</td><td></td><td><a href="https://wiki.immu3.io/integrators/multi-chain">https://wiki.immu3.io/integrators/multi-chain</a></td><td></td></tr><tr><td>🚀</td><td><strong>Utalize</strong></td><td>Immu3 ElizaOS plugins and empower AI agents with on-chain communication capabilities.</td><td></td><td><a href="/pages/HerFWOrDtL7g5oUYdraa">/pages/HerFWOrDtL7g5oUYdraa</a></td><td></td></tr><tr><td>💰</td><td><strong>Benefit</strong></td><td>from the Protocol's built-in app owner fee layer for independent integrator economics.</td><td></td><td><a href="https://wiki.immu3.io/integrators/fees-and-integrator-economics">https://wiki.immu3.io/integrators/fees-and-integrator-economics</a></td><td></td></tr><tr><td>➡️</td><td><strong>Onboard</strong></td><td>users, connect to any major Web3 wallet and build user-friendly email, messaging, or data management apps.</td><td></td><td><a href="https://wiki.immu3.io/introduction/onboard">https://wiki.immu3.io/introduction/onboard</a></td><td></td></tr></tbody></table>

<figure><img src="/files/vQDzvKMrqFeuSjeT6umY" alt=""><figcaption></figcaption></figure>

## AppSuite

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="content-ref"></th></tr></thead><tbody><tr><td>✉️ <strong>Connect</strong></td><td>your wallet and take control of your mail communication. Whitelist your incoming communication and prevent spam, phishing and other security threats ➡️</td><td></td><td><a href="https://wiki.immu3.io/end-users/appsuite/blockcommunicator-app-user-guide">https://wiki.immu3.io/end-users/appsuite/blockcommunicator-app-user-guide</a></td><td><a href="https://wiki.immu3.io/dapps-and-clients/email-and-messaging-app-user-guide">https://wiki.immu3.io/dapps-and-clients/email-and-messaging-app-user-guide</a></td></tr><tr><td>💬 <strong>Experience</strong></td><td>true self-custodial and immutable DM. Own your conversation data, preventing data ownership loss and data mining ➡️ </td><td></td><td><a href="https://wiki.immu3.io/end-users/appsuite/blockcommunicator-app-user-guide">https://wiki.immu3.io/end-users/appsuite/blockcommunicator-app-user-guide</a></td><td><a href="https://wiki.immu3.io/dapps-and-clients/email-and-messaging-app-user-guide">https://wiki.immu3.io/dapps-and-clients/email-and-messaging-app-user-guide</a></td></tr><tr><td>📁 <strong>Communicate</strong></td><td>P2P or exchange large files globally without fear of security breaches ➡️</td><td></td><td><a href="https://wiki.w3xshare.com/how-to-use-it/send-and-receive-data-file-transfers/testnet-user-guide">https://wiki.w3xshare.com/how-to-use-it/send-and-receive-data-file-transfers/testnet-user-guide</a></td><td></td></tr><tr><td>🗄️ <strong>Store</strong></td><td>your data files in a self-custodial, decentralized and permissionless way ➡️</td><td></td><td><a href="https://wiki.pollinationx.io/solution-guides/dapps-and-nfts/pollinationx-drive-testnet-user-guide">https://wiki.pollinationx.io/solution-guides/dapps-and-nfts/pollinationx-drive-testnet-user-guide</a></td><td></td></tr></tbody></table>


# Start Here

Learn about The Immu3, the ultimate Web3-Infra stack for building and utilizing trusted on-chain communication applications.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Get Started</strong></td><td>Learn about the Immu3, The complete developer platform for pioneering the future of global on-chain communication.</td><td></td><td></td><td><a href="/pages/bAOkav157o6TDQzi0p4A#context">/pages/bAOkav157o6TDQzi0p4A#context</a></td></tr><tr><td><strong>Onboard</strong></td><td>Discover how you can build on-chain communication apps or learn how to use already deployed app suite.</td><td></td><td></td><td><a href="https://wiki.immu3.io/introduction/onboard">https://wiki.immu3.io/introduction/onboard</a></td></tr><tr><td><strong>Immu3 AppChain</strong></td><td>Use fast finality/low cost on-chain communication-specific Immu3 AppChain.</td><td></td><td></td><td><a href="https://wiki.immu3.io/immu3-appchain/intro-to-appchain">https://wiki.immu3.io/immu3-appchain/intro-to-appchain</a></td></tr><tr><td><strong>Integrator Dashboard</strong></td><td>Unlock the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps.</td><td></td><td></td><td><a href="https://wiki.immu3.io/integrators/clients/intro-to-integrator-dashboard">https://wiki.immu3.io/integrators/clients/intro-to-integrator-dashboard</a></td></tr><tr><td><strong>Deploy on-chain email or messaging app</strong></td><td>Deploy on-chain mail, messaging or data-sharing apps and save engineering time by utilising easy-to-use White labels.</td><td></td><td></td><td><a href="https://wiki.immu3.io/integrators/occ-white-labels">https://wiki.immu3.io/integrators/occ-white-labels</a></td></tr><tr><td><strong>Utilize the SDK</strong></td><td>Enjoy seamless SDK interactions with protocol smart contracts, storage providers, encryption methods, and the Encryptor extension.</td><td></td><td></td><td><a href="https://wiki.immu3.io/integrators/occ-sdk">https://wiki.immu3.io/integrators/occ-sdk</a></td></tr></tbody></table>

**Welcome!** This documentation later referred to as Docs will help you develop "true" Web3 communication dApps (i.e. decentralized applications) and help you learn how to use them. Here you will find concepts, how-to guides, quickstarts, tutorials, API & SDK references, code examples, release notes, and more.

### Context

{% hint style="info" %}
**Problem:** Centralized digital communication platforms force users to give up control of their data, which is mined, shared, and exploited for profit. This custodial model lacks trust, security, and privacy, leaving users vulnerable to data ownership loss, phishing, de-platforming, and mass surveillance—and it’s fundamentally incompatible with Web3. As Web3 activity increasingly moves on-chain, it’s clear that a secure, interoperable, self-custodial communication layer is essential to support the evolving landscape of human and AI agent interactions.
{% endhint %}

{% hint style="success" %}
**Value Proposition:** Immu3's low-code tooling stack—SDKs, APIs, and white-label UI clients—empowers developers to build self-custodial mail, messaging, and data-sharing apps, with true data ownership, eliminating data mining risks. Beyond human communication, Immu3 is primed to support on-chain AI agent interactions. As crypto payment rails drive AI agents on-chain, trusted communication platforms will be essential for human-to-AI and AI-to-AI exchanges. With AI-agent messaging expected to outpace human interactions, Immu3's model—where each message is a blockchain transaction—could lead to unprecedented transaction volumes, exceeding typical Web3 metrics.
{% endhint %}

### Welcome to Immu3

Immu3 is the ultimate Web3-Infra stack for building and utilizing on-chain communication applications. The complete developer platform for pioneering the future of global on-chain communication with low-code tooling and configurability developer needs to accelerate from idea to launch. Built on top of the Block Labs \[4thTech] OCC (i.e. on-chain communication) technology framework and CR Systems \[PollinationX] decentralized storage infra, the Immu3 in essence acts as the integrator focusing on the abstraction, adoption and commercialisation of this new technology.

{% tabs %}
{% tab title="Welcome to Immu3" %}
{% embed url="<https://youtu.be/YXOZb2Tbw5g?feature=shared>" %}
{% endtab %}
{% endtabs %}

{% hint style="success" %}
**Core primitives;**

💡 1 blockchain mail/message/data-sharing = 1 L1/L2/L3 transaction \
💡 not your keys = not your mail/message/data
{% endhint %}

{% hint style="success" %}
**Apps built with the Immu3 infra-stack are based on decentralized principles;**

(1) pseudonymous login via Web3 wallets;\
(2) self-custodial and immutable;\
(3) on-chain verifiable;\
(4) communication data is accessible only to the private key owner; \
(5) end-to-end (i.e. E2E) communication encryption enabled by self-custodial [Encryptor extension](https://chrome.google.com/webstore/detail/encryptor/feolajpinjjfikmmeknkdjbllbppojij?hl=en-GB\&authuser=3);\
(6) encrypted attachments and big data files are stored on decentralized storage via [PX](/integrators/architecture-by-layers/pollinationx-decentralized-storage-infra) service;\
(7) no personal data whatsoever is collected, and; \
(8) open-source.
{% endhint %}

{% hint style="danger" %}
**Warning:** None of the protocols from the native Immu3 ecosystem would ever ask for your seed passphrase!&#x20;
{% endhint %}

### Products

* [**Integrator Dashboard**](https://wiki.immu3.io/integrators/clients/intro-to-integrator-dashboard)**:** Unlocks the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps while reducing deployment time from the duration of months to under an hour.
* [**End-user App Suite**](https://wiki.immu3.io/end-users/end-users-app-suite)**:** Offers a self-custodial Web3 alternative to traditional email, messaging, and data-sharing platforms.&#x20;
* [**AppChain**](https://wiki.immu3.io/immu3-appchain/intro-to-appchain)**:** Delivers a smart contract EVM AppChain with reliability, scalability and security needed within use cases of on-chain communication.
* [**Multi-chain**](https://wiki.immu3.io/integrators/multi-chain)**:** Creates multi-chain protocol instances and enables ready-to-use compatibility with multiple EVM chains.
* [**ElizaOS Plugin:**](/integrators/use-cases-and-integrations/elizaos) Enable devs to give AI agents additional powers of permissionless on-chain communication and data storage ownership.

### Associated Fees

Web3 mainly works on the PAYGO (i.e. pay-as-you-go) model, meaning the user has to pay for every transaction, ergo pay for every mail, message, or data transfer. To make on-chain communication more viable, development is being done that will in parallel to PAYGO also enable subscription-based models, so the users will be able to pay a monthly subscription fee to access block space and communicate without the hurdle of paying for every transaction. For a deeper look jump to the [Fees](/integrators/fees-and-integrator-economics) chapter.

### Official Ecosystem Links

{% tabs %}
{% tab title="Immu3 (infra stack)" %}

```
https://immu3.io
https://wiki.immu3.io
https://dashboard.immu3.io (TBA)
https://github.com/immu3-io
```

{% endtab %}

{% tab title="4thTech (framework)" %}

```
https://4thtech.io
https://wiki.4thtech.io
https://github.com/4thtech
```

{% endtab %}

{% tab title="PollinationX (infra)" %}

```
https://pollinationx.io
https://wiki.pollinationx.io
https://app.pollinationx.io
https://testnet.pollinationx.io
https://github.com/pollinationx
```

{% endtab %}

{% tab title="Encryptor (extension)" %}

```
https://chrome.google.com/webstore/detail/encryptor/feolajpinjjfikmmeknkdjbllbppojij?hl=en
https://github.com/4thtech/encryptor-extension
```

{% endtab %}

{% tab title="BlockCommunicator (dApp)" %}

```
https://blockcommunicator.com
https://testnet.blockcommunicator.com
https://app.blockcommunicator.com
```

{% endtab %}

{% tab title="W3XShare (dApp)" %}

```
https://w3xshare.com
https://wiki.w3xshare.com
https://testnet.w3xshare.com
```

{% endtab %}
{% endtabs %}


# Ecosystem Overview

To make scalable on-chain communication possible, an infrastructure ecosystem of frameworks, protocols, clients, and dApps emerged;

Here are some clarifications of various areas within the "Immu3" ecosystem:

* **CR Systems \[Immu3]:** Acts as `Level-1` integrator of Block Labs \[4thTech] on-chain communication technology, focusing on the abstraction, adoption and commercialization while offering `Level-2` permissionless licences to on-chain communication dApp developers.
* **CR Systems \[PollinationX]:** Suite of back-end services that enable developers to connect to custom decentralized storage nodes via dedicated service API & SDK, while utilizing the read-and-write methods of supported decentralized storage out-of-the-box.
* **Block Labs \[4thTech]:** The company and the initiative which developed the genesis OCC Protocol, along with the OCC SDK and BlockMail & BlockChat white-label framework.&#x20;
* **OCC Protocol v.1 \[4thTech]:** A suite of EVM smart contracts developed by the 4thTech initiative, that together create an on-chain communication framework and facilitate data ownership retention within the peer-to-peer mailing, messaging, data-sharing, or any other form of on-chain communication.
* **Encryptor extension \[4thTech]:** The Google Chrome extension, developed by the 4thTech initiative adds the communication encryption layer currently not supported in major wallets.
* **AppChain \[Immu3]:** A public EVM smart contract platform that offers reliability, scalability and security needed within use cases of on-chain communication.
* **Integrator Dashboard \[Immu3]:** Unlocks the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps while reducing deployment time from the duration of months to under an hour, while enabling the model of the w3CaaS (i.e. web3 communication as a service).
* **End-user app suite \[Immu3]:** Offers a self-custodial Web3 alternative to legacy email, messaging and data-sharing communication platforms.

<figure><img src="/files/cpuoLcW0TU32ohXjA32N" alt=""><figcaption></figcaption></figure>


# Onboard

Discover how you can use this modular technology to build key genesis on-chain communication dApps or learn how to use already deployed BlockCommunicator, 4P Super App, W3XShare, or PX Drive.

### Onboard by Learning

1. [Read](https://bit.ly/immu3-thesis) the \[Immu3] Thesis
2. Explore the infra-stack code: \[[4thTech](https://github.com/4thtech)], \[[Immu3](https://github.com/immu3-io)], \[[PollinationX](https://github.com/pollinationx/)]
3. [Browse](https://wiki.immu3.io/introduction/library) through the \[Immu3] Library

### Onboard by Building

1. One-click Deploy BlockMail or BlockChat White labels, Launch the Integrator Dashboard (TBA)
2. [Build](https://wiki.immu3.io/builders/occ-white-labels) your BlockMail, BlockChat or Data file sharing dApp
3. [Plug-in](https://wiki.immu3.io/builders/px-decentralized-storage) to decentralized storage

### Onboard by Experimenting

1. [Connect](https://app.the4thpillar.io/) your wallet and test drive the white-label-based integrator \[4P] Email & Chat Super App
2. [Connect](https://testnet.blockcommunicator.com/) your wallet and test drive the white-label-based \[BlockCommunicator] BlockMail & BlockChat App
3. [Connect](https://testnet.w3xshare.com/) your wallet and test drive the self-custodial integrator \[W3XShare] data-sharing App
4. [Connect](https://drive.pollinationx.io) your wallet and test drive the \[PX Drive] decentralized storage “cloud storage like” App


# Community

The Immu3 community is a great place to learn, get help, test-drive the OCC dApps, and find interesting people to work with.

### X (ex-Twitter)

Immu3 X (ex-Twitter) channels help stay up-to-date with the latest ecosystem developments while keeping tabs on the growing community.&#x20;

| X profile         | Description                                  | Link                                      |
| ----------------- | -------------------------------------------- | ----------------------------------------- |
| @immu3\_io        | \[Immu3] infra stack                         | [➡️](https://twitter.com/immu3_io)        |
| @4thtechProject   | \[4thTech] OCC framework                     | [➡️](https://twitter.com/4thtechProject)  |
| @w3xshare         | Integrator \[W3XShare] data file sharing App | [➡️](https://twitter.com/w3xshare)        |
| @PollinationX\_io | \[PX] decentralized storage service          | [➡️](https://twitter.com/PollinationX_io) |
| @4pfour           | Integrator \[4P] Email & Chat Super App      | [➡️](https://twitter.com/4pfour)          |

### YouTube

Immu3 YouTube channels provide easy access to solution tutorials and user guides.

| YouTube profile | Description                             | Link                                          |
| --------------- | --------------------------------------- | --------------------------------------------- |
| @immu3\_io      | \[Immu3] infra stack                    | [➡️](https://www.youtube.com/@immu3_io)       |
| @4thtechProject | \[4thTech] OCC framework                | [➡️](https://www.youtube.com/@4thtechProject) |
| @4PProject      | Integrator \[4P] Email & Chat Super App | [➡️](https://www.youtube.com/@4PProject)      |

### GitHub Repositories

Contributions from the development community are highly encouraged and appreciated. Feel free to submit issues, pull requests, or offer general feedback.

| Projects & Repos | Description                                         | Link                                   |
| ---------------- | --------------------------------------------------- | -------------------------------------- |
| /immu3-io        | OCC dApps, tools and some smart contracts...        | [➡️](https://github.com/immu3-io)      |
| /4thtech         | OCC protocol, SDK, white-labels, static assets...   | [➡️](https://github.com/4thtech)       |
| /pollinationx    | API, SDK, pxDrive, pxDApp...                        | [➡️](https://github.com/pollinationx/) |
| /4P-project      | 4P white-label dApp fork, static assets and more... | [➡️](https://github.com/4P-project)    |


# FAQ

## Let's get started

### 1. What is Immu3?

Immu3 is the complete developer platform for pioneering the future of global on-chain communication with low-code tooling and configurability you need to accelerate from idea to launch.

### 2. Why is on-chain communication important?

In apps built on the Immu3 infra stack, each mail, message or data file sharing is an L1/L2 transaction, while larger files are stored on decentralized storage. This model enables true decentralized communication that is non-custodial, permissionless, immutable, and resistant to Web2 data mining, contrasting sharply with traditional off-chain centralized communication.

### 3. What is the difference between legacy Web2 communication platforms and apps built on Immu3? <a href="#id-3.-what-is-the-difference-between-legacy-web2-communication-platforms-and-4p-super-app" id="id-3.-what-is-the-difference-between-legacy-web2-communication-platforms-and-4p-super-app"></a>

Legacy email applications use centralized databases and often lack E2E encryption. Users pay with their data, which is mined by the app. This Web2 model leads to data ownership loss, potential de-platforming, identity theft, spam, spoofing, and privacy loss.

The Immu3-based apps can be characterised as decentralized Web3 applications with no centralized database, giving users full control over their data. This approach prevents Web2 issues like data mining, data ownership loss, and de-platforming. It ensures secure, permissionless, immutable, self-custodial P2P on-chain communication.

### 4. What is the difference between dMail/dChat and BlockMail/BlockChat?

We refer to blockchain-based Mail/Chat as BlockMail/BlockChat. The Immu3 platform supports on-chain communication, with the level of decentralization matching that of the underlying network. Hence, terms like decentralized Mail/Chat, or dMail/dChat, are also applicable. However, given potential questions about some blockchain networks' decentralization, we prefer BlockMail/BlockChat. Sometimes the term on-chain email/message is also used within the Immu3 documentation. Ultimately, the choice of naming comes down to user preference.

### 5. Who can use Immu3?

Immu3 is an infrastructure and protocol stack platform for integrators to develop on-chain communication-based mail, messaging, and data-sharing apps. Simultaneously, the Immu3  AppSuite was created to provide permissionless access for anyone to use. Users can connect their MetaMask, Coinbase, or WalletConnect-supported wallets to experience on-chain communication within polished Web3 UIs:

* **BlockCommunicator**: A blockchain-based alternative to traditional email and messaging. This app allows users to communicate on-chain in a self-custodial manner, ensuring security and preserving data ownership.
* **W3XShare**: A decentralized alternative to "WeTransfer," enabling secure, self-custodial data file sharing that protects against data ownership loss and data mining.
* **PX Drive:** A decentralized storage application that allows users to store and access files online in a true self-custodial and permissionless way.

### 6. What is the integration cost?

There is no cost for integrators to utilise the OCC (i.e. on-chain communication) SDK and White labels. Immu3 charges the protocol base fee to earn money. To understand monetization read the [Fees & Integrator Economics](https://wiki.immu3.io/integrators/fees-and-integrator-economics) chapter.

### 7. What is the cost of using Immu3 AppSuite?

Parallel to the underlying L1/L2 transaction gas cost, the service fees (i.e. protocol fees) are also settled on the smart contract level and are applicable for every mail, message or data-sharing transaction. Total user cost equals the sum of the L1/L2 transaction gas and the service fees. The gas and service fees converge and manifest as one end-user communication transaction fee. [Read more](https://wiki.immu3.io/integrators/fees-and-integrator-economics).

### 8. How can I become an integrator and do I need to be a developer?

Permissionless integrator licences will be available via the Immu3 Integrator Dashboard and are perfect for teams wanting to build their on-chain communication apps. The Integrator Dashboard will unlock the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps. Anyone, not only developers will be able to deploy the mail or messaging apps in an hour.

## Technical

### 9. How does it work? <a href="#id-6.-how-does-it-work" id="id-6.-how-does-it-work"></a>

The message exchange happens on-chain as one short message represents one L1/L2 blockchain transaction. As the mailing or data file sharing process is data heavier, lite encrypted JSON objects are created to hold mail metadata. The link to this metadata and checksum is recorded on the chain as a blockchain transaction. So again, the core primitive described by the formula below applies;

* 💡1 blockchain mail/message/data-sharing= 1 L1/L2-TX

### 10. Which blockchain does Immu3 support? <a href="#id-7.-which-blockchain-can-i-use-to-connect-to-4p" id="id-7.-which-blockchain-can-i-use-to-connect-to-4p"></a>

Immu3 is supporting all EVM (e.g., Ethereum, Binance Smart Chain, Polygon, etc.), but is adding deployments in a planned timeframe. The first batch of deployments includes Fantom Opera, Oasis, Zeta, Edgeware, Arthera and Immu3 blockchains.

### 11. Where is my data stored? <a href="#id-9.-where-is-my-data-stored" id="id-9.-where-is-my-data-stored"></a>

Integrators can select the storage used within their apps, determining the data storage location. The OCC SDK and White labels integrate PollinationX's decentralized storage service by default. When chosen, it utilizes BTFS (i.e. Bittorrent file system) for self-custodial storage of encrypted user data. In the end-user AppSuite, mails and attachments are encrypted and stored on both decentralized storage and local devices, while encrypted messaging data is stored on-chain.

## User Experience & Features <a href="#user-experience-and-features" id="user-experience-and-features"></a>

### 12. Can I send images, videos and attachments through Immu3 AppSuite? <a href="#id-10.-can-i-send-images-videos-and-attachments-through-4p" id="id-10.-can-i-send-images-videos-and-attachments-through-4p"></a>

Yes, you can send any type of data file as a mail attachment through BlockCommunicator or use the W3XShare data file transfer app for larger data files. The user's PX sNFT determines storage availability (e.g., 100MB, 1GB, 10GB, 20GB) and by that, it defines the data file transfer size.&#x20;

### 13. What is the PX sNFT and do I need it? <a href="#id-11.-what-is-the-px-snft-and-do-i-need-it" id="id-11.-what-is-the-px-snft-and-do-i-need-it"></a>

PX sNFTs (i.e. PollinationX Decentralized Storage NFTs) let users mint self-custodial storage units with specific capacities (e.g., 100MB, 5GB, 10GB, 20GB, 100GB) for upload bandwidth. PollinationX offers the first 100MB sNFT of storage for free. Users can upgrade their storage with larger PX sNFTs. Unlike centralized storage, which often mines and sells user data for "free" plans, PX sNFTs ensure your data remains private. If you're only using text messaging within the BlockCommunicator without data or media file exchanges, PX sNFTs are not needed.

### 14. Why do I need to install the Encryptor extension into my browser? <a href="#id-12.-why-do-i-need-to-install-the-encryptor-extension-into-my-browser" id="id-12.-why-do-i-need-to-install-the-encryptor-extension-into-my-browser"></a>

Encryptor extension adds the communication end-to-end encryption layer within the BlockCommunicator app that is currently not supported in major wallets. It enables user encryption self-custody not available before in any digital communication.

### 15. How do I enable the Premium BlockCommunicator version? <a href="#id-13.-how-do-i-enable-pro-version" id="id-13.-how-do-i-enable-pro-version"></a>

BlockCommunicator Premium unlocks advanced mail and chat features like the send mail tab, mail whitelisting, chat group creation and lower transaction fees. It requires a Premium subscription which you can enable within the app.&#x20;

### 16. Can I create a group chat in BlockCommunicator? <a href="#id-14.-can-i-create-a-group-chat-in-4p" id="id-14.-can-i-create-a-group-chat-in-4p"></a>

Yes, Premium users can create encrypted on-chain group chats. They can create unlimited group chats with any number of participants and manage groups by adding or removing member wallet addresses.

### 17. How does mail address whitelisting work? <a href="#id-15.-how-does-email-address-whitelisting-work" id="id-15.-how-does-email-address-whitelisting-work"></a>

Mail address whitelisting is a smart contract feature that allows you to whitelist specific wallet addresses, permitting them to contact you. This provides an ultimate filter and true security tool. It is available in the BlockCommunicator Premium version.

## Other

### 18. The Team behind Immu3?

Immu3 represents an open-source collection of protocols created by a community of researchers and developers. The repositories are maintained by the Immu3 core team with contributions made by approximately 8 developers.

### 19. How can I contribute? <a href="#id-17.-how-can-i-contribute" id="id-17.-how-can-i-contribute"></a>

Contributions from the development community are highly encouraged and appreciated. Feel free to submit GitHub issues, pull requests, or offer general feedback.


# Library

Dive deeper into 10+ years of research and development, discover what we learned during the years putting together this amaizing on-chain communication technology.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>📑 <strong>AI-Agent-to-AI-Agent Trusted Communication Layer Thesis</strong></td><td><em>Dr. Tali Režun, 8th of January 2025</em></td><td><a href="https://x.com/talirezun/status/1876913835082154168">https://x.com/talirezun/status/1876913835082154168</a></td></tr><tr><td>🎙️<strong>LFD Closing Party. Spaces with Dr. Tali Režun &#x26; Tanssi Network</strong></td><td>X Spaces, 2024</td><td><a href="https://x.com/TanssiNetwork/status/1828792962542878996">https://x.com/TanssiNetwork/status/1828792962542878996</a></td></tr><tr><td>📑 <strong>The Road to Data Ownership and Secure, Non-custodial Communication</strong></td><td><em>Immu3 Thesis, 2024</em></td><td><a href="https://bit.ly/immu3-thesis">https://bit.ly/immu3-thesis</a></td></tr><tr><td>📑 <strong>Beyond Encryption: Block Labs’ OCC Tech Pioneers Next-Level Email, Messaging &#x26; Data File Transfer Communication Security</strong></td><td><em>Dr. Tali Režun &#x26; Denis Jazbec , 2th of February 2024</em></td><td><a href="https://medium.com/4thtech/beyond-encryption-next-level-email-messaging-data-file-transfer-communication-security-3194fdffce5f">https://medium.com/4thtech/beyond-encryption-next-level-email-messaging-data-file-transfer-communication-security-3194fdffce5f</a></td></tr><tr><td>📑 <strong>Revolutionising Communication: A Comprehensive Analysis of 4P Mail &#x26; Chat in Contrast to Existing Web2 &#x26; Web3 Communication Platforms</strong></td><td><em>Ian Božič &#x26; 4P team , 25th of january 2024</em></td><td><a href="https://medium.com/4p-project/comprehensive-analysis-of-4p-dmail-dchat-in-contrast-to-existing-web2-web3-platforms-ef2feff72e0c">https://medium.com/4p-project/comprehensive-analysis-of-4p-dmail-dchat-in-contrast-to-existing-web2-web3-platforms-ef2feff72e0c</a></td></tr><tr><td>🎬 <strong>The Road to Data Ownership &#x26; Secure Communication. Web3 Stronger Together with Dr. Tali Režun</strong></td><td>YouTube, 2023</td><td><a href="https://www.youtube.com/live/C1ufcyztAnw?feature=shared">https://www.youtube.com/live/C1ufcyztAnw?feature=shared</a></td></tr><tr><td>📑 <strong>Immu3 to Bring Next-Gen On-Chain Communication With Successful EVM Appchain Deployment Through Tanssi</strong></td><td><em>Tanssi, 26th of October 2023</em></td><td><a href="https://www.tanssi.network/post/collaboration-tanssi-immu3">https://www.tanssi.network/post/collaboration-tanssi-immu3</a></td></tr><tr><td>📑 <strong>From online to on-chain, the evolution of digital communication</strong></td><td><em>Dr. Tali Režun, 19th of October 2023</em></td><td><a href="https://medium.com/4thtech/from-online-to-on-chain-the-evolution-of-digital-communication-0fb201f98df1">https://medium.com/4thtech/from-online-to-on-chain-the-evolution-of-digital-communication-0fb201f98df1</a></td></tr><tr><td>📑 <strong>Human “on-chain” Communication Dedicated Protocol &#x26; SDK</strong></td><td><em>4thTech, 23th of August 2023</em></td><td><a href="https://medium.com/4thtech/human-on-chain-communication-dedicated-protocol-sdk-a3f35d68eedf">https://medium.com/4thtech/human-on-chain-communication-dedicated-protocol-sdk-a3f35d68eedf</a></td></tr><tr><td>📑 <strong>“on-chain” communication technology framework</strong></td><td><em>4thTech Whitepaper, Dr. Tali Režun &#x26; Denis Jazbec, 2018 - 2023</em></td><td><a href="https://github.com/4thtech/static-assets/raw/main/pdf/whitepaper.pdf">https://github.com/4thtech/static-assets/raw/main/pdf/whitepaper.pdf</a></td></tr><tr><td>📑 <strong>PollinationX (PX); Decentralized Storage Infrastructure and Service Layer</strong></td><td>PX Whitepaper, David Tacer, <em>Dr. Tali Režun &#x26; Denis Jazbec, 2024</em></td><td><a href="https://bit.ly/PX-whitepaper">https://bit.ly/PX-whitepaper</a></td></tr><tr><td>🎙️<strong>Bringing Decentralized Storage to the Masses. Talk with David Tacer, PollinationX Co-Founder</strong></td><td>Blockchain Recorded Podcast EP58, 2023</td><td><a href="https://open.spotify.com/episode/6nOzF4wYNsIZKRRZqTSgaU?si=I6n4iQyYRji1PA8QQwri3Q">https://open.spotify.com/episode/6nOzF4wYNsIZKRRZqTSgaU?si=I6n4iQyYRji1PA8QQwri3Q</a></td></tr><tr><td>🎙️<strong>Arthera &#x26; PollinationX: Decentralized Storage Architecture. Spaces with Laurent Perello &#x26; David Tacer</strong></td><td>X Spaces, 2023</td><td><a href="https://x.com/PollinationX_io/status/1702710829345292787">https://x.com/PollinationX_io/status/1702710829345292787</a></td></tr></tbody></table>


# Branding

Welcome to the Immu3 Brand & Marketing page

Follow these guidelines when promoting Immu3 in marketing communications, including advertising, articles, websites, and printed promotions.

Immu3’s logotype is constructed and designed from custom-built, modular forms. It draws its inspiration from code brackets, rotating and combining them into the unique logomark shape.

### Clearspace

Space surrounding the logo or logomark is needed to prevent distortions and creative misunderstanding. Please see the minimum spacing specifications below.&#x20;

<figure><img src="/files/mleZuBXix5CxjQfUeFS3" alt=""><figcaption></figcaption></figure>

### Colours

| Immu3 Green | Immu3 Black | Immu3 Gradient    |
| ----------- | ----------- | ----------------- |
| #56bf9d     | #231f20     | #56bf9d / #231f20 |

### Asset Downloads

<table><thead><tr><th>Main Logotype</th><th width="222.33333333333331">Logomark</th><th>Gradient</th></tr></thead><tbody><tr><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-logo-black.png">immu3-logo-black.png</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-icon-black.png">immu3-icon-black.png</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/98ba3560a0ee8d4d051176d96225eb691adb5f59/image/immu3-gradient.png">immu3-gradient.png</a></td></tr><tr><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-logo-black.svg">immu3-logo-black.svg</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-icon-black.svg">immu3-icon-black.svg</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/98ba3560a0ee8d4d051176d96225eb691adb5f59/image/immu3-gradient.svg">immu3-gradient.svg</a></td></tr><tr><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-logo-white.png">immu3-logo-white.png</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-icon-white.png">immu3-icon-white.png</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/98ba3560a0ee8d4d051176d96225eb691adb5f59/image/immu3-gradient-and-logo.png">immu3-gradient-and-logo.png</a></td></tr><tr><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-logo-white.svg">immu3-logo-white.svg</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/aaf03e325e7cb0e289e46e0155a88e20b63d2d49/image/immu3-logo-white.svg">immu3-icon-white.svg</a></td><td><a href="https://github.com/immu3-io/static-assets/blob/98ba3560a0ee8d4d051176d96225eb691adb5f59/image/immu3-gradient-and-logo.svg">immu3-gradient-and-logo.svg</a></td></tr></tbody></table>


# AppSuite

Offers a self-custodial Web3 alternative to traditional email, messaging, and data-sharing platforms. It includes BlockCommunicator, W3XShare, and PX apps, with plans to add more on-chain communication-based applications.

* **BlockCommunicator**: A blockchain-based alternative to traditional email and messaging. This app allows users to communicate on-chain in a self-custodial manner, ensuring security and preserving data ownership.
* **W3XShare**: A decentralized alternative to "WeTransfer," enabling secure, self-custodial data file sharing that protects against data ownership loss and data mining.
* **PX dApp:** A decentralized storage application that simplifies the usage of decentralized storage networks while serving as a developer dashboard and an end-user file hosting service.


# BlockCommunicator App User Guide

This is the BlockCommunicator App manual page. Follow the steps for easier onboarding and access to all needed information.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>1️⃣ <strong>Wallet Setup</strong></td><td>Install, login, fund your wallet and connect to BlockCommunicator App.</td><td></td></tr><tr><td>2️⃣ <strong>Dashboard Setup</strong></td><td>Setup Encryptor, Mint a Storage NFT, Enable premium features</td><td></td></tr><tr><td>3️⃣ <strong>Sending &#x26; Receiving Blockmails</strong></td><td>Send encrypted on-chain BlockMails or setup the incoming mail whitelist.</td><td></td></tr><tr><td>4️⃣ <strong>Messaging &#x26; Group Messaging</strong></td><td>Message or create on-chain encrypted messaging groups.</td><td></td></tr></tbody></table>

### Wallet Setup, App Connection and Blockchain Choice

BlockCommunicator is a Web3-native application supporting [MetaMask](https://support.metamask.io/getting-started/getting-started-with-metamask/), [Coinbase](https://www.coinbase.com/learn/tips-and-tutorials/how-to-set-up-a-crypto-wallet), and Wallet Connect. We recommend beginners take the [MetaMask Web3 101](https://learn.metamask.io/overview) course before starting.

Since BlockCommunicator app services run on-chain, ensure your wallet has enough gas for setup and operations. Currently, we support Fantom Opera, requiring FTM gas tokens.&#x20;

BlockCommunicator app is a multi-chain application. Users can choose between several supported EVM blockchains. We recommend browsing the [supported network list](https://wiki.immu3.io/integrators/multi-chain) and choosing the blockchain most suited to your needs.

Steps:

* ⚙️ Install and login to a supported wallet
* 💰 Fund your wallet with gas
* 🤝 Connect your wallet with the BlockCommunicator App;  [Testnet](https://testnet.blockcommunicator.com), [Mainnet](https://app.blockcommunicator.com)
* 🔗 Select blockchain rails

### Dashboard Setup <a href="#dashboard-setup" id="dashboard-setup"></a>

The BlockCommunicator dashboard is your mission control within the application. It gives you an overview, lets you set up self-custodial communication encryption via the Encryptor extension and manage decentralized storage via PX Storage NFTs.

The Encryptor extension adds an encryption layer for blockchain-based mail and messages. A one-time on-chain transaction, requiring gas, saves the sender/recipient's public key.

Decentralized storage and bandwidth are used in communication. PX Storage NFTs, which can be minted as needed, enable self-custodial storage management. Bandwidth usage depends on the number of uploads to decentralized storage.

Steps:

* ⚙️ Download and install the [Encryptor extension](https://chrome.google.com/webstore/detail/encryptor/feolajpinjjfikmmeknkdjbllbppojij?authuser=3\&hl=en-GB) from the Google Chrome Store
* 🔧 Set your Encryptor password and save your seed words
* ⛓️ "**Register Encryptor**" and confirm the transaction with your wallet
* 👌 "**Connect**" your PX Storage NFT and confirm the transaction with your wallet
* ⛏️ "**Mint**" your 100MB Free PX Storage NFT confirm the transaction with your wallet

{% tabs %}
{% tab title="Install & Register the Encryptor" %}
{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=113>" %}
{% endtab %}

{% tab title="Mint the PX Storage NFTs" %}
{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=202>" %}
{% endtab %}
{% endtabs %}

{% hint style="success" %}
**Encryptor options;** (1) Unlock your Encryptor = Your Encryptor extension is currently locked. Please unlock it to resume secure communication. (2) Register Your Encryptor = Please complete your registration with the Encryptor extension by creating a transaction on the smart contract. This step is essential to activate the extension’s full capabilities and adds its visibility on the blockchain making the connection between the sender & recipient possible. **PX Storage NFT and Bandwidth upgrade options;** (1) Upgrade existing PX Storage NFT (i.e. every NFT included a specific number of Bandwidth uploads) by choosing between available packages. (2) Mint new PX Storage NFT by choosing between available packages. (3) Buy additional Bandwidth.
{% endhint %}

### Sending and receiving on-chain mails <a href="#how-to-send-data-files-using-polygon-or-arbitrum-mainnets-1" id="how-to-send-data-files-using-polygon-or-arbitrum-mainnets-1"></a>

The BlockCommunicator app empowers you to send and receive end-to-end encrypted BlockMails, protecting against data mining, phishing, spoofing, spam, and identity theft. The sender and receiver must be on the same blockchain, as cross-chain emailing is not supported. While encryption is optional, we strongly encourage its use. On-chain communication incurs various [fees](https://wiki.immu3.io/builders/fees-and-integrator-economics) throughout the process.

Sending Blockmails:

* ✉️ Access the "**Compose new**" page available within the Mail menu
* 📄 Fill out the email data form and add the attachments
* 🚀 Click the "**Send**" button and confirm the transaction with your wallet

Receiving Blockmails:

* 📥 Access the "**Inbox**" page available within the Mail menu
* 📨 Review your Blockmails
* ↩️ Reply if needed

Account Whitelisting:

* Access the "**Settings**" page available within the main menu
* Add accounts (wallets) by pasting them in the designated form
* "**Add Account**" and confirm the transaction with your wallet

{% tabs %}
{% tab title="Sent your first BlockMail" %}
{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=271>" %}
{% endtab %}

{% tab title="Enable Address Whitelisting" %}
{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=372>" %}
{% endtab %}
{% endtabs %}

### **Messaging & Group Messaging**

The BlockCommunicator app lets you send end-to-end encrypted DMs and create on-chain group chats, fully controlled by users and resistant to data mining. Both sender and receiver must be on the same blockchain, as cross-chain messaging is not supported. On-chain messaging incurs various [fees](https://wiki.immu3.io/builders/fees-and-integrator-economics).&#x20;

Steps:

* 💬 Access the "**Chat**" page available within the main menu
* ➕ Add the person to your conversation by clicking plus (+) and pasting his or her wallet address to the designated field
* ✏️ Type the message, confirm it by pressing the Enter key on your keyboard and confirm the transaction with your wallet

Creating Group Chat:

* Click on the plus (+) within the "**Chat**" page
* Select the **"Group"** option
* Add group members by pasting their wallet addresses
* Mark / Unmark **"Only creator can add new members"** according to your specification
* Create a Group and confirm the transaction with your wallet

{% tabs %}
{% tab title="Send your first BlockMessage" %}
{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=409>" %}
{% endtab %}

{% tab title="Create on-chain group chat" %}

{% embed url="<https://youtu.be/a4rcas60GVs?feature=shared&t=438>" %}
{% endtab %}
{% endtabs %}

### Disclaimer

THE SOFTWARE SET FORTH IN THESE TERMS IS PROVIDED 'AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTY THAT THE SOFTWARE IS FREE OF DEFECTS, MERCHANTABLE OR FIT FOR A PARTICULAR PURPOSE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY US.

In no event will the Company, its affiliates, distributors or resellers be liable for any indirect, special, incidental or consequential damages arising out of the use of or inability to use the software, including, without limitation, damages for lost profits, loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if advised of the possibility thereof.


# Use Cases & Integrations

Discover SDK and White labels based pre-build applications and future ideas.

### Let's Start

With Web3 social on the rise, Web3 communication remains one of the last undiscovered frontiers. Until now, there was no permissionless infrastructure to enable out-of-the-box on-chain communication application development. With that out of the way, the developer community can now focus on building communication applications with Crypto-specific features and use cases.

### Use Case Table 1 (deployed or in development)

<table><thead><tr><th width="190">Application</th><th width="128">Integrator</th><th>Platform</th><th>Encryptor</th><th>TX Model</th><th>[Mail] SC</th><th>[Chat] SC</th><th>[PX] SC</th><th>OCC SDK</th><th>PX SDK</th></tr></thead><tbody><tr><td><a href="https://app.immu3.io/">BlockCommunicator dApp</a></td><td>Immu3</td><td>Browser</td><td>✅</td><td>PAYGO</td><td>✅</td><td>✅</td><td></td><td>✅</td><td></td></tr><tr><td><a href="https://app.the4thpillar.io/">Email &#x26; Chat Super dApp</a></td><td>4thPillar</td><td>Browser</td><td>✅</td><td>PAYGO</td><td>✅</td><td>✅</td><td>✅</td><td>✅</td><td></td></tr><tr><td><a href="https://w3xshare.com/">Data file sharing dApp</a></td><td>W3XShare</td><td>Browser</td><td></td><td>PAYGO</td><td>✅</td><td></td><td>✅</td><td>✅</td><td></td></tr><tr><td>Data file sharing dApp </td><td>Cherrio</td><td>Browser</td><td></td><td>PAYGO</td><td>✅</td><td></td><td>✅</td><td>✅</td><td></td></tr><tr><td>Broadcasting Web3 BlockMail to SMTP Client</td><td>Immu3</td><td>Desktop</td><td></td><td>Subscription</td><td>✅</td><td></td><td></td><td>✅</td><td></td></tr><tr><td><a href="https://drive.pollinationx.io">Decentralized storage drive dApp</a></td><td>PollinationX</td><td>Browser</td><td></td><td>PAYGO/ Subscription</td><td></td><td></td><td>✅</td><td></td><td>✅</td></tr><tr><td><a href="/pages/HerFWOrDtL7g5oUYdraa">ElizaOS plugin</a></td><td>Immu3</td><td>ElizaOS</td><td></td><td>PAYGO</td><td></td><td>✅</td><td>✅</td><td>✅</td><td></td></tr></tbody></table>

### Use Case Table 2 (ideas & concepts)

<table><thead><tr><th width="192">Application</th><th>Platform</th><th>TX Model</th><th>[Mail] SC</th><th>[Chat] SC</th><th>[PX] SC</th><th>OCC SDK</th><th>PX SDK</th><th>White-label</th></tr></thead><tbody><tr><td>Decentralized/on-chain mail</td><td>All</td><td>PAYGO/ Subscription</td><td>✅</td><td></td><td>✅</td><td>✅</td><td></td><td>Immu3 dMail </td></tr><tr><td>Decentralized/on-chain data-sharing</td><td>All</td><td>PAYGO/ Subscription</td><td>✅</td><td></td><td>✅</td><td>✅</td><td></td><td>W3XShare</td></tr><tr><td>Decentralized/on-chain notary</td><td>All</td><td>PAYGO/ Subscription</td><td>✅</td><td></td><td>✅</td><td>✅</td><td></td><td>Immu3 dMail</td></tr><tr><td>Decentralized/on-chain messaging</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td>✅</td><td>✅</td><td></td><td>Immu3 dChat</td></tr><tr><td>Decentralized/on-chain group messaging</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td>✅</td><td>✅</td><td></td><td>Immu3 dChat</td></tr><tr><td>NFT curated decentralized/on-chain messaging</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td>✅</td><td>✅</td><td></td><td>Immu3 dChat</td></tr><tr><td>Decentralized/on-chain news feeds</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td>✅</td><td>✅</td><td></td><td></td></tr><tr><td>NFT incentified  merchant/customer communication </td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td></td><td>✅</td><td></td><td></td></tr><tr><td>Decentralized/on-chain W2W collective messaging </td><td>All</td><td>PAYGO/ Subscription</td><td></td><td>✅</td><td></td><td>✅</td><td></td><td></td></tr><tr><td>Decentralized/on-chain ticketing system</td><td>All</td><td>PAYGO/ Subscription</td><td>✅</td><td>✅</td><td>✅</td><td>✅</td><td></td><td></td></tr><tr><td>IPFS to decentralized storage backup</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td></td><td>✅</td><td></td><td>✅</td><td></td></tr><tr><td>Cloud storage to decentralized storage backup</td><td>All</td><td>PAYGO/ Subscription</td><td></td><td></td><td>✅</td><td></td><td>✅</td><td>PX Drive</td></tr></tbody></table>


# ElizaOS

Empowering AI agent with additional powers of permissionless on-chain communication and data storage ownership

ElizaOS-based plugins enable devs to give AI agents additional powers of permissionless on-chain communication and data storage ownership:

* ElizaOS plugin that enables AI agents to seamlessly integrate on-chain communication capabilities, allowing permissionless P2P messaging and secure interaction.
* ElizaOS plugin that empowers AI agents to mint their decentralized storage NFTs, granting them ownership of storage units (e.g., 1GB, 5GB, 10GB) and enabling self-sovereign data management.

More info coming...


# Fees & Integrator Economics

Total user cost equals the sum of the L1/L2 transaction gas, the protocol fee and the storage cost.

### Let's Start

Web3 mainly works based on the PAYGO (i.e. pay-as-you-go) transaction model, meaning the user has to pay for every mail, message, or data-sharing transaction. To make on-chain communication more viable, work is being done that will parallel to PAYGO also enable subscription-based models, so the users can pay a monthly subscription fee to access block space and communicate without the hurdle of paying for every transaction.

## Fees within the Protocol

Parallel to the underlying L1/L2 transaction gas cost, the service fees (i.e. protocol fees) are also settled on the smart contract level and are applicable for every mail, message or data file-sharing transaction. Total user cost equals the sum of the L1/L2 transaction gas and service fees and the cost of decentralized storage. Both, the gas and service fees converge and manifest as one end-user communication transaction fee. Fees are handled by the \[[AppFeeManager](/integrators/architecture-by-layers/occ-protocol-v.1#appfeemanager-smart-contract)] smart contract.&#x20;

### Fee Table

{% tabs %}
{% tab title="Blockchain Fees" %}

<table><thead><tr><th width="219.66666666666663">Smart Contract Methods</th><th>Gas Limit</th><th>*Estimated Price in $xDAI</th><th>*Estimated Price in $POL</th><th>*Estimated Price in $S</th><th>*Estimated Price in $FTM</th><th>*Estimated Price in $ROSE</th></tr></thead><tbody><tr><td><code>[Users]</code> Register Encryptor</td><td>145000</td><td>≈ 0.0000004 xDAI</td><td>≈ 0.004POL</td><td>≈ 0.0015S</td><td>≈ 0.0059FTM</td><td>≈ 0.014ROSE</td></tr><tr><td><code>[Mail]</code> Send Mail</td><td>610000</td><td>≈ 0.000006 xDAI</td><td>≈ 0.016POL</td><td>≈ 0.0061S</td><td>≈ 0.025FTM</td><td>≈ 0.061ROSE</td></tr><tr><td><code>[Mail]</code> Send Data file Package</td><td>610000</td><td>≈ 0.000006 xDAI</td><td>≈ 0.016POL</td><td>≈ 0.0061S</td><td>≈ 0.025FTM</td><td>≈ 0.061ROSE</td></tr><tr><td><code>[Chat]</code> Send Message</td><td>*500000</td><td>≈ 0.000005xDAI</td><td>≈ 0.013POL</td><td>≈ 0.005S</td><td>≈ 0.02FTM</td><td>≈ 0.05ROSE</td></tr><tr><td><code>[Chat]</code> Create Group</td><td>*1025625</td><td>≈ 0.000003 xDAI</td><td>≈ 0.02POL</td><td>≈ 0.01S</td><td>≈ 0.04FTM</td><td>≈ 0.1ROSE</td></tr><tr><td><code>[PX]</code> Mint free package or new storage</td><td>3800000</td><td>≈ 0.00001xDAI</td><td>≈ 0.1POL</td><td>≈ 0.038S</td><td>≈ 0.15FTM</td><td>≈ 0.38ROSE</td></tr><tr><td><code>[PX]</code> Mint Bandwidth</td><td>860000</td><td>≈ 0.000002 xDAI</td><td>≈ 0.02POL</td><td>≈ 0.009S</td><td>≈ 0.03FTM</td><td>≈ 0.086ROSE</td></tr><tr><td><code>[PX]</code> Upgrade Package</td><td>1240000</td><td>≈ 0.000003 xDAI</td><td>≈ 0.03POL</td><td>≈ 0.01S</td><td>≈ 0.05FTM</td><td>≈ 0.12ROSE</td></tr></tbody></table>
{% endtab %}

{% tab title="Service Fees" %}

| dApp              | Smart Contract | Base Fee                               | dApp Fee                           | Total                                 | Bandwidth                |
| ----------------- | -------------- | -------------------------------------- | ---------------------------------- | ------------------------------------- | ------------------------ |
| BlockCommunicator | `[Mail]`       | TBD                                    | TBD                                | /                                     | /                        |
| BlockCommunicator | `[Chat]`       | TBD                                    | TBD                                | /                                     | /                        |
| W3XShare App      | `[Mail]`       | \~0.0075$ xDAI, POL, S, FTM, ROSE... ≡ | \~0.0925$ xDAI, POL, S,, ROSE... ≡ | \~**0.1$** xDAI, S, POL, ROSE... ≡    | 2                        |
| 4P Super App      | `[Mail]`       | \~0.0075$ xDAI, POL, S,, ROSE ≡        | \~0.0025$ xDAI, POL, S, ROSE ≡     | \~**0.01$** xDAI, POL, S, ROSE ≡      | 1 (json) + X attachments |
| 4P Super App      | `[Chat]`       | \~0.0025$ xDAI, POL, S, ROSE ≡         | \~0.0025$ xDAI, POL, S, ROSE ≡     | \~**0.005$** S, xDAI, POL, S,  ROSE ≡ | /                        |

{% endtab %}

{% tab title="PX sNFT Price" %}

| Size         | Bandwidth Limit | Estimated Price in $xDAI | Estimated Price in $POL | Estimated Price in $S | Estimated Price in $FTM | Estimated Price in $ROSE |
| ------------ | --------------- | ------------------------ | ----------------------- | --------------------- | ----------------------- | ------------------------ |
| `100MB`      | 25 uploads      | Free                     | Free                    | Free                  | Free                    | Free                     |
| `1GB`        | 50 uploads      | ≈ 5$                     | ≈ 25POL                 | ≈ 12S                 | ≈ 12FTM                 | ≈ 80ROSE                 |
| `5GB`        | 150 uploads     | ≈ 15$                    | ≈ 70POL                 | ≈ 35S                 | ≈ 35FTM                 | ≈ 240ROSE                |
| `20BG`       | 400 uploads     | ≈ 30$                    | ≈ 140POL                | ≈ 70S                 | ≈ 70FTM                 | ≈ 470ROSE                |
| {% endtab %} |                 |                          |                         |                       |                         |                          |

{% tab title="PX Bandwidth Price" %}

| Bandwidth    | Estimated Price in $xDAI | Estimated Price in $POL | Estimated Price in $S | Estimated Price in $FTM | Estimated Price in $ROSE |
| ------------ | ------------------------ | ----------------------- | --------------------- | ----------------------- | ------------------------ |
| 10 uploads   | ≈ 1$                     | ≈ 6POL                  | ≈ 3S                  | ≈ 3FTM                  | ≈ 16ROSE                 |
| {% endtab %} |                          |                         |                       |                         |                          |

{% tab title="Resources" %}

<table><thead><tr><th width="163.66666666666663">Function</th><th width="196">GAS Tracker</th><th width="207">Unit Converter</th><th>Token</th></tr></thead><tbody><tr><td>Polygon</td><td><a href="https://polygonscan.com/gastracker">Polygon GasTracker</a></td><td>/</td><td>POL</td></tr><tr><td>Fantom</td><td><a href="https://ftmscan.com/gastracker">Fantom GasTracker</a></td><td><a href="https://ftmscan.com/unitconverter">Fantom UnitConverter</a></td><td>FTM</td></tr><tr><td>Oasis Sapphire</td><td>/</td><td>/</td><td>ROSE</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**\*Note:** Crypto prices are estimated and calculated based on; (1) xDAI 0.003 GWei; (2) Sonic 10 GWei; (3) Fantom 41 GWei, and; (4) Oasis 100 GWei gas price. The "Send message" gas limit is based on the length of the message. The "Create Group" gas limit depends on the number of members in the group and the encryption variable. Table calculation is based on a two-member encrypted group. References to USD prices are made for approximate fiat value illustration purposes only.
{% endhint %}

### User cost calculation estimate per message transaction

Let's assume that:&#x20;

> Blockchain fees = \~0.009$ FTM ≡
>
> Service base-fee = \~0.0025$ FTM ≡
>
> Service dApp-owner-fee  = \~0.0025$ FTM... ≡
>
> **Total user cost = \~0.014$ FTM... ≡**

## Integrator Economics

OCC Protocol v.1 build-in monetization layers enable independent integrator economics, permitting developers to focus on application UI/UX features. `Level-1` integrators can set the desired protocol base fees, while `Level-2` integrators can set and manage their protocol dApp-owner fees.

### Monetization Schematic

<figure><img src="/files/Uhp7mW1qxJYyiFK9ArgK" alt=""><figcaption></figcaption></figure>


# Multi-chain

Creates multi-chain protocol instances and enables ready-to-use compatibility with multiple EVM chains.

### Let's Start

Immu3 enables ready-to-use multi-chain protocol instances on multiple EVM chains. The deployment is focused on L1s, L2s, side chains, or rollups with approachable block space access and fast transaction finality, while not forgetting the decentralization factor.

### Deployments

{% tabs %}
{% tab title="Mainnets" %}

<table><thead><tr><th width="136">Chain List 🔗</th><th>OCC smart contracts 🔗</th><th>Deployment</th><th>PX smart contracts 🔗</th><th>Deployment</th></tr></thead><tbody><tr><td><a href="https://chainlist.org/chain/100">Gnosis</a></td><td>[<a href="https://gnosisscan.io/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777">Mail</a>]; [<a href="https://gnosisscan.io/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b">Chat</a>]</td><td>26.09.2025</td><td>[<a href="https://gnosisscan.io/address/0xBdbEb66f3c33a7D83f2761D435E7a9a0135D5c43">PXMain</a>]</td><td>25.09.2025</td></tr><tr><td><a href="https://chainlist.org/chain/137">Polygon</a></td><td>[<a href="https://polygonscan.com/address/0x39dc65b90e9c96828213e1c10073a3ac9ee00777">Mail</a>]; [<a href="https://polygonscan.com/address/0xe8150fceef266cf81f4dd936c786e4a041be2d6b">Chat</a>]</td><td>18.02.2025</td><td>[<a href="https://polygonscan.com/address/0x1142b080a5493695e3e35c9c4269f6c06b5ce0f4">PXMain</a>]</td><td>18.02.2025</td></tr><tr><td><a href="https://chainlist.org/chain/146">Sonic</a></td><td>[<a href="https://explorer.soniclabs.com/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777">Mail</a>]; [<a href="https://explorer.soniclabs.com/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b">Chat</a>]</td><td>09.12.2024</td><td>[<a href="https://explorer.soniclabs.com/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4">PXMain</a>]</td><td>09.12.2024</td></tr><tr><td><a href="https://chainlist.org/chain/250">Fantom Opera</a></td><td>[<a href="https://ftmscan.com/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777">Mail</a>]; [<a href="https://ftmscan.com/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b">Chat</a>]</td><td>15.07.2024</td><td>[<a href="https://ftmscan.com/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4">PXMain</a>]</td><td>15.07.2024</td></tr><tr><td><a href="https://chainlist.org/chain/23294">Oasis Sapphire</a></td><td>[<a href="https://explorer.oasis.io/mainnet/sapphire/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777">Mail</a>]; [<a href="https://explorer.oasis.io/mainnet/sapphire/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b">Chat</a>]</td><td>09.08.2024</td><td>[<a href="https://explorer.oasis.io/mainnet/sapphire/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4">PXMain</a>]</td><td>08.08.2024</td></tr></tbody></table>
{% endtab %}

{% tab title="Testnets" %}

| Chain List 🔗                                        | OCC smart contracts 🔗                                                                                                                                                                                                                                                                                                                                       | Deployment | PX smart contracts 🔗                                                                                                                                                           | Deployment |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| [Katana](https://chainlist.org/chain/747474)         | \[[Mail](https://explorer.tatara.katana.network/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777)]; \[[Chat](https://explorer.tatara.katana.network/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b)]                                                                                                                                                   | 10.07.2025 | \[[PXMain](https://explorer.tatara.katana.network/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4)]                                                                          | 12.07.2025 |
| [Citrea](https://chainlist.org/chain/5115)           | \[[Mail](https://explorer.testnet.citrea.xyz/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777)]; \[[Chat](https://explorer.testnet.citrea.xyz/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b)]                                                                                                                                                         | 22.11.2024 | \[[PXMain](https://explorer.testnet.citrea.xyz/address/0x062a44f6aa66fDa906379cD2baF7f84E847e35A5)]                                                                             | 27.11.2024 |
| Sonic                                                | \[[Mail](https://testnet.soniclabs.com/address/0x39dc65b90e9c96828213e1c10073a3ac9ee00777)]; \[[Chat](https://testnet.soniclabs.com/address/0xe8150fceef266cf81f4dd936c786e4a041be2d6b)]                                                                                                                                                                     | 14.11.2024 | \[[PXMain](https://testnet.soniclabs.com/address/0x2901156559b86eb85be6cea64420e629ccfc9f7b)]                                                                                   | 12.11.2024 |
| [Gnosis Chiado](https://chainlist.org/chain/10200)   | \[[Mail](https://gnosis-chiado.blockscout.com/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777)]; \[[Chat](https://gnosis-chiado.blockscout.com/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b)]                                                                                                                                                       | 28.10.2024 | \[[PXMain](https://gnosis-chiado.blockscout.com/address/0x59827DCC32a45DC25F99008e4EE8b46908915BCC)]                                                                            | 04.10.2024 |
| [Polygon Amoy](https://chainlist.org/chain/80002)    | \[[Mail](https://amoy.polygonscan.com/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777)]; \[[Chat](https://amoy.polygonscan.com/address/0xe8150fceef266cf81f4dd936c786e4a041be2d6b)]                                                                                                                                                                       | 27.09.2024 | \[[PXMain](https://amoy.polygonscan.com/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4)]                                                                                    | 30.09.2024 |
| [Soneium Minato](https://chainlist.org/chain/1946)   | \[[Mail](https://explorer-testnet.soneium.org/address/0x39Dc65b90e9C96828213E1c10073a3Ac9ee00777)]; \[[Chat](https://explorer-testnet.soneium.org/address/0xe8150FcEeF266CF81f4dD936c786E4a041be2d6b)]                                                                                                                                                       | 06.09.2024 | \[[PXMain](https://explorer-testnet.soneium.org/address/0x1142b080a5493695e3E35c9C4269f6C06B5CE0F4)]                                                                            | 02.09.2024 |
| [Immu3](https://chainlist.org/chain/3100)            | \[[Mail](https://evmexplorer.tanssi-chains.network/address/0xaA70aD6D4dc4CBf3ec1f6CC07bF93e72B881fF44?rpcUrl=https%3A%2F%2Ffraa-flashbox-2800-rpc.a.stagenet.tanssi.network)]; \[[Chat](https://evmexplorer.tanssi-chains.network/address/0x6BC7B159a8d97B907B2F1912769DE72FE8b773A0?rpcUrl=https%3A%2F%2Ffraa-flashbox-2800-rpc.a.stagenet.tanssi.network)] | 15.07.2024 | \[[PXMain](https://evmexplorer.tanssi-chains.network/address/0x3e4760aC84f99ED1CB505fe0973b54d6E77B3C99?rpcUrl=https%3A%2F%2Ffraa-flashbox-2800-rpc.a.stagenet.tanssi.network)] | 15.07.24   |
| [Immu3](https://chainlist.org/chain/3100)            | \[[Mail](https://evmexplorer.tanssi-chains.network/address/0x2B568A7D93DdDe2cbEE293013e80617ab60Efd80?rpcUrl=https%3A%2F%2Ffraa-flashbox-2800-rpc.a.stagenet.tanssi.network)]; \[[Chat](https://evmexplorer.tanssi-chains.network/address/0xb157cdB09284D8284fe88DaBaF3a5e1472F7dBDa?rpcUrl=https%3A%2F%2Ffraa-flashbox-2800-rpc.a.stagenet.tanssi.network)] | 19.04.2024 | \[PXMain]                                                                                                                                                                       | 19.04.2024 |
| [Fantom](https://chainlist.org/chain/4002)           | \[[Mail](https://testnet.ftmscan.com/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://testnet.ftmscan.com/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                                         | 15.07.2024 | \[[PXMain](https://testnet.ftmscan.com/address/0xCFa778071BAd55BA6c893B3Fa5683F2231d3464F)]                                                                                     | 15.07.24   |
| Fantom Sonic                                         | \[[Mail](https://sonicscan.io/v1/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://sonicscan.io/v1/0xe7fd30fd5958165e46e618dfd8e6ef0fbb967827)]                                                                                                                                                                                                 | 05.04.2024 | \[[PXMain](https://public-sonic.fantom.network/address/0xF416eC122f61B933207915946B00364674eB3134)]                                                                             | 05.04.24   |
| [Sepolia](https://chainlist.org/chain/11155111)      | \[[Mail](https://sepolia.etherscan.io/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://sepolia.etherscan.io/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                                       | 17.10.2023 | \[[PXMain](https://sepolia.etherscan.io/address/0xd0466eb975de9cdfd790db14f143f4aaafd67cf2)]                                                                                    | 01.09.2023 |
| [Polygon Mumbai](https://chainlist.org/chain/80001)  | \[[Mail](https://mumbai.polygonscan.com/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://mumbai.polygonscan.com/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                                   | 24.08.2023 | \[[PXMain](https://mumbai.polygonscan.com/address/0x327d9765b9979a5bdae587971ff9c5d94596385b)]                                                                                  | 24.08.2023 |
| EdgeEVM                                              | \[[Mail](https://testnet.edgscan.live/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://testnet.edgscan.live/address/0xf32aFB10a3948B0D3Df65fEf5dd8004ea542BFAa)]                                                                                                                                                                       | 18.10.2023 | \[[PXMain](https://testnet.edgscan.live/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                                    | 18.10.2023 |
| [Arthera](https://chainlist.org/chain/10243)         | \[[Mail](https://explorer-test2.arthera.net/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://explorer-test2.arthera.net/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                           | 01.02.2024 | \[[PXMain](https://explorer-test.arthera.net/address/0x3F399f029BDCc695CfC8bab174938EdEaB84E546)]                                                                               | 01.02.2024 |
| [Metis Sepolia](https://chainlist.org/chain/59902)   | \[[Mail](https://sepolia.explorer.metisdevops.link/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://sepolia.explorer.metisdevops.link/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                             | 23.02.2024 | \[[PXMain](https://sepolia.explorer.metisdevops.link/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                       | 23.02.2024 |
| [Oasis Sapphire](https://chainlist.org/chain/23295)  | \[[Mail](https://testnet.explorer.sapphire.oasis.dev/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://testnet.explorer.sapphire.oasis.dev/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                         | 27.11.2023 | \[[PXMain](https://testnet.explorer.sapphire.oasis.dev/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                     | 27.11.2023 |
| [ZetaChain Athens](https://chainlist.org/chain/7001) | \[[Mail](https://athens.explorer.zetachain.com/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://athens.explorer.zetachain.com/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                     | 01.30.2024 | \[[PXMain](https://explorer.zetachain.com/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                                  | 01.30.2024 |
| [Mantle Sepolia](https://chainlist.org/chain/5003)   | \[[Mail](https://explorer.sepolia.mantle.xyz/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://explorer.sepolia.mantle.xyz/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                         | 09.02.2024 | \[[PXMain](https://explorer.sepolia.mantle.xyz/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                             | 09.02.2024 |
| [Gnosis Chiado](https://chainlist.org/chain/10200)   | \[[Mail](https://gnosis-chiado.blockscout.com/address/0xa6199D54df4c904976DC1741eE75A9570c7A3308)]; \[[Chat](https://gnosis-chiado.blockscout.com/address/0xe7fD30fd5958165e46e618DfD8e6ef0FbB967827)]                                                                                                                                                       | 09.02.2024 | \[[PXMain](https://gnosis-chiado.blockscout.com/address/0xd0466eB975dE9CDfd790Db14f143f4aAAFd67cF2)]                                                                            | 09.02.2024 |
| {% endtab %}                                         |                                                                                                                                                                                                                                                                                                                                                              |            |                                                                                                                                                                                 |            |

{% tab title="Faucets" %}

| Chain            | TestNet Faucets 🔗                                                                      |
| ---------------- | --------------------------------------------------------------------------------------- |
| Citrea           | [➡️](https://citrea.xyz/faucet)                                                         |
| Immu3            | [➡️](https://immu3-faucet.vercel.app/)                                                  |
| Fantom           | [➡️](https://faucet.fantom.network/)                                                    |
| Fantom Sonic     | [➡️](https://public-sonic.fantom.network/account)                                       |
| Sepolia          | [➡️](https://sepolia-faucet.pk910.de/)                                                  |
| Polygon Faucets  | [➡️](https://faucet.polygon.technology/)                                                |
| EdgeEVM          | [➡️](https://beresheet-evm-faucet.vercel.app/)                                          |
| Arthera          | [➡️](https://faucet2.arthera.net/)                                                      |
| Metis Sepolia    | [➡️](https://sepolia.faucet.metisdevops.link/)                                          |
| Oasis Sapphire   | [➡️](https://faucet.testnet.oasis.dev/)                                                 |
| ZetaChain Athens | [➡️](https://www.covalenthq.com/faucet/#form)                                           |
| Mantle Sepolia   | [➡️](https://faucet.sepolia.mantle.xyz/) / [Bridge](https://bridge.sepolia.mantle.xyz/) |
| Gnosis Chiado    | [➡️](https://faucet.chiadochain.net/)                                                   |
| {% endtab %}     |                                                                                         |
| {% endtabs %}    |                                                                                         |

### Resources

{% embed url="<https://github.com/4thtech/sdk-js/tree/main/packages/ethereum/src/lib/chains>" %}


# Architecture by Layers

Lightweight, modular and designed in line with core decentralization primitives.

### Let's Start

Architecture refers to the components and subcomponents or layers that comprise a complete Immu3 stack. Each layer has a unique role, from the underlying blockchain layer, storing data to enabling communication encryption and ensuring user connectivity and integration across the system. Understanding these layers is crucial for developers (i.e., integrators) and start-up entrepreneurs seeking to leverage Immu3s blockchain communication technology effectively.

### Layers

Connected by the [OCC SDK](https://wiki.immu3.io/integrators/occ-sdk) (i.e. software development kit) and later the Integrator Dashboard, seven layers complete the on-chain communication framework:

* [Integrator use cases](/integrators/use-cases-and-integrations)
* [AppSuite](https://wiki.immu3.io/end-users/appsuite)
* [White labels](/integrators/occ-white-labels)
* [Encryption](/integrators/architecture-by-layers/encryption)
* [OCC Protocol](/integrators/architecture-by-layers/occ-protocol-v.1)
* [Decentralized storage](/integrators/architecture-by-layers/pollinationx-decentralized-storage-infra)
* [Blockchain network](/integrators/multi-chain)

<figure><img src="/files/8F9JXrk6XcLLFfBL1mtQ" alt=""><figcaption></figcaption></figure>


# OCC Protocol v.1

With many iterations behind there are five EVM smart contracts forming the core protocol layer; (1) Mail; (2) Chat; (3) Users; (4) AppFeeManager, and; (5) Lock.

### Overview

The OCC Protocol follows mathematical methods embedded and enforced by smart contracts and can not act in a malicious or harmful manner (e.g. breaking its code primitives by granting access to communication transactions in any way or form). The methods within OCC Protocol smart contracts (i.e. Mail, Chat, Users, AppFeeManager, Lock, TierManager) set simple but strong rules enforcing its core primitives such as; immutability and transparency within P2P decentralized communication.

While built and developed by the 4thTech initiative, the multi-chain OCC Protocol v.1 deployment is the task of a `Level-1` integrator Immu3.&#x20;

<figure><img src="/files/IzfrnwvDtY3TNBpMlw2r" alt=""><figcaption></figcaption></figure>

### \[Mail] Smart Contract

`[Mail]` smart contract is implementing the following methods;

```
(1) sendMail: self-explanatory 
(2) setOpenedAt: recipient can mark read mail timestamp
(3) deleteMail: self-explanatory
(4) deleteMails: self-explanatory
(5) getMail: self-explanatory
(6) getMails: self-explanatory
(7) getMailsCount: returns the number of received mails 
(8) getMailsPaginated: self-explanatory
(9) getAppIds: self-explanatory
```

{% hint style="info" %}
**Explainer:** The envelope URL and envelope checksum are saved within the \[Mails] smart contract and include the time of the send information and the sender data (i.e. sender address). Envelope stands for metadata that is stored encrypted on decentralized storage (i.e.PollinationX).
{% endhint %}

`[Mails]` smart contract enables Web3 data exchange and communication in various use cases. To learn more visit the [use cases](/integrators/use-cases-and-integrations) page.

### \[Chat] **Smart Contract**

`[Chat]` is a smart contract used for decentralized, encrypted short message exchange over the blockchain. Deployed on various L1s and L2s, the protocol empowers any project to develop Web3 messaging-like communication dApps. Chat smart contract is implementing the following methods;

```
(1) sendMessage: self-explanatory 
(2) deleteMessage: self-explanatory 
(3) addMessageToConversation: self-explanatory 
(4) createGroupConversation: self-explanatory 
(5) deleteGroupConversation: self-explanatory 
(6) addMembersToGroupConversation: self-explanatory 
(7) removeMembersToGroupConversation: self-explanatory 
(8) getConversationHashes: each conversation has its own hash, this method returns an array of user-participation-conversation hashes 
(9) getConversations: self-explanatory 
(10) getConversation: self-explanatory 
(11) getConversationMessagesPaginated: self-explanatory
```

{% hint style="success" %}
**Explainer:** Messages are stored on-chain, while data and media files are exchanged using PollinationX decentralized storage on demand. &#x20;
{% endhint %}

The `[Chat]` smart contract enables Web3 data exchange and communication in various use cases. To learn more visit the [use cases](/integrators/use-cases-and-integrations) page.

### \[Users] **Smart Contract**

`[Users]` smart contract is used to manage user-related on-chain data. It is implementing the following methods;

```
(1) setUserEncryptionPublicKey: self-explanatory
(2) getUser: self-explanatory
```

### \[AppFeeManager] Smart Contract

`[AppFeeManager]` is a smart contract used for the management of app and fee-related tasks. It is implementing the following methods;

```
/(1) registerApp: self-explanatory 
(2) setGlobalBaseFee: self-explanatory 
(3) updateAppBaseFee: self-explanatory 
(4) resetAppBaseFee: self-explanatory 
(5) updateAppName: self-explanatory 
(6) updateAppIntegratorFee: self-explanatory 
(7) removeApp: self-explanatory 
(8) getApp: self-explanatory 
(9) getGlobalBaseFee: self-explanatory 
(10) isAppExists: self-explanatory 
(11) getIntegratorAppIds: self-explanatory 
(12) getIntegratorApps: self-explanatory 
(13) getAppBaseFee: self-explanatory 
(14) getAppIntegrator: self-explanatory 
(15) getAppIntegratorFee: self-explanatory
(16) isCaasEnabled: self-explanatory
```

### \[Lock] Smart Contract

`[Lock]` is a smart contract used for asset-locking-based tasks related to w3CaaS. It is implementing the following methods;

```
(1) setLockPeriod: self-explanatory 
(2) setTierManager: self-explanatory 
(3) deposit: self-explanatory 
(4) withdraw: self-explanatory 
(5) getBalance: self-explanatory 
(6) isLockPeriodOver: self-explanatory 
(7) getRemainingLockTime: self-explanatory 
(8) getLockPeriod: self-explanatory
```

### \[TierManager] Smart Contract

`[TierManager]` smart contract enables end users to set the desired PROTOCOL BASE-FEE DISCOUNT tier, while integrators can access the methods that enable them to withdraw and update dApp OWNER-FEEs.`[TierManager]` smart contract is implementing the following methods;

```
(1) addTier: self-explanatory 
(2) updateTier: self-explanatory 
(3) removeTier: self-explanatory 
(4) setIntegratorMinStakeAmount: self-explanatory 
(5) getTier: self-explanatory 
(6) getAllTiers: self-explanatory 
(7) getIntegratorMinStakeAmount: self-explanatory 
(8) getLockedBalance: self-explanatory 
(9) getDiscount: self-explanatory 
(10) onTokensLocked: self-explanatory 
(11) onTokensUnlocked: self-explanatory
```

{% hint style="success" %}
**Explainer:** Smart contracts within 4thTech OCC Protocol v.1 are registered under EUPL open-source license with commercial restrictions. GitHub repositories are currently still private, while audits will be available shortly.&#x20;
{% endhint %}

### Resources

{% embed url="<https://github.com/4thtech/smart-contracts>" %}

### Audits

We use Slither, the Solidity source analyzer for preliminary smart contracts code audits.&#x20;

{% hint style="info" %}
**Note:** [Slither](https://github.com/crytic/slither) is a Solidity static analysis framework written in Python3. It runs a suite of vulnerability detectors, prints visual information about contract details, and provides an API to easily write custom analyses. Slither enables developers to find vulnerabilities, enhance their code comprehension, and quickly prototype custom analyses.
{% endhint %}

What we audit:

* Solidity code vulnerabilities with low false positives ([read more](https://github.com/crytic/slither/blob/master/trophies.md))


# Encryption

Encryption is one of the key parts of the on-chain communication infrastructure.

### Let's Start

Encryption is one of the key parts of the infrastructure. There are three options available within the OCC SDK; (1) Custom encryption; (2) AES-randomly generated secret key, and; (3) AES-secret key produced by ECDH. The OCC technology uses GCM (Galois/Counter Mode), which is often considered the safest among all AES modes.

<figure><img src="/files/Bmi6vP4GydgV4i9otfyX" alt=""><figcaption></figcaption></figure>

### (1) No encryption

Plain unencrypted content is shared between wallet client A (i.e. sender) and wallet client B (i.e. receiver).

### (2) Custom encryption

Integrators have the option to develop their specific encryption implementations.

### (3) AES (symmetric, secret key encryption)

Natively AES-256-GCM is used for the encryption algorithm. &#x20;

### (3.1) AES (randomly generated secret key)

A random secret key is generated to encrypt content, which is shared between wallet client A (i.e. sender) and wallet client B (i.e. receiver). Content is encrypted with AES encryption. The receiver obtains the secret key from a sender using external communication (i.e. email, chat…) to decrypt the content.

{% hint style="success" %}
**Explainer:** AES encryption with a randomly generated secret key is used within w3xshare data file transfers.
{% endhint %}

### (3.2) AES (secret key produced by ECDH secret key exchange enabled by Encryptor extension)

The secret key is produced with ECDH secret key exchange. The sender needs the receiver [Encryptor extension](/integrators/clients-and-tools/intro-to-encryptor-extension) public key to be recorded on the blockchain. Encryptor extension is used to calculate the shared secret key.&#x20;

{% hint style="success" %}
**Explainer:** The calculation is made using the receiver Encryptor extension public key and sender Encryptor extension private key. Content is encrypted with AES encryption and shared between wallet client A and wallet client B. The receiver decrypts the content using a calculated shared secret key. The secret key is calculated with the receiver Encryptor extension private key and the sender Encryptor extension public key. AES encryption with a secret key produced by ECDH secret key exchange is used within Email & Chat use cases.
{% endhint %}

### Resources

{% embed url="<https://github.com/4thtech/sdk-js/tree/main/packages/encryption>" %}


# PollinationX Decentralized Storage Infra

While the OCC SDK integrators can utilize custom storage options, the PollinationX decentralized storage infra is set as a default.

### Let's Start

Because there was no available out-of-the-box solution, PollinationX (i.e. PX) was developed by a separate team within the CR Systems. PX also acts as a stand-alone solution, otherwise powering various integrator email, messaging and data file transfer use cases.&#x20;

### Features

* Self-custodial storage
* Communication data is accessible only to the private key owner
* Integrator [APIs](https://wiki.pollinationx.io/developer-section/api-reference) and [SDK](https://wiki.pollinationx.io/developer-section/pollinationx-sdk) tooling
* IPFS, BTFS, and FileCoin (phases 1 & 2) support
* [Multi-chain](https://wiki.pollinationx.io/overview/supported-networks-and-storages) availability
* Based on EVM, TypeScript and Solidity frameworks&#x20;
* Monetization via data package dynamic [PX NFTs](https://wiki.pollinationx.io/overview/px-storage-nft) and PX Bandwidth

### Usage with the OCC SDK

For detailed usage instructions of this package, please refer to the [wiki](https://wiki.4thtech.io/docs/sdk/storage).

However, a brief overview is provided below:

```
import { PollinationX } from '@4thtech-sdk/storage';
```

After importing, you can use the package as required by your project.

### Resources

{% embed url="<https://wiki.pollinationx.io/>" %}

{% embed url="<https://github.com/4thtech/sdk-js/tree/main/packages/storage>" %}

{% embed url="<https://github.com/pollinationx/>" %}

{% embed url="<https://www.npmjs.com/package/@pollinationx/core>" %}


# Clients & Tools

Learn about the Immu3s collection of clients dedicated to on-chain communication.

* **BlockMail client:** OCC White label-based communication platform that leverages blockchain networks to facilitate peer-to-peer mail delivery.
* **BlockChat client:** OCC White label-based communication platform that leverages blockchain networks to facilitate peer-to-peer message delivery.
* **Data file-sharing client:** W3XShare White label-based communication platform that leverages blockchain networks to facilitate peer-to-peer data file sharing.
* **Decentralized storage-based "Drive like" client:** PX White label-based data management platform that leverages decentralized storage and blockchain networks to facilitate self-custodial storage management.
* **Encryptor extension**: Fully self-custodial Chrome extension that enables E2E AES-256-GCM highly secure encryption of on-chain communications by user-owned private keys.
* **Integrator Dashboard:** Unlocks the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps.


# Intro to BlockMail

E2e encrypted blockchain mail that is resistant to data mining, phishing, spoofing, spam and the theft of digital identity or data.

### Blockchain Mail

**Blockchain Mail** (or “BlockMail”) is a communication platform that leverages blockchain networks to facilitate peer-to-peer message delivery. In this model, each mail is represented as a blockchain transaction, introducing an unprecedented level of trust and security, and ensuring mail communication immutability and traceability.&#x20;

By recording mail checksum, L1/L2s power the on-chain mailing, while data and media file attachments are exchanged via decentralized storage.&#x20;

{% hint style="info" %}
**Note:** We refer to blockchain-based Mail as BlockMail. This framework supports on-chain communication, with the level of decentralization matching that of the underlying network. Hence, terms like decentralized Mail, or dMail, are also applicable. However, given potential questions about some blockchain networks' decentralization, we prefer BlockMail. Ultimately, the choice of naming comes down to user preference.
{% endhint %}

### Features

* Pseudonymous communication via Web3 login
* Multi-chain wallet interoperability via MetaMask, Coinbase or Wallet Connect
* Robust and resistant to Web2 data mining, data ownership loss & phishing
* Self-custodial and immutable
* On-chain verifiable
* E2E encrypted
* [Multi-chain](https://wiki.immu3.io/builders/multi-chain)
* No centralized point of failure
* Attachments sent via decentralized storage
* Contact whitelist availability
* Correspondence fee availability (TBA).

### Technicals

With its unique on-chain “1 BlockMail = 1 L1/L2 transaction” model, its decentralization is directly tied to the underlying public blockchain network. Built on the \[Mail] smart contract, OCC SDK, PX decentralized storage service, and client white-label framework, the OCC-based BlockMail UI offers a distinctive UX and serves as a sandbox for this new on-chain communication technology.

{% hint style="success" %}
**Note:** Lite-encrypted JSON objects are created to hold BlockMail metadata. The link to this metadata and checksum is recorded on the chain as a blockchain transaction; 1 BlockMail = 1 L1-TX. The on-chain model introduces an unprecedented level of trust and security and ensures the immutability and traceability of message/data communication.
{% endhint %}

<figure><img src="/files/clgb0sHw1WIHpOyUgl1a" alt=""><figcaption></figcaption></figure>

### Fork & Deploy your on-chain BlockMail App 🚀

{% content-ref url="/pages/vQyRQLqhYcwxtk6E3KNt" %}
[OCC White-labels](/integrators/occ-white-labels)
{% endcontent-ref %}

### Resources

{% embed url="<https://github.com/4thtech/white-label-client>" %}


# Intro to BlockChat

E2e encrypted DMs and on-chain group chats are resistant to data mining, phishing, fake clone attacks, account hijacking, and the theft of digital identity or data.

### Blockchain Messaging

**Blockchain messaging** (or “BlockChat”) is the process of composing and sending electronic messages using blockchain networks. Each message is recorded as a blockchain transaction, providing a secure and immutable communication method. This approach ensures that messages are delivered peer-to-peer and are resistant to tampering and unauthorized access.

Immu3's block messaging platform is fully on-chain, while data and media files are exchanged via decentralised storage. There is no need for a centralised database. The average message transaction confirmation depends on the transaction finality of the chosen L1 or L2, the same goes for message transaction cost.

{% hint style="info" %}
**Note:** We refer to blockchain-based Chat as BlockChat. This framework supports on-chain communication, with the level of decentralization matching that of the underlying network. Hence, terms like decentralized Chat, or dChat, are also applicable. However, given potential questions about some blockchain networks' decentralization, we prefer BlockChat. Ultimately, the choice of naming comes down to user preference.
{% endhint %}

### Features

* Pseudonymous communication via Web3 login
* Multi-chain wallet interoperability via MetaMask, Coinbase or Wallet Connect
* Robust and resistant to Web2 data mining, data ownership loss & phishing
* Self-custodial and immutable
* On-chain verifiable
* E2E encrypted
* [Multi-chain](https://wiki.immu3.io/builders/multi-chain)
* No centralized point of failure
* E2E encrypted DMs and group chat
* Data and media file sharing via decentralized storage
* Contact whitelist availability
* Correspondence fee availability (TBA).

### Technicals

With its unique on-chain “1 message = 1 L1/L2 transaction” model, its decentralization is directly tied to the underlying public blockchain network. Built on the \[Chat] smart contract, OCC SDK, and UI white-label framework, the Block Messaging UI offers a distinctive UX and serves as a sandbox for this new on-chain communication technology.

{% hint style="success" %}
**Note:** Composed from (1) the message content, and (2) possible data files (i.e. media files, photos…), the individual block message can be from a few kilobytes to gigabytes in size. While encrypted message content gets recorded on the blockchain, the attachments are transmitted via the PX decentralized storage service.
{% endhint %}

<figure><img src="/files/uejvwoDgBUAWVXW0pfvt" alt=""><figcaption></figcaption></figure>

### Fork & Deploy your on-chain Block Messaging App 🚀

{% content-ref url="/pages/vQyRQLqhYcwxtk6E3KNt" %}
[OCC White-labels](/integrators/occ-white-labels)
{% endcontent-ref %}

### Resources

{% embed url="<https://github.com/4thtech/white-label-client>" %}


# Intro to Decentralized Data File Sharing

Communicate P2P or exchange large files globally without fear of security breaches.

### True Decentralized Data File Sharing

W3XShare is Immu3's integrator answer to P2P data file sharing. It is changing the way how large and sensitive data is transferred in a decentralized manner. It leverages blockchain networks, decentralized storage and communication protocols, to provide a secure and efficient solution for encrypted data transfer between wallets.&#x20;

{% hint style="success" %}
OCC-based data file sharing is data-heavy, thus processing it completely on-chain is not viable. In contrast, lite encrypted JSON objects are created to hold the data file-sharing package metadata. The link to this metadata and checksum is recorded on the chain as a blockchain transaction; 1 data file exchange package = 1 L1/L2-TX.
{% endhint %}

### Features

* Pseudonymous communication via Web3 login
* Multi-chain wallet interoperability via MetaMask, Coinbase or Wallet Connect
* Robust and resistant to Web2 data mining, data ownership loss & phishing
* Self-custodial and immutable
* On-chain verifiable
* E2E encrypted
* [Multi-chain](https://wiki.immu3.io/builders/multi-chain)
* No centralized point of failure
* Data and media file sharing via decentralized storage
* PAYGO monetization model

### Technicals

Composed of; (1) subject; (2) content, and; (3) attachment, the data file sharing package can be from a few kilobytes to 100 gigabytes in size. The data file sharing size is limited to the storage size of PX Storage NFT available in the user's wallet. Based on the \[Mails] smart contract, SDKs, PX decentralized storage service and white-label framework, the W3XShare UI showcases the UI/UX for future on-chain data file transfers.

### Technical Stack Schematic

<figure><img src="/files/riXv1MPNveljMd3LBBeR" alt=""><figcaption></figcaption></figure>

### Fork & Deploy your on-chain data file-sharing App 🚀

{% embed url="<https://wiki.w3xshare.com/architecture/w3xshare-platform/white-label>" %}

### Resources

{% embed url="<https://github.com/immu3-io/w3xshare.com>" %}


# Intro to Decentralized Storage File Hosting Service

Expirience "Cloud Storage" like UI in a decentralized self-custodial manner. .

### True Self-custodial Data Management

PX dApp is a decentralized storage-based app that enables users to store and access files online in a true self-custodial and permissionless way. The service syncs stored documents, photos and other types of data files across all the user's devices, that support Web3 wallets.

### **Features**

* Pseudonymous communication via Web3 login
* Multi-chain wallet interoperability via MetaMask or Wallet Connect
* Robust and resistant to Web2 data mining, data ownership loss & phishing
* Self-custodial and immutable
* Data access is possible only with users' private key
* Multiple accounts possibility
* Self-client custody (e.g. in the case of dApp downtime, the open-source UI client is available)
* Multi-chain
* Storage unit based on [PX NFTs](https://wiki.pollinationx.io/overview/px-storage-nft).

{% hint style="success" %}
**Explainer:** PX dApp uses PollinationX storage NFTs to enable data file storage over decentralized storage networks. Every user is eligible for the first `100MB` storage NFT. To increase data storage capacity an additional storage NFT needs to be added to the wallet. Users can mint PollinationX decentralized storage NFTs according to their needs (e.g. 5GB, 20GB, 100GB). Storage is available until used.
{% endhint %}


# Intro to Encryptor extension

Fully self-custodial Chrome extension that enables E2E AES-256-GCM highly secure encryption of on-chain communications by user-owned private keys.

### True Self-custodial communication encryption

Used by Immu3 stack-enabled end-users, the Encryptor extension adds a communication encryption layer currently unsupported by major Web3 wallets. It enables the ECDH key agreement protocol, creating an elliptic curve key pair and computing the shared secret key between the sender and receiver. Similar to a Web3 wallet, it allows users to save their private key seed phrases, which can be used to restore their Encryptor at any time or on any device.

{% hint style="success" %}
**Note:** Encryptor is an open-source, self-custodial Chrome extension built with Vite, Vue, and Manifest v3. It enables end-to-end AES-256-GCM encryption of on-chain communications using user-owned private keys, providing advanced and highly secure encryption.
{% endhint %}

### How to install it?

{% embed url="<https://youtu.be/TjMTM35-o4M>" %}

### Google Chrome Install

{% embed url="<https://chrome.google.com/webstore/detail/encryptor/feolajpinjjfikmmeknkdjbllbppojij?authuser=3&hl=en-GB>" %}

### Direct Install

1. Check if your `Node.js` version is >= **14**.
2. Change or configure the name of your extension on `src/manifest`.
3. Run `npm install` to install the dependencies.

### Developing

run the command

```
$ cd encryptor-extension

$ npm run dev
```

#### Chrome Extension Developer Mode

1. set your Chrome browser 'Developer mode' up
2. click 'Load unpacked', and select `extension/build` folder

#### Normal FrontEnd Developer Mode

1. access `http://localhost:3000/`
2. when debugging the popup page, open `/popup.html`
3. when debugging the options page, open `/options.html`

### Packing

After the development of your extension run the command

```
$ npm build
```

Now, the content of `build` folder will be the extension ready to be submitted to the Chrome Web Store. Just take a look at the [official guide](https://developer.chrome.com/webstore/publish) for more info about publishing.

### Resources

{% embed url="<https://github.com/4thtech/encryptor-extension>" %}

{% embed url="<https://github.com/4thtech/encryptor-extension/releases>" %}


# Intro to Integrator Dashboard

Unlocks the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps.

### Deployment Abstracted

The Integrator Dashboard is Immu3's way of simplifying the adoption and integration of this new Web3 communication technology. It unlocks the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps.&#x20;

### Features

* Multi-chain wallet interoperability via MetaMask, Coinbase or Wallet Connect
* Access to software pack licence subscription
* Tier-based pro access
* Integrator licencing
* Access to integrator economics via protocol dApp owner fee layer
* Access to integrator dApp ID
* One-click deploy white-labels
* Reseller access to PollinationX decentralized storage custom packages and more

{% hint style="success" %}
**Explainer:** Integrator features are currently available to whitelisted projects. Contact us via [Immu3 X](https://x.com/immu3_io) (ex-Twitter) DMs if you wish to learn more about the early integrator program.&#x20;
{% endhint %}


# OCC White-labels

A suite of ready-to-use white-label mail, messaging and data file transfer UIs designed to fast-track your entry into the rapidly growing Web3 market.

### Let's Start

White-label frameworks enable fast and easy builds. To begin, we recommend looking at wiki Guides and GitHub repos which include runnable examples and walkthroughs of core usages. These guides will help you better understand how to use the white-label framework. To test drive white labels in production connect to the [4P Email & Chat Super App](https://app.the4thpillar.io/). As a part of the immu3's infrastructure integrator stack, there are several white-label dApp frameworks available;&#x20;

* BlockMail & BlockChat: [Wiki](https://wiki.4thtech.io/docs/integration/white-label), [GitHub](https://github.com/4thtech/white-label-client)
* Data file sharing: [Wiki](https://wiki.w3xshare.com/architecture/w3xshare-platform/white-label), [GitHub](https://github.com/immu3-io/w3xshare-white-label)

{% hint style="success" %}
**Tip:** The Integrator Dashboard will enable one-click white-label deploys. It will unlock the skill and know-how required to abstract the complexities and simplify the deployment of on-chain communication apps.
{% endhint %}

### Technical Features

* Wallet Integration: Supports MetaMask, Coinbase, and Wallet Connect
* One-click network switching: EVM multi-chain UI support
* Infinity scroll: faster loading of mails, messages and conversations by progressively loading data on demand (i.e. available within Mail and Messaging frameworks)
* Self-custodial W2W Encryption: user-owned private key encryption for Mails, DMs, and group messaging
* Decentralized storage: built-in PollinationX storage NFT support
* Integrator monetization: dApp owner-fee smart contract feature

### UI/UX Features

* On-chain Inbox: smart contract-based mail and messaging inbox
* On-chain group messaging: smart contract-based group messaging
* Data file sharing: decentralized storage-based on-chain file sharing
* Built-in Encryptor Extension: integrated conversation encryption support
* PollinationX Storage NFTs: built-in support for decentralized storage
* Sender whitelisting: smart contract-based mail and message whitelisting
* Correspondence fees: option to charge for correspondence via smart contract
* Service fee discounts: option to enable discounts on service fees via smart contract

### Resources

{% embed url="<https://github.com/4thtech/white-label-client>" %}


# OCC SDK

Empowers integrators to seamlessly interact with protocol smart contracts, storage providers, encryption methods, and the Encryptor extension.

### OCC SDK

As a part of the immu3's infrastructure integrator stack, the OCC SDK provides abstractions to assist you with interacting with the OCC Protocol v.1 smart contracts in a Typescript/Javascript environment. The OCC SDK also simplifies the encryption process and remote storage access.

To begin, we recommend looking at wiki [Guides](https://wiki.4thtech.io/docs/integration/sdk) and GitHub [Repos](https://github.com/4thtech/sdk-js) which include runnable examples and walkthroughs of core usages. These guides will help you better understand how to use and integrate the OCC SDK into your application.

### Features

* Modular Packages: Typescript/Javascript stack including Encryption, Encryptor, Ethereum, Storage, Types, and Utils
* EVM Multi-chain Support: Ready-to-use compatibility with multiple Ethereum Virtual Machine (EVM) chains
* Method Usability Tests: Comprehensive tests to ensure functionality and usability
* Integrator Monetization: App owner-fee smart contract feature

### Packages

* Encryption: Allows for easy data encryption and decryption using various encryption methods
* Encryptor: Manages connection with the Encryptor extension
* Ethereum: Handles Ethereum blockchain transactions, smart contracts, and other blockchain-related functions
* Storage: Optimise storing and retrieving procedures, enhancing data management
* Types: Contains the type declarations used across all the other packages
* Utils: Provides utility functions and helpers that facilitate and enhance the functionality of the SDK

### Start Building

Each package comes with its unique usage instructions. To understand how to use a package, refer to the respective package directories for more detailed instructions and documentation. Typically, you would import a package as follows:

```
import { Mail } from '@4thtech-sdk/ethereum';
```

Use the imported package as required by your project. Please access GitHub for the latest guidelines.

{% hint style="success" %}
**Tip:** Experience seamless integration. Utilize method functions tests ([test example](https://github.com/4thtech/sdk-js/blob/main/packages/ethereum/src/lib/__tests__/chat.spec.ts)).
{% endhint %}

### Resources

{% embed url="<https://github.com/4thtech/sdk-js>" %}


# Intro to AppChain

A public EVM smart contract platform that offers reliability, scalability and security needed within use cases of on-chain communication.

{% hint style="danger" %}
**Note:** The Immu3 Testnet AppChain was deployed to support the Tanssi LFD campaign. It will be decommissioned by the end of September 2024.
{% endhint %}

### Let's Start

Immu3 AppChain was built on the Tansii AppChain infrastructure protocol. It inherits block finality (consensus) from Polkadot RelayChain. Consequently, it acts as a Layer 1 blockchain like Moonbeam, not Layer 2 solutions on top of another Layer 1. It is a public EVM smart contract platform that offers reliability, scalability and security needed within use cases of on-chain communication.&#x20;

{% hint style="success" %}
**Explainer:** Built on the Rust-based Substrate framework, [Tanssi](https://www.tanssi.network/) offers high performance, flexibility, and rapid deployment via its library of pre-built pallets. Substrate's modular structure eases appchain creation and deployment.
{% endhint %}

### Baseline EVM (i.e. Ethereum Virtual Machine) Template <a href="#baseline-evm-template" id="baseline-evm-template"></a>

Extending the *Baseline AppChain template*, this template provides not only Immu3 AppChain support but also an EVM and full Ethereum compatibility. It enables an Ethereum compatibility layer for Immu3 ContainerChain to allow running unmodified Ethereum dApps while using tools and infrastructure like MetaMask out of the box.

### Features

* Transaction execution reliability
* Robust security and decentralisation inherited from Polkadot RelayChain
* Congestion resistant
* On-chain communication-specific
* Native apps: BlockCommunicator, W3XShare, PX Storage NFTs and PX Drive

### Resources

{% embed url="<https://chainlist.org/chain/3100>" %}


# Adding MetaMask

This user guide will help you connect MetaMask to the Immu3 AppChain.

## Add Immu3 AppChain TestNet to MetaMask

1. Go to MetaMask settings, click on *Network,* and then click *Add Network*.
2. Click on *Add a network manually*.
3. Fill in the details below:
   1. **Network Name**: Immu3 EVM TestNet
   2. **RPC URL**: <https://fraa-flashbox-2800-rpc.a.stagenet.tanssi.network>
   3. **ChainID**: 3100
   4. **Symbol**: IMMU
   5. **Block Explorer URL**: <https://evmexplorer.tanssi-chains.network/?rpcUrl=https://fraa-flashbox-2800-rpc.a.stagenet.tanssi.network>
4. Click *Save*