Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/copperbits/TON

Telegram Open Network research group. Telegram: https://t.me/ton_research
https://github.com/copperbits/TON

blockchain research sharding telegram ton tutorial

Last synced: about 1 month ago
JSON representation

Telegram Open Network research group. Telegram: https://t.me/ton_research

Awesome Lists containing this project

README

        

# TON Research

This is open development community and **enthusiasts research place**. We will post our news and updates this project there.

---

## Table of contents

- [About source and github repositories](#about-source-and-github-repositories)
- [ton.org](#tonorg)
- [What we already did](#what-we-already-did)
- [Installation & Setup](#installation--setup)
- [Releases](#releases)
- [🍏macOS](#macos)
- [🐧Linux](#linux)
- [Tutorial](#tutorial)
- [Contributing](#contributing)
- [Contact us](#contact-us)

## About source and github repositories

- - is the "official"* ton client tarball
- - community version with added features but sometimes outdated code and releases
- - unchanged up to date version of tarball but on github. Also fresh binaries and docker container

\*There is no official statement that ton.org is related to the TON network. But this is only one real source of information and code at this moment.

## ton.org

- [List of available files](https://test.ton.org/) – List of available files

## What we already did

- πŸ“– Documentations:
- 🐧 Added build instructions for [ubuntu 16.04](https://github.com/copperbits/TON/blob/master/docs/copperbits_docs/ubuntu16.04.sh)
- πŸ“© Explain in [video on YouTube](https://www.youtube.com/watch?v=J7K2nq5lf7I) and [text on GitHub](/docs/Copperbits_docs/Mac_tutorial.md), how to start Lite Client on macOS and send transactions to TON network
- πŸ‡¨πŸ‡³ Wrote an [article](https://mp.weixin.qq.com/s/WLlD088acBDfjUM4bCEd0A) about the TON in Chinese and began to translate [TON whitepaper into Π‘hinese](https://drive.google.com/file/d/1acH4j7zY_XhsOUGsup4byssMXlp5000O/view) (by toozWu)

- Helpful sources:
- πŸ— Build lite client node: [Latest release](https://github.com/copperbits/TON/releases/latest)
- 🐳 Packaged lite client into [Docker](https://github.com/copperbits/TON#docker) container
- πŸ‘“ Launched a [beta explorer](https://explorer.test.ton.cryptoprocessing.io/) for test network
- πŸ’Έ Made a UI friendly [faucet for TON](https://faucet.copperbits.io/)
- πŸ” Created [mirror with updates it builds binaries and docker container on any changes in source code](https://github.com/poma/ton-lite-client) updates any 5 minutes (former TON-mirror)
- πŸ“£ Created Telegram bot post message about updates [here](https://t.me/ton_research) and [here](https://t.me/TrackingTONupdates) - with any new commits into original repo
- ✨ Created [Webserver](/docs/Copperbits_docs/WEB_SERVER.md) which realizes a web client for TON
- 🌐 [Public node](https://explorer.test.ton.cryptoprocessing.io/api) of [web client for TON](/docs/Copperbits_docs/WEB_SERVER.md)

πŸ‘‰ _pull request and suggestions are **[very welcome](https://github.com/copperbits/TON/issues/new)**!_

![Client lunch](img/run_client.png)

## Installation & Setup

There are two options. By running Docker or precompiled binary for macOS below:

**Docker**

The easiest way to run the node in a docker container:

```bash
docker run -d copperbits/ton
```

You might want to run in interactive mode and mount current dir into the container to be able to compile fif files:

```bash
docker run -ti -v "$(pwd):/data" --name ton copperbits/ton
```

Compile a fif file (if your container is running and current dir is mounted):

```bash
docker exec ton fift test.fif
```

### Releases

#### 🍏macOS

[Lite Client Latest release](https://github.com/copperbits/TON/releases/latest)

- Download [latest release](https://github.com/copperbits/TON/releases/)
- Go to the command line, where binary placed
- Run:

```bash
./lite-client -C ton-lite-client-test1.config.json
```

- run `help` to get started

- more detailed instruction you can find [here](/docs/Copperbits_docs/Mac_tutorial.md).

#### 🐧Linux

- Build instructions for [ubuntu 16.04](https://github.com/copperbits/TON/blob/master/docs/Copperbits_docs/ubuntu16.04.sh)
- Look also [Bootstap file](https://github.com/copperbits/TON/blob/master/docs/Copperbits_docs/ton-bootstrap-v2.sh) provided by TON Times

### Tutorial

All educational thing we moved it to [docs](/docs) folder.

You will find here [original readme](/docs/Original_docs/README.md), with additions of community-based tools and educational materials.

## Contributing

All this information shipped by [copperbits team](https://t.me/ton_research) and [contributors](https://github.com/copperbits/TON/graphs/contributors) :clap:

- **Questions?** Feel free to [open an issue](https://github.com/copperbits/TON/issues/new). Or ask us on [Telegam public group](https://t.me/ton_research)
- If you find **bugs, got suggestions**, or even feature requests: [open an issue](https://github.com/copperbits/TON/issues/new) :octocat:
- Star [GitHub repo](https://github.com/copperbits/TON/) to **support this project** :+1:
- **Want to share something?** Feel free to add related stuff to [awesome-ton](https://github.com/copperbits/awesome-ton) repo
- The **license** in [GNU Lesser General Public License v2.1
](https://github.com/copperbits/TON/blob/master/LICENSE) :unlock:
- Your **contributions are appreciated**. You can follow [CONTRIBUTING](https://github.com/copperbits/TON/blob/master/CONTRIBUTING.md) guide to get everything started.

## Contact us

Here is [Telegam public group](https://t.me/ton_research) - feel free to **ask any questions and proposals** there :+1: