w3f-grants-archive/apps

wallet & governance dashboard for Polkadot & substrate-based networks in VueJS

⚠️ Archived

This repository has been archived and we've moved on the new avenue being NFT explorer

https://github.com/kodadot/nft-gallery

📱 Apps

Apps are core components of KodaDot wallet.

Basic usage is to interact from browser with Polkadot and Substrate based networks.

🐦 Follow us on Twitter @KodaDot

▶️ Demo versions

• 👩‍✈️Stable release - could be used for production
• 🚧👷‍♀️ Development preview release - may not work everytime

🕹 Play

git clone [email protected]:vue-polkadot/apps.git
cd dashboard
yarn
yarn serve

Now, access apps in your browser at http://127.0.0.1:9090/. You can also open the URL in your browser from another terminal session like this.

open http://localhost:9090/

🏦 Stage One

• Accounts - It offers basic management functionality to work with Accounts
• Address book - It offers basic management functionality to work with Addresses
• Democracy - It offers basic voting app, allowing votes on activate proposals and referenda.
• Extrinsics - Extrinsics page is enviroment where user is able to execute every available transaction on the selected node.
• Transfer - Transfer function is abstraction on top of extrinsics for transfering various assets of network.
• Settings - It provide seamless integration of vue-settings and vue-api inside Vuex, allowing choice of language, node to connect to, and theme.

🏯 Stage Two

• Explorer - Explore chain name, best block, finalized blocks, total isuance, number of validators, state of epoch & era, deep dive in too finalized blocks, see hash of parent block, extrinsics and state. Next to it explore events happening in extrinsics, i.e. treasury deposit, balance transfers, council votes, democracy events and various governance drive
• ChainState - Storage - Find out what's in Storage of chain, what are constants and raw inputs. Simple node query application, multiple queries can be queued and updates as new values become available
• ToolBox - Utility hashing functions like Sign, Verify with accounts and hash data.
• RPC - Submission of raw data to RPC endpoints
• Treasury - Vote on proposals and send tips
• 🏗 Staking - Staking managment, you can stake and nominate

🏗 Development

Contribution is welcome!

We are using yarn workspace, as installing things via npm will result in broken dependencies.

👷‍♀️ Get Started

1. Clone the repo git clone [email protected]:vue-polkadot/apps.git <optional local path>
2. Ensure that you have a recent LTS version of Node.js, we are using in time of writing version v12.16.0
3. Recent version of Yarn, we are now using 1.22.4
4. Install the dependencies by running yarn
5. Now you can launch the UI. You can have local running Substrate node or connect to existing networks
6. Access the UI at http://localhost:8080/

🙋‍♀️ I want to contribute

Sure, your contribution is welcome. Please follow code of conduct and contribution guidelines

🐳 Docker

If you want just to try out our KodaDot on Kusama and have full local setup with local node, we assume you have docker and docker-compose installed. We have are building images from develop and master branch

You need to make yourself be in /dashboard directory first

docker-compose pull && docker-compose up

If you want to run just KodaDot

docker-compose up kodadot

Build docker image of KodaDot

docker build -t hello/kodadot .

Run it locally and then visit localhost:8080

docker run -it -p 8080:8080 --rm --name hellokodadot hello/kodadot