# Overview

The Guru Network is a revolutionary Multi-Chain AI Compute Layer 3 platform that seamlessly integrates blockchain technology, artificial intelligence, and business process automation to enhance real-time solutions for decentralized finance and data-driven decision-making.

### Key Features

| Feature             | Description                                                                       |
| ------------------- | --------------------------------------------------------------------------------- |
| AI Integration      | Comprehensive AI-driven orchestration with community-driven AI Processors catalog |
| Web3 Automation     | Extensive catalog of community-driven Web3 automations                            |
| Cross-Chain Support | Compatible with 18 blockchain networks                                            |
| Process Standards   | Implements BPMN for reliable process automation                                   |
| Open Source         | Platform and components open-sourced from day zero                                |

### **Strategic Partnerships:**

Chainlink's Cross-Chain Interoperability Protocol [powering](/guru-network/guru-network-chainlink-integration/guru-season-2-pass-and-chainlink-functions-case) the future of the Guru Network.

Guru Network and Subsquid [integration](/guru-network/subsquid-and-guru-network-data-partnership) helps to automate complex business processes with reliable, real-time multi-chain data.

Guru Network [Partners with SKALE Network](https://blog.gurunetwork.ai/guru-connects-the-dots-and-maintains-interoperability/) to Enhance Decentralized Application Development.

Partnership with Equalizer brings benefits of the Ve(3,3) AMM model to our users - Liquidity Stability, Sustainable Rewards, Enhanced Governance Power, Multiple Revenue Streams - [instruction to start](https://blog.gurunetwork.ai/guru-networks-partnership-with-equalizer-unlocking-the-power-of-ve-3-3-amm/).

Guru Network [Partners with ICHI](https://blog.gurunetwork.ai/guru-network-partners-with-ichi-to-enhance-liquidity-management-on-base-blockchain/) to Enhance Liquidity Management on Base Blockchain

Guru Network and GraphLinq: A [Strategic Partnership to Elevate On-Chain Analytics](https://blog.gurunetwork.ai/guru-network-and-graphlinq-a-strategic-partnership/) and Automation

### Revenue Streams

**Infrastructure Services**&#x20;

The network generates revenue through orchestration fees, IaaS fees, and enterprise support services for businesses requiring professional assistance and customization.

**Tokenomics**&#x20;

The GURU token serves as the primary utility value storage, powering the network ecosystem and incentivizing participant activities through various reward mechanisms.

### Core Components

**Flow Orchestrator**

The network's execution core manages complex workflows requiring adaptive, context-aware decisions based on real-time data. It extends traditional blockchain applications through BPMN-standard process automation, ensuring reliability and familiarity for users and developers.

**Cross-Chain Infrastructure**

Operating across 18 blockchain networks, the platform provides comprehensive interoperability through CCIP integration, allowing applications and users to embed orchestrated AI agents into their routines while earning network participant rewards.

**Developer Framework**&#x20;

The Guru Framework and SDK offer a comprehensive toolkit that streamlines developer onboarding and facilitates the orchestration of individual agents by AI processor definitions.

### Ecosystem Participants

**Network Roles**

* Gurus: AI Processors and code contributors
* Compute Node Runners: Infrastructure providers
* Ecosystem Projects: Combining BBPA orchestrations
* Individual Agents: Non-custodial Web3 Processors
* Integrators: B2B adoption facilitators
* Retail Users: Web3 automation consumers

### Market Presence

Since its inception in 2021, the Guru Network has evolved from a DeFi trading terminal into a comprehensive orchestration platform. Key products include the Guru Block Explorer, Data Warehouse, and DeFi Trading Terminal, all operational and serving users across multiple blockchain networks.

Through its unique combination of AI-driven orchestration, comprehensive Web3 automation, and robust developer tools, the Guru Network addresses critical gaps in the current market while fostering a collaborative ecosystem for blockchain and AI innovation.


# Using Mainnet

### Network Details

| Parameter                 | Value                                                             |
| ------------------------- | ----------------------------------------------------------------- |
| Network Name              | Guru Network                                                      |
| RPC Endpoint              | <https://rpc.gurunetwork.ai/archive/260>                          |
| Chain ID                  | 260                                                               |
| Currency Symbol           | GURU                                                              |
| Native Block Explorer URL | [scan.gurunetwork.ai](https://scan.gurunetwork.ai)                |
| Blockscout Explorer:      | [`blockscout.gurunetwork.ai`](https://blockscout.gurunetwork.ai/) |

### Adding Guru Network to MetaMask

**Option 1: Automatic Addition**

* Visit Chainlist.org and search for Guru Network
* Click "Connect Wallet" button
* Approve the network addition in MetaMask

**Option 2: Manual Addition**

1. Open MetaMask
2. Click the network dropdown at the top
3. Select "**Add a custom network**"
4. Enter the network details listed above
5. Click "Save" to complete the addition

The Guru Network supports both mainnet and testnet environments, providing developers with flexibility for testing and deployment. The network operates across 18 blockchain networks through CCIP integration, enabling comprehensive cross-chain functionality.

### P.S. Testnet Information

| Parameter          | Value                                    |
| ------------------ | ---------------------------------------- |
| Network Name       | Guru Network Testnet                     |
| RPC URL            | <https://rpc.gurunetwork.ai/archive/261> |
| Chain ID           | 261                                      |
| Currency Symbol    | tGURU                                    |
| Block Explorer URL | <https://sepolia.gurunetwork.ai/>        |


# Wallet Configuration

To interact with Guru Network, you'll need to add **Guru Network** to your wallet. Below are step-by-step instructions for setting up these networks in MetaMask.

#### **1. Install MetaMask** <a href="#id-1.-install-metamask" id="id-1.-install-metamask"></a>

* **Browser Extension**: Download and install MetaMask from the [official website](https://metamask.io/).
* **Mobile App**: Available on [iOS](https://apps.apple.com/app/metamask/id1438144202) and Android.

**Add Guru Network**

1. Open MetaMask
2. Click the network dropdown at the top
3. Select "**Add a custom network**"
4. Enter the network details

| Parameter                 | Value                                                             |
| ------------------------- | ----------------------------------------------------------------- |
| Network Name              | Guru Network                                                      |
| RPC Endpoint              | <https://rpc.gurunetwork.ai/archive/260>                          |
| Chain ID                  | 260                                                               |
| Currency Symbol           | GURU                                                              |
| Native Block Explorer URL | [scan.gurunetwork.ai](https://scan.gurunetwork.ai)                |
| Blockscout Explorer:      | [`blockscout.gurunetwork.ai`](https://blockscout.gurunetwork.ai/) |

5. Click "Save" to complete the addition

#### &#x20; <a href="#id-2.-add-matchain-network-to-metamask" id="id-2.-add-matchain-network-to-metamask"></a>


# Using DApps

Guru Network ecosystem lines up decentralized applications (dApps) across various categories, providing users with numerous opportunities to engage with web3 via rewarded activities or trading.

#### **1. Categories of dApps on Guru Network**

* **AI dApps**: Engage with decentralized applications that leverage artificial intelligence to provide innovative solutions and services. Explore AI-focused dApps : SOON
* **Rewarded Participation dApps**: Participate in applications that allow you to earn rewards and assets through various activities. Discover [Guru ERA](https://t.me/guru_network_bot)
* **Trading dApps**: Enjoy interactive gaming experiences on the blockchain. Make informed decisions on [trading dApp for Miles Deutscher](https://t.me/milesdeutscher_bot?start)
* **Memecoin Launch dApps**: Engage in decentralized memecoin marketplaces for launching, buying and selling memecoins. Explore [Burning Meme dApp](https://t.me/burningmemebot)

#### **2. Accessing dApps on Telegram**

To interact with these dApps:

1. **Install Telegram**

For [Desktop](https://desktop.telegram.org/?setln=en), [iOS](https://apps.apple.com/us/app/telegram-messenger/id686449807) or [Android](https://telegram.org/android).

2. **Connect to Guru Network**: [Configure](https://docs.gurunetwork.ai/getting-started/wallet-configuration) your wallet to connect to Guru Network.
3. **Explore dApps**: Visit the dApps: [Burning Meme](https://t.me/burningmemebot), [Guru ERA](https://t.me/guru_network_bot), [Miles Deutscher App](https://t.me/milesdeutscher_bot?start).&#x20;

#### **3. Security Reminder**

Always verify the authenticity of dApps (use only official links) and exercise caution when interacting with them to ensure the safety of your assets.


# Technical Architecture of Guru Network

Guru Network leverages cutting-edge blockchain technology to create a scalable, secure, and interoperable ecosystem for decentralized applications and services.

### Core Components

#### OP Stack Integration

Guru Network utilizes the OP Stack, a standardized and open-source development stack for building and deploying optimistic rollup chains. This integration provides several key benefits:

* **Scalability**: By leveraging optimistic rollup technology, Guru Network can significantly improve transaction throughput and reduce costs.
* **Security**: The network inherits Ethereum's robust security guarantees, ensuring the safety of assets and transactions.
* **Interoperability**: Shared standards and protocols facilitate seamless interaction between Guru Network and other OP Stack-based chains.

#### Superchain Ecosystem

As part of the Superchain ecosystem, Guru Network benefits from:

* **Shared Security**: Enhanced protection through a network of interconnected L2 chains.
* **Communication Layer**: Efficient cross-chain communication and data transfer.
* **Developer Accessibility**: Simplified development process for applications targeting the entire Superchain.

#### Cross-Chain Compatibility

Guru Network is designed to support cross-chain communication and interoperability, facilitating:

* **Asset Exchange**: Seamless transfer of tokens and data between Guru Network and other blockchain ecosystems.
* **Ecosystem Integration**: Easy integration with various DeFi protocols, NFT platforms, and other blockchain-based applications.

### Developer Engagement

To foster a thriving developer community, Guru Network provides:

* **Open-Source Contributions**: Guidelines for contributing to the Guru Network codebase on GitHub.
* **Guru Builders Initiative**: Incentives for building on top of Guru Ecosystem.

By adopting this technical architecture, Guru Network aims to position itself as a robust, scalable, and developer-friendly blockchain platform, capable of supporting a wide range of decentralized applications and services.


# Ultimate Guide To Guru Network For Community Users

This guide explains the Guru Network ecosystem, including its purpose, user roles, features, and mechanics. It also offers resources like FAQs and tutorials to help users navigate the platform

## Rewards

#### How Does Guru Network Incentivization Work?

Guru Network incentivization revolves around rewarding meaningful participation within the ecosystem. By engaging in activities such as completing quests, using applications, and participating in governance, users can earn rewards like GURU tokens or Points. The rewards system is backed by the Ecosystem Chest, ensuring sustainable and dynamic allocation over time, with weekly updates and new quests to keep the community engaged.

Please read more details in the recent proposals:

* [Understanding the Incentivization Mechanisms of the Guru Network](https://gov.gurunetwork.ai/t/understanding-the-incentivization-mechanisms-of-the-guru-network/59)
* [Guru Ecosystem Incentivization & Airdrop Mechanism](https://gov.gurunetwork.ai/t/proposal-003-guru-ecosystem-incentivization-airdrop-mechanism/34/9)
* [Guru Network Economy Flywheel Launch](https://gov.gurunetwork.ai/t/proposal-004-guru-network-economy-flywheel-launch/71/11)
* [Guru Network Mainnet Launch Initiative](https://gov.gurunetwork.ai/t/proposal-002-guru-network-mainnet-launch-initiative/26/3)

#### Is there an Airdrop?

Guru Network does not conduct traditional airdrops. Instead, users receive initial sign-up rewards when they join the mainnet. These rewards are designed to kickstart participation and recognize contributions made during the testnet phase. Early adopters and NFT holders receive significantly higher rewards due to multipliers from their holdings.

#### How can I check if I'm eligible for the airdrop?

Every user that has any Guru Network NFT is eligible for initial sign-up rewards and ongoing quest rewards. Depending on your activity and the types of NFTs you hold, the reward may vary. Early adopters receive higher rewards for their contributions.

#### How to participate in the mainnet?

Users will soon be able to switch networks directly within the Guru Network app and other Guru ecosystem apps. This feature, currently under development, will enable seamless participation in mainnet activities. Stay tuned for updates on its availability.

<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_RnIljM0ScLkQmyvJv7TacLFwoSyJICWobOBjeicILXXUKnJ6xDA4k5yeBsWeMgpD5lG488B6jcvUB_YZs-OZHhYcCQnSKOL7AV3deNevx9BuKod4bdHkbwpT674Z7gJud58aoQ?key=apQGffLnV7wIx5aoHsWbiM4p" alt="" width="375"><figcaption></figcaption></figure>

#### How Initial Mainnet Sign Up Reward is Calculated?

\[NOTE: this is a current proposal, it might be adjusted based on the community and Core Contributors feedback] Users who possess any Season Pass, Themed collection (Spooky Guru) or Guru DAO NFT will be able to switch to mainnet in apps. Upon sign up, eligible users will be able to receive Mainnet Sign Up Reward (Initial Reward). The amount of reward is depended on the following factors:

* Type of NFT possessed
* Governance activity
* Accumulated Balance in apps on testnet (e.g. Burns in Burning Meme, tGuru in Guru Network app, etc)
* App specific rewards

Sign Up Reward is calculated by the following formula:

Sign Up Reward = Base Sign Up Reward \* Pass Multiplicator + Governance Participation Reward + Accumulated Testnet points across apps \* Conversion Rate + App Specific Rewards

Where,

* Base Sign Up Reward - fixed amount of 250 $GURU for claim that is available to all Guru Network NFT collection holders.\ <br>
* Pass Multiplicator - Each type of Guru NFT provides a multiplicator that increases the amount of the reward. Season Passes 1 and 2 have multiplicator 2, Themed collections and Guru DAO NFT have multiplicator 1. If users have more than one type of NFT in their wallet, multiplicators are combined. The number of each type of NFT does not increase the multiplicator. Example: user has 1 Season Pass #1, 2 Season Pass #2 and 1 Guru DAO NFT. Total multiplicator is: 2 for Season Pass #1 + 2 for Season Pass #2 and + 1 for Guru DAO NFT, total is 5. Maximum multiplicator is 6 (2 + 2 from Season Passes collections + 1 from Themed Collection and + 1 Guru NFT DAO) if a user has at least 1 NFT from all available Guru NFT collections.\ <br>
* Governance Participation Reward - Users that are participated in Guru Network Snapshot voting, get additional reward 200 $GURU\ <br>
* Accumulated Testnet points across apps \* Conversion Rate - Points that were accumulated during testnet (tGURU, Burns, etc) are combined and converted into $GURU based on TVL ratio between mainnet and testnet conversion rate. We are still working on calculating the exact economics behind it.\ <br>
* App Specific Rewards - applications within the ecosystem may provide additional rewards based on the app-specific criteria.\ <br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdEDjza7J9YRe9Jn1178bJSHEIldP50Gp5muUfBsx8bA3ybHaEUI7ST5uDYhxjLUv7W_8EhtpKDzrcEA_y56CzWVOuAgdedxKkKfjl_3KiqWv-cO1wS_r7uVjwHFHUyscQHIkVe?key=apQGffLnV7wIx5aoHsWbiM4p" alt=""><figcaption></figcaption></figure>

<br>

* Core Contributors may adjust the sign Up bonus calculation formula.
* Sign Up Reward will be transferred to the user’s operational wallet. Tokens in this wallet will be available across all applications within the Guru Ecosystem.
* Users can redeem a Sign Up Reward by one wallet per Telegram account.
* The rewards will be allocated from the Ecosystem Chest, which is filled up from the Season 1-5 pool (Airdrop Community pool).
* * According to tokenomics, tokens have linear vesting over 1.5 years. Each period a part of the pool will be unlocked and transferred to the Ecosystem Chest to be used for community incentivization.

#### What Type of Rewards Are There?

Guru Network offers two main types of rewards:

* GURU Tokens: The native currency of the ecosystem, used for staking, governance, and accessing premium features
* Points: Earned through PointsNet (testnet) activities, these can be converted to GURU under specific conditions.

#### What Are Rewards?

Rewards vary depending on the activities and quests completed:

* GURU Tokens: Main rewards type. Distributed for mainnet quests, governance participation, and ecosystem engagement.
* Points: Issued for testnet activities and experimentation. Points provide a low-risk way to familiarize yourself with the Guru Network.
* App-Specific Rewards: Some apps may offer unique incentives tied to their usage, like NFT minting bonuses.

#### Where Do Tokens for the Rewards Come From?

The rewards are sourced from the Ecosystem Chest, an on-chain treasury funded by 20% of the total GURU token supply. Tokens are gradually unlocked over 1.5 years to ensure consistent incentivization and ecosystem sustainability.

#### How Often Do New Quests and Rewards Allocations Appear?

New quests and reward allocations are introduced weekly, coinciding with the weekly reward cycles (epochs). This ensures a steady flow of engagement opportunities and dynamic incentivization.

#### I’m an Early Adopter, Participated in Governance—What Will I Get?

Early adopters who participated in governance will receive extra initial Mainnet sign up rewards:

* Reward Multipliers: Holding Season Pass NFTs (e.g., Season Pass 1 or 2) grants multipliers of up to 2x on rewards.
* Governance Participation Bonus: Users who participated in governance votes receive an additional reward of 200 GURU tokens.
* Recognition of Testnet Contributions: Points accumulated during testnet activities will be converted to GURU tokens based on TVL linked conversion rates.

<br>

Also early adopters will get higher rewards for completing ongoing quests and activities within ecosystem apps.

By combining these factors, early adopters can expect higher initial rewards and long-term&#x20;

benefits within the ecosystem.

#### How Can I Use My Rewards?

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXexZHW75N-rHOjEKd9niYSYkR5FjZgS2GKEmHNJY2jrB7bSoDid4rImsGpsqXtl1ARflfT_o7plYV_6fTm6QCL6X3Ve-VsoduPgi69hIjRHE1mJhdge_1UmF84NFE6m-5IN468Y?key=apQGffLnV7wIx5aoHsWbiM4p" alt=""><figcaption></figcaption></figure>

Rewards earned in the Guru Network ecosystem serve as a versatile tool for enhancing user engagement and unlocking ecosystem features. Here’s how you can utilize your GURU tokens and other rewards:

Staking

* Lock your GURU tokens in the staking mechanism to earn additional rewards over time.
* Staking contributes to network sustainability while offering passive income for participants.

Minting NFTs

* Use your GURU tokens to mint unique NFTs, such as Guru DAO NFTs, which provide governance rights and reward multipliers.
* NFTs can also unlock premium features across ecosystem apps.

**Accessing Premium Features**

* Guru-powered applications will offer advanced functionalities, such as AI-driven insights or exclusive trading tools, accessible with GURU tokens. Currently you can use rewards for meme voting through Burning Meme app. More features (such launching memecoins) and apps are under development, so the list is going to be expanded soon.&#x20;
* Premium features enhance user experience and provide additional value within the network.

#### How to Boost Rewards?

You can increase your rewards by:

* Owning multiple types of NFTs (Season Passes, Evergreen NFTs).
* Participating actively in governance.
* Completing weekly quests

#### Will there be a Season 3?

Yes, Season 3 is planned and will include new features and enhanced rewards. Stay tuned for official announcements.

####

## Guru Network NFTs

#### Why Do I Need Guru DAO NFT or Season Pass NFTs?

Here's a breakdown of why you need them:

* Grants eligibility to participate in weekly distributions from the Seasons Chest. &#x20;
* Provides voting power in the DAO, allowing you to participate in governance and shape the future of the Guru Network.
* Provides access to premium features within ecosystem apps. Each app may have different features, but owning the NFT grants the complete experience, unlocking access to the most of the apps can offer.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc89ZFhrQP7KWSxxUevuveMtBOhZBDboXSHEXE_PbgPTFYID46LerlvyBuMyvAuN4dG3qeUSe7gaJknK5yn66tslp78YO5no0r0wvX75tS676kPo8UJ1NXheY-qWIBCAlVQkaAY6g?key=apQGffLnV7wIx5aoHsWbiM4p" alt=""><figcaption></figcaption></figure>

#### How Can I Get a Guru NFT?

There are a few ways to get your hands on Guru NFTs:

* Redeem Points for a Guru DAO NFT (+250 Guru Reward🔥)\
  You can redeem them for a Guru DAO NFT for 1,000 points. To redeem an NFT complete a “Points generation of DAO NFT Collection” quest in Guru Ecosystem apps. Once you generate your NFT, you can claim a reward of 250 GURU on Mainnet, which will go to your operational wallet. Please refer to this [post](https://blog.gurunetwork.ai/minting-guru-dao-nfts-for-points-step-by-step-guide-2/) if you have any difficulties.
* Mint a Guru DAO NFT\
  You can mint a Guru DAO NFT for 400 Guru (Base network). The minting is accessible on the Quest page of Guru Network apps. You can mint the NFT to your external wallet or to an operational one. Please refer to this [post](https://gov.gurunetwork.ai/t/how-to-participate-in-guru-network-governance/32#p-44-steps-to-mint-your-guru-dao-nft-3) if you have any difficulties.
* Purchase on Opensea\
  You can purchase Guru Season Pass #1, Guru Season Pass #2, and Spooky Guru NFTs on Opensea:
* * [Guru Season Pass #1](https://opensea.io/collection/guru-season-pass-nft-v2)
  * [Guru Season Pass #2](https://opensea.io/collection/guru-season-2-pass)
  * [Spooky Guru NFT](https://opensea.io/collection/spooky-guru)
  * [Guru DAO NFT](https://opensea.io/collection/guru-network-dao)

#### What’s the Difference Between NFTs?

| NFT                | Description                                                 | How to Get                                                                         | Voting Power        | Rewards         |
| ------------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------- | --------------- |
| Guru Season Pass 1 | Issued in 2022 for early adopters and users of DexGuru      | Purchase on Opensea                                                                | 1 Vote for each NFT | High Multiplier |
| Guru Season Pass 2 | Issued in 2024 for early adopters and users of Guru Network | Purchase on Opensea                                                                |                     |                 |
| Spooky Guru NFT    | Limited time NFT collection                                 | Purchase on Opensea                                                                | Regular Multiplier  |                 |
| Guru DAO NFT       | Evergreen NFT                                               | <p>Redeem for points or mint for GURU tokens<br><br></p><p>Purchase on Opensea</p> |                     |                 |

Each NFT provides 1 vote in DAO governance. The total voting power is the sum of all NFTs held in a wallet.

No matter which method you choose, owning a Guru NFT grants you access to governance, access to rewards, and opportunities to actively participate in shaping the future of the Guru Network.

#### How to Vote on Snapshot Using Your Guru NFTs

Connect Your Wallet to Snapshot

Visit the Guru Network’s [Snapshot](https://snapshot.org/#/thegurudao.eth) page and connect your wallet containing the Guru NFTs.

Verify Your Voting Power

Your voting power is determined by the number and type of NFTs you hold. Each NFT grants a one vote in voting power, and they sum up to your total voting power. The combined total of these NFTs determines the weight of your vote. For example:

You have 0 Guru Season Pass #1, 1 Guru Season Pass #2, 1 Spooky Guru NFT contributes and 3 Guru DAO NFT. You total voting power is (0 + 1 + 1 +3) = 5 votes.

Select the Proposal to Vote On

Browse through the list of active proposals and select the one you want to vote on.

Cast Your Vote

Follow the instructions to cast your vote. Your voting power will be automatically calculated based on the NFTs in your wallet.

By voting, you help shape the future and direction of the Guru Network. Every vote counts, so make sure to stay informed and participate actively!

#### Does it Make Sense to Get More NFT?

In the Guru Network, owning more NFTs can unlock several advantages:

* Voting Power: Each NFT grants you voting power in the Guru DAO, increasing your influence in network governance. Each NFT you own gives you 1 vote during the Snapshot voting. Currently, voting happens on Snapshot with an external wallet. We have plans to integrate voting within ecosystem apps, enabling voting with your operational wallet (ETA 2025). &#x20;
* Rewards: You gain additional rewards for each type of NFT you own. While having multiple NFTs of the same type doesn't increase the reward multiplier, owning different types does stack the multipliers. Rewards for different quests and types of NFTs may vary. &#x20;

However, it's important to consider the initial investment required to acquire multiple NFTs and the potential risks associated with the fluctuating value of NFTs. Also, note that reward multipliers don't stack for multiple NFTs of the same type.

#### How to Share Generated NFT Art on Twitter?

Once you mint your NFT in Guru ecosystem apps, open the NFT task on the Quests page in the Guru Network app. There, you will find ready-to-share links for platforms like Twitter. Simply click the link, customize the text if desired, and share your NFT art effortlessly. You can use it to share your NFT on X(Twitter) and Telegram. Also you can view your NFT on OpenSea.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXceqDfxxWfW0KRCbClPzIXzXBhRQEombQO3g0yWZjq9hGOBkKyJoTRBLvadSwV--q-2yv-tE3xOP5LF46mf3Y-QV4cKx0E_24W-QU9BS_4Bsj6mxY5cvHpF_1TFIIOuSHd5OBX8qQ?key=apQGffLnV7wIx5aoHsWbiM4p" alt="" width="375"><figcaption></figcaption></figure>

###

## GuruNetwork Tokenomics

#### What is Guru Network Tokenomics?

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdICmLo6JPfO_PdkWLUWNaKfhn_MRgiWUgWuwrVekwwL8XFimoveH--G9GnpPRTaX0pCRqnrPM5YrKWd3M2eDPIWPT_uqM_yX7-fZe-w-Z1hne05hLWwuitrHh-P72vfCchGofiJQ?key=apQGffLnV7wIx5aoHsWbiM4p" alt=""><figcaption></figcaption></figure>

The Guru Network tokenomics are designed to support its multi-chain orchestration and AI-driven ecosystem. The $GURU token serves as the network's utility token, facilitating transactions, governance, and staking while supporting AI-based business process automation. It operates alongside Chainlink's $LINK token, ensuring secure cross-chain interoperability and reliable data feeds. With a total supply of 1 billion tokens, 20% is reserved for ecosystem incentivization, gradually unlocked over 1.5 years to reward network participants. To dive deeper into Guru Network's tokenomics, please read the following:

* [GURU Token Token Sale](https://app.fjordfoundry.com/token-sales/0xcd3deBf6D36212523EDF6e0e9804f0f62C91093C) - LBP Details
* [Tokenomics Allocation and Distribution](https://gurunetwork.ai/distribution)
* [Litepaper](https://gurunetwork.ai/assets/img/litepapper_dexguru_network.pdf)
* [Whitepaper](https://gurunetwork.ai/assets/img/guru_network_architecture_whitepaper.pdf)

### What is the Guru Token?

The Guru Token ($GURU) serves as the backbone of the Guru Network’s economy. It is a multi-utility token designed to drive governance, incentivization, and ecosystem interaction.

Key Features

* Utility: Used for staking, governance voting, minting NFTs, and accessing premium features within the ecosystem.
* Dual Deployment: $GURU exists on both Ethereum and Base networks to ensure flexibility and scalability.

Contract Information

* Ethereum Network [0x525574C899A7c877a11865339e57376092168258](https://etherscan.io/token/0x525574C899A7c877a11865339e57376092168258)
* Base Network [0x0f1cFD0Bb452DB90a3bFC0848349463010419AB2](https://basescan.org/token/0x0f1cFD0Bb452DB90a3bFC0848349463010419AB2)

#### How Can I Get $GURU Tokens?

You can get the&#x20;

* Complete ecosystem-wide or app-specific quests
* Get as a reward for participation in governance
* [Buy on DEXes](https://blog.gurunetwork.ai/how-to-buy-guru-token/)

#### What is the tGURU Token?

The tGURU token (or points) is the testnet version of the $GURU token, specifically designed for users to safely explore Guru Network ecosystem features without financial risk. It enables activities such as minting NFTs, and testing new app functionalities on PointsNet. This allows users to gain experience and engage with the ecosystem before transitioning to mainnet interactions​.

#### What is the $GURU Unlock Schedule?

Token Circulation Per Category By Percentage:

<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfHN06AT6P7l6QRgOYxmwqsoa0p0PaHXxkNmAcrBxvesqyqqfgRDODmBui6mybZhWGpNuz7BRw3LJ5AX6o7aI0CHPsKtR31HrF68H46uI7NKZuMl5n9RxLL99Aiyj3xZJF8d81bBg?key=apQGffLnV7wIx5aoHsWbiM4p" alt=""><figcaption></figcaption></figure>

TGE and Locks date: May 28, 2024

Locks partner: [UNCX](https://uncx.network/)

Locks details: [View Locks](https://legacy.uncx.network/amm/uni-v2/token/0x525574C899A7c877a11865339e57376092168258)

#### What is an Operational Wallet?

In the Guru Network ecosystem, an Operational Wallet (or Internal Wallet) is a special type of wallet linked to your Telegram account. This wallet is designed to hold and manage the rewards you earn through various activities within the Guru Network.

Operational wallet is accessible in the app by clicking on the top bar icon in the left-top corner:

&#x20;  &#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeT7jofM-cSJTZJ_R8eXXNjMJArdSlS6XeqXYPIGiF9LcMJsx8-XgDGGpmefDG9cH0okgkRInFMwnvunzs8SrvGfZE9AC1hqxkr1UbY-PJ-imc1ZnjTYb5Nro2oNR5pjkCnUSPAHw?key=apQGffLnV7wIx5aoHsWbiM4p" alt="" width="375"><figcaption></figcaption></figure>

<br>

Here are some key features of the Operational Wallet:

* Centralized Reward Management: All rewards are deposited directly into this wallet.
* Ecosystem-Wide Access: Tokens can be used across all applications within the ecosystem.
* Linked to Telegram: Each Telegram account has a single Operational Wallet, simplifying management

Operational wallets are linked to Telegram accounts. If access is lost, users can initiate recovery via the Guru Network support portal with proof of ownership.

#### The Operational Wallet simplifies the process of managing your rewards and provides a convenient way to access and utilize your GURU tokens across the entire Guru Network ecosystem.


# Fees

Each transaction on Guru Network incurs X types of fees:

1. **Layer 3 (L3) Execution Fee**: Covers the cost of executing the transaction on Guru Network Layer 3 network.

* **L3 Fee Variability**: The L1 fee changes with transaction volume network. To minimize costs, consider submitting transactions during periods of lower gas usage, such as weekends.

Fees typically range from \_\_ to \_\_. This equates to approximately  \_\_\_ transactions per $1.


# Bridges

### Superbridge <a href="#superbridge-1" id="superbridge-1"></a>

[Superbridge](https://superbridge.app/) enables you to bridge $GURU from ETH to Base and back directly.

### Guru Bridge

* Enables users to transfer assets between Base network and Guru L3
* Supports WETH transfers through Superbridge technology
* Includes an intuitive chain selector for easy network switching

[https://bridge.gurunetwork.ai/](https://bridge.gurunetwork.ai/?ref=blog.gurunetwork.ai)

**Supported Networks**[**​**](https://docs.base.org/docs/tools/bridges#supported-networks)

* Mainnet


# Block Explorers

### Blockscout <a href="#blockscout" id="blockscout"></a>

A Blockscout explorer [is available](https://blockscout.gurunetwork.ai/) for Guru Network.

Blockscout provides tools to help you debug smart contracts and transactions:

* View, verify, and interact with smart contract source code.
* View detailed transaction information

### Guru Native Explorer:&#x20;

[`scan.gurunetwork.ai`](https://scan.gurunetwork.ai/)&#x20;


# Indexer

Guru Network Indexer

Link:

[**https://github.com/dex-guru/ethereum-etl**](https://github.com/dex-guru/ethereum-etl)

#### **Overview** <a href="#overview" id="overview"></a>

The blockchain indexer is a powerful and efficient tool written in Python, forked from the [original open-source project](https://github.com/blockchain-etl/ethereum-etl). This enhanced indexer is a core component used across all GuruNetwork.ai products, providing a robust solution for real-time indexing and querying blockchain data.

**Key Enhancements**

1. **New Entity Types**: Unlike the original indexer, our version supports several new entity types like dex trades and token balances, offering greater flexibility and depth in the data indexing process. This allows for a more comprehensive capture of blockchain events and states, facilitating advanced analytics and insights.
2. **Parallel Processing**: The indexer can be paralleled between multiple workers, significantly improving the indexing speed and efficiency. This parallel processing capability is achieved through the integration of RabbitMQ queues, enabling distributed task handling and coordination among workers. As a result, the indexer can handle large volumes of blockchain data with ease, ensuring timely updates and minimizing latency.
3. **Integration with GuruNetwork.ai Products**: Seamlessly integrated into the GuruNetwork.ai ecosystem, the indexer enhances the performance and functionality of our products. By providing accurate and up-to-date blockchain data, it supports various applications, from blockchain analytics to decentralized finance (DeFi) solutions.
4. **Community Participation**: The open-source nature of the indexer encourages community participation. Developers can contribute by adding new features, supporting additional blockchain networks, decentralized exchanges (DEXes), and other integrations. These community-driven enhancements ensure that GuruNetwork.ai products remain cutting-edge and responsive to the evolving needs of the blockchain space.

***

#### Useful Links <a href="#useful-links" id="useful-links"></a>

* [Schema](https://github.com/dex-guru/ethereum-etl/blob/main/db/migrations/schema.sql)
* [Command Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md)


# Contract Deployment

### Already know what you're doing? <a href="#what-is-remix" id="what-is-remix"></a>

* Add Guru Network
* RPC URL: <https://scan.gurunetwork.ai/chain>
* ChainID: `260`
* Bridge or request gas sponsorship from our team

### Getting started

TBD


# NFT APIs

### Use Rarible Protocol with Guru Network <a href="#use-rarible-protocol-with-matchain" id="use-rarible-protocol-with-matchain"></a>

The Rarible API is a dynamic, open-source, and multi-chain ecosystem designed to revolutionize NFT interactions and experiences. With a comprehensive suite of APIs, SDKs, and Smart Contracts, it provides a robust foundation for developers and creators to craft innovative NFT applications and marketplaces, allowing you to concentrate on your product.

References:

* [Rarible API](https://docs.rarible.org/docs/introduction)
* How to use [API](https://docs.rarible.org/reference/searchtraits) & [SDK](https://docs.rarible.org/reference/getting-started)
* How to get [API-Key](https://docs.rarible.org/docs/rarible-protocol#step-1-get-started)


# Account Abstraction

TBD


# Contracts

Token contracts for Guru Network Mainnet

**Native Tokens**

```
// WGURU Token Contract
address constant WGURU = 0xc339E17eFD801724937A645B7e356CFA8be85279;
// Wrapped ETH Contract
address constant WETH = 0xd402ca8c735960dbb5a45975b51f7dc9f85f977e;
// Bridged USDC Contract
address constant USDC.e = 0xfbf7fD738DE150c147dcaA120be96d0aB27C5a9b;
```

#### Core Protocol Contracts <a href="#core-protocol-contracts" id="core-protocol-contracts"></a>

**Uniswap Integration**

Copy

```
// Factory Contract
address constant UNISWAP_V2_FACTORY = 0x01a43Ad6C4244F820d9238d37AEc4867854c1044;
// Router Contract
address constant UNISWAP_V2_ROUTER = 0xEf68B8853f1B79601617110218bA8aB14C077df2;
```

**Utility Contracts**

Copy

```
// Multicall3 Contract
address constant MULTICALL3 = 0x9dE69f908Daf532019d2DeF8f7344e6Fc872F0dc;
```

#### Integration Examples <a href="#integration-examples" id="integration-examples"></a>

**Router Configuration**

Copy

```
const ROUTER_CONFIG = {
  factory: '0x01a43Ad6C4244F820d9238d37AEc4867854c1044',
  router: '0xEf68B8853f1B79601617110218bA8aB14C077df2',
  wguru: '0xc339E17eFD801724937A645B7e356CFA8be85279'
};
```

**Liquidity Functions**

Copy

```
interface IUniswapV2Router {
    function addLiquidity(
        address tokenA,
        address tokenB,
        uint amountADesired,
        uint amountBDesired,
        uint amountAMin,
        uint amountBMin,
        address to,
        uint deadline
    ) external returns (uint amountA, uint amountB, uint liquidity);
}
```

[<br>](https://docs.gurunetwork.ai/guru-network-mainnet-launch-documentation/network-information)


# Running Node

TBD


# How to buy $GURU

How to buy $GURU token

## **Token:**

**Contract on ETH:** [**https://etherscan.io/token/0x525574C899A7c877a11865339e57376092168258#code**](https://etherscan.io/token/0x525574C899A7c877a11865339e57376092168258#code)

**Contract on Base:**&#x20;

<https://basescan.org/token/0x0f1cFD0Bb452DB90a3bFC0848349463010419AB2#code>

### **BUY ON DEX**

**Uniswap on ETH:** <https://app.uniswap.org/explore/tokens/ethereum/0x525574c899a7c877a11865339e57376092168258> &#x20;

**Uniswap on Base:**<https://app.uniswap.org/explore/tokens/base/0x0f1cfd0bb452db90a3bfc0848349463010419ab2>&#x20;

**Equalizer:**

<https://base.equalizer.exchange/swap?inputCurrency=0x0f1cfd0bb452db90a3bfc0848349463010419ab2&outputCurrency=0x4200000000000000000000000000000000000006>&#x20;

### On our Token Terminal

**DexGuru:** <https://dex.guru/token/eth/0x525574c899a7c877a11865339e57376092168258>&#x20;

**DexGuru V2:** <https://v2.dex.guru/token/eth/0x525574c899a7c877a11865339e57376092168258>

### **BUY ON CEX**

**BitMart:** <https://www.bitmart.com/trade/en?symbol=GURU_USDT>&#x20;

**CoinEx:** <https://www.coinex.com/en/exchange/guru-usdt>&#x20;

**MexC:** <https://www.mexc.com/exchange/GURU_USDT><br>


# Web & social media

### **Join us on our:**

Website: <https://gurunetwork.ai/>&#x20;

X\Twitter: <https://x.com/xgurunetwork>&#x20;

CEO's X\Twitter: <https://x.com/evahteev>&#x20;

Discord: <https://discord.gg/dPW8fzwzz9>&#x20;

Telegram channel: <https://t.me/dexguru>&#x20;

Telegram group: [https://t.me/](https://t.me/dexguru)[gurunetworkchat](https://t.me/gurunetworkchat)

Farcaster: <https://warpcast.com/gurunetwork> &#x20;

Twitch: <https://www.twitch.tv/gurunetwork>&#x20;

YouTube channel: <https://www.youtube.com/@gurunetwork_ai>

\
What is Guru Network? <https://youtu.be/qozRUEnTIuI> &#x20;

What’s DexGuru V2 - walkthrough <https://youtu.be/TqpbNtYWt4o>&#x20;

How Guru Network works? <https://youtu.be/-hlJlh-W3YY>&#x20;

<br>

##


# Official NFT Collections

Opensea Season 1: <https://opensea.io/collection/guru-season-pass-nft-v2>&#x20;

OpenSea Season 2: <https://opensea.io/collection/guru-season-2-pass>&#x20;

OpenSea Evergreen: <https://opensea.io/collection/guru-network-dao>

Spooky: <https://opensea.io/collection/spooky-guru>&#x20;


# Docs and DYOR

GitHub: <https://docs.gurunetwork.ai/>&#x20;

Litepaper: <https://gurunetwork.ai/assets/img/litepapper_dexguru_network.pdf>

White paper: <https://gurunetwork.ai/assets/img/guru_network_architecture_whitepaper.pdf>

Guru Enlightenment Network Deck: <https://docsend.com/view/ihpwaurpca366kpa>&#x20;

Overview: <https://beincrypto.com/learn/guru-network/>&#x20;

AMA : <https://beincrypto.com/guru-network-ama-session-beincrypto/>&#x20;

AMAs archive on our YouTube channel: <https://youtube.com/live/nB3eCnk_cQw?feature=share>[ ](https://www.youtube.com/@gurunetwork_ai/streams)<br>

CTO’s Mirror: <https://mirror.xyz/evahteev.eth>&#x20;

LBP event (finished): <https://app.fjordfoundry.com/pools/0xcd3deBf6D36212523EDF6e0e9804f0f62C91093C>


# Open Source

Framework Github: <https://github.com/dex-guru/guru-framework.git>&#x20;


# Purpose and Vision

Converge AI, Blockchain and Automation for Business Domination

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

As blockchain and AI technologies mature, orchestrating their interactions with real-world business processes becomes increasingly crucial. Traditional smart contracts, while effective within their native environments, are often limited by a lack of secure, reliable real-world interaction. On the other hand, existing AI models perform well with simple tasks but face significant challenges when integrated into automated multi-step processes and participant flows.

The Guru Network design addresses this gap by focusing on AI-driven user flow orchestration across both on-chain and off-chain sides, providing a robust framework for real-world user actions and blockchain business process automation(BBPA). With Cross-Chain Interoperability Protocol (CCIP) protocol integration Guru Network can effectively serve as Multi Chain AI compute Layer 3 which allows apps and users to natively embed orchestrated AI Agents into their routines and earn Network participant rewards.

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

The Guru Network is dedicated to reducing the complexity associated with blockchain, AI and user actions states, facilitating accessible application development with minimal coding requirements. This enables users to focus more on innovation and value creation rather than underlying technologies.

Network Utility and Transactions Flow: In the Guru Network, each transaction is not merely a transfer of value but a critical component of orchestrated business processes. As decentralized process definitions are deployed and executed within the network, each step of the orchestration may trigger a transaction that requires decentralized consensus. This intrinsic link ensures that every action within an automated process is validated and secured by the network, enhancing the overall integrity and reliability of business operations. This approach not only optimizes process efficiency but also aligns with the network's commitment to providing a transparent, reliable, and sufficiently decentralized framework for enterprise-grade solutions.

Integration of AI and Blockchain: Integrating AI with blockchain, the Guru Network provides enhanced functionality for business applications, supporting AI-driven processes like GPT Completions and Retrieval-Augmented Generation (RAG) Memory Embeddings. This integration ensures applications are both efficient and contextually aware, optimizing performance within a blockchain framework.

Utilizing Chainlink CCIP for Enhanced Orchestration and Interoperability: The integration of Chainlink's Cross-Chain Interoperability Protocol (CCIP) is a strategic move for the Guru Network, allowing the orchestration of processes across any blockchain supported by CCIP. This capability effectively addresses the fragmentation issue prevalent in the blockchain space, where computation layers and dApps are often siloed within specific Blockchains yet need to operate collaboratively. By enabling seamless process integration across diverse blockchain environments, the Guru Network and Flow Orchestrator provide indiscriminate access to technology, opening doors for ecosystem scaling and substantial growth.

Decentralizing BBPA Engines: The future roadmap for the Guru Network includes transitioning the currently centralized BBPA Engines to a Decentralized Oracle Network (DON) architecture. This strategic shift will involve opening the BBPA Engine Event Bus to network participants through an Oracle interface connected to the BBPA Engine's Decentralized Oracle Network. This approach ensures that individual agents within the network can interact with the BBPA Engines as decentralized computational oracles. Such a structure promotes secure, efficient, and transparent execution of business processes across the network, aligning with the goal of complete decentralization. Architecture follows research papers published on DON and Chainlink's CCIP previously\[1]\[2]\[4].&#x20;

Blockchain Business Process Automation (BBPA): The focus of BBPA development is planned upon AI Models applications as they create the means of new types of economic incentives for network participants. The design of Guru Network significantly enhances the automation of complex business processes across diverse industries through BBPA Engines. These engines enable seamless integration and automation of AI Processors and users On-Chain/Off-Chain workflows, improving operational efficiency and reducing reliance on manual processes.

Empowering Users with Low-Code Solutions: The Guru Network and Flow Orchestrator offers a suite of tools and interfaces that simplify application development. Users benefit from drag-and-drop interfaces and pre-built templates that expedite development and lower entry barriers, making advanced technologies more accessible to entrepreneurs and business professionals. That approach simplifies enterprise business applications adoption mentioned at Chainlink v2.0 white paper\[2]


# Atomic Franchise Mechanism

Unlock Network Participation Economic Model Riches!

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

The ecosystem operates under the principles of the Atomic Franchise Mechanism (AFM), which are facilitated by BBPM (Blockchain Business Process Management) definitions. These definitions are deployed onto BBPA (Business Process Automation) Engines within the GURU Network. Individual Agents function as Lambda functions for serverless computing of AI Processors. Ecosystem projects integrate these BBPM Process Definitions into their workflows using the GURU Flow Orchestrator for deployment and management, along with the Framework SDK as the core for projects and integrations.

Ecosystem participants have the opportunity to publish their AI Processors and AI Assistants in the IAAS Catalog. Instances of BBPM processes, derived from these definitions, orchestrate users, Individual Agents (for AI computing and non-custodial execution), and on-chain actions across multiple chains where ecosystem dApps operate. This enables the creation of new economic models within the Guru Enlightenment Network, where participants share their business processes, routine optimizations, and proprietary intellectual property (in the form of Individual Agents) across the ecosystem as Infrastructure-as-a-Service (IaaS). Conversely, Gurus, users, and ecosystem projects can integrate these infrastructure flows into their BBPMs for use in business processes and Web3/Web2 applications.

When deploying a flow based on snippets from other participants, there are two types of fees involved, which contributors (Gurus) can specify during the publishing or BBPMN: an instantiation fee and rates for Individual Agents (as decentralized serverless AI Compute).

Consider a scenario where a company predominantly sells goods through platforms like Amazon, eBay, and to insurance companies. These sales funnel into a unified support pipeline where the context of an order, along with account and product details, are merged in an AI Processor BBPM Definition. Multiple Individual Agents running AI models are orchestrated to manage this data. As a result of these integrations, the company can offer both BBPMs and Individual Agents in the Guru IAAS catalog, utilizing individual workers and resources to address specific support chat challenges effectively.

<br>


# Participation

Roles and Opportunities for Contributors Incentives and Rewards System

<figure><img src="/files/9qq4GYTwRaB9RyoXLu3O" alt=""><figcaption></figcaption></figure>

As the Guru Network expands, it leverages a diverse ecosystem of contributors and users, each playing a crucial role in the network’s operation and growth. These various participant categories within the Guru Network, including Gurus, Ecosystem Projects, Individual Agents, Integrators, and Retail Users. Each category contributes uniquely to the network's ecosystem, from developing AI-driven solutions to enhancing blockchain interoperability and user engagement. Understanding these roles is essential for appreciating the network’s comprehensive architecture and collaborative dynamics.

* **Gurus**: This category encompasses AI Processors, Compute Node Runners, and Individual Agents code contributors.
* **Ecosystem Projects:** Retail and business projects serve as entities that combine multiple BBPA (Blockchain Business Process Automation) orchestrations and data scenarios to solve specific routine tasks or business functions. These projects can also act as Gurus by contributing AI Processors and GURU AI Assistants to the network. They have the opportunity to publish their AI Processors, GURU AI Assistants, and Individual Workers in a IAAS(infrastructure-as-a-service) catalog, making them available for integration by other participants in the ecosystem.&#x20;
* **Individual Agents:** AI/Non-Custodial Web3 Processors composed by Gurus and run by Compute nodes, utilized by BBPM defined processes.
* **Integrators:** For enterprise implementations, integrators serve as a middle layer providing B2B adoption of the Guru AI Flow Orchestrator and Framework.
* **Retail Users:** Retail users utilize the network as assistants from their wallets. Additionally, the architecture allows for them to participate in "Compute by Earn" when idle functionality, where they choose which Individual Agents to run when their device/wallet is idle.

The Guru Enlightenment Network thrives on the collaboration between Gurus, who innovate with AI technologies, ecosystem projects and active retail users, enhancing both functionality and scalability[.](https://docs.gurunetwork.ai/purpose-and-vision/www.ourfirstlink.com)&#x20;

<br>


# Rewards and Incentives

Get Rewarded for Your Contributions - Power the Decentralized AI Compute Layer

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

Gurus and Individual Agents are primarily incentivized through two revenue streams:&#x20;

* Instantiation fees from BBPM processes listed in the Guru IAAS Catalog.
* Fees from providing their Individual Agents (IA) as IAAS(infrastructure-as-a-service). These agents support network operations by offering their infrastructure for computational tasks.&#x20;

Rewards are earned for initiating processes and offering infrastructure, thus contributing to the AI Compute layer of Guru Enlightenment Network(GEN). Furthermore, this infrastructure, managed by the Flow Orchestrator's Task Queue Interface, can be developed into proprietary intellectual property (IP), which allows for the commercialization of customized business and AI models or non-custodial cross-chain computations.

<br>


# Guru Network

Marry BPMN and On-Chain Processes, utilizing CCIP to Blockchain Business Process Management

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

DexGuru is evolving its internal Developer Tooling into the Guru Enlightenment Network(GEN), driven by our  need for Multi-Chain Orchestration for Guru solutions deployed across 18 blockchain networks. These products, which include the Guru Block Explorer and Data Warehouse, have been publicly operational since July 2023 and DeFi Trading Terminal since February 2021. Execution core of the Guru Developer Toolset is Flow Orchestrator, initially an internal tool for cross-product Blockchain Business Process Automation (BBPA), employing the [BPMN](https://www.bpmn.org/)(Business Process Management and Notation) standard \[1] standard for defining process manifests.

Process definitions are deployed onto the Flow Orchestrator and can be instantiated from there. Alongside the BPMN\[1] definition deployed on the Web2 Flow Orchestrator, a corresponding Factory Smart Contract (SC) representing the same process definition is deployed on-chain. This design facilitates the creation of Blockchain Business Process Management (BBPM) definitions.

From the very beginning we decided not to "reinvent the wheel" and extended traditional BPA engines to support BBPM. We have been evaluating popular open-source projects like [Camunda Platform 7](https://docs.camunda.org/manual/7.21/)\[2] and [Flowable](https://www.flowable.com/)\[3] for this purpose since November 2023. We chose to build on top of Camunda, also its [Apache License 2.0](https://github.com/camunda/camunda-bpm-platform/blob/master/LICENSE) license allowed a public open source path for us. The Flow Orchestrator, in the form of the Camunda Web3 extension, was first released and utilized in production in December 2023. It has since been extensively used by the Guru team to orchestrate user flows and AI/business processes across our suite of B2B and retail products.&#x20;

Our internal assessments show that this Developers Tooling Architecture significantly aids the Guru Team in rapid development and operational control. The [Flow Orchestrator Framework](https://github.com/dex-guru/guru-framework/tree/main)\[5] on GitHub includes BBPA Engine, Smart Contracts, Individual Agents, and GUI allowing us to quickly spin up new applications and integrations. This framework was also tested for external party integration when it was utilized by one of the teams at the ETHDenver 2024 Hackathon.

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

We plan to scale and decentralize this approach by productizing the Flow Orchestrator and Data Warehouse into what will be known as the Guru Enlightenment Network(GEN). Here are the main design decisions we’ve made:

1. We envision a clustered environment of BBPA Engines with on-chain counterparts deployed as Engine SC and BBPM Process Definition Factory SC\[5]. These Smart Contracts, deployed onto the Guru Network, synchronize the state across engines.
2. Expanding on these architectural considerations, we aim to utilize the Cross-Chain Interoperability Protocol ([CCIP](https://docs.chain.link/ccip))\[6] for orchestrating multi-chain activities, moving away from the centralized Flow Orchestrator model currently used internally by the Guru team. The operational architecture comprising the Flow Orchestrator, BBPA Engines, and the Guru Network functions as Oracles for DON (Decentralized Oracle Networks)\[7].&#x20;
3. CCIP allows for multi-chain messaging and value transfers(ERC-20), which can be utilized by Flow Orchestrator as a value transfer mechanism defined on task level in BBPM definitions.&#x20;
4. This setup allows for multi-chain Operational Chain <-> CCIP\[6] <-> DON(Guru exec) <-> BBPA Engines <-> Guru Network orchestration, with well known Oracle interfaces designed to act as a compute layer for dApps, either deployed on their operational chain or across multiple chains.

Those core design principles identify the foundation of Guru Enlightenment Network, Guru Community and Ecosystem growth.


# Guru Network ChainLink integration

Chainlink's Cross-Chain Interoperability Protocol powering the future of the Guru Network

The integration of Chainlink Functions within the Guru Network is just the beginning of our collaboration with Chainlink technology. This document highlights the successful deployment of various AI models for image generation and NFT minting.&#x20;

The synchronization of the order-fulfill-release flow between DexGuru and Pixelpact(providing compartable AI processor) nodes is efficiently managed through inscriptions on the Guru Network, powering the Atomic Franchise Mechanism.

&#x20;Looking ahead, we also plan to integrate Chainlink's Cross-Chain Interoperability Protocol (CCIP) to further enhance our multi-chain capabilities. Stay tuned as we document these advancements, showcasing how Chainlink's innovative solutions continue to power the future of the Guru Network.


# Guru Season 2 Pass And ChainLink Functions Case

Integrating Chainlink Functions into the Guru Season 2 Pass NFT smart contract significantly enhances its capabilities, allowing for secure access to off-chain data and complex computations.

#### Authors: [Evgeny Vakhteev](https://github.com/evahteev), [Evgeny Shestakov](https://github.com/shestakoven)  <a href="#enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions" id="enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions"></a>

#### Enhancing the [GuruSeason2PassNFT Smart Contrac](https://basescan.org/token/0xeb8ae9ed9df8bff58f9d364eef3c4986f4331d1e)t with [Chainlink Functions](https://docs.chain.link/chainlink-functions) <a href="#enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions" id="enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions"></a>

#### Base: <https://basescan.org/token/0xeb8ae9ed9df8bff58f9d364eef3c4986f4331d1e> <a href="#enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions" id="enhancing-the-guruseason2passnft-smart-contract-with-chainlink-functions"></a>

**Introduction**

The integration of [Chainlink Functions](https://docs.chain.link/chainlink-functions) in smart contracts marks a significant advancement in the capabilities and functionality of decentralized applications (dApps). This article delves into the intricacies of the GuruSeason2PassNFT smart contract, highlighting the role of Chainlink Functions and exploring the potential for dynamic NFTs in future releases.

**Overview of the GuruSeason2PassNFT Smart Contract**

The GuruSeason2PassNFT contract is a sophisticated ERC721-based non-fungible token (NFT) designed to provide users with unique Season Pass NFTs. It incorporates several advanced features to enhance functionality and security:

* **ERC721Enumerable**: Enables enumeration of NFTs, allowing the contract to keep track of all minted NFTs.
* **ERC721Pausable**: Provides the ability to pause and unpause contract operations, ensuring better control during updates or in case of emergencies.
* **FunctionsClient**: Facilitates interactions with Chainlink Functions, enabling the contract to request and process off-chain data.
* **ConfirmedOwner**: Ensures ownership access control, allowing only the owner or designated executor to perform critical operations.

The contract is designed to limit each address to a single NFT, with a specified minting end time to ensure timely distribution of Season Passes.

**Minting Mechanism Protected by Merkle Root**

The GuruSeason2PassNFT employs a secure minting mechanism protected by a Merkle root. This ensures that only authorized users can mint NFTs, preventing unauthorized access and ensuring fair distribution. Here's how it works:

* **Merkle Proof Verification**: During the minting process, users must provide a Merkle proof. This proof is used to verify their inclusion in a pre-approved list (the Merkle tree), ensuring they are eligible to mint the NFT.

```solidity
function safeMint(bytes32[] calldata proof) public {

require(balanceOf(msg.sender) < NFT_PER_ADDRESS_LIMIT, "You have reached max number of NFT!");

require(block.timestamp <= MINTING_END_TIME, "SeasonPass has been sold out!");

bytes32 leaf = keccak256(bytes.concat(keccak256(abi.encode(msg.sender))));

require(MerkleProof.verify(proof, MERKLE_ROOT, leaf), "Invalid proof");

uint256 tokenId = _nextTokenId++;

_safeMint(msg.sender, tokenId);

}
```

* **Dynamic Merkle Root Updates**: The contract can dynamically update the Merkle root using Chainlink Functions, ensuring the list of eligible minters remains current and secure. The trigger for the Merkle root update is an invitation by a participant to another participant.

```solidity
function sendRequest(

string memory source,

bytes memory encryptedSecretsUrls,

uint8 donHostedSecretsSlotID,

uint64 donHostedSecretsVersion,

string[] memory args,

bytes[] memory bytesArgs,

uint64 subscriptionId,

uint32 gasLimit,

bytes32 donID

) external onlyOwnerOrExecutor returns (bytes32 requestId) {

FunctionsRequest.Request memory req;

req.initializeRequestForInlineJavaScript(source);

if (encryptedSecretsUrls.length > 0)

req.addSecretsReference(encryptedSecretsUrls);

else if (donHostedSecretsVersion > 0) {

req.addDONHostedSecrets(

donHostedSecretsSlotID,

donHostedSecretsVersion

);

}

if (args.length > 0) req.setArgs(args);

if (bytesArgs.length > 0) req.setBytesArgs(bytesArgs);

s_lastRequestId = _sendRequest(

req.encodeCBOR(),

subscriptionId,

gasLimit,

donID

);

return s_lastRequestId;

}
```

3. **Processing Responses**:

The `fulfillRequest` function processes the response from Chainlink, updating the contract state based on the data received.

```solidity
function fulfillRequest(

bytes32 requestId,

bytes memory response,

bytes memory err

) internal override {

if (s_lastRequestId != requestId) {

revert UnexpectedRequestID(requestId);

}

if (err.length == 0) {

MERKLE_ROOT = bytes32(response);

}

s_lastError = err;

emit Response(requestId, response, s_lastError);

}
```

**Benefits of Using Chainlink Functions**

The integration of Chainlink Functions offers several key benefits to the [GuruSeason2PassNFT](https://opensea.io/collection/guru-season-2-pass) smart contract:

1. **Access to Off-Chain Data**: Enables the contract to access dynamic and real-time data, enhancing its functionality.
2. **Enhanced Security**: Chainlink provides tamper-resistant data through decentralized oracles, ensuring data integrity and reliability.
3. **Cost Efficiency**: Offloading complex computations to Chainlink reduces on-chain gas consumption, making transactions more cost-effective.
4. **Increased Functionality**: Allows the contract to perform complex off-chain computations and interact with external APIs, expanding the range of possible use cases.

**Future Prospects: Dynamic NFTs Enabled by Chainlink Functions**

Dynamic NFTs represent the next step in the evolution of digital assets, offering a more interactive and engaging experience by changing and evolving based on external data and real-world events. By leveraging Chainlink Functions, the [GuruSeason2PassNFT](https://opensea.io/collection/guru-season-2-pass) contract can be extended to support dynamic NFTs, significantly enhancing user engagement and value.

**Use Case: Dynamic Guru Season Pass NFTs**

Dynamic Guru Season Pass NFTs could evolve based on various factors such as user achievements, event participation, or real-world events. This dynamic feature can significantly enhance the value and appeal of the NFTs, creating a unique and personalized experience for each holder.

1. **Real-Time Data Integration**: NFTs could change based on real-time sports events or weather updates, reflecting real-world conditions and events.
2. **User Achievements and Interactions**: NFTs could update to reflect user milestones within the Guru ecosystem, unlocking new visual elements or features.
3. **Event Participation**: NFTs could evolve during live events, providing unique keepsakes that represent the event's outcome or highlights.

**Implementation Strategy**

1. **Fetching Real-Time Data**: Use Chainlink oracles to retrieve data from external sources such as sports APIs or weather services.
2. **Real-Time Data Integration**: NFTs could change based on real-time sports events or weather updates, reflecting real-world conditions and events.
3. **User Achievements and Interactions**: NFTs could update to reflect user milestones within the Guru ecosystem, unlocking new visual elements or features.
4. **Event Participation**: NFTs could evolve during live events, providing unique keepsakes that represent the event's outcome or highlights.

**Implementation Strategy**

1. **Fetching Real-Time Data**: Use Chainlink oracles to retrieve data from external sources such as sports APIs or weather services.

```solidity
function updateNFTAttributes(uint256 tokenId) external onlyOwnerOrExecutor {

string memory source = "https://api.weather.com/v3/wx/conditions/current";

bytes32 requestId = sendRequest(

source,

"",

0,

0,

new string ,

new bytes ,

subscriptionId,

gasLimit,

donID

);

requestToTokenId[requestId] = tokenId;

}
```

2. **Processing and Updating NFTs**: Use the fulfill function to update NFT attributes based on the fetched data.

```solidity
function fulfillRequest(

bytes32 requestId,

bytes memory response,

bytes memory err

) internal override {

if (s_lastRequestId != requestId) {

revert UnexpectedRequestID(requestId);

}

if (err.length == 0) {

uint256 tokenId = requestToTokenId[requestId];

updateNFTMetadata(tokenId, response);

}

s_lastError = err;

emit Response(requestId, response, s_lastError);

}

function updateNFTMetadata(uint256 tokenId, bytes memory responseData) internal {

string memory newAttribute = parseResponseData(responseData);

_setTokenURI(tokenId, newAttribute);

}
```

3. **Dynamic Metadata**: Define how the NFT metadata should change based on the data.

```solidity
function _baseURI() internal view override returns (string memory) {

return "https://dynamic.gurunetwork.ai/nft/";

}

function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {

require(_exists(tokenId), "ERC721Metadata: URI set of nonexistent token");

_tokenURIs[tokenId] = _tokenURI;

}
```

Integrating [Chainlink Functions](https://docs.chain.link/chainlink-functions) into the [GuruSeason2PassNFT](https://opensea.io/collection/guru-season-2-pass) smart contract significantly enhances its capabilities, allowing for secure access to off-chain data and complex computations. This integration not only improves functionality and security but also opens the door to innovative features like dynamic NFTs. By embracing these advancements, the [GuruSeason2PassNFT](https://opensea.io/collection/guru-season-2-pass) contract can provide a more interactive, personalized, and engaging experience for users, paving the way for future innovations in the blockchain ecosystem.


# Guru Token

The $GURU token is a central element of the Guru Network, providing a secure and flexible mechanism for rewarding contributors, managing the token supply, and ensuring the integrity of the ecosystem.

## GURU Token

The GURU token is the native utility token of the Guru Network, designed to facilitate various activities within the ecosystem, reward contributors, and manage the supply through secure mechanisms. This document provides an overview of the GURU token's mechanisms, rights, and pointers to deployed addresses.

### Overview

* **Token Name:** GURU Token
* **Symbol:** GURU
* **Decimals:** 18
* **Total Supply:** 1,000,000,000 GURU
* **Deployed Address:** [0x525574c899a7c877a11865339e57376092168258](https://etherscan.io/address/0x525574c899a7c877a11865339e57376092168258#code)
* **Chain:** Ethereum (Mainnet, ChainId 1)

### Smart Contract Mechanisms

#### Minting

* **Initial Supply:** The contract mints a total supply of 1 billion GURU tokens at deployment.
* **Minting Functionality:** There is no additional minting functionality; the total supply is fixed at 1 billion tokens.

#### Burning

* **Burning Capability:** The contract does not include a burning mechanism. The total supply remains constant.

#### Pausing and Unpausing

* **Pausing Transfers:** The owner has the capability to pause all token transfers in case of a security threat.
* **Unpausing Transfers:** The owner can also unpause the transfers, resuming normal operations.

#### Ownership

* **Owner:** The `_guruSafe` address is set as the owner of the contract. This address has special administrative rights to manage the token, such as pausing and unpausing transfers.

### Key Roles and Rights

#### `_guruSafe` Address

* **Initial Recipient:** Receives the entire initial supply of 1 billion GURU tokens upon deployment.
* **Ownership Rights:** As the owner, `_guruSafe` has the ability to:
  * Pause and unpause token transfers.
  * Manage the circulating supply through transfers.
* **Security Considerations:** It is recommended to use a multisig wallet for `_guruSafe` to enhance security and prevent unauthorized actions.

### Multisig Wallet Setup

To ensure the security and integrity of the GURU token management, the `_guruSafe` address should be a multisig wallet. This setup requires multiple approvals for any administrative action, reducing the risk of a single point of failure.

#### Recommended Multisig Configuration

1. **Use a Platform:** Gnosis Safe is recommended for setting up the multisig wallet.
2. **Number of Signatories:** A 2-of-3 or 3-of-5 configuration is suggested for balance between security and operational efficiency.
3. **Signatories:** Trusted individuals or entities within the Guru Network.

#### Multisig Wallet Capabilities

* **Managing Circulating Supply:** The multisig wallet can manage the circulating supply by transferring tokens to and from various addresses.
* **Pausing and Unpausing:** The multisig wallet can pause and unpause token transfers for security purposes.

### Contract Deployment

* **Deployment Address:** The GURU token contract is deployed at the following Ethereum mainnet address:
  * [0x525574c899a7c877a11865339e57376092168258](https://etherscan.io/address/0x525574c899a7c877a11865339e57376092168258#code)

#### Initial Distribution

Upon deployment, the entire supply of GURU tokens is transferred to the `_guruSafe` address. Subsequent distributions, such as allocations to liquidity pools or vesting contracts, are managed by the `_guruSafe` address.

### GitHub Repository

For more details, including the source code and development updates, visit the [GURU Token GitHub Repository](https://github.com/dex-guru/).

### Conclusion

The GURU token is a central element of the Guru Network, providing a secure and flexible mechanism for rewarding contributors, managing the token supply, and ensuring the integrity of the ecosystem. By leveraging robust security practices, such as using a multisig wallet for the `_guruSafe` address, the Guru Network ensures that the GURU token remains a reliable and valuable asset for its community.

For more details and real-time information, you can view the GURU token contract on [Etherscan](https://etherscan.io/address/0x525574c899a7c877a11865339e5737609216825).


# Web3 Infrastructure

The Guru Network is architecturally designed as a Layer 3 solution on the base stack for multi-chain AI orchestration, leveraging Chainlink's Cross-Chain Interoperability Protocol (CCIP). Guru Network

<figure><img src="/files/7lRSq8R2p7fSPNbs0EVp" alt=""><figcaption></figcaption></figure>

### Flow Orchestrator

<figure><img src="https://lh7-us.googleusercontent.com/V3m6y0XjtKtUYMp8cd5t87PvGU3f8XGzqTTJkhfPY24penirupNvIlfGp25TAPxVRzR63itdi5BFMiMkmMKG8IS5K_u7eYIuWsmcv9ZQCjDnAPinzgCftYZyZTF2p1D7qocg3ZG7Kv00zQl9-1TwnVQ" alt=""><figcaption><p>Flow Orchestrator BPMN</p></figcaption></figure>

\
The Flow Orchestrator, a central component of our Web3 infrastructure, harnesses AI processors equipped with comprehensive data sourced from the Guru Data Warehouse, Analytics driven Block Explorer and DeFi trading terminal deployed on Guru Network. This setup reduces the manual complexities typically associated with Web3 technologies, which can hinder adoption and lead to user errors. By automating and battle-testing processes, the Flow Orchestrator ensures efficient blockchain orchestration within the Guru Enlightenment Network, enhancing operational efficiency and maximizing network value.

### BBPA Engine Event Bus as Network Native Oracle

As we continue to enhance the usability and interoperability of orchestrated BBPM processes, we plan to integrate the Flow Orchestrator Event Bus as an interface that can be queried through oracles within the Guru Network. Currently, the Flow Orchestrator event bus feeds into Elasticsearch storage, which is accessible via the Guru Data Warehouse. Moving forward, we aim to expose this data on-chain, leveraging the centralized Elasticsearch storage in a selective manner based on the specific needs within ecosystem process definitions. This approach will streamline data accessibility and enhance real-time data integration across the network, fostering greater transparency and efficiency in process orchestration.

### AI Compute Oracles as Prophets

In the context of the Guru Network, a Prophet refers to an advanced predictive mechanism that extends the traditional oracle concept (typically used for sensor data) to include prediction generation capabilities. Prophets are utilized within the AI Compute Orchestration as Verifiable Truth Sources and Base Truth Oracles. As BBPA (Blockchain Business Process Automation) Engines achieve sufficient decentralization, they can serve as Base Truth Oracles for specific AI Processors. This role is crucial in filtering out hallucinative responses from Language Learning Models (LLMs) and maintaining the relevance of automated responses. By ensuring that AI-driven processes are based on verified and reliable data, Prophets enhance the accuracy and applicability of automated decisions across the network

### Real-World Impact and Network Growth

Through the Guru Enlightenment Network, AI Gurus tackle real-world business challenges across multiple chains by integrating them into the Decentralized Oracle Network. This approach not only brings efficiency but also drives practical innovations that meet the evolving demands of the digital landscape. The synergy between Gurus—who innovate with AI technologies— Ecosystem projects — and active retail users, who enhance network functionality and scalability, enhances the ecosystem growth in integrating user flows with AI and blockchain technology.

### User Engagement and Participation

Retail users engage with the network by utilizing AI assistants directly from their wallets. Furthermore, the BBPA Engine in wallet architecture supports a "Compute to Earn" functionality allowing users to select which Individual Agents to run, when devices or wallets are idle. This feature encourages active participation and contributes to the network’s collaborative ecosystem.

<br>


# Web2 and Off-Chain Infrastructure

Enable Business Process Automation integrators to build various front-end applications atop the orchestration system

<figure><img src="/files/3ePxqagtVo2WA7qTyyC9" alt=""><figcaption></figcaption></figure>

### BBPA Engine REST API

We utilize Camunda Platform 7 as the open-source foundation of Flow Orchestrator Nodes it offers an extensive [REST API](https://docs.camunda.org/rest/camunda-bpm-platform/7.20/)\[9] out of the box. REST API designed to enable BPA(Business Process Automation) integrators to build various front-end applications atop the orchestration system.&#x20;

All the states of the processes instantiated from BBPM process definition items are accessible through these REST APIs hosted on BBPA Engine, allowing for object interactions and state queries. These APIs can be exposed to Web2 applications either directly through the BBPA Engine node or via a Flow Orchestrator proxy that handles all requests from multiple tenants

<br>


# Multi Chain Interoperability Layer (CCIP)

Flow Orchestrator and Blockchain Business Process Automation on Guru Network

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

The Guru Network is set to advance its architecture by integrating Chainlink's Decentralized Oracle Network (DON), ensuring secure and efficient processing of off-chain computations and data feeds. This integration will enhance robust interoperability through the Cross-Chain Interoperability Protocol (CCIP), extending beyond our current centralized Flow Orchestrator model. The CCIP is already functional on multiple blockchains including Arbitrum, Avalanche, Base, BNB Chain, Ethereum, Kroma, Optimism, Polygon, and WEMIX, and is poised for further expansion, enhancing both the Guru Network and the Flow Orchestrator's multi-chain capabilities.

<figure><img src="/files/67pTRDKsEUkFqmgMJ3v1" alt=""><figcaption></figcaption></figure>

This upgraded architecture not only supports multi-chain messaging and ERC-20 token transfers but also improves scalability and performance across various sectors like finance, supply chain, and automated customer interactions. These sectors stand to benefit from AI-driven dynamic optimizations and data-driven decisions, utilizing CCIP’s capabilities for value transfer mechanisms defined at the task level in BBPM (Blockchain Business Process Management) definitions.

Guru Network <-> DON integration focused on AI Compute Orchestration expands the Oracles concept(sensor data) towards Prophets(prediction generator for future data) implementation.&#x20;

The operational trio of the Flow Orchestrator, BBPA Engines, and the Guru Network acts as the oracle infrastructure within DON, streamlining processes and maintaining integrity and confidentiality across diverse platforms. For a detailed exploration of these integrations and our future strategies, please refer to the "Building [The AI Orchestration Network: Blockchain Business Process Automation Architecture](https://gurunetwork.ai/assets/img/guru_network_architecture_whitepaper.pdf)" whitepaper, which covers the "Guru Network <-> Chainlink DON <-> CCIP” integration extensively.


# Subsquid & Guru Network Data Partnership

How Guru Network and  Subsquid integration helps to  automate complex business processes with reliable, real-time multi-chain data.

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

Authors: <https://gurunetwork.ai/>, <https://subsquid.io/>

### Abstract

This whitepaper details the integration of Subsquid and Guru Network, highlighting the technical architecture and potential use cases enabled by this collaboration. The Guru Network, a Multi-Chain AI Compute Layer, focuses on AI-driven user flow orchestration across both on-chain and off-chain environments. By integrating Subsquid's decentralized data aggregation and query capabilities, the Guru Network enhances its ability to automate complex business processes with reliable, real-time multi-chain data. Subsquid SDK simplifies the integration process and the Guru Data Warehouse aggregates these data streams for AI processors. The economic interactions between the $GURU and $SQD tokens drive network participation and value creation in future. This integration significantly advances decentralized AI-driven automation, offering robust solutions for DeFi, social applications, gaming, infrastructure management, and the creator economy.

**Introduction**

![](https://lh7-us.googleusercontent.com/docsz/AD_4nXe6ENwcZMLgK_L4UCNK0nr41WD_IP7lSR-P4vbvoMVO3KmgC5B8QRDsMG_XzacxZTOaqFzVNRaHb4PtUXSsh2AuR5JQLi8lo8Cb54V017BtTv4BVvlffXc3Nj3C-n3ab_K6_L0QzvXEUqaAuxc7FzWEr7Pe?key=L6VgfJJ54zGqjbSlyFvXwQ)

The integration of Subsquid with the Guru Network aims to harness the capabilities of Subsquid's decentralized data aggregation and query network to serve as a reliable data provider for AI processors and Web3 automation orchestrated by the Guru Network's nodes\[1]. This collaboration addresses the challenge of accessing and processing large-scale blockchain and off-chain data, enabling enhanced AI-driven business process automation across multiple blockchain networks.

**Subsquid Network Overview**

![](https://lh7-us.googleusercontent.com/docsz/AD_4nXeIm86geZQo6rSTguqEs_lDJRmDXBGme1szijxV9gCxIwS3zc9v1UBAFef90WTP54V4_R2LfJARW67FFN0vyG0U7UIvTBycP-IYTxTbu0eDgjzURnVnhLYorBH6rqpEEzyhTc0klRaxqV2k4jdDjoTylFuJ?key=L6VgfJJ54zGqjbSlyFvXwQ)

Subsquid Network is designed to meet these requirements with a decentralized architecture that includes\[3]:

* Data Providers: Upload raw data to permanent storage and distribute it among network nodes.
* Workers: Store and serve data in a peer-to-peer manner, earning rewards for their contributions.
* Scheduler: Distributes data chunks among workers based on capacity and redundancy requirements.
* Logs Collector: Collects liveness pings and query execution logs from workers.
* Rewards Manager: Calculates and distributes rewards based on worker performance.
* Data Consumers: Query the network through gateways, with access controlled by locked SQD tokens.

The network supports simple queries initially, with plans to introduce more complex SQL queries and query planning layers in the future.

**Guru Network Overview**

The Guru Network focuses on AI-driven user flow orchestration across on-chain and off-chain environments, providing a robust framework for Blockchain Business Process Automation (BBPA). It leverages the Cross-Chain Interoperability Protocol (CCIP)\[2] to facilitate seamless multi-chain operations and integrates AI processors to manage complex business processes.

Key components of the Guru Network include:

* Flow Orchestrator: Manages BBPA engines and AI processes.
* Data Warehouse
* BBPA Engine Event Bus: Serves as a network-native oracle for process orchestration.
* AI Compute Oracles (Prophets): Provide predictive capabilities to enhance AI-driven decision-making.

**Subsquid <-> Guru Data Warehouse Integration Details**

The Guru Data Warehouse serves as a crucial aggregation point for data streams from Subsquid before they are utilized in processes running on Guru Network orchestration nodes. Here’s how it works:

1. Data Aggregation: Subsquid provides comprehensive on-chain and off-chain data streams, which are hooked up into the Guru Data Warehouse via Subsquid SDK -> Data Warehouse storage adapters. The data includes transaction data, smart contract states, and relevant off-chain data such as price feeds and external data sources.
2. Data Processing: Once the data is aggregated in the Guru Data Warehouse, it undergoes preprocessing to ensure it is ready for AI processors. This preprocessing includes data cleaning, normalization, and compression, making the data suitable for high-efficiency querying and processing.
3. Real-Time Data Utilization: The processed data is then utilized by AI-driven processes running on Guru Network orchestration nodes. These nodes leverage the data to execute complex business process automations, make data-driven decisions, and provide real-time insights.
4. Enhanced Decision Making: By integrating Subsquid’s data streams, the Guru Network ensures that its AI processors have access to the most accurate and up-to-date information. This enhances the reliability and efficiency of automated processes, leading to more accurate and impactful decision-making.

#### Architecture

The integration of Subsquid and Guru Network involves the following key components:

1. Subsquid Network:

* Data Providers: Submit raw data to the network.
* Workers: Store and serve the data.
* Scheduler: Manages data distribution among workers.
* Logs Collector: Aggregates logs for liveness and performance monitoring.
* Rewards Manager: Distributes rewards to network participants.
* SDK: Works in conjunction with Guru Data Warehouse as transport layer between two systems.

2. Guru Network:

* Flow Orchestrator: Manages BBPA engines and AI processes.
* Guru Data Warehouse: Aggregates and processes data from Guru Indexer, Subsquid(SDK) and other data providers(adapters).
* AI Processors: Utilize data from the Guru Data Warehouse to execute business processes.
* BBPA Engine: Runs business process automation on-chain and off-chain.

#### Use Cases

**Decentralized Finance (DeFi)**

The integration of Subsquid and Guru Network can revolutionize DeFi by providing real-time, reliable data for automated trading strategies, risk management, and financial analytics. AI-driven processes can use this data to make informed decisions, enhancing the efficiency and profitability of DeFi operations.

**Decentralized Social Applications (DeSoc)**

By leveraging the combined capabilities of Subsquid and Guru Network, decentralized social applications can offer enhanced user experiences through personalized AI-driven interactions and content recommendations based on real-time data analytics.

**Decentralized Gaming (GameFi)**

In decentralized gaming, real-time data from Subsquid can be used to manage in-game economies and assets efficiently. AI-driven processes can automate complex tasks such as player matchmaking, asset management, and in-game events, providing a seamless gaming experience.

**Decentralized Physical Infrastructure (DePIN)**

For decentralized physical infrastructure networks, the integration can provide real-time monitoring and management of physical assets. AI-driven processes can automate maintenance schedules, optimize resource allocation, and enhance the overall efficiency of infrastructure management.

**Decentralized Creator Economy**

Creators in the decentralized economy can benefit from AI-driven analytics and process automation powered by Subsquid data. This can include automated content distribution, personalized marketing strategies, and real-time audience engagement analytics.

#### $GURU and $SQD Economy Interactions

The integration of Subsquid with the Guru Network introduces potential interactions between the $GURU and $SQD tokens, which can drive economic activity and incentivize network participation.

**$GURU Token**

The $GURU token underpins the economic operations of the Guru Network, serving as a fundamental element of the Contract Secured Revenue (CSR) model. Key uses include:

* Incentivizing Participation: Participants earn $GURU tokens by contributing computational resources, developing AI processes, and engaging in network activities.
* Ensuring Security: The staking mechanisms involving $GURU tokens help secure the network by aligning the incentives of participants.
* Facilitating Transactions: $GURU tokens are used to pay for transactions and services within the network, ensuring smooth and efficient operations.

**$SQD Token**

The $SQD token is the native token of the Subsquid Network, used to:

* Reward Node Operators: $SQD tokens are used to reward workers for storing and serving data, ensuring data availability and reliability.
* Enable Data Access: Data consumers use $SQD tokens to query the network, with access controlled by the amount of locked $SQD tokens.
* Governance and Curation: $SQD holders participate in network governance and delegate tokens to signal the reliability of workers.

**Economic Interactions**

1. Data Queries and Processing Fees: AI processors within the Guru Network will use data aggregated from Subsquid. To access this data, they will pay processing fees in $GURU tokens. Part of these fees can be converted to $SQD tokens to compensate Subsquid workers for data retrieval and storage.
2. Staking and Rewards: Both $GURU and $SQD tokens can be staked to participate in the network. Participants can earn rewards in the form of $GURU tokens for running compute nodes and contributing AI models, while $SQD tokens can be earned by providing data services in the Subsquid Network.
3. Inter-Network Collaboration: The integration allows for seamless collaboration between the Guru Network and Subsquid, with $GURU and $SQD tokens facilitating economic interactions. For example, data consumers in the Guru Network might lock $SQD tokens to gain higher query limits, enabling more efficient data utilization for AI processes.
4. Token Liquidity and Value: The combined usage of $GURU and $SQD tokens across both networks can enhance liquidity and value. As the networks grow and more participants join, the demand for both tokens will increase, driving their economic value.

#### Closing Thoughts

While we’re still in the very early days of both AI and blockchain, their intersection remains one of the hottest narratives in crypto today. The sharing of AI agents and references throughout an ecosystem takes the open and permissionless nature of blockchain and blends it with the self-improvement models in AI and machine learning.

By combining Subsquid’s scalable data aggregation with Guru Network’s robust AI and process orchestration, the collaboration will enable more efficient, secure, and scalable blockchain-based business process automation, driving innovation and growth within the Web3 ecosystem.

### References:

1. GURU Network: Multi Chain AI Compute Layer  Available at: <https://gurunetwork.ai/assets/img/litepapper_dexguru_network.pdf>
2. Guru: Building The AI Orchestration Network  Available at: <https://gurunetwork.ai/assets/img/guru_network_architecture_whitepaper.pdf>
3. Subsquid Network whitepaper  Available at: <https://docs.subsquid.io/subsquid-network/whitepaper/>

<br>


# Smart Contracts

Significant smart contracts deployed on Guru Network

<table data-full-width="true"><thead><tr><th width="174" align="center">Contract</th><th align="center">Sepolia</th><th>Mainnet</th></tr></thead><tbody><tr><td align="center">WGURU</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0x449E8D7B54eCD0c1d53A010E5935FeA4b806f723">0x449E8D7B54eCD0c1d53A010E5935FeA4b806f723</a></td><td><a href="https://scan.gurunetwork.ai/address/0xc339E17eFD801724937A645B7e356CFA8be85279">0xc339E17eFD801724937A645B7e356CFA8be85279</a></td></tr><tr><td align="center">DEX Factory</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0x0621E1E3c8E2871D5D54d9ce16dA57c85074b422">0x0621E1E3c8E2871D5D54d9ce16dA57c85074b422</a></td><td><a href="https://scan.gurunetwork.ai/address/0x01a43Ad6C4244F820d9238d37AEc4867854c1044">0x01a43Ad6C4244F820d9238d37AEc4867854c1044</a></td></tr><tr><td align="center">DEX Router</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0xC28611B48C3987E9778D062b033b3086f9469467">0xC28611B48C3987E9778D062b033b3086f9469467</a></td><td><a href="https://scan.gurunetwork.ai/address/0xEf68B8853f1B79601617110218bA8aB14C077df2">0xEf68B8853f1B79601617110218bA8aB14C077df2</a></td></tr><tr><td align="center">Multicall3</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0xbD8c7F4064F121fa8BEA8Ac4EE1e7c9Aec8ca7bA">0xbD8c7F4064F121fa8BEA8Ac4EE1e7c9Aec8ca7bA</a></td><td><a href="https://scan.gurunetwork.ai/address/0x9dE69f908Daf532019d2DeF8f7344e6Fc872F0dc">0x9dE69f908Daf532019d2DeF8f7344e6Fc872F0dc</a></td></tr><tr><td align="center">gUSD</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0x3A0b1c2e13d4e0C10BcD3E74F70EE150dB437DD8">0x3A0b1c2e13d4e0C10BcD3E74F70EE150dB437DD8</a></td><td>Soon</td></tr><tr><td align="center">USDC.e</td><td align="center">None</td><td><a href="https://scan.gurunetwork.ai/address/0xfbf7fD738DE150c147dcaA120be96d0aB27C5a9b">0xfbf7fD738DE150c147dcaA120be96d0aB27C5a9b</a></td></tr><tr><td align="center">WETH</td><td align="center">None</td><td><a href="https://scan.gurunetwork.ai/address/0xd402ca8c735960dbb5a45975b51f7dc9f85f977e">0xd402ca8c735960dbb5a45975b51f7dc9f85f977e</a></td></tr><tr><td align="center">WGURU/gUSD pool</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0x866eE6e9335D8Cd42f677db630B976A70B7BEEa9">0x866eE6e9335D8Cd42f677db630B976A70B7BEEa9</a></td><td>Soon</td></tr><tr><td align="center">Burning Meme Factory</td><td align="center"><a href="https://scan.gurunetwork.ai/address/0x6f4A0358CeaEacdDA288093896e7f11cD8e948b7">0x6f4A0358CeaEacdDA288093896e7f11cD8e948b7</a></td><td>Soon</td></tr></tbody></table>


# Flow Orchestrator

Flow Orchestrator uses AI processors equipped with comprehensive data from Guru Data Warehouse, Block Explorer and DeFi trading terminal deployed on Guru Network

<figure><img src="/files/1EpYY6hUv8c2PQdQRO7G" alt=""><figcaption></figcaption></figure>

The Flow Orchestrator, a central component of our Web3 infrastructure, harnesses AI processors equipped with comprehensive data sourced from the Guru Data Warehouse, Analytics driven Block Explorer and DeFi trading terminal deployed on Guru Network. This setup reduces the manual complexities typically associated with Web3 technologies, which can hinder adoption and lead to user errors. By automating and battle-testing processes, the Flow Orchestrator ensures efficient blockchain orchestration within the Guru Enlightenment Network, enhancing operational efficiency and maximizing network value.

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

You can see BBPA Engine, main component of flow orchestrator in guru framework repository:&#x20;

{% embed url="<https://github.com/dex-guru/guru-framework.git>" %}


# BBPA Engines

BBPA Engines as computational nodes within the Guru Network ensure secure and efficient process automation across multiple blockchain platforms.

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

The BBPA Engines are a foundational element of the Guru Network, enhancing the automation of complex business processes across decentralized environments. Their integration with Chainlink’s Cross-Chain Interoperability Protocol (CCIP) and their role as a verifiable truth source within the Chainlink ecosystem underscore their importance in ensuring secure, reliable, and efficient process automation across multiple blockchain platforms.

In the Guru Network, the architectural framework integrates AI and blockchain technologies to streamline application development and operation. Users interact with the Flow Orchestrator, which acts as the central hub, coordinating activities across the network. It defines and dispatches business processes to the BBPA Engines, which execute these tasks with the aid of Chainlink's Cross-Chain Interoperability Protocol (CCIP) for secure and reliable data verification. AI Services are integrated within the Flow Orchestrator to enhance decision-making and process efficiency. Finally, all transactions and operational data are securely recorded on the blockchain network, providing a reliable feedback loop to users and supporting the network's overall functionality.

Architectural Overview: BBPA Engines are designed as computational nodes within the Guru Network, providing essential computational results for automated processes. The BBPA Engine Declaration Smart Contract is deployed on the Guru Network and serves as an oracle interface into the BBPA Engine System Event Bus. This setup allows the BBPA Engines to interact seamlessly with various components of the network, facilitating efficient and secure On-Chain/Off-Chain/AI processes automation.

Deployment and Integration with CCIP: The Process Definition Smart Contracts, which utilize the computational results from the BBPA Engines, can be deployed on any blockchain platform supported by Chainlink’s CCIP. This deployment strategy ensures that the BBPA Engines can report and trigger actions across multiple blockchain environments. The CCIP ability to transfer value (ERC-20 Tokens) along with message enhancing the versatility and utility of BBPA Processes for multi-chain/Off-Chain actions.

Role Within of BBPA Engines in Chainlink Ecosystem: BBPA Engines acting within the Chainlink ecosystem as advanced and easy to compose web services that provide verifiable truth sources for automated processes. BBPA Engines running the same process definitions can ensure consistency by reaching the "same state," with any biased data excluded through CCIP’s aggregation mechanisms. Architecture allows support of optional N sufficient decentralization (based on business application), where N specifies number of BBPA engines running process definition, and passed over as part of computation request. That enables consistency which is vital for maintaining the integrity and reliability of the process automation across various blockchains.

Synchronization and Consistency Mechanisms: To maintain high levels of consistency and reliability, the BBPA Engines would employ sophisticated synchronization mechanisms managed by sequencers within the Guru Network. These sequencers coordinate the execution of processes, ensuring that all BBPA Engines across different blockchains can achieve and maintain a synchronized state. This coordination is essential for the decentralized verification of process states, making BBPA Engines a reliable source of truth within the network.

Verifiable Truth Source and Base Truth Oracle: As BBPA Engines achieve sufficient decentralization, they can serve as a Base Truth Oracle within the context of specific AI Processors. This Base Truth Oracle is crucial for excluding hallucinative responses from Language Learning Models (LLMs) and maintaining relevance within automated responses. By serving as a Base Truth Oracle, BBPA Engines enhance the accuracy and relevance of AI-driven processes, ensuring that the automated decisions are based on verified and reliable data.


# Tasklist

The BBPA Engine orchestrates Agents Tasks and Gurus Tasks through both Web2 (REST API) and Web3 (BBPM Process Instance SC Variables) interfaces.

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

The BBPA Engine orchestrates two main types of tasks externally: Individual Agents(IA) Tasks and Gurus Tasks, those are divided based on functionality:

* Generic Individual Agents (IA) Tasks: These are queues for IA Lambda functions that handle AI Compute, comprehensive interaction scripts, or non-custodial transaction execution on the blockchain. These tasks facilitate the processing and execution of complex data and transactions, integrating seamlessly with various AI-driven processes.
* Gurus Tasks: Presented within the user’s task list, these tasks function as user interaction and feedback UI elements across integrated frontends and chatbots. This setup enhances off-chain orchestration of routines and business processes through an easy-to-use interface that has been extensively tested across thousands of integrations in traditional finance (TradFi) businesses utilizing BPMN-based BPA systems.
* Gurus Web3 Tasks: This task type provides a user transaction builder interface, which orchestrates the transaction process and prompts users to complete tasks through their wallet. This functionality allows for the encapsulation of various DeFi routines into a single decision point, which can be automated through an IA Non-Custodial Worker implementation.
* Non-Custodial Individual Agents (IA) Tasks: These tasks are designed for automated signing and execution by a container running on the user’s controlled hardware. They enable different scenarios for automating crypto activities, enhanced by AI processors, allowing for sophisticated, secure crypto operations. Example here could be wrapped[ Guru DeFi Meta Aggregation API](https://github.com/dex-guru/meta-aggregation-api)\[11] wrapped as Individual agent operating in non custodial fashion.

Access to these tasks, whether in their current state or a form optimized for integration, is provided through both Web2 (REST API) and Web3 (BBPM Process Instance SC Variables) interfaces. The choice of interface depends on the deployers' need for decentralization mechanisms, offering flexibility in how tasks are managed and executed within the Flow Orchesrtator.

<br>


# Shared Event Bus

Functionality and Integration with Oracles Data Flow and Accessibility

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


# Individual Agents

Individual Agents are computational workhorses and integral economic units within Guru Network, receiving fees for successfully completed tasks, with the original liquidity sourced from the CCIP layer

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

Individual Agents represent a core technological and economic component of the Guru Network, enabling sophisticated, blockchain-integrated computational services that drive the network's automation and operational capabilities. Their role as AI compute engines among other functionalities underscores the innovative approach to decentralized process automation and economic incentivation. These agents function similarly to AWS Lambda functions with non-custodial execution in Individual Agent Owner Cloud or On-premises environments. Agents integrated into the blockchain environment through process definition smart contracts. They can serve roles as AI compute engines among other functionalities.

<figure><img src="/files/40Xh47nQiURpgGuUEyTu" alt=""><figcaption></figcaption></figure>

Individual AI Agents are central to the operation and success of the Guru Network, driving innovation and efficiency through the strategic integration of AI and blockchain technologies. This synergy enhances the network's capabilities, making it not only a powerful platform today but also a resilient and scalable system for the future.

This section explores how these agents subscribe to tasks, execute various operations, and interact within the Guru Network's economic framework.

Architecture of Individual Agents:

Individual Agents in the Guru Network are designed as flexible, event-driven computational units that respond to specific tasks issued by the BBPA Engines. Tasks Queues are declared within process definition smart contracts, which can be deployed on any blockchain platform supported by Chainlink’s Cross-Chain Interoperability Protocol (CCIP).

* Process Definition Smart Contracts: Each contract specifies the topics of the task queue to which Individual Agents can subscribe. This setup provides a structured and secure method for agents to receive tasks relevant to their capabilities and designated roles within the network.\ <br>
* Subscription: To become active participants in the Guru Network, Individual Agents subscribe to task queues via transactions against the /subscribe method of the process definition smart contract. This subscription effectively upgrades their role, allowing them to receive and execute tasks distributed by the BBPA Engines.\ <br>
* Task Execution: The tasks assigned to these agents can vary widely, including executing AI model requests, performing non-custodial transactions, or calculating buy/sell signals based on complex trading strategies and indicators. The versatility of these tasks underscores the robust capability of Individual Agents to handle diverse computational demands.\ <br>

Actions Available for Individual Agents

Individual Agents have several actions available to manage tasks effectively within the network. These actions are executed On-Chain and Off Chain against the BBPA Engine by the agents:

* /lock: Secures a task for a specific period of time or until execution. If an Individual Agent cannot complete the task within the specified time (less than time-to-live, TTL), the task is returned to the queue, and the agent is penalized.
* /complete: Marks a task as completed and submits the results to the BBPA Engine and subsequently into the DON network in an aggregated view from the process instance.
* /error: Reports any computational errors or misconfigurations of tasks.
* /publish: If an Individual Agent is chosen by a round-robin mechanism to publish results on-chain, this action facilitates the publishing of results against the BBPA Engine at the same time as an on-chain transaction is submitted on the chain where the BBPMN definition is deployed.

Individual Agents can sign transactions with their passphrase, as they are executed in their own controlled secured environment. This setup allows for non-custodial execution of transactions using the Individual Agents interface.

Economic Integration and Fee Structure

Individual Agents are not only computational workhorses but also integral economic units within the Guru Network. They receive fees for successfully completing tasks, with the original liquidity sourced from the CCIP layer in the form of LINK tokens. These tokens can be locked in the process definition smart contract against Guru tokens, which serve multiple financial roles within the network.

The Guru token acts as a value holder for the fees paid to Individual Agents, ensuring a stable and predictable economic environment. Each task orchestrated within the BBPMN Process has a price nominated in Guru tokens, akin to gas fees in traditional blockchain transactions. This pricing mechanism ensures that all transactions and computations are compensated fairly, promoting sustained participation and growth of the network's capabilities.

Scalability, Security and Network Health

Ensuring the security and compliance of Individual Agents is paramount, given their ability to execute sensitive and potentially high-stake operations. The Guru Network implements rigorous security protocols to authenticate and authorize agents, maintaining a trusted environment for all participants. The decentralized nature of Individual Agents allows the Guru Network to scale efficiently as demand increases. New agents can be added seamlessly, enhancing the network's capacity to handle more tasks without compromising performance or security.

* Data Integrity and Security: Robust cryptographic techniques are employed to secure communications and transactions between Individual Agents and other network components, protecting against unauthorized access and ensuring data integrity.\ <br>
* Balancing the Ecosystem: The interplay between LINK and Guru tokens within this framework not only facilitates economic transactions but also helps balance the overall Guru Network ecosystem, ensuring stability and fostering growth.\ <br>

#### Individual Agents Example Applications

Integration of AI and Blockchain in the Guru Network

The fusion of AI and blockchain technologies within the Guru Network creates a robust framework for enhancing decision-making and data processing capabilities. This hybrid architecture leverages the strengths of both technologies, leading to operations that are not only more secure and efficient but also highly scalable.

* Hybrid Architectures: The BBPA Engines integrate AI to enhance data analysis and decision-making processes, ensuring that operations are both intelligent and immutable. This integration provides a strong defense mechanism against fraud and errors, making the network more resilient.\ <br>
* Decentralization and Security: The decentralized nature of blockchain significantly enhances the security of AI operations. By distributing data and processing across multiple nodes, the network prevents single points of failure and ensures that AI-driven decisions are both transparent and tamper-proof.\ <br>

AI-Driven Data Analysis and Decision Making

AI Agents act as decision support systems within the Guru Network, providing advanced data analysis capabilities that surpass traditional methods.

* AI as a Decision Support System: Individual AI Agents analyze vast amounts of data to provide insights that aid in complex decision-making processes. These insights are backed by the immutable records of the blockchain, ensuring their accuracy and reliability.\ <br>
* Automated Responses and Adaptations: AI Agents can automatically respond to changes in market conditions or network demands. This capability ensures that the Guru Network remains optimal in its performance, dynamically adapting to internal and external shifts without compromising security or efficiency.\ <br>

Verifiable Truth and Data Integrity

As it was mentioned in \[5], the integration of AI with blockchain's cryptographic tools ensures that all operations conducted by AI Agents are based on verifiable and immutable data.

* Cryptographic Truth: The concept of cryptographic truth is pivotal in AI operations, where decisions must be based on data that is not only accurate but also secure from tampering. This is ensured through cryptographic verifications that validate every piece of data before it is processed by AI.\ <br>
* Blockchain as a Trust Anchor: Blockchain technology serves as a trust anchor in the Guru Network, providing a solid foundation for AI analyses and decisions. This layer of trust is crucial for maintaining the integrity and reliability of operations, especially when sensitive data is involved.\ <br>

Future Proofing and Scalability

The combination of AI and blockchain not only addresses current needs but also prepares the Guru Network for future challenges and opportunities.

* Scalability through AI and Blockchain: By leveraging AI for efficient resource management and predictive capabilities, alongside blockchain for its robustness and security features, the Guru Network is well-positioned to scale effectively. This scalability extends to handling increased transactions, more complex operations, and growing user bases.\ <br>

Adaptability to Regulatory and Technological Changes: The Guru Network is designed to be flexible in the face of regulatory and technological shifts. This adaptability ensures that the network remains compliant and relevant, even as the landscapes of blockchain and AI evolve.<br>


# Framework

Set of tools and libraries that simplify the integration of AI and blockchain technologies, enhancing the capabilities and scalability of your projects

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

**Overview**

The Guru Framework SDK is designed to facilitate the development, deployment, and management of decentralized applications (dApps) and automated processes within the Guru Network. It provides a set of tools and libraries that simplify the integration of AI and blockchain technologies, enhancing the capabilities and scalability of your projects.

**Key Features**

* **Flow Orchestrator Integration**
  * Seamlessly integrate with the Flow Orchestrator to manage and automate complex workflows.
  * Support for BPMN (Business Process Model and Notation) to define and execute process flows.
* **BBPA Engines**
  * Access and control Blockchain Business Process Automation (BBPA) Engines for efficient process management.
  * Tools for deploying and synchronizing smart contracts across multiple chains.
* **Unified API**
  * A comprehensive API that bridges Web2 and Web3 environments, enabling smooth data and process interactions.
  * Simplified access to on-chain and off-chain resources.
* **Individual Agents**
  * Create and manage Individual Agents for non-custodial execution and compute tasks.
  * Integration with AI models for enhanced decision-making and automation.
* **Event Bus**
  * Utilize the shared Event Bus for real-time data synchronization and process orchestration.
  * Query and interact with on-chain data through oracle interfaces.


# Setup and Configuration

Environment Setup Dependencies and Initial Configuration

**Installation**

To install the Guru Framework SDK, follow these steps:

1. **Clone the Repository**

   ```bash
   git clone https://github.com/dex-guru/guru-framework.git
   cd guru-framework
   ```


# Data Warehouse API

Detailed REST API Guide Web3 Interactions and Smart Contracts

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

### Overview

The Warehouse API provides developers and builders with a robust and scalable solution for managing warehouse operations efficiently. This API allows seamless integration with existing systems, enabling streamlined inventory management, order processing, and real-time data synchronization.

#### Key Benefits

1. **Scalability**: Easily handle increasing data volumes and transaction loads without compromising performance.
2. **Efficiency**: Automate and optimize warehouse processes to reduce manual effort and errors.
3. **Real-Time Data**: Access up-to-date information on inventory levels, order status, and more.
4. **Integration**: Seamlessly connect with other systems and applications for a unified operational workflow.

#### Functionalities

* **Inventory Management**: Track and manage stock levels, locations, and movements within the warehouse.
* **Order Processing**: Efficiently handle order creation, picking, packing, and shipping operations.
* **Real-Time Updates**: Receive real-time notifications and updates on inventory and order statuses.
* **Reporting and Analytics**: Generate comprehensive reports and analytics for better decision-making.

#### 🔑 Authorization

To start using the Warehouse API, all you need is an API key. Go to developers.warehouseapi.com, connect your web3 wallet, create a project, and copy your API key. This API key is all you need to start receiving reliable warehouse data.

There are two ways to authorize your API request. Instead of `YOUR_API_KEY`, use the key you got at developers.warehouseapi.com:

1. **Query Parameter**

   ```shell
   curl http://warehouse-api.xfi.ms/v1/inventory?api-key=YOUR_API_KEY
   ```
2. **Authorization Header**

   ```shell
   curl http://warehouse-api.xfi.ms/v1/inventory -H 'api-key: YOUR_API_KEY'
   ```

#### 📝 Supported Chains

List of supported networks with the corresponding ChainID:

* **Ethereum**: 1
* **BSC**: 56
* **Polygon**: 137
* **Avalanche**: 43114
* **Arbitrum**: 42161
* **Fantom**: 250
* **CELO**: 42220
* **Optimism**: 10
* **Gnosis**: 100
* **Canto**: 7000
* **Arbitrum Nova**: 42170

For a full list of chains supported, please use the Get All Chains endpoint. For the list of Chain\_IDs, you can refer to [Chainlist](https://chainlist.org/).

#### 🚦 Free Tier Plan Limitations

Our API is free for personal use, with a few limitations listed below:

* **200,000 calls per month**
* **5 RPS (Requests Per Second)**
* **300 seconds delay for data updates**

Premium API plan for commercial usage is $199 per month, which includes 1 million API calls. Any additional 1 million API calls will cost an extra $25. We accept payments via credit card, including Visa, Mastercard, and American Express. You can start a free trial at our developers console. Please reach out here if you have any questions about the Premium API plan.

#### 📈 FAQ

**Q: Why can I not access all historical data about a certain item?**\
A: For the time being, we currently index and display transaction data only from the date/time they are implemented. This means all transactions that occurred before the implementation date will not be included in transaction lists, aggregates/counts, and charts that involve the pre-implementation time period. You can find the list of implemented features and their dates at our documentation.

**Q: How often is data updated?**\
A: Currently, for the Free Tier Plan, there is a 300 seconds delay on all data updates.

**Q: Am I sending too many requests?**\
A: The rate limit is 5 concurrent requests per second.

**Q: I only receive 20 transactions in the response. How can I look at older transactions?**\
A: Use the `limit` and `offset` query parameters to use pagination. Using the `offset` parameter, you can specify where to start a page. Using the `limit` parameter, you can specify the page size.

Some parameters can be unclear. Below are their descriptions:

* **chain\_id**: You can look up chain IDs for any EVM-powered network by going to [Chainlist](https://chainlist.org/).
* **verified**: We use Token Lists to identify verified tokens. A token is considered verified if present in at least one Token List. For ERC-20 tokens, we use [Token Lists](https://tokenlists.org/). For more info, go to our documentation.
* **limit**: This is a parameter used for pagination. Use it to specify the page size. Learn more about pagination here.
* **offset**: This is a parameter used for pagination. Use it to specify where to start a page. Learn more about pagination here.

**Wallet Category**:

* **heavy**: Heavy Trader with $500k+ of trading volume in the last 30 days.
* **medium**: Active Trader with $100k-$500k of trading volume in the last 30 days.
* **casual**: Casual Trader with $10k-$100k of trading volume in the last 30 days.
* **bot**: Trader with 1000+ transactions in the last 30 days. Most likely a bot.
* **noob**: All other wallet addresses.

#### 💬 Support

Need help with our API or want to provide some feedback? Join our Community Discord Server and head to the #api-questions channel, where you can chat with fellow builders!

We're excited you're here! 💙


# Block Explorer

Brief welcome overview of our xfi network block explorer: https\://scan.xfi.ms/

The block explorer has slightly expanded tool set including other dex.guru’s ecosystem tools.

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

{% embed url="<https://scan.xfi.ms/>" %}

Basic features are similar to well known explorer’s services such as block (1), transaction(2), or chain (3) info.

<figure><img src="/files/4OJGkQpZ8Qyvkz7kRCAL" alt=""><figcaption></figcaption></figure>

{% embed url="<https://scan.xfi.ms/blocks>" %}

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

{% embed url="<https://scan.xfi.ms/txs>" %}

<figure><img src="/files/2R4meNXnRcyWugFcuQ1k" alt=""><figcaption></figcaption></figure>

{% embed url="<https://scan.xfi.ms/chain>" %}

Top ERC-20 top tokens (1) and ERC-20 top tokens txs (2) (tba)

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

{% embed url="<https://scan.xfi.ms/tokens>" %}

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

{% embed url="<https://scan.xfi.ms/tokentxns>" %}

With Developers Console (1) you get the access to our data API. On verification page(2) you can  verify any network related contract. In a warehouse (3) you can play with a data making queries and building dashboards, as it is briefly described on a dedicated [docs page](/framework/warehouse/getting-started).

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

{% embed url="<https://developers.dex.guru/>" %}

<figure><img src="/files/23C8fqofMXU2zrEsOzIS" alt=""><figcaption></figcaption></figure>

{% embed url="<https://scan.xfi.ms/verifyContract>" %}

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

{% embed url="<https://warehouse.xfi.ms/>" %}

Finally on a dex.guru(1) you can get vibrant dashboards with aggregated data from dexs statistics. So as gas tracker (2), and dashboards made at and published from our warehouse.

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

{% embed url="<https://dex.guru/markets?chain=xfi_test>" %}

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

{% embed url="<https://scan.xfi.ms/gastracker>" %}

<figure><img src="/files/6UQnqZl1PaMMSXtMbi9f" alt=""><figcaption></figcaption></figure>

{% embed url="<https://scan.xfi.ms/charts?tab=blockchain-data>" %}


# Indexer

Guru Network Indexer

[**https://github.com/dex-guru/ethereum-etl**](https://github.com/dex-guru/ethereum-etl)

### **Overview**

The blockchain indexer is a powerful and efficient tool written in Python, forked from the [original open-source project](https://github.com/blockchain-etl/ethereum-etl). This enhanced indexer is a core component used across all GuruNetwork.ai products, providing a robust solution for real-time indexing and querying blockchain data.

**Key Enhancements**

1. **New Entity Types**: Unlike the original indexer, our version supports several new entity types like dex trades and token balances, offering greater flexibility and depth in the data indexing process. This allows for a more comprehensive capture of blockchain events and states, facilitating advanced analytics and insights.
2. **Parallel Processing**: The indexer can be paralleled between multiple workers, significantly improving the indexing speed and efficiency. This parallel processing capability is achieved through the integration of RabbitMQ queues, enabling distributed task handling and coordination among workers. As a result, the indexer can handle large volumes of blockchain data with ease, ensuring timely updates and minimizing latency.
3. **Integration with GuruNetwork.ai Products**: Seamlessly integrated into the GuruNetwork.ai ecosystem, the indexer enhances the performance and functionality of our products. By providing accurate and up-to-date blockchain data, it supports various applications, from blockchain analytics to decentralized finance (DeFi) solutions.&#x20;
4. **Community Participation**: The open-source nature of the indexer encourages community participation. Developers can contribute by adding new features, supporting additional blockchain networks, decentralized exchanges (DEXes), and other integrations. These community-driven enhancements ensure that GuruNetwork.ai products remain cutting-edge and responsive to the evolving needs of the blockchain space.

[**https://github.com/dex-guru/ethereum-etl**](https://github.com/dex-guru/ethereum-etl)

### **Overview**

The blockchain indexer is a powerful and efficient tool written in Python, forked from the [original open-source project](https://github.com/blockchain-etl/ethereum-etl). This enhanced indexer is a core component used across all GuruNetwork.ai products, providing a robust solution for real-time indexing and querying blockchain data.

**Key Enhancements**

1. **New Entity Types**: Unlike the original indexer, our version supports several new entity types like dex trades and token balances, offering greater flexibility and depth in the data indexing process. This allows for a more comprehensive capture of blockchain events and states, facilitating advanced analytics and insights.
2. **Parallel Processing**: The indexer can be paralleled between multiple workers, significantly improving the indexing speed and efficiency. This parallel processing capability is achieved through the integration of RabbitMQ queues, enabling distributed task handling and coordination among workers. As a result, the indexer can handle large volumes of blockchain data with ease, ensuring timely updates and minimizing latency.
3. **Integration with GuruNetwork.ai Products**: Seamlessly integrated into the GuruNetwork.ai ecosystem, the indexer enhances the performance and functionality of our products. By providing accurate and up-to-date blockchain data, it supports various applications, from blockchain analytics to decentralized finance (DeFi) solutions.&#x20;
4. **Community Participation**: The open-source nature of the indexer encourages community participation. Developers can contribute by adding new features, supporting additional blockchain networks, decentralized exchanges (DEXes), and other integrations. These community-driven enhancements ensure that GuruNetwork.ai products remain cutting-edge and responsive to the evolving needs of the blockchain space.

***

### Useful Links

* [Schema](https://github.com/dex-guru/ethereum-etl/blob/main/db/migrations/schema.sql)
* [Command Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md)


# Run the Indexer

How to run Guru Network Indexer

### Quickstart

<figure><img src="/files/8xyTTj4gpldrboNxoAZR" alt=""><figcaption><p>How it works</p></figcaption></figure>

**Prerequisites**

Ensure you have the following installed:

* Docker
* Docker Compose

**Step-by-Step Instructions**

1. **Prepare Environment Variables**
   * Copy the `env.sample` file and rename it to `.env`.
   * Edit the `.env` file to set the following variables according to your needs:
     * `CHAIN_ID`: The ID of the blockchain network you are indexing.
     * `DATABASE`: The name of the database that will be created in ClickHouse.
     * `PROVIDER_URL`: The URL of your RPC provider, such as a public node, Infura, or a local node.
   * See [Environment Variables](broken://pages/6fCAFM5Si7d2PUW4qnoe)
2. **Start Indexing**
   * Open your terminal and navigate to the directory containing your `docker-compose.yml` file.
   * Run the command:

     ```sh
     docker-compose up
     ```
   * This command will start indexing the Ethereum blockchain into ClickHouse.
3. **Verify Database Content**
   * Once the indexing process begins, you can inspect the database to see the tables created for each entity type and a few service-related tables.

#### Running certain command

Install Ethereum ETL:

```
pip3 install -r requirements.txt
```

:warning: If you want to use Clickhouse as a destination, make sure to apply migrations:

```
CLICKHOUSE_URL=clickhouse+http://default:@localhost:8123/ethereum alembic upgrade head 
```

Export blocks and transactions ([Schema](https://github.com/dex-guru/ethereum-etl/blob/main/db/migrations/schema.sql), [Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md#export_blocks_and_transactions)):

```
ethereumetl export_blocks_and_transactions --start-block 0 --end-block 500000 \
--blocks-output blocks.csv --transactions-output transactions.csv \
--provider-uri https://mainnet.infura.io/v3/${INFURA_API_KEY}
```

Export ERC20 and ERC721 transfers ([Schema](https://github.com/dex-guru/ethereum-etl/blob/main/docs/schema.md#token_transferscsv), [Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md##export_token_transfers)):

```
ethereumetl export_token_transfers --start-block 0 --end-block 500000 \
--provider-uri file://$HOME/Library/Ethereum/geth.ipc --output token_transfers.csv
```

Export traces ([Schema](https://github.com/dex-guru/ethereum-etl/blob/main/docs/schema.md#tracescsv), [Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md#export_traces)):

```
ethereumetl export_traces --start-block 0 --end-block 500000 \
--provider-uri file://$HOME/Library/Ethereum/parity.ipc --output traces.csv
```

***

Stream blocks, transactions, logs, token\_transfers continually to console ([Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md#stream)):

```
ethereumetl stream --start-block 500000 -e block,transaction,log,token_transfer --log-file log.txt \
--provider-uri https://mainnet.infura.io/v3/7aef3f0cd1f64408b163814b22cc643c
```

Find other commands [here](https://github.com/dex-guru/ethereum-etl/blob/main/ethereumetl/cli).

Supported export destinations [here](broken://pages/6fCAFM5Si7d2PUW4qnoe#output).

### Linters/formatters

#### Install

```
pip install black ruff mypy
```

#### Run

all-at-once run and fix:

```
ruff check --fix . && black . && mypy .
```

Or one-by-one:

* Check and auto-fix with: `ruff --fix .`
* Check typing: `mypy .`
* Auto-format all: `black .`

### Useful Links

* [Schema](https://github.com/dex-guru/ethereum-etl/blob/main/db/migrations/schema.sql)
* [Command Reference](https://github.com/dex-guru/ethereum-etl/blob/main/docs/commands.md)


# Environment Variables

Environment Variables for Guru Network Indexer

### OUTPUT

Ethereum ETL supports a variety of item exporters, which are classes that write items to specified destinations. To configure an item exporter, set the `OUTPUT` environment variable. You can specify multiple outputs at once using the format: \
&#x20;`OUTPUT=exporter_name://path,second_exporter://path_to_second_destination`.

Here are the item exporters available out of the box and how to set them up:

<table><thead><tr><th width="189">Exporter</th><th width="202">Configuration</th><th>Example Value</th></tr></thead><tbody><tr><td><strong>CONSOLE</strong></td><td>Output to the console</td><td><code>OUTPUT=console</code> or <code>OUTPUT=None</code></td></tr><tr><td><strong>JSON</strong></td><td>Output to a JSON file</td><td><code>OUTPUT=path_to_output.json</code></td></tr><tr><td><strong>CSV</strong></td><td>Output to a CSV file</td><td><code>OUTPUT=path_to_output.csv</code></td></tr><tr><td><strong>PROJECTS</strong></td><td>Output to Google Cloud Projects</td><td><code>OUTPUT=projects://path_to_google_cloud_project</code></td></tr><tr><td><strong>KINESIS</strong></td><td>Output to AWS Kinesis stream</td><td><code>OUTPUT=kinesis://stream_name</code></td></tr><tr><td><strong>KAFKA</strong></td><td>Output to Apache Kafka topic</td><td><code>OUTPUT=kafka://topic</code></td></tr><tr><td><strong>POSTGRES</strong></td><td>Output to PostgreSQL database</td><td><code>OUTPUT=postgresql://user:password@host:port/dbname</code></td></tr><tr><td><strong>GCS</strong></td><td>Output to Google Cloud Storage bucket</td><td><code>OUTPUT=gs://bucket_name</code></td></tr><tr><td><strong>CLICKHOUSE</strong></td><td>Output to ClickHouse database</td><td><code>OUTPUT=clickhouse+http://host:port/dbname</code></td></tr><tr><td><strong>AMQP</strong></td><td>Output to AMQP message broker</td><td><code>OUTPUT=amqp://user:password@host:port/vhost</code> or <code>OUTPUT=rabbitmq://user:password@host:port/vhost</code></td></tr><tr><td><strong>ELASTICSEARCH</strong></td><td>Output to Elasticsearch index</td><td><code>OUTPUT=elasticsearch+http://host:port/index_name</code> or <code>OUTPUT=elasticsearch+https://user:password@host:9200/index_name</code></td></tr></tbody></table>

### DATABASE

Optional, is used when Clickhouse is in OUTPUT. Specifies the name of the ClickHouse database. You can choose any name.

### PROVIDER\_URL

The URL of your RPC provider (public node, Infura, local node, etc.). `PROVIDER_URL=https://ethereum-rpc.publicnode.com`

### LAST\_SYNCED\_BLOCK\_PROVIDER

Optional, if not set, a local file will be used. The provider used to sync the last indexed block (local file, Redis, SQL database).

`LAST_SYNCED_BLOCK_PROVIDER=redis://redis:6379`

`LAST_SYNCED_BLOCK_PROVIDER=clickhouse+http://clickouse:8123/database_name`

### EXPORT\_FROM\_CLICKHOUSE

Optional. If set, the indexer will export entities from ClickHouse first and fallback to the node if necessary. Useful for indexed tokens and pools or multiple indexers.

`EXPORT_FROM_CLICKHOUSE=clickhouse+http://clickhouse-2:8123/db_same_blockchain`

### START\_BLOCK

The block number to start indexing from. It can be set as the latest block. If the block number from the `LAST_SYNCED_BLOCK_PROVIDER` is greater than `START_BLOCK`, then the last synced block will be used. Examples:

`START_BLOCK='latest' or START_BLOCK=1337`

### END\_BLOCK

(Optional) The block number to stop indexing. If not set, indexing continues indefinitely.

### ENTITY\_TYPES

A comma-separated list of entities to export

`ENTITY_TYPES=block,transaction,token_transfer`

| Entity                     | Description                                                           |
| -------------------------- | --------------------------------------------------------------------- |
| block                      | Information about each block in the blockchain.                       |
| transaction                | Data related to individual transactions.                              |
| receipt                    | Receipts for each transaction, including status and gas used.         |
| log                        | Logs generated by smart contract events during transactions.          |
| token\_transfer            | Transfers of ERC-20, ERC-721, and other tokens.                       |
| geth\_trace                | Call traces from the Geth Ethereum client.                            |
| contract                   | Information about smart contracts deployed on the blockchain.         |
| token                      | Metadata and details about tokens.                                    |
| internal\_transfer         | Internal Ether transfers within the blockchain.                       |
| token\_balance             | Balances of tokens held by addresses.                                 |
| error                      | Errors encountered during indexing.                                   |
| native\_balance            | Balances of native cryptocurrency (e.g., Ether) held by addresses.    |
| token\_transfer\_priced    | Priced transfers of tokens, including valuation.                      |
| internal\_transfer\_priced | Priced internal transfers, including valuation.                       |
| dex\_pool                  | Information about decentralized exchange (DEX) liquidity pools.       |
| enriched\_dex\_trade       | Enhanced details about DEX trades, including additional context.      |
| enriched\_transfer         | Enhanced details about token transfers, including additional context. |


# Parallel Indexing using RabbitMQ

By parallelizing the indexing process, you can significantly reduce the time required to index blockchain data

### Parallelizing Indexing with RabbitMQ

Due to the need to index many entities, the process can take significant time for each block. To achieve real-time indexing, a smaller set of entities can be indexed separately by different workers. After indexing a block, the resulting objects are sent to RabbitMQ. Each type of entity has its own routing key, ensuring the message is delivered to the appropriate queue while maintaining indexing order.

For example, to index logs, blocks and transactions are required. In the first worker, indexed blocks and transactions are sent to RabbitMQ with the routing key `block`. The second worker, which has its own queue configured for the routing key `block`, receives this message and starts indexing logs using the already indexed blocks and transactions. Meanwhile, the first worker continues indexing the next set of blocks.

**Steps for Parallel Indexing**

1. **Set Up RabbitMQ Queues and Routing Keys**
   * Define queues for each entity type.
   * Assign a routing key for each entity type to ensure messages are delivered to the correct queue.
2. **Configure Workers**
   * Assign specific entities to be indexed by each worker.
   * Ensure each worker listens to the appropriate RabbitMQ queue.
   * There must be one worker for the RabbiMQ messaging trigger.&#x20;
3. **Indexing Workflow**
   * **Worker 1**: Indexes blocks and transactions, then sends the indexed data to RabbitMQ with the routing key `block`.
   * **Worker 2**: Listens to the queue for `block` routing key, receives the indexed blocks and transactions, and begins indexing logs.
   * **Worker 1**: Continues to index the next set of blocks and transactions in parallel.

This approach allows for efficient and scalable real-time indexing, leveraging RabbitMQ for task distribution and coordination among workers.

By parallelizing the indexing process, you can significantly reduce the time required to index blockchain data, ensuring timely and accurate updates across your GuruNetwork.ai products.

### How GURU run it

<figure><img src="/files/KNEvZ53Inrr47LWdQfgW" alt=""><figcaption><p>Parallel indexing at dex.guru</p></figcaption></figure>

The attached diagram illustrates the data flow and the critical role of RabbitMQ in enabling parallel indexing. This workflow has proven to be the most efficient for our operations at [dex.guru](https://dex.guru). Here's a detailed breakdown:

1. **stream.py**:
   * Responsible for streaming blocks, transactions, and logs.
   * Outputs the data to RabbitMQ with the exchange `ethereumetl_{chain_id}`.
2. **RabbitMQ**:
   * Manages the routing of messages based on routing keys.
3. **Workers**:
   * **Token Transfer Worker**: Listens to the `block` routing key, processes token transfers, and outputs data to ClickHouse and RabbitMQ.
   * **DEX Pool Worker**: Listens to the `block` routing key, processes DEX pools, and outputs data to ClickHouse.
   * **Geth Trace Worker**: Listens to the `block` routing key, processes geth traces, and outputs data to ClickHouse and RabbitMQ.
4. **Subsequent Processing**:
   * **Balance and Token Workers**: Listen to token transfer messages and process balances and tokens, outputting data to ClickHouse.
   * **Enriched Data Workers**: Process enriched DEX trades and transfers.
   * **Native Balance and Contract Workers**: Listen to internal transfers and process native balances and contracts, outputting data to ClickHouse.
5. **Dead Letter Queue (DLQ)**:
   * Handles unhandled errors by routing them to the DLQ for further inspection and retry.

This system ensures that each type of entity is processed by a dedicated worker, allowing for efficient and scalable real-time indexing.

### Improving the Messaging Mechanism

Currently, the messaging system operates primarily as a trigger, and the necessary data for the worker is fetched from ClickHouse. While this setup is functional, there is significant room for improvement. By transitioning to a system where data is directly retrieved from the messages themselves, we can enhance efficiency and reduce latency.

We invite the community to contribute to this enhancement. Your participation in developing and refining this mechanism will be greatly appreciated and beneficial to all users of [GuruNetwork.ai](https://gurunetwork.ai) products.


# Swap

Our swap features include very basic swap, pair creation and liquidity adding, and dex.guru dedicated charts.

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

{% embed url="<https://crossfi-swap.dex.guru/#/swap>" %}

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

{% embed url="<https://crossfi-swap.dex.guru/#/pool>" %}

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

{% embed url="<https://dex.guru/token/eth/0x467bccd9d29f223bce8043b84e8c8b282827790f>" %}


# Warehouse

Dex.guru Warehouse, is the product where you can compose any queries against feature rich data and combine queries to a dashboards and API for dApps.

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


# Getting Started

Data Warehouse showcase with a simple use case.

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

{% embed url="<https://warehouse.xfi.ms>" %}

You can create QUERIES (1), create DASHBOARDS (2) combining queries and visualizations built for them, TAG (3) them, and PUBLISH (4) for  public usage. Queries should be published in order to be available for dashboards and public. Dashboards should be published in order to be available from outside. Let’s take a look for a “XFI Pools Activity” (5) dashboard for example.

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

{% embed url="<https://warehouse.xfi.ms/dashboards?order=-created_at&page=1&page_size=20>" fullWidth="false" %}

Here we have a set of QUERY DASHBOARDS (1), global params for dashboards (2),  and REFRESH rate (3). In order to go down to the QUERY (4), select it from DROPDOWN (5).

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

{% embed url="<https://warehouse.xfi.ms/dashboards/xfi_pools_activity?p_dates=d_last_month&p_limit=100&p_network=xfi_test>" %}

On a query page there is a SQL QUERY (1) with PARAMS (2). On a left you can find a LIST OF TABLES (3) for a network, and select REQUIRED TABLE (4). Query result is found in a TABLE (5). Next, take a look at VISUALIZATION (6).

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

```sql
WITH
    toUnixTimestamp(toString('{{dates.start}}')) AS dateStart,
    toUnixTimestamp(toString('{{dates.end}}')) AS dateEnd
SELECT 
    pool_address,
    wallet_address,
    DATE(block_timestamp) as timestamp,
    CAST(token_addresses[1] as CHAR) as tokenFrom,
    CAST(token_addresses[2] as CHAR) as tokenTo,
    amounts[1] as tokenFromAmount,
    amounts[2] as tokenToAmount,
    transaction_type
FROM xfi_test.dex_trades
```

{% embed url="<https://warehouse.xfi.ms/queries/85/source?p_dates=d_last_month#130>" %}

Go down the VISUALIZATION CONFIG (1, 2), select CHART (3) type and choose required AXIS AND PARAMS (4). There’s a variety of dashboards you can build (5).

<figure><img src="/files/6AjDQiBo9IIIXhdZkcM8" alt=""><figcaption></figcaption></figure>

Query can be used via REST (1), dashboard can be published via URL (2).

<div data-full-width="true"><figure><img src="/files/yyxZ1aDGfOE1h5wZpmmu" alt=""><figcaption></figcaption></figure></div>

{% embed url="<https://warehouse.xfi.ms/queries/85/source?p_dates=d_last_month#-1>" %}

{% code title="CURL" overflow="wrap" %}

```
curl -X POST 'https://api.dev.dex.guru/wh/xfi_addresses_interaction?api_key=sTa5PAljgZuakDAojY8YipKcUq0jHQH2mI8xKlxn' -H 'Content-Type: application/json' --data '{"parameters": {"dates":"d_last_month"}}'
```

{% endcode %}

{% code title="JS" overflow="wrap" %}

```
fetch( "https://api.dev.dex.guru/wh/xfi_addresses_interaction?api_key=sTa5PAljgZuakDAojY8YipKcUq0jHQH2mI8xKlxn", { method: "POST", headers: {"Content-Type": "application/json"}, body: '{"parameters": {"dates":"d_last_month"}}' } )
```

{% endcode %}

That is all for a main features introduction. All details can be provided on demand. Other features and uses cases will be described in a while.


# Ecosystem and Community

Gurus Wanted: Become Network Assistants and Compute Providers - Earn While You Participate!

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

As the Guru Network expands, it leverages a diverse ecosystem of contributors and users, each playing a crucial role in the network’s operation and growth. These various participant categories within the Guru Network, including Gurus, Ecosystem Projects, Individual Agents, Integrators, and Retail Users. Each category contributes uniquely to the network's ecosystem, from developing AI-driven solutions to enhancing blockchain interoperability and user engagement. Understanding these roles is essential for appreciating the network’s comprehensive architecture and collaborative dynamics.

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

* Gurus: This category encompasses AI Processors, Compute Node Runners, and Individual Agents code contributors.
* Ecosystem Projects: Retail and business projects serve as entities that combine multiple BBPA (Blockchain Business Process Automation) orchestrations and data scenarios to solve specific routine tasks or business functions. These projects can also act as Gurus by contributing AI Processors and GURU AI Assistants to the network. They have the opportunity to publish their AI Processors, GURU AI Assistants, and Individual Workers in a IAAS(infrastructure-as-a-service) catalog, making them available for integration by other participants in the ecosystem.&#x20;
* Individual Agents: AI/Non-Custodial Web3 Processors composed by Gurus and run by Compute nodes, utilized by BBPM defined processes.
* Integrators: For enterprise implementations, integrators serve as a middle layer providing B2B adoption of the Guru AI Flow Orchestrator and Framework.
* Retail Users: Retail users utilize the network as assistants from their wallets. Additionally, the architecture allows for them to participate in "Compute by Earn" when idle functionality, where they choose which Individual Agents to run when their device/wallet is idle.

The Guru Enlightenment Network thrives on the collaboration between Gurus, who innovate with AI technologies, ecosystem projects and active retail users, enhancing both functionality and scalability.&#x20;

<br>


# Governance and Stakeholder Engagement

Governance Framework - Community Involvement and Decision-Making Processes

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


# Q1\&Q2 2024 Roadmap

Guru Network Roadmap for Q1 & Q2 2024

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

Our commitment to the GURU Network goes beyond its architectural and economical design; it is also the foundation for the next evolution of our existing products. By running services using GURU Network as infrastructure, we demonstrate capabilities and refine functionality to ensure the platform meets the high standards users expect. This approach allows us to closely align our products' development with the emerging needs of the blockchain community, ensuring that our solutions remain at the cutting edge.

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


# Terms Of Sale

Public Token Sale Terms for $GURU

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

THESE TERMS DO NOT CONSTITUTE AN OFFER TO SELL OR THE SOLICITATION OF AN OFFER TO BUY, NOR SHALL THERE BE ANY SALE OF, TOKENS TO ANY U.S. PERSONS (AS DEFINED BELOW) OR IN THE UNITED STATES OR IN ANY OTHER JURISDICTION IN WHICH SUCH OFFER, SOLICITATION, OR SALE WOULD BE UNLAWFUL PRIOR TO REGISTRATION OR QUALIFICATION UNDER THE LAWS OF ANY SUCH JURISDICTION. TOKENS MAY NOT BE OFFERED OR SOLD WITHIN THE UNITED STATES OR TO, OR FOR THE ACCOUNT OR BENEFIT OF, U.S. PERSONS. THESE TERMS DO NOT CONSTITUTE INVESTMENT ADVICE OR COUNSEL OR SOLICITATION FOR INVESTMENT IN ANY SECURITY AND SHALL NOT BE CONSTRUED IN THAT WAY.<br>

PUBLIC TOKEN SALE TERMS

These Public Token Sale Terms (“Terms”) constitute a binding agreement entered on the date of the later signature (“Effective Date”) by you or the entity you represent (“you”, “your” or “Purchaser”) and DexGuru Foundation, a company organized under the laws of the BVI (“we”, “us”, “our” or “Company”), respectively, each “Party” and together the “Parties,” and govern your purchase of GURU Tokens (as defined below) from Company during the Token Sale.

| KEY TERMS      |                                                |
| -------------- | ---------------------------------------------- |
| Token Name     | $GURU                                          |
| TGE Deadline   | TBD                                            |
| Token Release  | 100% on or about the TGE Deadline.             |
| Launchpad      | fjordfoundry.com, operated by fjordfoundry.com |
| Applicable Law | The laws of the British Virgin Islands (BVI)   |

<br>

Other capitalized terms appearing in these Terms are defined below.

Please read these Terms carefully. By acquiring Tokens or otherwise using the Website located at <https://dexguru.net/> (“Website”) and products and services offered on the Website, you acknowledge that you have read the Terms and that you agree to be bound by them. If you do not agree to all of the provisions of the Terms, you are not an authorized user of these services and you should not acquire any Tokens or use the Website or any related products or services.

Company reserves the right to change, modify, add or remove any provisions of the Terms at any time for any reason. Such changes are effective immediately once we post them in a public forum. We suggest that you review the Terms periodically for any changes. You acknowledge that by using Tokens or by accessing the Website after we have posted changes to the Terms, you are agreeing to the modified provisions.

The Website or the White Paper may contain a summary of the provisions that are outlined in greater detail in these Terms. These Terms prevail over and qualify the provisions of the Website and the White Paper. Any decision to purchase Tokens should only be made following a review of these Terms.

Ownership of Tokens carries no rights, express or implied, other than the right to use such Tokens as a means to enable the usage of, and interaction with, the Platform, if successfully completed and deployed. In particular, you understand and accept that Tokens do not represent or confer any ownership right or stake, share or security or equivalent rights, or any right to receive future revenue shares, intellectual property rights or any other form of participation in or relating to any of the Indemnified Parties, other than rights relating to the use of and interaction with the Platform, subject to limitations and conditions as described in the Company’s White Paper (as defined below) and the Website.

1. ## DEFINITIONS

### “Disruption Event” means (a) any event or occurrence that causes a disruption in the functionality of the technology upon which Tokens operate, (b) any event or occurrence that causes a disruption in the functionality of the software used in connection with the Token Sale, (c) any compromise of security that has or in our sole good faith determination may have an adverse impact on the Token Sale; or (d) any other event that we reasonably think materially adversely affects or may materially adversely affect Company, its affiliates, the Platform, the transactions associated with Tokens or the Token Sale.

### “Indemnified Party” or “Indemnified Parties” means Company, the Platform, the owner of the Platform and their respective past, present and future employees, officers, directors, contractors, consultants, equity holders, suppliers, vendors, service providers, parent companies, subsidiaries, affiliates, agents, representatives, predecessors, successors and assigns.

### “Launchpad” means a platform where the Token Sale is conducted as specified in the Key Terms.

### “PEP” has the meaning attached to it in Section 4.1(i).

### “Platform” means a blockchain-based software, computing system network, or protocol developed by Company and associated with the Company’s intellectual property that may involve a native cryptographic token to access certain functions (including governance functions) or services as further described in the White Paper.

### “Prohibited Jurisdictions” include (a) Australia, Canada, Cuba, Democratic People’s Republic of North Korea, Republic of Korea, Islamic Republic of Iran, Libya, People’s Republic of China, South Sudan, The United States of America, Sudan (North), Syria, The Crimea, (b) any jurisdiction in which the entry into the Terms or the ownership of Tokens is prohibited by applicable law, and (c) any jurisdiction which is subject to the sanctions or embargoes introduced or administered by the United States or the United Nations.

### “Restricted Persons” has the meaning attached to it in Section 4.1.

### “Securities Act” means the U.S. Securities Act of 1933, as amended.

### “Tokens” means decentralized application assets, protocol tokens, blockchain-based assets, or other forms of digital assets associated with the Platform and created or issued by Company and sold during the Token Sale with the name ascribed to it in the Key Terms.

### “Token Sale” means the process of selling Tokens as conducted by Company in accordance with the Terms.

### “Token Utility” has the meaning attached to it in Section 7.1.

### “Token Generation Event” or “TGE” means an act that involves the technical generation of Tokens in a blockchain-based network and its launch to the market.

### “U.S. Person” means (a) any natural person resident in the United States; (b) any partnership or corporation organized or incorporated under the laws of the United States; (c) any estate of which any executor or administrator is a U.S. person; (d) any trust of which any trustee is a U.S. person; (e) any agency or branch of a foreign entity located in the United States; (f) any non-discretionary account or similar account (other than estate or trust) held by a dealer or other fiduciary for the benefit of a U.S. person; (g) any discretionary account or similar account (other than estate or trust) held by a dealer or other fiduciary organized, incorporated, or (if an individual) resident in the United States; and (h) any partnership or corporation if: (i) organized or incorporated under the laws of any foreign jurisdiction; and (ii) formed by a U.S. person principally for the purpose of investing in securities not registered under the Securities Act, unless it is organized or incorporated, and owned by accredited investors who are not natural persons, estates or trusts.

### “Wallet” means a cryptographic public address on a blockchain for receiving, storing, and disposing of funds, in which a record of eligible assets can be held and which is used by Purchaser for receiving the Tokens purchased during the Token Sale.

### “White Paper” means a single document that summarizes important information related to the Platform and Tokens.

### Other capitalized terms appearing in these Terms are defined below.

2. ## SCOPE OF THE TERMS

### The Terms govern only your purchase of Tokens from Company during the Token Sale. Company will have no responsibility for your use of Tokens after Tokens are sold.

3. ## ELIGIBILITY AND RESTRICTED PERSONS

### To be eligible to participate in the Token Sale, you must:

1. #### be at least 18 years of age;
2. #### not be any Restricted Person (as defined below);
3. #### comply with all provisions set forth in these Terms;
4. #### complete the registration process on the Launchpad or any affiliated website and provide all information requested during the registration process;
5. #### own and control private keys to an ERC-20 compatible Ethereum blockchain Wallet and provide the public address of the Wallet to Company;
6. #### provide to Company through the Launchpad such anti-money laundering (“AML”) information as Company or the Launchpad may require; and
7. #### arrange payment for the relevant Tokens pursuant to these Terms or as otherwise specified on the Launchpad.
8. ## RESTRICTED PERSONS
9. 1. ### Restricted Persons Defined. Tokens are not being offered or distributed to the following restricted persons (collectively, “Restricted Persons”):
   2. 1. #### any person unable to pass the Company’s or the Launchpad’s know-your-customer or know-your-client (“KYC”) requirements as may be determined from time to time in their sole discretion;
      2. #### a citizen or resident of or located in, or a legal entity formed or incorporated within or subject to the laws of, any Prohibited Jurisdiction regardless of whether the use of a virtual private network or other technical workaround to affect such transaction and avoid detection within a Prohibited Jurisdiction;
      3. #### an individual or an individual employed by or associated with a legal entity or a legal entity identified on the United States Department of Commerce’s denied persons or entity list, the United States Department of Treasury’s specially designated nationals or blocked persons lists, the United States Department of State’s debarred parties list, the consolidated sanctions list maintained by the United States Department of Treasury’s Office of Foreign Assets Control, any United Nations Security Council sanctions lists or any other sanctions list;
      4. #### a person identified as a terrorist organization on any other relevant lists maintained by any governmental authority;
      5. #### a person acting, directly or indirectly, in contravention of any applicable law;
      6. #### a person in any manner limited or prohibited (or that requires licensing, registration or approval of any kind) from the purchasing, possessing, transferring, using or otherwise conducting a transaction involving any amount of Tokens under applicable law;
      7. #### a person taking part in the Token Sale or acquiring Tokens on behalf of another undisclosed or unidentified person;
      8. #### a person that has been involved at any time in any type of activity associated with money laundering or terrorist financing or any other applicable anti-corruption or anti-bribery statute or has been subject to any investigation or sanction by, or a request for information from, any governmental authority relating to money laundering, terrorist financing, corruption or bribery in any jurisdiction or under any applicable law;
      9. #### a person that is, unless otherwise disclosed in writing to and approved in writing by Company prior to taking part in the Token Sale or acquiring Tokens, a politically exposed person (“PEP”) as defined by the Financial Action Task Force (or such similar person under any applicable law) as an individual who is or has been entrusted with a prominent public function or an immediate family member or close associate of a PEP or any corporation, business or other entity that has been formed by, or for the benefit of, a PEP or any immediate family member or close associate of a PEP; or
      10. #### a person acting or purporting to act, directly or indirectly, on behalf of, or owned or controlled by, any persons who would be a Restricted Person under this Section.
   3. ### No Purchase by the Restricted Persons. The Restricted Persons are strictly prohibited and restricted from purchasing and using Tokens. Company is not soliciting purchases and usage of Tokens by the Restricted Persons in any way. If a Restricted Person purchases Tokens, such Restricted Person has done so on an unlawful, unauthorized and fraudulent basis. Any transactions and operations entered into by the Restricted Person in respect of Tokens shall be null and void. Neither Company nor the Platform shall be bound by any transaction in violation of these Terms, and Company may in its sole discretion:
   4. 1. #### take all necessary and appropriate actions to apply and enforce the consequences of the void transactions and operations specified above;
      2. #### notify the relevant authorities on the transaction or the operation in question; and
      3. #### retain all the funds paid by the Restricted Person and either freeze them until the situation is resolved by the respective authority or transfer to the account specified by the relevant financial authority, or apply to cover inflicted losses or discharge liabilities, or, except where prohibited by law, refund to the payer of the funds in accordance with applicable law and provisions of these Terms.
   5. ### Liability of Restricted Persons. Any Restricted Person purchasing Tokens shall be solely liable for any and all damages, liabilities, losses and expenses (including but not limited to reasonable attorneys’ fees) caused to Company or the Platform, and each such Restricted Person shall indemnify, defend and hold harmless Indemnified Parties from and against any and all damages, liabilities, losses, costs and expenses (including but not limited to reasonable attorneys’ fees) incurred by any of the Indemnified Parties that arise from or are related to such Restricted Person’s purchase of Tokens.
10. ## PURCHASE, PAYMENT AND DELIVERY
11. 1. ### Purchase and Payment. You agree to purchase the Number of Purchased Tokens for the Total Purchase Price as set forth in the Key Terms. You will pay the Total Purchase Price to Company on the Effective Date. Company may, in its sole discretion and without notice, rescind or terminate, as applicable, these Terms and Tokens in the event that Purchaser does not deliver to Company its signature page to these Terms or the Total Purchase Price.
    2. ### Form of Payment. Company agrees to accept payment for the Total Purchase Price (a) in United States Dollars via wire transfer to a bank account designated in writing by Company or (b) in Bitcoin (BTC), Ether (ETH), Tether (USDT), or USD Coin (USDC) to an ERC-20 compatible Ethereum wallet address designated in writing by Company. Company may elect to accept other methods or forms of payment on an as-converted to U.S. dollars basis in its sole discretion.
    3. ### Delivery of Tokens. Subject to the Terms and the receipt by Company of the Total Purchase Price from Purchaser, Company will make available, in full satisfaction of all of the Company’s obligations under these Terms, for Purchaser to claim and transfer to the Wallet that number of Tokens equal to the Number of Purchased Tokens. Title to and risk of loss of Tokens shall transfer to Purchaser upon such time as Company makes available such number of Tokens for Purchaser to claim and transfer to the Wallet. Any and all costs and expenses of such claim and transfer shall be the sole and exclusive responsibility and liability of Purchaser.
    4. ### Token Delivery Schedule. The delivery of Tokens to you as set forth in Section 5.3 will occur subject to the following schedule:
    5. 1. #### 100 of the Number of Purchased Tokens will be delivered on or about the TGE Deadline;
       2. #### 0% of the Number of Purchased Tokens will be delivered gradually as set forth in the Key Terms under provision “Token Release.”
    6. ### Conditions to Delivery of Tokens. As a condition to and prior to the delivery of Tokens as set forth in Section 5.3 above, and in each case unless waived in writing by Company:
    7. 1. #### Purchaser will execute and deliver to Company any and all other transaction documents related to these Terms and the delivery of Tokens as requested by the Company;
       2. #### Purchaser will provide to Company in writing the Ethereum blockchain public address of the Wallet or any other applicable blockchain wallet address as will be determined by Company;
       3. #### Purchaser will complete and deliver all forms, documentation and registrations required hereunder, including but not limited to the KYC and AML documentation set forth in these Terms, including submission of such forms and other documentation and information to Company, the Launchpad or any third-party vendor Company has engaged in connection with the Token Sale; and
       4. #### Purchaser will do and perform, or cause to be done and performed, all such further acts and things, and will execute and deliver all such other agreements, certificates, instruments and documents, as the Company or its affiliates, agents, representatives and assigns may reasonably request in order to carry out the intent of these Terms or as will be required to comply with then applicable laws and regulations.
12. ### If Purchaser fails to meet any of the conditions above, Company may hold Tokens otherwise deliverable under the Terms in escrow until such conditions are met, and such escrow will constitute delivery of the applicable number of Tokens in accordance with these Terms notwithstanding that such Tokens remain in escrow.
13. ### Disruption Event. In the event of a Disruption Event, we have the right to suspend the Token Sale. If we elect to suspend the Token Sale, we will publicly announce the suspension as soon as reasonably practicable and, prior to resuming the Token Sale, we will announce the resumption at least a reasonable period in advance. If we suspend the Token Sale for a period of time, we will determine in our sole and absolute discretion whether to:
14. 1. #### nevertheless continue the Token Sale on the originally scheduled Token Sale end date (if any); or
    2. #### extend the Token Sale for a period of time equal to the period of time the Token Sale was suspended for.
15. ## CANCELLATION, REFUNDS AND PURCHASE ATTEMPTS
16. 1. ### Your purchase of Tokens from us during the Token Sale is final, and there are no refunds or cancellations except as may be required by applicable law.
    2. ### NOTWITHSTANDING ANYTHING TO THE CONTRARY SET FORTH IN THE TERMS, COMPANY RESERVES THE RIGHT TO REFUSE OR REJECT TOKEN PURCHASE ATTEMPTS AT ANY TIME FOR ANY REASON IN ITS SOLE DISCRETION. COMPANY IS NOT RESPONSIBLE FOR ANY SUCCESSFUL OR UNSUCCESSFUL ATTEMPTS YOU MAY MAKE TO PURCHASE TOKENS IN CONTRAVENTION OF THESE TERMS.
17. ## PURPOSE AND USE OF TOKENS
18. 1. ### Utility. Tokens are being designed for the use in connection with the Platform currently accessible at the Website. Further details about the Platform are available at the Website. Tokens are digital utilities that power and incentivize the Platform, as further described on the Website and in the White Paper (“Token Utility”).
    2. ### No Rights. Your purchase, ownership, receipt, or possession of Tokens carries no rights, express or implied, other than the right to use Tokens in connection with the Token Utility. Tokens do not and will not represent or confer any ownership right, stake, share or security or equivalent rights, or any right to receive future revenue share or profits, intellectual property rights or any other form of participation in or relating to Company, the Platform, the owner of the Platform or their respective affiliates, including the governance of Company and the Platform. Tokens are not intended to be a digital currency, security, expectation of profit, or any other kind of financial instrument.
    3. ### No Promise of Value. No promises of future performance or value have been, are being or will be made with respect to Tokens by any party, including no promise of inherent value, no promise of continuing payments, and no guarantee that Tokens will hold any particular value.
19. ## TRANSFER RESTRICTIONS; NO SECONDARY TRADING

### Tokens may be subject to restrictions or prohibitions on transfers and usage in accordance with applicable law, including, but not limited to, restrictions under the Securities Act. Such restrictions or prohibitions may also restrict or prohibit secondary market trading. Tokens have not been and will not be registered under the Securities Act and may not be offered or sold within the United States or to, or for the account or benefit of U.S. Persons.

5. ## ACKNOWLEDGMENT AND ASSUMPTION OF RISKS
6. 1. ### You acknowledge and agree that there are risks associated with your purchase, ownership and use of Tokens in connection with the Token Utility or the Platform. These risks include but are not limited to the risk factors set out in ANNEX I.
   2. ### BY PURCHASING TOKENS, YOU EXPRESSLY ACKNOWLEDGE AND ASSUME ALL SUCH RISKS.
7. ## SECURITY
8. 1. ### Secure Your Wallet. You are solely responsible for implementing reasonable measures for securing your Wallet and any other wallet or vault you use to hold Tokens that you purchase from us, including but not limited to any requisite private keys or other credentials necessary to access such Wallet or other wallet or vault. If Purchaser is no longer in possession of the Purchaser’s private keys or any device associated with the Wallet or is not able to provide the Purchaser’s login or identifying credentials, Purchaser may lose all of Purchaser’s Tokens and all access to the Purchaser’s account. Indemnified Parties are under no obligation to recover any Tokens and are not liable for such loss of the Purchaser’s Tokens.
   2. ### Notwithstanding any other provisions of these Terms, we will not be responsible or liable for any damages, losses, penalties, fines, or expenses arising out of or relating to:
   3. 1. #### your failure to implement reasonable measures to secure your Wallet or any other wallet or vault you use to hold Tokens or the relevant access credentials;
      2. #### the loss of, tampering with, circumventing or unauthorized use of any access credentials to your Wallet or any other wallet or vault you use to hold Tokens;
      3. #### any errors or omissions (including but not limited to typos and inaccuracies) relating to your Wallet, including but not limited to errors and omissions in the public blockchain address of your Wallet that may result in your Tokens not being transferred to you in the Token Sale;
      4. #### any bugs, defects, faults, exploits, vulnerabilities or security breaches affecting the security of or access to your Wallet or any wallet or vault you use to hold Tokens; or
      5. #### the loss of Tokens from your Wallet or any other wallet or vault you use to hold Tokens.
9. ## PRIVACY

### Please refer to our privacy policy and Launchpad’s privacy policy available on the respective websites for information about how we collect, use and discloses your personal data.

8. ## TAXES

### Any amounts that you pay for Tokens are exclusive of all applicable taxes. You are solely responsible for determining what, if any, taxes apply to your purchase of Tokens, including but not limited to, for example, sales, use, value added, and similar taxes. It is your sole responsibility to withhold, collect, report and remit the correct taxes to the appropriate tax authorities. We are not responsible for withholding, collecting, reporting, or remitting any sales, use, value added, or similar tax arising from your purchase of Tokens.

9. ## REPRESENTATIONS AND WARRANTIES

### You represent and warrant that as of the Effective Date and the date of delivery of Tokens to you that:

1. #### you are at least 18 years of age;
2. #### you have full legal capacity, power and authority to execute and perform under these Terms;
3. #### all information requested during the registration process you have provided in accordance with Section 3(d) is complete and accurate;
4. #### you are not a Restricted Person as defined in Section 4;
5. #### you have a sufficient technical understanding of cryptographic tokens (including Tokens, ETH and BTC), proof-of-stake based protocols, distributed networks (including the Platform), token storage mechanisms (including, but not limited to, your Wallet), and blockchain technology in general to understand these Terms and to appreciate the risks and implications of purchasing, holding and using Tokens;
6. #### you have carefully read and understood these Terms, including ANNEX I;
7. #### you have carefully read and examined the Website and the White Paper and understand the Token Utility, including the purpose of Tokens;
8. #### you have obtained sufficient information about Tokens to make an informed decision to purchase Tokens;
9. #### you understand, acknowledge and assume the restrictions and risks associated with the purchase, holding and use of Tokens as set forth herein, including, but not limited to, the risks explained and disclosed in these Terms;
10. #### you understand that Tokens are intended to be used only in connection with the Token Utility, and otherwise confer no rights of any form with respect to the Company, the Platform or the owner of the Platform or their affiliates, including, but not limited to, any ownership, voting, stock, distribution, redemption, liquidation, proprietary (including all forms of intellectual property), or other financial or legal rights;
11. #### you are purchasing Tokens solely for the use in connection with Token Utility and are not purchasing Tokens for any other purposes, including, but not limited to, any investment, speculative or other financial purposes;
12. #### you understand and acknowledge that Company is not registered with or licensed by any financial regulatory authority. Accordingly, no financial regulatory authority has passed upon the contents of these Terms or the merits of purchasing Tokens, nor have these Terms been filed with, or reviewed by, any financial regulatory authority;
13. #### these Terms constitute a valid and binding obligation of the Purchaser, enforceable in accordance with its provisions, except as limited by bankruptcy, insolvency or other laws of general application relating to or affecting the enforcement of creditors’ rights generally and general principles of equity;
14. #### your purchase of Tokens complies with applicable laws and regulations or rules in your jurisdiction, including, but not limited to: (a) legal capacity and any other applicable legal requirements in your jurisdiction for purchasing Tokens, using Tokens, and entering into contracts with us, (b) any foreign exchange, regulatory or import/export restrictions applicable to such purchase, and (c) any governmental or other consents that may need to be obtained;
15. #### you are not resident or domiciled in a jurisdiction prohibiting its residents or domiciles from participating in or purchasing tokens or coins in token offerings or sales;
16. #### if you are purchasing Tokens on behalf of any entity: (a) you are authorized to accept these Terms and to act on such entity’s behalf, (b) such entity will be responsible for breach of these Terms by you or any other employee or agent of such entity, (references to “you” in these Terms refer to you and such entity, jointly), and (c) such entity is duly organized and validly existing under applicable laws of the jurisdiction of its organization and is not a Restricted Person; and (d) to the extent they are applicable, you will cooperate with the beneficial ownership identification requirements set forth in these Terms;
17. #### you will not use Tokens or the Platform in connection with any activity that violates applicable laws in any relevant jurisdiction, including, but not limited to, use of Tokens or the Platform in connection with transactions that violates applicable law;
18. #### you will comply with all applicable tax obligations in your jurisdiction arising from your purchase of Tokens;
19. #### you will provide Company and/or the Launchpad with any AML and KYC information as they may require, with your information as of the date of your response, together with any supporting identification documentation, as they may require, and deliver it to them before you may be eligible to purchase Tokens. You also agree to provide Company and/or the Launchpad with such documents that they may request in connection with their compliance requirements with any applicable laws (including, without limitation, AML laws) in order to determine your eligibility;
20. #### you represent and warrant that the funds used for your purchase of Tokens are not derived from illegal or illegitimate activities;
21. #### you are not a U.S. Person and Tokens have not and are not being offered to you in the United States. As of the Effective Date, you (and your authorized signatory, if applicable) were outside of the United States;
22. #### you are acquiring Tokens for your own account and not with a view to resale or distribution, either directly or indirectly, in the United States or to or for the account or benefit of a U.S. Person; and
23. #### you are not a party to any contract, undertaking, agreement, or arrangement  with any person to sell, transfer, or pledge to a U.S. Person any of the Tokens, and have no present plans to enter into any such contract, undertaking, agreement, or arrangement.
24. ## INDEMNIFICATION
25. 1. ### To the fullest extent permitted by applicable law, you will indemnify, defend and hold harmless the Indemnified Parties from and against all claims, demands, actions, liabilities, damages, losses, costs and expenses (including but not limited to reasonable attorneys’ fees with the right of advancement) that arise from or relate to:
    2. 1. #### your purchase or use of Tokens;
       2. #### your responsibilities or obligations under these Terms;
       3. #### any breach by you of these Terms; or
       4. #### any infringement or violation by you of any rights of, or laws or regulations applicable to, any other person or entity.
    3. ### Company reserves the right to exercise sole control over the defense, at your expense, of any claim subject to indemnification under this Section 14. This indemnity is in addition to, and not in lieu of, any other indemnities and agreements to defend or hold harmless that you have provided to any Indemnified Party.
    4. ### Each of the Indemnified Party shall be entitled to enforce any indemnification or release provisions of these Terms as if they were a party to these Terms, provided that the Parties to these Terms may by mutual written agreement terminate, rescind or agree to any variation, waiver or settlement or extinguish or alter any entitlement or right of any of an Indemnified Party without obtaining the consent of any other person, including such Indemnified Party.
26. ## KYC AND AML
27. 1. ### Company and its affiliates follow KYC and AML and other banking or government regulations in respective jurisdictions. Each and any purchaser of Tokens fully agrees to assist Company in fulfilment of the mentioned regulations and provide any necessary information if such is required from the purchaser by the authorized authority.
    2. ### As part of the Company’s compliance process with such regulations, Company and/or the Launchpad will conduct KYC and AML checks on you prior to your purchase of Tokens or the transfer of Tokens to you (as determined by Company and/or the Launchpad). As part of such checks, Company and/or the Launchpad will collect and store, and you agree to provide to Company and/or the Launchpad, prior to your purchase of Tokens or prior to the delivery of Tokens to you, the following types of data:
    3. 1. #### your name and surname;
       2. #### your email;
       3. #### your address;
       4. #### your date of birth;
       5. #### a copy of your passport or driver license or other appropriate identification document details or incorporation documents if you are a legal entity;
       6. #### identification numbers that you may use or have registered with your local tax authority; and
       7. #### a copy of your utility bills and/or other documents that Company and/or the Launchpad can use to verify your address.

### In certain cases, such as when additional verification by bank or compliance authority is needed according to governmental rules, AML or KYC policies, Company and/or the Launchpad may require you to provide additional information, and some or all of the following:

1. #### confirmation of proceeds sources;
2. #### sworn statements;
3. #### W-2 form;
4. #### bank statement(s);
5. #### information regarding the value of your assets or net worth;
6. #### confirmation of any professional licenses that you may hold; and
7. #### any other documents that Company and/or the Launchpad may reasonably request to satisfy applicable KYC and AML requirements.
8. ### Company and/or the Launchpad will refuse your access to the Token Sale if they have reasonable doubts as to validity, authenticity and genuineness of the data provided by you, or in case you have failed to provide the data and other additional information as required above. In such case you will be deemed to have violated the provisions of this Section 15 of these Terms and Company and/or Launchpad will refuse to transfer the Tokens to you and will, subject to applicable law, use its commercially reasonable efforts to refund the money, including any cryptocurrencies, that Company and/or the Launchpad has actually received from you to purchase Tokens in the same amount (of the form of payment, whether money or any cryptocurrencies, as applicable) it has been transferred to Company and/or the Launchpad (with no interest or any other amounts due on such funds, subject to the deduction of any transfer fees paid by Company and/or the Launchpad). In addition, the Company and/or the Launchpad has the right to use any possible efforts for preventing the money laundering and terrorism financing, including, but not limited to, blocking your Wallet and disclosing any information about you to the national, federal or state authorities at their request, without your knowledge or consent.
9. ### All payments by you to Company and/or the Launchpad in connection with these Terms shall be made only in your name, from a digital wallet or bank account not located in a country or territory that has been designated as a “non-cooperative country or territory” by the Financial Action Task Force, and is not a “foreign shell bank” within the meaning of the U.S. Bank Secrecy Act, as amended, and the regulations promulgated thereunder by the Financial Crimes Enforcement Network, as such regulations may be amended from time to time.
10. ## DISCLAIMERS

### TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW:

1. TOKENS ARE SOLD ON AN “AS IS” AND “AS AVAILABLE” BASIS WITHOUT WARRANTIES OF ANY KIND, AND WE EXPRESSLY DISCLAIM ALL IMPLIED WARRANTIES AS TO TOKENS, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON- INFRINGEMENT;
2. WE DO NOT REPRESENT OR WARRANT THAT TOKENS ARE RELIABLE, CURRENT, OR ERROR-FREE, MEET YOUR REQUIREMENTS, OR THAT ANY DEFECTS IN TOKENS WILL BE CORRECTED; AND
3. WE CANNOT AND DO NOT REPRESENT OR WARRANT THAT TOKENS OR THE DELIVERY MECHANISM FOR TOKENS ARE FREE OF BUGS, DEFECTS, FAULTS, EXPLOITS, VULNERABILITIES, VIRUSES OR OTHER HARMFUL COMPONENTS.
4. ## LIMITATION OF LIABILITY

### TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW:

1. IN NO EVENT WILL COMPANY OR ANY OF THE INDEMNIFIED PARTIES BE LIABLE FOR LOSS OF PROFITS OR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER LOSS OF ANY KIND (INCLUDING, BUT NOT LIMITED TO, WHERE RELATED TO LOSS OF REVENUE, INCOME OR PROFITS, LOSS OF USE OR DATA, OR LOSS FOR BUSINESS INTERRUPTION) ARISING OUT OF OR IN ANY WAY RELATED TO THE SALE OR USE OF TOKENS OR OTHERWISE RELATED TO THESE TERMS, REGARDLESS OF THE FORM OR CAUSE OF ACTION, WHETHER BASED IN CONTRACT, TORT, OR ANY OTHER LEGAL OR EQUITABLE THEORY (EVEN IF THE PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND REGARDLESS OF WHETHER SUCH LOSS WERE FORESEEABLE); AND
2. IN NO EVENT WILL THE AGGREGATE LIABILITY OF COMPANY AND THE INDEMNIFIED PARTIES (JOINTLY) FOR ANY LOSS ARISING OUT OF OR RELATING TO THESE TERMS OR THE USE OF OR INABILITY TO USE TOKENS, EXCEED THE AMOUNT YOU PAY TO US FOR TOKENS.
3. ## RELEASE

### To the fullest extent permitted by applicable law, you release Company and the Indemnified Parties from responsibility, liability, claims, demands and damages (actual and consequential) of every kind and nature, known and unknown (including, but not limited to, claims of negligence), arising out of or related to these Terms. You expressly waive any rights you may have under applicable law or any other statute or common law principles that would otherwise limit the coverage of this release (including similar laws in other applicable jurisdictions).

5. ## GOVERNING LAW

### These Terms will be governed by, construed and enforced in accordance with the laws of the jurisdiction specified in the Key Terms, without regard to conflict of law rules or principles that would cause the application of the laws of any other jurisdiction.

6. ## DISPUTE RESOLUTION
7. 1. ### Arbitration. Any dispute, controversy, or claim arising out of or relating to these Terms, including the existence, validity, interpretation, performance, breach or termination thereof or any dispute regarding non-contractual obligations arising out of or relating to these Terms shall be referred to and finally resolved by arbitration administered in accordance with the JAMS International Arbitration Rules. The tribunal will consist of one arbitrator. The place of arbitration will be New York, New York. The arbitration proceedings shall be conducted in English.
   2. ### Class Action Waiver. Any claim or dispute arising under these Terms will take place on an individual basis without resort to any form of class or representative action.&#x20;

### THIS CLASS ACTION WAIVER PRECLUDES ANY PARTY FROM PARTICIPATING IN OR BEING REPRESENTED IN ANY CLASS OR REPRESENTATIVE ACTION REGARDING A CLAIM.&#x20;

7. ## MISCELLANEOUS
8. 1. ### Severability. If any term, clause or provision of these Terms is held unlawful, void or unenforceable, then that term, clause or provision will be severable from these Terms and will not affect the validity or enforceability of any remaining part of that term, clause or provision, or any other term, clause or provision of these Terms.
   2. ### Entire Agreement. These Terms constitute the entire agreement between you and us relating to your purchase of Tokens from us. Our failure to exercise or enforce any right or provision of these Terms will not operate as a waiver of such right or provision.
   3. ### Assignment. We may assign our rights and obligations under these Terms. You shall not assign these Terms, or any of your rights or obligations hereunder.
   4. ### No Partnership. Your purchase of Tokens from us does not create any form of partnership, joint venture or any other similar relationship between you and us.
   5. ### Notices. All agreements, notices, disclosures, and other communications that we provide to you, including these Terms, may be provided in electronic form, including via the Launchpad.

<br>

### ANNEX I

RISKS

There are significant risks and uncertainties associated with your purchase of Tokens. Tokens should not be purchased by anyone who cannot afford to lose the entirety of their purchase price. Some of such risks are identified below. You bear full responsibility for any such risks.

1. Uncertain Regulations and Enforcement Actions

The regulatory status of Tokens and underpinning distributed ledger technology is unclear or unsettled in many jurisdictions, but numerous regulatory authorities across jurisdictions have been outspoken about considering the implementation of regulatory regimes which govern virtual or digital currencies and respective markets. It is impossible to predict how, when or whether regulatory agencies may apply existing regulations or create new regulations with respect to such technology and its applications, including the Token or the Platform. Regulatory actions could negatively impact the Token or the Platform in various ways. The Company or any of the Indemnified Parties may cease operations in a jurisdiction, or even abandon certain features of the project, in the event that regulatory actions, or changes to law or regulation, make it illegal to operate in such jurisdiction, or commercially undesirable to obtain the necessary regulatory approval(s) to operate in such jurisdiction.

2. Risks Associated with the Blockchain Protocol

Given that the Token and the Platform are based on blockchain protocol and architecture, any malfunction, breakdown or abandonment of the relevant blockchain protocol or architecture may have a material adverse effect on the Token or the Platform. Moreover, advances in cryptography, or technical advances (including without limitation development of quantum computing), could present unknown risks to the Token or the Platform by rendering ineffective the cryptographic consensus mechanism that underpins that blockchain protocol. The future of cryptography and security innovations are highly unpredictable. Further, products or services available on the Platform may require digital assets provided by a user to be deposited with, “staked” with or otherwise require interaction with various third-party decentralized finance protocols, which primarily comprise smart contracts deployed on the relevant blockchain. These third-party decentralized finance protocols and the development team behind these protocols are independent third parties, so neither Company nor any of the Indemnified Parties have control over these protocols or teams. The deployed smart contracts underlying the Platform or these decentralized finance protocols are highly experimental in nature, risky, and may contain security vulnerabilities, errors, failures, bugs or economic loopholes which may be exploited by third parties, causing you to suffer losses in connection with any product(s) available on the Platform. Neither the Company nor any of the Indemnified Parties can be responsible for any such security vulnerabilities, errors, failures, bugs or economic loopholes.

3. Personal Security

You are responsible for implementing reasonable measures for securing the Wallet, vault or other storage mechanism you use to receive and hold Tokens, which you have purchased, including any requisite passwords, tokens, private key(s) or other credentials necessary to access such storage mechanism(s). If your passwords, tokens, private key(s) or other access credentials are lost, you may lose access to your Tokens. Company cannot be responsible for, and is technologically unable to recover, any such losses.

4. Insufficient Information

The Platform is at the stage of development as of the date of these Terms and its algorithm, code, consensus mechanism and various other technical specifications and parameters could be updated and changed frequently and constantly. While the marketing materials and the White Paper released relating to the development of the Platform has been prepared with the up-to-date key information of the Platform, it is not absolutely complete and is subject to adjustments and updates from time to time for optimal development and growth of the Platform and ecosystem on the Platform. Company is neither able, nor obliged, to keep you closely posted on every detail of the development of the Platform (including its progress and expected milestones no matter whether rescheduled or not) and therefore will not necessarily provide you with timely and full access to all the information relating to the Platform that may emerge from time to time. Due to the nature of the project to develop the Platform, you accept that such insufficiency of information disclosure is inevitable and reasonable.

5. Cyber Weaknesses

Hackers or other malicious groups or organizations may attempt to interfere with the Token or the Platform in a variety of ways, including but not limited to, malware attacks, denial of service attacks, consensus-based attacks, Sybil attacks, smurfing and spoofing. Furthermore, there is a risk that a third party may intentionally or unintentionally introduce weaknesses into the core infrastructure of the Token or the Platform, which could negatively affect the Token or the Platform.

6. Lack of Markets for Tokens

There is no prior market for Tokens and the Token Sale may not result in an active or liquid market for the Token. The Token is intended to be used solely within the network for the Platform, hence there may be illiquidity risk with respect to any Token you hold.

The Token is not a currency issued by any central bank or national, supra-national or quasi- national organization, nor is it backed by any hard assets or other credit nor is it a “commodity” in the usual meaning of that word. Company cannot be responsible for, nor does Company pursue, the circulation and trading of Tokens on any market. Trading of Tokens will depend on the consensus on its value between the relevant market participants. No one is obliged to purchase any Token from any holder of the Token, nor does anyone guarantee the liquidity or market price of the Token to any extent at any time. Accordingly, Company cannot ensure that there will be any demand or market for the Token, or that the price you pay for the Token is indicative of any market valuation or market price for the Token.

Any secondary market or exchange for trading the Token would be run and operated wholly independently of Company and any of the Indemnified Parties. Company will not create such secondary markets, nor will it act as an exchange for the Token. Even if secondary trading of Tokens is facilitated by third-party exchanges, such exchanges may be relatively new and subject to little or no regulatory oversight, making them more susceptible to fraud or manipulation. Furthermore, to the extent that third parties do ascribe an external exchange value to the Token, such value may be extremely volatile, decline below the price which you had paid for the Token, or even diminish to zero. Holders of Token shall be responsible for all losses in connection with the purchase of or secondary trading of the Token, and shall not make any claim against any Company or any of the Indemnified Parties.&#x20;

7. Risk of Uninsured Losses

The Token is uninsured unless you specifically obtain private insurance to insure them. In the event of loss or loss of utility value, there is no public insurer or private insurance to offer recourse to you.

8. Taxation Risks

The tax treatment of the Token and these Terms is uncertain. The Company intends to treat the Token and these Terms neither as an equity interest nor as a debt interest in Company for tax purposes. It is possible that the Company’s intended treatment of the Token and these Terms may be challenged, so that the tax consequences to Purchaser and Company relating to Token and these Terms could differ from those described above. You must seek your own tax advice in connection with the purchase, holding or usage of the Token, which may result in adverse tax consequences to you, including withholding taxes, income taxes and tax reporting requirements.

9. Competitors

It is possible that alternative networks could be established that utilize the same or similar code and protocol underlying the Token or the Platform and attempt to re-create similar facilities. The Platform may be required to compete with these alternative networks, which could negatively impact the Token or the Platform.

10. Insufficient Interest

It is possible that the Platform will not be used by a large number of individuals, companies and other entities or that there will be limited public interest in the creation and development of distributed ledger technolgy ecosystems (such as the Platform). Such a lack of use or interest could negatively impact the development of the Platform and therefore the potential utility of the Token.

11. Risks Related to Our Corporate Structure

The Company’s corporate structure (including the intra-group arrangements) is bespoke and there is no generally accepted standard or structure for similar projects in the distributed ledger technology space. The legal structure had been designed to address certain specific legal risks, and attempt to decentralize the management and control, as well as economic risks and benefits relating to the Platform and the Token, but there is no legal precedent for whether these structures are effective and it is difficult to predict the position that a regulator may adopt.

12. Risks Arising from Lack of Governance Rights

Because the Token confers no governance rights of any kind with respect to the Platform or Company, all decisions involving the Platform or Company will be made by the relevant party of Company’s group at its sole and absolute discretion, including, but not limited to, decisions to discontinue the services or ecosystem on the Platform, to create and sell more Tokens for use in the ecosystem on the Platform, or to sell or liquidate any legal entity. These decisions could adversely affect the Platform and the Token you hold.

13. Risks Involving Cloud Storage

As the Platform may provide or utilize a decentralized cloud storage service for users and applications, therefore the Platform and associated services are susceptible to a number of risks related to the storage of data in the cloud, such as a cyberattack or other malicious activity. Similarly, the Platform and associated services may be interrupted and files may become temporarily unavailable in the event of such an attack or malicious activity. Because users can use a variety of hardware and software that may interface with the Platform, there is the risk that the Platform and associated services may become unavailable or interrupted based on a failure of interoperability or an inability to integrate these third-party systems and devices that Company does not control. The risk that the Platform and associated services may face increasing interruptions and the ecosystem on the Platform may face additional security vulnerabilities could adversely affect the Platform and ecosystem thereon, and therefore the future utility of any Token that you hold.

14. Forking

The Platform is a community project and certain elements are open-sourced. Company and any of the Indemnified Parties do not and cannot monopolize the development, marketing, operation or otherwise of the Platform. Any entity may independently develop a patch or upgrade of the source code of the Platform or blockchain without prior authorization of any other party. The acceptance of these patches or upgrades by a sufficient (not necessarily overwhelming) percentage of the Token holders could result in a “fork” in the blockchain, and consequently two diverging networks will emerge and remain. Each branch of the blockchain arising from the fork will have its own native cryptographic tokens. Accordingly, there will be two different versions of the Token respectively residing in the two divergent branches with almost identical technical features and functions. The community on the Platform may split into two groups in support of the two branches respectively. Further, it is theoretically possible for each branch of the forked blockchain to be further forked an unlimited number of times. The temporary or permanent existence of forked blockchains could adversely affect the operation of the Platform and blockchain and the Token which you hold, and may ruin the sustainability of the Platform.

15. Other Risks

In addition to the above risks, there are other risks associated with your purchase, holding and usage of the Token, including those that Company cannot anticipate. Such risks may further materialize as unanticipated variations or combinations of the above risks.

<br>


# Glossary

Glossary of Guru Network related terms in Blockchain, Crypto and Business Process Automation

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

**B**

BBPA (Blockchain [Business Process Automation](https://en.wikipedia.org/wiki/Business_process_automation)):

In the realm of blockchain, efficiency is king, and BBPA is the crown jewel. This ingenious concept streamlines complex business processes, transforming them into well-choreographed routines executed with the precision of a Swiss watch. It's like having a personal assistant who not only understands the intricate dance of blockchain but also possesses an uncanny knack for optimizing and automating every step, ensuring your operations run with clockwork precision.

**C**

CCIP ([Cross-Chain Interoperability Protocol](https://chain.link/cross-chain)):

Imagine a world where blockchain networks could effortlessly communicate and collaborate, like a harmonious symphony of digital ledgers. CCIP is the maestro conductor, orchestrating this cross-chain interoperability with finesse. It's the blockchain equivalent of a multilingual translator, fluently facilitating the exchange of data and assets across disparate networks, breaking down barriers and fostering seamless cooperation.<br>

**L**

[Layer 3](https://101blockchains.com/layer-3-protocols-blockchain/):

Visualize a towering blockchain ecosystem, where Layer 1 forms the foundation, and Layer 2 adds scalability and efficiency. Enter Layer 3, the pinnacle of this technological marvel – a realm where AI and blockchain converge in perfect harmony. This innovative layer introduces a new dimension of intelligence, allowing applications and users to seamlessly embed orchestrated AI agents into their workflows, akin to having a team of digital savants at their beck and call, ready to tackle even the most complex challenges with unwavering prowess.


# Reference Documentation

Reference Documentation For Guru Network

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


# Contests

Guru NFT Art Contest


# Guru NFT Art Contest - CONTEST IS OVER

Guru NFT Art Contest rules

<figure><img src="/files/Hj7lmHSxr0X3LB1XVlO7" alt=""><figcaption><p>Guru Season 2 Pass Collection on OpenSea</p></figcaption></figure>

## <mark style="color:green;">**CONTEST IS OVER, THANK YOU FOR YOUR SUBMISSIONS!**</mark>

TL;DR:

1. Follow <https://x.com/xgurunetwork>
2. Mint NFT on <https://v2.dex.guru/generate>
3. Share NFT's OpenSea link on X/Twitter with #GuruNFTArt and tag @xgurunetwork
4. Share a link to your tweet at special [Discord channel](<https://discord.com/channels/779159507967672360/1260584447363911711 >) . Winners selected daily - based on amount of likes on Discord! Invite your friends to vote for you!

Prizes include up to $100 in $GURU tokens (ERC20) daily 🏆

#### Guru NFT Art Contest Rules

1. **Eligibility:** The contest is open to all artists and creators who follow the official Guru Network Twitter account (<https://x.com/xgurunetwork>). Core Contributors Team members are not eligible to participate.
2. **Submission:** To enter contest, participants must tweet their artwork link on OpenSea with the hashtag #GuruNFTArt and tag @xgurunetwork. To mint NFT go to <https://v2.dex.guru/generate>, generate arts, pick your favorite and mint NFT on Base with it. You just need to cover a gas price for minting - so don’t forget to have some in your wallet. Minting stops July 31 2024.
3. **Judging:** Winners will be selected based on amount of likes on dedicated [Discord channel](<https://discord.com/channels/779159507967672360/1260584447363911711 >). Invite your friends to vote for you on Discord!
4. **Prizes:** Prize will be awarded to the top artwork daily, up to $100 USD equivalent in $GURU tokens, making you a holder.
5. **Announcement:** Winners will be announced on the Guru Network Twitter account and other social media channels.
6. **Rights:** By submitting artwork, participants grant Guru Network the right to use their artwork for promotional purposes.
7. **Disclaimer:** Guru Network reserves the right to modify or cancel the contest at any time.

By participating in the Guru NFT Art Contest, you agree to abide by these rules. Let your creativity flow!

## <mark style="color:green;">**CONTEST IS OVER, THANK YOU FOR YOUR SUBMISSIONS!**</mark>


# Guru Meme Mania

Guru Meme Mania Contest Rules

<figure><img src="/files/S8ovoEJxmOxpUG3TLlni" alt="" width="375"><figcaption><p>Guru Meme Mania</p></figcaption></figure>

## [<mark style="color:red;">**CONTEST PAUSED UNTIL FURTHER NOTICE**</mark>](#user-content-fn-1)[^1]

TL;DR:

1. Follow @xgurunetwork
2. Tweet your original meme with the #GuruMemeMania and tag @xgurunetwork
3. Ask your friends to like it
4. Repeat steps 2-3 to increase your chances to win $100 equivalent
5. Join Discord and ask your friends to vote in it - for chance to win even more

Easiest way to start: <https://imgflip.com/memetemplates>

## Full rules

1. **Eligibility:** The contest is open to all users who follow the official Guru Network account on X\Twitter (@xgurunetwork).
2. **Theme:** Memes must be related to Guru Network, its products (like DexGuru), the DeFi space, or Web3/AI concepts.
3. **Submission:** To enter, participants must tweet their meme with the hashtag #GuruMemeMania and tag @xgurunetwork.
4. **Originality:** Memes must be original creations. Plagiarism or copyright infringement will result in disqualification.
5. **Content:** Memes should be humorous, creative, and relevant to the Guru Network community. Offensive or inappropriate content will not be tolerated.
6. **Judging:** There's 3 nominations weekly:

   1. **Selection Criteria:** Each week, one winner will be chosen based on creativity, humor, and relevance to the Guru Network. The Guru Network team will judge these entries.
   2. **Audience Engagement:** A second weekly winner will be determined by the meme that receives the most likes on X/Twitter. Entries from previous weeks are not eligible for consideration.
   3. **Discord Community:** A third weekly winner will be selected based on the meme that garners the most likes in our dedicated [Discord channel](https://discord.com/channels/779159507967672360/1261257023907954718).

   We encourage all participants to submit fresh and engaging content each week to maximize their chances of winning.
7. **Prizes:** Prizes will be awarded to the top meme in every nomination (see 6) weekly, including $GURU (ERC20) tokens or other Guru Network prizes. Each prize is a $100 equivalent.
8. **Announcement:** Winners will be announced on the Guru Network Twitter account and other social media channels.
9. **Rights:** By submitting a meme, participants grant Guru Network the right to use their meme for promotional purposes.
10. **Disclaimer:** Guru Network reserves the right to modify or cancel the contest at any time.

By participating in the Guru Meme Mania contest, you agree to abide by these rules.

Let the meme-ing begin!

## [<mark style="color:red;">**CONTEST PAUSED UNTIL FURTHER NOTICE**</mark>](#user-content-fn-1)[^1]

[^1]:


# Guru Network Grand Riddle Hunt

Embark on an exciting journey through the Guru Network ecosystem to unlock a treasure of 5,000 $GURU tokens.

### How to Join The Guru Network Grand Riddle Hunt

**Hunt Process**

### Step 1: Preparation

* Follow Guru Network on [social media platforms](https://docs.gurunetwork.ai/links/web-and-social-media).
* Wait for the official hunt announcement.

### Step 2: Riddle Solving

* Solve 12 unique riddles in sequence.
* Each solved riddle reveals one word.
* Record each word exactly as solved and maintain their specific order.

### Step 3: Creating the Seed Phrase

* Combine all 12 words in the exact order of the riddles.
* Ensure proper spacing between words.
* Double-check spelling (no capitalization allowed).
* The complete phrase will serve as your wallet’s [seed phrase](https://support.metamask.io/getting-started/user-guide-secret-recovery-phrase-password-and-private-keys/#intro-to-secret-recovery-phrases).

### Step 4: Claiming the Prize

* Use the assembled seed phrase to access the wallet (wallet address revealed after solving the 12th riddle).
* The wallet contains **exactly 5,000 $GURU tokens**.

**Token Transfer Guidelines**:

* Transfer tokens immediately upon accessing the wallet to secure your prize.
* **Ensure that wallet has sufficient funds to cover transaction fees.**

### Important Notes

**Security Measures**

* Keep your solutions private
* Never share partial solutions
* Document your progress securely

**Verification**

* Only the correct sequence of all 12 words will grant access
* First person to access the wallet claims the entire prize
* No partial prizes are awarded

The hunt officially begins after announcing first riddle. **Winner should transfer the tokens immediately upon accessing the wallet to secure their prize.**

## Check The Clues

[Clue 1](https://tally.so/r/mVoydl)

Clue 2

Clue 3

Clue 4

Clue 5

Clue 6

Clue 7

Clue 8

Clue 9

Clue 10

Clue 11

Clue 12

Each clue will become available sequentially after the previous one. Every Clue Page provide checking of one clue for one word - Clue 1 for Word 1, etc. Participants can find the clues not only through Guru Network's platform - they will also be distributed via social media or other channels.

### Rules

1. Participants must solve all 12 riddles in sequence
2. Each correct answer is one word in the final pass phrase
3. The seed phrase must be assembled in the exact order of the riddles
4. The first person to correctly enter the complete pass phrase into the designated wallet gains access to 5,000 $GURU tokens
5. All participants must hold a valid Guru Season Pass NFT to participate
6. No hints will be provided beyond the initial riddles
7. All answers could be checked through the official Guru Network platform
8. The hunt concludes when the first correct solution is verified and the prize is claimed
9. If multiple participants solve the riddles simultaneously there are no tiebreaker mechanisms, the first to transfer the tokens to their personal wallet gets the prize.


# Our Links

Guru Network Official Links - Do Your Own Research with Confidence

## **Token:**

**Contract:** [**https://etherscan.io/token/0x525574C899A7c877a11865339e57376092168258#code**](https://etherscan.io/token/0x525574C899A7c877a11865339e57376092168258#code)

### **DEX**

**Uniswap on ETH:** <https://app.uniswap.org/explore/tokens/ethereum/0x525574c899a7c877a11865339e57376092168258> &#x20;

**Uniswap on Base:**<https://app.uniswap.org/explore/tokens/base/0x0f1cfd0bb452db90a3bfc0848349463010419ab2>&#x20;

**Equalizer:**

<https://base.equalizer.exchange/swap?inputCurrency=0x0f1cfd0bb452db90a3bfc0848349463010419ab2&outputCurrency=0x4200000000000000000000000000000000000006>&#x20;

On our Token Terminal

**DexGuru:** <https://dex.guru/token/eth/0x525574c899a7c877a11865339e57376092168258>&#x20;

**DexGuru V2:** <https://v2.dex.guru/token/eth/0x525574c899a7c877a11865339e57376092168258>

### **CEX**

**BitMart:** <https://www.bitmart.com/trade/en?symbol=GURU_USDT>&#x20;

**CoinEx:** <https://www.coinex.com/en/exchange/guru-usdt>&#x20;

**MexC:** <https://www.mexc.com/exchange/GURU_USDT>\ <br>

## **Join us on our:**

Website: <https://gurunetwork.ai/>&#x20;

X\Twitter: <https://x.com/xgurunetwork>&#x20;

Discord: <https://discord.gg/dPW8fzwzz9>&#x20;

Telegram <https://t.me/dexguru>&#x20;

Farcaster: <https://warpcast.com/gurunetwork> &#x20;

Twitch: <https://www.twitch.tv/gurunetwork>&#x20;

<br>

Framework Github: <https://github.com/dex-guru/guru-framework.git>&#x20;

<br>

Opensea Season 1: <https://opensea.io/collection/guru-season-pass-nft-v2>&#x20;

OpenSea Season 2: <https://opensea.io/collection/guru-season-2-pass>&#x20;

OpenSea Evergreen: <https://opensea.io/collection/guru-network-dao>

Spooky: <https://opensea.io/collection/spooky-guru>&#x20;

## Docs and DYOR:&#x20;

GitHub: <https://docs.gurunetwork.ai/>&#x20;

Litepaper: <https://gurunetwork.ai/assets/img/litepapper_dexguru_network.pdf>

White paper: <https://gurunetwork.ai/assets/img/guru_network_architecture_whitepaper.pdf>

Guru Enlightenment Network Deck: <https://docsend.com/view/ihpwaurpca366kpa>&#x20;

Overview: <https://beincrypto.com/learn/guru-network/>&#x20;

AMA : <https://beincrypto.com/guru-network-ama-session-beincrypto/> <br>

AMAs on YT: <https://youtube.com/live/nB3eCnk_cQw?feature=share>[ ](https://www.youtube.com/@gurunetwork_ai/streams)<br>

CTO’s Mirror: <https://mirror.xyz/evahteev.eth>&#x20;

<br>

What is Guru Network? <https://youtu.be/qozRUEnTIuI> &#x20;

What’s DexGuru V2 - walkthrough <https://youtu.be/TqpbNtYWt4o>&#x20;

How Guru Network works? <https://youtu.be/-hlJlh-W3YY>&#x20;

LBP event (finished): <https://app.fjordfoundry.com/pools/0xcd3deBf6D36212523EDF6e0e9804f0f62C91093C>


# Guru Network Mainnet Launch Documentation

The Guru Network is launching its mainnet as a Multi-Chain AI Compute Layer 3 platform, enabling orchestrated AI-driven user flows across both on-chain and off-chain activities. This documentation

This documentation provides essential information for developers and users participating in the mainnet launch.

Voting for the Guru Network Mainnet Launch Initiative proposal is now live on [Snapshot](https://snapshot.org/#/thegurudao.eth/proposal/0x5cf11a62b6708460e41995a8e96b0f4c4e68d33aaaa9a9dc1c079fb72479a862). Please go to the Guru Network DAO space and cast your vote!&#x20;

For voting you need to connect a wallet with [Guru Season Pass 1](https://opensea.io/collection/guru-season-pass-nft-v2), [Season Pass 2](https://opensea.io/collection/guru-season-2-pass) or Spooky Guru NFT.&#x20;

For anyone who doesn't have Seasons but wants to participate in governance, the [Evergreen collection](https://opensea.io/collection/guru-network-dao) is available for minting in the app and in the bot as well.

**Voting is open until November 20, so don't miss your chance to participate and express your opinion.**

**Anyone who votes for the winning choice shares a pool of 200,000 GURU based on Voting power.**

### Core Components

[**Flow Orchestrator**](/flow-orchestrator)

* Manages complex workflows requiring adaptive, context-aware decisions
* Implements BPMN (Business Process Management and Notation) standard
* Deploys process definitions with corresponding Factory Smart Contracts

### Network Participants

**Gurus**

* AI Processors contributors
* Compute Node Runners
* Individual Agents code contributors

**Ecosystem Projects**

* Deploy BBPA orchestrations
* Publish AI Processors
* Contribute to GURU AI Assistants

### Technical Architecture

**Compute Layer**

* Cross-chain compatibility across 18 blockchain networks
* Integration with Chainlink for off-chain computations
* Non-custodial Web3 Processors executionGur
*

### Revenue Streams

**Network Activities**

* Orchestration fees
* Transaction processing
* AI-driven workflow execution

### Mainnet Features

**Cross-Chain Support**

* Multi-chain orchestration
* Integrated AI Processors catalog
* Decentralized compute resources

### Development Tools

Please proceed to ther [Guru Framework](https://github.com/dex-guru/guru-framework) on GitHub

### Scaling Strategy

**Q4 2024 Milestones**

* Ecosystem incentives launch
* Guru Launchpad deployment
* Public Smart Wallet release
* Franchise toolset implementation

**2025 Objectives**

* Technical implementation expansion
* AI infrastructure development
* Web3 partnerships establishment


# Network Information

Mainnet Guru Network Information - chain details, block explorers, network services, RPC and bridge configurations

**Chain Details**

<pre><code><strong>CHAIN_ID: 260
</strong>RPC Endpoint: https://rpc.gurunetwork.ai/archive/260
Native Currency: GURU
</code></pre>

### Infrastructure

**Block Explorers**

* Blockscout Explorer: [`blockscout.gurunetwork.ai`](https://blockscout.gurunetwork.ai/)
* Guru Native Explorer: [`scan.gurunetwork.ai`](https://scan.gurunetwork.ai/)

**Network Services**

* Testnet Environment: [`sepolia.gurunetwork.ai`](https://sepolia.gurunetwork.ai/)
* Bridge Interface: [`bridge.gurunetwork.ai`](https://bridge.gurunetwork.ai/) (SuperBridge Integration)
* Swap Interface: [`swap.gurunetwork.ai`](https://swap.gurunetwork.ai) (Uniswap V2 fork)

### Integration Examples

**RPC Configuration**

```javascript
Will be added a bit later, thank you for your patience!
```

**Smart Contract Interaction**

```solidity
Will be added a bit later, thank you for your patience!
```

### Cross-Chain Operations

**Bridge Configuration**

```typescript
Will be added a bit later, thank you for your patience!
```


# Token Contracts

Token contracts for Guru Network Mainnet

**Native Tokens**

```solidity
// WGURU Token Contract
address constant WGURU = 0xc339E17eFD801724937A645B7e356CFA8be85279;
// Wrapped ETH Contract
address constant WETH = 0xd402ca8c735960dbb5a45975b51f7dc9f85f977e;
// Bridged USDC Contract
address constant USDC.e = 0xfbf7fD738DE150c147dcaA120be96d0aB27C5a9b;
```

### Core Protocol Contracts

**Uniswap Integration**

```solidity
// Factory Contract
address constant UNISWAP_V2_FACTORY = 0x01a43Ad6C4244F820d9238d37AEc4867854c1044;
// Router Contract
address constant UNISWAP_V2_ROUTER = 0xEf68B8853f1B79601617110218bA8aB14C077df2;
```

**Utility Contracts**

```solidity
// Multicall3 Contract
address constant MULTICALL3 = 0x9dE69f908Daf532019d2DeF8f7344e6Fc872F0dc;
```

### Integration Examples

**Router Configuration**

```typescript
const ROUTER_CONFIG = {
  factory: '0x01a43Ad6C4244F820d9238d37AEc4867854c1044',
  router: '0xEf68B8853f1B79601617110218bA8aB14C077df2',
  wguru: '0xc339E17eFD801724937A645B7e356CFA8be85279'
};
```

**Liquidity Functions**

```solidity
interface IUniswapV2Router {
    function addLiquidity(
        address tokenA,
        address tokenB,
        uint amountADesired,
        uint amountBDesired,
        uint amountAMin,
        uint amountBMin,
        address to,
        uint deadline
    ) external returns (uint amountA, uint amountB, uint liquidity);
}
```


# Using Guru

**Testnet**

Guru Network Testnet can be added as a custom network to any EVM-compatible wallet (i.e. [MetaMask](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn)).

#### MetaMask[​](https://docs.base.org/docs/using-base#metamask) <a href="#metamask" id="metamask"></a>

To add Guru as a custom network to MetaMask:

1. Open the MetaMask browser extension.
2. Open the network selection dropdown menu by clicking the dropdown button at the top of the extension.
3. Click the **Add network** button.
4. Click **Add a network manually**.
5. In the **Add a network manually** dialog that appears, enter the following information for Guru testnet:

| Name            | Value                                    |
| --------------- | ---------------------------------------- |
| Network Name    | Guru Network Testnet                     |
| Description     | Guru Network Testnet                     |
| RPC Endpoint    | <https://rpc.gurunetwork.ai/archive/261> |
| Chain ID        | 261                                      |
| Currency Symbol | tGURU                                    |
| Block Explorer  | <https://scan.gurunetwork.ai>            |

1. Tap the Save button to save Guru Network Testnet as a network.

You should now be able to connect to the Guru by selecting it from the network selection dropdown menu.


