Blazing-Fast SVM Ephemeral Validator: Clones accounts and programs just-in-time and settles state to a reference cluster.
The Ephemeral Validator is a Solana Virtual Machine Validator that clones accounts and programs just-in-time and settles state to a reference cluster. It is designed to be used in a MagicBlock Ephemeral Rollup instance to build any type of applications entirely on Solana, but can also be used as a super-charged development environment
Ephemeral Rollups extend Solana by enabling the Solana Virtual Machine (SVM) to replace centralized servers. They allow to use the SVM as a serverless, elastic compute for real-time use cases like fully onchain gaming, trustless high-frequency finance, decentralized social networks etc, while keeping all smart contracts and state on Solana.
The core intuition is that by harnessing the SVM’s account structure and its capacity for parallelization, we can split the app/game state into shards. Users can lock one or multiple accounts to temporarily transfer the state to an auxiliary layer, which we define as the “ephemeral rollup”, a configurable dedicated runtime.
The Ephemeral Rollups instances always originate from a reference cluster, which is the source of truth for the state (programs and accounts). The session is eventually settled back to the reference cluster.
For the full documentation, please refer to the Ephemeral Rollups page.
$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env
$ rustup component add rustfmt$ git clone https://github.com/magicblock-labs/ephemeral-conjunto.git
$ git clone https://github.com/magicblock-labs/ephemeral-validator.git
$ cd ephemeral-validator$ cargo buildThe validator supports configurations for the different use cases. The configuration files is a TOML file (some examples can be found in configs). Additionally, the configuration can be overridden by environment variables.
For example, to run the ephemeral validator on the devnet cluster, run:
$ cargo run -- configs/ephem-devnet.tomlAdditionally, the validator can also be run with docker: magicblocklabs/validator
Run the test suite:
$ make testRunning an integration test locally requires:
$ cd test-integration
$ ./configs/run-test-validator.sh$ cargo run -- configs/ephem-localnet.toml$ cargo test --test 01_invocations test_schedule_commit_directly_with_single_ix --profile testephemeral devnet- stable public cluster for development accessible via https://devnet.magicblock.app. It uses solana devnet as base cluster for cloning and settling.
All claims, content, designs, algorithms, estimates, roadmaps, specifications, and performance measurements described in this project are done with the MagicBlock Labs, Pte. Ltd. (“ML”) good faith efforts. It is up to the reader to check and validate their accuracy and truthfulness. Furthermore, nothing in this project constitutes a solicitation for investment.
Any content produced by ML or developer resources that ML provides are for educational and inspirational purposes only. ML does not encourage, induce or sanction the deployment, integration or use of any such applications (including the code comprising the MagicBlock blockchain protocol) in violation of applicable laws or regulations and hereby prohibits any such deployment, integration or use. This includes the use of any such applications by the reader (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction, (b) if the reader is located in or ordinarily resident in a country or territory subject to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC), or (c) if the reader is or is working on behalf of a Specially Designated National (SDN) or a person subject to similar blocking or denied party prohibitions.
The reader should be aware that U.S. export control and sanctions laws prohibit U.S. persons (and other persons that are subject to such laws) from transacting with persons in certain countries and territories or that are on the SDN list. Accordingly, there is a risk to individuals that other persons using any of the code contained in this repo, or a derivation thereof, may be sanctioned persons and that transactions with such persons would be a violation of U.S. export controls and sanctions law.
The Ephemeral Validator is in active development, so all APIs are subject to change. This code is unaudited. Use at your own risk.
The most up-to-date version of the ephemeral validator is developed in a private repository. We will periodically update this repository with the latest changes. If you wish to build from the latest version or report vulnerabilities or improvements, please contact us on Discord or Twitter.
Open Source is at the heart of what we do at Magicblock. We believe building software in the open, with thriving communities, helps leave the world a little better than we found it.