e61f23d001
* .gitignore migrations/0x_ganache_snapshot
* .gitignore new-ish Python contract wrappers
These should have been added back when we started generating these
wrappers.
* rm superfluous contract artifact in Python package
All of the contract artifacts were removed from the Python package
recently, because now they're copied from the monorepo/packages area as
an automated build step. Somehow this one artifact slipped through the
cracks.
* Eliminate circular dependency
This was preventing the Exchange wrapper from ever importing its
validator!
* Improve output of monorepo-level parallel script
- Capture stderr (and have it included in stdout) so that it doesn't
leak onto the console for commands that didn't actually fail.
- Include all error output in the Exception object (eliminate print
statement).
* Silence new versions of linters
Newer versions care about this stuff. Old versions didn't, and we don't
either.
* Support Rich Reverts via Web3.py middleware
* Fix bug in generated wrappers' bytes handling
`bytes.fromhex(bytes.decode('utf-8')` is just plain wrong. It would
work for some cases, but is not working when trying to fill orders with
the latest Exchange contract.
* Migrate to Exchange v3
* Fix typo in DevUtils documentation
* Include new contracts in docs
* Re-enable Python checks in CI
* Accept strings for bytes
* Fix CircleCI build artifacts for gen'd python
I swear the previous way was working before, but it wasn't working now,
so this fixes it.
* Accept a provider OR a Web3 object
In various places. This allows the caller to install middleware (which
in web3.py is installed on a Web3 object, not on a provider) before
executing any RPC calls, which is important for the case where one wants
to produce signatures locally before submitting to a remote node.
* wrapper base: don't assume there are accounts
* Eliminate some inline linter directives
* make CHANGELOGs be REVERSE chronological
* Update CHANGELOG entries and bump version numbers
* @0x/contract-addresses: Put addr's in JSON, not TS
This allows easier consumption by other languages. (Specifically, it
eliminates the overhead of keeping the Python addresses package in sync
with the TypeScript one.)
* sra_client.py: incl. docker in `./setup.py clean`
* sra_client.py: Migrate to protocol v3
Removed script that existed only to exclude runs of sra_client builds
(parallel_without_sra_client). Now `parallel` is used by CI,
re-including sra_client in CI checks.
* abi-gen/templates/Py: clarify if/else logic
In response to
https://github.com/0xProject/0x-monorepo/pull/2284#discussion_r342200906
* sra_client.py: Update CHANGELOG and bump version
* contract_addresses/setup.py: rm unnecessary rm
* json_schemas.py: corrections to dev dependencies
* In tests against deployment, also run doctests
* contract_wrappers example: rm xtra Order attribute
Thanks to @steveklebanoff for catching this.
https://github.com/0xProject/0x-monorepo/pull/2284#pullrequestreview-312065368
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.
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 |
 |
A tiny utility library for getting known deployed contract addresses for a particular network |
0x-contract-artifacts |
 |
0x smart contract compilation artifacts |
0x-contract-wrappers |
 |
0x smart contract wrappers |
0x-json-schemas |
 |
0x-related JSON schemas |
0x-order-utils |
 |
A set of utilities for generating, parsing, signing and validating 0x orders |
0x-sra-client |
 |
A Python client for interacting with servers conforming to the Standard Relayer API specification |
Solidity Packages
These packages are all under development. See /contracts/README.md for a list of deployed packages.
| Package | Version | Description |
|---|---|---|
@0x/contracts-asset-proxy |
 |
AssetProxy contracts used within the protocol |
@0x/contracts-erc20 |
 |
Implementations of various ERC20 tokens |
@0x/contracts-erc721 |
 |
Implementations of various ERC721 tokens |
@0x/contracts-erc1155 |
 |
Implementations of various ERC1155 tokens |
@0x/contracts-exchange |
 |
The Exchange contract used for settling trades within the protocol |
@0x/contracts-exchange-forwarder |
 |
A Forwarder contract used to simplify UX for interacting with the protocol |
@0x/contracts-exchange-libs |
 |
