Crate car_mirror_reqwest

car-mirror-reqwest

A helper library that helps making car-mirror client requests using reqwest.

Examples

use car_mirror::{cache::NoCache, common::Config};
use car_mirror_reqwest::RequestBuilderExt;
use reqwest::Client;
use wnfs_common::{BlockStore, MemoryBlockStore, CODEC_RAW};

// Say, you have a webserver that supports car-mirror requests running:
tokio::spawn(car_mirror_axum::serve(MemoryBlockStore::new()));

// You can issue requests from your client like so:
let store = MemoryBlockStore::new();
let data = b"Hello, world!".to_vec();
let root = store.put_block(data, CODEC_RAW).await?;

let client = Client::new();
client
    .post(format!("http://localhost:3344/dag/push/{root}"))
    .run_car_mirror_push(root, &store, &NoCache) // rounds of push protocol
    .await?;

let store = MemoryBlockStore::new(); // clear out data
client
    .post(format!("http://localhost:3344/dag/pull/{root}"))
    .run_car_mirror_pull(root, &Config::default(), &store, &NoCache) // rounds of pull protocol
    .await?;

assert!(store.has_block(&root).await?);

Enums

• Error
  Possible errors raised in this library

Traits

• RequestBuilderExt
  Extension methods on RequestBuilders for sending car mirror protocol requests.

Functions

• pull_with
  Run (possibly multiple rounds of) the car mirror pull protocol.
• push_with
  Run (possibly multiple rounds of) the car mirror push protocol.