/polymath.js

Core library/API/Node module for accessing chain code.

Primary LanguageJavaScriptMIT LicenseMIT

Build Status Known Vulnerabilities

Polymath

Polymath.js

Polymath.js is the main library for interacting with Polymath's smart contracts. It is written in javascript using flow, babel and eslint. The documentation is automatically generated using documentationjs. Checkout the docs

Read the whitepaper

Testing locally

Clone the repo, then run

  • yarn install
  • yarn testrpc (keep this terminal running)

In a new terminal

  • yarn compile
  • yarn migrate-testrpc
  • yarn start (babel compiling) (keep this terminal running)

In a new terminal

  • yarn test to test all files
  • yarn mocha lib/test/{FILENAME.js} to test a single file

Note: If make changes to source files being compiled by babel, run yarn clean to remove the old compiled babel files, and then run yarn start to get an updated version with the new code.

Updating the contracts

The following occurs:

  • Checks that polymath-core is on the master branch
  • Executes git pull on the polymath-core
  • Copies the polymath-core/contract directory into polymath-js directory
  • Removes the polymath-js/build directory

In polymath-js

  • yarn contracts

Note: Ensure you have the following file structure

- polymath (root dir name doesn't matter)
|-- polymath-js
|-- polymath-core

Serving and building documentation

To serve the docs locally, run:

  • yarn install
  • yarn start to run babel to compile the source code and have it watching for updates (leave this terminal open)
  • yarn serve-poly-docs

To build the docs run yarn build-poly-docs. Make sure when you make edits, you rebuild the docs so they are added in!

Contributing

We're always looking for developers to join the polymath network. To do so we encourage developers to contribute by creating Security Token Offering contracts (STO) which can be used by issuers to raise funds. If your contract is used, you can earn POLY fees directly through the contract, and additional bonuses through the Polymath reserve fund.

If you would like to apply directly to our STO contract development team, please send your resume and/or portfolio to careers@polymath.network.

Styleguide

The polymath-core repo follows the style guide overviewed here: http://solidity.readthedocs.io/en/develop/style-guide.html