Clouded › Getting Started › About Clouded

Quick Start

Clouded is a prediction market protocol that's:

deployed on HyperEVM and bet on $HYPE instead of stablecoins;

priced along bonding curves instead of "Polymarket" model;

resolved by community juries and DAO tokens instead of external oracles.

$HYPE

Mints, trades, profits are measured and settled in $HYPE.

The only other token used in the protocol is the DAO token, $CLOUDED, to finalize an outcome whenever there is a dispute in a market.

Bonding Curve

Outcome price moves along bonding curves like you see in a memecoin launchpad.

There are two kinds of bonding curves: market bonding curve and outcome bonding curve.

Every outcome shares one market bonding curve, while has its own outcome bonding curve.

Respectively, there are two kinds of pools in a market: market bonding pool and market prize pool.

Bonding pool is refundable, representing all funds regulated by the market bonding curve.

Prize pool is locked, representing fixed rewards collected by all outcome bonding curves.

After the market ends, shares are no longer refundable. 90% of prize pool plus bonding pool go to winning outcome shareholders, and the rest to community juries.

Resolution

After the market ends, there is a one-day window period for jury to reveal outcomes and a one-day window period to challenge the jury outcome.

If all jurors have revealed or the jury outcome is challenged before the window closes, the market automatically goes to the next stage.

If challenged, the window period for the final DAO voting is three days.

Otherwise, the market is resolved and traders claim rewards.

Tips

Price can be unreasonably high in a bonding curve market and sometimes you can lose money even if you're right.

Always look for market total shares, minRewardToWin and health when you bet on an outcome.

Tip 1: Buy any share and wait for the total market shares to rise enough to cover your cost paid into the outcome bonding curve, and take profit.

Since only the price paid to the market bonding curve is refundable, and the outcome bonding curve is locked, you will be temporarily unprofitable. But if more traders buy into the market and the market price rises, it will make your position profitable.

The underlying assumption is: the more popular the market, the more likely your position is to turn profitable.

Tip 2: If you believe an outcome will come true, and the total cost is lower than MinRewardToWin, go in.

ImpliedRewardToWin is the reward you will get if the market immediately settled to your outcome after you place the bet.

But that reward is calculated by the prize pool plus the bonding pool. Any buy that follows you or sell from other outcomes will liquidate your reward.

MinRewardToWin calculates exactly that, that if your outcome wins, what's the minimum reward you will get.

It's not enforced on-chain. Traders can still liquidate your rewards at the expense of losing profits, hence it makes no sense of going in in the first place.

Tip 3: You might still lose money even if you are right.

Since the market is governed by bonding curves and all rewards come from trader deposits, at a point of time, you might still lose money by going in, even if it finally settles to your outcome.

Though if the market outcome is still unclear, it might still be worth going into a popular outcome even though you can't make profit at the moment and against opposite parties.

Because more shares means more prize pool and higher market share price, which makes betting against the popular outcome more profitable and the overall prize pool attractive.

Tip 4: Look for the market total shares and health factor when betting on a popular outcome.

Since every outcome shares one market bonding curve, traders can drain most of the profits from markets with unhealthy market structure.

Health factor tries to measure the structure. It represents how many current shares have switched hands by comparing market total volume and total shares.

A health factor of 0 means nobody has sold any share yet, while a health factor of 100% means half the current market total shares have been sold at some point.

A higher health factor means more early entries have exited positions already, leaving current holders mostly unprofitable and unlikely to sell at the point.

In general, for popular outcomes, the more the current total market shares are, the more difficult it is to cover the cost paid into the outcome bonding curve, hence the more difficult it is to profit from mere trading.

About Clouded

A fully on-chain, decentralized prediction market protocol on HyperEVM powered by $HYPE, community juries, and DAO governance.

1. Traders use $HYPE instead of stablecoins to bet on market outcomes, with share prices moving along a bonding curve.

2. Markets resolve in two phases. First, all staked NFTs form the community jury. The outcome with the most votes wins.

3. There is a 1-day challenge window to appeal the jury outcome. The final outcome is decided by DAO voting.

Share Price & Prize Pool

Clouded markets use a bonding curve to price shares. There are two kinds of bonding curve in a market: market bonding curve and outcome bonding curve. Every outcome has its own bonding curve, while at the same time sharing one bonding curve for the entire market. The equation for both bonding curves is:

sharePrice = 0.00005 × shares

And the overall outcome share price is:

outcomeSharePrice = 0.00005 × (marketShares + outcomeShares)

This implies that betting on one outcome raises the entire market price as well, and earlier entry always has a better edge.

Another difference between market shares and outcome shares is that market shares are refundable, but the amounts paid for outcome shares are locked as the prize pool and distributed to holders of the resolved outcome's shares.

Jury NFT

