# Project X

Utility-driven powerhouse, combining a community owned DAO, blockchain tools, and visual storytelling under one web3 brand.

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FSe9qvD9GwMwfl3li5HCg%2FLogoAnime.gif?alt=media&amp;token=3ad3f890-5715-4726-8c0e-414c09c127f9" alt=""><figcaption><p>#FollowTheX</p></figcaption></figure>


# NFTs

All collections of Project X

[Subject X](https://xoxno.com/collection/SUBJECTX-2c184d) - Main Collection - DNA miners - Upgradeable\
A digital collection of 5000 randomly generated PFPs that powers the DAO.

Titans - [Tier-2 Entities](/project-x/dao)\
Non-tradable 1 of 1 NFTs with special Perks & Utilities.

[Divergent Club](https://xoxno.com/collection/DCLUB-b0ddcb) - subDAO Collection - Community Lead\
A collection of 3333 generative pixelized characters exploring the world and the MultiversX blockchain. The Club aims to create a vibrant community hub where individuals can come together, have fun, and thrive from the Club benefits.

[DNA Capsules](https://xoxno.com/collection/XCAPSULE-78c42c) - Utility\
This SFT is crafted with the sole purpose of amplifying the capabilities of Subject X.

[Boxes](https://xoxno.com/collection/XBOX-634ad5) & [Keys](https://xoxno.com/collection/XKEY-d6ccf4) - Gamify Collection\
This collection introduced mystery on MultiversX. Grab a Box and a Key to win a random prize -> <https://dapp.projectx.mx/unbox>

[X Capsules](https://xoxno.com/collection/SUBJECTX-1e3de1) - Mintable Collection\
Each capsule contains a Subject X. Used to gamify the mint experience and add a new layer of depth to the minting process.

[Milk Bottle](https://xoxno.com/collection/DCMILK-7fb496) - Utility\
Got Milk?


# Token (DNA)

The next-gen utility token of Project X

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FObSrf7FSqLfs5hxDhWbC%2FDNA.PNG?alt=media&amp;token=c16b1941-12ac-45c5-b8a1-2b1f65ece941" alt=""><figcaption></figcaption></figure>

**Status**: [Mining Concluded](https://explorer.multiversx.com/tokens/DNA-b144d1) (All Epochs Complete)\
Token Type: [ESDT](https://docs.multiversx.com/tokens/intro/) (MultiversX)\
Max Supply: [**16,180,339 DNA**](https://en.wikipedia.org/wiki/Golden_ratio)

***

### Initial Distribution & History

[DNA](https://explorer.multiversx.com/tokens/DNA-b144d1) was issued via a fair-launch mechanism with no pre-mine. The token began with a supply of **0** and was fully distributed to staked Subject X NFTs over the course of the mining epochs.

* Fair-Launch: 100% of the supply was distributed to DAO members (Subject X).
* Staking: Distribution was achieved through a in wallet-staking mechanism, where holding the NFT in wallet generated the token.

***

Mining Concluded (all 4 Epochs Complete) on 11th of January 2026. Max supply has been reached. DNA became deflationary.


# Tokenomics

### Historical Tokenomics

*Note: The mining phase has ended. The data below represents the historical emission schedule.*

The DNA supply cap is 16,180,339 DNA. The distribution followed a deflationary model featuring 3 "Cleavages" (halving periods). Each Cleavage reduced the staking rewards by 50%.

#### The Cleavage Milestones

* 1st Cleavage: Occurred at 8,090,169.5 DNA
* 2nd Cleavage: Occurred at 12,135,254.25 DNA
* 3rd Cleavage: Occurred at 14,157,796.625 DNA

#### Genesis Emission Rates

During the active mining epochs, rewards were calculated as follows (prior to halving effects):

* Subject X: Mined 4.8 DNA/day (0.2 DNA/hour).
* Subject X²: Mined 14.4 DNA/day (0.6 DNA/hour).


# Utility & Ecosystem

DNA is the lifeblood of the Project X ecosystem. It is a next-generation utility token designed to reward the community and power the DAO.

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2F8d4pKHuufQFOeEhK2of6%2FInfographicIII-01.png?alt=media&amp;token=efad014b-27c1-4757-afc6-9709176ee9a4" alt=""><figcaption></figcaption></figure>

#### Core Utilities

* **Governance & DE-FI:** DNA represents your share in Project X DAO. As shown in the ecosystem diagram above, the DAO captures revenue from products, royalties, and tools. Holders effectively govern the direction of these funds, with 100% of royalties and product revenue flowing back into the ecosystem to support buybacks, the Liquidity Pool and development.
* **Evolution & Upgrades:** DNA is the catalyst for evolution. It was required to upgrade Subject X to Subject X² (granting boosted rewards and additional art). It will continue to play a vital role in future evolutions, including the upcoming Subject X³ mechanics.
* **Ecosystem Currency:** DNA acts as the native digital currency for the X ecosystem, removing the need for centralized intermediaries. It provides access to:
  * Boosted EGLD staking rewards
  * Exclusive Merchandise
  * Raffles and Auctions
  * Gated Events and Quests
  * Future Minting opportunities
* **Incentivization Layer:** Builders and developers incorporating DNA into their platforms (games, marketplaces, services) are incentivized by the Project X ecosystem, further expanding the token's utility.

#### Future Outlook

With the mining phase complete, the focus shifts entirely to utility and circulation. New use cases, DE-FI mechanisms, and the Subject X³ evolution are in development.

*More to be unlocked...*


# DAO

The first fully community-owned DAO on MultiversX

The DAO lies at the heart of Project X. It is a transparent and democratic governance structure that allows holders ([Subject X](/project-x/nfts)) and employees to manage and control the project.

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2Fq6aADWejbmkyNST7O9Cd%2FX%20DAO.jpg?alt=media&amp;token=4ef8e2b5-e19c-4627-8084-b70f26843ff5" alt=""><figcaption></figcaption></figure>

The governance structure of the X DAO is based on NFTs, which enable holders to cast their votes on important decisions proposed by the Creators and the community *(1 Subject X = 1 VOTE)*. These votes can take various forms, including yes/no decisions, polls, and elections.

Version 2.0 of the DAO (made in collaboration with PeerMe) can be found here -> <https://peerme.io/project-x>


# Framework

A Decentralized Autonomous Organization (DAO) framework consists of several key components and features that enable the organization to function autonomously, driven by the consensus of its members.

### Introduction

The Decentralized Autonomous Organization (DAO) system within Project X is designed to give the holders a direct say in project decision-making. This document outlines how our DAO operates, leveraging NFTs as voting tokens to empower our community.

### Voting Power

[In the X DAO](https://peerme.io/peerings/project-x), each [Subject X](https://dapp.projectx.mx/explorer) (NFT) serves as a vote. This approach allows every NFT holder to actively participate in project decisions. While bigger holders have a bigger impact, it is important to note that there is not one member that holds more than 3.33% of the voting power at this moment.

### Proposal Mechanism

#### Community and Team Proposals

Proposals for actions, updates, or changes can be initiated by both community members and our project team within our Discord community and in an upcoming update, directly on the DAO platform. Each Proposal is required to have a clear structure, view and pool.

The Colossus, a select group of large holders (25+ NFTs), play a vital role in our DAO. They review and enhance proposed votes by the community before they go live. Their guidance ensures proposal clarity and quality.

### Voting Parameters

#### Transparency and Accessibility

To maintain transparency, we define the minimum number of votes required (for now set at 1.000 Votes) for a proposal to pass and the duration of voting (usually 3 to 7 days). This information is accessible on our partner platform, [PeerMe](https://peerme.io/peerings/project-x), where the voting process occurs. Please note that the voting time can change depending on the "speed of reaction to an event" or the magnitude of the vote.

### Future Enhancements

#### Inclusivity

In the near future, every NFT holder will have the ability to make direct votes. This can be done on the PeerMe or our official website, enhancing inclusivity and decentralization.

### Conclusion

The PROJECT X DAO framework empowers NFT holders by giving them a voice in project decisions. We are committed to maintaining transparency and quality through community involvement and the Colossus review. Our future enhancements will further democratize the decision-making process, "giving the power to the people".


# Factions

The 5 pieces of the DAO

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FW3bI4LKVmHi0PBdeUIBT%2Flocked%20factions.png?alt=media&amp;token=fa601f59-2f20-494f-9661-0bdb4a6970f0" alt=""><figcaption><p>X-DAO Faction</p></figcaption></figure>

The Factions within Project X are independent entities operating under the project's umbrella, led by their own leaders with the freedom to innovate and promote initiatives using DAO funds.&#x20;

Factions play a vital role in Project X's backbone by boosting engagement, marketing efforts, and community involvement through various activities such as socials, campaigns, and product development.

Their decision-making, supported by multisig smart contracts, adds a layer of transparency and responsibility.

Funded by secondary sales and revenue platforms, subDAOs handle a wide range of responsibilities, contributing to Project X goal of becoming a leading example of community-owned projects in the web3 ecosystem, aligning with popular practices in blockchain ecosystems like Solana, Ethereum, and Polygon other community centric NFT ecosystems. These help Projects tremendously in increasing exposure, community bonds and every other part of a Project. Some examples: DeGods, Brozo, y00ts.


# Products

Powered by Project X | Developed by Lucky Birds Labs

Our development efforts are dedicated to serving the entire MultiversX community and all projects within the ecosystem. Our goal is to establish industry standards and elevate MultiversX as a leading L1 blockchain platform.

The funds generated by our products are distributed equitably among our community members through the innovative [DNA Token](/project-x/token-dna), that embodies a tangible piece of our companies achievements, fostering a mutually advantageous connection between our initiatives and Project X Holders.


# Website

The X-Map

Our new website is designed to provide a comprehensive, real-time view of **Project X** and its ecosystem. Every event that occurs on the website is directly linked to our products and the **MultiversX blockchain**, ensuring complete transparency and up-to-date information.

You can track product performance, revenue generation, DAO activities, and more—all in real time. This integration with the blockchain allows users to see every action and interaction live, giving a full picture of the DAO's operations and the value generated by our ecosystem.

The website serves as a hub where you can explore all facets of **Project X as events**, from governance to product updates, with data that’s directly tied to on-chain transactions.

{% embed url="<https://projectx.mx/>" %}


# KEPLER

High-performance infrastructure layer purpose-built for the MultiversX ecosystem.

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2F4gfBHnj92sd2bNrCo8X8%2Fimage.png?alt=media&amp;token=43c6f50f-078e-48b7-9efd-2b6149df7190" alt=""><figcaption></figcaption></figure>

### Welcome to KEPLER

We give developers the tools they need to launch and scale dApps without spending time managing nodes, renting oversized servers, or setting up backend services from scratch.

KEPLER provides reliable access to blockchain data through private APIs, event streams, and managed nodes, allowing developers to build faster and scale without worrying about infrastructure maintenance.

Kepler powers all major Project X products — from **Saturn** (real-time token and NFT event engine) and **Atlas** (wallet analytics) to the **Project X Validator** and internal DAO systems — and is now available for everyone.

***

### What Kepler Does

Kepler abstracts the complexity of running and maintaining MultiversX observers, gateways, and indexers. It provides a single, unified interface for querying, subscribing, and delivering blockchain data in real time.

* **Private APIs** — fast and reliable endpoints for accounts, transactions, tokens, and NFTs.
* **Custom APIs** — tailored endpoints designed for specific business needs, optimized for each use case while maintaining performance and consistency.
* **ElasticSearch indexing** — optimized data search and filtering at scale.
* **Event Streams** — real-time push of token swaps, NFT sales, and transfers.
* **Dedicated nodes** — private, high-availability gateways for production use cases.
* **Webhooks** — secure and signed event delivery to your backend.

***

### Why Builders Use Kepler

Developers choose Kepler when they need:

* **Speed and reliability** beyond public gateways.
* **Simplified integration** without running their own nodes.
* **Consistent data** indexed and normalized for analytics or monitoring.
* **Event-driven infrastructure** to react to on-chain activity instantly.
* **Scalability** without additional infra or DevOps overhead.

By using Kepler, you can focus entirely on your application logic while Kepler manages uptime, redundancy, and data pipelines underneath.

***

### How It Works

Kepler runs a distributed pool of observers and gateways that continuously sync blockchain data.\
Events are decoded, enriched, and indexed in real time, then exposed to builders.

Each project receives its own **API key** and isolated rate limits.\
Requests are authenticated via header (`Api-Key`) or URL query param (`Api-Key`) and served at minimum latency.

***

### Mainnet and Devnet Access

Kepler maintains separate environments:

* **Mainnet** — for production integrations.
* **Devnet** — for testing and development.

Both environments expose identical endpoints.

***

### Plans and Access

Kepler offers three plans:

* **Developer** — for individual builders testing or prototyping.
* **Business** — for projects in active production.
* **Custom / Enterprise** — for organizations needing dedicated nodes or SLAs.

All plans include private endpoints, access to Mainnet + Devnet, and full community support through the Project X channels.

***

### Support and Community

The Project X team maintains an active builder community.

For help and enterprise onboarding DM the team on [**Discord**](https://discord.com/invite/project-x-dao-1047509567858299000) or [**Telegram**](https://t.me/ProjectX_DAO).

***

### The Vision

KEPLER is part of a decentralized, community-owned infrastructure network.

Every plan contributes back to the Project X DAO, ensuring that the tools builders rely on are maintained by the very ecosystem they help grow.

Fast. Reliable. Community-powered.\
Welcome to Kepler.


# Get Started

Power your MultiversX app with Kepler — high-performance APIs and real-time event streams built for builders.

## Getting Started

Getting started with Kepler takes only a few minutes.\
You’ll authenticate using an API Key that identifies your project and gives access to all active services.

### 1️. Quick Start

**Visit:** [kepler.projectx.mx](https://kepler.projectx.mx)

Follow these steps to get your first live API key:

{% stepper %}
{% step %}
**Log in** with your preferred MultiversX wallet.
{% endstep %}

{% step %}
**Choose your plan** based on your app’s traffic and data needs.
{% endstep %}

{% step %}
**Create an API Key** — give it a name (e.g., *my-dapp-mainnet*).
{% endstep %}

{% step %}
**Plug it into your app.**

* Go to the **Services** tab in your **Dashboard** to copy the base URLs for Mainnet or Devnet.
  {% endstep %}
  {% endstepper %}

***

### 2️. Make Your First Request

Here’s a quick example using `curl`:

```bash
curl --request GET \
  --url "https://kepler-api.projectx.mx/mainnet/api/transactions?size=3" \
  --header "Api-Key: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d"
```

This returns the **3 latest transactions** from the mainnet API.

***

### 3️. Next Steps

* Explore your available services on the **Dashboard** (API, ElasticSearch, Event Notifier, Gateway, Herotag DB, Webhooks).
* For deeper integration examples, check the **Core Features** section in this documentation.
* Monitor your credit usage and active keys in **Kepler Dashboard → API Keys**.

### 4️. Best Practices

<mark style="color:$danger;">**Integrate securely**</mark>

* **Never expose your API key in public code or repositories.**
* Use environment variables or a secrets manager for production apps.

**Reference official MultiversX structures**\
For transaction, address, and token schema details, see the [MultiversX Docs](https://docs.multiversx.com/).


# Core Features

Kepler provides a unified API layer for MultiversX — fast REST endpoints, real-time event streams, and webhooks — all backed by high-availability infrastructure.

#### 🔌 Private MultiversX APIs

Access your own private, high-speed API endpoints with no setup required.\
Stop worrying about rate limits or shared infrastructure.

What you get:

* Instant access to mainnet & devnet endpoints
* Low-latency, high-reliability performance
* Elastic scaling based on your app's usage

***

#### 📡 Real-Time On-Chain Event Monitoring

Monitor blockchain events as they happen. Whether you're building bots, games, dashboards, or alerting systems, we've got you covered!

What you get:

* Real-time tracking for smart contract events or addresses
* Custom filtering support
* Webhooks for seamless integrations *(Coming soon)*

***

#### 📁 Full Node + Elasticsearch Support

Use a full-history observer node with powerful querying via Elasticsearch.

What you get:

* Optimized access to historical blockchain data
* Enhanced indexing capabilities
* High uptime, low maintenance

***

#### 🎁 Free Trial

Get **1 month of full access for free.**\
**N**o hidden costs, no surprises. Feel the difference.\
We want real builders to succeed, even in a bear market.


# Infrastructure & Data

Coming soon..


# Developer Tools & SDKs


# Webhooks

Webhooks allow your system to receive real-time notifications from Kepler when specific events occur on the blockchain. This page details how to configure filters, process payloads, and verify the sec

### Event Filtering Options

When configuring a webhook, you can filter which events trigger a notification. You can use a combination of three criteria.

> ℹ️ **Note** If multiple filters are set, **all conditions must match (AND logic)** for the webhook to be triggered. If you set both an `address` and an `identifier`, only events matching *both* will trigger the webhook.

| Filter       | Description                                                                 | Example            |
| ------------ | --------------------------------------------------------------------------- | ------------------ |
| `address`    | The smart contract address that emitted the event. Must be an exact match.  | `erd1qqqq...`      |
| `identifier` | The event identifier/name. Must be an exact match.                          | `transfer`, `swap` |
| `topic`      | The first topic of the event (decoded from base64). Must be an exact match. | `claimed`          |

#### Configuration Rules

* **Requirement:** At least one filter (`address`, `identifier`, or `topic`) is mandatory.
* **Decoding:** Topics in MultiversX events are base64-encoded. The filter matches against the **decoded** value of the first topic.

#### Common Examples

| Configuration                                                                     | Result                                                       |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `address: erd1qqq...abc`                                                          | Receives **all** events from this specific address.          |
| `identifier: transfer`                                                            | Receives **all** `transfer` events from **any** address.     |
| <p><code>address: erd1qqq...abc</code><br><code>identifier: distribute</code></p> | Receives only `distribute` events from the specific address. |

***

### Webhook Delivery

When an event matches your filters, Kepler sends an HTTP `POST` request to your configured URL.

#### The Payload

The request body is a JSON object containing the event details and a timestamp.

```json
{
  "event": {
    "address": "erd1qqqqqqqqqqqqqpgqjhn0rrta3hceyguqlmkqgklxc0eh0r5rl3tsv6a9k0",
    "identifier": "distribute",
    "topics": [
      "ZGlzdHJpYnV0ZWQ=",
      "AAAAAAAAAAAFAPWuOkANricr0lRon9WkT4jj8pSeV4c=",
      "Q09MUy05ZDkxYjc=",
      "iscjBInoAAA="
    ],
    "data": "",
    "txHash": "2151f16aa3a491d5979d16d6e6ad128da9851d3d65bf63cf226d8083432a201b"
  },
  "timestamp": 1706540400,
  "webhook": "550e8400-e29b-41d4-a716-446655440000"
}
```

#### Markdown

| **Field**          | **Type**   | **Description**                                    |
| ------------------ | ---------- | -------------------------------------------------- |
| `event.address`    | `string`   | The smart contract address that emitted the event. |
| `event.identifier` | `string`   | The event identifier/name.                         |
| `event.topics`     | `string[]` | Array of base64-encoded topics.                    |
| `event.data`       | `string`   | Base64-encoded event data (may be empty).          |
| `event.txHash`     | `string`   | The transaction hash that triggered the event.     |
| `timestamp`        | `number`   | Unix timestamp (seconds) of webhook dispatch.      |
| `webhook`          | `string`   | Your webhook's unique identifier.                  |

#### Headers

| **Header**     | **Value**                   | **Description**                                          |
| -------------- | --------------------------- | -------------------------------------------------------- |
| `Content-Type` | `application/json`          | The media type of the body.                              |
| `X-Signature`  | Hex-string                  | Important: The cryptographic signature for verification. |
| `User-Agent`   | `ProjectX-Kepler/{version}` | Identifies the sender.                                   |

***

### Delivery Lifecycle

#### Expected Response

Your endpoint must return a status code in the 2xx range (e.g., `200 OK`) to acknowledge receipt. The response body is ignored.

> ⚠️ Warning
>
> Your server must respond within 10 seconds. If the request times out, it is treated as a failure and will be retried.

#### Retry Mechanism

If delivery fails (network error, timeout, or non-2xx status), Kepler retries automatically.

* Max Retries: 3 attempts (4 total requests).
* Strategy: Progressive backoff (5s, 10s, 15s).

Example Timeline:

1. `T+0s`: Initial attempt (Fails)
2. `T+5s`: Retry 1 (Fails)
3. `T+15s`: Retry 2 (Fails)
4. `T+30s`: Final Retry

***

### Security & Verification

To ensure requests originate from Kepler and haven't been tampered with, you must verify the `X-Signature` header.

#### Verification Logic

1. Serialize: Read the raw request body as a string.
2. Verify: Use the MultiversX message signing algorithm (Ed25519) to verify the body against the signature.
3. Public Key: Use the official Kepler signing address below.

Kepler Public Signing Address:

Plaintext

```
erd1c0mj9ctdg0xv872j4v3rs8ygcz2tdx7mtxffawj9trxfkvwg0njq7uzp58
```

#### Code Examples

**TypeScript / JavaScript**

```typescript
import { Address, Message, MessageComputer } from '@multiversx/sdk-core';

const SIGNING_ADDRESS = 'erd1c0mj9ctdg0xv872j4v3rs8ygcz2tdx7mtxffawj9trxfkvwg0njq7uzp58';

function verifyWebhookSignature(payload: string, signature: string): boolean {
  const messageComputer = new MessageComputer();
  
  const message = new Message({
    data: new Uint8Array(Buffer.from(payload)),
    address: Address.fromBech32(SIGNING_ADDRESS),
    signature: Buffer.from(signature, 'hex'),
  });

  return messageComputer.verifyMessage(message);
}

// Express.js usage
app.post('/webhook', express.text({ type: 'application/json' }), (req, res) => {
  const payload = req.body; // Ensure this is the RAW string body
  const signature = req.headers['x-signature'] as string;

  if (!verifyWebhookSignature(payload, signature)) {
    return res.status(401).send('Invalid signature');
  }

  res.status(200).send('OK');
});
```

**Python**

```python
from multiversx_sdk import Address, MessageComputer, Message

SIGNING_ADDRESS = 'erd1c0mj9ctdg0xv872j4v3rs8ygcz2tdx7mtxffawj9trxfkvwg0njq7uzp58'

def verify_webhook_signature(payload: str, signature: str) -> bool:
    message_computer = MessageComputer()
    
    message = Message(
        data=payload.encode('utf-8'),
        address=Address.new_from_bech32(SIGNING_ADDRESS),
        signature=bytes.fromhex(signature)
    )
    
    return message_computer.verify_message(message)
```

***

### Best Practices

* Idempotency: In rare network conditions, you may receive the same webhook twice. Always use the `event.txHash` as a unique key to prevent processing the same event multiple times.
* Async Processing: Return a `200 OK` immediately, then process the data asynchronously (e.g., send it to a queue). This prevents timeouts.
* Security: Always use HTTPS. Validate the `timestamp` field (e.g., ensure it is within the last 5 minutes) to prevent replay attacks.

***

## Quick Start: Receive Your First Webhook

Follow this guide to set up a local webhook receiver, expose it to the internet, and trigger a test event from Kepler.

***

### Prerequisites

* A Kepler account.
* Node.js installed on your machine.
* A tool to tunnel local ports to the internet (e.g., [ngrok](https://ngrok.com/)).

***

### Step 1: Create a Simple Receiver

Create a file named `server.js` and paste the following code. This sets up a basic Express server that logs incoming webhooks to your console.

```javascript
const express = require('express');
const app = express();
const port = 3000;

// Middleware to parse JSON bodies
app.use(express.json());

app.post('/webhook', (req, res) => {
  // 1. Log the incoming event
  console.log('🔔 Webhook Received!');
  console.log('Event:', req.body.event.identifier);
  console.log('TxHash:', req.body.event.txHash);

  // 2. Respond quickly with 200 OK
  res.status(200).send('Received');
});

app.listen(port, () => {
  console.log(`🚀 Receiver running on http://localhost:${port}`);
});
```

Install dependencies and start the server:

Bash

```
npm install express
node server.js
```

***

### Step 2: Expose Your Server

Since Kepler cannot reach your `localhost` directly, use a tunneling service to create a public URL.

Bash

```bash
# If using ngrok
ngrok http 3000
```

Copy the HTTPS URL generated by ngrok (e.g., `https://a1b2-c3d4.ngrok-free.app`). Your full webhook URL will be: `https://a1b2-c3d4.ngrok-free.app/webhook`

***

### Step 3: Configure Kepler

1. Log in to your Kepler dashboard and navigate to Webhooks.
2. Click Create Webhook.
3. URL: Paste your ngrok URL (ensure it ends with `/webhook`).
4. Filters: Set up a filter to reduce noise. For testing, you might want to track a common token transfer.
   * Identifier: `transfer`
   * *(Leave Address and Topic empty to catch all transfers for now)*

> ℹ️ Tip Start with broad filters (like just an `identifier`) to ensure your connection works, then narrow them down with specific `address` or `topic` filters later.

***

### Step 4: Test and Verify

1. Trigger an action on the blockchain (or wait for a live event that matches your filter).
2. Check your terminal running `server.js`. You should see:

Plaintext

```
🔔 Webhook Received!
Event: transfer
TxHash: 2151f16aa3a491d5979d16d6e6ad128da9851d3d65bf63cf226d8083432a201b
```

3. Check the Kepler dashboard. The webhook status should show 200 OK.

***

### What's Next?

Now that you are receiving events:

* Secure your endpoint: Implement Signature Verification.
* Handle logic: Parse the `topics` array to decode transfer amounts and recipients.
* Go to production: Deploy your Node.js script to a cloud provider (AWS, Heroku, DigitalOcean).


# Security & Access

Coming soon..


# Pricing, Rate Limits & Credits

Coming soon..


# Support & Community

Builders move faster together. Join the Project X community to get help, share feedback, and stay up to date with new releases.

### Get Help Fast

Kepler is actively maintained by **Project X** and its core contributors.\
You can reach the team and other builders through our community channels:

* [Discord](https://discord.projectx.mx/)
* [Telegram](https://t.me/ProjectX_DAO)

***

### Collaborate & Contribute

Kepler is part of a broader open-infrastructure initiative under **Project X DAO**.\
You can contribute by:

* Reporting bugs or suggesting features in **#feedback** on Discord.
* Submitting improvements.
* Proposing new custom APIs or data sources through the DAO governance.

***

### Stay in the Loop

* **Announcements:** major launches, integrations, and ecosystem partnerships.
* **Builder Spotlights:** case studies from teams using Kepler in production.
* **DAO Votes:** upcoming proposals that shape Kepler’s roadmap.

Follow updates on:

* [Twitter](https://x.com/ProjectX_DAO)
* [**Discord**](https://discord.com/invite/project-x-dao-1047509567858299000)
* [**Telegram**](https://t.me/ProjectX_DAO)

***

### Our Philosophy

Kepler exists to empower builders — not gatekeep access.\
All of our infrastructure decisions are guided by three principles:

1. **Transparency** — every upgrade and incident is public.
2. **Fairness** — equal access to performant infrastructure at the lowest prices on the market.
3. **Community-Driven Growth** — every user can help shape what Kepler becomes.

We're here for you 24/7.


# Roadmap

Coming soon


# EDGE

The fastest Telegram bot on MultiversX

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FRTcWpwbclBYKFc02rt1e%2FEDGE.png?alt=media&amp;token=093a2e0e-2ccc-4197-b799-9f28463e4625" alt=""><figcaption></figcaption></figure>

EDGE is an all-in-one Telegram trading bot that makes trading any token (ESDT) on [MultiversX blockchain](https://multiversx.com/) fun for everyone.

Lightning-fast, user-friendly, and designed for seamless onboarding of new users.

With its clean design and top-notch security, EDGE is the most advanced bot offering features suitable for both beginners and experts.


# User guide

Seamless experience for Telegram

1. To use EDGE you need an invite code.
2. Use `/start` to create your account.
3. EDGE automatically creates a custodial wallet for you to trade with.

EDGE is free to use for all users.

For additional questions and support, [join our Telegram](https://t.me/Project_xdao).


# ToS

EDGE's Terms of Service

**1. Introduction**

Welcome to EDGE, a Telegram trading bot operated by Project X DAO. By using our bot, you agree to these Terms of Service. If you do not agree with these ToS, please do not use the bot.

**2. Eligibility**

You must be at least 18 years old to use our bot. By using the bot, you represent and warrant that you are of legal age and comply with all local laws.

**3. Account Registration**

To use our bot, you must complete the registration process by providing your Telegram information. You are responsible for maintaining the confidentiality of your account information.

**4. Use of the Bot**

You may use the bot only for lawful purposes and in accordance with these ToS. Prohibited uses include, but are not limited to, engaging in illegal activities, spamming, and attempting to gain unauthorized access to the bot.\
\
You acknowledge and agree that the use of this trading bot is fully automated and operates on a decentralized blockchain platform. As such, we do not manually operate or control any aspect of the transactions conducted through the bot.

We are not responsible for any legal issues or obligations you may encounter, including but not limited to taxes owed to the state or any other regulatory requirements. It is your sole responsibility to ensure compliance with all applicable laws and regulations, including the payment of taxes on any gains or transactions made using the bot.

This trading bot is provided as a service, and we disclaim any responsibility for your individual legal and tax responsibilities.

**5. Transactions**

EDGE accepts any token available on the MultiversX Blockchain. Transaction fees may apply as detailed in the HELP section of the bot. There are no refunds and we are not responsible for any trades you do using EDGE.

**7. User Responsibilities**

You are responsible for the security of your account and must comply with all applicable laws. Report any unauthorized use of your account immediately.

**8. Limitation of Liability**

The bot is provided "as is" without warranties of any kind. We are not liable for any damages arising from the use of the bot.

**9. Intellectual Property**

We own all intellectual property rights to the bot. Users are granted a limited, non-exclusive license to use the bot.

**10. Privacy Policy**

We collect and use user data. We implement security measures to protect your data.

**11. Termination**

You may terminate your account at any time by blocking the bot. We reserve the right to terminate accounts for violations of these ToS.

**12. Amendments**

We may amend these ToS at any time. Users will be notified of changes via notifications.

**13. Contact Information**

For support or questions regarding these ToS, please contact us at using [our socials](https://linktr.ee/projectx_dao).


# Saturn

Powering Web3 Communities with maximum efficiency

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FXzidqEunLOG2ZDGCl68w%2FSaturn%20(8).png?alt=media&amp;token=13c9c5f3-f80e-4284-aacb-ed5e5a27eab3" alt=""><figcaption></figcaption></figure>

Saturn is an all-in-one comprehensive solution to help communities handle tasks with ease and achieve high levels of organization and productivity.

It offers a wide range of features that provide tremendous support, making it essential for any community looking to streamline its processes and boost its efficiency.

## Discord Features

1. Whitelist submission
2. Wallet verification
3. NFT-based Role administration (based on nr. of NFTs & attributes)
4. ESDT-based Role administration
5. Listings tracker
6. Sales tracker
7. Token prices
8. Multi-wallets (soon)

## Telegram Features

1. Wallet verification
2. ESDT trackers
3. ESDT gating
4. NFT gating
5. NFT trackers (soon)

## Twitter Features (soon)


# Discord Set-up

Easy set-up for Discord administrators

1. [**Invite Saturn**](https://discord.com/api/oauth2/authorize?client_id=1080215198608134235\&permissions=268479488\&scope=bot%20applications.commands) to your server from -> <https://discord.projectx.mx/>
2. Make sure Saturn is <mark style="color:blue;">**above**</mark> all roles it manages & can view the channels
3. Set it up using the bot commands

> Please make sure your server has a **Community Updates** channel set up & open for Saturn (view/write) to receive the latest updates and notifications.

#### Set-up

`/collection add` - Add a collection to be tracked. Up to an infinite number of collections.

`/collection list` - Show a list of all tracked collection in your server.

`/collection delete` - Delete a tracked collection from your server.

**Verification**

`/verify channel` - Set the verification channel.

`/rule add_collection` - Add a rule for a tracked collection based on a threshold.\
The threshold = the amount of NFTs needed to obtain that role.

`/rule add_attribute` - Add a rule for a tracked collection based on NFT attributes.\
This command is **case sensitive**. You can take the correct traits/attributes from [multiversx.explorer ](https://explorer.multiversx.com/)/ marketplaces.

`/rule list` - List all verification rules.

`/rule delete` - Delete a verification rule from the list.

#### Verification for staking Smart contracts

`/source add xoxno [pool] [ticker]` - Define the collection's <mark style="color:red;">staking</mark> pool from [XOXNO](https://xoxno.com/)\
Pool - staking pool number\
Ticker - collection ticker

`/source add custom [SCaddress] [ticker]` - Define the collection's <mark style="color:red;">staking</mark> smart contract\
SCaddress - staking smart contract address\
Ticker - collection ticker\
*<mark style="color:blue;">The SC should let Saturn look into it. Open a support ticket if you need help with that!</mark>*

`/source list` - List all the active SC sources.

`/source delete` - Delete an active SC source.

#### Wallet collection (for whitelist / airdrops / etc)

`/wl start` - Start a whitelist submission. (ERD address is required)\
The message title and the message body can be customized in the optional arguments.

`/wl stop` - Stop a whitelist submission.\
When stopped, the bot will delete its message and sends a file with all the collected addresses to the user via DM.

**Sale Tracker**

`/sales add` - Add a collection to track sales on all marketplaces.

`/sale list` - List all active sale trackers.

`/sale delete` - Delete an active sale tracker.

#### Listing Tracker

`/listing add` - Add a collection to track listings on all marketplaces.

`/listing list` - List all active listing trackers.

`/listing delete` - Delete an active listing tracker.


# Telegram Set-up

Easy set-up for Telegram administrators

1. [**Invite Saturn**](https://t.me/Saturn_ProjectX_bot) to your server.
2. Set-up the bot using the menu `/ProjectX`.

For any questions feel free to contact us in Discord or Telegram.


# User guide

Seamless experience for Discord

**Wallet verification**

This is a **one time process** for any user. Once you have signed up, you will automatically be verified on all Saturn-enabled servers based on their configurations.

1. Click the "Verify" button
2. Connect with your wallet on the dApp. No need to sign any transaction
3. That's it

**Whitelist submission**

1. Click "Submit"
2. Enter your ERD address
3. Click "Submit"

Check your submitted wallet by clicking "Check Wallet"


# Subscription

Saturn comes packed with all the features needed for you and your community on all main platforms at just **50$ per month**. To enable Saturn, simply pay the activation fee to [The Saturn Wallet](https://explorer.multiversx.com/accounts/erd1aq56njkp5ucw89phtgcsf3lf8v6tvwzr6eph8sh9ukjw4d8g4gksfvd9j0) in USDC/EGLD.

You can always contact us on [Discord](https://discord.projectx.mx/) for your custom needs.

*Special Offer for Memes!*\
Get full access to Saturn on Telegram and power up your meme coin’s success for just a **one-time** fee of $50!


# Get Saturn

[Invite Saturn to your Discord server](https://discord.com/api/oauth2/authorize?client_id=1080215198608134235\&permissions=268479488\&scope=applications.commands%20bot) or [Join our Discord](https://discord.projectx.mx/) and invite it from there.

[Invite Saturn to your Telegram group](https://t.me/Saturn_ProjectX_bot) or [Join our Telegram](https://t.me/+-WcwqSVXFEcwNzA8) and invite it from there.


# ToS

Saturn's Terms of service

**1. Acceptance of Terms**

By using Saturn, you agree to comply with these Terms of Service. If you do not agree with any part of these terms, you may not use the bot.

**2. Use of the Bot**

* Saturn is provided "as is" and the bot owner holds no responsibility for its misuse or any damages caused by it.
* Users must adhere to Discord's Terms of Service and Community Guidelines while using the bot.
* The bot owner reserves the right to modify or discontinue the bot's services at any time without prior notice.

**3. User Conduct**

* Users are prohibited from engaging in any unlawful or prohibited activities while using the bot.
* Harassment, hate speech, spamming, or any form of abusive behavior towards other users will not be tolerated.

**4. Data and Privacy**

* The bot may collect and store user data necessary for its functionality. This data will be handled in accordance with the bot owner's Privacy Policy.
* [Link to Privacy Policy](/products/saturn/pp)

**5. Limitation of Liability**

* The bot owner will not be liable for any direct, indirect, incidental, or consequential damages arising from the use or inability to use the bot.

**6. Changes to Terms of Service**

* The bot owner reserves the right to update or modify these terms at any time without prior notice. It is the user's responsibility to review these terms periodically.

**7. Contact Information**

* For questions or concerns regarding these terms, use these links <https://linktr.ee/projectx_dao>.

**8. Governing Law**

* These terms shall be governed and construed in accordance with the laws of Romania, without regard to its conflict of law provisions.


# PP

Saturn's Privacy Policy

**1. Information Collection and Use**

* Saturn may collect certain information necessary for its functionality, such as user IDs, server information, wallet addresses, message content, or other data required for the bot's services.
* This information is used solely to provide and improve the bot's services and is not shared with third parties except as described in this policy.

**2. Data Storage and Security**

* Saturn stores collected data securely and takes reasonable measures to protect it from unauthorized access, alteration, disclosure, or destruction.
* Users acknowledge that while the bot takes reasonable precautions, no method of transmission over the internet or electronic storage is 100% secure.

**3. Use of Collected Information**

* Collected information is used to deliver, maintain, and improve the bot's functionalities, troubleshoot issues, and provide user support when necessary.

**4. Third-Party Services**

* Saturn doesn't use third-party services or APIs. All services and APIs are built in-house.

**5. Cookies and Tracking**

* Saturn does not use cookies or tracking mechanisms to collect personal information from users.

**6. User Rights**

* Users have the right to access, correct, update, or delete their personal information stored by the bot.

**7. Compliance with Discord's Policies**

* Saturn complies with Discord's Terms of Service, including its privacy and data protection policies, when handling user data.

**8. Changes to the Privacy Policy**

* The bot owner reserves the right to update or modify this Privacy Policy at any time. Users will be notified of any changes through the bot or other means.

**9. Contact Information**

* For inquiries or concerns regarding this Privacy Policy, contact us using these links <https://linktr.ee/projectx_dao>.

**10. Governing Law**

* This Privacy Policy shall be governed and construed in accordance with the laws of Romania.


# dApp

Coming soon... This will showcase the true power of Saturn and why it is the perfect solution for all communities.


# Atlas

MultiversX Wallet Tracker

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2Fxjea79OTLo0actUkUKFv%2Fatlast%20pfp.png?alt=media&amp;token=de9876db-e847-4588-aeba-bd40b6e4d124" alt=""><figcaption></figcaption></figure>

### Overview

ATLAS is a **free wallet tracker** that provides real-time notifications for any MultiversX wallet. Get it here -> [@Atlas\_ProjectX\_bot](https://t.me/Atlas_ProjectX_bot)

### Features

* **Real-Time Notifications:** Stay updated with instant alerts on wallet activities.
* **Transaction Tracking:** Get notified about any incoming or outgoing transactions.
* **Staking Information:** Receive updates on staking-related activities.

### How It Works

1. Add any MultiversX Wallet to ATLAS.
2. Choose which activities you want to be notified about.
3. Get real-time alerts as events occur with 0 limits.

### Community-Driven Enhancements

Project X will continue improving Atlas by integrating additional features and enhancements based on DAO members feedback.

Stay connected and experience seamless tracking with ATLAS!


# In-wallet staking

Made possible on MultiversX

In-wallet staking is the most secure, simple, and hassle-free token mining experience on MultiversX.

Features\
\- Live mining data\
\- Transaction-less claim (no signature needed by the user)\
\- Free claim (no gas paid by users)\
\- Maximum security for users and projects\
\- 2 clicks to get your tokens

The token is linked to the NFT. This means that the NFT can be traded with the ESDT linked to it. The tokens mined by the NFT can always be claimed by the owner of the NFT on [The dApp](http://dapp.projectx.mx/explorer).


# Rug Royalties

Operated by Divergent Club, a Sub-DAO of Project X

Through Rug Royalties, users have the option to "Rug" (sell) their NFTs in exchange for a return of 0.001 $EGLD.

In countries where capital gains tax is applied to the sale of crypto assets, users can potentially claim "tax losses." Tax losses occur when the sale of an asset results in a financial loss compared to its original purchase price. Typically, tax losses cannot be claimed if an asset is stolen, a project rugs, or if the asset is burned (destroyed).

By selling the asset through Rug Royalties, users can now claim tax losses on their tax self-assessment. Additionally, Rug Royalties conducts a monthly raffle of 2x Divergent Club NFTs, with users earning a raffle ticket for each NFT they rug through the Dapp.

Learn more about it here -> <https://rug.divergentclub.xyz/>


# The Gold Planet

Multi-sig protocol

A Fraud-Safe Protocol that secures the DAO, subDAOs, and project funds using Smart Contracts & multi-sign wallets. All interactions run on a 2 of 3 model based on a vote system.

The Bank is made possible using [xSafe](https://xsafe.io/) & custom scripts.

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FjEPyEE8hivmoln2LA0En%2Fdao_bank_no_bg%20(3).png?alt=media&amp;token=d1587202-20ab-4c25-bfd8-3ea2719e5e39" alt=""><figcaption></figcaption></figure>

2 of 3 model = 2 parts — Creators | 1 part — Dev Team (mediator)


# Smart Contracts

**xDAO**\
`erd1qqqqqqqqqqqqqpgqy07sp5s4gdvnds55j6jpgvrf3e3cyh6kmvls57w48r`

**Divergent Club DAO**\
`erd1qqqqqqqqqqqqqpgqdq9f845f0p4y0nzxucc4svd7kykx08gjrkks3t7ysw`

**xDoctors DAO**\
`erd1qqqqqqqqqqqqqpgq204v88r0u3zxugv0k3wysr0lgqg5h72srkksmpu89z`

**HorrorX DAO**\
`erd1qqqqqqqqqqqqqpgq5eslysddj4qpszz2ypcpczhpew9tn35trkksgvl96q`

**ToXic DAO**\
`erd1qqqqqqqqqqqqqpgqxt08qlhjj5p42elw3jszyklzvm3ee4cwrkks2kxdau`

**Xcity DAO**\
`erd1qqqqqqqqqqqqqpgqpg0nn7g6utvwn0ynrwmwd63hmxyhtky2rkksmuq7lv`


# xID

The profile app

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2F8T7zKh99Tbcbzof409xJ%2Fid_no_bg.png?alt=media&amp;token=820b9bb7-0157-4410-b50c-fa2a75f89f03" alt=""><figcaption></figcaption></figure>

Coming soon..


# The Spaceport

Raid 2 Earn

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FmncQbDNj3jV7hk2ir85y%2Fspaceport_no_bg.PNG?alt=media&amp;token=defe7a09-0945-4b2a-8e43-1ad8952b4535" alt=""><figcaption></figcaption></figure>

Coming soon..


# The Unknown

All products in development that have not been presented yet

<figure><img src="https://634426457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNw654mamvSAXnTIWr8QP%2Fuploads%2FNfM6Hl1sSLBPyTv1BvMU%2FMistery_no_bg.png?alt=media&amp;token=0593f189-4a15-4fdf-8381-33f17379cd52" alt=""><figcaption></figcaption></figure>

The sky is not the limit.


