docs: Replace oasis-node CLI with oasis CLI docs

Author: matevz

docs/general/manage-tokens/README.mdx

@@ -25,7 +25,7 @@ For your own security and peace of mind, please only use wallets that are listed
     findSidebarItem('/general/manage-tokens/terminology'),
     findSidebarItem('/general/manage-tokens/staking-and-delegating'),
     findSidebarItem('/general/manage-tokens/oasis-wallets/'),
-    findSidebarItem('/general/manage-tokens/advanced/oasis-cli-tools/'),
+    findSidebarItem('/general/manage-tokens/cli/'),
     findSidebarItem('/general/manage-tokens/holding-rose-tokens/custody-providers'),
     findSidebarItem('/general/manage-tokens/holding-rose-tokens/bitpie-wallet'),
     findSidebarItem('/general/manage-tokens/holding-rose-tokens/ledger-wallet'),

docs/general/manage-tokens/advanced/oasis-cli-tools/setup.md

@@ -11,10 +11,7 @@ To run a command that requires a connection to an online Oasis node (i.e. the `s
 
 Here are some examples of Oasis Node CLI commands that need a connection to an online Oasis node:
 
-* `oasis-node stake info`: Shows general staking information.
-* `oasis-node stake list`: Lists all accounts with positive balance.
-* `oasis-node stake account info`: Shows detailed information for an account.
-* `oasis-node consensus submit_tx`: Submits a pre-generated transaction to the network.
+
 
 ## Local commands
 

docs/general/manage-tokens/advanced/oasis-cli-tools/transfer-tokens.md

@@ -82,7 +82,8 @@ Escrow Account:
   ...
 ```
 
-We can observe that both, the general account and the escrow account (actively bounded and debonding), have a balance of 0 tokens.
+We can observe that both, the general account and the escrow account (actively
+bounded and debonding), have a balance of 0 tokens.
 
 ## Generate a Transfer Transaction
 

docs/general/manage-tokens/cli/README.md

@@ -0,0 +1,33 @@
+# Oasis CLI
+
+Oasis command-line interface (CLI) is a powerful all-in-one tool for
+interacting with the Oasis Network. You can download the latest release
+binaries from the [GitHub repository].
+
+It boasts a number of handy features:
+
+- Flexible setup:
+  - supports Mainnet, Testnet, Localnet or any other Oasis network deployment
+  - consensus layer configuration with arbitrary token
+  - configuration of custom ParaTimes with arbitrary token
+  - connecting to remote (via TCP/IP) or local (Unix socket) Oasis node
+    instance
+- Powerful wallet features:
+  - standard token operations (transfers, allowances, deposits, withdrawals and
+    balance queries)
+  - file-based wallet with password protection
+  - full Ledger hardware wallet support
+  - address book
+  - generation, signing and submitting transactions in non-interactive mode
+  - offline transaction generation for air-gapped machines
+  - transaction encryption with Deoxys-II envelope
+  - Ed25519 and Ethereum-compatible Secp256k1 encryption schemes
+  - raw, BIP-44, ADR-8 and Ledger's legacy derivation paths
+- Developer and devops features:
+  - Oasis node inspection and healthchecks
+  - official testing accounts for Oasis Localnet, test runners and debugging
+  - WebAssembly smart contract code deployment, instantiation, management and
+    calls
+  - debugging tools for deployed WebAssembly contracts
+
+[GitHub repository]: https://github.com/oasisprotocol/cli/releases

…sit-withdraw-tokens-to-from-paratime.mdx …/general/manage-tokens/cli/acccounts.mdxdocs/general/manage-tokens/advanced/oasis-cli-tools/deposit-withdraw-tokens-to-from-paratime.mdx renamed to docs/general/manage-tokens/cli/acccounts.mdx docs/general/manage-tokens/advanced/oasis-cli-tools/deposit-withdraw-tokens-to-from-paratime.mdx renamed to docs/general/manage-tokens/cli/acccounts.mdx

@@ -1,35 +1,13 @@
 import DocCard from '@theme/DocCard';
 import {findSidebarItem} from '@site/src/sidebarUtils';
 
-# Deposit/Withdraw Tokens to/from ParaTime
+# Account transactions
 
-To perform ParaTime deposits or withdrawals using a command line interface, you will need `oasis` executable which is part of the [Oasis CLI](https://github.com/oasisprotocol/oasis-sdk/tree/main/cli). `oasis` is supplemental to `oasis-node` and supports ParaTime-related operations such as deposits, withdrawals, transfers and manipulation of the smart contracts, in contrast to `oasis-node` which only supports consensus layer features.
+## Transfer
 
-We will assume that your already have an Oasis wallet with some ROSE and that you want to Deposit or Withdraw ROSE to or from Emerald ParaTime running on the Mainnet network.
+TODO
 
-:::info
-
-At time of writing, no precompiled `oasis` binaries are available. You will need to clone the [`oasis-sdk` git repository](https://github.com/oasisprotocol/oasis-sdk/) and compile the tool yourself. The process is straight forward - just follow the [Readme](https://github.com/oasisprotocol/oasis-sdk/blob/main/cli/README.md).
-
-:::
-
-:::info
-
-This chapter describes the command line interface for depositing and withdrawing ROSE which is tailored toward advanced users such as node operators. If you are interested in the end-user wallets with a graphical user interface, consult the [How to Transfer ROSE into a ParaTime](../../how-to-transfer-rose-into-paratime.mdx) chapter.
-
-:::
-
-## Import your wallet
-
-To sign any transaction you will need to import an Oasis wallet. Prepare your base64-encoded private key or the BIP39 mnemonic of your Oasis account and run:
-
-```
-oasis wallet import <SOME_WALLET_NAME>
-```
-
-Follow the interactive instructions that will guide you through the import procedure. If this is the first time you are running `oasis`, the imported wallet will become your default wallet and transactions will be signed with the key stored in this wallet, if not otherwise specified with the `--wallet` parameter.
-
-## Configure Allowance
+## Allowance
 
 In order to deposit ROSE to a ParaTime, you will first need to grant the ParaTime access to your Oasis account on the consensus layer. The following command allows Emerald to access up to 100 ROSE stored on your Oasis account which you will deposit afterwards:
 

docs/general/manage-tokens/cli/setup.md

@@ -0,0 +1,46 @@
+# Setup
+
+## Download and Run
+
+Download the latest release [here][cli-releases] and extract it to your
+favorite application folder.
+
+:::info
+
+Oasis is currently providing official builds for x86 Linux only. If you want
+to run it on another platform, you will have to [build it from source][cli-source].
+
+:::
+
+Run the Oasis CLI by typing `oasis`.
+
+:::info
+
+We suggest that you move into or put a symbolic link to `oasis` binary in your
+system path, so you can access it globally.
+
+:::
+
+Running Oasis CLI for the first time will generate a configuration file and
+populate it with the current Mainnet and Testnet networks. It will also
+configure all [Oasis-supported ParaTimes][paratimes].
+
+## Configuration
+
+The configuration folder of Oasis CLI is located:
+
+- on Windows:
+  - `%USERPROFILE%\AppData\Roaming\Oasis\`
+- on macOS:
+  - `/Users/$USER/Library/Application Support/Oasis/`
+- on Linux:
+  - `$HOME/.config/oasis/`
+
+There, you will find `cli.toml` which contains configuration of the networks,
+ParaTimes and your wallet. Additionally, each file-based account in your wallet
+will have a separate, password-encrypted `.toml` file in the same folder named
+after the name of the account. 
+
+[cli-releases]: https://github.com/oasisprotocol/cli/releases
+[cli-source]: https://github.com/oasisprotocol/cli
+[paratimes]: ../../../dapp/README.mdx

docs/general/manage-tokens/cli/wallet.md

@@ -0,0 +1,107 @@
+# Wallet Management
+
+`oasis wallet` command is used to manage your file-based or hardware wallet
+accounts. Oasis CLI supports the following account kinds:
+
+- `ed25519-adr8`: Ed25519 keypair using [ADR-8] derivation path to obtain
+  a private key from mnemonic. This is the default setting suitable for
+  accounts on the Oasis consensus layer.
+- `secp256k1-bip44`: Secp256k1 Ethereum-compatible keypair using [BIP-44]
+  with ETH coin type to derive a private key. This setting is
+  used for accounts living on EVM-compatible ParaTimes. The same account can
+  be imported into Metamask and other Ethereum wallets.
+- `ed25519-legacy`: Ed25519 keypair using a legacy 5-component derivation path.
+  This is the preferred kind for Oasis accounts stored on
+  a hardware wallet like Ledger. It is called legacy, because it was
+  implemented before [ADR-8] was standardized.
+- `ed25519-raw` and `secp256k1-raw`: Ed25519 and Secp256k1 respective keypairs
+  imported directly from Base32 or Hex-encoded private key. These kinds
+  do not use a derivation path.
+
+:::tip
+
+For compatibility with Ethereum, each `secp256k1` account has two addresses:
+
+- 20-byte hex-encoded Ethereum-compatible address, e.g. `0xDCbF59bbcC0B297F1729adB23d7a5D721B481BA9`
+- Bech32-encoded Oasis native address, e.g. `oasis1qq3agel5x07pxz08ns3d2y7sjrr3xf9paquhhhzl`.
+
+There exists a mapping from Ethereum address to the native Oasis address as in
+the example above, but there is no reverse mapping.
+
+:::
+
+[ADR-8]: ../../../adrs/0008-standard-account-key-generation.md
+[BIP-44]: https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki
+
+## Create or Import wallet
+
+`oasis wallet create` will generate a new mnemonic and derive a keypair for
+you. For optimal security, you can connect your Ledger wallet and create an
+account which uses a private key stored on the hardware wallet.
+
+If you already have a mnemonic or a raw private key, you can import it
+as a new account by running `oasis wallet import`. You will then need to
+provide a mnemonic or the raw private key in the corresponding format.
+
+## View wallets
+
+You can list all available wallets with `oasis wallet list`:
+
+```
+$ oasis wallet list
+ACCOUNT                         KIND                            ADDRESS                                        
+emerald_test                    file (secp256k1-raw)            oasis1qq3agel5x07pxz08ns3d2y7sjrr3xf9paquhhhzl
+john                            file (ed25519-raw)              oasis1qrec770vrek0a9a5lcrv0zvt22504k68svq7kzve
+oasis_hackathon                 file (ed25519-adr8:0)           oasis1qptx7ytle3xlccyvk9w27f47jq4pfqxrug2dzwtv
+sapphire_test                   file (secp256k1-raw)            oasis1qpupfu7e2n6pkezeaw0yhj8mcem8anj64ytrayne
+sapphire_tictactoe1             file (secp256k1-bip44:0)        oasis1qqd333zt6lrx734szrcay2cjzek9uumlf5rrmmr7
+sapphire_tictactoe2             file (secp256k1-bip44:1)        oasis1qrk58a6j2qn065m6p06jgjyt032f7qucy5wqeqpt
+```
+
+Above, you can see native Oasis addresses of all local accounts. You can see
+the public key of an account and for `secp256k1` accounts their Ethereum
+addresses by using `oasis wallet show`:
+
+```
+$ oasis wallet show emerald_test
+Unlock your account.
+? Passphrase: 
+Name:             emerald_test
+Public Key:       A8JDpTiCnrq+zFUsAHrHY/xuFVsyt48sC1Srkp62r7Yx
+Ethereum address: 0xDCbF59bbcC0B297F1729adB23d7a5D721B481BA9
+Native address:   oasis1qq3agel5x07pxz08ns3d2y7sjrr3xf9paquhhhzl
+```
+
+To print the account's mnemonic or the private key, run `oasis wallet export`:
+
+```
+$ oasis wallet export emerald_test
+WARNING: Exporting the account will expose secret key material!
+Unlock your account.
+? Passphrase: 
+Name:             eth_0
+Public Key:       A8JDpTiCnrq+zFUsAHrHY/xuFVsyt48sC1Srkp62r7Yx
+Ethereum address: 0xDCbF59bbcC0B297F1729adB23d7a5D721B481BA9
+Native address:   oasis1qq3agel5x07pxz08ns3d2y7sjrr3xf9paquhhhzl
+Export:
+0x0b5e6994430f9d3a5b6619b97e6af146b88f06457372764b36cdcff10c1c64f8
+```
+
+## Test wallets
+
+Oasis CLI comes with the following hardcoded testing accounts:
+
+- `test:alice`: Ed25519 test account by Oasis core tests
+- `test:bob`: Ed25519 test account by Oasis core tests
+- `test:charlie`: Secp256k1 test account
+- `test:cory`: Ed25519 account used by `oasis-net-runner`
+- `test:dave`: Secp256k1 test account
+- `test:erin`: Sr25519 test account
+- `test:frank`: Sr25519 test account
+
+Those accounts are often used for your Localnet development or when
+reporting bugs to oasis-core team for reproducibility. You can access the
+private key of a test account the same way as you would for ordinary accounts
+by running `oasis wallet export` command.
+
+[oasis-core]: https://github.com/oasisprotocol/oasis-core

docs/general/manage-tokens/holding-rose-tokens/ledger-wallet.md

@@ -158,4 +158,4 @@ Ledger is supported by the Oasis CLI. Follow the instructions in the
 [Nano S Plus]: https://support.ledger.com/hc/en-us/articles/4445777839901-Update-Ledger-Nano-S-Plus-firmware
 [BIP 39]: https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki
 [Oasis Wallets]: ../oasis-wallets/README.mdx
-[Oasis CLI Tools]: ../advanced/oasis-cli-tools/README.md
+[Oasis CLI Tools]: ../cli/README.md

docs/general/manage-tokens/how-to-transfer-rose-into-paratime.mdx

@@ -198,7 +198,7 @@ learn how to use Oasis CLI instead.
 
 :::
 
-[Oasis CLI]: advanced/oasis-cli-tools/deposit-withdraw-tokens-to-from-paratime.mdx
+[Oasis CLI]: cli/deposit-withdraw.mdx
 
 ### Verifying ParaTime deposits and withdrawals
 
@@ -233,5 +233,5 @@ addresses, Token Transfers, Contract Calls, etc.), you have to use the
     findSidebarItem('/dapp/emerald/writing-dapps-on-emerald'),
     findSidebarItem('/dapp/sapphire/quickstart'),
     findSidebarItem('/dapp/cipher/'),
-    findSidebarItem('/general/manage-tokens/advanced/oasis-cli-tools/deposit-withdraw-tokens-to-from-paratime')
+    findSidebarItem('/general/manage-tokens/cli/deposit-withdraw')
 ]} />

docs/node/run-your-node/paratime-node.mdx

@@ -179,7 +179,7 @@ No manual node registration is necessary.
 
 :::info
 
-ParaTime rewards for running the compute node will be sent to your entity address **inside the ParaTime**. To access the rewards on the consensus layer, you will need to withdraw them first. Read the [Deposit/Withdraw Tokens to/from ParaTime](../../general/manage-tokens/advanced/oasis-cli-tools/deposit-withdraw-tokens-to-from-paratime.mdx) chapter to learn more.
+ParaTime rewards for running the compute node will be sent to your entity address **inside the ParaTime**. To access the rewards on the consensus layer, you will need to withdraw them first. Read the [Deposit/Withdraw Tokens to/from ParaTime](../../general/manage-tokens/cli/deposit-withdraw.mdx) chapter to learn more.
 
 :::