Protocol specific libraries used within the Exchange contract |
@0x/contracts-extensions |
 |
Contracts that interact with and extend the functionality of the core protocol |
@0x/contracts-multisig |
 |
Various implementations of multisignature wallets, including the AssetProxyOwner contract that has permissions to upgrade the protocol |
@0x/contracts-test-utils |
 |
TypeScript/Javascript shared utilities used for testing contracts |
@0x/contracts-utils |
 |
Generic libraries and utilities used throughout all of the contracts |
@0x/contracts-coordinator |
 |
A contract that allows users to execute 0x transactions with permission from a Coordinator |
@0x/contracts-dev-utils |
 |
A contract contains utility functions for developers (such as validating many orders using a single eth_call) |
@0x/contracts-staking |
 |
Implements the stake-based liquidity incentives defined by ZEIP-31 |
TypeScript/Javascript Packages
0x-specific packages
| Package | Version | Description |
|---|---|---|
0x.js |
 |
An aggregate package combining many smaller utility packages for interacting with the 0x protocol |
@0x/contract-addresses |
 |
A tiny utility library for getting known deployed contract addresses for a particular network. |
@0x/contract-wrappers |
 |
JS/TS wrappers for interacting with the 0x smart contracts |
@0x/order-utils |
 |
A set of utilities for generating, parsing, signing and validating 0x orders |
@0x/json-schemas |
 |
0x-related JSON schemas |
@0x/migrations |
 |
Migration tool for deploying 0x smart contracts on private testnets |
@0x/contract-artifacts |
 |
0x smart contract compilation artifacts |
@0x/abi-gen-wrappers |
 |
Low-level 0x smart contract wrappers generated using @0x/abi-gen |
@0x/sra-spec |
 |
OpenAPI specification for the Standard Relayer API |
@0x/connect |
 |
An HTTP/WS client for interacting with the Standard Relayer API |
@0x/asset-buyer |
 |
Convenience package for discovering and buying assets with Ether |
@0x/asset-swapper |
 |
Convenience package for discovering and performing swaps for any ERC20 Assets |
Ethereum tooling
| Package | Version | Description |
|---|---|---|
@0x/web3-wrapper |
 |
An Ethereum JSON RPC client |
@0x/sol-compiler |
 |
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 |
 |
A solidity test coverage tool |
@0x/sol-profiler |
 |
A solidity gas cost profiler |
@0x/sol-trace |
 |
A solidity stack trace tool |
@0x/sol-resolver |
 |
Import resolver for smart contracts dependencies |
@0x/subproviders |
 |
Web3 provider middlewares (e.g. LedgerSubprovider) |
@0x/sol-doc |
 |
Solidity documentation generator |
Utilities
| Package | Version | Description |
|---|---|---|
@0x/abi-gen |
 |
Tool to generate TS wrappers from smart contract ABIs |
@0x/tslint-config |
 |
Custom TSLint rules used by the 0x core team |
@0x/types |
 |
Shared type declarations |
@0x/typescript-typings |
 |
Repository of types for external packages |
@0x/utils |
 |
Shared utilities |
@0x/assert |
 |
Type and schema assertions used by our packages |
@0x/base-contract |
 |
BaseContract used by auto-generated abi-gen wrapper contracts |
@0x/dev-utils |
 |
Dev utils to be shared across 0x packages |
Private Packages
| Package | Description |
|---|---|
@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 |
Usage
Node version 6.x or 8.x 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
You will also need to have Python 3 installed, in order to build and run the tests of abi-gen's command-line interface, which is integrated with the yarn build, yarn test, and yarn lint commands described below. More specifically, your local pip should resolve to the Python 3 version of pip, not a Python 2.x version.
Build
To build all packages:
yarn build
To build a specific package:
PKG=@0x/web3-wrapper yarn build
To build all contracts packages:
yarn build:contracts
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
Run all contracts packages tests:
yarn test:contracts