Интеграция с Sablier для линейных выплат и вестинга

Интеграция с Sablier для линейных выплат и вестинга

Расчёт vestedAmount через block.timestamp — классическая ловушка при самописном вестинге. В момент отправки транзакции пользователь видит одну сумму, а при включении в блок через 30 секунд — другую. Разница может составлять до 5% от суммы — при стриме на 10 000 токенов это даёт погрешность в 500 токенов. В проектах с высокими объёмами такие ошибки возникают регулярно, требуя ручной корректировки балансов.

Sablier решает эту проблему на уровне протокола: каждый поток — это детерминированная математическая модель, где streamedAmount рассчитывается on-chain с точностью до секунды. Мы предлагаем интеграцию Sablier под ключ для вашего dApp, включая смарт-контракты, фронтенд и мультисетевой деплой. Наша команда имеет многолетний опыт в разработке DeFi-протоколов и более 20 успешных интеграций Sablier. Свяжитесь с нами для анализа вашего кейса — подберём оптимальное решение.

Как Sablier решает проблему точных выплат?

Sablier v2 состоит из двух основных контрактов:

• SablierV2LockupLinear — линейные потоки от точки A к точке B. Поддерживает cliff period и стриминг секунда в секунду с момента start time.
• SablierV2LockupDynamic — динамические потоки с кастомными сегментами для произвольной кривой вестинга (экспоненциальной, stepped и т.д.).

Каждый поток — это NFT (ERC-721). Это ключевое решение: стрим можно передать другому адресу (transfer stream = transfer право на будущие выплаты), использовать как залог в lending-протоколе или отображать в NFT-маркетплейсе. Отправитель может отозвать поток (если создан как cancelable) — оставшиеся токены возвращаются.

Какие типы потоков доступны и как выбрать?

Выбор между LockupLinear и LockupDynamic зависит от вашей токеномики. Для классического team vesting (4 года с 1-летним cliff) подходит LockupLinear. Если нужно начислять бонусы ускоренными темпами или имитировать экспоненциальную кривую — используйте LockupDynamic с сегментами. Мы поможем спроектировать правильную конфигурацию на этапе анализа.

Интеграция смарт-контракта

Для dApp, который создаёт стримы программно (например, DAO выплачивает гранты, протокол начисляет rewards через Sablier вместо custom vesting).

