Fix space-cli & update docs

Author: buffrr

SUBSPACES.md

@@ -14,14 +14,40 @@ $ space-cli operate @bitcoin
 
 Use [subs](https://github.com/spacesprotocol/subs) to issue subspaces off-chain and create commitments.
 
+
+An **end-user** can generate a key pair like this:
+
+```
+$ subs request alice@bitcoin
+✔ Created handle request
+   → [email protected]
+   → Private key saved: [email protected]
+```
+
+An **operator** such as @bitcoin, can accept requests into their tree:
+
+```
+$ subs add [email protected]
+```
+
+
+For this example, we will commit just one handle, but it's more efficient to add a large batch of handles before making a commitment.
+
+```
+$ subs commit
+✔ Committed batch
+   → Tree root: 79d39952ac5a8d6daedd48e59c0a58d12d10644c09f2fa3c70e9fe76e72f866a
+```
+
+
 ### 3. Submit Commitments
 
-Submit a commitment for your space with a Merkle root. Each commitment is cryptographically bound to all previous commitments.
+After your tree is updated, commit it's root hash. Each commitment is cryptographically bound to all previous commitments you made on-chain.
 
-**Example:** To submit a commitment for `@bitcoin` with root hash `85d3a410db41b317b7c0310df64cefb6504482c0b5c7e8a36c992ed0dfdb38af`:
+**Example:** To submit a commitment for `@bitcoin` with root hash `79d39952ac5a8d6daedd48e59c0a58d12d10644c09f2fa3c70e9fe76e72f866a`:
 
 ```bash
-$ space-cli commit @bitcoin 85d3a410db41b317b7c0310df64cefb6504482c0b5c7e8a36c992ed0dfdb38af
+$ space-cli commit @bitcoin 79d39952ac5a8d6daedd48e59c0a58d12d10644c09f2fa3c70e9fe76e72f866a
 ```
 
 **Retrieve commitments** for a space:
@@ -30,6 +56,7 @@ $ space-cli commit @bitcoin 85d3a410db41b317b7c0310df64cefb6504482c0b5c7e8a36c99
 $ space-cli getcommitment @bitcoin
 ```
 
+
 ### Delegating Operational Control
 
 You can authorize another party to make commitments on your behalf:

client/src/bin/space-cli.rs

@@ -1144,18 +1144,18 @@ async fn handle_commands(cli: &SpaceCli, command: Commands) -> Result<(), Client
                 false,
             )
                 .await?;
-
+            let addr = SpaceAddress::from_str(&sptr_addr).expect("valid");
             println!("Creating UTXO for sptr {}", sptr);
             cli.send_request(
                 Some(RpcWalletRequest::CreatePtr(CreatePtrParams {
-                    address: sptr_addr,
+                    address: addr.0.to_string(),
                 })),
                 None,
                 fee_rate,
                 false,
             )
                 .await?;
-            println!("Space should be operational was txs are confirmed");
+            println!("Space should be operational once txs are confirmed");
         }
         Commands::Commit { space, root, fee_rate } => {
             let space_info = match cli.client.get_space(&space).await? {

ptr/src/sptr.rs

@@ -11,10 +11,6 @@ impl KeyHash for Sptr {}
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
 pub struct Sptr(pub(crate) [u8; 32]);
 
-// COMMITMENT_KEY
-// SPTR_KEY
-// SPACE_KEY
-
 impl Sptr {
     #[inline]
     pub fn as_slice(&self) -> &[u8] { &self.0 }