Sherwood Protocol // Documentation

How OutlawFlip Works

A provably fair, instant-settle on-chain coinflip game on Robinhood Chain. Stake in USDG or $OUTLAW, get rewarded in $OUTLAW at 1.9× — no waiting, no keeper, no VRF delay.

🔗 Network

Chain	Robinhood Testnet
Chain ID	46630 (0xb626)
RPC	`https://rpc.testnet.chain.robinhood.com`
Explorer	explorer.testnet.chain.robinhood.com
Currency	ETH

📜 Contract Addresses

CoinFlipV2	`0x594a1BDf7646A481C13Aaa65cD2561031737577d`
OUTLAW Token	`0xd37Eb14f0E8f76b0e8Dd9c877428dC2e5cd09E50`
USDG Token	`0x9F4E3861B55dcB673c6C8ca94C737d0DA99bE1fa`

🎮 How to Play

Connect Wallet — Click "Connect Wallet" and approve MetaMask. The app will auto-add Robinhood Testnet to your wallet if not already configured.
Choose Token — Select USDG or $OUTLAW as your stake. Rewards are always paid in $OUTLAW.
Set Amount — Enter your bet amount. Min: 1,000 OUTLAW. Max: 10,000,000 OUTLAW.
Pick a Side — Choose HEADS (The Hood) or TAILS (The Crown).
Flip — Click "Loose the Arrow". The coin flips and settles instantly in a single transaction.
Win — If you guessed correctly, you receive 1.9× your bet in $OUTLAW, sent directly to your wallet in the same transaction.

⚡ Instant Settlement

OutlawFlip V2 uses blockhash randomness for instant settlement. Unlike V1 (which used Chainlink VRF and required a separate keeper to fulfill random words), V2 settles the bet in the same transaction as the placeBet call.

1 User calls placeBetWithOutlaw()

→

2 Contract transfers stake in

→

3 Blockhash generates result

→

4 If won: payout sent instantly

→

5 BetSettled event emitted

All in one transaction, one block. No waiting, no keeper, no VRF delay.

💰 Payout Structure

Outcome	Payout	Net Profit
Win	1.9× bet	+0.9× bet
Lose	0	−1.0× bet

House Edge: 5% (RTP = 95%)
Multiplier: 19/10 = 1.9×
Example: Bet 1,000 OUTLAW on HEADS → Win → Receive 1,900 OUTLAW (net +900).

🔐 Randomness

The result is determined by a hash of:

keccak256(
  blockhash(block.number - 1),
  block.timestamp,
  msg.sender,
  nextBetId,
  tx.gasprice
)

The least significant bit of this hash determines the result (0 = HEADS, 1 = TAILS). This is unpredictable at bet time and cannot be manipulated by the player.

🛡 Security

ReentrancyGuard on all bet functions
SafeERC20 for all token transfers
Solvency check — bet rejected if bankroll < payout
Ownable — only owner can withdraw, pause, or set limits
Non-custodial — payouts sent directly to player wallet

📊 Contract Functions

Player

placeBetWithOutlaw(uint256 amount, uint8 choice) → (uint256 betId, bool won)
placeBetWithUSDG(uint256 usdgAmount, uint8 choice) → (uint256 betId, bool won)
quoteUsdgToOutlaw(uint256 usdgAmount) → (uint256 outlawAmount)

Views

availableOutlaw() → (uint256)
lockedOutlaw() → (uint256)      // always 0 in V2
minBetOutlaw() → (uint256)
maxBetOutlaw() → (uint256)
nextBetId() → (uint256)
paused() → (bool)
bets(uint256 betId) → (Bet)
getRecentBets(uint256 offset, uint256 limit) → (Bet[])
getPlayerBets(address player, uint256 limit) → (Bet[])

Admin (owner only)

fundBankroll(uint256 amount)
withdrawOutlaw(address to, uint256 amount)
withdrawUSDG(address to, uint256 amount)
setBetLimits(uint256 min_, uint256 max_)
setPaused(bool paused_)