From 6839641c620c341ca1d1a4ab0587b7a6f89c924c Mon Sep 17 00:00:00 2001 From: "Dr. Awesome Doge" Date: Fri, 8 Nov 2024 15:31:14 +0800 Subject: [PATCH] Update TON Documentation to Include TONX API Information Across Multiple Sections (#838) * Add Testnet TONX Faucet and API URLs to documentation * Edit TON HTTP API to TONAPI * Add TONX API to RPC Nodes List * Add TONX API in Indexer List * Add TONX API in Other APIs List * Add TONX.js into TypeScript / JavaScript List * Add TONX API Link * Add TONX API into node provide partner List * Add TONX API into Third party APIs List * Update API list in documentation Rearranged the order of third-party APIs listed in the documentation. The TONX API and tonapi.io entries were swapped for better readability. No changes were made to the content or descriptions of these APIs. * Updated RPC Nodes list in documentation The RPC Nodes list in the documentation has been updated. The changes include reordering of the items and minor modifications to their descriptions for better clarity and understanding. * Updated API references in documentation Rearranged the order of API references in the blockchain connection section of the documentation. The TONX API reference is now listed after suggestions for using a public TON Index or running your own TON Index. No changes were made to the actual content of these references. * Updated SDK documentation Reordered the list of libraries in the SDK documentation for better readability. Also, added some spacing to improve visual separation between different sections. * Updated FAQ documentation Rearranged the order of node providers partners in the FAQ section of the documentation. No new content was added or removed, just reorganized for better readability and flow. * Updated testnet documentation Rearranged the order of resources in the testnet documentation for better readability and logical flow. The Testnet TONAPI link has been moved up for easier access. --- docs/v3/documentation/faq.md | 13 ++++++------ .../getting-started/testnet.md | 4 +++- .../guidelines/dapps/apis-sdks/api-types.md | 12 +++++------ docs/v3/guidelines/dapps/apis-sdks/sdk.mdx | 12 ++++++----- .../dapps/apis-sdks/ton-http-apis.md | 21 +++++++++++-------- 5 files changed, 35 insertions(+), 27 deletions(-) diff --git a/docs/v3/documentation/faq.md b/docs/v3/documentation/faq.md index 4a60218a7a..1b2959cfd3 100644 --- a/docs/v3/documentation/faq.md +++ b/docs/v3/documentation/faq.md @@ -274,12 +274,13 @@ API types: Node providers partners: -- https://toncenter.com/api/v2/ -- [getblock.io](https://getblock.io/) -- https://www.orbs.com/ton-access/ -- [toncenter/ton-http-api](https://github.com/toncenter/ton-http-api) -- [nownodes.io](https://nownodes.io/nodes) -- https://dton.io/graphql +- [Toncenter](https://toncenter.com/api/v2/) — Reliable access to TON RPC services. +- [TONX API](https://docs.tonxapi.com/reference/direct-apis) — Direct access with robust stability and low latency for TON-based applications. +- [GetBlock](https://getblock.io/) — Blockchain nodes provider for dApp development. +- [TON Access](https://www.orbs.com/ton-access/) — HTTP API for secure, high-performance TON access. +- [Toncenter/Ton HTTP API](https://github.com/toncenter/ton-http-api) — Self-hosted RPC node solution. +- [NOWNodes](https://nownodes.io/nodes) — Full nodes and explorers accessible via API. +- [Dton](https://dton.io/graphql) — GraphQL API endpoint for TON. TON directory with projects from TON Community: diff --git a/docs/v3/documentation/smart-contracts/getting-started/testnet.md b/docs/v3/documentation/smart-contracts/getting-started/testnet.md index 464fa57995..9f1a4946e1 100644 --- a/docs/v3/documentation/smart-contracts/getting-started/testnet.md +++ b/docs/v3/documentation/smart-contracts/getting-started/testnet.md @@ -18,7 +18,9 @@ For convenience, nearly the entire mainnet infrastructure (wallets, APIs, bridge * Web wallet: https://wallet.ton.org?testnet=true * Browser extension: use [mainnet browser extension](https://chrome.google.com/webstore/detail/ton-wallet/nphplpgoakhhjchkkhmiggakijnkhfnd) and [do this](https://github.com/toncenter/ton-wallet#switch-between-mainnettestnet-in-extension). * Testnet TON Center API: https://testnet.toncenter.com -* Testnet HTTP API: https://testnet.tonapi.io/ +* Testnet TONAPI: https://testnet.tonapi.io/ +* Testnet TONX Faucet: https://faucet.tonxapi.com +* Testnet TONX API: https://testnet-rpc.tonxapi.com * Testnet bridge: https://bridge.ton.org/?testnet=true * Testnet dTON GraphQL: https://testnet.dton.io/ diff --git a/docs/v3/guidelines/dapps/apis-sdks/api-types.md b/docs/v3/guidelines/dapps/apis-sdks/api-types.md index 848712e85a..873bd90278 100644 --- a/docs/v3/guidelines/dapps/apis-sdks/api-types.md +++ b/docs/v3/guidelines/dapps/apis-sdks/api-types.md @@ -10,12 +10,12 @@ - [toncenter/v2](https://toncenter.com/) - This API enables HTTP access to TON blockchain - getting accounts and wallets information, looking up blocks and transactions, sending messages to the blockchain, calling get methods of smart contracts, and more. ## Third party APIs -- [TONX API](https://docs.tonxapi.com/) - an API specifically designed for seamless Dapp development, enabling easy access to a variety of tools and data. -- [tonapi.io](https://docs.tonconsole.com/tonapi) - fast indexed API which provides basic data about accounts, transactions, blocks, application-specific data about NFT, Auctions, Jettons, TON DNS, Subscriptions. It also provides annotated data on transaction chains. -- [dton.io](https://dton.io/graphql/) - GraphQL API with that can provide data about accounts, transactions and blocks, as well as application-specific data about NFT, Auctions, Jettons and TON DNS. -- [ton-api-v4](https://mainnet-v4.tonhubapi.com) - another lite-api focused on speed via aggressive cashing in CDN. -- [docs.nftscan.com](https://docs.nftscan.com/reference/ton/model/asset-model) - NFT APIs for TON blockchain. -- [everspace.center](https://everspace.center/toncoin) - Simple RPC API for accessing TON Blockchain. +- [tonapi.io](https://docs.tonconsole.com/tonapi) — Fast indexed API providing basic data about accounts, transactions, blocks, and application-specific data about NFTs, Auctions, Jettons, TON DNS, and Subscriptions. It also provides annotated data on transaction chains. +- [TONX API](https://docs.tonxapi.com/reference/build-your-first-dapp) — Your go-to API for accessing data on accounts, transactions, blocks, NFTs, and Jettons with 99.99% uptime—just like TonKey and TonStake did. +- [dton.io](https://dton.io/graphql/) — GraphQL API that can provide data about accounts, transactions, and blocks, as well as application-specific data about NFTs, Auctions, Jettons, and TON DNS. +- [ton-api-v4](https://mainnet-v4.tonhubapi.com) — A lite API focused on speed via aggressive caching in CDN. +- [docs.nftscan.com](https://docs.nftscan.com/reference/ton/model/asset-model) — NFT APIs for the TON blockchain. +- [everspace.center](https://everspace.center/toncoin) — Simple RPC API for accessing the TON blockchain. ## Additional APIs diff --git a/docs/v3/guidelines/dapps/apis-sdks/sdk.mdx b/docs/v3/guidelines/dapps/apis-sdks/sdk.mdx index 20c9880868..5008a6f220 100644 --- a/docs/v3/guidelines/dapps/apis-sdks/sdk.mdx +++ b/docs/v3/guidelines/dapps/apis-sdks/sdk.mdx @@ -13,15 +13,17 @@ There are different ways to connect to blockchain: ### TypeScript / JavaScript -| Library | Blockchain connection | Description | -|---------|------------------|--------------| -|[ton](https://github.com/ton-org/ton)|via RPC ([Orbs](https://www.orbs.com/ton-access/) / [Toncenter](https://toncenter.com/api/v2/) / etc)|Convenient client library with wallet wrappers for development dApps on TON Blockchain.| +| Library | Blockchain connection | Description | +|---------|------------------------|-------------| +|[ton](https://github.com/ton-org/ton)|via RPC ([Orbs](https://www.orbs.com/ton-access/) / [Toncenter](https://toncenter.com/api/v2/) / etc)|Convenient client library with wallet wrappers for developing dApps on the TON Blockchain.| |[tonweb](https://github.com/toncenter/tonweb)|via RPC ([Orbs](https://www.orbs.com/ton-access/) / [Toncenter](https://toncenter.com/api/v2/) / etc)|Old-style TON JS SDK, with minimal external dependencies, extensively tested in production.| +|[TONX.js](https://github.com/frigatebird-studio/TONX.js)| via [TONX API](https://tonxapi.com/) | A gateway into Web3. Interact with TON and its ecosystem with TONX API seamlessly and effortlessly.| |[tonkite/adnl](https://github.com/tonkite/adnl)|[ADNL](/v3/documentation/network/protocols/adnl/adnl-tcp) natively / via WebSocket| ADNL TypeScript implementation. | -|[tonutils](https://github.com/thekiba/tonutils)|Native [ADNL](/v3/documentation/network/protocols/adnl/adnl-tcp)| TypeScript-based interface for building and interacting with applications in TON Ecosystem. Due to native ADNL dependency, cannot be used for blockchain interaction in browser.| -|[foton](https://foton.sh/)|via RPC ([Orbs](https://www.orbs.com/ton-access/) / [Toncenter](https://toncenter.com/api/v2/) / etc)|TypeScript toolkit for interacting with TON wallets and blockchain as a whole. The library wraps existing solutions (Blueprint and TON Connect) into one comfortable API.| +|[tonutils](https://github.com/thekiba/tonutils)|Native [ADNL](/v3/documentation/network/protocols/adnl/adnl-tcp)| TypeScript-based interface for building and interacting with applications in the TON Ecosystem. Due to native ADNL dependency, cannot be used for blockchain interaction in the browser.| +|[foton](https://foton.sh/)|via RPC ([Orbs](https://www.orbs.com/ton-access/) / [Toncenter](https://toncenter.com/api/v2/) / etc)|TypeScript toolkit for interacting with TON wallets and the blockchain as a whole. The library wraps existing solutions (Blueprint and TON Connect) into one comfortable API.| ### Java + | Library | Blockchain connection | Description | |---------|------------------|--------------| | [ton4j](https://github.com/neodix42/ton4j) | Tonlib binary | Java SDK for The Open Network (TON) | diff --git a/docs/v3/guidelines/dapps/apis-sdks/ton-http-apis.md b/docs/v3/guidelines/dapps/apis-sdks/ton-http-apis.md index d43305840d..11ce52575d 100644 --- a/docs/v3/guidelines/dapps/apis-sdks/ton-http-apis.md +++ b/docs/v3/guidelines/dapps/apis-sdks/ton-http-apis.md @@ -25,15 +25,16 @@ There are different ways to connect to blockchain: ## RPC Nodes -* [Chainstack](https://chainstack.com/build-better-with-ton/) — RPC nodes and indexer in multiple regions with geo and load balancing. -* [Tatum](https://docs.tatum.io/reference/rpc-ton) — Access TON RPC nodes and powerful developer tools in one simple-to-use platform. -* [GetBlock Nodes](https://getblock.io/nodes/ton/) — connect and test your dApps using GetBlocks Nodes -* [TON Access](https://www.orbs.com/ton-access/) - HTTP API for The Open Network (TON). -* [Toncenter](https://toncenter.com/api/v2/) — community-hosted project for Quick Start with API. (Get an API key [@tonapibot](https://t.me/tonapibot)) -* [ton-node-docker](https://github.com/fmira21/ton-node-docker) - Docker Full Node and Toncenter API. -* [toncenter/ton-http-api](https://github.com/toncenter/ton-http-api) — run your own RPC node. -* [nownodes.io](https://nownodes.io/nodes) — NOWNodes full Nodes and blockbook Explorers via API. -* [Chainbase](https://chainbase.com/chainNetwork/TON) — Node API and data infrastructure for The Open Network. +- [Toncenter](https://toncenter.com/api/v2/) — Community-hosted project for quick start with TON API. (Get an API key from [@tonapibot](https://t.me/tonapibot)) +- [toncenter/ton-http-api](https://github.com/toncenter/ton-http-api) — Run your own RPC node. +- [TONX API](https://docs.tonxapi.com/reference/direct-apis) — Supernode offering unparalleled stability and low latency, enabling TON DApps worldwide. +- [Chainstack](https://chainstack.com/build-better-with-ton/) — RPC nodes and indexers across multiple regions, with geo and load balancing. +- [Tatum](https://docs.tatum.io/reference/rpc-ton) — Access to TON RPC nodes and a suite of developer tools on a single platform. +- [GetBlock Nodes](https://getblock.io/nodes/ton/) — Connect and test your dApps using GetBlock’s TON nodes. +- [TON Access](https://www.orbs.com/ton-access/) — HTTP API for The Open Network (TON). +- [ton-node-docker](https://github.com/fmira21/ton-node-docker) — Docker Full Node and Toncenter API setup. +- [NOWNodes.io](https://nownodes.io/nodes) — Full nodes and Blockbook explorers via API. +- [Chainbase](https://chainbase.com/chainNetwork/TON) — Node API and data infrastructure for The Open Network (TON). ## Indexer @@ -43,6 +44,7 @@ Indexers allow to list jetton wallets, NFTs, transactions by certain filters, no - Public TON Index can be used: tests and development are for free, [premium](https://t.me/tonapibot) for production - [toncenter.com/api/v3/](https://toncenter.com/api/v3/). - Run your own TON Index with [Worker](https://github.com/toncenter/ton-index-worker/tree/36134e7376986c5517ee65e6a1ddd54b1c76cdba) and [TON Index API wrapper](https://github.com/toncenter/ton-indexer). +- [TONX API](https://docs.tonxapi.com/reference/indexer-apis) — Listing and filtering on-chain data, including Jetton, NFTs, and TON transactions, from the first block in a customized manner. ### Anton @@ -60,4 +62,5 @@ GraphQL nodes act as indexers as well. ## Other APIs +* [TONX API](https://docs.tonxapi.com/reference/build-your-first-dapp) — Your go-to API for accessing data on accounts, transactions, blocks, NFTs, and Jettons with 99.99% uptime. * [TonAPI](https://docs.tonconsole.com/tonapi) - API that is designed to provide users with a streamlined experience, not worrying about low-level details of smart contracts.