Skip to content

Commit

Permalink
Merge branch 'main' into entry-point-mount
Browse files Browse the repository at this point in the history
  • Loading branch information
gkaravatski committed Nov 21, 2024
2 parents cf349fc + c3fd852 commit fe4cb70
Show file tree
Hide file tree
Showing 258 changed files with 39,607 additions and 654 deletions.
12 changes: 11 additions & 1 deletion cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@
"Gravi",
"Hackathon",
"Highlevel",
"Highlit",
"IPFS",
"InMsgDescr",
"Indo-European",
Expand All @@ -72,6 +73,7 @@
"Jettons",
"Kademlia",
"Keccak",
"Lamport",
"Masterchain",
"Mbit",
"Merkle",
Expand All @@ -80,6 +82,7 @@
"Multiplatform",
"Mytonctrl",
"NVME",
"Nand",
"Notcoin",
"Offchain",
"OutMsgDescr",
Expand Down Expand Up @@ -157,6 +160,7 @@
"deeplink",
"dnsresolve",
"dracones",
"dstat",
"ed25519_chksign",
"exitcode",
"extracurrencies",
Expand All @@ -180,11 +184,14 @@
"hmac",
"howto",
"HOWTO",
"htop",
"idict",
"iftop",
"inclusivity",
"inplace",
"int",
"ints",
"iotop",
"ipfs",
"janvier",
"jetton",
Expand Down Expand Up @@ -221,6 +228,7 @@
"nanotons",
"newkeypair",
"nextra",
"nmon",
"nonexist",
"nonfinal",
"penalising",
Expand Down Expand Up @@ -283,6 +291,7 @@
"visio",
"Visio",
"votings",
"VARUINT16",
"workchain",
"workchains",
"xguard",
Expand Down Expand Up @@ -325,6 +334,7 @@
"sidebars.js",
"sidebars",
"i18n",
".husky"
".husky",
"warnings.txt"
]
}
77 changes: 0 additions & 77 deletions docs/v3/concepts/academy-overview.mdx

This file was deleted.

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
25 changes: 0 additions & 25 deletions docs/v3/concepts/ton-blockchain/shards.md

This file was deleted.

55 changes: 0 additions & 55 deletions docs/v3/concepts/ton-blockchain/smart-contract-addresses.md

This file was deleted.

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
Loading

0 comments on commit fe4cb70

Please sign in to comment.