Router and market

The token's marketCopy Anchor Link

QSHIELD was launched on the Pons V2 launchpad on Robinhood Chain. It started on a Pons bonding curve and graduated into a Uniswap v4 pool:

The token is a standard ERC-20: it can be held, transferred and traded by anything that supports ERC-20s.

QuantumRouterCopy Anchor Link

The router is the bridge between the market and the vault. It holds no funds between transactions.

Buy into an accountCopy Anchor Link

function buy(bytes32 account, uint256 minTokensOut) external payable returns (uint256 tokensOut);

Swaps msg.value ETH for the token, shields the result into account and updates the vault's price average. Reverts with InsufficientOutput below minTokensOut.

Sell from an accountCopy Anchor Link

A sale is an ordinary vault operation whose exit names the router:

exitTarget = router
exitData   = abi.encode(minEthOut)
recipient  = the address that receives the ETH

The vault approves the router for the exit's amount and calls onShieldExit. The router pulls the tokens, sells them and sends the ETH to recipient. Only the vault can call it.

QuoteCopy Anchor Link

function quote(bool isBuy, uint256 amountIn) external returns (uint256 amountOut);

Returns the output of trading amountIn now, Pons fees included. On the pool it runs the real swap and reverts it, so it is exact; call it with eth_call.

Venue-awareCopy Anchor Link

PonsSwapper, which the router and the harvester share, reads the token's phase from the Pons factory and trades on whichever venue is live. The same contracts worked on the bonding curve and work on the pool, with no migration.

Exit targetsCopy Anchor Link

The router is one implementation of a general interface:

interface IExitTarget {
    function onShieldExit(uint256 amount, address recipient, bytes calldata data) external;
}

Any contract can be the target of an exit: the owner's signature names it and its parameters. This is how a shielded balance can be routed anywhere in one operation without the tokens resting at an address in between.