Skip to content

zunxbt/aztec-sequencer-node

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 

Repository files navigation

Aztec Sequencer Node Guide

Aztec is building a decentralized, privacy-focused network and the sequencer node is a key part of it. Running a sequencer helps produce and propose blocks using regular consumer hardware. This guide will walk you through setting one up on the testnet.

Note : There’s no official confirmation of any rewards, airdrop, or incentives. This is purely for learning, contribution and being early in a cutting-edge privacy project.

💻 System Requirements

Component Specification
CPU 8-core Processor
RAM 16 GiB
Storage 1 TB SSD
Internet Speed 25 Mbps Upload / Download

Note

You can start running this node on a 4-core CPU, 6 GB of RAM and 25 GB of storage. However, as uptime increases, it's important to meet the recommended system requirements—otherwise, your node may eventually crash.

🌐 Rent VPS

Note

Renting VPS is not necessarily needed if your main goal is to take Apprentice role on Aztec Discord, You can run this node on WSL for 30 mins to get that role

Tip

If you don't know what a VPS is or how to buy one, you should watch this video on my YouTube channel.

⚙️ Prerequisites

  • You can use Alchemy or Infura to get Sepolia Ethereum RPC.
  • You can use Chainstack to get the Consensus URL (Beacon RPC URL).
  • Create a new evm wallet and fund it with at least 2.5 Sepolia ETH if you want to register as Validator.

Important

If you're using the free version and reach the maximum request limit on either the Sepolia Ethereum RPC or the Sepolia Consensus (Beacon RPC) URL, you'll need to either upgrade to a premium plan or change the RPC endpoint each time you hit the limit.

📥 Installation

Tip

You can watch this video to learn how to set up aztec sequencer node very easily.

  • Install curl and wget first
(command -v curl >/dev/null 2>&1 && command -v wget >/dev/null 2>&1) || sudo apt-get update; command -v curl >/dev/null 2>&1 || sudo apt-get install -y curl; command -v wget >/dev/null 2>&1 || sudo apt-get install -y wget
  • Execute either of the following commands to run your Aztec node
[ -f "aztec.sh" ] && rm aztec.sh; curl -sSL -o aztec.sh https://raw.githubusercontent.com/zunxbt/aztec-sequencer-node/main/aztec.sh && chmod +x aztec.sh && ./aztec.sh

or

[ -f "aztec.sh" ] && rm aztec.sh; wget -q -O aztec.sh https://raw.githubusercontent.com/zunxbt/aztec-sequencer-node/main/aztec.sh && chmod +x aztec.sh && ./aztec.sh

⚡Commands

  • You can use this command to check logs of your node
sudo docker logs -f --tail 100 $(docker ps -q --filter ancestor=aztecprotocol/aztec:latest | head -n 1)
  • You can stop this node using this command
sudo docker stop $(docker ps -q --filter ancestor=aztecprotocol/aztec:latest | head -n 1)

🧩 Post-Installation

Note

After running node, you should wait at least 10 to 20 mins before your run these commands

  • Use this command to get block-number
curl -s -X POST -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","method":"node_getL2Tips","params":[],"id":67}' http://localhost:8080 | jq -r '.result.proven.number'
  • After running this code, you will get a block number like this : 66666

  • Use that block number in the places of block-number in the below command to get proof

Screenshot 2025-05-02 120017

curl -s -X POST -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","method":"node_getArchiveSiblingPath","params":["block-number","block-number"],"id":67}' http://localhost:8080 | jq -r ".result"
  • Now navigate to operators | start-here channel in Aztec Discord Server
  • Use the following command to get Apprentice role
/operator start
  • It will ask the address , block-number and proof , Enter all of them one by one and you will get Apprentice instantly

🚀 Register as Validator

Warning

You may see an error like ValidatorQuotaFilledUntil when trying to register as a validator, which means the daily quota has been reached—convert the provided Unix timestamp to local time to know when you can try again to register as Validator.

  • Replace SEPOLIA-RPC-URL , YOUR-PRIVATE-KEY , YOUR-VALIDATOR-ADDRESS with actual value and then execute this command
aztec add-l1-validator \
  --l1-rpc-urls SEPOLIA-RPC-URL \
  --private-key YOUR-PRIVATE-KEY \
  --attester YOUR-VALIDATOR-ADDRESS \
  --proposer-eoa YOUR-VALIDATOR-ADDRESS \
  --staking-asset-handler 0xF739D03e98e23A7B65940848aBA8921fF3bAc4b2 \
  --l1-chain-id 11155111

About

One click guide to run aztec sequencer node.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages