holochain_data 0.7.0-dev.21

Database abstraction layer for Holochain using sqlx
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! `TxRead<Dht>` / `TxWrite<Dht>` API for the `LimboWarrant` table.

use super::super::inner::limbo_warrant::{self, InsertLimboWarrant};
use crate::handles::{TxRead, TxWrite};
use crate::kind::Dht;
use crate::models::dht::LimboWarrantRow;
use holo_hash::DhtOpHash;
use holochain_timestamp::Timestamp;

impl TxWrite<Dht> {
    pub async fn insert_limbo_warrant(&mut self, w: InsertLimboWarrant<'_>) -> sqlx::Result<()> {
        limbo_warrant::insert_limbo_warrant(self.conn_mut(), w).await
    }

    pub async fn delete_limbo_warrant(&mut self, hash: DhtOpHash) -> sqlx::Result<()> {
        limbo_warrant::delete_limbo_warrant(self.conn_mut(), hash).await
    }

    /// Set the system-validation status for the given warrant. Returns the number of rows updated.
    pub async fn set_limbo_warrant_sys_validation_status(
        &mut self,
        hash: &DhtOpHash,
        status: Option<i64>,
    ) -> sqlx::Result<u64> {
        limbo_warrant::set_sys_validation_status(self.conn_mut(), hash, status).await
    }

    /// Atomically promote a `LimboWarrant` row to the `Warrant` table using
    /// the current transaction. `when_integrated` is stamped on the new
    /// `Warrant` row.
    ///
    /// Returns `true` if the limbo row existed and was promoted, `false` if it
    /// did not exist.  The caller's transaction is used — commit or rollback is
    /// the caller's responsibility.
    pub async fn promote_limbo_warrant(
        &mut self,
        hash: &DhtOpHash,
        when_integrated: Timestamp,
    ) -> sqlx::Result<bool> {
        limbo_warrant::promote_to_warrant(self.conn_mut(), hash, when_integrated).await
    }
}

impl TxRead<Dht> {
    pub async fn get_limbo_warrant(
        &mut self,
        hash: DhtOpHash,
    ) -> sqlx::Result<Option<LimboWarrantRow>> {
        limbo_warrant::get_limbo_warrant(self.conn_mut(), hash).await
    }

    pub async fn limbo_warrants_pending_sys_validation(
        &mut self,
        limit: u32,
    ) -> sqlx::Result<Vec<LimboWarrantRow>> {
        limbo_warrant::limbo_warrants_pending_sys_validation(self.conn_mut(), limit).await
    }

    pub async fn limbo_warrants_ready_for_integration(
        &mut self,
        limit: u32,
    ) -> sqlx::Result<Vec<LimboWarrantRow>> {
        limbo_warrant::limbo_warrants_ready_for_integration(self.conn_mut(), limit).await
    }
}