{"id":13751194,"url":"https://github.com/paradigmxyz/alphanet","last_synced_at":"2025-05-09T23:32:22.453Z","repository":{"id":233300006,"uuid":"765376485","full_name":"paradigmxyz/alphanet","owner":"paradigmxyz","description":"Reth AlphaNet is a testnet OP Stack-compatible rollup aimed at enabling experimentation of bleeding edge Ethereum Research.","archived":true,"fork":false,"pushed_at":"2024-11-24T00:28:27.000Z","size":1901,"stargazers_count":173,"open_issues_count":5,"forks_count":32,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-05-04T22:59:09.211Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paradigmxyz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-29T19:55:46.000Z","updated_at":"2025-04-25T16:34:10.000Z","dependencies_parsed_at":"2024-05-29T21:32:47.016Z","dependency_job_id":"cb083e2b-ed2d-4837-a6c8-137bf102831e","html_url":"https://github.com/paradigmxyz/alphanet","commit_stats":null,"previous_names":["paradigmxyz/alphanet"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Falphanet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Falphanet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Falphanet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Falphanet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paradigmxyz","download_url":"https://codeload.github.com/paradigmxyz/alphanet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253341963,"owners_count":21893546,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T09:00:38.821Z","updated_at":"2025-05-09T23:32:21.959Z","avatar_url":"https://github.com/paradigmxyz.png","language":"Rust","funding_links":[],"categories":["Development Tools ##","Layer 2","Dev Tools"],"sub_categories":["Optimism","Use-case: Turning ETH into an ERC-20 compatible token"],"readme":"# alphanet\n\n\u003c!-- [![Crates.io][crates-badge]][crates-io] --\u003e\n\u003c!-- [![Downloads][downloads-badge]][crates-io] --\u003e\n[![MIT License][mit-badge]][mit-url]\n[![Apache-2.0 License][apache-badge]][apache-url]\n[![CI Status][actions-badge]][actions-url]\n\n\u003e [!IMPORTANT]\n\u003e This repo has been moved to [Odyssey](https://github.com/ithacaxyz/odyssey) and is no longer being maintained.\n\n## What is Reth AlphaNet?\n\nReth AlphaNet is a testnet OP Stack rollup aimed at enabling experimentation of bleeding edge Ethereum Research.\nAlphaNet is __not__ a fork of reth.\nAlphaNet implements traits provided by the [reth node builder API](https://paradigmxyz.github.io/reth/docs/reth_node_builder/index.html), allowing implementation of precompiles and instructions of experimental EIPs without forking the node.\n\nSpecifically, AlphaNet currently implements the following EIPs:\n - [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702): Set EOA account code.\n - [EIP-7212](https://eips.ethereum.org/EIPS/eip-7212): Precompile for secp256r1 curve support.\n - [EIP-2537](https://eips.ethereum.org/EIPS/eip-2537): Precompiles for BLS12-381 curve operations.\n\nAlphaNet also implements the EIPs for EOF, or [The EVM Object Format](https://evmobjectformat.org/).\n\n### Why AlphaNet?\n\nAlphaNet has 2 goals:\n1. Showcase Reth's performance at the extremes. We intend to launch a hosted version of AlphaNet on [Conduit](https://conduit.xyz/), targeting 50mgas/s, and eventually ramping up to 1ggas/s and beyond. In the process we hope to hit the state growth performance bottleneck, and discover ways to solve it. If our hosted chains end up getting too big, we may possibly restart the experiment from zero, and try again.\n2. Showcase how Reth's modular architecture can serve as a distribution channel for research ideas. Specifically,\nAlphaNet's node extensions were chosen for their ability to enable applications that enhance the onchain user experience, and\ndrastically reduce cost for existing applications that improve UX.\n\n### AlphaNet Local Development\n\nAlphaNet does not yet have a running testnet, but can be run locally for development and testing purposes. To do this, the binary can be run with the `--dev` flag, which will start the node with a development configuration.\n\nFirst, alphanet should be built locally:\n```bash\ngit clone https://github.com/paradigmxyz/alphanet\ncd alphanet\ncargo install --path bin/alphanet\n```\n\n```bash\nalphanet node --chain etc/alphanet-genesis.json --dev --http --http.api all\n```\n\nThis will start the node with a development configuration, and expose the HTTP API on `http://localhost:8545`.\n\nTo use EOF-enabled foundry, use [forge-eof](https://github.com/paradigmxyz/forge-eof) and follow installation instructions.\n\n### Running AlphaNet\n\n\u003e [!WARNING]\n\u003e\n\u003e AlphaNet does not yet have a running testnet, please use the local development instructions above!\n\nRunning AlphaNet will require running additional infrastructure for the archival L1 node. These instructions are a guide for\nrunning the AlphaNet OP-stack node only.\n\nFor instructions on running the full AlphaNet OP stack, including the L1 node, see the [Reth book section on running the OP stack](https://paradigmxyz.github.io/reth/run/optimism.html), using the `alphanet` binary instead of `op-reth`.\n\n#### Running the alphanet execution node\n\nTo run AlphaNet from source, clone the repository and run the following commands:\n\n```bash\ngit clone https://github.com/paradigmxyz/alphanet.git\ncd alphanet\ncargo install --path bin/alphanet\nalphanet node\n    --chain etc/alphanet-genesis.json \\\n    --rollup.sequencer-http \u003cTODO\u003e \\\n    --http \\\n    --ws \\\n    --authrpc.port 9551 \\\n    --authrpc.jwtsecret /path/to/jwt.hex\n```\n\n#### Running op-node with the alphanet configuration\n\nOnce `alphanet` is started, [`op-node`](https://github.com/ethereum-optimism/optimism/tree/develop/op-node) can be run with the\nincluded `alphanet-rollup.json`:\n\n```bash\ncd alphanet/\nop-node \\\n    --rollup.config ./etc/alphanet-rollup.json \\\n    --l1=\u003cyour-sepolia-L1-rpc\u003e \\\n    --l2=http://localhost:9551 \\\n    --l2.jwt-secret=/path/to/jwt.hex \\\n    --rpc.addr=0.0.0.0 \\\n    --rpc.port=7000 \\\n    --l1.trustrpc\n```\n\n### Running AlphaNet with Kurtosis\n\nRunning a local network with a full AlphaNet OP stack with Kurtosis requires some extra setup, since AlphaNet uses a forked version of `op-node`.\n\nTo get started, follow [these instructions](https://docs.kurtosis.com/install/) to install Kurtosis.\n\nNext, clone and build the modified `optimism-contract-deployer` image:\n\n```bash\ngit clone git@github.com:paradigmxyz/optimism-package.git\ncd optimism-package\ngit switch alphanet\ndocker build . -t ethpandaops/optimism-contract-deployer:latest --progress plain\n```\n\n\u003e [!NOTE]\n\u003e\n\u003e The image may fail to build if you have not allocated enough memory for Docker.\n\nFinally, run start a Kurtosis enclave (ensure you are still in `optimism-package`):\n\n```bash\nkurtosis run --enclave op-devnet github.com/paradigmxyz/optimism-package@alphanet \\\n  --args-file https://raw.githubusercontent.com/paradigmxyz/alphanet/main/etc/kurtosis.yaml\n```\n\nThis will start an enclave named `op-devnet`. You can tear down the enclave with `kurtosis enclave rm --force op-devnet`, or tear down all enclaves using `kurtosis clean -a`.\n\n\u003e [!NOTE]\n\u003e\n\u003e If you want to use a custom build of AlphaNet, simply build an AlphaNet image with `docker build . -t ghcr.io/paradigmxyz/alphanet:latest`.\n\nConsult the [Kurtosis OP package](https://github.com/ethpandaops/optimism-package) repository for instructions on how to adjust the args file to spin up additional services, like a block exporer.\n\n### Security\n\nSee [SECURITY.md](SECURITY.md).\n\n#### License\n\n\u003csup\u003e\nLicensed under either of \u003ca href=\"LICENSE-APACHE\"\u003eApache License, Version\n2.0\u003c/a\u003e or \u003ca href=\"LICENSE-MIT\"\u003eMIT license\u003c/a\u003e at your option.\n\u003c/sup\u003e\n\n\u003cbr\u003e\n\n\u003csub\u003e\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in these crates by you, as defined in the Apache-2.0 license,\nshall be dual licensed as above, without any additional terms or conditions.\n\u003c/sub\u003e\n\n\u003c!-- [crates-badge]: https://img.shields.io/crates/v/alphanet.svg --\u003e\n\u003c!-- [crates-io]: https://crates.io/crates/alphanet --\u003e\n\u003c!-- [downloads-badge]: https://img.shields.io/crates/d/alphanet --\u003e\n[mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg\n[apache-badge]: https://img.shields.io/badge/license-Apache--2.0-blue.svg\n[mit-url]: LICENSE-MIT\n[apache-url]: LICENSE-APACHE\n[actions-badge]: https://github.com/paradigmxyz/alphanet/workflows/unit/badge.svg\n[actions-url]: https://github.com/paradigmxyz/alphanet/actions?query=workflow%3ACI+branch%3Amain\n[foundry-alphanet]: https://github.com/paradigmxyz/foundry-alphanet\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmxyz%2Falphanet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparadigmxyz%2Falphanet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmxyz%2Falphanet/lists"}