# What is WECO?

𝗧𝗛𝗘 𝟯: 𝗕𝘂𝗶𝗹𝗱, 𝗨𝘀𝗲, $𝗪𝗘𝗟𝗟

<figure><img src="/files/vK59fKEfJ78oi72rf9Xx" alt=""><figcaption><p>𝗧𝗛𝗘 𝟯: 𝗕𝘂𝗶𝗹𝗱, 𝗨𝘀𝗲, $𝗪𝗘𝗟𝗟</p></figcaption></figure>

Introducing THE 3 — where innovation meets simplicity. Empower builders and users with a seamless digital experience, unified by a single identity, driven by the power of $WELL. It’s more than an ecosystem; it’s the future of interconnected possibilities.

1. **Build WECO** \
   \
   \&#xNAN;*��𝗲𝗹𝗹.𝗲𝗰𝗼 – 𝗢𝗻𝗲 𝗣𝗹𝗮𝘁𝗳𝗼𝗿𝗺. 𝗦𝗲𝗮𝗺𝗹𝗲𝘀𝘀 𝗖𝗼𝗻𝗻𝗲𝗰𝘁𝗶𝗼𝗻𝘀.* \
   \
   Introducing <http://well.eco> – the gateway to a vibrant network of users. Empowering builders to create seamless connections with WELL ID users. With our intuitive SDK, companies can effortlessly integrate and engage with the user base, driving innovation and fostering collaboration across the ecosystem.<br>

<figure><img src="/files/STBwmPIXRzsnfdUj58VL" alt="" width="375"><figcaption></figcaption></figure>

2. **Use WELL ID** \
   \
   \&#xNAN;*WELL ID - 𝗢𝗻𝗲 𝗜𝗗. 𝗕𝗼𝘂𝗻𝗱𝗹𝗲𝘀𝘀 𝗔𝗰𝗰𝗲𝘀𝘀.* \
   \
   Introducing WELL ID – your unified digital identity. This single ID opens up a world of possibilities, giving users easy and secure access to a variety of applications across different blockchains. Experience seamless integration and unparalleled convenience, effortlessly connecting you to <http://well.eco.&#x20>;

<figure><img src="/files/frWaafktkcc6WiQBD3Vt" alt="" width="375"><figcaption><p><em>WELL ID - 𝗢𝗻𝗲 𝗜𝗗. 𝗕𝗼𝘂𝗻𝗱𝗹𝗲𝘀𝘀 𝗔𝗰𝗰𝗲𝘀𝘀</em></p></figcaption></figure>

2. **$WELL**\
   \
   \&#xNAN;*$𝗪𝗘𝗟𝗟 – 𝗢𝗻𝗲 𝗧𝗼𝗸𝗲𝗻. 𝗘𝘀𝘀𝗲𝗻𝘁𝗶𝗮𝗹 𝗳𝗼𝗿 𝗔𝗹𝗹.* \
   \
   Introducing $WELL – the exclusive currency powering <http://well.eco> for both builders and users. $WELL drives value exchange, incentivizes participation, and fosters a thriving, interconnected economy.

<figure><img src="/files/JPqqeOileudG37X5R3t1" alt="" width="375"><figcaption><p><em>$𝗪𝗘𝗟𝗟 – 𝗢𝗻𝗲 𝗧𝗼𝗸𝗲𝗻. 𝗘𝘀𝘀𝗲𝗻𝘁𝗶𝗮𝗹 𝗳𝗼𝗿 𝗔𝗹𝗹</em> <br></p></figcaption></figure>


# How to join

𝗜𝗳 𝗬𝗼𝘂 𝗔𝗹𝗿𝗲𝗮𝗱𝘆 𝗛𝗮𝘃𝗲 𝗮 𝗪𝗘𝗟𝗟 𝗜𝗗:&#x20;

1\. Visit <https://well.eco/weco> \
2\. Click “𝗦𝗶𝗴𝗻 𝗶𝗻 𝘄𝗶𝘁𝗵 𝘄𝗮𝗹𝗹𝗲𝘁” \
3\. Connect using the wallet where you minted your WELL ID \
4\. You're now part of 𝗪𝗘𝗖𝗢!&#x20;

𝗜𝗳 𝗬𝗼𝘂 𝗗𝗼𝗻’𝘁 𝗛𝗮𝘃𝗲 𝗮 𝗪𝗘𝗟𝗟 𝗜𝗗: \
\
1\. Visit <https://well.eco/weco> \
2\. Select your preferred sign-in method \
3\. Scroll down and click “𝗖𝗼𝗻𝗻𝗲𝗰𝘁 𝗪𝗮𝗹𝗹𝗲𝘁” \
4\. Choose “𝗟𝗶𝗻𝗸 𝗪𝗮𝗹𝗹𝗲𝘁” and then click “𝗟𝗶𝗻𝗸” \
5\. Enter your desired WELL ID name and click “𝗖𝗿𝗲𝗮𝘁𝗲” \
6\. Your WELL ID will be minted \
7\. Welcome to 𝗪𝗘𝗖𝗢!


# Dashboard

well.eco/weco

WELL3 has introduced a new dashboard on well.eco/weco that enhances user experience by providing a comprehensive overview of their activities within the platform. The dashboard displays users' linked accounts, including options like Google, Apple, and MetaMask, alongside their unique WELL ID and wallet address. Additionally, it showcases the number of WELL projects in which users are participating, offering insights into their engagement with various sustainability initiatives.&#x20;

The WELL3 app dashboard also highlights collaborative projects, complete with direct links to the official websites of these initiatives, enabling users to easily explore and connect with the wider WELL3 ecosystem.

<figure><img src="/files/qSPTHOYaHrbdRuPpkCVR" alt=""><figcaption><p>WELL3 App Dashboard Overview</p></figcaption></figure>

<figure><img src="/files/6TJaVPowQSuGQPbmM6Ks" alt=""><figcaption><p>WELL3 App Dashboard partners</p></figcaption></figure>


# SDK

The **SDK (Software Development Kit)** is a set of tools and libraries that developers can use to integrate WELL3's features into their own applications. Here's a step-by-step guide to get you started:

**Step 1: Set Up Your Development Environment**

1. *Install Node.js*: Ensure you have Node.js installed on your system. You can download it from the official Node.js website.
2. *Create a New Project*: Create a new directory for your project and initialize it with npm init to create a package.json file.

#### Step 2: Install the WELL3 SDK

1. *Install the SDK*: Use npm to install the WELL3 SDK by running the following command: bash npm install well3-sdk

#### Step 3: Initialize the SDK

1. *Import the SDK*: In your project's main file (e.g., index.js), import the WELL3 SDK: javascript const WELL3 = require('well3-sdk');

#### Step 4: Connect to the WELL3 Platform

1. *Initialize the SDK*: Create an instance of the SDK and connect to the WELL3 platform: javascript const well3 = new WELL3({ apiKey: 'YOUR\_API\_KEY', apiSecret: 'YOUR\_API\_SECRET' });

#### Step 5: Use SDK Features

1. *Fetch User Data*: Use the SDK to fetch user data from the WELL3 platform: javascript well3.getUserData(userId, (err, data) => { if (err) { console.error('Error fetching user data:', err); } else { console.log('User data:', data); } });
2. *Submit Health Data*: Submit health data to the WELL3 platform: javascript well3.submitHealthData(userId, healthData, (err, response) => { if (err) { console.error('Error submitting health data:', err); } else { console.log('Health data submitted successfully:', response); } });
3. *Earn Rewards*: Use the SDK to check and redeem rewards: javascript well3.checkRewards(userId, (err, rewards) => { if (err) { console.error('Error checking rewards:', err); } else { console.log('Rewards:', rewards); } });

#### Step 6: Handle Errors

