midenup 0.3.0

The Miden toolchain manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# Tutorial

A typical usage of midenup and miden might look like the following:

1. midenup has been downloaded and correctly configured following the instructions of the [Installation](installation.md) page or [README](https://github.com/0xMiden/midenup)
2. The latest stable toolchain can then be installed:

   ```shell title=">_ Terminal"
   midenup install stable
   ```

3. With the toolchain now installed, the installed components can be inspected with the following command:

   ```shell title=">_ Terminal"
   miden help toolchain
   ```

4. To start, create a new miden project:
   ```shell title=">_ Terminal"
   miden new miden_project && cd miden_project
   ```

5. If said project requires a specific toolchain version, for instance 0.17.0, then it can be set with the following command:
   ```shell title=">_ Terminal"
   midenup set 0.17.0
   ```
   Note that if the toolchain is not already installed, midenup/miden will automatically install it as soon as it detects that it is required.

6. With the project now generated and the required toolchain established, the `src/lib.rs` can be modified with any desired additions. Afterwards, a build can be issued:
   ```shell title=">_ Terminal"
   miden build
   ```
   Once compilation finishes, a message displaying the location of the generated Miden Package will be shown.

7. With the generated Miden Package, an account can be created and deployed with the following command:
   ```shell title=">_ Terminal"
   miden client new-account --account-type regular-account-updatable-code -p /path/to/package.masp
   ```