How Quantum Vault works

Overview

Quantum Vault is a Uniswap v4 hook deployed on Ethereum mainnet, together with the QV token. The hook does two things:

• It charges a 1% fee on every swap in the pools that use it.
• It holds staking vaults, one per currency, where you can deposit ETH or an ERC-20 such as QV and withdraw it at any time.

Stakers can be rewarded in QV, minted by the hook when it collects fees. Minting is limited by QV's 1,000,000,000 supply cap. See Rewards for how this works and the current status.

Contracts and live status

Live status

QV total supply

…

QV max supply

…

QV left to mint as rewards

…

QV minted per whole fee token

…

Staked in the ETH vault

…

Staked in the QV vault

…

Protocol fees held, ETH

…

Protocol fees held, QV

…

Reading from Ethereum…

The 1% hook fee

On every swap through a pool that uses the hook, the hook withholds 1% of the amount the swapper specifies (FEE_BPS = 100):

• Exact input (you choose how much you pay): 1% of the input, in the input currency.
• Exact output (you choose how much you receive): 1% of the output, in the output currency.

The fee is charged on top of the pool's own LP fee. Pools meant to charge only the 1% are created with an LP fee of 0.

Every fee is booked as protocol revenue (protocolFees), per currency, and only the owner can withdraw it. Fees never come out of staked deposits, which are accounted for separately.

Staking

Each currency has its own vault inside the hook. The site offers the ETH vault and the QV vault.

• Stake: stake(currency, amount). For ETH, the amount is sent with the transaction. For QV, your wallet first asks you to approve the hook to move that amount.
• Unstake: unstake(currency, amount) returns your deposit and pays any pending QV in the same transaction.
• Claim: claim(currency) pays pending QV without touching your deposit.

There is no lock and no fee to stake or unstake; you only pay network gas. Staking more or unstaking also pays out your pending QV first.

Rewards

When the hook collects a fee in a currency that has stakers, it mints QV and shares it among that currency's stakers, in proportion to their stake at that moment:

• Rate. qvPerFee is the QV minted per 10¹⁸ units of the fee token. It starts at 1, so a fee of 1 ETH mints 1 QV. The owner can change it, up to 1,000,000 QV per whole fee token. Tokens with fewer decimals than 18 (such as USDC) mint proportionally less per unit of value.
• Only when someone is staked. If nobody is staked in the fee's currency, no QV is minted for that swap.
• Instant split. QV is split among whoever is staked when the swap happens. There is no time weighting or minimum stay.
• Supply cap. The hook never mints past QV's 1,000,000,000 maximum. Near the cap, it mints only what's left, then nothing.

QV token

• Name Quantum Vault, symbol QV, 18 decimals, standard ERC-20.
• Maximum supply 1,000,000,000 QV, enforced by the contract.
• The only address that can mint is the vault hook, and that setting is locked forever (minterLocked = true).
• No transfer tax, no blacklist and no pause in the token.
• The official website and X profile are stored in the contract (website(), twitter()).

Who can do what

Risks

• No rewards at the moment. See Current status.
• Smart contract risk. The contracts can contain bugs. No audit has been published.
• Price risk. ETH and QV can lose value while staked.
• Owner powers. The owner controls the reward rate and the collected fees.
• Not financial advice. Nothing on this site is an offer or a promise of returns. Availability may be restricted where you live.

FAQ