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.
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.
Latest version of Debian or Ubuntu. Windows users can run debian or ubuntu on
- Virtual machine (eg.- VirtualBox)
- VM instance on cloud (eg.- Google cloud platform or AWS)
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
Coming soon.
keep developing
