Skip to main content

ton_connect_core/
lib.rs

1//! Runtime-neutral building blocks for a TON Connect wallet implementation.
2//!
3//! This crate models the protocol wire format and the NaCl-compatible HTTP
4//! bridge session encryption. It deliberately contains no HTTP client,
5//! executor, wallet implementation, or persistence policy.
6
7#![deny(missing_docs)]
8#![forbid(unsafe_code)]
9
10mod account_address;
11mod bridge;
12mod capability;
13mod cell_boc;
14mod connect;
15mod deep_link;
16mod embedded;
17mod friendly_address;
18mod http_bridge;
19mod http_session;
20mod js_bridge;
21mod manifest;
22mod protocol;
23mod rpc;
24mod session;
25mod session_state;
26mod signing;
27mod value;
28mod wallet_state;
29mod wallets_list;
30
31pub use account_address::{AccountAddress, AccountAddressError};
32pub use bridge::BridgeMessage;
33pub use capability::CapabilityError;
34pub use cell_boc::{CellBoc, CellBocError};
35pub use connect::{
36    ConnectEvent, ConnectEventError, ConnectEventErrorCode, ConnectEventPayload, ConnectItem,
37    ConnectItemError, ConnectItemErrorCode, ConnectItemReply, ConnectRequest,
38    ConnectValidationError, DeviceInfo, DeviceInfoValidationError, DevicePlatform, Feature,
39    FeatureValidationError, SendTransactionFeature, SignDataFeature, SignDataType,
40    SignMessageFeature, StructuredItemType, TonAddressItem, TonAddressItemReply, TonProof,
41    TonProofDomain, TonProofItem, TonProofItemReply, UnsupportedConnectItemError,
42};
43pub use deep_link::{
44    ConnectLink, ConnectLinkError, ReturnStrategy, decode_telegram_url_parameters,
45    encode_telegram_url_parameters,
46};
47pub use embedded::{
48    EmbeddedRequest, EmbeddedRequestError, EmbeddedResponse, EmbeddedResponseError,
49    EmbeddedResponseSuccess, decode_embedded_request_param, encode_embedded_request_param,
50};
51pub use friendly_address::{FriendlyAddress, FriendlyAddressError};
52pub use http_bridge::{
53    BridgeCodecError, BridgeSseDecoder, BridgeSseMessage, HeartbeatMode, HttpBridgeError,
54    HttpBridgeUrl, PreparedBridgePost,
55};
56pub use http_session::{HttpSessionError, PersistedHttpSession};
57pub use js_bridge::{
58    InjectedWalletInfo, JsBridge, JsBridgeContractError, JsBridgeDescriptor, JsBridgeEventListener,
59};
60pub use manifest::{AppManifest, ManifestError};
61pub use protocol::{AppMessage, RpcMethod, RpcMethodError, WalletEvent, WalletMessage};
62pub use rpc::{
63    AppRequest, DisconnectRequest, ExtraCurrencies, KnownAppRequest, KnownWalletResponse,
64    RawMessage, RawTransactionPayload, RequestContextError, ResponseValidationError, RpcError,
65    RpcErrorCode, SendTransactionRequest, SignDataPayload, SignDataRequest, SignDataResult,
66    SignMessageRequest, SignMessageResult, StructuredItem, StructuredTransactionPayload,
67    TransactionPayload, WalletResponse, WalletResponseError, WalletResponseSuccess, WalletResult,
68};
69pub use session::{
70    PersistedSessionKeyPair, SessionCrypto, SessionCryptoError, SessionKeyPairError,
71};
72pub use session_state::{
73    PreparedAppRequest, PreparedWalletEvent, PreparedWalletEventReceipt, RpcRequestId,
74    SessionStateError, WalletEventCursor, WalletEventCursorError, WalletEventKind,
75    WalletSessionPhase, WalletSessionState,
76};
77pub use signing::{
78    Ed25519PublicKey, Ed25519Signature, RawAccountAddress, SignDataSigningPayload, SignatureDomain,
79    SigningError, sign_data_signing_hash, ton_proof_message, ton_proof_signing_hash,
80    verify_signature,
81};
82pub use value::{
83    Base64Value, ClientId, DecimalString, EmptyObject, HttpsUrl, NetworkId, NonEmptyVec, TraceId,
84    Uint64String, ValueError,
85};
86pub use wallet_state::{
87    AccountVerificationError, StandardWalletState, StandardWalletVersion, WalletStateError,
88    WalletStateInit,
89};
90pub use wallets_list::{
91    WalletBridge, WalletInfo, WalletInfoConfig, WalletPlatform, WalletsList, WalletsListError,
92};
93
94/// TON Connect transport protocol version implemented by this crate.
95pub const PROTOCOL_VERSION: u8 = 2;
96
97/// Normative specification revision used for this implementation.
98///
99/// Pinning the revision makes later protocol changes explicit instead of
100/// silently changing validation behavior under existing wallet binaries.
101pub const SPEC_REVISION: &str = "5656a962eee30819a31a9e918e3de0b9614713b6";