WeaveVM Archiver is an ETL archive pipeline for EVM networks. It's the simplest way to interface with WeaveVM's permanent data feature without smart contract redeployments.
WeaveVM Archiver is the ideal choice if you want to:
- Interface with WeaveVM's permanent data settlement and high-throughput DA
- Maintain your current data settlement or DA architecture
- Have an interface with WeaveVM without rollup smart contract redeployments
- Avoid codebase refactoring
git clone https://github.com/weaveVM/wvm-archiver.git
cd wvm-archiver
cargo shuttle run
While a WeaveVM Archiver node can run without web2 component dependencies, this node implementation uses planetscale for cloud indexing (indexing target network block ID to WVM archive TXID) and shuttle.rs for backend hosting. Check .env.example to set up your environment variables.
archiver_pk="" // WeaveVM archiver PK
backfill_pk="" // WeaveVM backfill PK
backfill_start_block="0" // it defaults to 0 (genesis), but it's dynamic, so you can specify from which block number you want to start backfilling
network="./networks/your_network.json"
ps_livesync_table_name="LivesyncTableName"
ps_backfill_table_name="BackfillTableName"
DATABASE_HOST="" // planetscale
DATABASE_USERNAME="" // planetscale
DATABASE_PASSWORD="" // planetscale
To start archiving your network block data on WeaveVM:
- Add your network config file to the networks directory.
- Name your config file using snake_case syntax (e.g.,
your_network_name.json
). - Modify properties that don't have a
wvm_
prefix in the config JSON file. Check _template.json guide - Fund your
archiver_address
&backfill_address
with a sufficient amount of tWVM (1 MB costs ~ 5 cents). Check out WVM Faucet to claim $tWVM. Make sure that the two addresses are distinct. - Choose a unique
archive_pool_address
that's different from yourarchiver_address
&backfill_address
- set
start_block
value to the most recent network's blockheight. That will facilitate the archiver to start in sync with live blockheight while, in parallel, reindexing from genesis using thebackfill_address
. - Set up your PlanetScale DB according to
db_schema.sql
.
As mentioned previously, archiver_address
is responsible for archiving blocks starting from the start_block
specified in your network.json
config file, while also keeping up with the network’s current blockheight (live sync). Meanwhile, backfill_address
handles archiving blocks from backfill_start_block
up to start_block
.
backfill thread: backfill_start_block -> start_block
live sync thread: start_block -> network's live blockheight
You can use eRPC to cache, load-balance and failover between as many RPC endpoints and use eRPC's proxy URL in each network's config for WeaveVM. This will increase performance and resiliency and reduce RPC usage cost while fetching network's block data via WeaveVM.
# modify erpc.yaml
cp erpc.yaml.dist erpc.yaml
code erpc.yaml
# run docker-compose
docker-compose up -d
Finally, you can set eRPC's proxy URL in each relative network config.
{
"name": "Optimism",
"network_chain_id": 10,
"network_rpc": "http://erpc:4000/main/evm/10",
...
}
The WeaveVM Archiver node operates as follows:
- It starts downloading the target EVM network block data from the RPC you provide in the network config file.
- The node begins pulling blocks from the
start_block
defined in the network's config file. - The block data is then serialized in borsh format and compressed using Brotli.
- The serialized-compressed data is pushed to WeaveVM as calldata transaction from the
archiver_address
&backfill_address
to thearchive_pool_address
. - Simultaneously, the resulting TXID from pushing data to WeaveVM and the archived EVM block ID are indexed in the cloud for faster data retrieval.
As mentioned, PlanetScale is used for cloud indexing, which allows a WeaveVM Archiver node to expose its WeaveVM data as a RESTful API.
Node instance endpoint: https://metis.wvm.network
curl -X GET https://the_network.wvm.network/v1/info
returns:
pub struct InfoServerResponse {
first_livesync_archived_block: Option<u64>,
last_livesync_archived_block: Option<u64>,
first_backfill_archived_block: Option<u64>,
last_backfill_archived_block: Option<u64>,
livesync_start_block: u64,
total_archived_blocks: u64,
blocks_behind_live_blockheight: u64,
archiver_balance: U256,
archiver_address: String,
backfill_address: String,
backfill_balance: U256,
network_name: String,
network_chain_id: u32,
network_rpc: String,
}
curl -X GET https://the_network.wvm.network/v1/all-networks-info
returns:
Vec<Network>
curl -X GET https://the_network.wvm.network/v1/block/$BLOCK_ID
Decode the WVM archived block data for a given EVM block ID (return original block data in JSON format)
curl -X GET https://the_network.wvm.network/v1/block/raw/$BLOCK_ID
This project is licensed under the BSL 1.1 License