Load S3 Protocol

Migrate to a permanent S3-compatible object storage in a single line change

About

Load.Network provides an S3 implementation which enables developers to store files permanently in a decentralized manner by using the common AWS S3 Patterns with minimal change.

Installation

Load.Network is compatible with the S3 SDKs, because of this, you are able to use existing libraries.

NodeJS

To install the official S3 library in NodeJS, run the following command

$ yarn add @aws-sdk/client-s3

Initialization

In order to initialize the S3 client connected to Load Network, you can do the following:

import { S3Client } from "@aws-sdk/client-s3";

const accessKeyId = process.env.LOAD_ACCESS_KEY;
const secretAccessKey = ""; // It's meant to be empty

const s3Client = new S3Client({
    region: "eu-west-2", // Required -- current supported region
    endpoint: "https://s3.load.rs", // Load.Network S3 endpoint
    credentials: {
        accessKeyId,
        secretAccessKey,
    },
    forcePathStyle: true, // Required
});

- It looks similar to load_acc_*******
forcePathStyle set to true is always necessary.

Rust Examples

use aws_sdk_s3::error::SdkError;
use aws_sdk_s3::operation::create_bucket::CreateBucketError;
use aws_sdk_s3::Client;

pub async fn create_client() -> Client {
    let config = aws_config::from_env()
        .endpoint_url("https://s3.load.rs")
        .region("eu-west-2")
        .load()
        .await;

    let s3_config = aws_sdk_s3::config::Builder::from(&config)
        .force_path_style(true)
        .build();

    Client::from_conf(s3_config)
}

pub async fn s3_create_bucket() -> Result<(), SdkError<CreateBucketError>> {
    let client = create_client().await;
    
    match client.create_bucket()
        .bucket("LoadNetworkBucketTest")
        .send()
        .await {
            Ok(output) => {
                println!("✅ Bucket created: {}", output.location().unwrap_or("(no location)"));
                Ok(())
            },
            Err(err) => {
                println!("❌ Error creating bucket: {}", err);
                Err(err)
            }
    }
}

PreviousCloud Platform (LNCP)Nextload0 data layer

Last updated 6 days ago

import { S3Client } from "@aws-sdk/client-s3"; const accessKeyId = process.env.LOAD_ACCESS_KEY; const secretAccessKey = ""; // It's meant to be empty const s3Client = new S3Client({ region: "eu-west-2", // Required -- current supported region endpoint: "https://s3.load.rs", // Load.Network S3 endpoint credentials: { accessKeyId, secretAccessKey, }, forcePathStyle: true, // Required });

use aws_sdk_s3::error::SdkError; use aws_sdk_s3::operation::create_bucket::CreateBucketError; use aws_sdk_s3::Client; pub async fn create_client() -> Client { let config = aws_config::from_env() .endpoint_url("https://s3.load.rs") .region("eu-west-2") .load() .await; let s3_config = aws_sdk_s3::config::Builder::from(&config) .force_path_style(true) .build(); Client::from_conf(s3_config) } pub async fn s3_create_bucket() -> Result<(), SdkError<CreateBucketError>> { let client = create_client().await; match client.create_bucket() .bucket("LoadNetworkBucketTest") .send() .await { Ok(output) => { println!("✅ Bucket created: {}", output.location().unwrap_or("(no location)")); Ok(()) }, Err(err) => { println!("❌ Error creating bucket: {}", err); Err(err) } } }