farcaster-rs 1.0.1

A rust crate to interface & interact with the Farcaster.xyz contracts & APIs
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

use crate::constants::merkle::API_ROOT;
use crate::types::casts::casts::CastRoot;
use crate::types::user::user::UserInfo;
use crate::Farcaster;
use std::error::Error;

impl Farcaster {
    /// Get a users casts by their FID
    ///
    /// ## Params
    /// fid: i64
    /// limit: Option<i32>
    /// cursor: Option<&str>
    ///
    /// ## Example
    /// ```no_run
    /// let casts = farcaster.get_casts_by_fid(0, None, None).await?;
    /// ```
    pub async fn get_casts_by_fid(
        &self,
        fid: i64,
        limit: Option<i32>,
        cursor: Option<&str>,
    ) -> Result<CastRoot, Box<dyn Error>> {
        let mut url = format!("{}/v2/casts?fid={}", API_ROOT, fid);
        if limit.is_some() {
            url.push_str(format!("&limit={}", limit.unwrap()).as_str())
        }

        if cursor.is_some() {
            url.push_str(format!("&cursor={}", cursor.unwrap()).as_str())
        }

        println!("{}", url);

        let casts_reqwest = &self.reqwest_get(url.as_str()).await?;

        let casts: CastRoot = serde_json::from_str(casts_reqwest)?;

        Ok(casts)
    }

    /// Get a users casts by their Username
    ///
    /// ## Params
    /// username: &str
    /// limit: Option<i32>
    /// cursor: Option<&str>
    ///
    /// ## Example
    /// ```no_run
    /// let casts = farcaster.get_casts_by_username("cassie", None, None).await?;
    /// ```
    pub async fn get_casts_by_username(
        &self,
        username: &str,
        limit: Option<i32>,
        cursor: Option<&str>,
    ) -> Result<CastRoot, Box<dyn Error>> {
        let fid = &self.get_user_by_username(username).await?;

        let casts = &self.get_casts_by_fid(fid.fid, limit, cursor).await?;

        Ok(casts.clone())
    }

    /// Get a users casts by their Address
    ///
    /// ## Params
    /// address: &str
    /// limit: Option<i32>
    /// cursor: Option<&str>
    ///
    /// ## Example
    /// ```no_run
    /// let casts = farcaster.get_casts_by_address("0x0000....", None, None).await?;
    /// ```
    pub async fn get_casts_by_address(
        &self,
        address: &str,
        limit: Option<i32>,
        cursor: Option<&str>,
    ) -> Result<CastRoot, Box<dyn Error>> {
        let address: &UserInfo = &self.get_user_by_address(address).await?;

        let casts = &self.get_casts_by_fid(address.fid, limit, cursor).await?;

        Ok(casts.clone())
    }
}