docs: Onchain notes tutorial

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+## 0.3.0 (TBD)
+
 ## 0.2.1 (2024-04-12)
 
 * [BREAKING] Return a reference to `NoteMetadata` from output notes (#593).

docs/introduction/get-started/p2p-private-offchain-txs.md

@@ -32,7 +32,7 @@ In this section, we show you how to make off-chain transactions and send funds t
     To do this, run:
 
     ```shell
-    miden-client tx new p2id <regular-account-id-A> <regular-account-id-B> <faucet-account-id> 50
+    miden-client tx new p2id <regular-account-id-A> <regular-account-id-B> <faucet-account-id> 50 --note-type private
     ```
 
     !!! note
@@ -55,7 +55,7 @@ In this section, we show you how to make off-chain transactions and send funds t
 4. Have the second account consume the note.
 
     ```sh
-    miden-client tx new consume-notes <regular-account-ID-B> <input-note-id> 
+    miden-client tx new consume-notes <regular-account-ID-B> <input-note-id>
     ```
 
     !!! tip
@@ -97,4 +97,3 @@ You have successfully configured and used the Miden client to interact with a Mi
 You have performed basic Miden rollup operations like sending transactions, generating and consuming notes.
 
 For more information on the Miden client, refer to the [Miden client documentation](https://docs.polygon.technology/miden/miden-client/).
-

docs/introduction/get-started/p2p-public-note-txs.md

@@ -0,0 +1,68 @@
+In this section, we show you how to execute transactions and send funds to another account using the Miden client through public notes. 
+
+!!! important "Prerequisite steps"
+    - You should have already followed all previous sections.
+    - You should have *not* reset the state of your local client. 
+
+## Create a second client
+
+!!! tip
+      Remember to use the [Miden client documentation](https://docs.polygon.technology/miden/miden-client/cli-reference/) for clarifications.
+
+This is an alternative to the private offchain P2P transactions article. For this tutorial, we will utilize two different clients to simulate two different remote users who don't share local state. To do this, we can have two terminals with their own state (using their own `miden-client.toml`). One terminal can run the client from the previous article, and a new terminal can run a new client.
+
+1. On the new client, let's create a new basic account:
+
+      ```shell
+      miden-client account new basic-immutable
+      ```
+
+2. List and view the accounts with the following command:
+
+      ```shell
+      miden-client account -l
+      ```
+
+## Transfer assets between accounts
+
+1. Now we can transfer some of the tokens we received from the faucet to our new account B. 
+
+    To do this, from the first client run:
+
+    ```shell
+    miden-client tx new p2id <regular-account-id-A> <regular-account-id-B> <faucet-account-id> 50 --note-type public
+    ```
+
+    !!! note
+        The faucet account id can be found on the [Miden faucet website](https://ethdenver.polygonmiden.io/) under the title **Miden faucet**.
+
+    This generates a Pay-to-ID (`P2ID`) note containing `<amount>` assets, transferred from one account to the other. As the note is public, the second account can receive the necessary details by syncing with the node.
+
+2. First, sync the account on the new client.
+
+    ```shell
+    miden-client sync # Make sure we have an updated view of the state
+    ```
+
+3. At this point, we should have received the public note details.
+
+    ```sh
+    miden-client input-notes list 
+    ```
+
+4. Have the second account consume the note.
+
+    ```sh
+    miden-client tx new consume-notes <regular-account-ID-B> <input-note-id> 
+    ```
+
+    !!! tip
+        It's possible to use a short version of the note id: 7 characters after the `0x` is sufficient.
+
+That's it! 
+
+The second account will have now consumed the note and should have new assets in the account:
+
+```sh
+miden-client account show <account-ID> -v
+```

miden-lib/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "miden-lib"
-version = "0.2.1"
+version = "0.3.0"
 description = "Standard library of the Miden rollup"
 readme = "README.md"
 categories = ["no-std"]
@@ -30,11 +30,11 @@ std = [
 testing = ["miden-objects/testing"]
 
 [dependencies]
-miden-objects = { package = "miden-objects", path = "../objects", version = "0.2", default-features = false }
+miden-objects = { package = "miden-objects", path = "../objects", version = "0.3", default-features = false }
 miden-stdlib = { workspace = true }
 
 [dev-dependencies]
-miden-objects = { package = "miden-objects", path = "../objects", version = "0.2", default-features = false, features = [
+miden-objects = { package = "miden-objects", path = "../objects", version = "0.3", default-features = false, features = [
     "testing",
 ] }
 mock = { package = "miden-mock", path = "../mock", default-features = false }

miden-tx/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "miden-tx"
-version = "0.2.1"
+version = "0.3.0"
 description = "Miden rollup transaction compiler, executor, and prover"
 readme = "README.md"
 categories = ["no-std"]
@@ -22,8 +22,8 @@ default = ["std"]
 std = ["miden-lib/std", "miden-objects/std", "miden-prover/std", "miden-verifier/std", "vm-processor/std"]
 
 [dependencies]
-miden-lib = { package = "miden-lib", path = "../miden-lib", version = "0.2", default-features = false }
-miden-objects = { package = "miden-objects", path = "../objects", version = "0.2", default-features = false }
+miden-lib = { package = "miden-lib", path = "../miden-lib", version = "0.3", default-features = false }
+miden-objects = { package = "miden-objects", path = "../objects", version = "0.3", default-features = false }
 miden-prover = { workspace = true }
 miden-verifier = { workspace = true }
 vm-processor = { workspace = true }

mock/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "miden-mock"
-version = "0.2.0"
+version = "0.3.0"
 description = "Library for mocking and testing core Miden rollup components"
 readme = "README.md"
 keywords = ["miden", "mock"]
@@ -28,8 +28,8 @@ std = ["miden-lib/std", "miden-objects/std"]
 clap = { version = "4.4", features = ["derive"], optional = true }
 env_logger = { version = "0.11" }
 hex = { version = "0.4" }
-miden-lib = { path = "../miden-lib", version = "0.2" }
-miden-objects = { path = "../objects", version = "0.2", features = [
+miden-lib = { path = "../miden-lib", version = "0.3" }
+miden-objects = { path = "../objects", version = "0.3", features = [
     "log",
     "serde",
     "testing",

objects/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "miden-objects"
-version = "0.2.1"
+version = "0.3.0"
 description = "Core components of the Miden rollup"
 readme = "README.md"
 categories = ["no-std"]