v1-protocol icon indicating copy to clipboard operation
v1-protocol copied to clipboard

Core smart contracts of the Sablier V1 protocol

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

The source code of the Sablier token streaming protocol. Start with our FAQ to get a high-level understanding of how Sablier works, and see our docs if you want to integrate it in your project.

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 :hammer_and_pick:

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 our apps, head to pay.sablier.finance to create streams and app.sablier.finance to withdraw from streams. You'll need an Ethereum wallet and some ERC20 tokens.

Contributing :raising_hand_woman:

We highly encourage participation from the community to help shape the 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 To install using homebrew:

$ brew install 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