/v1-protocol

Core smart contracts of the Sablier V1 protocol

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Sablier V1 CircleCI Coverage Status Styled with Prettier Commitizen Friendly License: LGPL3.0

This is the source code of the Sablier V1 token streaming protocol, which is a legacy release. The most recent release is V2 and can be found here. For more details about how Sablier works, check out our docs at docs.sablier.com/.

This repo is structured as a monorepo:

Package Description
@sablier/dev-utils Dev utils to be shared across Sablier projects and packages
@sablier/protocol The core token streaming protocol
@sablier/shared-contracts Smart contracts to be shared across Sablier projects and packages

Usage ⚒️

To compile the smart contracts, bootstrap the monorepo and open the package you'd like to work on. For example, here are the instructions for @sablier/protocol:

$ yarn run bootstrap
$ cd packages/protocol
$ truffle compile --all
$ truffle migrate --reset --network development

Alternatively, if you simply want to use the UI, head to v1-pay.sablier.com to create streams and v1-app.sablier.com to withdraw from streams. You'll need an Ethereum wallet and some ERC20 tokens.

Contributing 🙋‍♀️

Participation from the community is crucial for shaping the future development of Sablier. If you are interested in contributing or have any questions, ping us on Discord.

We use Yarn as a dependency manager and Truffle as a development environment for compiling, testing, and deploying our contracts. The contracts were written in Solidity.

Requirements

  • yarn >=1.17.3
  • truffle >= 5.0.35
  • solidity 0.5.17

Pre Requisites

Make sure you are using Yarn >=1.17.3.

$ npm install --global yarn

Then, install dependencies:

$ yarn install

Watch

To re-build all packages on change:

$ yarn watch

Clean

To clean all packages:

$ yarn clean

To clean a specific package:

$ PKG=@sablier/protocol yarn clean

Lint

To lint all packages:

$ yarn lint

To lint a specific package:

$ PKG=@sablier/protocol yarn lint

Prettier

To run prettier on all packages:

$ yarn prettier

Prettier cannot be run on individual packages.

Test

To run all tests:

$ yarn test

To run tests in a specific package:

$ PKG=@sablier/protocol yarn test