# 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": null,
"name": "tons",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "TON, wallet, TON wallet, blockchain, security, safety, cryptowallet, crypto",
"author": "tonfactory.org",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/4b/a1/875aa78328e60b4e1dcc0872d3d5a6e047e4f544fc704ac9ca38b864c6b2/tons-1.3.6.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": null,
"summary": "TON Stash - secure TON wallet",
"version": "1.3.6",
"project_urls": null,
"split_keywords": [
"ton",
" wallet",
" ton wallet",
" blockchain",
" security",
" safety",
" cryptowallet",
" crypto"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c6fb2cf58c395a8e30360e8efd679b197219f2198db82c93fbe5fa12745a101",
"md5": "0f96a771ecd8909f343f7520477e4638",
"sha256": "1929fc5e9520c2adf321c5465520c5e28c5b305391ed6acc149a831d3e0fff6c"
},
"downloads": -1,
"filename": "tons-1.3.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0f96a771ecd8909f343f7520477e4638",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 1020888,
"upload_time": "2024-07-27T14:03:30",
"upload_time_iso_8601": "2024-07-27T14:03:30.190459Z",
"url": "https://files.pythonhosted.org/packages/6c/6f/b2cf58c395a8e30360e8efd679b197219f2198db82c93fbe5fa12745a101/tons-1.3.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ba1875aa78328e60b4e1dcc0872d3d5a6e047e4f544fc704ac9ca38b864c6b2",
"md5": "0484555e33e4fac6bf96527a500c90aa",
"sha256": "28479e8d24edae6001881c42630fb2a266a0abdf0cc7b1a9d60ecb2c07c1ae74"
},
"downloads": -1,
"filename": "tons-1.3.6.tar.gz",
"has_sig": false,
"md5_digest": "0484555e33e4fac6bf96527a500c90aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 786112,
"upload_time": "2024-07-27T14:03:33",
"upload_time_iso_8601": "2024-07-27T14:03:33.690356Z",
"url": "https://files.pythonhosted.org/packages/4b/a1/875aa78328e60b4e1dcc0872d3d5a6e047e4f544fc704ac9ca38b864c6b2/tons-1.3.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-27 14:03:33",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tons"
}