82b0ff6008
* development: (269 commits) Make new packages default to public on publish Add new public packages to top-level README Update top-level package.json Fix incorrect new versions Fix path to assets Publish Updated CHANGELOGS Fix quotation marks Add a complex test for ast visitor Move opcodes to constants Fix issue with bundling subproviders for the browser by ignoring the `ganache-core` dependency Add changelog entry about pragma addition Add pragma above command-line script Add tests for sol-cov Updated CHANGELOGs Add SignedOrder, Order, and ECSignature types to the types package Keep console.log in monorepo-scripts Enable coverage for all other packages with tests Fix parallel coverage results reporting Fix linter issuesx ...
0x is an open protocol that facilitates trustless, low friction exchange of Ethereum-based assets. A full description of the protocol may be found in our whitepaper.
This repository is a monorepo including the 0x protocol smart contracts and numerous developer tools. Each public sub-package is independently published to NPM.
Published Packages
| Package | Version | Description |
|---|---|---|
0x.js |
 |
A Javascript library for interacting with the 0x protocol |
@0xproject/abi-gen |
 |
Tool to generate TS wrappers from smart contract ABIs |
@0xproject/assert |
 |
Type and schema assertions used by our packages |
@0xproject/base-contract |
 |
BaseContract used by auto-generated abi-gen wrapper contracts |
@0xproject/connect |
 |
A Javascript library for interacting with the Standard Relayer API |
@0xproject/deployer |
 |
Solidity project compiler and deployer framework |
@0xproject/dev-utils |
 |
Dev utils to be shared across 0x projects and packages |
@0xproject/json-schemas |
 |
0x-related json schemas |
@0xproject/monorepo-scripts |
 |
Monorepo scripts |
@0xproject/react-docs |
 |
React documentation component for rendering TypeDoc & Doxity generated JSON |
@0xproject/react-shared |
 |
0x shared react components |
@0xproject/sra-report |
 |
Generate reports for standard relayer API compliance |
@0xproject/sol-cov |
 |
Solidity test coverage tool tool |
@0xproject/subproviders |
 |
Useful web3 subproviders (e.g LedgerSubprovider) |
@0xproject/tslint-config |
 |
Custom 0x development TSLint rules |
@0xproject/types |
 |
Shared type declarations |
@0xproject/utils |
 |
Shared utilities |
@0xproject/web3-wrapper |
 |
Web3 wrapper |
TypeScript Typings
| Package | Version | Description |
|---|---|---|
chai-as-promised-typescript-typings |
 |
Chai as promised typescript typings |
chai-typescript-typings |
 |
Chai typescript typings |
ethers-typescript-typings |
|
Ethers.js typescript typings |
web3-typescript-typings |
 |
Web3 typescript typings |
Private Packages
| Package | Description |
|---|---|
@0xproject/contracts |
0x solidity smart contracts & tests |
@0xproject/react-docs-example |
Example documentation site created with @0xproject/react-docs |
@0xproject/testnet-faucets |
A faucet micro-service that dispenses test ERC20 tokens or Ether |
@0xproject/website |
0x website & Portal DApp |
Usage
Dedicated documentation pages:
Contributing
We strongly recommend that the community help us make improvements and determine the future direction of the protocol. To report bugs within this package, please create an issue in this repository.
Please read our contribution guidelines before getting started.
Install dependencies
If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:
yarn config set workspaces-experimental true
Then install dependencies
yarn install
Build
Build all packages
yarn lerna:run build
Continuously rebuild on exchange
yarn dev
Lint
Lint all packages
yarn lerna:run lint
Run Tests
Before running the tests, you will need to spin up a TestRPC instance and deploy all the 0x smart contracts.
In a separate terminal, start TestRPC (a convenience command is provided as part of this repo)
yarn testrpc
Then in your main terminal run
cd packages/contracts
yarn migrate
cd ..
And finally from the root project directory run
yarn lerna:run test