blockfrost 1.2.3

A Rust SDK for Blockfrost.io API
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
95
96
97
98
99
100
101
102
103
104
105
106

use crate::*;
use blockfrost_openapi::models::{
    script::Script, script_cbor::ScriptCbor, script_json::ScriptJson,
    script_redeemers_inner::ScriptRedeemersInner, scripts_inner::ScriptsInner,
};

impl BlockfrostAPI {
    /// Return the list of scripts.
    pub async fn scripts(&self, pagination: Pagination) -> BlockfrostResult<Vec<ScriptsInner>> {
        self.call_paged_endpoint("/scripts", pagination).await
    }

    /// Return information about a specific script.
    pub async fn scripts_by_id(&self, script_hash: &str) -> BlockfrostResult<Script> {
        self.call_endpoint(format!("/scripts/{script_hash}").as_str())
            .await
    }

    /// Return the JSON representation of a timelock script.
    pub async fn scripts_hash_json(&self, script_hash: &str) -> BlockfrostResult<ScriptJson> {
        self.call_endpoint(format!("/scripts/{script_hash}/json").as_str())
            .await
    }

    /// Return the CBOR representation of a Plutus script.
    pub async fn scripts_hash_cbor(&self, script_hash: &str) -> BlockfrostResult<ScriptCbor> {
        self.call_endpoint(format!("/scripts/{script_hash}/cbor").as_str())
            .await
    }

    /// Return the list of redeemers for a specific script.
    pub async fn scripts_redeemers(
        &self, script_hash: &str, pagination: Pagination,
    ) -> BlockfrostResult<Vec<ScriptRedeemersInner>> {
        self.call_paged_endpoint(
            format!("/scripts/{script_hash}/redeemers").as_str(),
            pagination,
        )
        .await
    }

    /// Return the JSON value of a datum by its hash.
    pub async fn scripts_datum_hash(
        &self, datum_hash: &str,
    ) -> BlockfrostResult<serde_json::Value> {
        self.call_endpoint(format!("/scripts/datum/{datum_hash}").as_str())
            .await
    }

    /// Return the CBOR representation of a datum by its hash.
    pub async fn scripts_datum_hash_cbor(
        &self, datum_hash: &str,
    ) -> BlockfrostResult<serde_json::Value> {
        self.call_endpoint(format!("/scripts/datum/{datum_hash}/cbor").as_str())
            .await
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::json;

    #[tokio::test]
    async fn test_scripts() {
        let json_value = json!([
            {
                "script_hash": "13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"
            },
            {
                "script_hash": "e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e"
            },
            {
                "script_hash": "a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54"
            }
        ]);
        serde_json::from_value::<Vec<ScriptsInner>>(json_value).unwrap();
    }

    #[tokio::test]
    async fn test_scripts_by_id() {
        let json_value = json!({
            "script_hash": "13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1",
            "type": "plutusV1",
            "serialised_size": 3119
        });
        serde_json::from_value::<Script>(json_value).unwrap();
    }

    #[tokio::test]
    async fn test_scripts_redeemers() {
        let json_value = json!([
            {
                "tx_hash": "1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0",
                "tx_index": 0,
                "redeemer_data_hash": "2a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0",
                "purpose": "spend",
                "datum_hash": "3a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0",
                "unit_mem": "1700",
                "unit_steps": "476468",
                "fee": "172033"
            }
        ]);
        serde_json::from_value::<Vec<ScriptRedeemersInner>>(json_value).unwrap();
    }
}