Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Patch 1 #10

Closed
wants to merge 19 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,7 @@
"deeplink",
"dnsresolve",
"dracones",
"dstat",
"ed25519_chksign",
"exitcode",
"extracurrencies",
Expand All @@ -180,11 +181,14 @@
"hmac",
"howto",
"HOWTO",
"htop",
"idict",
"iftop",
"inclusivity",
"inplace",
"int",
"ints",
"iotop",
"ipfs",
"janvier",
"jetton",
Expand Down Expand Up @@ -221,6 +225,7 @@
"nanotons",
"newkeypair",
"nextra",
"nmon",
"nonexist",
"nonfinal",
"penalising",
Expand Down Expand Up @@ -325,6 +330,7 @@
"sidebars.js",
"sidebars",
"i18n",
".husky"
".husky",
"warnings.txt"
]
}
3 changes: 2 additions & 1 deletion docs/v3/concepts/qa-outsource/auditors.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,13 @@ import Button from '@site/src/components/button'

:::info
Test your software with the following quality assurance providers.
Find more TON Ecosystem auditors on [ton.app/audit](https://ton.app/audit).
:::

## Primary TON Blockchain SAP

* [beosin.com](https://beosin.com/?lang=en-US)
* [certik.com](certik.com)
* [certik.com](https://www.certik.com/)
* [quantstamp.com](https://quantstamp.com/)
* [ton.tech](https://ton.tech/)
* [trailofbits.com](https://www.trailofbits.com/)
Expand Down
2 changes: 1 addition & 1 deletion docs/v3/concepts/qa-outsource/outsource.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Discover 3rd party development teams for your TON project
* [Coinvent](#coinvent)
* [EvaCodes](#evacodes)
* [Pixelplex](#pixelplex)
* [Serokell](#Serokell)
* [Serokell](#serokell)
* [softstack](#softstack)

### Astralyx
Expand Down
2 changes: 1 addition & 1 deletion docs/v3/contribute/docs/schemes-guidelines.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ If the order of transactions doesn't matter, you can omit their labels. This sim



Learn references directly from Visio [message-processing.vsdx](/schemes-visio/message-processing.vsdx).
Learn references directly from Visio [message-processing.vsdx](/schemes-visio/message_processing.vsdx).


### Formats and Colors
Expand Down
4 changes: 2 additions & 2 deletions docs/v3/documentation/archive/compile.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,8 +186,8 @@ Note that all FunC source file contents used in your project should be passed to

### Validated by TON Community

* [ton-community/ton-compiler](/v3/documentation/smart-contracts/getting-started/javascript#ton-compiler) — ready-to-use FunC compiler for TON smart contracts.
* [ton-community/func-js](/v3/documentation/smart-contracts/getting-started/javascript#func-js) — cross-platform bindings for the TON FunC compiler.
* [ton-community/ton-compiler](https://github.com/ton-community/ton-compiler) — ready-to-use FunC compiler for TON smart contracts.
* [ton-community/func-js](https://github.com/ton-community/func-js) — cross-platform bindings for the TON FunC compiler.

### Third-party contributors

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The Hacktoberfest rules for 2022 are as follows:
* [List of projects on GitHub](https://github.com/topics/hacktoberfest)
* Have **4** pull/merge requests accepted between October 1 and October 31
* The first 40,000 participants (maintainers and contributors) who complete Hacktoberfest can choose between two prizes: a tree planted in their honor or a Hacktoberfest 2022 t-shirt. _(from the Hacktoberfest community)_
* Every participant (maintainer and contributor) to any of the TON Ecosystem projects will receive a [**Limited Hack-TON-berfest NFT**](#what-the-rewards). _(from TON Foundation)_
* Every participant (maintainer and contributor) to any of the TON Ecosystem projects will receive a [**Limited Hack-TON-berfest NFT**](/v3/documentation/archive/hacktoberfest-2022#what-are-the-rewards). _(from TON Foundation)_

For everyone in TON it's an opportunity to drive the growth of the entire ecosystem and receive cool rewards from TON Foundation. Let's do it together!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ To become a contributor who receives a limited *Hack-TON-berfest NFT*, please se
2. Please provide your wallet address to the [@toncontests_bot](https://t.me/toncontests_bot) in Telegram.
3. Validate your GitHub account in the same bot.

After these steps you are ready to contribute and receive a [limited Hack-TON-berfest NFT](/v3/documentation/archive/hacktoberfest-2022/#what-the-rewards).
After these steps you are ready to contribute and receive a [limited Hack-TON-berfest NFT](/v3/documentation/archive/hacktoberfest-2022#what-are-the-rewards).

Welcome to the club, this is just the beginning!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ After that, feel free to add your repository to the list.
As a repository maintainer in the TON Ecosystem, you will be able to receive two types of rewards:

1. [Hacktoberfest Reward Kit](https://hacktoberfest.com/participation/#maintainers) (_see REWARD FOR MAINTAINERS_)
2. [Limited Hack-TON-berfest NFT](/v3/documentation/archive/hacktoberfest-2022/#what-the-rewards) (_please, register the wallet address in the [@toncontests_bot](https://t.me/toncontests_bot)_)
2. [Limited Hack-TON-berfest NFT](/v3/documentation/archive/hacktoberfest-2022#what-are-the-rewards) (_please, register the wallet address in the [@toncontests_bot](https://t.me/toncontests_bot)_)

## How to join and be listed?

Expand Down
12 changes: 6 additions & 6 deletions docs/v3/documentation/archive/mining.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ To start mining right away:
1. Get a [computer suitable for mining](#hardware).
2. Install [Ubuntu](https://ubuntu.com) 20.04 desktop or server distribution.
3. Install [mytonctrl](https://github.com/igroman787/mytonctrl#installation-ubuntu) in `lite` mode.
4. Check your hardware and [expected mining income](#faq-emi) by running `emi` command within `mytonctrl`.
4. Check your hardware and [expected mining income](/v3/documentation/archive/mining#income-estimates) by running `emi` command within `mytonctrl`.
5. If you do not yet have one, create `wallet address` using one of the [wallets](https://www.ton.org/wallets).
6. Define your `wallet address` as a mining target by executing `set minerAddr "..."` in `mytonctrl`.
7. Chose a giver contract from the list available on [ton.org/mining](https://ton.org/mining) and set your miner to mine it by executing `set powAddr "..."` in `mytonctrl`.
Expand All @@ -25,7 +25,7 @@ To start mining right away:
## <a id="basics"></a>Basics
Toncoin is distributed by `PoW Givers`, which are smart contracts with specific amounts of Toncoin assigned to them. Currently, there are 10 active PoW givers on the TON Network. Each giver distributes coins in blocks of 100 TON. To earn one of these blocks, your computer must solve a complex mathematical challenge faster than other miners. If another miner solves the problem before you, your machine's work is discarded, and a new round begins.

Mining profits are not gradual; they come in batches of 100 TON for each successfully solved giver challenge. This means that if your machine has a 10% chance to calculate a block within 24 hours (see step 4 of [Quick start](#quickStart)) then you will probably need to wait for ~10 days before you will get a 100 TON reward.
Mining profits are not gradual; they come in batches of 100 TON for each successfully solved giver challenge. This means that if your machine has a 10% chance to calculate a block within 24 hours (see step 4 of [Quick start](/v3/documentation/archive/mining#quick-start)) then you will probably need to wait for ~10 days before you will get a 100 TON reward.

The process of mining is largely automated by `mytonctrl`. Detailed information about the mining process can be found in [PoW givers](https://www.ton.org/#/howto/pow-givers) document.

Expand Down Expand Up @@ -59,7 +59,7 @@ A miner running in lite mode uses minimal storage space and does not store data.
Plain miner needs the ability to open outgoing connections to the Internet.

#### FPGA / ASIC
See [can I use FPGA / ASICs?](#faq-hw-asic)
See [can I use FPGA / ASICs?](/v3/documentation/archive/mining#can-i-use-my-btceth-rig-to-mine-ton)

### <a id="hardware-cloud"></a>Cloud machines
Many people mine using AWS or Google compute cloud machines. As outlined in the specs above, what really matters is CPU. Therefore, we advise AWS [c5a.24xlarge](https://aws.amazon.com/ec2/instance-types/c5/) or Google [n2d-highcpu-224](https://cloud.google.com/compute/vm-instance-pricing) instances.
Expand Down Expand Up @@ -93,7 +93,7 @@ As of August 2021, about 4.9BN Toncoins have been mined.
#### <a id="faq-general-whomined"></a>Who has mined those coins?
Coins have been mined to over 70,000 wallets. The owners of these wallets remain unknown.
#### <a id="faq-general-elite"></a>Is it difficult to start mining?
Not at all. All you need is [adequate hardware](#hardware) and to follow the steps outlined in the [quick start](#quickStart) section.
Not at all. All you need is [adequate hardware](#hardware) and to follow the steps outlined in the [quick start](#quick-start) section.
#### <a id="faq-general-pissed"></a>Is there another way to mine?
Yes, there is a third-party app—[TON Miner Bot](https://t.me/TonMinerBot).
#### <a id="faq-general-stats"></a>Where can I see mining statistics?
Expand All @@ -105,7 +105,7 @@ No, you do not. Anyone can start mining without owning a single Toncoin.
#### <a id="faq-mining-noincome"></a>Why does my wallet balance not increase, even after hours of mining?
TON are mined in blocks of 100, you either guess a block and receive 100 TON or receive nothing. Please see [basics](#basics).
#### <a id="faq-mining-noblocks"></a>I've been mining for days and I see no results, why?
Did you check your current [Income estimates](#hardware-estimates)? If field `Est. 24h chance to mine a block` is less than 100%, then you need to be patient. Also, please note that a 50% chance to mine a block within 24 hours does not automatically mean that you will mine one within 2 days; 50% applies to each day separately.
Did you check your current [Income estimates](/v3/documentation/archive/mining#income-estimates)? If field `Est. 24h chance to mine a block` is less than 100%, then you need to be patient. Also, please note that a 50% chance to mine a block within 24 hours does not automatically mean that you will mine one within 2 days; 50% applies to each day separately.
#### <a id="faq-mining-pools"></a>Are there mining pools?
No, as of now there are no implementations of mining pools, everyone mines for themselves.
#### <a id="faq-mining-giver"></a>Which giver should I mine?
Expand All @@ -114,7 +114,7 @@ It does not really matter which giver you choose. The difficulty tends to fluctu
#### <a id="faq-hw-machine"></a>Will a faster machine always win?
No, all miners take different roads to find the solution. A faster machine has a higher probability of success, but it doesn't guarantee victory!
#### <a id="faq-hw-machine"></a>How much income will my machine generate?
Please see [Income estimates](#hardware-estimates).
Please see [Income estimates](/v3/documentation/archive/mining#income-estimates).
#### <a id="faq-hw-asic"></a>Can I use my BTC/ETH rig to mine TON?
No, TON uses a single SHA256 hashing method which is different from BTC, ETH, and others. ASICS or FPGAs which are built for mining other cryptos will not help.
#### <a id="faq-hw-svsm"></a>What is better, a single fast machine or several slow ones?
Expand Down
2 changes: 1 addition & 1 deletion docs/v3/documentation/dapps/assets/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ TON has three types of digital assets.
- Native token, which is special kind of assets that can be attached to any message on the network. But these asset is currently not in use since the functionality for issuing new native tokens is closed.

## Interaction with TON blockchain
Basic operations on TON Blockchain can be carried out via TonLib. It is a shared library which can be compiled along with a TON node and expose APIs for interaction with the blockchain via so-called lite servers (servers for lite clients). TonLib follows a trustless approach by checking proofs for all incoming data; thus, there is no necessity for a trusted data provider. Methods available to TonLib are listed [in the TL scheme](https://github.com/ton-blockchain/ton/blob/master/tl/generate/scheme/tonlib_api.tl#L234). They can be used either as a shared library via [wrappers](/v3/guidelines/dapps/asset-processing/payments-processing/#repositories).
Basic operations on TON Blockchain can be carried out via TonLib. It is a shared library which can be compiled along with a TON node and expose APIs for interaction with the blockchain via so-called lite servers (servers for lite clients). TonLib follows a trustless approach by checking proofs for all incoming data; thus, there is no necessity for a trusted data provider. Methods available to TonLib are listed [in the TL scheme](https://github.com/ton-blockchain/ton/blob/master/tl/generate/scheme/tonlib_api.tl#L234). They can be used either as a shared library via [wrappers](/v3/guidelines/dapps/asset-processing/payments-processing/#sdks).

## Read next

Expand Down
4 changes: 2 additions & 2 deletions docs/v3/documentation/dapps/assets/usdt.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ To integrate Tether’s USD₮ Token on TON Blockchain use the contract address:
:::

<Button href="https://github.com/ton-community/assets-sdk" colorType="primary" sizeType={'sm'}>Assets SDK</Button>
<Button href="v3/guidelines/dapps/asset-processing/jettons" colorType={'secondary'} sizeType={'sm'}>Jetton Processing</Button>
<Button href="/v3/guidelines/dapps/asset-processing/jettons" colorType={'secondary'} sizeType={'sm'}>Jetton Processing</Button>
<Button href="https://github.com/ton-community/tma-usdt-payments-demo?tab=readme-ov-file#tma-usdt-payments-demo" colorType={'secondary'} sizeType={'sm'}>TMA USDT payments demo</Button>


Expand Down Expand Up @@ -46,7 +46,7 @@ TON’s high throughput and rapid confirmation times enable USD₮ transactions
:::caution IMPORTANT
In TON Blockchain Jettons can be created with duplicate names. Technically, it will not differ in any way from the real USD₮ but it will have no value because of no security. You can check it for fraud only by checking Jetton Master address.

See important [recommendations](/v3/guidelines/dapps/asset-processing/jettons#jetton-wallet-processing).
See important [recommendations](/v3/guidelines/dapps/asset-processing/jettons).
:::

## See Also
Expand Down
2 changes: 1 addition & 1 deletion docs/v3/documentation/dapps/defi/coins.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,6 @@ Note that if there are a large number of extra currencies created, the accounts

Thus, extra currencies are best used for well-known decentralized currencies (for example, Wrapped Bitcoin or Ether), and creating such an extra currency should be quite expensive.

[Jettons](/v3/documentation/dapps/defi/tokens#jettons) are suitable for other tasks.
[Jettons](/v3/documentation/dapps/defi/tokens#jettons-fungible-tokens) are suitable for other tasks.

At the moment, no extra currency has been created on TON Blockchain. TON Blockchain has full support for extra currencies by accounts and messages, but the minter system contract for their creation has not yet been created.
2 changes: 1 addition & 1 deletion docs/v3/documentation/dapps/oracles/red_stone.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ the [endpoint](https://cairo-utils-web.vercel.app/)
The value of `feed_ids` should be passed as a serialized `tuple` of `int`s.

The value `payload` is packed from an array of bytes representing the serialized RedStone payload.
See [TON RedStone payload packing](#-ton-redstone-payload-packing) section below, as well as the file [constants.fc](https://github.com/redstone-finance/redstone-oracles-monorepo/blob/main/packages/ton-connector/contracts/redstone/constants.fc), containing all needed `int`-length constants.
See [TON RedStone payload packing](#ton-redstone-payload-packing) section below, as well as the file [constants.fc](https://github.com/redstone-finance/redstone-oracles-monorepo/blob/main/packages/ton-connector/contracts/redstone/constants.fc), containing all needed `int`-length constants.

#### get_prices

Expand Down
6 changes: 3 additions & 3 deletions docs/v3/documentation/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This section covers the most popular questions about TON Blockchain.

### What are some of the main similarities and differences to EVM blockchains?

- [Ethereum to TON](/v3/concepts/dive-into-ton/introduction#ethereum-to-ton)
- [Ethereum to TON](/v3/concepts/dive-into-ton/go-from-ethereum/tvm-vs-evm)
- [Comparison of TON, Solana and Ethereum 2.0](https://ton.org/comparison_of_blockchains.pdf)


Expand Down Expand Up @@ -158,7 +158,7 @@ Non-fungible tokens (NFTs):
Jettons (tokens):
- [TEP-74: Jettons standard](https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md)
- [Distributed tokens overview](https://telegra.ph/Scalable-DeFi-in-TON-03-30)
- [Fungible token documentation(Jettons)](/v3/documentation/dapps/defi/tokens#jettons)
- [Fungible token documentation(Jettons)](/v3/documentation/dapps/defi/tokens#jettons-fungible-tokens)

Other Standards:
- https://github.com/ton-blockchain/TEPs
Expand Down Expand Up @@ -217,7 +217,7 @@ Smart contract can exist in uninitialized state, meaning that its state is not a

To protect message chains from being halted at non-existing contracts TON use "bounce" feature. Read more in these articles:

- [Deploying wallet via TonLib](/v3/guidelines/dapps/asset-processing/payments-processing/#deploying-wallet)
- [Deploying wallet via TonLib](/v3/guidelines/dapps/asset-processing/payments-processing#wallet-deployment)
- [Paying for processing queries and sending responses](/v3/documentation/smart-contracts/transaction-fees/forward-fees)

### Does the upgradability of a smart-contract pose a threat to its users?
Expand Down
1 change: 1 addition & 0 deletions docs/v3/documentation/infra/nodes/node-commands.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ This document describes the various flags and options available when running a T
| `--celldb-cache-size` | Sets the block cache size for RocksDb in CellDb, in bytes. | `1G` (1 Gigabyte) | `--celldb-cache-size <size>` |
| `--celldb-direct-io` | Enables direct I/O mode for RocksDb in CellDb (only applies when cache size is >= 30G). | Disabled | `--celldb-direct-io` |
| `--celldb-preload-all` | Preloads all cells from CellDb on startup. | Disabled | `--celldb-preload-all` |
| `--celldb-in-memory` | Stores the whole celldb in memory. For validators with default settings, size of celldb ~80-100GB, so 128 Gb is absolutely necessary and 256 is preferred.| Disabled| `--celldb-in-memory` |
| `--catchain-max-block-delay` | Sets the delay before creating a new catchain block, in seconds. | `0.4` seconds | `--catchain-max-block-delay <seconds>` |
| `--catchain-max-block-delay-slow` | Sets the maximum extended catchain block delay for too long rounds, in seconds. | `1.0` seconds | `--catchain-max-block-delay-slow <seconds>` |
| `--fast-state-serializer` | Enables a faster persistent state serializer, requires more RAM. | Disabled | `--fast-state-serializer` |
Expand Down
4 changes: 2 additions & 2 deletions docs/v3/documentation/infra/nodes/node-types.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Full nodes _prune_ the state of the TON blockchain kept by them - that means, ea
To allow client applications to look for blocks and transactions, as well as to send new transactions into the TON blockchain, full nodes are equipped with the liteserver functionality: see [Interacting with TON nodes](#interacting-with-ton-nodes) below.


<Button href="/v3/guidelines/nodes/running-nodes/full-node"
<Button href="/v3/guidelines/nodes/running-nodes/full-node#run-a-node-video"
colorType="primary" sizeType={'sm'}>

Running a Full Node
Expand Down Expand Up @@ -80,7 +80,7 @@ Because of a permanent high load on public Liteservers, the majority of them is
This may drive to instability of your your lite client application.
:::

<Button href="/v3/guidelines/nodes/running-nodes/full-node#enable-liteserver-mode"
<Button href="/v3/guidelines/nodes/running-nodes/liteserver-node"
colorType="primary" sizeType={'sm'}>
Enable Liteserver in your Node
</Button>
Expand Down
Loading
Loading