Frequently Asked Questions
Common questions about RateVault Protocol
Can I change the beneficiary after creation?
No. All vault parameters including the beneficiary address are immutable once deployed. Choose your beneficiary address carefully during creation.
What happens if I don't use my full daily limit?
Unused limit does not roll over. Each 24-hour period starts from your first sell. If you sell 500 tokens on Monday at 10 AM, that starts a period until Tuesday 10 AM. Any sells within that window accumulate against your limit. After Tuesday 10 AM, your next sell will start a fresh 24-hour period with full limit available.
Can I deposit more tokens after creation?
Yes! Anyone can send tokens directly to the vault address at any time. The beneficiary can then sell them according to the daily limit.
What if the swap fails?
Transactions are atomic - if the swap fails for any reason (slippage, liquidity, etc.), your tokens remain in the vault and your daily limit is not consumed. You can try again with adjusted slippage or a smaller amount.
Why is there a protocol fee?
The 1% protocol fee supports ongoing development, security audits, infrastructure costs, and future improvements. It's only charged on ETH received from successful sells, not on your token deposit.
Can I withdraw tokens without selling?
No. The vault enforces rate-limited selling only. Tokens can only exit through the sell function, which enforces daily limits and converts to ETH. This is by design to prevent circumventing the rate limits.
What networks are supported?
Currently Ethereum mainnet and Sepolia testnet. Additional EVM-compatible chains may be added in the future based on demand.
How do I verify my vault contract?
All vaults created through the factory are automatically verifiable on Etherscan using the factory's verified source code. Simply navigate to your vault address on Etherscan and check the contract tab.
What if I lose access to my beneficiary wallet?
If the beneficiary loses wallet access, the tokens are permanently locked in the vault. There is no recovery mechanism. This is why it's critical to secure your beneficiary wallet and verify the address during creation.
Can someone else sell my tokens?
No. Only the designated beneficiary address can execute sells. The smart contract enforces this check before every sell transaction. Not even the vault creator or protocol team can sell tokens from your vault.
How accurate is the daily limit reset timer?
The timer is accurate to the second based on blockchain timestamps. It shows exactly when 24 hours will have elapsed since your last sell. The limit becomes available immediately at that timestamp.
What happens if DEX liquidity is low?
If there's insufficient liquidity for your sell amount, the transaction will fail and your tokens/limit remain unchanged. Try selling a smaller amount or waiting for better liquidity conditions.
Can I sell to tokens other than ETH?
Currently no. RateVault only supports selling tokens for ETH. This simplifies the protocol and ensures consistent fee handling. You can swap the received ETH for other tokens separately.
Is there a minimum daily limit?
No minimum limit is enforced by the contract. However, very small limits (under $10 worth) may result in high gas costs relative to the sell amount, making them economically impractical.
What's the maximum cliff period?
There's no hard maximum, but cliffs are specified in days. Practical maximum is ~1000 years. Most use cases need 0-365 days (0-1 year cliff).
Can I create multiple vaults for the same token?
Yes! You can create as many vaults as needed for the same token with different parameters (different beneficiaries, limits, cliff periods). Each vault is independent.
What tokens are compatible?
Standard ERC20 tokens work. Tokens with non-standard implementations (rebase tokens, fee-on-transfer tokens, tokens with transfer hooks) may not work correctly. Test with small amounts first if unsure.
How much does it cost to create a vault?
You only pay gas fees for deployment. There's no creation fee. Typical gas cost is 200,000-300,000 gas, which varies with network congestion. On mainnet at 20 gwei, this is around $10-15.
Can I pause or cancel my vault?
No. Vaults have no pause, cancel, or destroy functionality. Once created, they operate according to their parameters until the tokens are sold. This is a security feature preventing unauthorized modifications.
What's the advantage over simple time locks?
Traditional time locks release all tokens at once, creating dump risk. RateVault enables continuous, controlled selling throughout the vesting period. This provides liquidity while protecting token price.