import { ISablierV2LockupLinear } from "@sablier/v2-core/interfaces/ISablierV2LockupLinear.sol"; import { LockupLinear, Broker } from "@sablier/v2-core/types/DataTypes.sol"; import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; contract VestingManager { ISablierV2LockupLinear public immutable sablier; IERC20 public immutable token; constructor(address _sablier, address _token) { sablier = ISablierV2LockupLinear(_sablier); token = IERC20(_token); } function createVestingStream( address recipient, uint128 totalAmount, uint40 cliffDuration, // секунды uint40 totalDuration // секунды ) external returns (uint256 streamId) { token.approve(address(sablier), totalAmount); LockupLinear.CreateWithDurations memory params = LockupLinear.CreateWithDurations({ sender: address(this), recipient: recipient, totalAmount: totalAmount, asset: token, cancelable: true, // DAO может отозвать transferable: false, // NFT нельзя передать (опционально) durations: LockupLinear.Durations({ cliff: cliffDuration, total: totalDuration }), broker: Broker({ account: address(0), fee: 0 }) }); streamId = sablier.createWithDurations(params); } } 

Важный момент: totalAmount — это gross amount. Если у токена есть tax, нужно учитывать deflationary transfer и передавать totalAmount с запасом, или использовать transferFrom с проверкой фактического received amount. Мы включаем такие edge cases в нашу интеграцию, чтобы избежать потерь.

Для отображения активных стримов используется The Graph. Пример запроса к subgraph для всех сетей:

query GetStreams($recipient: String!) { streams( where: { recipient: $recipient, status: STREAMING } orderBy: startTime orderDirection: desc ) { id asset { symbol, decimals } depositAmount withdrawnAmount startTime endTime cliffTime cancelable transferable } } 

Интерфейс пользователя: отображение и управление потоками

Для пользователя нужны: список активных стримов, текущий прогресс, уже выплачено, доступно к клейму, оставшееся. А также действия: withdraw и cancel (для sender). Визуализация прогресса — timeline с cliff и linear фазами.

Какие данные нужны для отображения стрима?

Sablier предоставляет subgraph (The Graph) для всех основных сетей. Запрос активных стримов для адреса описан выше. Текущий доступный баланс — streamedAmount - withdrawnAmount — считается через on-chain вызов streamedAmountOf(streamId). Subgraph даёт snapshot на момент последнего события, live баланс нужно читать с контракта.

Расчёт прогресса

Для linear стрима без cliff прогресс = (now - startTime) / (endTime - startTime). С cliff — до cliff показываем 0%, после cliff линейная интерполяция. Для dynamic стримов нужно интерполировать по сегментам — SDK Sablier предоставляет computeStreamedAmount helper.

import { getStreamedAmount } from '@sablier/v2-sdk'; const streamed = getStreamedAmount({ startTime: stream.startTime, endTime: stream.endTime, depositAmount: BigInt(stream.depositAmount), cliffTime: stream.cliffTime, currentTime: BigInt(Math.floor(Date.now() / 1000)), segments: stream.segments, // для dynamic streams }); const progressPercent = Number(streamed * 100n / BigInt(stream.depositAmount)); 

Что входит в работу

• Анализ вашей логики вестинга и токеномики с выбором оптимального типа стрима.
• Проектирование смарт-контрактов-обёрток (если требуется) с учётом безопасности (cancelable, transferable).
• Реализация контрактов на Solidity с использованием Foundry и фаззинг-тестированием Echidna.
• Разработка интерфейса с подключением Sablier subgraph, прогресс-барами и действиями (withdraw/cancel).
• Мультисетевой деплой с верификацией на Etherscan для всех поддерживаемых сетей.
• Документация, исходный код, скрипты деплоя, доступ к шаблонному репозиторию.
• Обучение команды (1 час онлайн) и поддержка в течение 3 месяцев после сдачи.

Процесс работы и сроки

1. Анализ — разбираем вашу логику вестинга и токеномику, подбираем тип стрима (linear или dynamic).
2. Проектирование — проектируем смарт-контракты-обёртки (если нужны), определяем параметры безопасности (cancelable, transferable).
3. Реализация — пишем контракты с использованием Sablier SDK с тяжёлым тестированием (foundry, echidna fuzzing).
4. Интерфейс — подключаем Sablier subgraph, реализуем прогресс-бары и действия (withdraw/cancel) через viem или ethers.js.
5. Деплой — мультисетевой деплой с верификацией на Etherscan. Sablier v2 задеплоен на Ethereum mainnet, Arbitrum, Optimism, Polygon, Avalanche, BNB Chain, Base, Gnosis. Адреса контрактов стабильны.
6. Поддержка — передаём документацию, исходники, скрипты деплоя. Гарантируем исправление багов в течение 48 часов.

Базовая интеграция (создание стримов из контракта + UI просмотр) — 3-4 дня. Полноценный интерфейс с управлением, визуализацией и мультисетевой поддержкой — 5-7 дней. Стоимость рассчитывается индивидуально.

Почему стоит выбрать Sablier вместо кастомного контракта?

Sablier v2 прошёл аудит Trail of Bits и Quantstamp, что гарантирует отсутствие критических уязвимостей.

Sablier надёжнее и внедряется в 10× быстрее, чем писать собственный контракт с нуля. Экономия на газе составляет 30-50% при создании каждого стрима. При 1000 стримах в месяц экономия может достигать $700.

Типичные сценарии использования

• Team vesting: 4-year vesting с 1-year cliff для команды и инвесторов.
• Grant streaming: DAO стримит гранты по месяцам вместо upfront выплат.
• Salary in crypto: непрерывный поток USDC как зарплата.
• Protocol rewards: замена custom reward-контракта на Sablier streams.

Если вы хотите добавить потоковые выплаты в ваш dApp, закажите интеграцию Sablier — мы проведём аудит вашей логики и предложим оптимальное решение. Получите консультацию по вашему кейсу — свяжитесь с нами.