Kumandra-Portal Introducation

💘 https://testnet.kumandra.org/

Kumandra/Substrate UI for interacting with Kumandra node.

Here is the source code of our blockchain explorer, which is forked from polkadot/apps, and currently supports http and wss access methods.

About The Kumandra

Kumandra is a decentralized cloud data storage network, mainly focus on providing storage solution for Selendra.

Features

• Brand new UI style.
• Visually display the storage data on the Kumandra network through graphs.
• The Kumandra network supports miners to provide storage to obtain incentives.
• We can see the overview of storage miners on miner page.
• Customized search bar, support keyword search such as block hash, extrinsics hash, miner ID, account address.
• Shows the detailed information of each extrinsic.
• Display the basic information of the miner, such as controller address, beneficiary address, provided storage, total reward, and received reward.
• List specific miner-related extrinsic information.
• We have designed a separate display page for each account, which includes information such as the account address, related extrinsics, the amount of stored data, and the data list.

overview

The repo is split into a number of packages, each representing an application. These are -

• apps This is the main entry point. It handles the selection sidebar and routing to the specific application being displayed.
• apps-electron Desktop app running apps.
• page-accounts A basic account management app.
• page-address-book A basic address management app.
• page-democracy A basic voting app, allowing votes on activate proposals and referenda.
• page-explorer A simple block explorer. It only shows the most recent blocks, updating as they become available.
• page-extrinsics Submission of extrinsics to a node.
• page-js An online code editor with @polkadot-js/api access to the currently connected node.
• page-settings A basic settings management app, allowing choice of language, node to connect to, and theme
• page-staking A basic staking management app, allowing staking and nominations.
• page-storage A simple node storage query application. Multiple queries can be queued and updates as new values become available.
• page-toolbox Submission of raw data to RPC endpoints and utility hashing functions.
• page-transfer A basic account management app, allowing transfer of Units/DOTs between accounts.

In addition the following libraries are also included in the repo. These are to be moved to the @polkadot/ui repository once it reaches a base level of stability and usability. (At this point with the framework being tested on the apps above, it makes development easier having it close)

• react-components A reactive (using RxJS) application framework with a number of useful shared components.
• react-signer Signer implementation for apps.
• react-query Base components that use the RxJS Observable APIs

Technology stack

• nodejs >=10.13.0

• yarn >=1.10.1

• react >=17.0.2

• typescript >=4.4.4

• echarts >=3.10.5

• polkadot >=6.12.11

• electron >=5.17.3

• webpack >=16.5.1

• docker >=7.4.3

Development

To start off, this repo uses yarn workspaces to organize the code. As such, after cloning dependencies should be installed via yarn, not via npm, the latter will result in broken dependencies.

To get started -

1. Clone the repo locally, via:

   $ git clone https://github.com/kumandra/kumandra-portal.git

2. Ensure that you have a recent LTS version of Node.js, for development purposes Node >=10.13.0 is recommended.

3. Ensure that you have a recent version of Yarn, for development purposes Yarn >=1.10.1 is required.

4. Install the dependencies by running yarn:

   $ yarn install

5. Ready! Now you can launch the UI (assuming you have a local Polkadot Node running), via

   $ yarn run start

6. Access the UI via http://localhost:3000

Build & Deploy

1. Install the dependencies by running yarn:

   $ yarn install

2. Run build

   $ yarn run build:code:win # the dist files in /packages/apps/build

Run with Docker

1. pull the image with docker:

   $ docker pull kumandra/kumandra-portal-explorer

2. Run docker

   $ docker run -d --restart unless-stopped --name kumandra-ui -p 3000:80 kumandra/kumandra-portal-explorer

3. View it on your browser using localhost:80

Browsers support

Modern browsers.

IE / Edge	Firefox	Chrome	Safari	Opera
IE11, Edge	last 2 versions	last 2 versions	last 2 versions	last 2 versions

We very much welcome your contribution

• Use Kumandra-Portal in your daily work.
• Submit GitHub issues to report bugs or ask questions.
• Propose Pull Request to improve our code.