Hypeflow Docs

Overview

Hypeflow brings token locks, vesting and streaming to Elysium. A creator deposits an ERC‑20 into one escrow contract with a schedule and a beneficiary; the beneficiary claims what has unlocked, whenever they like; and anyone can open a public proof page to verify the deposit, the schedule and every claim, without connecting a wallet.

Getting started

1. Connect a wallet from the app. Hypeflow runs on Elysium; if your wallet is on another network it will prompt you to switch.
2. Get testnet HYPE for gas from the Elysium testnet faucet. There is no app fee during the pilot, so this is the only cost.
3. Test with Demo Token (HFDEMO). You can test immediately using the pre-deployed demo token at 0x2414…04FE (or click Fill Demo Token in the Create form).
4. Create a lock, or check what you can claim. Open Create to lock or vest a token, or Positions to see anything you've created or can claim.

Creating a lock

If the tokens came from a launchpad or factory deployment, copy the token address from the launch receipt. Then:

1. Paste the token address and choose hard lock or linear vesting.
2. Set the amount, beneficiary and schedule. The beneficiary defaults to your own address.
3. Approve the exact amount for the escrow contract, then sign the create transaction.
4. Share the proof link from the confirmation screen, once the position is readable onchain.

The schedule and beneficiary are fixed the moment the position is created. There is no edit, cancel or override, including by the admin, which is what makes the proof link worth sharing.

Hard lock vs. linear vesting

vested = total × (now − start) / (end − start), clamped to zero before the cliff and to the full total at or after the end. The contract and the app use the same formula, so the preview you see before signing matches what the chain will enforce.

Claiming

Only the address recorded as beneficiary can call claim, and it always pays that same address, never the caller of some other function or the creator. There's no minimum: claim as soon as the claimable amount is above zero, as many times as you like, until the position is fully claimed.

Public proof

Every position gets a page at /proof/[chainId]/[id] that opens without a wallet. Every value on it, the token, amounts, schedule, status, and the deposit and claim transaction links, is read straight from the escrow contract and its events, not from a database.

Escrow rules & security

• No upgrade path and no emergency withdraw function. The admin key can only change the creation fee and its recipient.
• A lock only succeeds if the escrow receives the exact deposited amount, so fee‑on‑transfer tokens are rejected automatically.
• Rebasing tokens aren't supported: the escrow books a fixed amount per position.
• Fuzz and invariant tests check that claims never exceed the deposit and that the escrow always stays solvent.
• Not audited. Treat the pilot on testnet accordingly.

Contracts & network