Contracts

​

Contracts

• GoalyMarkets — the no-loss prediction layer. Players predict(marketId, outcome, amount) staking USD₮0; every stake is deposited into GoalyVault to earn yield. Winners split a prize funded purely by that yield, and claim(marketId) returns the stake plus any prize — always in USD₮0. The protocol fee is taken from the prize only, never from the principal.
• GoalyVault — an ERC-4626 (UUPS) vault that pools principal and allocates it across whitelisted strategies while keeping a liquidity buffer for on-demand claims.
• MorphoStrategy — a same-asset strategy that routes USD₮0 into a Morpho USD₮0 vault.
• MorphoSwapStrategy — a cross-asset strategy that swaps USD₮0 ↔ USDC so the vault can also earn in USDC Morpho vaults.
• GoalySettlement — an optimistic settlement oracle. Results are proposed with a bond, finalize after a dispute window if unchallenged, and escalate to governance if disputed — replacing a single trusted oracle key.
• ReserveManager — bridges surplus only (prize funds, never principal) cross-chain as USDC via Circle CCTP (Wormhole-relayed). Principal never leaves Arbitrum.
• AllocationLib — an external delegatecall library holding the vault’s allocation logic, which keeps the vault under 24 KB without the optimizer.

​

What a player calls

// Predict: stake USD₮0 on an outcome. The stake is deposited into the vault to earn yield.
function predict(bytes32 marketId, Outcome outcome, uint256 amount);

// Claim: reclaim your stake (always) plus your prize (if you won), paid in USD₮0.
function claim(bytes32 marketId) returns (uint256 stakeReturned, uint256 prize);

​

No-loss is an on-chain invariant

// The vault's position must always cover principal + prize reserve.
function isSolvent() public view returns (bool) {
    return vault.convertToAssets(vault.balanceOf(markets)) >= totalStaked + reserve;
}

​

Roles