AquaQoSDocs
AQUAQOS / GUIDEv0 prototype
AquaQoS
Documentation001

Shared liquidity, scheduled.

Aqua makes liquidity shareable. AquaQoS makes shared liquidity schedulable. These pages explain the protocol; the proof page shows the receipts.

Solid: guaranteed. Outlined: burst. Two strategies, half the backing protected.

AquaQoS is an experimental capacity scheduler for makers who run several strategies on 1inch Aqua. It protects configured capacity for every registered strategy and lets unused shared inventory burst to whichever strategy is filling. It adds one custom SwapVM instruction, CAPACITY_GUARD, and a restricted maker vault. Official Aqua still performs every virtual-balance update and every ERC-20 transfer.

  1. 01Independent Aqua strategies

    Each strategy keeps its own virtual balance in Aqua.

  2. 02One shared real inventory

    Every strategy settles against the same vault's ERC-20 balance.

  3. 03CAPACITY_GUARD schedules access

    Opcode 0x05 admits or rejects each fill before settlement.

  4. 04Guaranteed capacity + controlled burst

    Sibling entitlements stay covered; inventory above them can burst.

  5. 05Actual transfer receipt

    Real balances change only in official Aqua settlement.

Read evidence by its label

Every number in these docs comes from one of four environments. They are never interchangeable: a local receipt is not a public transaction, and a planned item is not evidence.

LabelMeaning
RecordedRetained local transaction evidence from the benchmark report
Live localA fresh isolated local EVM session with mock tokens
Local forkA local EVM using copied Ethereum state; no transactions are sent to Ethereum
Public testnetA deployed environment with chain, block and address evidence
PlannedNot implemented and not evidence

Supported domain

One immutable token pair, up to eight fee-free XYC strategies, standard honest ERC-20 tokens and pinned Aqua/SwapVM code. AquaQoS does not claim general solvency, profitability, hostile-token coverage or an external audit.

Vocabulary

TermMeaning
StrategyOne Aqua order: maker, app, program bytes and token pair. Its identity is the Aqua order hash.
Virtual balance vAqua's per-strategy, per-token ledger. It prices quotes; it is not owned capital.
Real inventory IWhat the vault can actually transfer: min(balanceOf(vault), allowance(vault, Aqua)).
Guarantee gThe configured maximum entitlement a strategy keeps protected, in raw token units.
Baseline bThe surplus recorded at activation, v - g. Entitlement is measured above it.
Remaining entitlementmin(g, max(v - b - r, 0)): the part of g the strategy has not consumed.
Reservation rA transient debit held for an in-progress fill and cleared at transaction end.
Debit dThe final maker output of the current fill: amountOut in the fee-free v0 program.
BurstInventory above every remaining entitlement, usable by whichever strategy fills.
GroupOne vault, one router and one sorted token pair, with at most eight strategies.
CAPACITY_GUARDSwapVM opcode 0x05. It runs the program, then checks and reserves the debit.

Where to go next

Verify

On this page