1. *Error Handling*: Implement error handling to manage any issues that arise during SDK usage: javascript try { // SDK operations } catch (error) { console.error('An error occurred:', error); }

This is a basic guide to get projects started with the WELL3 SDK. Please refer to the official WELL3 documentation for more detailed information and advanced features.


# Partnerships

Join Us & Transform the Future of Wellness

AI buddy powered by the CohortX protocol is the the first first-ever decentralized application (DAPP) launch on 𝗪𝗘𝗖𝗢.

𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 represents the culmination of groundbreaking AI training innovation, designed to deliver a one-of-a-kind user experience. Now live on Telegram, 𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 opens the door to limitless interactions with your dream companions.&#x20;

{% embed url="<https://x.com/i/status/1848364725769556455>" %}

Here’s what makes 𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 a game-changer:&#x20;

1. 𝗣𝗹𝗮𝘆-𝘁𝗼-𝗔𝗶𝗿𝗱𝗿𝗼𝗽: Train your AI, play exciting games, and earn [$LOVE](https://x.com/search?q=%24LOVE\&src=cashtag_click) coins and 𝗘𝗚𝗚𝘀 in-game. 𝗘𝗚𝗚𝘀 can be converted to [$CHX](https://x.com/search?q=%24CHX\&src=cashtag_click) tokens in the future, allowing you to combine fun with real rewards.
2. 𝗕𝘂𝗶𝗹𝘁 𝗼𝗻 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: Dive into 𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 directly from the Telegram app for a seamless and accessible experience.&#x20;
3. 𝗠𝘂𝗹𝘁𝗶-𝗹𝗮𝗻𝗴𝘂𝗮𝗴𝗲 𝗦𝘂𝗽𝗽𝗼𝗿𝘁: Break down language barriers and connect with users across the globe.&#x20;
4. 𝗔𝗜 𝗮𝗻𝗱 𝗨𝘀𝗲𝗿-𝗚𝗲𝗻𝗲𝗿𝗮𝘁𝗲𝗱 𝗖𝗼𝗻𝘁𝗲𝗻𝘁: Immerse yourself in rich, dynamic interactions powered by advanced AI and contributions from the community. 𝗚𝗲𝘁 𝗦𝘁𝗮𝗿𝘁𝗲𝗱 𝗮𝗻𝗱 𝗨𝗻𝗹𝗼𝗰𝗸 𝗘𝘅𝗰𝗹𝘂𝘀𝗶𝘃𝗲 𝗥𝗲𝘄𝗮𝗿𝗱𝘀 Join 𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 now with 𝗪𝗘𝗖𝗢 and be among the first to unlock 𝗲𝘅𝗰𝗹𝘂𝘀𝗶𝘃𝗲 𝗿𝗲𝘄𝗮𝗿𝗱𝘀.&#x20;

With 𝗪𝗘𝗖𝗢, users will gain access to exciting features and bonuses designed to enrich their experience within the WELL Ecosystem. This is more than just an app—it’s a milestone in the WELL Ecosystem and a glimpse into the future of AI-powered interactions. 𝗔𝗜 𝗕𝘂𝗱𝗱𝘆 sets the stage for what’s possible as we continue to push the boundaries of innovation within the WELL Ecosystem.


# How to buy $WELL

To buy $WELL3 tokens, you can trade them on centralized crypto exchanges like **Bybit, Bitget, Gate.io,** and **MEXC.**<br>

{% embed url="<https://twitter.com/i/status/1808481243136487758>" %}

**Here's a quick guide on how to do it:**\
1\. Create an account on a crypto exchange that supports $WELL3.\
2\. Complete the KYC (Know Your Customer) process to verify your identity.\
3\. Deposit USD or any other preferred currency into your exchange account using a bank transfer or credit/debit card.\
4\. Select $WELL3 and select the fiat currency that you want to pay with.\
5\. Enter the purchase amount. You can enter the transaction amount based on fiat currency or coin, according to your needs.\
6\. Select preferred Payment Method.\
7\. Confirm the transaction and wait for your $WELL3 tokens to be credited to your account.\
8\. Store your tokens in a secure crypto wallet to keep custody of your assets.

Remember to check the payment details carefully before confirming your order.


# Deposit $WELL into TON wallet

Instructions for bridging on the TON Network:

1. Navigate to <https://bridge.ton.org/&#x20>;
2. Connect your Ethereum wallet that holds $WELL.&#x20;
3. Click on the dropdown menu labeled "Asset."&#x20;
4. Select "other tokens."&#x20;
5. Enter the $WELL ETH Contract Address: 0x63696Fc66795B51d02c1590b536484A41fbDDF9a
6. Specify the amount of $WELL you wish to bridge.&#x20;
7. Authorize the expenditure of $WELL.&#x20;
8. Link your TON wallet.&#x20;
9. Click on "Transfer."&#x20;
10. Sign the transaction from your Ethereum wallet.&#x20;
11. Wait for the Ethereum transaction blocks to be confirmed.&#x20;
12. Sign the transaction from your TON wallet.&#x20;
13. Wait for the TON transaction blocks to be confirmed.&#x20;
14. Your $WELL will be deposited in your TON wallet.

Disclaimer:

1. The bridging fee on the Ethereum network varies based on network traffic.
2. The bridging fee on the TON network is 1 $TON. User need to have $TON available in the destination wallet to cover the fee.
3. The entire process may take approximately 20 to 30 minutes, depending on the current network conditions.&#x20;


# Sign In

WECO provides login options via Google, Apple ID, X, Telegram, and Metamask, seamlessly bridging Web2 and Web3 without barriers.

Visit <https://well.eco> to create your WECO account and mint a free WELL ID to kickstart your journey.

<figure><img src="/files/frWaafktkcc6WiQBD3Vt" alt="" width="375"><figcaption></figcaption></figure>


# Benefits

WELL ID is the heart of the WELL3 Ecosystem.

Discover the benefits you can unlock by registering a WELL ID.&#x20;

1. **Rewards & Tokens**&#x20;

   Every action or on-chain interaction transaction associated with WELL ID will be converted into a reward matrix, which will then be transformeded into $WELL tokens, allowing users to earn $WELL.<br>
2. **Airdrops & Exclusive Access**

   Access and interact with projects within the WELL3 ecosystem and earn rewards. Gain access to whitelists, airdrops, special events, challenges, and community initiatives designed to promote wellness and reward healthy behaviors.


# Setup

## Step 1:

You will receive the following data for your project

```
1. Project ID (UUID string)
2. project_secret (string)
3. jwt public key (for varifying the jwt token, optional)
```

## Step 2:

Use the following private API to update your account info

## Update account info

<mark style="color:green;">`POST`</mark> [https://api.well.eco/oauth/account/{project\_id}](https://api.well.eco/oauth/account/{your_project_id})

An API to update your account info

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body(JSON)**

<table><thead><tr><th width="216">Name</th><th>description</th></tr></thead><tbody><tr><td>secret</td><td>The secret provided by us (required)</td></tr><tr><td>host</td><td>The host that match your website, you need to set this for your account to work probably</td></tr><tr><td>privacyPolicyURL</td><td>Your privacy policy page URL (optional)</td></tr><tr><td>termsOfServiceURL</td><td>Your terms of service page URL (optional)</td></tr><tr><td>logoURL</td><td>Your logo url, prefer linking to a 50x50 jpg image, please set this as it will affect how your project looks on the WECO website</td></tr><tr><td>infoURL</td><td>Link to your website, will display on WECO website</td></tr><tr><td>type</td><td>Type of your project, will display on WECO website</td></tr><tr><td>chain</td><td>Chain of your project, will display on WECO website</td></tr><tr><td>tgResultCallbackURL</td><td>Required if you are using the oauth in a telegram app</td></tr><tr><td>tgBotID</td><td>Required if you are using the oauth in a telegram app</td></tr><tr><td>tgBotMiniAppURL</td><td>Required if you are using the oauth in a telegram app, the url to open your telegram mini app</td></tr></tbody></table>

## Example

```
{
    "secret": "your_project_secret",
    "host": "test.com",
    "privacyPolicyURL": "https://test.com/privacy.html",
    "termsOfServiceURL": "https://test.com/tos.html",
    "logoURL": "https://test.com/logo.jpg",
    "infoURL": "https://test.com",
    "type": "AI",
    "chain": "ETH",
    "tgResultCallbackURL": "https://api.test.com/tg_callback",
    "tgBotID": "test",
    "tgBotMiniAppURL": "https://t.me/test/page",
}
```

**Response**

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

```json
{
    "host": "test.com",
    "privacyPolicyURL": "https://test.com/privacy.html",
    "termsOfServiceURL": "https://test.com/tos.html",
    "logoURL": "https://test.com/logo.jpg",
    "infoURL": "https://test.com",
    "tgResultCallbackURL": "https://api.test.com/tg_callback",
    "tgBotID": "test",
    "tgBotMiniAppURL": "https://t.me/test/page",
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}


# How to OAuth

Depending on your usage, you can implement this with pop-up window or redirection

## Popup window method

Add a message event listener like the following

```javascript
window.addEventListener('message', async function(event) {
    console.log(event)
    // Check for the user data in the message
    if (event.data?.type === 'well-oauth-token' && event.data?.token) {
        // verify and store the token in a secure way
        const jwtToken = event.data?.token;
        // Close the popup window
        if (popup) {
            popup.close();
        }
    }
});
```

## Redirect method

Set location.href

```javascript
location.href = `https://api.well.eco/oauth/auth?state=${randomString()}${Math.floor(Math.random() * 100000)}&redirect_url=${encodeURIComponent(yourURL)}`;
```

If the oauth success, the token will be included as the search param to the redirect\_url provided.

You can get the redirect token with the following code:

```javascript
const initialToken = new URLSearchParams(location.search).get('token');
```

After getting the token, you can request the user information with the following API

## Fetch with token

<mark style="color:green;">`GET`</mark> [`https://api.well.eco/oauth/me`](https://api.well.eco/oauth/me)

**Headers**

| Name         | Value                 |
| ------------ | --------------------- |
| Content-Type | `application/json`    |
| oauth-token  | {`jwt_token_you_get}` |

**Body(JSON**

<table><thead><tr><th width="190">Name</th><th width="106">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td>id of the user</td></tr><tr><td><code>linkedAddress</code></td><td>string</td><td>linked ETH address</td></tr><tr><td><code>token</code></td><td>Object</td><td>Type as below</td></tr></tbody></table>

```javascript
{
  "description": string,
  "image": string,
  "tokenId": string,
  "name": string,
  "attributes": [
    {
      "trait_type": string,
      "value": string
    }
  ],
  "createdAt": string
}
```

**Response**

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

```json
{
  "id": "nX9d7H3cPQWmxrK2t3jh4UzIcGo5",
  "linkedAddress": "0x3F8B9a45678dCd872e93Be582f54AFe912b874Dc",
  "token": {
    "description": "Hello test.well, Well ID is the digital identity representing you in the ever growing network of wellness. Powered by WELL3.",
    "image": "https://s3.well3.com/WellID/7752/1.jpg",
    "tokenId": "77522218045247854526172210698749283758228288462773800836215567039694054862682",
    "name": "test.well",
    "attributes": [
      {
        "trait_type": "Type",
        "value": "Well ID"
      }
    ],
    "createdAt": "1713175672123"
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

## Telegram mini app oauth

1. Use the update account API to update your "tgResultCallbackURL", "tgBotID", "tgBotMiniAppURL"
2. Add the following code to your link/login well3 button callback

```javascript
window.open(`https://api.well.eco/oauth/tg-mini-app?oauth_app_id=${YOUR_WELL_APP_ID}`, '_blank');
```

3. Receive the result callback in your backend. The request will be a GET request, with a jwt attached to the API query. Nodejs example code:

```javascript
import jwt from 'jsonwebtoken';
router.get('/tg-well-oauth-callback', async (req, res, next) => {
  const decoded = jwt.verify(req.query.jwt, WELL_OAUTH_PROJECT_SECRET);
  const {tgUserID, token} = decoded;
  // Code to bind the user in your server with the access token
  await redis.set(`tg-test:${tgUserID}`, token);
  res.send();
});
```

4. Our telegram bot will have a button to redirect the user back to your telegram mini app with the tgBotMiniAppURL you provided, so it is important to fill in the URL.
5. When the user go back to your bot, fetch the access token stored in your server to get the Well user info.


# Full example code

```html
<!DOCTYPE html>
<html>
  <head>
    <title>Dapp</title>
  </head>
  <body>
    <h1>Welcome to Dapp</h1>
    <p>This is a simple dapp.</p>
    <p id="token">Token: </p>
    <p id="user">User: </p>
    <button
      onclick="login()"
    >
      login
    </button>
    <button
      onclick="redirectLogin()"
    >
      Redirect login
    </button>
  </body>
  <script>
    function redirectLogin() {
      location.href = `https://api.well.eco/oauth/auth?state=${Date.now()}${Math.floor(Math.random() * 100000)}&hostname=test.com&redirect_url=${encodeURIComponent('https://oauth-test.pages.dev')}`;
    }
    function login() {
      // Open a new popup window for the OAuth flow
      const popup = window.open(`https://api.well.eco/oauth/auth?state=${Date.now()}${Math.floor(Math.random() * 100000)}`, 'WELL OAuth', 'width=500,height=600');

      // Listen for messages from the popup window
      window.addEventListener('message', async function(event) {
        console.log(event)
          // Check for the user data in the message
          if (event.data && event.data.type === 'well-oauth-token' && event.data.token) {
              // Update the original page with the user's info
              document.getElementById('token').textContent = `Token: ${event.data.token}`;
              const res = await fetch('https://api.well.eco/oauth/me', {
                headers: {
                  'oauth-token': event.data.token
                }
              });
              const data = await res.json()
              document.getElementById('user').textContent = `User: ${JSON.stringify(data, null , ' ')}`;
              // Close the popup window
              if (popup) {
                  popup.close();
              }
          }

      });
    }
    (async () => {
      const initialToken = new URLSearchParams(location.search).get('token');
      console.log({initialToken})
      if (initialToken) {
        document.getElementById('token').textContent = `Token: ${initialToken}`;
        const res = await fetch('https://api.well.eco/oauth/me', {
          headers: {
            'oauth-token': initialToken
          }
        });
        const data = await res.json()
        document.getElementById('user').textContent = `User: ${JSON.stringify(data, null , ' ')}`;
        // Close the popup window
        if (popup) {
            popup.close();
        }
      }
    })();
  </script>
</html>

```

Test website:\
<https://oauth-test.pages.dev>


# Whitepaper 2025

Updated : March, 2025

1. **Introduction**

The decentralized WELLAIOS framework is an open-source AI Operating System (AIOS) designed to create a scalable and interoperable environment for building, deploying, and interacting with AI Agents across diverse platforms and devices. At its core, WELLAIOS functions as a middleware layer that facilitates cross-platform AI integration through the Model Context Protocol (MCP), which standardizes interactions between AI Agents and third-party AI tools, ensuring seamless interoperability regardless of hosting environments.

Developers independently build AI tools and connect them to the WELLAIOS ecosystem via API layers, maintaining full control over their tool hosting while integrating efficiently with the broader framework. The no-code interface on wellaios.ai empowers both developers and Agent creators to easily combine these AI tools with pre-existing assets, such as expressive 3D avatars and contextual knowledge bases, to craft highly personalized AI Agents without the need for complex coding.

Tokenomics is a fundamental aspect of WELLAIOS, with the $WELL token underpinning all transactions within the ecosystem. This includes paying for tool usage, staking for enhanced visibility, and incentivizing community contributions, thereby fostering a sustainable and incentivized economic model. Through its modularity, developer-driven expansion, and robust Web3 integration, WELLAIOS establishes itself as a versatile AI framework that seamlessly bridges traditional digital ecosystems with the decentralized future, empowering developers, creators, and users to interact with intelligent agents in a more open and scalable way.<br>

2. **Product and Technology**

**1️⃣ Middleware Layer: Cross-Platform AI Integration**

WELLAIOS is designed as a middleware solution that enables seamless AI interoperability across multiple platforms and devices. It integrates with instant messenger mini-apps, allowing AI companions to function within Telegram, LINE, and other messaging ecosystems. Additionally, the AI companions are accessible via a web-based dashboard on wellaios.ai, ensuring users can manage and interact with their AI agents across different environments.

At its core, WELLAIOS leverages multimodal AI to create intelligent and interactive AI companions. It incorporates Retrieval-Augmented Generation (RAG) for dynamic and context-aware responses, Text-to-Speech (TTS) for natural AI-generated voices, and Speech-to-Text (STT) for fluid voice-based communication. This combination allows AI companions to deliver highly personalized and lifelike interactions, adapting to various user needs.

WELLAIOS supports multi-model 3D avatars, including NFT-based avatars that enable ownership and interoperability within Web3 applications. A decentralized marketplace allows users to acquire, customize, and trade 3D avatars, AI personas, and custom knowledge bases. Users have full control over their AI companion’s persona, enabling real-time updates and tailored AI intelligence. Furthermore, WELLAIOS extends AI interaction into holographic projection, enabling AI avatars to be rendered in real-world environments through hologram-compatible devices.

**2️⃣ No-Code AI Asset Management**

WELLAIOS provides a no-code AI asset management framework, empowering users to create, customize, and deploy AI companions without requiring technical expertise. The wellaios.ai platform acts as a central hub where users can manage AI assets, integrate AI tools, and personalize AI interactions through an intuitive interface.

The marketplace enables users to acquire AI avatars, personas, and AI tools to enhance their AI companions. By selecting and integrating different AI capabilities, users can tailor their AI companions to serve specific functions, such as virtual assistants, automated content creators, or interactive digital personas. This plug-and-play approach democratizes AI customization, making it accessible to both individuals and businesses without the need for coding.

**3️⃣ Open-Source AI Innovation**

WELLAIOS fosters an open-source AI ecosystem, allowing developers to contribute AI tools (AI agents) that can be integrated into AI companions. Through an API & SDK framework, WELLAIOS will provide a modular SDK and standardized API interface that enables developers to contribute AI Tools. These tools will be callable within the AI agent runtime via secure APIs. Developers can containerize their tools or host them on pre-approved infrastructure, exposing inputs/outputs that conform to system-defined protocols. Over time, WELLAIOS will support large commercialized models via APIs, and webhook-based automation workflows, allowing domain experts to integrate their own logic or datasets.

A Decentralized AI Tool Library serves as a permissionless repository where developers and users can access, contribute, and integrate AI enhancements. This library ensures that AI companions continuously evolve with new capabilities, fostering an adaptive AI ecosystem driven by community contributions. By adopting an open AI integration model, WELLAIOS allows AI companions to incorporate third-party AI models, advanced automation functions, and specialized AI agents, creating a modular and extensible AI framework.

Through its middleware infrastructure, no-code AI deployment, and open-source collaboration, WELLAIOS transforms AI agents into scalable, customizable, and monetizable assets. By leveraging decentralized governance and Web3 token incentives, it establishes a sustainable AI ecosystem where users, developers, and AI tools interact seamlessly, shaping the future of AI-driven digital experiences.

3. **Stakeholders & Activities**

**1️⃣ AI Developers**

* **Submit modular AI Tools to the open-source AI Developer Centre.**
* Tools can include text processing, image generation, summarization, logic modules, etc.
* Earn when Agent Creators use their tools in live AI Agents.
* Stake $WELL tokens to boost visibility and ranking in the Agent Creator Centre.

**2️⃣ NFT Owners**

* Contribute 3D NFT avatars to the Avatar library.
* Manage avatars and reveal eggs through the NFT Centre.
* Earn rental fees when Agent Creators use their avatars.
* Stake $WELL tokens to boost avatar visibility in the Agent Creator Centre.

**3️⃣ Agent Creators**

* Use the Agent Creator Centre to:
* * Choose base LLM (e.g. GPT-4o, DeepSeek, Grok … etc)
  * Select AI Tools from the Developer Library
  * Rent a 3D NFT avatar
  * Upload a knowledge base (docs, links, prompts) / RAG / Memory
  * Describe the AI Agent’s function/personality
  * Choose where to deploy (wellaios.ai, Telegram MiniApp, website embed)
* Pay for AI tools and avatars in $WELL
* Stake $WELL to boost the discoverability of their agents on the Agent Marketplace.

**4️⃣ End Users**

* Discover AI Agents from the Wellaios.ai Agent Marketplace, shared invite links, or embedded widgets.
* Interact seamlessly across platforms without registration.
* Optionally pay Agent Creators for premium features or personalization.\ <br>

4. **$WELL Token utilities**

The $WELL3 token serves as the foundational asset of the WELLAIOS ecosystem, enabling functionality, ownership, governance, and incentives. It integrates every participant in the AI Agent economy—developers, NFT owners, creators, and users—through clearly defined economic interactions.

1️⃣ Creation & Access Economy

* Agent Creators use $WELL3 to purchase or rent AI Tools contributed by developers and 3D NFT Avatars contributed by NFT holders.
* $WELL3 can be used for direct payments or to unlock discounted usage relative to fiat.
* End users pay $WELL3 (or fiat, which is auto-converted) to access premium features such as personalized memory, advanced personalities, exclusive voices, or motion libraries.

2️⃣ Staking for Visibility & Curation

* AI Developers stake $WELL3 to increase their AI Tools' exposure in the Agent Creator Centre.
* NFT Avatar Owners stake to boost the ranking and visibility of their avatars in the Avatar Marketplace.
* Agent Creators stake $WELL3 to boost the discoverability and homepage placement of their AI Agents.

3️⃣ Incentivized Contribution & Earning

* AI Developers earn $WELL3 when their tools are used in deployed AI Agents.
* NFT Owners earn $WELL3 rental revenue when their avatars are selected.
* Agent Creators can monetize their Agents via platform usage or 3rd-party integration.
* A portion of fees may be redistributed into staking or reward pools to encourage network participation.

4️⃣ Governance & Incubation (Future)

* Token holders will eventually participate in governance, such as:
* * Approving new incubation grants for creators or developers
  * Deciding reward distribution rules for contributors
  * Voting on ecosystem upgrades or standard proposals

5️⃣ Creator Economy Utilities

* NFT Reveal and Minting: $WELL3 is required for revealing NFT eggs and unlocking avatar utilities.
* Subscription or Tier Access: Certain premium agent features—such as advanced tools, exclusive avatars, or personalized functions—can be unlocked by paying with $WELL3, allowing creators to offer tiered access or subscriptions based on user engagement.
* Future DAO-initiated programs may allow creators to earn multipliers or reputation boosts by staking their tokens.

6️⃣ Lanuchpad Participation

* $WELL holders can stake their tokens to gain early access to new meme coin offerings launched on the platform
* Projects launching meme coins on the WELLAIOS platform must pay a fixed fee or a percentage in $WELL
* $WELL can be staked to support liquidity pools for newly launched meme coins
* $WELL token holders can vote on which projects to feature on the launchpad

<br>

5. **Roadmap**

📅 Q1<br>

* Prototype Testing on Telegram (WebGL)
* AI Agents on Twitter
* Generative AI for 3D avatars

📅 Q2

* WELLAIOS Dashboard
* NFT Yogapetz reveal
* AI Agent Chat Page Upgrade with AI Tools and Avatars

📅 Q3

* Agent Centre&#x20;
* No-Code Agent Creation
* Ecosystem Expansion

📅 Q4

* Open-source Framework and Developer Activation
* AI Agent Intelligence Layer Upgrade
* Multi-Platform SDK Launch
* Token Launchpad for AI Agents

6. **Security and Transparency**

WELLAIOS is committed to ensuring user safety and ecosystem integrity through transparent AI behavior tracking and on-chain financial accountability.

All AI Agents deployed on WELLAIOS are designed with auditable reasoning pipelines. Each interaction, including prompt inputs, tool activations, decision paths, and LLM outputs, is logged securely with time-stamped execution traces. These logs form the foundation for real-time monitoring, misuse detection, and post-hoc audits, enabling developers and users to trace back agent behavior and improve model reliability.

To safeguard against unintended or harmful outputs, agent logs may be subjected to automatic evaluation using safety filters and behavioral diagnostics. Agent creators can opt into publishing anonymized agent performance data to foster ecosystem-wide learning and quality assurance.

On the economic layer, all critical transactions—such as AI Tool purchases, avatar rentals, staking, and agent monetization—are recorded on-chain via smart contracts. This transparent ledger ensures that creators and contributors are properly rewarded, while providing a public and immutable view of the network’s economic health. Token flows and staking metrics can be independently audited by any participant, reinforcing trust and fairness in reward distribution.

By combining AI activity traceability with on-chain financial transparency, WELLAIOS delivers a comprehensive decentralized framework for accountable, secure, and user-aligned AI experiences.

7. **Conclusion**

WELLAIOS is a decentralized, open-source AIOS framework that empowers anyone to create, manage, and deploy AI agents across platforms. Its middleware architecture supports real-time interaction through web, Telegram, and holographic displays, with support for Retrieval-Augmented Generation (RAG), Text-to-Speech (TTS), Speech-to-Text (STT), and animated 3D avatars. Users can build agents with no code, customize knowledge bases and personas, and launch them across multiple interfaces.

Developers contribute modular AI tools to an open-source library, which Agent Creators integrate into functional agents. These agents are then monetized by end users who pay to interact with them—whether via microtransactions, subscriptions, or platform-integrated services. $WELL3 powers this economy by facilitating payments, staking, access prioritization, and creator incentives. It ensures that every AI interaction is composable, verifiable, and reward-aligned—creating a sustainable system for open, secure, and user-driven AI applications.

\ <br>


