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
//! Token helpers for NEP-141 (Fungible Tokens) and NEP-171 (Non-Fungible Tokens).
//!
//! This module provides ergonomic APIs for interacting with standard NEAR token contracts.
//!
//! # Known Token Constants
//!
//! For common tokens like USDC, USDT, and wNEAR, use the provided constants to avoid
//! copy-pasting addresses. These automatically resolve to the correct address based
//! on the network your client is connected to:
//!
//! ```rust,no_run
//! use near_kit::*;
//!
//! # async fn example() -> Result<(), near_kit::Error> {
//! // Mainnet client - USDC resolves to the mainnet address
//! let near = Near::mainnet().build();
//! let usdc = near.ft(tokens::USDC)?;
//! let balance = usdc.balance_of("alice.near").await?;
//!
//! // Testnet client - USDC resolves to the testnet address
//! let near = Near::testnet().build();
//! let usdc = near.ft(tokens::USDC)?;
//! # Ok(())
//! # }
//! ```
//!
//! Available tokens:
//!
//! | Constant | Token | Mainnet | Testnet |
//! |----------|-------|---------|---------|
//! | [`USDC`] | Circle USD Coin | ✓ | ✓ |
//! | [`USDT`] | Tether USD | ✓ | ✗ |
//! | [`W_NEAR`] | Wrapped NEAR | ✓ | ✓ |
//!
//! You can still use raw addresses for any token:
//!
//! ```rust,no_run
//! # use near_kit::*;
//! # fn example(near: &Near) -> Result<(), near_kit::Error> {
//! let custom = near.ft("my-token.near")?;
//! # Ok(())
//! # }
//! ```
//!
//! # Fungible Tokens (NEP-141)
//!
//! ```rust,no_run
//! use near_kit::*;
//!
//! # async fn example() -> Result<(), near_kit::Error> {
//! let near = Near::mainnet().build();
//!
//! // Get a fungible token client using a known token
//! let usdc = near.ft(tokens::USDC)?;
//!
//! // Query metadata (cached after first call)
//! let metadata = usdc.metadata().await?;
//! println!("Token: {} ({})", metadata.name, metadata.symbol);
//!
//! // Query balance - returns FtAmount with decimals for formatting
//! let balance = usdc.balance_of("alice.near").await?;
//! println!("Balance: {}", balance); // e.g., "1.5 USDC"
//!
//! // Transfer tokens (requires signer)
//! let near = Near::mainnet()
//! .credentials("ed25519:...", "alice.near")?
//! .build();
//! let usdc = near.ft(tokens::USDC)?;
//!
//! usdc.transfer("bob.near", 1_500_000_u128).await?;
//!
//! // Or with a memo
//! usdc.transfer_with_memo("bob.near", 1_500_000_u128, "Payment").await?;
//! # Ok(())
//! # }
//! ```
//!
//! # Non-Fungible Tokens (NEP-171)
//!
//! ```rust,no_run
//! use near_kit::*;
//!
//! # async fn example() -> Result<(), near_kit::Error> {
//! let near = Near::testnet().build();
//!
//! // Get an NFT client
//! let nft = near.nft("nft-contract.near")?;
//!
//! // Query a specific token
//! if let Some(token) = nft.token("token-123").await? {
//! println!("Owner: {}", token.owner_id);
//! }
//!
//! // List tokens owned by an account
//! let tokens = nft.tokens_for_owner("alice.near", None, Some(10)).await?;
//! for token in tokens {
//! println!("Token: {}", token.token_id);
//! }
//!
//! // Transfer an NFT (requires signer)
//! let near = Near::testnet()
//! .credentials("ed25519:...", "alice.near")?
//! .build();
//! let nft = near.nft("nft-contract.near")?;
//!
//! nft.transfer("bob.near", "token-123").await?;
//!
//! // Or with a memo
//! nft.transfer_with_memo("bob.near", "token-123", "Gift").await?;
//! # Ok(())
//! # }
//! ```
pub use *;
pub use ;
pub use *;
pub use *;