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
152
153
use Arc;
use Serialize;
use Value;
use Url;
use crate::;
/// TRON Mainnet read-only JSON-RPC methods represented by this release.
pub const TRON_RPC_METHODS: & = &;
/// TRON Mainnet read-only JSON-RPC service client.
///
/// TRON Mainnet uses chain ID `728126428` (`0x2b6653dc`). The native balance
/// returned by `eth_getBalance` is a raw JSON-RPC quantity in lowercase `sun`
/// units (`1 TRX = 1,000,000 sun`); this client does not parse or convert it.
/// TRON Mainnet read-only JSON-RPC namespace.
///
/// The namespace deliberately exposes only the three read methods represented
/// by [`TRON_RPC_METHODS`]. JSON-RPC quantities and results remain raw strings;
/// in particular, no `41` prefix or `Base58Check` address conversion is applied.
/// Callers should use the documented interoperable 20-byte `0x` hexadecimal
/// address form and the `latest` state selector.
///
/// A hosted root target is posted to `/`; the provider owns its upstream
/// `/jsonrpc` route. A caller-owned direct endpoint is the complete request
/// target, so a direct `/jsonrpc` suffix, encoded path, and query are retained
/// unchanged. The client is HTTP-only and has no REST, generic raw/request,
/// batch, subscription, transaction, signing, broadcast, swap, or bridge API.
///
/// The intentionally narrow surface has compile-fail coverage for forbidden
/// escape hatches and state-changing operations:
///
/// ```compile_fail
/// # use erpc_sdk::{ErpcClient, ErpcClientConfig};
/// # async fn forbidden() -> erpc_sdk::Result<()> {
/// let rpc = ErpcClient::new(ErpcClientConfig::new("key"))?.tron.rpc;
/// let _ = rpc.raw::<String>("eth_chainId", None);
/// # Ok(())
/// # }
/// ```
///
/// ```compile_fail
/// # use erpc_sdk::{ErpcClient, ErpcClientConfig};
/// # async fn forbidden() -> erpc_sdk::Result<()> {
/// let rpc = ErpcClient::new(ErpcClientConfig::new("key"))?.tron.rpc;
/// let _ = rpc.request::<String>("eth_chainId", Vec::<serde_json::Value>::new());
/// # Ok(())
/// # }
/// ```
///
/// ```compile_fail
/// # use erpc_sdk::{ErpcClient, ErpcClientConfig};
/// # async fn forbidden() -> erpc_sdk::Result<()> {
/// let rpc = ErpcClient::new(ErpcClientConfig::new("key"))?.tron.rpc;
/// let _ = rpc.batch(Vec::new());
/// # Ok(())
/// # }
/// ```
///
/// ```compile_fail
/// # use erpc_sdk::{ErpcClient, ErpcClientConfig};
/// # async fn forbidden() -> erpc_sdk::Result<()> {
/// let rpc = ErpcClient::new(ErpcClientConfig::new("key"))?.tron.rpc;
/// let _ = rpc.subscribe("newHeads", Vec::new());
/// # Ok(())
/// # }
/// ```
///
/// ```compile_fail
/// # use erpc_sdk::{ErpcClient, ErpcClientConfig};
/// # async fn forbidden() -> erpc_sdk::Result<()> {
/// let rpc = ErpcClient::new(ErpcClientConfig::new("key"))?.tron.rpc;
/// let _ = rpc.eth_send_raw_transaction(["0xdeadbeef"]);
/// # Ok(())
/// # }
/// ```