#cid #ipld #bitswap

blockstore

An IPLD blockstore capable of holding arbitrary data indexed by CID

9 releases (breaking)

0.7.0 Sep 13, 2024
0.6.1 Aug 13, 2024
0.6.0 Jun 27, 2024
0.5.0 Apr 15, 2024
0.1.1 Jan 15, 2024

#154 in Asynchronous

Download history 3785/week @ 2024-07-18 5402/week @ 2024-07-25 3884/week @ 2024-08-01 4985/week @ 2024-08-08 5044/week @ 2024-08-15 4591/week @ 2024-08-22 3967/week @ 2024-08-29 4861/week @ 2024-09-05 4498/week @ 2024-09-12 3995/week @ 2024-09-19 4821/week @ 2024-09-26 4490/week @ 2024-10-03 4221/week @ 2024-10-10 4682/week @ 2024-10-17 5690/week @ 2024-10-24 6902/week @ 2024-10-31

22,584 downloads per month
Used in 6 crates (4 directly)

Apache-2.0

51KB
1K SLoC

Blockstore

An IPLD blockstore capable of holding arbitrary data indexed by CID.

use blockstore::{Blockstore, InMemoryBlockstore};
use blockstore::block::{Block, CidError};
use cid::Cid;
use multihash_codetable::{Code, MultihashDigest};

const RAW_CODEC: u64 = 0x55;

struct RawBlock(Vec<u8>);

impl Block<64> for RawBlock {
    fn cid(&self) -> Result<Cid, CidError> {
        let hash = Code::Sha2_256.digest(&self.0);
        Ok(Cid::new_v1(RAW_CODEC, hash))
    }

    fn data(&self) -> &[u8] {
        self.0.as_ref()
    }
}

async fn put_and_get() {
    let block = RawBlock(vec![0xde, 0xad]);
    let cid = block.cid().unwrap();

    let blockstore = InMemoryBlockstore::<64>::new();
    blockstore.put(block).await.unwrap();

    let block = blockstore.get(&cid).await.unwrap();

    assert_eq!(block, Some(vec![0xde, 0xad]));
}

tokio::runtime::Builder::new_current_thread()
    .enable_all()
    .build()
    .unwrap()
    .block_on(put_and_get());

Contributing

We welcome contributions! Please fork the repository and submit a pull request.

License

Blockstore is licensed under the Apache 2.0 License. See the LICENSE file for more details.

About Eiger

We are engineers. We contribute to various ecosystems by building low level implementations and core components.

Contact us at hello@eiger.co Follow us on X/Twitter

Dependencies

~1.7–10MB
~99K SLoC