balius-sdk 0.5.2

SDK for building Headless dApps on UTxO-based blockchains
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

pub(crate) mod asset_math;
pub mod plutus;

#[derive(Debug, thiserror::Error)]
pub enum BuildError {
    #[error("Builder is incomplete")]
    Incomplete,
    #[error("Conflicting requirement")]
    Conflicting,
    #[error("UTxO decoding failed")]
    UtxoDecode,
    #[error("UTxO set is empty")]
    EmptyUtxoSet,
    #[error("Transaction has no inputs")]
    MalformedScript,
    #[error("Could not decode address")]
    MalformedAddress,
    #[error("Could not decode datum bytes")]
    MalformedDatum,
    #[error("Invalid bytes length for datum hash")]
    MalformedDatumHash,
    #[error("Input/policy pointed to by redeemer not found in tx")]
    RedeemerTargetMissing,
    #[error("Invalid network ID")]
    InvalidNetworkId,
    #[error("Corrupted transaction bytes in built transaction")]
    CorruptedTxBytes,
    #[error("Public key for private key is malformed")]
    MalformedKey,
    #[error("Asset name must be 32 bytes or less")]
    AssetNameTooLong,
    #[error("Asset value must be less than 9223372036854775807")]
    AssetValueTooHigh,
    #[error("Total outputs of this transaction are greater than total inputs")]
    OutputsTooHigh,
    #[error("Invalid asset policy id hex")]
    MalformedAssetPolicyIdHex,
    #[error("Malformed TxoRef")]
    MalformedTxoRef,
    #[error("Ledger error: {0}")]
    LedgerError(String),
}

impl From<crate::wit::balius::app::ledger::LedgerError> for BuildError {
    fn from(err: crate::wit::balius::app::ledger::LedgerError) -> Self {
        BuildError::LedgerError(err.to_string())
    }
}

use std::sync::Arc;

pub use pallas_codec as codec;
pub use pallas_primitives::conway as primitives;
pub use utxorpc_spec::utxorpc::v1alpha::cardano::PParams;

pub trait Ledger {
    fn read_utxos(&self, refs: &[dsl::TxoRef]) -> Result<dsl::UtxoSet, BuildError>;
    fn search_utxos(&self, pattern: &dsl::UtxoPattern) -> Result<dsl::UtxoSet, BuildError>;
    fn read_params(&self) -> Result<PParams, BuildError>;
}

#[derive(Clone)]
pub struct BuildContext {
    pub network: primitives::NetworkId,
    pub pparams: PParams,
    pub total_input: primitives::Value,
    pub spent_output: primitives::Value,
    pub estimated_fee: u64,
    pub ledger: Arc<Box<dyn Ledger>>,

    pub tx_body: Option<primitives::TransactionBody>,
    pub parent_output: Option<primitives::TransactionOutput>,
}

impl BuildContext {
    pub fn with_parent_output(&self, output: primitives::TransactionOutput) -> Self {
        let mut ctx = self.clone();
        ctx.parent_output = Some(output);
        ctx
    }
}

mod build;
mod dsl;

pub use build::*;
pub use dsl::*;