iota-sdk 0.3.0

The IOTA SDK provides developers with a seamless experience to develop on IOTA by providing account abstractions and clients to interact with node APIs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

// Copyright 2022 IOTA Stiftung
// SPDX-License-Identifier: Apache-2.0

//! Database provider interfaces and implementations.

#[cfg(feature = "stronghold")]
#[cfg_attr(docsrs, doc(cfg(feature = "stronghold")))]
mod stronghold;

use async_trait::async_trait;

#[cfg(feature = "stronghold")]
pub use self::stronghold::StrongholdStorageProvider;

/// The interface for database providers.
#[async_trait]
pub trait StorageProvider {
    type Error;

    /// Get a value out of the database.
    async fn get(&mut self, k: &[u8]) -> Result<Option<Vec<u8>>, Self::Error>;

    /// Insert a value into the database.
    ///
    /// If there exists a record under the same key as `k`, it will be replaced by the new value (`v`) and returned.
    async fn insert(&mut self, k: &[u8], v: &[u8]) -> Result<Option<Vec<u8>>, Self::Error>;

    /// Delete a value from the database.
    ///
    /// The deleted value is returned.
    async fn delete(&mut self, k: &[u8]) -> Result<Option<Vec<u8>>, Self::Error>;
}