OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

SDKs

For available APIs, see the API overview.

There are several ways to interact with TON blockchain:

  • HTTP libraries connect through HTTP JSON APIs to read and write to the blockchain. HTTP servers mostly relay these requests to the ADNL network.
  • ADNL libraries connect to liteserver.

Here's a small comparison of these protocols:

HTTPADNL
StandardizedNoYes
Can connect from a web pageYesNo
Has free third-party serversYesYes
Can be self-hostedYesYes
Requires trusting third partiesYes1No
First connection takes time for data synchronizationNoYes2

1 Some HTTP servers do provide proofs, but there is no out-of-the-box library that verifies them.
2 If proofs returned by liteservers are ignored, the first connection skips data synchronization; however, this requires trusting the liteserver.

SDKs might also provide some other functionality:

  • Core libraries implement standard TON data structures (cell, slice), formats (address, mnemonic), cryptography, etc.
  • Wrappers provide high-level APIs for interacting with standard contracts (Wallet, Jetton, NFT).
  • Emulator libraries provide an execution environment similar to a real blockchain for testing purposes.
HTTPADNLCoreWrappersEmulatorLanguage
⭐@ton/ton✅✅TypeScriptCodeChat
⭐@ton/core✅TypeScriptCodeDocs
⭐@ton/sandbox✅TypeScriptCode
⭐ton4j✅✅✅JavaCodeChat
⭐tonutils-go✅✅✅GoCodeChat
⭐tonutils✅✅✅✅PythonCodeDocsChat
@ton-community/assets-sdk✅✅TypeScriptCode
adnl✅TypeScriptCode
tonutils✅TypeScriptCode
tonlib-java✅JavaCode
tonlib✅C++CodeDocs
pytonlib✅PythonCode
pytoniq✅PythonCodeDocsChat
pytoniq-core✅PythonCodeDocsChat
mytonlib✅✅PythonCode
tonpy✅PythonCodeDocs
tvm_valuetypes✅PythonCode
pytvm✅PythonCode
tongo✅✅✅✅GoCode
ton✅PHPCode
interop✅PHPCode
ton-rs✅✅✅✅RustCode
ton-grpc✅RustCode
tonsdk.net✅✅C#CodeChat
tonlib.net✅✅✅C#Code
ton✅ElixirCode
@tetherto/wdk-wallet-ton✅✅JavaScriptCodeDocs
@tetherto/wdk-wallet-ton-gasless✅✅JavaScriptCodeDocs
ton-kotlin✅✅KotlinCodeDocs
tonlib-go✅GoCode
tonweb✅JavaScriptCode
node-tonlib✅JavaScriptCode
tontools✅✅PythonCode
swiftyton✅SwiftCode
tonlib-xcframework✅SwiftCode
tonlib-rs✅✅✅✅RustCode

See also:

  • WDK Core, JavaScript - Modular library from Tether, which supports wallet management and various swap, bridge, and lending services for many blockchains at once.