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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

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

use super::super::inner::limbo_chain_op::{self, InsertLimboChainOp};
use crate::handles::{TxRead, TxWrite};
use crate::kind::Dht;
use crate::models::dht::LimboChainOpRow;
use holo_hash::DhtOpHash;
use holochain_integrity_types::dht_v2::OpValidity;
use holochain_timestamp::Timestamp;

impl TxWrite<Dht> {
    pub async fn insert_limbo_chain_op(&mut self, op: InsertLimboChainOp<'_>) -> sqlx::Result<()> {
        limbo_chain_op::insert_limbo_chain_op(self.conn_mut(), op).await
    }

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

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

    /// Set the app-validation status for the given op. Returns the number of rows updated.
    pub async fn set_limbo_chain_op_app_validation_status(
        &mut self,
        op_hash: &DhtOpHash,
        status: Option<i64>,
    ) -> sqlx::Result<u64> {
        limbo_chain_op::set_app_validation_status(self.conn_mut(), op_hash, status).await
    }

    /// Force both sys and app validation status to `Rejected`, bypassing the
    /// normal ordering constraints.  Returns the number of rows updated.
    pub async fn force_reject_limbo_chain_op(&mut self, op_hash: &DhtOpHash) -> sqlx::Result<u64> {
        limbo_chain_op::force_reject(self.conn_mut(), op_hash).await
    }

    /// Atomically promote a `LimboChainOp` row to the `ChainOp` table using
    /// the current transaction.
    ///
    /// 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_chain_op(
        &mut self,
        op_hash: &DhtOpHash,
        validation_status: OpValidity,
        when_integrated: Timestamp,
    ) -> sqlx::Result<bool> {
        limbo_chain_op::promote_to_chain_op(
            self.conn_mut(),
            op_hash,
            validation_status,
            when_integrated,
        )
        .await
    }
}

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

    pub async fn limbo_chain_ops_pending_sys_validation(
        &mut self,
        limit: u32,
    ) -> sqlx::Result<Vec<LimboChainOpRow>> {
        limbo_chain_op::limbo_chain_ops_pending_sys_validation(self.conn_mut(), limit).await
    }

    pub async fn limbo_chain_ops_pending_app_validation(
        &mut self,
        limit: u32,
    ) -> sqlx::Result<Vec<LimboChainOpRow>> {
        limbo_chain_op::limbo_chain_ops_pending_app_validation(self.conn_mut(), limit).await
    }

    pub async fn limbo_chain_ops_ready_for_integration(
        &mut self,
        limit: u32,
    ) -> sqlx::Result<Vec<LimboChainOpRow>> {
        limbo_chain_op::limbo_chain_ops_ready_for_integration(self.conn_mut(), limit).await
    }
}