Rework and proofread APIs and SDKs

docs/v3/guidelines/dapps/apis-sdks/api-types.md

@@ -1,26 +1,26 @@
-# API Types
+# API types
 
-**High availability blockchain APIs are the core element of secure, convenient and fast development of useful applications on TON.**
+**High availability blockchain APIs are essential for developing secure, efficient, and scalable applications on TON.**
 
-- [TON HTTP API](/v3/guidelines/dapps/apis-sdks/ton-http-apis) — API that allows to work with the _indexed blockchain information_.
-- [TON ADNL API](/v3/guidelines/dapps/apis-sdks/ton-adnl-apis) — secure API to communicate with TON, based on ADNL protocol.
+- [TON HTTP API](/v3/guidelines/dapps/apis-sdks/ton-http-apis) — An API that allows working with the _indexed blockchain information_.
+- [TON ADNL API](/v3/guidelines/dapps/apis-sdks/ton-adnl-apis) — A secure API for communicating with TON using the ADNL protocol.
 
 :::tip TON Infrastructure Status
-* [status.toncenter](https://status.toncenter.com/) - various statistics of nodes activity during the last hour.
-* [Tonstat.us](https://tonstat.us/) - a real-time Grafana, updated every 5 minutes.
+* [status.toncenter](https://status.toncenter.com/) - Displays various node activity statistics from the last hour.
+* [Tonstat.us](https://tonstat.us/) - A real-time Grafana dashboard, updated every 5 minutes.
 :::
 
 ## Toncenter APIs
-- [TON Index](https://toncenter.com/api/v3/) - TON Index collects data from a full node to PostgreSQL database and provides convenient API to an indexed blockchain.
-- [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.
+- [TON Index](https://toncenter.com/api/v3/) - Collects data from a full node into a PostgreSQL database and provides a convenient API for accessing indexed blockchain data.
+- [toncenter/v2](https://toncenter.com/) - Enables HTTP access to TON Blockchain, allowing developers to retrieve account and wallet information, look up blocks and transactions, send messages to the blockchain, call smart contract methods, and more.
 
-## Third party APIs
-- [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.
-- [TONX API](https://docs.tonxapi.com/) - an API specifically designed for seamless Dapp development, enabling easy access to a variety of tools and data.
-- [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.
+## Third-party APIs
+- [tonapi.io](https://docs.tonconsole.com/tonapi) - A fast indexed API that provides basic data about accounts, transactions, blocks, application-specific data about NFT, auctions, jettons, TON DNS, and subscriptions. It also offers annotated transaction chain data.
+- [TONX API](https://docs.tonxapi.com/) - Designed for seamless dApp development, this API provides easy access to various tools and data.
+- [dton.io](https://dton.io/graphql/) - A GraphQL API that delivers data on 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) - A lightweight API optimized for speed through aggressive CDN caching
+- [docs.nftscan.com](https://docs.nftscan.com/reference/ton/model/asset-model) - NFT APIs for TON Blockchain.
+- [everspace.center](https://everspace.center/toncoin) - A simple RPC API for accessing TON Blockchain.
 
 
 ## Additional APIs
@@ -32,15 +32,15 @@
 * https://apiguide.coingecko.com/getting-started
 
 
-### Address Convert APIs
+### Address convert APIs
 
 
 :::info
-It is preferable to convert address via local algorithm, read more in the [Addresses](/v3/documentation/smart-contracts/addresses) section of documentation.
+It is preferable to convert addresses using a local algorithm. See [Addresses](/v3/documentation/smart-contracts/addresses) section of documentation for details.
 :::
 
 
-#### From Friendly to Raw form
+#### From friendly to raw form
 
 /api/v2/unpackAddress
 
@@ -59,7 +59,7 @@ Response body
 }
 ```
 
-#### From Friendly to Raw form
+#### From friendly to raw form
 
 /api/v2/packAddress
 
@@ -80,7 +80,7 @@ Response body
 
 
 
-## See Also
+## See also
 * [TON HTTP API](/v3/guidelines/dapps/apis-sdks/ton-http-apis)
 * [List of SDKs](/v3/guidelines/dapps/apis-sdks/sdk)
-* [TON Cookbook](/v3/guidelines/dapps/cookbook)
+* [TON cookbook](/v3/guidelines/dapps/cookbook)

docs/v3/guidelines/dapps/apis-sdks/overview.md

@@ -1,41 +1,40 @@
 # Overview
 
-The purpose of this article is to help you choose the right tools for application development in TON ecosystem.
+This article helps you choose the right tools for application development in TON Ecosystem.
 
 ## TMA development
 
 * Use [Mini Apps SDKs](/v3/guidelines/dapps/tma/overview#mini-apps-sdks) for [Telegram Mini Apps](/v3/guidelines/dapps/tma/overview) development.
-* Choose [JS/TS-based SDK](/v3/guidelines/dapps/apis-sdks/sdk#typescript--javascript) for interacting with TON blockchain.
+* Choose [JS/TS-based SDK](/v3/guidelines/dapps/apis-sdks/sdk#typescript--javascript) to interact with TON Blockchain.
 
 ## DApps development
 
-* Use Tolk, FunC or Tact [programming languages](/v3/documentation/smart-contracts/overview#programming-languages) for TON blockchain smart contracts development for your [DApp](/v3/guidelines/dapps/overview) if needed.
-* To interacts with TON blockchain and process its data choose listed [SDK](/v3/guidelines/dapps/apis-sdks/sdk). One of the most popular languages for this purpose are:
-    * [JS/TS](/v3/guidelines/dapps/apis-sdks/sdk#typescript--javascript)
+* Use Tolk, FunC, or Tact [programming languages](/v3/documentation/smart-contracts/overview#programming-languages) to develop TON Blockchain smart contracts for your [dApp](/v3/guidelines/dapps/overview).
+* To interacts with TON Blockchain and process its data, choose one of the listed [SDKs](/v3/guidelines/dapps/apis-sdks/sdk). One of the most popular languages for this purpose include:
+    * [JavaScript/TypeScript](/v3/guidelines/dapps/apis-sdks/sdk#typescript--javascript)
     * [Go](/v3/guidelines/dapps/apis-sdks/sdk#go)
     * [Python](/v3/guidelines/dapps/apis-sdks/sdk#python)
-* To integrate user authentication with their TON Wallets (also payments processing logic) into your DApp use [TON Connect](/v3/guidelines/ton-connect/overview).
+* To integrate user authentication and payments processing via with their TON wallets, use [TON Connect](/v3/guidelines/ton-connect/overview).
 
 ## TON data analytics
 
-Quite often developers need to perform analytical queries on top of on-chain data: for example to track historical changes and aggregate data from multiple accounts. 
-Blockchains are not designed for this kind of workload and one need to build indexing pipeline and run analytical queries off-chain. Building such pipelines
-from scratch could be resource-consuming so one can use one of the following alternatives:
-* [Dune Analytics](https://dune.com/queries?category=canonical&namespace=ton) has a set of tables with TON data: raw transactions and messages, jetton events and DEX trades. Dune allows to build custom charts and dashboard, fetch query results via API and configure alerts. Before starting with writting queries please check [this guide](https://dune.com/ton_foundation/ton-quick-start) for best practices, tips and tricks.
-* Dune integration is powered by the Public Data Lake from the [ton-etl](https://github.com/re-doubt/ton-etl/blob/main/datalake/README.md) project. It is a parsing and decoding pipeline
-which dumps raw and decode data into S3 bucket __s3://ton-blockchain-public-datalake/v1/__ in AVRO format. The bucket is publicly available and everyone can use it with tools like [Amazon Athena](https://aws.amazon.com/athena/) (see [DDLs](https://github.com/re-doubt/ton-etl/blob/main/datalake/athena_ddl.sql)) or Apache Spark. The data is updated on the daily basis.
-* If you need to track on-chain data in near real-time you can run your own [Ton Node](/v3/documentation/infra/nodes/node-types) and launch [ton-etl](https://github.com/re-doubt/ton-etl/blob/main/README.md) or [ton-index-worker](https://github.com/toncenter/ton-index-worker).
-* [chainbase](https://docs.chainbase.com/catalog/Ton/Overview) comes with a set of raw and decoded tables with TON data. It allows to run SQL queries and fetch results via API.
+Developers often need to run analytical queries on top of on-chain data—for example, to track historical changes and aggregate data from multiple accounts. 
+Since blockchains are not designed for analytical workloads, you need to build an indexing pipeline and run off-chain analytical queries. Creating such pipelines
+from scratch can be resource-consuming, so you can use one of these alternatives:
+* [Dune analytics](https://dune.com/queries?category=canonical&namespace=ton) provides tables with TON data, including raw transactions and messages, jetton events, and DEX trades. Dune allows building custom charts and dashboards, fetch query results via API and set up alerts. Before writing queries, check [this guide](https://dune.com/ton_foundation/ton-quick-start) for best practices, tips, and tricks.
+* Dune integration is runs on the public data lake from the [ton-etl](https://github.com/re-doubt/ton-etl/blob/main/datalake/README.md) project. This parsing and decoding pipeline dumps raw and decoded data into an S3 bucket __s3://ton-blockchain-public-datalake/v1/__ in AVRO format. The bucket is publicly available and everyone can use it with [Amazon Athena](https://aws.amazon.com/athena/) (see [DDLs](https://github.com/re-doubt/ton-etl/blob/main/datalake/athena_ddl.sql)) or Apache Spark. The data updates daily.
+* If you need real-time on-chain data tracking, you can run your own [Ton Node](/v3/documentation/infra/nodes/node-types) and launch [ton-etl](https://github.com/re-doubt/ton-etl/blob/main/README.md) or [ton-index-worker](https://github.com/toncenter/ton-index-worker).
+* [Chainbase](https://docs.chainbase.com/catalog/Ton/Overview) offers a set of raw and decoded tables with TON data. It allows you to run SQL queries and fetch results via API.
 
-## Infrastructure Status
+## Infrastructure status
 
-* [status.toncenter](https://status.toncenter.com/) - various statistics of nodes activity during the last hour.
-* [Tonstat.us](https://tonstat.us/) - a real-time Grafana, updated every 5 minutes.
+* [status.toncenter](https://status.toncenter.com/) - Displays various node activity statistics from the last hour.
+* [Tonstat.us](https://tonstat.us/) - A real-time Grafana dashboard, updated every 5 minutes.
 
 
-## See Also
+## See also
 
 * [SDKs](/v3/guidelines/dapps/apis-sdks/sdk)
-* [TMA Tutorials](/v3/guidelines/dapps/tma/tutorials/step-by-step-guide)
-* [TON Connect Tutorials](/v3/guidelines/ton-connect/guidelines/how-ton-connect-works)
-* [Payments Processing](/v3/guidelines/dapps/asset-processing/payments-processing)
+* [TMA tutorials](/v3/guidelines/dapps/tma/tutorials/step-by-step-guide)
+* [TON Connect tutorials](/v3/guidelines/ton-connect/guidelines/how-ton-connect-works)
+* [Payments processing](/v3/guidelines/dapps/asset-processing/payments-processing)