Hello from Shell

Quickstart

First you will need to download Tupelo.

Unzip tupelo-v0.5.11.zip and from a terminal rename whichever version you need based on which OS you are running. Next, chmod it to make it executable.

mv tupelo-v0.5.11-darwin-amd64 tupelo
chmod +x tupelo

Next follow these steps from a command shell (stepping past OS publisher checks if they appear) to quickly write some data to a chain tree and read it back.

$ ./tupelo shell -w billfold
>>> create-wallet
>>> start-session
>>> create-key
>>> create-chain <key address>
>>> set-data <chain tree id> <key address> my/data/path "hello tupelo"
>>> resolve-data <chain tree id> my/data/path
>>> stop-session

Congratulations!
You have successfully written to a ChainTree and your request was verified by the Tupelo network.

Commentary

Read below if you’d like an explanation of what each of the above steps does.

1. Start the shell

   $ ./tupelo shell -w billfold
   

2. Create a new, password protected wallet (you only need to do this once)

   >>> create-wallet
   Creating wallet:  billfold
   Please enter a new passphrase:
   Please confirm your passphrase by entering it again:
   Thank you for confirming your password.
   

3. Start a new session

   >>> start-session
   Passphrase:
   Starting session
   

4. Generate a new key pair

   >>> create-key
   \<key address>
   

5. Create a new chain tree

   >>> create-chain <key address>
   chain-id: <chain tree id>
   

6. Write some data to the tree

   >>> set-data <chain tree id> <key address> my/data/path "hello tupelo"
   new tip: <tip hash>
   

7. Read the data back

   >>> resolve-data <chain tree id> my/data/path
   data: hello tupelo
   remaining path: []
   

The next step in getting to know the Tupelo DLT is to try our notebook tutorial.