0x protocol monorepo - includes our smart contracts and many developer tools
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Remove second yarn call Jan 10, 2019
.github Rename sol-trace-based-tools-common to sol-tracing-utils Jan 10, 2019
contracts Publish Jan 15, 2019
packages update team info, add brent Jan 16, 2019
python-packages chore(python-packages): add MAP to python-packages Jan 12, 2019
.editorconfig Add .editorconfig Feb 5, 2018
.gitattributes merge development Oct 16, 2018
.gitignore Rename sol-trace-based-tools-common to sol-tracing-utils Jan 10, 2019
.prettierignore Merge development Jan 10, 2019
.prettierrc Apply prettier config Jan 3, 2018
CODEOWNERS Rename sol-trace-based-tools-common to sol-tracing-utils Jan 10, 2019
CODE_OF_CONDUCT.md Update prettier to version ^1.15.3 Jan 11, 2019
CONTRIBUTING.md Update prettier to version ^1.15.3 Jan 11, 2019
ISSUE_TEMPLATE.md Update issue template Nov 20, 2018
LICENSE Update LICENSE Nov 16, 2018
PULL_REQUEST_TEMPLATE.md Update prettier to version ^1.15.3 Jan 11, 2019
README.md Merge development Jan 10, 2019
lerna.json Add contracts/* to monorepo routes Dec 3, 2018
package.json Update prettier to version ^1.15.3 Jan 11, 2019
readthedocs.yaml fix(order_utils.py): tweaks for first publish (#1185) Oct 26, 2018
requirements.readthedocs.txt fix(order_utils.py): tweaks for first publish (#1185) Oct 26, 2018
tsconfig.json Rename sol-trace-based-tools-common to sol-tracing-utils Jan 10, 2019
typedoc-tsconfig.json chore: missing converts Oct 18, 2018
yarn.lock update team info, add brent Jan 16, 2019

README.md


0x is an open protocol that facilitates trustless, low friction exchange of Ethereum-based assets. For more information on how it works, check out the 0x protocol specification.

This repository is a monorepo including the 0x protocol smart contracts and numerous developer tools. Each public sub-package is independently published to NPM.

If you're developing on 0x now or are interested in using 0x infrastructure in the future, please join our developer mailing list for updates.

CircleCI Coverage Status Discord Join the chat at https://gitter.im/0xProject/Lobby License

Packages

Visit our developer portal for a comprehensive list of core & community maintained packages. All packages maintained with this monorepo are listed below.

Python Packages

Package Version Description
0x-contract-addresses PyPI A tiny utility library for getting known deployed contract addresses for a particular network
0x-contract-artifacts PyPI 0x smart contract compilation artifacts
0x-json-schemas PyPI 0x-related JSON schemas
0x-order-utils PyPI A set of utilities for generating, parsing, signing and validating 0x orders
0x-sra-client PyPI A Python client for interacting with servers conforming to the Standard Relayer API specification

Typescript/Javascript Packages

0x-specific packages

Package Version Description
0x.js npm An aggregate package combining many smaller utility packages for interacting with the 0x protocol
@0x/contract-addresses npm A tiny utility library for getting known deployed contract addresses for a particular network.
@0x/contract-wrappers npm JS/TS wrappers for interacting with the 0x smart contracts
@0x/order-utils npm A set of utilities for generating, parsing, signing and validating 0x orders
@0x/json-schemas npm 0x-related JSON schemas
@0x/order-watcher npm An order watcher daemon that watches for order validity
@0x/migrations npm Migration tool for deploying 0x smart contracts on private testnets
@0x/contract-artifacts npm 0x smart contract compilation artifacts
@0x/abi-gen-wrappers npm Low-level 0x smart contract wrappers generated using @0x/abi-gen
@0x/sra-spec npm OpenAPI specification for the Standard Relayer API
@0x/connect npm An HTTP/WS client for interacting with the Standard Relayer API
@0x/asset-buyer npm Convenience package for discovering and buying assets with Ether

Ethereum tooling

Package Version Description
@0x/web3-wrapper npm An Ethereum JSON RPC client
@0x/sol-compiler npm A wrapper around solc-js that adds smart re-compilation, ability to compile an entire project, Solidity version specific compilation, standard input description support and much more.
@0x/sol-coverage npm A solidity test coverage tool
@0x/sol-profiler npm A solidity gas cost profiler
@0x/sol-trace npm A solidity stack trace tool
@0x/sol-resolver npm Import resolver for smart contracts dependencies
@0x/subproviders npm Web3 provider middlewares (e.g. LedgerSubprovider)
@0x/sol-doc npm Solidity documentation generator

Utilities

Package Version Description
@0x/abi-gen npm Tool to generate TS wrappers from smart contract ABIs
@0x/tslint-config npm Custom TSLint rules used by the 0x core team
@0x/types npm Shared type declarations
@0x/typescript-typings npm Repository of types for external packages
@0x/utils npm Shared utilities
@0x/react-docs npm React documentation component for rendering TypeDoc & sol-doc generated JSON
@0x/react-shared npm 0x shared react components
@0x/assert npm Type and schema assertions used by our packages
@0x/base-contract npm BaseContract used by auto-generated abi-gen wrapper contracts
@0x/dev-utils npm Dev utils to be shared across 0x packages
@0x/fill-scenarios npm 0x order fill scenario generator

Private Packages

Package Description
@0x/contracts 0x protocol solidity smart contracts & tests
@0x/instant A free and flexible way to offer simple crypto purchasing in any app or website.
@0x/testnet-faucets A faucet micro-service that dispenses test ERC20 tokens or Ether
@0x/website 0x website

Usage

Node version >= 6.12 is required.

Most of the packages require additional typings for external dependencies. You can include those by prepending the @0x/typescript-typings package to your typeRoots config.

"typeRoots": ["node_modules/@0x/typescript-typings/types", "node_modules/@types"],

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.

Read our contribution guidelines.

Install dependencies

Make sure you are using Yarn v1.9.4. To install using brew:

brew install yarn@1.9.4

Then install dependencies

yarn install

Build

To build all packages:

yarn build

To build a specific package:

PKG=@0x/web3-wrapper yarn build

Watch

To re-build all packages on change:

yarn watch

To watch a specific package and all it's dependent packages:

PKG=[NPM_PACKAGE_NAME] yarn watch

e.g
PKG=@0x/web3-wrapper yarn watch

Clean

Clean all packages:

yarn clean

Clean a specific package

PKG=0x.js yarn clean

Rebuild

To re-build (clean & build) all packages:

yarn rebuild

To re-build (clean & build) a specific package & it's deps:

PKG=0x.js yarn rebuild

Lint

Lint all packages:

yarn lint

Lint a specific package:

PKG=0x.js yarn lint

Run Tests

Run all tests:

yarn test

Run a specific package's test:

PKG=@0x/web3-wrapper yarn test