# Cytonic network

**Cytonic** is an L1 blockchain designed to create a unique ecosystem that is open to all technologies used in Web3. Cytonic offers several advantages for users and protocols, including:

* **Zero-effort onboarding** for DeFi protocols, even from non-EVM ecosystems.
* **Compatibility with existing developer tools** across all supported blockchains.
* **Integration with existing wallets**, allowing users to maintain their preferred level of security.
* [**A new method**](/multi-vm/cross-vm-calls) **for creating highly interoperable apps**, enabling developers to build applications compatible with all supported ecosystems.

<figure><img src="/files/5gaP5wK5RjSJoH6BZ3Xk" alt=""><figcaption></figcaption></figure>

## Why another L1?&#x20;

Cytonic faces the challenge of building a robust ecosystem with its own strong tokenomics. As an L1 blockchain, it must maintain its own validators, which contributes to the stability of its native token through a PoS (Proof of Stake) consensus mechanism.\
Due to Cytonic's unique multi-virtual machine technology, its goal is to be interoperable with all ecosystems without being part of any single one.

## How Cytonic works

### Zero effort onboarding

Cytonic enables developers from any ecosystem to deploy their protocols on Cytonic with just a few clicks, similar to the integration process for EVM-compatible DeFi protocols with additional blockchains (when they go multichain). Detailed integration guidelines can be found in the corresponding [section](#integration-with-existing-wallets).

### Compatibility with existing developer tools

Due to Cytonic's compatibility features, you can use your preferred tools for Solana, Ethereum, and other supported blockchains. Cytonic ensures a degree of compatibility and supports the use of SDKs and frameworks that are well-established and trusted by the crypto community.

### **Integration with existing wallets**

Users can access protocols deployed on any Cytonic runtime using their preferred wallet. This is made possible through a highly interoperable system of virtual machine communication.

### Atomic parallelism&#x20;

Cytonic aims to implement a solution that will enable scaling of its consensus mechanism while maintaining atomic transaction execution and leaving the dApp execution layer unaffected.


# Multi virtual machine

The core of Cytonic is it's unique multi-virtual machine that is compatible with Solana VM, EVM and other existing VMs

## What is a VM?

VM is a part of blockchain used to execute user's transactions and invoke smart contracts. Virtual machine is tightly connected with the blockchain architecture. DIfferent VM is for example the reason why you can't use Solana programs on Ethereum and reverse.&#x20;

## Our solution

We offer a new type of virtual machine that adapts based on the transaction type being sent. This allows dApps from Solana, Ethereum, and other blockchains to coexist seamlessly on the Cytonic chain. Additionally, we provide a highly interoperable and native solution for dApps to communicate with one another.

## Synchronous execution

Our multi-virtual-machine is designed to execute transactions within a single block, addressing the complications and vulnerabilities associated with modern scaling blockchains while maintaining compatibility with them.


# Cytonic Ethereum

***

Cytonic Ethereum Testnet is a Layer 2 (L2) Ethereum Virtual Machine (EVM)-compatible blockchain designed for scalable, low-cost decentralized applications. This documentation provides essential details for developers to interact with the network.

Network Details

| Field               | Value                                                          |
| ------------------- | -------------------------------------------------------------- |
| **Network Name**    | Cytonic Ethereum Testnet                                       |
| **RPC URL**         | `https://rpc.evm.testnet.cytonic.com`                          |
| **Chain ID**        | `0xCC02` (52226 in decimal)                                    |
| **Block Explorer**  | `https://explorer.evm.testnet.cytonic.com`                     |
| **Currency Symbol** | ССС (test token)                                               |
| **Faucet**          | Contact the team or check official resources for testnet $ССС. |

### Connecting to the Network

1\. MetaMask Configuration

1. Open MetaMask and click the network dropdown.
2. Select **Add Network**.
3. Fill in the details:
   * **Network Name**: `Cytonic Ethereum Testnet`
   * **New RPC URL**: `https://rpc.evm.testnet.cytonic.com`
   * **Chain ID**: `52226` (or `0xCC02`)
   * **Currency Symbol**: `CCC`
   * **Block Explorer**: `https://explorer.evm.testnet.cytonic.com`

2\. Hardhat Configuration

Add the network to `hardhat.config.js`:

```javascript
module.exports = {
  networks: {
    cytonicTestnet: {
      url: "https://rpc.evm.testnet.cytonic.com",
      chainId: 52226,
      accounts: [process.env.PRIVATE_KEY]
    }
  }
};
```

3\. Foundry (Forge) Configuration

Add the RPC to `foundry.toml`:

```toml
[rpc_endpoints]
cytonicTestnet = "https://rpc.evm.testnet.cytonic.com"

[profile.default]
chain_id = 52226
```

***

### Example Contract Deployment

Simple Storage Contract

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract SimpleStorage {
    uint256 public value;

    function setValue(uint256 _value) external {
        value = _value;
    }
}
```

Deployment Script (Hardhat)

```javascript
async function main() {
  const Contract = await ethers.getContractFactory("SimpleStorage");
  const contract = await Contract.deploy();
  await contract.deployed();
  console.log("Deployed to:", contract.address);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

Run with:

```bash
npx hardhat run scripts/deploy.js --network cytonicTestnet
```

***

### Interacting with the Blockchain

Using ethers.js

```javascript
const provider = new ethers.providers.JsonRpcProvider(
  "https://rpc.evm.testnet.cytonic.com"
);
const contract = new ethers.Contract(
  "0xYourContractAddress",
  ["function value() view returns (uint256)", "function setValue(uint256)"],
  provider
);

// Read value
const value = await contract.value();
console.log("Value:", value.toString());
```

***

### Troubleshooting

1. **Transaction Stuck?**\
   Ensure your gas fee is sufficient. Use the block explorer to check network congestion.
2. **Chain ID Mismatch**\
   Verify the Chain ID is `52226` (or `0xCC02`).
3. **RPC Connection Issues**\
   Double-check the RPC URL for typos. Test connectivity using tools like `curl`.

***

### Support

For assistance, join the Cytonic developer community:\
[Discord Support Server](https://discord.gg/cytonic)

***

**Note**: $CCC tokens on the testnet have no real-world value. Always use testnet funds for development purposes.


# Cytonic Solana

Cytonic Solana Testnet is a Solana Virtual Machine (SVM)-compatible blockchain optimized for high-speed transactions and low fees. This documentation provides key details for developers to build and interact with the network.

***

Network Details

| Field              | Value                                                     |
| ------------------ | --------------------------------------------------------- |
| **Network Name**   | Cytonic Solana Testnet                                    |
| **RPC URL**        | `https://rpc.svm.testnet.cytonic.com/rpc`                 |
| **Block Explorer** | `https://explorer.svm.testnet.cytonic.com`                |
| **Token Symbol**   | CCC (test token)                                          |
| **Faucet**         | Request testnet CCC tokens via the Cytonic faucet or CLI. |

***

### Connecting to the Network

1\. Phantom Wallet Configuration

1. Open Phantom Wallet and navigate to **Settings** > **Networks**.
2. Click **Add Network** and enter:
   * **Network Name**: `Cytonic Solana Testnet`
   * **RPC URL**: `https://rpc.svm.testnet.cytonic.com/rpc`
   * **Token**: `CCC`

2\. Solana CLI Configuration

Set the CLI to use Cytonic Solana Testnet:

```bash
solana config set --url https://rpc.svm.testnet.cytonic.com/rpc
```

3\. Anchor Configuration

Update `Anchor.toml` for your project:

```toml
[provider]
cluster = "cytonic-svm-testnet"
wallet = "~/.config/solana/id.json"

[programs.localnet]
your_program = "YourProgramAddress"

[scripts]
test = "yarn run test"
```

***

### Example Program Deployment

Simple Counter Program (Rust)

```rust
use anchor_lang::prelude::*;

declare_id!("YourProgramID");

#[program]
pub mod counter {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.count = 0;
        Ok(())
    }

    pub fn increment(ctx: Context<Increment>) -> Result<()> {
        let counter = &mut ctx.accounts.counter;
        counter.count += 1;
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize<'info> {
    #[account(init, payer = user, space = 8 + 8)]
    pub counter: Account<'info, Counter>,
    #[account(mut)]
    pub user: Signer<'info>,
    pub system_program: Program<'info, System>,
}

#[derive(Accounts)]
pub struct Increment<'info> {
    #[account(mut)]
    pub counter: Account<'info, Counter>,
}

#[account]
pub struct Counter {
    pub count: u64,
}
```

Deploy with Solana CLI

```bash
# Build and deploy
anchor build
anchor deploy --provider.cluster https://rpc.svm.testnet.cytonic.com/rpc
```

***

### Interacting with the Blockchain

Using @solana/web3.js

```javascript
import { Connection, PublicKey, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection("https://rpc.svm.testnet.cytonic.com/rpc");
const programId = new PublicKey("YourProgramID");

// Fetch account data
const counterAccount = new PublicKey("CounterAccountAddress");
const accountInfo = await connection.getAccountInfo(counterAccount);
console.log("Counter value:", accountInfo.data.readUInt64LE(0));
```

***

### Troubleshooting

1. **RPC Timeouts**\
   Check your internet connection or switch to the WebSocket URL for real-time updates.
2. **Transaction Not Confirmed**\
   Use the Solana CLI to check status:

   ```bash
   solana confirm -v <TRANSACTION_SIGNATURE>
   ```
3. **Program ID Mismatch**\
   Ensure the program ID matches the deployed address on the Cytonic block explorer.

***

### Support

Join the Cytonic developer community for assistance:\
[Discord Server](https://discord.gg/cytonic)

***

**Note**: $CCC tokens on the testnet have no monetary value. Use them only for development and testing.


# Tokenomics

{% hint style="info" %}
Tokenomics can change according to strategy
{% endhint %}

## Initial Investment Round: 19.38%

Allocation of tokens bought by investors.

## Team: 12%

Rewards for the core team members that take part in developing the protocol.

## Cytonic Ecosystem Contributors: 25%

This includes all airdrop epochs and contributions that help the protocol grow in the initial scaling phase.

## Cytonic Foundation: 43.62%

Token reservers held by the foundation.


# Overview

The Cytonic airdrop campaign is designed to incentivize users and help bootstrap the initial blockchain TVL and ecosystem. The campaign will unfold over several rounds, each with different conditions.

The first phase will last approximately 6 months and will conclude with the mainnet launch. Subsequent phases will run on-chain and focus on promoting the growth of the Cytonic ecosystem.

### Concept

Cytonic offers a [list](/airdrop/contracts) of [audited](/airdrop/security) contracts deployed across multiple blockchains. Users can deposit supported tokens into these contracts, which will earn rewards throughout the airdrop campaign. These rewards can be utilized within the airdrop app. More info about earnings can be found [here](/airdrop/energy-and-flames).

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

After the mainnet launch, users' funds will be bridged to the Cytonic chain and will be accessible there. Additionally, users will receive Cytonic's native token as a reward on the Cytonic chain.

{% hint style="info" %}
The amount of native tokens received will depend on the user's Flames value at the end of the airdrop campaign. This amount will be calculated using a uniform ratio applicable to all participants.
{% endhint %}


# Accounts

## Creating account

An account is created by signing a message with a wallet. This wallet address will be permanently associated with the account and cannot be changed. Any deposits or withdrawals made using this address will affect only this account.

The first address used to create the wallet is considered the primary address and will be used to claim airdrop funds. However, the primary address can later be changed to any other address linked to this account.

## Linking Twitter

A linked Twitter account enables a set of actions that are available only when Twitter is connected. Each Twitter account can be connected only once.

When you link your Twitter account, your account name will be inherited from your Twitter name. This process can be done only once and cannot be changed later. If you prefer to keep your Twitter data private, linking also allows you to conceal this information.

## Linking account

A new address can be linked to your account. This option is available on the deposits page when you make a deposit from a wallet that is not yet linked, while logged in as a specific user.

{% hint style="info" %}
If a new account has already been created for an address or if the address is already linked, the attempt to link it will fail. This cannot be altered and may result in your energy and Flames being distributed across multiple accounts.
{% endhint %}


# Energy and Flames

## Energy

Energy is the primary currency used during the airdrop campaign. It is earned based on the deposited value on any supported chain and accumulates continuously, with updates occurring approximately every hour.\
Additionally, Energy can be earned by completing [achievements](/airdrop/guidelines/achievements) and claiming their associated rewards.

## Flames

Flames is the currency that will be used later for token distribution. It is typically earned by opening chests or receiving lottery rewards.


# Lottery

The lottery is designed as the exclusive place to convert lottery tickets into [energy](/airdrop/energy-and-flames). Tickets can be earned by opening chests. The Lottery distributes the jackpot proportionally based on the percentage of lottery tickets entered (entries). \
Each entry included in the jackpot distribution participates based on the highest tier it reaches. For example, if an entry falls within the top 1% of winners, it only claims a portion of the 1% jackpot distribution. The distribution follows this structure:

<table><thead><tr><th>Place</th><th>Jackpot percent distributed</th><th data-hidden></th></tr></thead><tbody><tr><td>#1</td><td>20%</td><td></td></tr><tr><td>#2</td><td>10%</td><td></td></tr><tr><td>#3</td><td>5%</td><td></td></tr><tr><td>First 1%</td><td>25%</td><td></td></tr><tr><td>First 5%</td><td>20%</td><td></td></tr><tr><td>First 10%</td><td>15%</td><td></td></tr><tr><td>First 15%</td><td>4%</td><td></td></tr><tr><td>First 20%</td><td>1%</td><td></td></tr></tbody></table>

Users can participate in a single lottery with multiple entries. In this case, the user's overall standing is determined by the highest-ranking entry they submitted.\
The [energy](/airdrop/energy-and-flames) jackpot starts with a sufficient base value and can increase over time. Each lottery lasts for one week.


# Referral program

The referral program allows users to earn extra Energy based on the Energy earned by users they have invited through TVL provision. In the Cytonic referral program, users can earn 15% of the Energy earned by those they directly invite and 7% of the Energy earned by users referred by their invitees.\
Referral program don't work for other types of earnings (e.g if user wins lottery, then his reward is only given to him, not to user that invited him).\
You can create a referral code by meeting one of two conditions: maintaining a $10 deposit in your account or connecting your account to Twitter.

> **Warning:** You can only create one referral code, and it cannot be changed later. If you create the code by meeting the $10 deposit condition, it will only remain valid as long as your deposit is worth $10 or more.

Referral code can be created on the dashboard in the corresponding section.


# Chests

## Overview

Chests are the primary way to convert energy into Flames. There are four types of chests on the platform: Common, Rare, Epic, and Legendary. Each chest has a different cost and contains varying rewards. For more information about chest types and rewards, visit the related app page.

<figure><img src="/files/HvbBLrNbjyLA0WAYtwvH" alt=""><figcaption><p>Types of chests</p></figcaption></figure>

## Rewards

When opening a chest, you receive a single reward of one of the following types:

* Energy
* Flames
* Lottery tickets
* Chests (of the same type as the one opened)
* Other rewards that are periodically added to the app

If you win a chest as a reward, it will be added to your inventory and prioritized over energy when opening that type of chest next time.

<figure><img src="/files/HJgAqDq5YPu05YjZM8r8" alt=""><figcaption><p>Rarity types</p></figcaption></figure>

Rewards vary in rarity, which is indicated by their color. The rarer the reward, the less frequently it is distributed. The types of rarity are:

* Common (white)
* Rare (blue)
* Epic (purple)
* Mythical (red)
* Legendary (gold)

## Boosts

Boosts are a special feature that allows you to increase all rewards in chests by a specific multiplier. The available multipliers are 2x, 3x, or 4x. Using a boost consumes extra energy based on the multiplier value you select.

{% hint style="info" %}
Chests in inventory can't be used to boost your pack. It can only be made with energy&#x20;
{% endhint %}


# Levels & Achievements

## Overview

For all additional reward distributions, achievements are utilized. Achievements reward users with energy, which can be claimed and spent.

There are multiple types of achievements, with the primary distinction being between one-time achievements and laddered achievements.

## Ladder achievements

<figure><img src="/files/JpLK65R2WpFHCnsbe8D5" alt=""><figcaption><p>Ladder achievement example</p></figcaption></figure>

Ladder achievements are achievements with a progression counter. These types of achievements offer multiple rewards at different milestones. For example, opening one rare chest might reward you with a certain amount of energy, while opening three rare chests will grant you a larger reward.

## Levels

Levels are awarded for completing achievements and are accompanied by energy rewards in the corresponding section. Each level is numbered and categorised, with the maximum level being 21.

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

New level types are unlocked as you reach specific level milestones:

* **Bronze**: Starting from level 1
* **Silver**: Starting from level 3
* **Gold**: Starting from level 9
* **Diamond**: Starting from level 15
* **Cytoshi**: Awarded at level 21

## Weekly quests

Weekly quests are tasks with a set deadline, typically involving social media activities or depositing funds under specific conditions. These quests are frequently updated and offer extra energy rewards for completing certain actions.

## Meme olympics

Meme Olympics are tasks where you can win if the Cytonic Twitter account likes or reposts your meme. Meme Olympics function as ladder achievements, meaning the more memes you create that get noticed, the more energy rewards you can earn.

## Deposit till mainnet

This is a special type of achievement. If your account has not had any withdrawals before the app transitions to mainnet, you will receive a doubling of your total Flames.


# Guidelines


# Deposit

To make a deposit, first log in to your account. Create an account or sign in using the "Log in / Register" button. Once logged in, go to the deposit page, select your preferred blockchain and token, enter the amount, and click the deposit button. Connect your wallet to complete the deposit.

<figure><img src="/files/d68gm2yJTm7h2NkdeVUT" alt=""><figcaption><p>Make a deposit</p></figcaption></figure>

You can also take advantage of our referral system. To do so, follow a referral link or enter a referral code in the field to the right of the deposit section.

<figure><img src="/files/ePPbzpc1S3nVke4JScma" alt=""><figcaption><p>Referral code</p></figcaption></figure>

Earn a free Inferno Chest with any deposit of $20 or more.

<figure><img src="/files/9TKXqpT3vkGhkQOg3m6e" alt=""><figcaption><p>Free chest</p></figcaption></figure>


# Get my referral code

Share your referral link to earn 15% of the energy from each referral. You’ll also receive 7% of the energy from anyone referred by your referrals.

To create your referral link, you must make a deposit of $10 or connect your X account.&#x20;

<figure><img src="/files/9Z6oImQd4VrfpsfK0mNx" alt=""><figcaption><p>Default</p></figcaption></figure>

Go to Dashboard, create and enter your referral code in the input field that appears.&#x20;

<figure><img src="/files/YEs4Rt1CzcIBmKNsxW7G" alt=""><figcaption><p>Creation</p></figcaption></figure>

*Note: You can set your referral code only once; it cannot be changed later.*&#x20;

<figure><img src="/files/UA46anQDR3tb8qn39pL3" alt=""><figcaption><p>Created</p></figcaption></figure>

Once created, you can share your referral code with others on X, along with your referral link.


# Chest Opening

Open chests to earn Flames, energy, additional chests, and lottery tickets. Here’s how:

1. Go to the chests page.
2. Select the desired chest and click on it.
3. Press "Open."

<figure><img src="/files/EGhdUBj369W1jXmLmRpq" alt=""><figcaption><p>Chests page</p></figcaption></figure>

You can adjust the chest opening animation with the "Play animation" button. To increase your rewards, consider using a booster.&#x20;

<figure><img src="/files/ipAYJAEYTBZlMMvNJbyy" alt=""><figcaption><p>Ember chest</p></figcaption></figure>

Share your achievements on X for extra energy.

<figure><img src="/files/mmbeki4isXQ6v0lSXJsv" alt=""><figcaption><p>Share in X</p></figcaption></figure>


# Achievements

Complete tasks to earn energy. Visit the Achievements page, open any tab, and complete a task. To claim your earned energy, press "Claim" next to the completed task

<figure><img src="/files/wYSuc8wLt4isFIjx47ib" alt=""><figcaption><p>Achievements page</p></figcaption></figure>


# Lottery

Participate in the lottery to win additional energy. Go to the lottery page and, if you have lottery tickets, enter the lottery with the desired number of tickets. If you haven't tickets, try to win them in the Chest. Wait for the lottery to end to see if you’ve won

<figure><img src="/files/laokF8QVlTXCeBcdNQmB" alt=""><figcaption><p>Lottery</p></figcaption></figure>

Prizes are distributed according to the following scheme

<figure><img src="/files/b8vEbNAGhoCdvxlBa9h3" alt=""><figcaption><p>Distribution of prizes</p></figcaption></figure>


# Withdraw

You can withdraw your funds from Saitonix at any time. On the deposit page, switch to the "Withdraw" tab and enter the necessary details.&#x20;

<figure><img src="/files/AYB1uZtDagZMzpxD9jmf" alt=""><figcaption><p>Withdraw</p></figcaption></figure>

The withdrawal process takes 5 days. You can track and, if necessary, cancel a withdrawal in the “Pending” tab.

<figure><img src="/files/MfYO4UTF0iWzJRwukdRG" alt=""><figcaption><p>Pending withdraw</p></figcaption></figure>


# Security

All our contracts are audited and are managed by multisig accounts, which oversee the future migration of funds onto the Cytonic chain.

## Audit list

<table><thead><tr><th>Audit type</th><th>Contents</th><th data-hidden></th></tr></thead><tbody><tr><td>Zellic audit Solana &#x26; EVM</td><td></td><td></td></tr><tr><td>Fuzzland audit Solana &#x26; EVM</td><td></td><td></td></tr></tbody></table>

## Multisignature wallets

All Cytonic deposit contracts are controlled by multisignature wallets with external signers. In cases where a blockchain does not support multisig, we utilize AWS Key Management Service (KMS) to ensure security by creating a hardware wallet for funds. An example of this solution is the Bitcoin depositor.


# Contracts

## EVM chains

| Type             | Address                                    |
| ---------------- | ------------------------------------------ |
| Deposit contract | 0xaEA5Bf79F1E3F2069a99A99928927988EC642e0B |
|                  |                                            |
|                  |                                            |

## Solana

| Type            | Address                                      |
| --------------- | -------------------------------------------- |
| Deposit program | HYDqq5GfUj4aBuPpSCs4fkmeS7jZHRhrrQ3q72KsJdD4 |
|                 |                                              |
|                 |                                              |


# RPC Compatibility

Coming soon


# Cross VM calls

Coming soon


# Integrating existing app

Coming soon


# Testnet

Coming soon


# SVM

Coming soon


# Deploy Contract

Coming soon


# Call Contract

Coming soon


# Get blockchain data

Coming soon


# EVM

Coming soon


# Deploy contract

Coming soon


# Call contract

Coming soon


# Get blockchain data

Coming soon


