neo3 1.0.9

Production-ready Rust SDK for Neo N3 blockchain with high-level API, unified error handling, and enterprise features
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

use primitive_types::H256;
use serde::{Deserialize, Deserializer, Serialize, Serializer};
use std::str::FromStr;

use neo3::prelude::{
	deserialize_h256, deserialize_script_hash, serialize_h256, serialize_script_hash, ScriptHash,
};

#[derive(Serialize, Deserialize, Clone, PartialEq, Eq, Hash, Debug)]
pub struct Nep11Transfers {
	pub sent: Vec<Nep11Transfer>,
	pub received: Vec<Nep11Transfer>,
	#[serde(rename = "address")]
	pub transfer_address: String,
}

#[derive(Serialize, Deserialize, Clone, PartialEq, Eq, Hash, Debug)]
pub struct Nep11Transfer {
	#[serde(rename = "tokenid")]
	pub token_id: String,
	pub timestamp: u64,
	#[serde(rename = "assethash")]
	#[serde(deserialize_with = "deserialize_script_hash")]
	#[serde(serialize_with = "serialize_script_hash")]
	pub asset_hash: ScriptHash,
	#[serde(rename = "transferaddress")]
	pub transfer_address: String,
	#[serde(deserialize_with = "deserialize_amount")]
	#[serde(serialize_with = "serialize_amount")]
	pub amount: u64,
	#[serde(rename = "blockindex")]
	pub block_index: u32,
	#[serde(rename = "transfernotifyindex")]
	pub transfer_notify_index: u32,
	#[serde(rename = "txhash")]
	#[serde(serialize_with = "serialize_h256")]
	#[serde(deserialize_with = "deserialize_h256")]
	pub tx_hash: H256,
}

impl Nep11Transfer {
	pub fn new(
		timestamp: u64,
		asset_hash: ScriptHash,
		transfer_address: String,
		amount: u64,
		block_index: u32,
		transfer_notify_index: u32,
		tx_hash: H256,
		token_id: String,
	) -> Self {
		Nep11Transfer {
			token_id,
			timestamp,
			asset_hash,
			transfer_address,
			amount,
			block_index,
			transfer_notify_index,
			tx_hash,
		}
	}
}

#[derive(Serialize, Deserialize, Clone, PartialEq, Eq, Hash, Debug)]
pub struct Nep17Transfers {
	pub sent: Vec<Nep17Transfer>,
	pub received: Vec<Nep17Transfer>,
	#[serde(rename = "address")]
	pub transfer_address: String,
}

#[derive(Serialize, Deserialize, Clone, PartialEq, Eq, Hash, Debug)]
pub struct Nep17Transfer {
	pub timestamp: u64,
	#[serde(rename = "assethash")]
	#[serde(deserialize_with = "deserialize_script_hash")]
	#[serde(serialize_with = "serialize_script_hash")]
	pub asset_hash: ScriptHash,
	#[serde(rename = "transferaddress")]
	pub transfer_address: String,
	#[serde(deserialize_with = "deserialize_amount")]
	#[serde(serialize_with = "serialize_amount")]
	pub amount: u64,
	#[serde(rename = "blockindex")]
	pub block_index: u32,
	#[serde(rename = "transfernotifyindex")]
	pub transfer_notify_index: u32,
	#[serde(rename = "txhash")]
	#[serde(serialize_with = "serialize_h256")]
	#[serde(deserialize_with = "deserialize_h256")]
	pub tx_hash: H256,
}

impl Nep17Transfer {
	// Constructor function for Nep17Transfer
	pub fn new(
		timestamp: u64,
		asset_hash: ScriptHash,
		transfer_address: String,
		amount: u64,
		block_index: u32,
		transfer_notify_index: u32,
		tx_hash: H256,
	) -> Self {
		Self {
			timestamp,
			asset_hash,
			transfer_address,
			amount,
			block_index,
			transfer_notify_index,
			tx_hash,
		}
	}
}

// Custom deserialization function to convert a string into a u64
fn deserialize_amount<'de, D>(deserializer: D) -> Result<u64, D::Error>
where
	D: Deserializer<'de>,
{
	let s = String::deserialize(deserializer)?;
	u64::from_str(&s).map_err(serde::de::Error::custom)
}

// Optional: custom serialization function if you want to serialize `u64` back into `String`
fn serialize_amount<S>(amount: &u64, serializer: S) -> Result<S::Ok, S::Error>
where
	S: Serializer,
{
	serializer.serialize_str(&amount.to_string())
}