Skip to main content

Configure Your Local Environment

In this guide, we will go through the steps to set up a local development environment for building on-chain integrations with Sablier. We will use Foundry to install Sablier as a dependency, and run a few simple tests.

At the end, you’ll have a development environment set up that you can use to build the rest of the examples under "Guides", or start your own integration project.


You will need the following software on your machine:

In addition, familiarity with Ethereum and Solidity is requisite.

Quick start

We put together a template repository that you can use to get started quickly. This repository features a basic project structure, pre-configured Sablier imports, and a selection of sample contracts and tests.


Make sure you are using the latest version of Foundry by running foundryup.

To install the template, simply execute the following commands:

$ mkdir sablier-v2-integration-template
$ cd sablier-v2-integration-template
$ forge init --template sablier-labs/sablier-v2-integration-template
$ bun install

Then, hop to the Run a Fork Test section to complete your set up and start developing.

Start from scratch

Foundry is a popular development toolkit for Ethereum projects, which we have used to build the Sablier Protocol. For the purposes of this guide, Foundry will provide us with the tooling needed to compile and test our contracts.

Let's use this command to spin up a new Foundry project:

$ forge init my-project
$ cd my-project

You might notice that the CLI is forge rather than foundry. This is because Foundry is a toolkit, and forge is just one of the tools that comes with it.

Once the initialization completes, take a look around at what got set up:

├── foundry.toml
├── script
├── src
└── test

The folder structure should be intuitive:

  • src is where you'll write Solidity contracts
  • test is where you'll write tests (also in Solidity)
  • script is where you'll write scripts to perform actions like deploying contracts (you guessed it, in Solidity)
  • foundry.toml is where you can configure your Foundry settings, which we will leave as is in this guide

Let's install the Sablier Node.js packages using Bun:

$ bun add @sablier/v2-core @sablier/v2-periphery

Bun will download the Sablier contracts, along with their dependencies, and put them in the node_modules directory.

Let's remap the package names to point to the installed contracts. This step is required so that the Solidity compiler can find the Sablier contracts when you import them:

$ echo "@sablier/v2-core=node_modules/@sablier/v2-core/" >> remappings.txt
$ echo "@sablier/v2-periphery=node_modules/@sablier/v2-periphery/" >> remappings.txt
$ echo "@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/" >> remappings.txt
$ echo "@prb/math/=node_modules/@prb/math/" >> remappings.txt

That's it! You should now have a functional development environment to start building on-chain Sablier integrations. Let's run a quick test to confirm everything is set up properly.

Sample contract

Delete the src/Counter.sol and test/Counter.t.sol files generated by Forge, and create two new files: src/StreamCreator.sol and test/StreamCreator.t.sol.

Paste the following code into src/StreamCreator.sol (a detailed explanation of this contract can be found here):

Lockup Linear Stream Creator

Let's use Forge to compile this contract:

$ forge build

If the contract was compiled correctly, you should see this message:

[⠢] Compiling...
[⠰] Compiling { number } files with { compiler }
[⠒] Solc { compiler } finished in { time }
Compiler run successful

The minimum Solidity version supported by the Sablier contracts is v0.8.13.

Run a fork test

Foundry offers native support for running tests against a fork of Ethereum Mainnet, which is useful when building and testing integrations with on-chain protocols like Sablier. In practice, this enables you to access all Sablier contracts deployed on Ethereum, and use them for testing your integration.

As a prerequisite, you will need an RPC that supports forking. A good solution for this is Alchemy, as it includes forking in its free tier plan.

Once you have obtained your RPC, you can proceed to run the following test:

Stream Creator Test

You can run the test using Forge:

$ forge test

If the test passed, you should see a message like this:

Ran 2 tests for v2/core/LockupStreamCreator.t.sol:LockupStreamCreatorTest
[PASS] test_LockupDynamicStreamCreator() (gas: 273719)
[PASS] test_LockupLinearStreamCreator() (gas: 186388)
Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 6.34s (5.80s CPU time)

Next steps

Congratulations! Your environment is now configured, and you are prepared to start building. Explore the guides section to discover various Sablier features available for integration. Remember to include all contracts (.sol files) in the src folder and their corresponding tests in the test folder.

As far as Foundry is concerned, there is much more to uncover. If you want to learn more about it, check out the Foundry Book, which contains numerous examples and tutorials. A deep understanding of Foundry will enable you to create more sophisticated integrations with Sablier.