Share an Object

Generate a time-limited URL that anyone can use to download an object.

⚠️ Warning

Share URLs are public links. A share URL grants access to anyone who has it. There is no way to restrict it to specific users or revoke it once shared. Even after the URL expires, anyone who accessed it could have pinned the object into their own account.

If you need permissioned sharing, build your own access layer on top of pinned objects.

rust

use chrono::{Duration, Utc};
 
let obj = sdk.object(&object_id).await?;
 
let expires = Utc::now() + Duration::hours(1);
let share_url = sdk.share_object(&obj, expires)?;
 
println!("Share URL: {share_url}");

rust

use sia_storage::DownloadOptions;
use tokio::io::AsyncReadExt;
 
let shared_obj = sdk.shared_object(share_url).await?;
 
let (mut writer, mut reader) = tokio::io::duplex(64 * 1024);
 
let download_fut = async {
    sdk.download(&mut writer, &shared_obj, DownloadOptions::default()).await?;
    drop(writer);
    Ok::<(), Box<dyn std::error::Error>>(())
};
 
let read_fut = async {
    let mut bytes = Vec::new();
    reader.read_to_end(&mut bytes).await?;
    Ok::<Vec<u8>, Box<dyn std::error::Error>>(bytes)
};
 
let (_, bytes) = tokio::try_join!(download_fut, read_fut)?;
println!("Downloaded: {}", String::from_utf8_lossy(&bytes));

Generate a share URL

Download from a share URL