-
Notifications
You must be signed in to change notification settings - Fork 57
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: more doc updates to readme files
- Loading branch information
Showing
6 changed files
with
43 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,10 @@ | ||
# sn_cli | ||
|
||
Provides the `safe` client binary, used for participating in the Safe Network. | ||
This directory contains the `safe` client binary. It is used to interact with the Safe Network and provides a range of commands for managing data, keys, wallets, and more. | ||
|
||
The `safe` binary includes the following subcommands: | ||
|
||
- `wallet`: Commands for wallet management. This includes creating wallets, checking balances, and making transactions. | ||
- `files`: Commands for file management. This includes uploading, downloading, and deleting files. | ||
- `register`: Commands for register management. This includes creating, reading, and writing to registers. | ||
- `gossipsub`: Commands for gossipsub management. This includes subscribing to topics and publishing messages. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,5 @@ | ||
# sn_peers_acquisition | ||
|
||
Provides utilities for peer acquisition. | ||
Provides utilities for discovering bootstrap peers on a given system. | ||
|
||
It handles `--peer` arguments across all bins, as well as `SAFE_PEERS` or indeed picking up an initial set of `network-conacts` from a provided, or hard-coded url. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,17 @@ | ||
# sn_transfers | ||
|
||
Provides utilities for working with transfers on the Safe Network. | ||
The `sn_transfers` crate is responsible for managing transfers within the Safe Network. | ||
|
||
Its main component is the [`CashNote`](https://github.com/maidsafe/sn_transfers/blob/main/src/cash_note.rs), which forms the basis of transfers on the Safe Network. | ||
|
||
A `CashNote` represents a spendable unit of currency in the network, denoting ownership of a certain number of `NanoTokens`. | ||
|
||
To execute a transfer, a [`SignedSpend`](https://github.com/maidsafe/sn_transfers/blob/main/src/signed_spend.rs) needs to be created and validated on the network. | ||
|
||
`Transfer`s are directed to `UniquePubKey`s, which are derived from `MainPubKey`s. Using a `DerivationIndex`, the recipient can generate the necessary `SecretKey` to spend the `NanoTokens`. | ||
|
||
Since most of the required information is stored in a `SignedSpend` on the network, we also provide a [`CashNoteRedemption`](https://github.com/maidsafe/sn_transfers/blob/main/src/cash_note_redemption.rs) struct. This struct contains the minimum information needed to retrieve a full `Spend` from the network and generate the keys required to spend the `NanoTokens`. | ||
|
||
For error handling, we expose [`Error`](https://github.com/maidsafe/sn_transfers/blob/main/src/error.rs) and [`Result`](https://github.com/maidsafe/sn_transfers/blob/main/src/result.rs) types. | ||
|
||
Additionally, this crate re-exports the `bls` crate used in the public API and includes a helper module for creating an Rng when invoking `sn_transfers` methods that require them. |