# Tons
[![PyPI](https://img.shields.io/pypi/v/tons?color=blue)](https://pypi.org/project/tons/)
[![Downloads](https://static.pepy.tech/badge/tons)](https://pepy.tech/project/tons)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tons)](https://pypi.org/project/tons/)
# Documentation
You can find [installation guide](https://tonfactory.github.io/tons-docs/installation)
and all available features in our [docs](https://tonfactory.github.io/tons-docs/).
# Introduction
**tons** is an Open Source cross-platform wallet application
and command-line interface to maintain any type of wallet on the TON network
on desktops and servers. Works with Windows/Mac/Linux.
**tons** has different UI versions thanks to which any user will find a suitable interface:
- [tons-interactive](#tons-interactive)
- [tons](#tons)
- [tons-gui](#tons-gui)
**tons** uses specific filesystem architecture that is maintained by the application.
```
.tons
├── config.yaml
├── whitelist.json
├── keystores
│ ├── *.keystore
```
## User interfaces
### tons-interactive
*tons-interactive* is a convenient interface to control your assets through terminal.
```bash
$ tons-interactive
[✓] Pick command: Keystores
[✓] Pick command: Open keystore
[✓] Choose keystore to use: 🔒 personal.keystore
[?] Pick command [personal.keystore]: List wallets
> List wallets
Transfer
Advanced Transfer
Whitelist
Tonconnect v2
DNS
Jetton
...
```
### tons
*tons* is a batch mode interface that allows you to write automatic scripts.
To get all available subcommands and flags run a command with an '-h' flag
```bash
$ tons -h
Usage: tons [OPTIONS] COMMAND [ARGS]...
Options:
--version Show the version and exit.
-c, --config Use specific config.yaml file
-h, --help Show this message and exit.
Commands:
config Control config parameters (check README.md for all fields...
contract Operate with contracts
dev Development tools
dns Operate with DNS
init Initialize .tons workdir in a current directory
keystore Operate with keystores
tonconnect Operate with TonConnect
wallet Operate with wallets
whitelist Operate with whitelist contacts
```
Example: get list of all wallets from a keystore
```bash
$ tons wallet list -v
| Name | Version | WC | Address | Comment | State | Balance |
|:------|:-------:|:--:|:------------------------------------------------:|:--------|:------:|--------:|
| dev | v3r2 | 0 | EQBxWbjry61lk0dU_8viG9M_e5x9VGOJaI9ZhOrn6vcIp7Sm | None | Active | 13.1 |
| prod | v4r2 | 0 | EQCkNipaz2C3Md-tXVBcD3E4yv8EKqMzZ41QQtsM4IdFnKP5 | None | Uninit | 0.0 |
| Total | | | | | | 13.1 |
```
### tons-gui
Graphic user interface version is being developed.
Here's a glimpse of the interface.
![tons-gui](https://tonfactory.github.io/tons-docs/assets/images/gui-797c01820e1ed143ca7ff93360c9c6b3.png)
# License
The code and data files in this distribution are licensed under the terms of the GNU General Public License version 3
as published by the Free Software Foundation. See https://www.gnu.org/licenses/ for a copy of this license.
Raw data
{
"_id": null,
"home_page": "",
"name": "tons",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "TON,wallet,TON wallet,blockchain,security,safety,cryptowallet,crypto",
"author": "tonfactory.org",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/02/ea/26e751730f97ac9b5e09bb187877264e4861a0505d1cf56961ebbf265265/tons-1.0.0.tar.gz",
"platform": null,
"description": "# Tons\n\n[![PyPI](https://img.shields.io/pypi/v/tons?color=blue)](https://pypi.org/project/tons/)\n[![Downloads](https://static.pepy.tech/badge/tons)](https://pepy.tech/project/tons)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tons)](https://pypi.org/project/tons/)\n\n\n# Documentation\n\nYou can find [installation guide](https://tonfactory.github.io/tons-docs/installation) \nand all available features in our [docs](https://tonfactory.github.io/tons-docs/).\n\n\n\n# Introduction\n\n**tons** is an Open Source cross-platform wallet application\nand command-line interface to maintain any type of wallet on the TON network\non desktops and servers. Works with Windows/Mac/Linux.\n\n**tons** has different UI versions thanks to which any user will find a suitable interface:\n- [tons-interactive](#tons-interactive)\n- [tons](#tons)\n- [tons-gui](#tons-gui)\n\n\n**tons** uses specific filesystem architecture that is maintained by the application.\n```\n.tons\n\u251c\u2500\u2500 config.yaml\n\u251c\u2500\u2500 whitelist.json\n\u251c\u2500\u2500 keystores\n\u2502 \u251c\u2500\u2500 *.keystore\n```\n\n\n## User interfaces\n\n\n### tons-interactive\n\n*tons-interactive* is a convenient interface to control your assets through terminal.\n\n```bash\n$ tons-interactive\n[\u2713] Pick command: Keystores\n[\u2713] Pick command: Open keystore\n[\u2713] Choose keystore to use: \ud83d\udd12 personal.keystore\n[?] Pick command [personal.keystore]: List wallets\n > List wallets\n Transfer\n Advanced Transfer\n Whitelist\n Tonconnect v2\n DNS\n Jetton\n ...\n```\n\n\n### tons\n\n*tons* is a batch mode interface that allows you to write automatic scripts.\n\nTo get all available subcommands and flags run a command with an '-h' flag\n```bash\n$ tons -h\nUsage: tons [OPTIONS] COMMAND [ARGS]...\n\nOptions:\n --version Show the version and exit.\n -c, --config Use specific config.yaml file\n -h, --help Show this message and exit.\n\nCommands:\n config Control config parameters (check README.md for all fields...\n contract Operate with contracts\n dev Development tools\n dns Operate with DNS\n init Initialize .tons workdir in a current directory\n keystore Operate with keystores\n tonconnect Operate with TonConnect\n wallet Operate with wallets\n whitelist Operate with whitelist contacts\n```\n\nExample: get list of all wallets from a keystore\n```bash\n$ tons wallet list -v\n| Name | Version | WC | Address | Comment | State | Balance |\n|:------|:-------:|:--:|:------------------------------------------------:|:--------|:------:|--------:|\n| dev | v3r2 | 0 | EQBxWbjry61lk0dU_8viG9M_e5x9VGOJaI9ZhOrn6vcIp7Sm | None | Active | 13.1 |\n| prod | v4r2 | 0 | EQCkNipaz2C3Md-tXVBcD3E4yv8EKqMzZ41QQtsM4IdFnKP5 | None | Uninit | 0.0 |\n| Total | | | | | | 13.1 |\n```\n\n### tons-gui\n\nGraphic user interface version is being developed.\nHere's a glimpse of the interface.\n\n![tons-gui](https://tonfactory.github.io/tons-docs/assets/images/gui-797c01820e1ed143ca7ff93360c9c6b3.png) \n\n# License\n\nThe code and data files in this distribution are licensed under the terms of the GNU General Public License version 3 \nas published by the Free Software Foundation. See https://www.gnu.org/licenses/ for a copy of this license.\n",
"bugtrack_url": null,
"license": "",
"summary": "TON Stash - secure TON wallet",
"version": "1.0.0",
"project_urls": null,
"split_keywords": [
"ton",
"wallet",
"ton wallet",
"blockchain",
"security",
"safety",
"cryptowallet",
"crypto"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da46ca21ac7c19a5eb27fd01e323fa8cdcf5236d8f2cde41a94b2560471502e3",
"md5": "38fc6ea015c631578b3643400475a739",
"sha256": "df96996d98804dfd979ba5ce8e2e39df2e47148a728e8149c775cfce071c83b0"
},
"downloads": -1,
"filename": "tons-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "38fc6ea015c631578b3643400475a739",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 177771,
"upload_time": "2023-08-03T15:40:26",
"upload_time_iso_8601": "2023-08-03T15:40:26.989748Z",
"url": "https://files.pythonhosted.org/packages/da/46/ca21ac7c19a5eb27fd01e323fa8cdcf5236d8f2cde41a94b2560471502e3/tons-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "02ea26e751730f97ac9b5e09bb187877264e4861a0505d1cf56961ebbf265265",
"md5": "e9e275400962577870f8e10e57d2bb7e",
"sha256": "72638784fdbc27d5eba778e49ac17d15fbffbb10e9336a01d54cb93c74e36aba"
},
"downloads": -1,
"filename": "tons-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "e9e275400962577870f8e10e57d2bb7e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 133662,
"upload_time": "2023-08-03T15:40:29",
"upload_time_iso_8601": "2023-08-03T15:40:29.804326Z",
"url": "https://files.pythonhosted.org/packages/02/ea/26e751730f97ac9b5e09bb187877264e4861a0505d1cf56961ebbf265265/tons-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-03 15:40:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tons"
}