Skip to content
A personal development blockchain based on Javascript that lives entirely on your local machine.
JavaScript Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
script
README.md
config.json
image.png
package.json
tezster-manager.js
tezster.js
tzaddr.PNG

README.md

Tezster

A personal development blockchain based on Javascript that lives entirely on your local machine. It will come as either a CLI with integrated GUI, has log output, and the ability to run transactions or deploy contracts against the local machine node or state of a live network such as the babylonnet, without spending any XTZ.

Getting started

Tezster comes in an npm package with a set of easy commands to kickstart the development or interaction with Tezos. The current version will install and start tezos node on your local machine.

Prerequisites

Latest version of Debian or Ubuntu. Windows users can run debian or ubuntu on

  1. Virtual machine (eg.- VirtualBox)
  2. VM instance on cloud (eg.- Google cloud platform or AWS)

Installing

download the npm package

sudo npm install -g tezster@latest

Once it is installed run

sudo tezster setup

This may take upto 30 mins depending upon the internet connection. It will download and install the Tezos blockchain. Once it's done, you will get appropriate message. You need to run setup only once. After that run,

sudo tezster start-nodes

It will activate Tezos alpha. Now you will have two nodes running successfully on port 18731 and 18732. To see the nodes running run following command as the root (super user)

sudo lsof -i :18731

To stop the nodes run

sudo tezster stop-nodes

To see generated accounts, run

tezster list-accounts

User can also activate and use an babylonnet faucet account with tezster to interact with babylonnet (test network of tezos) user has to download file from faucet : https://faucet.tzalpha.net/ After downloading from faucet you need to change the provider.

to check your current provider run

tezster get-provider

Change your provider to babylonnet by running

tezster set-provider https://tezos-dev.cryptonomic-infra.tech/

add-testnet-account <account-label> <absolute-path-to-json-file> - restores account from faucet json file
e.g. tezster add-testnet-account alpha4 /home/op/Downloads/tz1Umt3KQUwZYyjFjJrRXjp17qosuxAkmf3n.json

Any testnet faucet account requires activation before first use.

 activate-testnet-account <account-label>
e.g. tezster activate-testnet-account alpha4

After activating faucet you need to change the provider.

to check your current provider run

tezster get-provider

Change your provider to babylonnet by running

tezster set-provider https://tezos-dev.cryptonomic-infra.tech/

To transfer tezos from account to another, run (baking is required only in case of tx happening between localnode accounts)

sudo tezster transfer <amount> <from> <to> 
eg. - tezster transfer 10 bootstrap1 bootstrap2

then bake the transaction via,

sudo tezster bake-for bootstrap1 

To deploy a smart contract, put the michelson code in a file (eg.- testcontract.tz) Code eg.-

parameter string;
storage string;
code {CAR; NIL operation; PAIR;};

this stores any string to the storage

then run,

tezster deploy <contract label> <absolute path> <initial storage value> <account>

eg.- tezster deploy simplecontract /home/op/testcontract.tz "\"helloworld\"" bootstrap1

if this is successful, you'll receive a contract hash and a message asking you to bake the transaction (assuming you're on local node), then run

sudo tezster bake-for bootstrap1

To call the contract, run

tezster call <contract label> <argument value> <account>
eg.- tezster call simplecontract "\"goodmorning\"" bootstrap1

After calling, again bake the transaction in the same manner

sudo tezster bake-for bootstrap1

To see the current storage in a contract, run

tezster get-storage <contract-label/address>
eg.- tezster get-storage simplecontract

You can call this after each step when you deploy or call contract to see the updated storage. if you're on localhost, storage will change only after the deploy/call operation is baked by user manually. on testnet node, user may have to wait before operation is baked and included in a block.

To see what you can do with tezster, run

tezster --help

Extra

Coming soon.

keep developing

image

You can’t perform that action at this time.