Head to https://www.originprotocol.com/developers to learn more about what we're building and how to get involved.

Just getting started with Origin? We recommend using Origin Box for development and testing on your local machine.

This is an example DApp (Decentralized Application) that shows how easy it is to create a truly peer to peer marketplace on the Ethereum blockchain with origin-js. Using only javascript, you can create and purchase listings, leave reviews, check identity, and more.

• origin-js repo
• origin-js documentation

To learn more about Origin Protocol, please read our product brief and whitepaper for a high-level description of what we're building and why it matters. Our official website is https://www.originprotocol.com.

This demo is currently running on the Rinkeby testnet. (Note that this demo is slightly behind the current state of this repo.)

• Overview and step-by-step instructions
• Live Demo

Make sure you have node version 8.5.0 or greater

node --version

In a new tab:

git clone https://github.com/OriginProtocol/demo-dapp origin-demo-dapp && cd origin-demo-dapp
npm install
npm run start

A browser will open to http://localhost:3000. If you don't have the MetaMask extension (or another wallet provider) follow instructions of the next step.

• Install MetaMask Chrome Browser Extension.

• Follow the instructions to set up your wallet.

• Click where it says "Ethereum Main Network" and select "Rinkeby Test Network" or "Ropsten Test Network". This takes us off of the real Ethereum network and onto a test network. Ethers on test networks cannot be exchanged for fiat currency.

Be careful not to mix up your test wallet with your real one on the Main Network.

• Get Rinkeby ether from the Rinkeby faucet.
• Get Ropsten ether from the Ropsten faucet.

Create a listing and post it to IPFS and Ethereum.

If you want hack on origin-js code, or if you just want to use a private local blockchain, follow these instructions.

Follow these instructions to setup and run origin-js.

Leave origin-js running and create a new terminal window. Then run the following:

git clone https://github.com/OriginProtocol/demo-dapp origin-demo-dapp && cd origin-demo-dapp
cp dev.env .env  # Use development env vars
npm run install:dev
npm run start

The install:dev script performs the regular install and then links to your local origin-js from step 1. Changes made to origin-js code will then immediately reflected in Demo DApp without requiring npm install.

Your browser will open to http://localhost:3000 and display the DApp.

• Log out of MetaMask.

• Click Restore from seed phrase

• Enter the following seed phrase (Mnemonic):

candy maple cake sugar pudding cream honey rich smooth crumble sweet treat

This is the default seed phrase used by Truffle for development.

⚠️ Be careful not to mix up your test wallet with your real one on the Main Network.

• Click where it says "Ethereum Main Network" and select "Localhost 8545". Click the back arrow to return to your account.

• You should see your first test account now has 100 ETH and the address 0x627306090abaB3A6e1400e9345bC60c78a8BEf57. Additional generated accounts will also have this amount.

Browsers with wallets for both desktop and mobile that you can use with the Origin Demo DApp.

^{Tests for http://demo.originprotocol.com}

See translations directory.

To deploy a development copy of the site on Heroku, choose which branch you would like to use and follow the instructions:

Master branch (stable)	Develop branch (active development)

Heroku will prompt you to set some config variables. You will likely want to stick with the defaults which use Origin's IPFS Gateway and Bridge Server. We also recommend using Infura for connecting to Ethereum even when visitors don't have web3-enabled browsers.

Since this app is just a bunch of HTML and JavaScript, you can also deploy and use it directly from IPFS. Just run:

./scripts/deploy.sh

Origin is an 100% open-source and community-driven project and we welcome contributions of all sorts. There are many ways to help, from reporting issues, contributing code, and helping us improve our community.

To get involved, please join our Discord channel and review our guide to contributing.