diff --git a/README.md b/README.md index c384122118..481550699c 100644 --- a/README.md +++ b/README.md @@ -14,20 +14,19 @@ It was initially written by TON [contributors](/v3/contribute/maintainers/) and --- - - ## Join TON Docs Club πŸ’Ž -TON is an actively growing ecosystem, and every day many devs contribute to its development. +TON is an actively growing ecosystem, and every day many devs contribute to its development. -You can participate in TON by helping organize knowledge, making Pull Requests and creating tutorials to help other developers. +You can participate in TON by helping organize knowledge, making Pull Requests and creating tutorials to help other developers. Feedback, lectures, technical articles, tutorials, and examples. All this can help the developers community grow even faster! Join TON Docs Club chat in Telegram to join contributors party: -* https://t.me/+c-0fVO4XHQsyOWM8 + +- https://t.me/+c-0fVO4XHQsyOWM8 --- @@ -35,9 +34,9 @@ Join TON Docs Club chat in Telegram to join contributors party: ## How to contribute? πŸ¦„ -β€” Have an issue? [Prepare a solution with TON Docs Wizard](https://t.me/ton_docs_bot). +β€” Have an issue? [Prepare a solution with TON Docs Wizard](https://t.me/ton_docs_bot). -β€” Have an idea? [Submit a Feature Request](https://github.com/ton-community/ton-docs/issues/new/choose). +β€” Have an idea? [Submit a Feature Request](https://github.com/ton-community/ton-docs/issues/new/choose). β€” Want to contribute? [How to contribute](https://docs.ton.org/v3/contribute). @@ -45,8 +44,6 @@ Join TON Docs Club chat in Telegram to join contributors party: β€” Have a question? [Documentation development chat](https://t.me/+c-0fVO4XHQsyOWM8). - - --- ## Set up your environment ☁️ @@ -65,39 +62,43 @@ Use Gitpod for contributing. It'll launch a workspace with a single click: 1. Download repository from GitHub with its submodules - ``` - git clone --recursive https://github.com/ton-community/ton-docs.git - ``` + ``` + git clone --recursive https://github.com/ton-community/ton-docs.git + ``` 2. Install last version [NodeJS LTS](https://nodejs.org/en/download/) to run local build 3. Open Terminal in project directory 4. Install dependencies with command: - ``` - npm install - ``` + ``` + npm install + ``` + 5. Run project with command: - ``` - npm run start - ``` + ``` + npm run start + ``` + 6. Build with multiple locales and run it locally - ``` - npm run build - npm run serve - ``` + ``` + npm run build + npm run serve + ``` This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. ## Install recursive module If you cloned the repository from GitHub without step 1, you'll need to install the submodules to enable local execution. + ``` git submodule update --init --recursive ``` ## Contributors wall + @@ -110,5 +111,3 @@ git submodule update --init --recursive ## License [GPL-3.0](https://choosealicense.com/licenses/gpl-3.0/) - - diff --git a/docs/v3/guidelines/dapps/apis-sdks/nownodes-ton-api.mdx b/docs/v3/guidelines/dapps/apis-sdks/nownodes-ton-api.mdx new file mode 100644 index 0000000000..cc5225e166 --- /dev/null +++ b/docs/v3/guidelines/dapps/apis-sdks/nownodes-ton-api.mdx @@ -0,0 +1,80 @@ +import Feedback from "@site/src/components/Feedback"; + +# Access TON Blockchain via NOWNodes + +:::info +[NOWNodes](https://nownodes.io/) provides access to the TON blockchain through multiple API interfaces. This guide covers getting started, supported interfaces, core methods, and integration examples. +::: + +### 1. Get Your API Key + +#### 1. Sign up at [NOWNodes](https://account.nownodes.io/auth/login?utm_source=tondocs&utm_medium=guide). + +![NOWNodes login](/img/docs/nownodes-img/login_nownodes.png) + +#### 2. Choose the plan which suits you. + +![NOWNodes plans](/img/docs/nownodes-img/plans_nownodes.png) + +#### 3. Navigate to **Dashboard** and generate a new key and store it securely β€” all requests require it. + +![NOWNodes dashboard](/img/docs/nownodes-img/dashboard_nownodes.png) + +### 2. Supported Interfaces + +NOWNodes offers three main TON API interfaces: + +| Interface | Description | Description | +| -------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------- | +| **API V1** | Classic RPC interface | Basic queries: get account state, balance, blocks, and send transactions. | +| **API V2** | Extended RPC interface | Includes additional methods and improved performance for blockchain queries. | +| **API V3 (Indexer)** | Indexer-based API | Optimized for fetching transactions, and advanced queries like wallets, collections, and event-based filters. | + +To check all supported methods, you can check [NOWNodes documentation](https://nownodes.gitbook.io/ton-toncoin?utm_source=tondocs&utm_medium=guide). + +### 3. Connecting to TON via NOWNodes + +Let’s take a look closer how to connect to TON with NOWNodes + +Example: Get up-to-date masterchain state. + +Use this endpoint: https://ton.nownodes.io/getMasterchainInfo + +Here is an example of the request: + +```bash +curl --location 'https://ton.nownodes.io/getMasterchainInfo' \ +--header 'api-key: YOUR_API_KEY' \ +--header 'Content-Type: application/json' +``` + +Here is an example of the correct response: + +```json +{ + "ok": true, + "result": { + "@type": "blocks.masterchainInfo", + "last": { + "@type": "ton.blockIdExt", + "workchain": -1, + "shard": "-9223372036854775808", + "seqno": 52266460, + "root_hash": "uQzcsabTYGT9rO4yF+ZxIhdAWIpOkq/bSvVBs90NG9c=", + "file_hash": "nPP70Hz95nRRze16USISEzlB15obheSQ23FrWuIK36U=" + }, + "state_root_hash": "gTl/1j0sZukHTBI8yLPkBtp7g5wo4Kq+Lz6BCv+GEZw=", + "init": { + "@type": "ton.blockIdExt", + "workchain": -1, + "shard": "0", + "seqno": 0, + "root_hash": "F6OpKZKqvqeFp6CQmFomXNMfMj2EnaUSOXN+Mh+wVWk=", + "file_hash": "XplPz01CXAps5qeSWUtxcyBfdAo5zVb1N979KLSKD24=" + }, + "@extra": "1758640859.1752262:6:0.6899334555338705" + } +} +``` + + diff --git a/static/img/docs/nownodes-img/dashboard_nownodes.png b/static/img/docs/nownodes-img/dashboard_nownodes.png new file mode 100644 index 0000000000..ba14e24bac Binary files /dev/null and b/static/img/docs/nownodes-img/dashboard_nownodes.png differ diff --git a/static/img/docs/nownodes-img/login_nownodes.png b/static/img/docs/nownodes-img/login_nownodes.png new file mode 100644 index 0000000000..b37f31701d Binary files /dev/null and b/static/img/docs/nownodes-img/login_nownodes.png differ diff --git a/static/img/docs/nownodes-img/plans_nownodes.png b/static/img/docs/nownodes-img/plans_nownodes.png new file mode 100644 index 0000000000..d7ccd40cb6 Binary files /dev/null and b/static/img/docs/nownodes-img/plans_nownodes.png differ