load0 data layer

About Load Network optimistic & high performance data layer

load0 is Bundler's Large Bundle on steroids -- a cloud-like experience to upload and download data from Load Network using the Bundler's 0xbabe2 transaction format powered with SuperAccount & S3 under the hood.

To obtain API key and unlock higher limits, create an API key on cloud.load.network

Technical Architecture

First, the user sends data to the load0 REST API /upload endpoint -- the data is pushed to load0's S3 bucket and returns an optimistic hash (keccak hash) which allows the users to instantly retrieve the object data from load0.

After being added to the load0 bucket, the object gets added to the orchestrator queue that uploads the optimistic cached objects to Load Network. Using Large Bundle & SuperAccount, the S3 bucket objects get sequentially uploaded to Load and therefore, permanently stored while maintaining very fast uploads and downloads. Object size limit: 1 byte -> 2GB.

tx lifecycle

REST API

1- Upload object

curl -X POST "https://load0.network/upload" \
  --data-binary "@./video.mp4" \
  -H "Content-Type: video/mp4" \
  -H "X-Load-Authorization: $YOUR_LNCP_AUTH_TOKEN"

2- Download object (browser)

GET https://load0.network/download/{optimistic_hash}

Also, to have endpoints similiarity as in bundler.load.rs, you can do:

GET https://load0.network/resolve/{optimistic_hash}

3- Retrieve Bundle metadata using optimistic hash or bundle txid (once settled)

GET https://load0.network/bundle/optimistic/{op_hash}
GET https://load0.network/bundle/load/{bundle_txid}

Returns:

pub struct Bundle {
    pub id: u32,
    pub optimistic_hash: String,
    pub bundle_txid: String,
    pub data_size: u32,
    pub is_settled: bool,
    pub content_type: String
}

An object data can be accessed via:

  • optimistic caching: https://load0.network/resolve/{Bundle.optimistic_hash}

  • from Load Network (once settled): https://bundler.load.rs/v2/resolve/{Bundle.bundle_txid}

Source code: https://github.com/loadnetwork/load0/

Last updated