Socket
Book a DemoInstallSign in
Socket

@sablier/flow

Package Overview
Dependencies
Maintainers
4
Versions
3
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@sablier/flow

Flow smart contracts of the Sablier token distribution protocol

1.1.1
latest
npmnpm
Version published
Weekly downloads
55
120%
Maintainers
4
Weekly downloads
 
Created
Source

Sablier Flow Github Actions Coverage Foundry Discord

In-depth documentation is available at docs.sablier.com.

Background

Sablier Flow is a debt tracking protocol that tracks tokens owed between two parties, enabling open-ended token streaming. A Flow stream is characterized by its rate per second (rps). The relationship between the amount owed and time elapsed is linear is be defined as:

\text{amount owed} = rps \cdot \text{elapsed time}

Sablier Flow can be used in several areas of everyday finance, such as payroll, subscriptions, grant distributions, insurance premiums, loans interest, token ESOPs etc. If you are looking for vesting and airdrops, please refer to our Lockup protocol.

Features

  • Open-ended: A stream can be created with no specific end time. It runs indefinitely until it is paused or voided.
  • Top-ups: No upfront deposit requirements. A stream can be funded with any amount, at any time, by anyone, in full or partially.
  • Pause: A stream can be paused by the sender and can later be restarted without losing track of previously accrued debt.
  • Void: A voided stream cannot be restarted anymore. Voiding an insolvent stream forfeits the uncovered debt. Either the sender or the recipient can void a stream at any time.
  • Refund: Unstreamed amount can be refunded back to the sender at any time.
  • Withdraw: A publicly callable function as long as to is set to the recipient. A stream's recipient is allowed to withdraw funds to any address.

Install

Node.js

This is the recommended approach.

Install Flow using your favorite package manager, e.g. with Bun:

bun add @sablier/flow

Then, if you are using Foundry, you need to add these to your remappings.txt file:

@sablier/flow/=node_modules/@sablier/flow/
@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/
@prb/math/=node_modules/@prb/math/

Git Submodules

This installation method is not recommended, but it is available for those who prefer it.

Install the submodule using Forge:

forge install --no-commit sablier-labs/flow

Then, install the project's dependencies:

forge install --no-commit OpenZeppelin/openzeppelin-contracts@v5.0.2 PaulRBerg/prb-math#95f00b2

Finally, add these to your remappings.txt file:

@sablier/flow/=lib/flow/
@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
@prb/math/=lib/prb-math/

Usage

This is just a glimpse of Sablier Flow. For more guides and examples, see the documentation and the technical file.

import { ISablierFlow } from "@sablier/flow/src/interfaces/ISablierFlow.sol";

contract MyContract {
  ISablierFlow immutable flow;

  function doSomethingWithFlow(uint256 streamId) external {
    uint128 totalDebt = flow.totalDebtOf(streamId);
    // ...
  }
}

Contributing

Feel free to dive in! Open an issue, start a discussion or submit a PR. For any concerns or feedback, please join our Discord server.

Refer to CONTRIBUTING guidelines if you wish to create a PR.

License

The primary license for Sablier Flow is the Business Source License 1.1 (BUSL-1.1), see LICENSE.md. However, there are exceptions:

  • All files in src/ with the exception of SablierFlow.sol are licensed under GPL-3.0-or-later. Refer to LICENSE-GPL.md for preamble.
  • All files in script/ are licensed under GPL-3.0-or-later.
  • All files in tests/ are unlicensed (as indicated in their SPDX headers).

Keywords

asset-distribution

FAQs

Package last updated on 05 Feb 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.