Tonomy-ID-integration

Developer environment to run Tonomy ID locally alongside a blockchain node, and the demo app.

All developers contributing to the project should check Contributors Guide and first check the Troubleshoot Guide if you have issues installing or running.

Try it out here

See ./staging

• Demo: https://demo.staging.tonomy.foundation
• Accounts website: https://accounts.staging.tonomy.foundation
• Block explorer: https://local.bloks.io/?nodeUrl=https%3A%2F%2Fblockchain-api-staging.tonomy.foundation&systemDomain=eosio
• Blockchain API: https://blockchain-api-staging.tonomy.foundation
• Communication Service: https://communication.staging.tonomy.foundation
• Docs: https://docs.staging.tonomy.foundation
• Tonomy ID:
  • Play store: https://play.google.com/store/apps/details?id=foundation.tonomy.projects.tonomyidstaging
  • iTunes store: https://apps.apple.com/us/app/tonomy-id-demo/id1663471436
• Testers issue reporting sheet: https://tonomy-foundation.notion.site/Tonomy-ID-Testing-Procedure-4a084f9e43df413695425289ca017446?pvs=4

Testnet environment

See ./testnet

• Demo: https://demo.testnet.pangea.web4.world
• Accounts website: https://accounts.testnet.pangea.web4.world
• Block explorer: https://local.bloks.io/?nodeUrl=https%3A%2F%2Fblockchain-api-testnet.pangea.web4.world&systemDomain=eosio
• Blockchain API: https://blockchain-api-testnet.pangea.web4.world
• Communication Service: https://communication.testnet.pangea.web4.world
• Docs: https://docs.testnet.pangea.web4.world
• Pangea Passport - Testnet:
  • Play store: https://play.google.com/store/apps/details?id=foundation.tonomy.projects.pangeapassporttestnet
  • iTunes store: https://apps.apple.com/us/app/pangea.web4.world/id1663471436
    • TestFlight: TODO

Production environment

• Demo: https://demo.pangea.web4.world
• Accounts website: https://accounts.pangea.web4.world
• Block explorer: https://local.bloks.io/?nodeUrl=https%3A%2F%2Fblockchain-api.pangea.web4.world&systemDomain=eosio
• Blockchain API: https://blockchain-api.pangea.web4.world
• Communication Service: https://communication.pangea.web4.world
• Docs: https://docs.pangea.web4.world
• Tonomy ID:
  • Play store: https://play.google.com/store/apps/details?id=foundation.tonomy.projects.pangeapassport
  • iTunes store: https://apps.apple.com/us/app/pangea.web4.world/id1663471436

Repositories

• Tonomy ID - Our expo (React Native) cross-platform mobile wallet for public & private Antelope blockchains.
  • Directory Structure
• SDK - typescript library used in Tonomy ID to interact and call with the Antelope blockchain and services.
  • Contracts (inside SDK repo) - Antelope smart contracts to run the governance, identity, DAO, token and other ecosystem tools.
  • Microservice (inside SDK repo) - nextjs peer to peer message broker for communication between different identities.
• Testnet - A reactjs application to facilitate the SSO login with Tonomy ID to web apps
• Mainnet - A reactjs application to facilitate the SSO login with Tonomy ID to web apps
• SSO Login - A reactjs application to show demo flows with Tonomy ID and Tonomy ID SSO

Environment compatibility

• Linux debian distribution (Ubuntu 20.0.4 LTS used)

Hardware suggestions:

• 2 Gb RAM minimum
• 2 core minimum

Dependencies

In case you have problems here is a list of the dependencies

• Docker v20.10+
• Docker Compose v1.29+
• npm with corepack enabled v18.12.1. Suggested to install with nvm v0.35+
• pm2 v5.5+ installed globally by npm
• mkdocs with material theme

Check out the file ./scripts/install_prerequisits.sh. This can be used as a guide to install all dependencies on an Ubuntu 18+ machine. Run the script line-by-line, as sometimes you need to exit terminal or restart your machine to continue.

Pre-run (one time)

In the Tonomy-ID repository you need to set up the expo build and install it on your phone. See instructions here

https://github.com/Tonomy-Foundation/Tonomy-ID/tree/development#pre-run-build-first-time-and-each-time-new-rn-only-packages-are-installed

Run

Follow these steps one by one & read them carefully. Do not rush through it.

• Clone the repo
• git checkout development
• ./app.sh and read what each command does
• ./app.sh gitinit
• ./app.sh install
• ./app.sh init
• Now, you can do one of the following;
• ./app.sh start
  • Open the installed Tonomy ID app downloaded from https://expo.dev (See #pre-run-one-time)
  • Check out the links shown
• ./app.sh log antelope
• ./app.sh stop or ./app.sh reset or ./app.sh reset all

See TROUBLESHOOT.md to fix common issues when running the app.

Environment variables

To run in staging or testnet or mainnet, use:

export NODE_ENV=staging
#or
export NODE_ENV=testnet
#or 
export NODE_ENV=production
#then
./app.sh start

To show logs within the SDK, use

export LOG=true

Staging server

See ./staging/staging.sh

Testnet server

See ./testnet/testnet.sh

Mainnet server

See ./mainnet/mainnet.sh