external/ton
1
0
Fork 0
mirror of https://github.com/ton-blockchain/ton synced 2025-03-09 15:40:10 +00:00
Code Issues Releases Wiki Activity

initial commit

Browse source
This commit is contained in:
initial commit 2019-09-07 14:03:22 +04:00 • committed by vvaltman
commit c2da007f40
1610 changed files with 398047 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
lite-client-docs/DISCLAIMER Normal file
View file

@ -0,0 +1,9 @@
Please read the following before you download the TON Blockchain Lite Client and connect to the TON Test Network. By downloading the TON Blockchain Lite Client and associated software and connecting to the TON Test Network, you accept and agree to be bound and abide by the following terms:
1. You agree to use the TON Test Network only for lawful purposes and only for testing and development purposes.
2. YOUR USE OF THE TON TEST NETWORK IS AT YOUR OWN RISK. THE TON TEST NETWORK IS PROVIDED ON AN "AS IS" AND "AS AVAILABLE" BASIS, WITHOUT ANY WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED. YOU UNDERSTAND AND ACKNOWLEDGE THAT THE TON TEST NETWORK IS STILL UNDER DEVELOPMENT AND TESTING.
3. NEITHER TELEGRAM NOR ANY PERSON ASSOCIATED WITH TELEGRAM MAKES, AND HEREBY DISCLAIMS, ANY WARRANTY OR REPRESENTATION WITH RESPECT TO THE COMPLETENESS, SECURITY, RELIABILITY, QUALITY, ACCURACY, AVAILABILITY, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT OF THE TON TEST NETWORK. WITHOUT LIMITING THE FOREGOING, NEITHER TELEGRAM NOR ANYONE ASSOCIATED WITH TELEGRAM REPRESENTS OR WARRANTS THAT THE TON TEST NETWORK WILL BE ACCURATE, RELIABLE, ERROR-FREE OR UNINTERRUPTED, THAT DEFECTS WILL BE CORRECTED, THAT THE TON TEST NETWORK IS FREE OF VIRUSES OR OTHER HARMFUL COMPONENTS OR THAT THE TON TEST NETWORK WILL OTHERWISE MEET YOUR NEEDS OR EXPECTATIONS. SOME JURISDICTIONS DO NOT ALLOW EXCLUSION OF WARRANTIES OR LIMITATIONS ON THE DURATION OF IMPLIED WARRANTIES, SO THE ABOVE DISCLAIMER MAY NOT APPLY TO YOU IN ITS ENTIRETY, BUT WILL APPLY TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW.
4. TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT WILL TELEGRAM NOR ANY PERSON ASSOCIATED WITH TELEGRAM BE LIABLE FOR ANY LOSS OF USE, LOST DATA, FAILURE OF SECURITY MECHANISMS, INTERRUPTION OF BUSINESS, OR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY KIND (INCLUDING LOST PROFITS), REGARDLESS OF THE FORM OF ACTION, WHETHER IN CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF INFORMED OF THE POSSIBILITY OF SUCH DAMAGES IN ADVANCE. NOTWITHSTANDING ANY OTHER PROVISION OF THIS TERMS OF USE, NEITHER TELEGRAM NOR ANY PERSON ASSOCIATED WITH TELEGRAM SHALL HAVE ANY LIABILITY UNDER THIS TERMS OF USE.

48
lite-client-docs/README Normal file
View file

@ -0,0 +1,48 @@
This archive is a distribution of a preliminary version of the TON Blockchain Lite Client along with the relevant portions of the TON Blockchain Library. It is not necessarily representative of the totality of the TON Blockchain code developed so far; rather it is a simplified stable version, containing only those files that are necessary for compiling the Lite Client, and sometimes outdated versions of these files sufficient for this purpose.
Use this software at your own risk; consult the DISCLAIMER for more information.
The software is licensed under GNU Lesser General Public License version 2 or later; consult LICENSE.LGPL and LGPL.v2 for more information. If you ever use any of these source files to develop your own versions of this or other software, you must attach a comment with the contents of LGPL.v2 to the beginning of each source file taken from this archive.
The software is likely to compile and work properly on most Linux systems. It should work on macOS and even Windows; however, we do not guarantee this for this preliminary version.
BASIC COMPILATION AND INSTALLATION INSTRUCTIONS
1) Download and unpack the newest version of this archive, available at
https://test.ton.org/download
The TON Blockchain Test Network is updated quite often, so we cannot guarantee that older versions of the Lite Client will always work. Backward compatibility is not enforced at this development stage.
2) Install the newest versions of make, cmake (version 3.0.2 or later), OpenSSL (including C header files), and g++ or clang (or another C++14-compatible compiler as appropriate for your operating system).
3) Suppose that you have unpacked this archive to directory ~/lite-client, where ~ is your home directory, and that you have created an empty directory ~/liteclient-build. Then run the following in a terminal on a Linux system:
cd ~/liteclient-build
cmake ~/lite-client
cmake --build . --target lite-client
You might also want to build some extra utilities useful for smart-contract development:
cmake --build . --target fift
4) Download the newest configuration file from https://test.ton.org/ton-lite-client-test1.config.json :
wget https://test.ton.org/ton-lite-client-test1.config.json
5) Run the Lite Client:
./lite-client/lite-client -C ton-lite-client-test1.config.json
If everything was installed successfully, the Lite Client will connect to a special server (a full node for the TON Blockchain Test Network #1) and will send some queries to the server.
If you indicate a writeable "database" directory as an extra argument to the client, it will download and save the block and the state corresponding to the newest masterchain block:
./lite-client/lite-client -C ton-lite-client-test1.config.json -D ~/ton-db-dir
Basic help info can be obtained by typing "help" into the Lite Client. Type "quit" or press Ctrl-C to exit.
6) Now you can create new smart contracts, examine the state of existing smart contracts, send external messages to smart contracts and so on. You can also use Fift (if you have compiled it) to compile, execute, and debug your smart contracts locally.
More details on these activities, including step-by-step instructions for creating a simple wallet smart contract (along with its source code), may be found in the HOWTO file included in this archive.
7) Some documentation on the TON Blockchain and TON Virtual Machine may be found at the download page https://test.ton.org/download . Be aware that this documentation may not be completely in sync with the version currently employed by the Test Network, because some minor implementation details are likely to be changed during the final development and testing phases.