near-api-types 0.8.4

Rust types library to interact with NEAR Protocol via RPC 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
107
108
109
110
111
112
113
114
115
116
117

use borsh::{BorshDeserialize, BorshSerialize};
use serde::{Deserialize, Serialize};

use crate::{AccountId, CryptoHash, NearToken, StorageUsage, errors::DataConversionError};

#[derive(
    Serialize, Deserialize, Debug, Clone, BorshSerialize, BorshDeserialize, PartialEq, Eq, Default,
)]
pub enum ContractState {
    GlobalHash(CryptoHash),
    GlobalAccountId(AccountId),
    LocalHash(CryptoHash),
    #[default]
    None,
}

impl ContractState {
    pub const fn from_global_contract_hash(hash: CryptoHash) -> Self {
        Self::GlobalHash(hash)
    }

    pub const fn from_local_hash(hash: CryptoHash) -> Self {
        Self::LocalHash(hash)
    }
}

impl From<AccountId> for ContractState {
    fn from(value: AccountId) -> Self {
        Self::GlobalAccountId(value)
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Account {
    pub amount: NearToken,
    pub contract_state: ContractState,
    pub locked: NearToken,
    pub storage_usage: StorageUsage,
}

impl TryFrom<near_openapi_types::AccountView> for Account {
    type Error = DataConversionError;

    fn try_from(value: near_openapi_types::AccountView) -> Result<Self, Self::Error> {
        let near_openapi_types::AccountView {
            amount,
            code_hash,
            global_contract_account_id,
            global_contract_hash,
            locked,
            storage_paid_at: _, // Intentionally ignoring this field. See (https://github.com/near/nearcore/issues/2271)
            storage_usage,
        } = value;

        let code_hash = CryptoHash::from(code_hash);

        let contract_state = match (code_hash, global_contract_account_id, global_contract_hash) {
            (_, _, Some(hash)) => ContractState::from_global_contract_hash(hash.into()),
            (_, Some(account_id), _) => account_id.into(),
            (hash, _, _) if hash == CryptoHash::default() => ContractState::None,
            (hash, _, _) => ContractState::from_local_hash(hash),
        };

        Ok(Self {
            amount,
            contract_state,
            locked,
            storage_usage,
        })
    }
}

impl serde::Serialize for Account {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        let version = AccountVersion::V2;
        let code_hash = match self.contract_state {
            ContractState::LocalHash(hash) => hash,
            _ => CryptoHash::default(),
        };
        let repr = SerdeAccount {
            amount: self.amount,
            locked: self.locked,
            code_hash,
            storage_usage: self.storage_usage,
            version,
            global_contract_hash: match &self.contract_state {
                ContractState::GlobalHash(hash) => Some(*hash),
                _ => None,
            },
            global_contract_account_id: match &self.contract_state {
                ContractState::GlobalAccountId(account_id) => Some(account_id.clone()),
                _ => None,
            },
        };
        serde::Serialize::serialize(&repr, serializer)
    }
}

#[derive(Serialize, Deserialize, Debug, Clone, BorshSerialize, BorshDeserialize, PartialEq, Eq)]
pub enum AccountVersion {
    V1,
    V2,
}

#[derive(Serialize, Deserialize, Debug, Clone, BorshSerialize, BorshDeserialize, PartialEq, Eq)]
pub struct SerdeAccount {
    pub amount: NearToken,
    pub locked: NearToken,
    pub code_hash: CryptoHash,
    pub storage_usage: u64,
    pub version: AccountVersion,
    pub global_contract_hash: Option<CryptoHash>,
    pub global_contract_account_id: Option<AccountId>,
}