holochain_data 0.7.0-rc.0

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

//! `DbRead<Dht>` / `DbWrite<Dht>` API for the `ChainOp` table.

use super::super::inner::chain_op::{self, InsertChainOp, OpLocationRow, PendingReceiptRow};
use crate::handles::{DbRead, DbWrite};
use crate::kind::Dht;
use crate::models::dht::ChainOpRow;
use holo_hash::{ActionHash, AnyDhtHash, DhtOpHash};
use holochain_integrity_types::action::OpValidity;

impl DbWrite<Dht> {
    pub async fn insert_chain_op(&self, op: InsertChainOp<'_>) -> sqlx::Result<()> {
        chain_op::insert_chain_op(self.pool(), op).await
    }

    /// Update `validation_status` for the given op. Returns the number of rows updated.
    pub async fn set_chain_op_validation_status(
        &self,
        op_hash: &DhtOpHash,
        validation_status: OpValidity,
    ) -> sqlx::Result<u64> {
        chain_op::set_validation_status(self.pool(), op_hash, validation_status).await
    }

    /// Clear the `require_receipt` flag on the `ChainOp` row for the given op.
    /// Returns the number of rows updated.
    pub async fn clear_chain_op_require_receipt(&self, op_hash: &DhtOpHash) -> sqlx::Result<u64> {
        chain_op::clear_require_receipt(self.pool(), op_hash).await
    }
}

impl DbRead<Dht> {
    pub async fn get_chain_op(&self, hash: DhtOpHash) -> sqlx::Result<Option<ChainOpRow>> {
        let mut conn = self.timed_conn().await?;
        chain_op::get_chain_op(&mut *conn, hash).await
    }

    pub async fn get_chain_ops_by_basis(&self, basis: AnyDhtHash) -> sqlx::Result<Vec<ChainOpRow>> {
        let mut conn = self.timed_conn().await?;
        chain_op::get_chain_ops_by_basis(&mut *conn, basis).await
    }

    /// `(hash, basis_hash, storage_center_loc)` for every integrated chain op.
    pub async fn integrated_op_locations(&self) -> sqlx::Result<Vec<OpLocationRow>> {
        let mut conn = self.timed_conn().await?;
        chain_op::integrated_op_locations(&mut *conn).await
    }

    pub async fn get_chain_ops_for_action(
        &self,
        action_hash: ActionHash,
    ) -> sqlx::Result<Vec<ChainOpRow>> {
        let mut conn = self.timed_conn().await?;
        chain_op::get_chain_ops_for_action(&mut *conn, action_hash).await
    }

    /// Terminal validation outcome of the chain op for `(action_hash,
    /// op_type)`, from `ChainOp` or `LimboChainOp`. See
    /// `chain_op::op_validation_outcome`.
    pub async fn op_validation_outcome(
        &self,
        action_hash: &ActionHash,
        op_type: i64,
    ) -> sqlx::Result<Option<i64>> {
        let mut conn = self.timed_conn().await?;
        chain_op::op_validation_outcome(&mut *conn, action_hash, op_type).await
    }

    /// Return integrated, validated `ChainOp` rows that still require a
    /// validation receipt to be sent.
    pub async fn pending_validation_receipts(&self) -> sqlx::Result<Vec<PendingReceiptRow>> {
        let mut conn = self.timed_conn().await?;
        chain_op::pending_validation_receipts(&mut *conn).await
    }
}