dwn 0.4.0

Rust implementation of a Decentralized Web Node.
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use anyhow::bail;
use dwn_core::{
    message::{
        Message, Version,
        descriptor::{DateFilter, DateSort, RecordsQueryBuilder},
        mime::Mime,
    },
    reply::Reply,
};
use reqwest::Url;
use xdid::core::did::Did;

use crate::{Actor, records::RecordView};

impl Actor {
    pub fn query(&self) -> ActorQueryBuilder<'_> {
        ActorQueryBuilder {
            actor: self,
            msg: RecordsQueryBuilder::default(),
            auth: true,
            target: None,
        }
    }
}

pub struct ActorQueryBuilder<'a> {
    actor: &'a Actor,
    msg: RecordsQueryBuilder,
    auth: bool,
    target: Option<&'a Did>,
}

impl<'a> ActorQueryBuilder<'a> {
    pub fn attester(mut self, value: Did) -> Self {
        self.msg.filter.attester = Some(value);
        self
    }

    pub fn recipient(mut self, value: Did) -> Self {
        self.msg.filter.recipient = Some(value);
        self
    }

    pub fn schema(mut self, value: String) -> Self {
        self.msg.filter.schema = Some(value);
        self
    }

    pub fn record_id(mut self, value: String) -> Self {
        self.msg.filter.record_id = Some(value);
        self
    }

    pub fn protocol(mut self, value: String) -> Self {
        self.msg.filter.protocol = Some(value);
        self
    }

    pub fn protocol_path(mut self, value: String) -> Self {
        self.msg.filter.protocol_path = Some(value);
        self
    }

    pub fn protocol_version(mut self, value: Version) -> Self {
        self.msg.filter.protocol_version = Some(value);
        self
    }

    pub fn data_format(mut self, value: Mime) -> Self {
        self.msg.filter.data_format = Some(value);
        self
    }

    pub fn date_created(mut self, value: DateFilter) -> Self {
        self.msg.filter.date_created = Some(value);
        self
    }

    pub fn date_sort(mut self, value: DateSort) -> Self {
        self.msg.filter.date_sort = Some(value);
        self
    }

    /// Whether to authorize the message.
    /// Defaults to `true`.
    pub fn auth(mut self, value: bool) -> Self {
        self.auth = value;
        self
    }

    /// Sets the target DID for DWN processing.
    /// Defaults to the actor's own DID.
    pub fn target(mut self, value: &'a Did) -> Self {
        self.target = Some(value);
        self
    }

    fn build(self) -> anyhow::Result<Message> {
        let mut msg = self.msg.build()?;

        if self.auth {
            self.actor.authorize(&mut msg)?;
        }

        Ok(msg)
    }

    /// Sends the message to a remote DWN.
    pub async fn send(self, url: &Url) -> anyhow::Result<Vec<RecordView>> {
        let actor = self.actor;
        let target = self.target.unwrap_or(&actor.did);

        let msg = self.build()?;

        let reply = actor.send(target, &msg, url).await?;

        parse_reply(reply)
    }

    /// Processes the message with the actor's DWN.
    pub async fn process(self) -> anyhow::Result<Vec<RecordView>> {
        let actor = self.actor;
        let target = self.target.unwrap_or(&actor.did);

        let msg = self.build()?;

        let reply = actor
            .dwn
            .process_message(target, msg)
            .await
            .map_err(|e| anyhow::anyhow!("failed to process message: {e}"))?;

        parse_reply(reply)
    }
}

fn parse_reply(reply: Option<Reply>) -> anyhow::Result<Vec<RecordView>> {
    match reply {
        Some(Reply::RecordsQuery(query)) => Ok(query
            .entries
            .into_iter()
            .map(RecordView::from_entry)
            .collect::<Result<Vec<_>, _>>()?),
        Some(other) => {
            bail!("got invalid reply from DWN: {other:?}")
        }
        None => {
            bail!("got no reply from DWN")
        }
    }
}