In the first phase of resolution, as described in the earlier chapter, the market is first resolved to the outcome with the most jury votes. The jury is formed by stakers of the jury NFT. The jury NFT costs 3 $HYPE and can be redeemed at any time for 2.99 $HYPE. The remaining 0.01 $HYPE goes to the protocol's AMM-V2 pool to buy back DAO tokens.

1. Commit-Reveal Mechanism

While the market is ongoing, stakers stake NFTs and secretly commit their intended outcome with a commit hash. To generate a commit hash, the staker's wallet signs a deterministic message containing the market and outcome IDs. The resulting signature is hashed to derive a private salt, and the commit hash is then computed from the revealer's address, market ID, outcome ID, and salt. As long as the staker does not change their intended outcome, the commit hash is always reproducible from the same wallet.

2. Random Number

After the market ends, stakers have a 1-day reveal window to reveal their outcomes. If everyone reveals within this window, the market automatically advances to the 1-day challenge window. Once the market ends, stakers can no longer change their committed outcome. Any token not revealed will be slashed, and its value will also go into the protocol pool to buy back DAO tokens.

This matters because the salt revealed along with the outcome is not only what determines the jury outcome via majority vote, but also the source of the random number used to select the jury panel.

The random number is calculated by XOR-ing all the salts revealed by stakers. The XOR calculation ensures the random number is insensitive to reveal order, so it is effectively determined before the market ends. It changes whenever a staker commits or changes their intended outcome, making it unpredictable and irreversible. The only way to tamper with the random number is by withholding a reveal, which the protocol deters by slashing unrevealed NFTs and withholding DAO rewards from the entire jury panel if the market is not fully revealed.

The DAO token reward scales with market duration: each additional day adds 1 DAO token per correctly-voting staker selected into the jury panel.

3. Jury Panel

The main purpose of the random number is to select and form the jury panel. To be clear, the jury panel does not determine the jury outcome — all stakers' votes collectively determine the outcome. Instead, the jury panel determines which NFTs are rewarded with DAO tokens or slashed if their vote turns out to be wrong.

The size of the jury panel is the total number of staked tokens divided by 5, capped at 300.

Challenge & DAO Voting

After all stakers reveal, or one day after the market ends if not all have revealed, the market enters the challenge window. The window lasts 1 day; if no one challenges, the market resolves to the jury outcome. Anyone unsatisfied with the jury outcome can challenge it by staking one jury NFT, triggering a 3-day DAO voting period. The outcome with the most votes wins.

$CLOUDED Tokenomics

The DAO token used in Clouded is $CLOUDED. Its only role is to vote on market outcomes appealed by challengers. There is no initial emission. The only way to earn $CLOUDED is through jury participation.

All revenue is used to buy back $CLOUDED. Revenue comes from two sources: NFT minting and slashing. The protocol maintains its own native AMM-V2 pool and executes buybacks with 20% slippage tolerance and a 30-minute TWAP.

Market Creation

Another use case for the jury NFT is creating prediction markets. Clouded is a permissionless protocol — everyone can mint and stake enough jury NFTs to create a market. The required number of NFTs is dynamically adjusted:

MarketCreationPrice = TotalSupply / 100

TotalSupply is the total number of NFTs in circulation. In addition to providing market information, the creator must also purchase shares in one outcome at creation time.

Reward

There are three types of reward depending on one's role: jury reward, challenger reward, and trader reward. Market creators receive no direct reward but get to purchase the first shares.

For jury rewards, every staked tokens that voted correctly share 10% of the total prize pool. If staked tokens are fully revealed and selected into the jury panel, those stakers are also rewarded with DAO tokens. Stakers who voted incorrectly receive no token reward of any; if also selected into the jury panel, their NFTs are slashed and their value go to the protocol. If an NFT is not revealed, it will also be slashed.

For challengers, the rule is simple. A challenger is rewarded whenever the resolved outcome differs from the jury outcome — the challenger's token shares 10% of the prize pool and earns DAO tokens. On an unsuccessful challenge, the token is slashed with no reward.

For traders, winners share 90% of the total prize pool. The prize pool consists of the accumulated fixed prize from outcome shares and the remaining bonding prize from market shares.

The reward formulas are:

TraderReward = (marketPrizePool + outcomePrizePool) × traderShares / totalTraderShares × 9 / 10
JuryReward = (marketPrizePool + outcomePrizePool) × stakedTokens / totalStakedTokens / 10
ChallengerReward = (marketPrizePool + outcomePrizePool) / totalStakedTokens / 10
JuryDAOReward = stakedTokens × marketDurationDays
ChallengerDAOReward = marketDurationDays

Contracts

CloudedJury: 0xAF069AAef505047Db7f69F50D322F0D7c3cA4f2A

CloudedMarket: 0x37cebb68dCE4b595ee3534f48049eB7e7fA2dB82

CloudedDAO: 0xbEcE7718FB5e189F9a53Ca3D362dD53fA79c5ADE

CloudedManager: 0x8021e4B891CeFAC6E25301b327a92dF169e7390c

Audits

V12