+ Lt] P!R R ] 2R RR]!^^4Uu.uF pRVRR/NK upR^RRRR/4K@ Rt] !] ]4t]!R]R,4]!R]R,4]!R]R,R]R ,R!]R",4R#R#uupi)#u HEAD OR TAIL — payout engine (pure functions, no DB, no I/O). This is the heart of the margin guarantee. Everything here is deterministic given its inputs, so it can be unit-tested in isolation. Resolution order inside a single simulated outcome: 1. Each bet -> WIN (exact tier), NEAR (5/6-coin, miss by exactly one), or LOSS. 2. Group bets by (session, round). A group of >= CASHBACK_MIN_TICKETS that is a CLEAN SWEEP (every bet strictly LOSS, no WIN and no NEAR) earns cashback. (Near-miss and cashback are therefore mutually exclusive within a group.) 3. Total payout = sum(wins) + sum(near-miss) + sum(cashback). The chooser simulates all 2^NUM_COINS outcomes, keeps only those whose total payout <= ceiling (PAYOUT_RATE * pool), and picks one favouring the house. If NO outcome is safe (oversubscribed round), it picks the least-bad outcome and returns a scale factor < 1 so that, after scaling every payout, the total equals exactly the ceiling -> the house always keeps its reserve. )productNcR#)HEADS)rTAILSr/opt/headortail/engine.py_facesr s rc>\\\4VR74#)z=All 2^num_coins possible boards as tuples of 'HEADS'/'TAILS'.)repeat)listrr ) num_coinss&r all_outcomesrs 3 44rca\V3RlV44pWR8Xd RW4,3#V\P9d'WR^, 8XdRV\P,3#R#)z Return (status, payout) for one bet against one outcome. status in {'win','near_miss','loss'}. outcome is a tuple indexed 0..num_coins-1. picks is [{'coin':1..6,'pick':'HEADS'/'TAILS'}, ...]. c3r<"TF,pSVR,^, ,VR,8XgK(^xK. R#5i)coinpickNr).0pkoutcomes& r resolve_bet..*s+Mewr&zA~'>"V*'L!!es%7 7win near_miss)loss)sumconfigNEAR_MISS_SIZESNEAR_MISS_MULT)rpickssizestake multipliercorrectsf&&&& r resolve_betr%#s[MeMMGe((( v%%%'AX*=EF$9$9999 rc a /o /p/pVFp\WR,VR,VR,VR,4wrVWV3S VR,&VR,pVPV.4PVR,4VPVR4VR,,W7&K /pVP 4Fwry\ V 4\ P8gK%\;QJdV 3RlV 4F 'dK R M R M!V 3RlV 44'gKgW7,\ P,W&K \R S P444\VP44,p V S V3#) z Evaluate one outcome against all bets. bets: list of dicts with keys: ticket_id, session_id, picks, size, stake, multiplier Returns: (total_payout, results, cashback) results: {ticket_id: (status, payout)} cashback: {session_id: amount} r r!r"r# ticket_id session_idrc3J<"TFpSV,^,R8HxK R#5i)rNr)rtidresultss& rr#evaluate_outcome..Ls@73<?f,s #FTc3*"TF wrVxK R#5i)Nr)r_ps& rrr-Os1 0fq 0s) r% setdefaultappendgetitemslenrCASHBACK_MIN_TICKETSall CASHBACK_RATErvalues) rbets group_members group_stakebstatuspayoutsidcashbackmemberstotalr,s && @revaluate_outcomerD2s5GMK $ wZ6AgJ, $*"2+ o  b)00;@&??34qzA H%++-  w<666 6s@@sss@@@@ + 063G3G G . 1 01 1C8I4J JE '8 ##rcrVf\PpV\P,p.p\V4F$p\ W`4wrxp VP WvW34K& VU u.uFq^,VR,8:gKV NK p p V 'dWV P RR7VP4\P8d V ^,p MVPV 4p Rp RpM8VP RR7V^,p V ^,pV^8d WO, MRp RpV wpprRVR VR V R VR V R VRV/#uup i)a Pick the board to reveal. Returns a dict: outcome : tuple of faces to reveal results : {ticket_id: (status, payout)} (pre-scale) cashback : {session_id: amount} (pre-scale) raw_payout : total payout before scaling scale : multiply every payout by this (<1 only when oversubscribed) ceiling : PAYOUT_RATE * pool oversubscribed : bool g& .>cV^,#r*res&r choose_outcome..ls!r)key?FcV^,#rGrrHs&rrJrKtsQqTrTrr,rA raw_payoutscaleceilingoversubscribed) r NUM_COINS PAYOUT_RATErrDr2sortrandom HOUSE_BIASchoice)r:poolr rngrQ evaluatedorCr,rArIsafechosenrPrRrawrs&&&& rchoose_outcomer`Ss8$$ V'''GI ) $#3A#< %G67%! ;y!aDGdN$:AAyD ;  n % ::<&++ +!WFZZ%F>*1Qi#&7(.%E7G77He7. % S>S6S0S(TVW"XYCICI/ Jrc0\\V44^8H#)z2All coins the same face -> jackpot-eligible board.)r5set)rs&ris_perfect_boardrps s7|  !!r__main__r'Tr(P1r rrrr!r"gY@r#gN@g@@zCeiling:rQz Chosen board:rz Raw payout:rOzscale:rPzoversubscribed:rR)__doc__ itertoolsrrVrr rr%rDr`rmrp__name__samplerbir2rYrprint)cs0rr{s( 5 $B*.60f*"  zF 1X 1QC $ E!QKHKqvq&'2KH A U $    D &$ 'D *d9o& /4 ?+ -l+XtG} T"235%IsC