amdev9 / dapp-browser

Electron.js desktop application that helps to securely run decentralized web applications with the ability to use the API to access a secure blockchain wallet, a distributed IPFS network and blockchain connectors

Demo

Documentation

Details of architecture described in Readme https://github.com/cypherpunk99/dapp-browser/tree/develop/docs/README.md

Deploy instruction

For Linux enable sandbox (change value from 0 to 1): /proc/sys/kernel/unprivileged_userns_clone

Development setup:

git clone https://github.com/cypherpunk99/dapp-browser && cd dapp-browser
npm install
npm run setup

Spawn new shell & wait for build process finish:

npm run dev

Run tests:

npm run test-main

Build application for Linux/macOS

npm install
npm run build

and get executable file from ./electron/main/release folder.

Build for Windows:

Requirements:

1. Python 2.7
2. NodeJS v.11 or higher version
3. Visual Studio 2015
4. npm install --global windows-build-tools

Run build process and get '.exe' file from ./electron/main/release folder.

npm install
npm run build

How to upload dapp into IPFS

• Download go-ipfs client
• Upload Dapp folder.

You can upload Dapp folder with native ipfs client by command:

ipfs add -r <dapp-folder>

To keep the files online and avoid them to be garbage collected, just use the pin command and they will remain online as long as your ipfs daemon is running.

ipfs pin add -r <dapp-folder-ipfs-hash>

• Copy IPFS hash (Dapp list located in main/modules/AppsManager/component->AppsProvider)
• If you create new Dapp in development mode, please change path to yours Dapps folder in main/modules/AppsManager/component:112 parseDapps method (ex. constants.DAPPS_PATH)