Datt is a node.js and web browser app for decentralized content sharing with integrated payments. It is currently undergoing heavy development and has not yet reached alpha. Our issues are tracked on GitHub. Check out the blog or twitter to stay up-to-date on progress.
Datt can be built and run on Linux. It is not tested on Mac or Windows, but should work with minimal or no changes on those platforms. To help program the Datt application, first be sure you are running node 4.2:
> node --version
v4.2.1
Then clone this repo:
git clone https://github.com/dattnetwork/datt.git
Then install the dependencies:
cd datt
npm install
To run all of Datt tests:
npm test
You may wish to run the node tests while you edit files:
npm run watch-test-node
...then save a file and the tests will run.
To run the server and use the app:
npm run serve-testnet
This will serve the files, run the PeerJS rendezvous server, and run a browser-sync proxy server that will automatically refresh your browser when the files change. (If for some reason you wish to run in dangerous mainnet mode instead, replace 'testnet' for 'mainnet' above). You can then access the tests at:
http://localhost:3040/tests.html
Or access the app itself at:
http://localhost:3040/
The app makes use of IndexedDB and Web RTC in a browser. Each "domain" has its own IndexedDB and p2p connections. This means if you run the app on a different port, it's as though you're running the app as a different person from a different computer. This makes it easy to test the p2p properties of Datt if you simply deliver the same app from different ports. To facilitate this, the ports 3040 - 3044 are all assigned to simply deliver the app. So feel free to open up these other ports to see the same app but with a different user, content, and p2p connections:
http://localhost:3040/
http://localhost:3041/
http://localhost:3042/
http://localhost:3043/
http://localhost:3044/
To run in testnet mode:
FULLNODE_NETWORK=testnet DATT_BLOCKCHAIN_API_URI=https://test-insight.bitpay.com/api/ npm run serve
This repo contains both the main datt application as well as the landing page, blog, documentation, mockups and other media, and a second unfinished UI. The folders are as follows:
- bin/ - Executable files, particularly for running the app servers.
- blog/ - The blog content and source.
- build/ - Static files and build files for the browser.
- core/ - dattcore - The core logic of p2p, database and API.
- docs/ - Documentation on business, product, community, technology.
- ember/ - The Ember UI, currently unmaintained.
- landing/ - The landing page content and source.
- media/ - Logos, mockups, and template HTML.
- react/ - dattreact - The React front-end.
- server/ - The Datt servers: app server and rendezvous server.
- test/core/ - Tests for dattcore.
- test/react/ - Tests for dattreact.
DATT_JS_BASE_URL- Default "/". The public-facing URL where the javascript files are hosted, usually either "/" or "/js/".DATT_CORE_JS_BUNDLE_FILE- Default "datt-core.js". The dattcore bundle file.DATT_CORE_JS_WORKER_FILE- Default "datt-core-worker.js". The dattcore worker file.DATT_CORE_JS_WORKERPOOL_FILE- Default "datt-core-workerpool.js". The workerpool file, which manages the workers.DATT_JS_TESTS_FILE- Default "datt-tests.js". The tests file - where the browser tests are located.DATT_REACT_JS_FILE- Default "datt-react.js". The React front-end bundle.FULLNODE_NETWORK- Default "mainnet". Can also be "testnet".DATT_BLOCKCHAIN_API_URI- Default "https://insight.bitpay.com/api/".