ambrosus-node-contracts

ambrosus-node-contracts

Smart contracts used in AMB-NET

Development

Install dependencies and compile contracts:

yarn
yarn build

First you need an RPC running. For example you may want to start ganache-cli with running

yarn global add ganache-cli
ganache-cli -e 1000000

Next you need to set environment variables for the RPC address and private key. In case you run ganache copy one of the available private keys and set

export WEB3_RPC=http://localhost:8545
export WEB3_NODEPRIVATEKEY="COPIED_PRIVATE_KEY"

Then deploy genesis contracts and save outcome to an environment file

yarn task deployGenesis --save <path to file>

Finally deploy the cryptoeconomy contracts:

yarn task deploy initial

Or deploy an update to the cryptoeconomy contracts:

yarn task deploy update

You are ready to play.

The following administrative tasks are available:

yarn task deployGenesis (only for testing purposes as this are normally included in the genesis block)
yarn task deploy initial [turbo mode flag] 
yarn task deploy update [turbo mode flag] 
yarn task whitelist add [address] [node type] [required stake/deposit]
yarn task whitelist remove [address]
yarn task whitelist get [address]
yarn task onboard [node type]
yarn task upload [bundleId] [storagePeriods]
yarn task nodeService setUrl [new node url]
yarn task payouts period
yarn task payouts total
yarn task payouts withdraw

Testing

To install dependencies call:

yarn

To compile contracts:

yarn build

To run tests:

yarn test:units
yarn test:tasks

Alternatively, to compile contracts and test:

yarn test:all

To check gas consumption of common operations

yarn test:gasbenchmark

Production and deployment

Before distributing the compiled contract files you should strip away unnecessary fields:

yarn strip