> For the complete documentation index, see [llms.txt](https://docs.substreams.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.substreams.dev/tutorials/intro-to-tutorials/elysium.md).

# on Elysium

In this tutorial, you'll learn how to initialize an Elysium-based Substreams project using the Substreams CLI (`substreams init` command).

{% hint style="info" %}
The CLI installation is supported only on Linux and macOS. If you're using Windows, consider using the [DevContainer environment](https://docs.substreams.dev/reference-material/development-tools/devcontainer-ref.md), which launches a Linux-based virtual environment.
{% endhint %}

{% hint style="info" %}
**Tip**: Using an AI coding assistant? Install the [Substreams agent skills](https://docs.substreams.dev/how-to-guides/develop-your-own-substreams/general/agent-skills.md) to get expert Substreams guidance while building.
{% endhint %}

### About Elysium

[Elysium](https://elysium.kinetiq.xyz/docs/what-is-elysium) is a general-purpose, high-performance L2 for Hyperliquid, built by Kinetiq on Arbitrum Orbit (Nitro/ArbOS). It settles to HyperEVM, and HYPE is its native gas token.

### Step 1: Initialize Your Elysium Substreams Project

1. [Install the Substreams CLI](https://docs.substreams.dev/how-to-guides/installing-the-cli.md).
2. Running `substreams init` will give you the option to choose the EVM protocol, then select one of the project options that best fits your requirements:
   * **evm-hello-world**: Creates a simple Substreams that outputs the events of a smart contract.
   * **evm-events-calls-raw**: (without ABI) Get raw EVM events/calls and create a Substreams as source. You'll need to specify the contract address(es) that you want to follow.
   * **evm-events-calls**: (with ABI) Decode EVM events/calls using an ABI and create a Substreams as source. You'll need to specify the contract address(es) that you want to follow. You can look up contracts and their verified ABIs on the [Elysium Explorer](https://elysium.kinetiq.xyz/explorer). If the CLI can't retrieve an ABI automatically, you'll need to provide it yourself.

### Step 2: Configure Your Elysium Endpoint

When running your Substreams commands, use the Elysium endpoint:

```bash
substreams run -e mainnet.elysium.streamingfast.io:443 substreams.yaml [module_name] --start-block [block_number]
```

### Step 3: Visualize the Data

1. Run `substreams auth` to create your [account](https://thegraph.market/) and generate an authentication token (JWT), then pass this token back as input.
2. Run `substreams build` to compile the project.
3. Run `substreams gui -e mainnet.elysium.streamingfast.io:443` to visualize and iterate on your extracted data.

### Step 3.5: (Optionally) Transform the Data

1. Open the `src/lib.rs` file that has been generated.
2. Modify the transformations made to the data as needed. Every time you modify the code, you will have to recompile the project with `substreams build`.

### Step 4: Load the Data

To make your Substreams queryable (as opposed to [direct streaming](https://docs.substreams.dev/how-to-guides/sinks/stream.md)), you can automatically send the data to a SQL database by using the [SQL sink](https://docs.substreams.dev/how-to-guides/sinks/sql.md) or through [PubSub](https://docs.substreams.dev/how-to-guides/sinks/pubsub.md).

### Elysium Specifics

Elysium is an EVM-compatible blockchain built on Arbitrum Nitro, which means:

* It uses the same [`sf.ethereum.type.v2.Block`](https://github.com/streamingfast/firehose-ethereum/blob/develop/proto/sf/ethereum/type/v2/type.proto) protobuf model as other EVM chains
* All EVM-based Substreams modules and patterns work seamlessly
* You can leverage existing EVM foundational modules and libraries
* Blocks are [Extended Blocks](https://docs.substreams.dev/reference-material/chain-support/chains-and-endpoints.md#evm-extended-vs-base-block-model), so rich data such as internal calls, balance changes, and storage changes is available
* `eth_call` is supported in Substreams modules
* Blocks are produced every 100 ms. Expect a much higher block rate than most EVM chains, which affects how quickly a backfill progresses and how much data you process per block range.
* Native currency is HYPE, which bridges 1:1 from HyperEVM and is used for gas and `msg.value`.

### Additional Resources

#### Elysium Endpoints

Elysium Substreams are available on the following endpoint:

* **Elysium Mainnet**: `mainnet.elysium.streamingfast.io:443`
* **Elysium Mainnet chain ID**: `99901`

#### Elysium Explorer

Use the [Elysium Explorer](https://elysium.kinetiq.xyz/explorer) to browse blocks, transactions and verified contracts, and to find the contract addresses and ABIs you want to follow.

#### Dev Container Reference

The [Dev Container Reference](https://docs.substreams.dev/reference-material/development-tools/devcontainer-ref.md) helps you navigate the container and its common errors.

#### CLI Reference

The [CLI reference](https://docs.substreams.dev/reference-material/command-line-interface.md) lets you explore all the tools available in the Substreams CLI.

#### Substreams Components Reference

The [Components Reference](https://docs.substreams.dev/reference-material/manifest-and-components/packages.md) dives deeper into navigating the `substreams.yaml`.

#### EVM Development Guide

Since Elysium is EVM-compatible, you can also refer to the general [EVM development guide](https://docs.substreams.dev/how-to-guides/develop-your-own-substreams/on-evm/exploring-ethereum.md) for more advanced patterns and techniques.
