0x — это открытый протокол, который обеспечивает безопасный, низкотранзакционный обмен цифровыми активами на основе Ethereum. Для получения более подробной информации о том, как он работает, обратитесь к спецификации протокола 0x.

Этот репозиторий является монорепозиторием, включающим в себя смарт-контракты протокола 0x и множество инструментов для разработчиков. Каждое публичное подпакетное решение независимо публикуется на NPM.

Пакеты

Посетите наш портал разработчика для полного списка основных и сообщественно поддерживаемых пакетов. Все пакеты, поддерживаемые этим монорепозиторием, приведены ниже.

Пакеты на TypeScript/JavaScript#### Инструменты для Ethereum| Пакет | Версия | Описание |

| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | @0x/web3-wrapper | | Клиент JSON-RPC для Ethereum | | @0x/sol-compiler | | Обертка вокруг solc-js с возможностью умной перекомпиляции, компиляцией всего проекта, специфичной версией Solidity, поддержкой описания стандартного ввода и многим другим. | | @0x/sol-coverage | | Инструмент тестового покрытия для Solidity | | @0x/sol-profiler | | Профилировщик затрат газа для Solidity | | @0x/sol-trace | | Инструмент трассировки для Solidity |npmjs.com/package/@0x/sol-trace) | Инструмент просмотра стека вызовов для Solidity || @0x/sol-resolver | ](https://www.npmjs.com/package/@0x/sol-resolver) | Объект разрешения импорта для зависимостей смарт-контрактов | | @0x/subproviders | ](https://www.npmjs.com/package/@0x/subproviders) | Middleware для провайдера Web3 (например, LedgerSubprovider) | | @0x/sol-doc | ](https://www.npmjs.com/package/@0x/sol-doc) | Генератор документации для Solidity |

Утилиты

Пакет	Версия	Описание
@0x/abi-gen	](https://www.npmjs.com/package/@0x/abi-gen)	Инструмент для генерации TypeScript оболочек из ABI смарт-контрактов
@0x/tslint-config	](https://www.npmjs.com/package/@0x/tslint-config)	Конфигурация TSLint для проектов на TypeScript
@0x/types		Общие объявления типов
@0x/typescript-typings		Репозиторий типов для внешних пакетов
@0x/utils		Общие утилиты
@0x/assert		Типы и схемы проверок, используемые нашими пакетами
@0x/base-contract		Базовый контракт, используемый автоматически сгенерированными обёртками abi-gen
@0x/dev-utils		Утилиты разработки для использования в пакетах 0x

ИспользованиеНеобходим Node.js версии 6.x или 8.x.

Большинство пакетов требуют дополнительных типов для внешних зависимостей. Вы можете включить эти зависимости, добавив пакет @0x/typescript-typings в начало вашего конфига typeRoots.

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

Вклад

Мы настоятельно рекомендуем сообществу помочь нам сделать улучшения и определить будущее направление протокола. Чтобы сообщить о багах внутри этого пакета, создайте проблему в этом репозитории.

Прочтите наши инструкции по вкладу.

Установка зависимостей

Убедитесь, что вы используете Yarn v1.9.4. Для установки с помощью brew:

brew install yarn@1.9.4

Затем установите зависимости

yarn install

Также вам потребуется установленный Python 3, чтобы сборка и запуск тестов командной строки abi-gen, который интегрирован с командами yarn build, yarn test и yarn lint, были выполнены успешно. Более конкретно, ваш локальный pip должен разрешаться к версии pip для Python 3, а не к версии Python 2.x.

Сборка

Для сборки всех пакетов:

yarn build

Для сборки конкретного пакета:

PKG=@0x/web3-wrapper yarn build

Для сборки всех контрактов пакетов:

yarn build:contracts

Наблюдение за изменениями

Чтобы заново собирать все пакеты при изменении:

yarn watch

Чтобы наблюдать за конкретным пакетом и всеми его зависимыми пакетами:```bash PKG=[NPM_PACKAGE_NAME] yarn watch

например, PKG=@0x/web3-wrapper yarn watch

### Очистка

Очистить все пакеты:

```bash
yarn clean

Очистить конкретный пакет:

PKG=0x.js yarn clean

Пересборка

Чтобы заново собрать (очистить и собрать) все пакеты:

yarn rebuild

Чтобы заново собрать (очистить и собрать) конкретный пакет и его зависимости:

PKG=0x.js yarn rebuild

Линтер

Проверить все пакеты:

yarn lint

Проверить конкретный пакет:

PKG=0x.js yarn lint

Запуск тестов

Запустить все тесты:

yarn test

Запустить тесты конкретного пакета:

PKG=@0x/web3-wrapper yarn test

Запустить тесты всех контрактов пакетов:

yarn test:contracts