Skip to content

superfluid:vest

Vest a total SuperToken amount to a receiver over a duration through the VestingScheduler (V3), executed by Superfluid's keeper network. With --cliff, everything accrued up to the cliff is transferred at once when it passes, then the rest streams. Automatically grants the scheduler flow-operator rights and the SuperToken allowance it needs; execution is permissionless but not guaranteed if the grants are revoked.

superfluid:vest <amount> <token> <to> <receiver> <over> <duration>
NameTypeDescription
amountnumberTotal amount to vest, in base units (18 decimals)
tokensupertokenSuperToken symbol (e.g. USDCx) or address
tocommandKeyword to
receiveraddressVesting receiver
overcommandKeyword over
durationnumberTotal vesting duration, e.g. 1y or 730d
NameTypeDescription
--startnumberUnix timestamp at which vesting starts (defaults to now)
--cliffnumberCliff period from the start (e.g. 90d): nothing until it passes, then the accrued amount at once
--claimable-fornumberMake the schedule claimable: the receiver must claim within this period after the start or it never begins
--no-approveboolSkip the automatic permission grant and allowance actions
# Vest 12,000 xDAIx to a contributor over a year with a 3-month cliff (scheduler permissions and allowance are granted automatically)
superfluid:vest 12000e18 xDAIx to 0x8790B75cF2BD36a2502A24e0E16AA1B23eBeBC71 over 1y --cliff 90d