Skip to content

Commit 4814d3a

Browse files
committed
made compatible with torus v0 initial release
1 parent c06924c commit 4814d3a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+387
-2151
lines changed

README.md

Lines changed: 66 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,38 @@
1-
# CommuneX
1+
# Torus CLI
2+
3+
The Torus CLI serves as an official SDK for the network, offering a streamlined and
4+
user-friendly experience. It is designed for simplicity and scalable
5+
development. To learn more [visit docs](https://docs.torus.network/installation/setup-torus-cli)
6+
7+
## Contents
28

39
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4-
[![Discord Chat](https://img.shields.io/badge/discord-join%20chat-blue.svg)](https://go.agicommies.org/commune-discord)
10+
[![Discord Chat](https://img.shields.io/badge/discord-join%20chat-blue.svg)](https://discord.gg/W2H8Q6aE)
511
[![PyPI version](https://badge.fury.io/py/torus.svg)](https://pypi.org/project/torus/)
612

7-
- [Why CommuneX](#why-torus)
8-
- [Installation with `pip`](#installation-with-pip)
9-
- [Installation with Nix](#installation-with-nix)
10-
- [Features](#features)
11-
- [Planned](#planned)
12-
- [CLI Usage](#cli-usage)
13+
- [Torus CLI](#torus-cli)
14+
- [Contents](#contents)
15+
- [Installation with `pip`](#installation-with-pip)
16+
- [Installation with Nix](#installation-with-nix)
17+
- [Features](#features)
18+
- [CLI Usage](#cli-usage)
1319
- [Examples](#examples)
20+
- [Retrieving Balance](#retrieving-balance)
21+
- [Creating a Key](#creating-a-key)
22+
- [Retrieving Key Info](#retrieving-key-info)
23+
- [Listing Keys](#listing-keys)
24+
- [List Keys With Balances](#list-keys-with-balances)
25+
- [Retrieving Agent Information](#retrieving-agent-information)
26+
- [Retrieving Global Parameters](#retrieving-global-parameters)
27+
- [Retrieving Circulating Supply](#retrieving-circulating-supply)
1428
- [Completions](#completions)
15-
- [Contributing](#contributing)
16-
- [Commune compatibility](#commune-compatibility)
17-
18-
## Why CommuneX
19-
20-
CommuneX serves as an alternative library/SDK to the original [Commune
21-
Ai](https://github.com/commune-ai/commune) codebase, offering a streamlined and
22-
user-friendly experience. It is designed for simplicity and scalable
23-
development. To learn more [visit docs](https://docs.torus.ai/torus)
29+
- [Contributing](#contributing)
2430

2531
## Installation with `pip`
2632

2733
Requirements: Python 3.10+
2834

29-
Install the `torus` Python package directly with `pip`:
35+
Install the `torus-cli` Python package directly with `pip`:
3036

3137
```sh
3238
pip install torus
@@ -47,123 +53,112 @@ nix profile install .
4753

4854
## Features
4955

50-
- [x] Commands
51-
- [x] Key management
52-
- [x] Transfering and staking tokens
53-
- [x] Module management
54-
- [x] Client to interact with served modules
55-
- [x] Module class and server
56-
- [x] Governance participation
56+
The `torus-cli` offers a variety of features for token management and agent interaction:
5757

58-
### Planned
58+
- Commands for managing keys, tokens, and agents
59+
- Key management including creation and listing
60+
- Token operations such as transferring and staking
61+
- Agent management for registration, curation and updates
62+
- Participation in governance processes
5963

60-
- [ ] Module API extraction and documentation generator
6164

6265
## CLI Usage
6366

6467
The CLI commands are structured as follows:
6568

6669
```sh
67-
comx [OPTIONS] COMMAND [ARGS]
70+
torus-cli [OPTIONS] COMMAND [ARGS]
6871
```
6972

7073
There are six top-level subcommands:
7174

72-
- **balance**: transfer, stake, unstake and showing balance operations
73-
- **key**: creating, saving (AKA regenerating), listing and showing balance
74-
operations
75-
- **module**: info, list, register, serve, update
76-
- **network**: block, parameters, proposals / proposing, voting operations
77-
- **subnet**: info, list, update
78-
- **misc**: apr, circulating supply
75+
- **balance**: Manage token balances and staking.
76+
- **key**: Handle key creation and management.
77+
- **agent**: Manage information and operations related to agents.
78+
- **network**: Interact with network operations like block and proposal management.
79+
- **misc**: Access miscellaneous information such as APR and circulating supply.
7980

8081
```sh
81-
comx subcommand [OPTIONS] COMMAND [ARGS]...
82+
torus-cli subcommand [OPTIONS] COMMAND [ARGS]...
8283
```
8384

84-
### Examples
85+
## Examples
8586

86-
#### Retrieving Balance
87+
### Retrieving Balance
8788

8889
```sh
8990
# Show staked, free and total balance.
90-
comx balance show 5FgfC2DY4yreEWEughz46RZYQ8oBhHVqD9fVq6gV89E6z4Ea
91+
torus-cli balance show 5FgfC2DY4yreEWEughz46RZYQ8oBhHVqD9fVq6gV89E6z4Ea
9192
```
9293

93-
#### Creating a Key
94+
### Creating a Key
9495

9596
```sh
96-
comx key create key_name
97+
torus-cli key create key_name
9798
```
9899

99-
#### Retrieving Key Info
100+
### Retrieving Key Info
100101

101102
```sh
102-
comx key show key_name
103+
torus-cli key show key_name
103104

104-
# Add the `--show-private` flag to show sentitive fields like private key.
105-
comx key show key_name --show-private
105+
# Add the `--show-private` flag to show sensitive fields like private key.
106+
torus-cli key show key_name --show-private
106107
```
107108

108-
#### Listing Keys
109+
### Listing Keys
109110

110111
```sh
111112
# Lists the names and addresses of keys stored on disk.
112-
comx key list
113+
torus-cli key list
113114
```
114115

115-
#### List Keys With Balances
116+
### List Keys With Balances
116117

117118
```sh
118119
# Lists keys stored on disk with their balance (free, staked and total).
119-
comx key balances
120+
torus-cli key balances
120121
```
121122

122-
#### Retrieving Module Information
123+
### Retrieving Agent Information
123124

124125
```sh
125-
# Note that the module has to be registered on the network.
126-
comx module info vali::calc [--balance]
126+
# Note that the agent has to be registered on the network.
127+
torus-cli agent info vali::calc [--balance]
127128
```
128129

129-
#### Retrieving Global Parameters
130+
### Retrieving Global Parameters
130131

131132
```sh
132-
comx network params
133+
torus-cli network params
133134
```
134135

135-
#### Retrieving Subnet Parameters
136-
137-
```sh
138-
comx subnet list
139-
```
140-
141-
#### Retrieving Circulating Supply
136+
### Retrieving Circulating Supply
142137

143138
```sh
144139
# Gets all tokens then were ever emitted minus burned tokens.
145-
comx misc circulating-supply
140+
torus-cli misc circulating-supply
146141
```
147142

148-
### Completions
143+
## Completions
149144

150145
You can enable completions for your shell by running:
151146

152147
```sh
153148
# On bash
154-
comx --install-completion bash
149+
torus-cli --install-completion bash
155150
# On zsh
156-
comx --install-completion zsh
151+
torus-cli --install-completion zsh
157152
```
158153

159154
## Contributing
160155

161156
Bug reports and pull requests and other forms of contribution are welcomed and
162-
encouraged! :)
157+
encouraged! :)
163158

164159
To report a bug or request a feature, please [open an issue on GitHub].
165160

166-
If you have any questions, feel free to ask on the [CommuneX Discord channel] or
161+
If you have any questions, feel free to ask on the [CLI Discord channel] or
167162
post on our [GitHub discussions page].
168163

169164
To contribute to the codebase, using Poetry you can install the development dependencies with:
@@ -172,20 +167,11 @@ To contribute to the codebase, using Poetry you can install the development depe
172167
poetry install --with dev
173168
```
174169

175-
it can [require some enviroment-specific binaries to be installed][ruff-installation]
176-
177-
## Commune compatibility
178-
179-
Yes, `torus` is compatible with the `commune` library/CLI. However, there are
180-
important considerations to note. `torus` verifies the integrity of your
181-
keys, which means that mixing certain types of keys is not permissible.
182-
Specifically, if you possess node keys or other similar types that are not
183-
designed to receive tokens, you to relocate them outside of the key
184-
directory.
170+
it can [require some environment-specific binaries to be installed][ruff-installation]
185171

186172
---
187173

188-
[open an issue on GitHub]: https://github.com/agicommies/torus/issues/new/choose
189-
[CommuneX Discord channel]: https://go.agicommies.org/torus-channel
190-
[GitHub discussions page]: https://github.com/agicommies/torus/discussions
174+
[open an issue on GitHub]: https://github.com/renlabs-dev/torus-cli/issues/new/choose
175+
[torus-cli Discord channel]: https://go.renlabs-dev.org/torus-cli-channel
176+
[GitHub discussions page]: https://github.com/renlabs-dev/torus-cli/discussions
191177
[ruff-installation]: https://docs.astral.sh/ruff/installation/

docs/.gitkeep

Whitespace-only changes.

docs/assets/favicon.ico

-14.7 KB
Binary file not shown.

docs/assets/logo.png

-64 KB
Binary file not shown.

docs/bootnodes.txt

Lines changed: 0 additions & 22 deletions
This file was deleted.

docs/modules/miner.md

Lines changed: 0 additions & 68 deletions
This file was deleted.

0 commit comments

Comments
 (0)