You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The `indy-cli` is developed under the [indy-sdk](https://github.com/hyperledger/indy-sdk). This documentation may be not up to date.
3
+
The `indy-cli` is developed under the [indy-cli-rs](https://github.com/hyperledger/indy-cli-rs). This documentation may be not up to date.
4
4
5
-
>As stated in [Installation and configuration of Indy-Node](../installation-and-configuration.md)`indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6
-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
7
5
8
6
You will need to perform the following once for each `indy-cli` machine you would like to set up (only 1 is required).
9
7
It is recommended that you install the `indy-cli` in your native work environment if possible, so you always have it available even when traveling.
10
8
11
9
## Installing `indy-cli-rs`
12
-
To install `indy-cli-rs` simply donwload the latest release from its release pages and unpack it.
10
+
To install `indy-cli-rs` simply download the latest release from its release pages and unpack it.
13
11
14
12
## Containerized `indy-cli` Environment
15
13
16
14
The following sections describe how to install and configure the `indy-cli` directly on a machine or VM. However, possibly the most convenient option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
17
-
18
-
## Windows:
19
-
To install the `indy-cli` on Windows 10 perform the following steps:
20
-
1. Download https://repo.sovrin.org/windows/indy-cli/stable/1.16.0/indy-cli_1.16.0.zip and unzip it.
21
-
If there is a newer version under https://repo.sovrin.org/windows/indy-cli/stable/ it instead.
22
-
2. Open a command prompt. (This will work differently if you use Windows Terminal).
23
-
3.`cd` to the directory where you unzipped the `indy-cli` package. For example, if you unzipped directly in your ‘downloads’ directory like I did you would type: `cd \Users\<Username>\Downloads\indy-cli_1.14.2`
24
-
4. Create a JSON Config file containing your taaAcceptanceMechanism in the directory where indy-cli.exe resides (I created \Users\<Username>\Downloads\indy-cli_1.14.2\cliconfig.json on my machine)
25
-
```json
26
-
{
27
-
"taaAcceptanceMechanism": "for_session"
28
-
}
29
-
```
30
-
5. Run `indy-cli.exe --config cliconfig.json` to verify proper installation. You should see a new window appear with an `indy>` prompt, (If you are double clicking to start `indy-cli`, you need to right click on the .exe in your window and add the --config parameter first.) If you get an error stating that it is missing vcruntime140.dll then do the following:
31
-
6. Download and install vc_redist.x64.exe from the Visual Studio 2017 section on the https://support.microsoft.com/en-ae/help/2977003/the-latest-supported-visual-c-downloads page, and then rerun indy-cli.exe to see if it works as described in previous step.
32
-
7. Type ‘exit’ in the `indy-cli`
33
-
34
-
## Ubuntu:
35
-
To install the `indy-cli` on Ubuntu, perform the following steps from the ubuntu command line:
8. Create a JSON Config file containing your taaAcceptanceMechanism in your home directory:
45
-
`vim ~/cliconfig.json`
46
-
47
-
Press the “i” key and paste the following into the file:
48
-
```json
49
-
{
50
-
"taaAcceptanceMechanism": "for_session"
51
-
}
52
-
```
53
-
Press the “esc” key then the following characters to write the file and quit
54
-
`:wq`
55
-
9. Run `indy-cli --config ~/cliconfig.json` to start the `indy-cli`
56
-
57
-
## Mac:
58
-
59
-
Since there is not a prepackaged version of the `indy-cli` prepared for the Mac, the following steps will help you to create an environment, build, and run the `indy-cli` in a Mac terminal.
60
-
61
-
Open a Terminal
62
-
Run the following commands in the terminal:
63
-
64
-
1.`cd ~`
65
-
2.`mkdir github`
66
-
3.`cd github`
67
-
4.`git clone https://github.com/hyperledger/indy-sdk.git`(might need xcode-select --install if error occurs)
11. Run the following commands from your terminal to build the `indy-cli`:
91
-
```
92
-
source ~/.profile
93
-
cd ~/github/indy-sdk/libindy
94
-
cargo build
95
-
cd ../cli
96
-
cargo build
97
-
```
98
-
12. Create a JSON Config file containing your taaAcceptanceMechanism in your home directory:
99
-
`vim ~/cliconfig.json`
100
-
101
-
Press the “i” key and paste the following into the file:
102
-
```json
103
-
{
104
-
"taaAcceptanceMechanism": "for_session"
105
-
}
106
-
```
107
-
Press the “esc” key then the following characters to write the file and quit
108
-
`:wq`
109
-
13. You can now run `indy-cli` from within a terminal by typing
110
-
111
-
`indy-cli --config ~/cliconfig.json`
112
-
113
-
`indy> exit` (To exit from the `indy-cli` prompt when you ar done)
114
-
115
-
If the above gives error regarding library not loaded libssl.1.0.0, you will probably need to run the following command (all in one line should work) to revert your version:
Copy file name to clipboardExpand all lines: docs/source/NewNetwork/CreateDID.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,15 +2,13 @@
2
2
3
3
You will need to perform the following commands once for each `indy-cli` machine that you want to run on. The following commands contain suggestions to save certain values in a secure place. Please do not share those values or that place with anyone.
4
4
5
-
>As stated in [Installation and configuration of Indy-Node](../installation-and-configuration.md)`indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6
-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
7
5
8
-
_If you just need to quickly generate a set of secrets (Seed and wallet key), or a Seed, DID, and Verkey and do not have an `indy-cli` environment already setup, you can use the `indy-cli` features integrated into `von-network`. Refer to [Generate a set of Secrets](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-a-set-of-secrets), and [Generate your DID](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-your-did) for details._
6
+
_If you just need to quickly generate a set of secrets (Seed and wallet key), or a Seed, DID, and Verkey and do not have an `indy-cli-rs` environment already setup, you can use the `indy-cli` features integrated into `von-network`. Refer to [Generate a set of Secrets](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-a-set-of-secrets), and [Generate your DID](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-your-did) for details._
9
7
10
8
11
9
1. Start your `indy-cli` using the instructions from [Installing the `indy-cli`](./CLIInstall.md) for your platform.
12
10
13
-
All following commands are executing inside the `indy-cli`.
11
+
All following commands are executing inside the `indy-cli-rs`.
Copy file name to clipboardExpand all lines: docs/source/installation-and-configuration.md
+13-24Lines changed: 13 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,8 @@
1
1
# Installation and configuration of Indy-Node
2
2
3
3
## 1. Introduction
4
-
The purpose of this document is to describe how to setup a production level Indy-Validator-Node and register it on an existing network using an `indy-cli` machine which you also configure along the way.
5
-
>Alternativly you can use [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs), which is command for command compatible with the existing indy-cli (at least ATM).
6
-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
4
+
The purpose of this document is to describe how to setup a production level Indy-Validator-Node and register it on an existing network using an `indy-cli-rs` machine which you also configure along the way.
5
+
7
6
8
7
This documentation is based heavily on the [Sovrin Steward Validator Preparation Guide v3](https://docs.google.com/document/d/18MNB7nEKerlcyZKof5AvGMy0GP9T82c4SWaxZkPzya4).
9
8
@@ -38,7 +37,7 @@ As you proceed through these steps, you will be generating data that will be nee
38
37
- A cryptographic check against certain forgeries that can be done with BLS keys.
39
38
40
39
### 2.1 Two Machines
41
-
You’ll need two machines: one is your Validator node and the other an `indy-cli` machine to run the `indy-cli` with which you will interact with the ledger. They can be physical machines, virtual machines, or a combination. The machine with the `indy-cli` can be turned on and off at your convenience (refer to [3.1. `indy-cli` Machine Installation](##3.1.-indy-cli-Machine-Installation) for more details), only the Validator node needs to be public and constantly running.
40
+
You’ll need two machines: one is your Validator node and the other an `indy-cli` machine to run the `indy-cli-rs` with which you will interact with the ledger. They can be physical machines, virtual machines, or a combination. The machine with the `indy-cli` can be turned on and off at your convenience (refer to [3.1. `indy-cli` Machine Installation](##3.1.-indy-cli-Machine-Installation) for more details), only the Validator node needs to be public and constantly running.
42
41
43
42
>Important: for security reasons, you must not use your Validator node as an `indy-cli` client. If you do, it could expose your Steward credentials needlessly.
44
43
@@ -73,22 +72,12 @@ Your Validator node will need to have an alias. This will be used later when we
73
72
74
73
Some instructions must be executed on the Validator node, and others on the `indy-cli` machine. The command line prompts in the instructions will help remind you which machine should be used for each command.
75
74
76
-
### 3.1. `indy-cli` Machine Installation
77
-
78
-
The following instructions describe how to install and configure the `indy-cli` directly on a machine or VM. The other, possibly more convenient, option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
75
+
### 3.1. `indy-cli-rs` Machine Installation
79
76
80
-
#### 3.1.1. Install the `indy-cli`
81
-
On the machine you’ve chosen for the `indy-cli`, open a terminal and run the following lines to install the `indy-cli` package.
77
+
The following instructions describe how to install and configure the `indy-cli-rs` directly on a machine or VM. The other, possibly more convenient, option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
On the machine you’ve chosen for the `indy-cli-rs` simply donwload the latest release from its release pages and unpack it.
92
81
93
82
#### 3.1.2. Add an Acceptance Mechanism
94
83
To write to an Indy Node Ledger, you’ll need to sign the Transaction Author Agreement (TAA). You can learn more about the TAA [here](https://github.com/hyperledger/indy-sdk/blob/master/docs/how-tos/transaction-author-agreement.md). This agreement is incorporated into the process of connecting to the node pool and requires an acceptance mechanism. For the `indy-cli`, the default mechanism is “For Session” and the following instructions are required to be able to use “For Session” for your `indy-cli`:
@@ -103,12 +92,12 @@ This example cliconfig.json file contains the line that sets the AML:
103
92
```
104
93
105
94
To start the `indy-cli` using your new config file, run the following:
Now all of the appropriate transactions will have an “Agreement Accepted” authorization attached to them during this `indy-cli` session.
109
98
110
99
#### 3.1.3. Obtain the Genesis Files
111
-
Obtain the genesis transaction files for the Network with the following steps. For the sake of this documentation, we will use the genesis files from the Sovrin Networks. Information on how to create a genesis file can be found [here](./NewNetwork/NewNetwork.md). These files contain bootstrap information about some of the Validator nodes, which will be used by your `indy-cli` to connect to the networks.
100
+
Obtain the genesis transaction files for the Network with the following steps. For the sake of this documentation, we will use the genesis files from the Sovrin Networks. Information on how to create a genesis file can be found [here](./NewNetwork/NewNetwork.md). These files contain bootstrap information about some of the Validator nodes, which will be used by your `indy-cli-rs` to connect to the networks.
Keep this seed in a safe place, such as an encrypted password manager or other secure location designated by your organization. You will need it later in this guide, as well as in the future for other Steward interactions with the ledger.
In the command line, enter the following to create your pool configuration and your wallet locally. In these instructions, we use "buildernet" for the pool name and "buildernet_wallet" for the wallet name, although you may use other names of your choosing, if desired. The encrypted wallet will be used to store important information on this machine, such as your public and private keys. When creating your wallet, you will need to provide a "key" that is any string desired. It will be the encryption key of your local wallet.
160
149
@@ -351,10 +340,10 @@ dpkg -l | grep indy
351
340
```
352
341
353
342
##### Add Validator Node to Ledger
354
-
On your `indy-cli` machine, if you are not still on the `indy-cli` prompt, you will need to return to it. To get back to where you were, type `indy-cli --config <path_to_cfg>/cliconfig.json`, connect to the network pool, designate the wallet to use (using the same wallet key as before), and enter the DID that was returned earlier, when you typed `did new seed` (then enter your seed) for your Steward user:
343
+
On your `indy-cli` machine, if you are not still on the `indy-cli-rs` prompt, you will need to return to it. To get back to where you were, type `indy-cli --config <path_to_cfg>/cliconfig.json`, connect to the network pool, designate the wallet to use (using the same wallet key as before), and enter the DID that was returned earlier, when you typed `did new seed` (then enter your seed) for your Steward user:
Copy file name to clipboardExpand all lines: sample/Network/README.md
+1-3Lines changed: 1 addition & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,10 @@
2
2
3
3
This walkthrough goes through some of the detailed steps mentioned in [Setting up a New Network](../../docs/source/NewNetwork/NewNetwork.md)
4
4
5
-
>As stated in [Installation and configuration of Indy-Node](../../docs/source/installation-and-configuration.md)`indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6
-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
7
5
8
6
For the sake of simplicity this walkthrough runs all of the nodes on the local machine. As a result it uses the local python install version of some of the commands rather than the production level Debian package install version of the commands documented in the [Setting up a New Network](../../docs/source/NewNetwork/NewNetwork.md) guide.
0 commit comments