new-economy / 0x-monorepo Goto Github PK

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.

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/sol-compiler		A thin wrapper around Solc.js that outputs artifacts, resolves imports, only re-compiles when needed, and other niceties.
@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
@0xproject/subproviders		Useful web3 subproviders (e.g LedgerSubprovider)
@0xproject/tslint-config		Custom 0x development TSLint rules
@0xproject/types		Shared type declarations
@0xproject/typescript-typings		Repository of types for external packages
@0xproject/utils		Shared utilities
@0xproject/web3-wrapper		Web3 wrapper

Dedicated documentation pages:

• 0x.js Library
• 0x Connect
• Smart contracts
• Subproviders
• Sol Compiler
• Web3-wrapper
• JSON-schemas
• Sol-cov
• Standard Relayer API

Node version >= 6.12 is required.

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

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

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.

If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:

yarn config set workspaces-experimental true

Then install dependencies

yarn install

To build all packages:

yarn build

To build a specific package:

PKG=@0xproject/web3-wrapper yarn build

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=@0xproject/web3-wrapper yarn watch

Clean all packages:

yarn clean

Clean a specific package

PKG=0x.js yarn clean

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 all packages:

yarn lint

Lint a specific package:

PKG=0x.js yarn lint

Run all tests:

yarn test

Run a specific package's test:

PKG=@0xproject/web3-wrapper yarn test