Home

Awesome

Tezori v2 (DEPRECATED!)

Deprecation

This repository is now deprecated! The successor repo is located at https://github.com/Cryptonomic/Galleon.

Introducton

A wallet for the Tezos blockchain based on ConseilJS. T2 is a rewrite of the original Tezori codebase into Typescript. Along the way we re-architected to code to make it more resilient and extensible. The wallet uses ConseilJS to interact with the Tezos blockchain for operation submission and with the Conseil indexer for fast aggregated data, like the full list of transactions for an account, or the collection of contracts a given account has deployed. ConseilJS also provides a software signer and a Ledger device interface for increased security.

This product was written for the community – fork it, hack it, use it as you please!

Build Status Coverage Status

Development

Building

The wallet is built with Typescript, React and Electron. Cryptonomic offers a deployment of Tezori called Galleon.

To build your own package add the environment configuration file as src/extraResources/walletSettings.json. Cryptonomic uses the Nautilus Cloud infrastructure of Tezos and Conseil indexer nodes for production deployments.

Note the version of nodejs specified in the outer package file, at the time of writing it was 12.21.0. We recommend using nvm.

{
  "selectedNode": "MyTezosNode",
  "nodesList": [
    {
      "displayName": "MyTezosNode",
      "platform": "TEZOS",
      "network": "MyNetwork",
      "tezosUrl": "https://mytezosnode.com",
      "conseilUrl": "https://myconseilnode.com",
      "apiKey": "anapikey"
    }
  ],
  "selectedPath": "Default",
  "pathsList": [
    {
      "label": "Default",
      "derivation": "44'/1729'/0'/0'/0'"
    }
  ]
}

To install all dependencies:

npm i

To run during development:

npm run dev

To package for deployment for the local target:

npm run package

A complete script might look like this:

nvm use 12.21.0

mkdir ./t2
cd t2

git clone https://github.com/Cryptonomic/T2.git .
npm i
npm run dev

Customization Options

Several branding features can be applied in src/config.json, including name, logo and block explorer link.

Contributing

We welcome all contributions, be it issue reports, feature suggestions, language files or pull requests. When submitting a PR expect the code to undergo a detailed review prior to any potential inclusion.

Support

Cryptonomic hosts a developer support channel on Element. Cryptonomic and several of its employees are active on Reddit and Twitter.

ConseilJS documentation and Conseil documentation is quite through as well.

Architecture Overview

This section may be occasionally outdated as the codebase evolves.

One of the goals for the T2 rewrite of Tezori was to organize the code in a clearer way. Here's an outline of the directory structure.

The main application entry point is app.html.

Known Issues

There are several opportunities for improvement that we're tackling during the normal process of adding new functionality to the application. There include, but are not limited to:

There are TODO items sprinkled around the code and of course the formal list of issues.