/persona-mainnet

Persona mainnet

Primary LanguageJavaScript

Persona testnet platform. For more information please refer to our website: https://persona.im.

This version is still alpha, use at your own risks

Details

This is a fork from Ark with the following features:

  • Ability to register a name with an address
  • Ability to verify a user`s name through signing the registered name
  • Ability to list the verifications

### Planned features:

  • Add IPFS in order to register documents

### Performance

Developer Installation

Install

Install essentials:

sudo apt-get update
sudo apt-get install -y curl build-essential python git

Install PostgreSQL (min version: 9.5.2)

sudo apt-get install -y postgresql postgresql-contrib
sudo -u postgres createuser --createdb --password $USER
createdb persona_testnet

Install Node.js (tested with version 6.9.2, but any recent LTS release should do):

sudo apt-get install -y nodejs
sudo npm install -g n
sudo n 6.9.2

Install grunt-cli (globally):

sudo npm install grunt-cli -g

Clone this repository

git clone https://github.com/PersonaIam/personatestnet.git
cd personatestnet

Install node modules:

npm install libpq secp256k1
npm install

Launch

To launch Persona on testnet:

createdb persona_testnet
npm run start:testnet

To launch Persona on localnet:

createdb persona_localnet
npm run start:localnet

To test stuff on local net use the genesis address:

passphrase: blade early broken display angry wine diary alley panda left spy woman
address: LMs6hQAcRYmQk4vGHgE2PndcXWZxc2Du3w

NOTE: The port, address, genesis block and config-path can be overridden by providing the relevant command switch:

node app.js -p [port] -a [address] -c [config-path] -g [genesisBlock-path]

This allow you to run several different networks, or your own private chain

Launch your own private or public chain

Generate a genesisBlock.json + a default config.json containing all passphrases of genesis delegates

node tasks/createGenesisBlock.js

Be sure to configure this file for your needs

  • a genesisBlock.json containing the genesis block
  • a config.json containing configuration to start relay nodes
  • an autoforging config.json containing configuration to start all delegates on a single node (for testing purpose)
  • a bunch of config files to distribute to different configured delegate nodes starting the network.
  • a delegatesPassphrases.json containing details about the genesis delegates
  • a genesisPassphrase.json containing the details of delegates that will launch your network

Obviously you can hack away tasks/createGenesisBlock.js for your own custom use.

You can the start with your own chain on a single node (all delegates will forge on your single node) using:

createdb ark_newtest
npm run start:newtest

Then you can distribute the config.json (without the delegates secrets inside, and with custom peers settings) to peers to let them join your chain

Tests

Load git submodule ark-js:

git submodule init
git submodule update

You should run using test configurations

npm run start:test

Run the test suite:

npm test

Run individual tests:

npm test -- test/api/accounts.js
npm test -- test/api/transactions.js

NOTE: The master passphrase for this test genesis block is as follows:

peace vanish bleak box tuna woman rally manage undo royal lucky since

Authors

License

The MIT License (MIT)

Copyright (c) 2016-2017 Ark Copyright (c) 2016 Lisk Copyright (c) 2014-2015 Crypti

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.