Download tests/test_creator_rules.py from bryceweiner/fly-trader: direct link, hf CLI and curl.
- Browser
- Download file 8.59 kB
-
https://huggingface.co/bryceweiner/fly-trader/resolve/main/tests/test_creator_rules.py
- Command line
-
hf download hf://bryceweiner/fly-trader/tests/test_creator_rules.py
-
curl -L -o test_creator_rules.py https://huggingface.co/bryceweiner/fly-trader/resolve/main/tests/test_creator_rules.py
8.59 kB
| """The creator rules of the memecoin universe (train/selector.py, 2026-10-28/29): a serial rugger's coin is never traded, | |
| nor a coin whose creator owned most of its supply (its launch buy, or its holding at graduation with the launch block's | |
| wallets), nor one whose launch or curve is unknown; a creator-heavy buy that reached sizing would stake at most | |
| CREATOR_HEAVY_CAP_FRACTION of the bankroll (agent/sizing.py).""" | |
| import math | |
| import numpy as np | |
| import pytest | |
| from fly_trader import config | |
| from fly_trader.agent import sizing | |
| from fly_trader.markets import RH | |
| from fly_trader.train import selector | |
| from fly_trader.train.decisions import X_COLS | |
| def _row(age_h=None, dev_share=0.0, prior_known=0.0, prior_rug_share=0.0, dev_hold_share=0.0, bundle_share=0.0, meta_known=1.0, curve_known=1.0): | |
| x = np.zeros(len(X_COLS), np.float32) | |
| if age_h is not None: | |
| x[X_COLS.index("age_known")] = 1.0; x[X_COLS.index("log_age_h")] = math.log1p(age_h) | |
| x[X_COLS.index("dev_share")] = dev_share; x[X_COLS.index("prior_known")] = prior_known; x[X_COLS.index("prior_rug_share")] = prior_rug_share | |
| x[X_COLS.index("dev_hold_share")] = dev_hold_share; x[X_COLS.index("bundle_share")] = bundle_share | |
| x[X_COLS.index("meta_known")] = meta_known; x[X_COLS.index("curve_known")] = curve_known | |
| return x | |
| def _uni(**kw): | |
| return bool(selector.in_universe(_row(**kw)[None], X_COLS)[0]) | |
| def test_a_coin_whose_creator_owned_most_of_the_supply_is_never_traded(): | |
| assert _uni(age_h=9.0, dev_share=0.3) # an ordinary coin: any age past 6 h | |
| assert not _uni(age_h=5.0, dev_share=0.3) # the 6 h minimum still holds | |
| for h in (6.0, 7.5, 8.0, 20.0, None): # XTO: 79 % at launch, bought at 6 and 7.5 h | |
| assert not _uni(age_h=h, dev_share=0.7931) | |
| assert not _uni(age_h=9.0, dev_share=0.3, dev_hold_share=0.75) # bought the rest on the curve | |
| assert not _uni(age_h=9.0, dev_share=0.79, dev_hold_share=0.0) # sold on the curve: its launch buy still counts | |
| assert _uni(age_h=9.0, dev_share=0.7) and _uni(age_h=9.0, dev_hold_share=0.7) # more than 70 %, not 70 % itself | |
| def test_the_launch_blocks_wallets_count_as_the_creators(): | |
| assert not _uni(age_h=9.0, dev_share=0.3, dev_hold_share=0.3, bundle_share=0.45) # 75 % between them | |
| assert not _uni(age_h=9.0, dev_share=0.0, dev_hold_share=0.0, bundle_share=0.75) # the creator kept none itself | |
| assert _uni(age_h=9.0, dev_share=0.3, dev_hold_share=0.3, bundle_share=0.35) # 65 % between them | |
| def test_a_coin_whose_launch_or_curve_is_unknown_is_never_traded(): | |
| assert not _uni(age_h=9.0, meta_known=0.0) # no launch seen: its creator's buy is unknown | |
| assert not _uni(age_h=9.0, curve_known=0.0) # no curve seen: who held at graduation is unknown | |
| assert not _uni(age_h=9.0, curve_known=np.nan) # a training row's NULL fails as well | |
| assert not _uni(age_h=None, meta_known=0.0, curve_known=0.0) # graduated before the archive: no creator facts | |
| x = _row(age_h=9.0, dev_share=0.3); x[X_COLS.index("dev_hold_share")] = np.nan; x[X_COLS.index("bundle_share")] = np.nan | |
| assert bool(selector.in_universe(x[None], X_COLS)[0]) # a NaN share with the facts known is no share | |
| def test_a_serial_ruggers_coin_is_never_traded(): | |
| assert not _uni(age_h=9.0, prior_known=2, prior_rug_share=0.5) | |
| assert _uni(age_h=9.0, prior_known=2, prior_rug_share=0.4) | |
| assert _uni(age_h=9.0, prior_known=0, prior_rug_share=0.0) # no history: not a serial rugger | |
| assert _uni(age_h=None) # age unknown but its creator known: as before | |
| def test_a_universe_without_the_creator_inputs_keeps_the_age_rule_alone(): | |
| cols = ["age_known", "log_age_h"] | |
| assert list(selector.in_universe(np.array([[1, math.log1p(30.0)], [1, math.log1p(5.0)], [0, 0]]), cols)) == [True, False, True] | |
| def test_creator_heavy(): | |
| assert selector.creator_heavy(0.7931) and not selector.creator_heavy(0.7) | |
| assert not selector.creator_heavy(None) and not selector.creator_heavy(float("nan")) | |
| def test_a_creator_heavy_buy_stakes_at_most_its_share_of_the_bankroll(): | |
| table = [{"lo": 0.0, "n": 100, "mean": 0.05, "win": 0.5, "kelly": 0.27}] | |
| size = lambda bankroll, **kw: sizing.size_position(0.1, 0.06, table, bankroll, bankroll, 1000.0, **kw) | |
| share = config.CREATOR_HEAVY_CAP_FRACTION | |
| for bankroll in (1.5, 5.0, 10.0): # 0.1 SOL of a 5 SOL bankroll, 0.03 of 1.5, 0.2 of 10 | |
| (full, _), (capped, why) = size(bankroll), size(bankroll, creator_heavy=True) | |
| assert full > share * bankroll and capped == pytest.approx(share * bankroll) and "creator-heavy cap" in why | |
| assert size(0.8)[0] > 0 and size(0.8, creator_heavy=True)[0] == 0.0 # its share of 0.8 SOL is below the minimum buy: none | |
| full_rh, capped_rh = size(0.2, market=RH)[0], size(0.2, market=RH, creator_heavy=True)[0] | |
| assert capped_rh == pytest.approx(share * 0.2) and capped_rh < full_rh # RH: its share of the ETH bankroll | |
| def _held_info(engine, conn, mint, t, resq=60.0): | |
| a = {"open": 1.0, "high": 1.0, "low": 1.0, "close": 1.0, "buy": 60.0, "sell": 0.0, "nb": 2, "ns": 0, "n_traders": 2, "resq": resq, "pool": "P", "program_label": "Pump.fun Amm"} | |
| return engine._features(conn, mint, a, t)[1] | |
| def _held_meta(conn, table, **rows): | |
| with conn.cursor() as cur: | |
| for mint, held in rows.items(): | |
| cur.execute(f"DELETE FROM {table} WHERE mint = %s", (mint,)) | |
| cur.execute(f"INSERT INTO {table} (mint, graduated_at, dev_hold_share) VALUES (%s, now(), %s)", (mint, held)) | |
| conn.commit() | |
| def test_a_solana_coin_whose_creator_held_a_tenth_at_graduation_is_never_bought(db_conn): | |
| """The Saturween rule (2026-11-01): from 10 % held at graduation; a share not known passes here, the universe's own rule stops it.""" | |
| from fly_trader.agent import minute_engine as me | |
| e = me.MinuteEngine(); t = 1_800_000_000.0 | |
| _held_meta(db_conn, "corpus_meta", CHAtpump=0.10, CHBelowpump=0.0999, CHZeropump=0.0, CHNonepump=None, CHBigpump=0.1695) | |
| try: | |
| got = {m: e.eligible(_held_info(e, db_conn, m, t)) for m in ("CHAtpump", "CHBelowpump", "CHZeropump", "CHNonepump", "CHBigpump")} | |
| finally: | |
| with db_conn.cursor() as cur: | |
| cur.execute("DELETE FROM corpus_meta WHERE mint LIKE 'CH%%pump'") | |
| db_conn.commit() | |
| assert got == {"CHAtpump": False, "CHBelowpump": True, "CHZeropump": True, "CHNonepump": True, "CHBigpump": False} | |
| def test_the_rule_stops_at_solana(db_conn): | |
| from fly_trader import markets | |
| from fly_trader.agent import minute_engine as me | |
| e = me.MinuteEngine(market=markets.RH) | |
| base = {"broken": False, "resq": 100.0, "logvol_15m": 100.0, "source": "pons", "seen_h": 10.0} | |
| assert e.eligible({**base, "creator_held": 0.5}) | |
| def test_a_held_coin_can_still_be_sold_and_priced(db_conn): | |
| """The rule takes a coin off the books' buy rows. Its minute still carries its price and bar, so an open position exits on time.""" | |
| from fly_trader.agent import minute_engine as me | |
| e = me.MinuteEngine(); t = 1_800_000_000.0 | |
| _held_meta(db_conn, "corpus_meta", CHHeldpump=0.5) | |
| a = {"open": 1.0, "high": 1.0, "low": 1.0, "close": 1.0, "buy": 60.0, "sell": 0.0, "nb": 2, "ns": 0, "n_traders": 2, "resq": 60.0, "pool": "P", "program_label": "Pump.fun Amm"} | |
| try: | |
| X, infos, mints, bars = e._minute_rows(db_conn, {"CHHeldpump": a}, t) | |
| finally: | |
| with db_conn.cursor() as cur: | |
| cur.execute("DELETE FROM corpus_meta WHERE mint = 'CHHeldpump'") | |
| db_conn.commit() | |
| assert mints == [] and "CHHeldpump" in bars | |
| def test_no_model_or_definition_moves(monkeypatch): | |
| """Live rows only: training's universe and the definitions a model is matched on are untouched by the rule.""" | |
| import numpy as np | |
| from fly_trader.agent import minute_engine as me | |
| from fly_trader.train import selector | |
| from fly_trader.train.decisions import X_COLS | |
| x = np.zeros((1, len(X_COLS)), np.float32); c = {n: i for i, n in enumerate(X_COLS)} | |
| x[0, c["age_known"]] = 1.0; x[0, c["log_age_h"]] = 3.0; x[0, c["meta_known"]] = 1.0; x[0, c["curve_known"]] = 1.0; x[0, c["dev_hold_share"]] = 0.5 | |
| assert selector.in_universe(x, X_COLS)[0] and selector.UNIVERSE_VERSION == "creator-3" and me.CREATOR_HELD_MAX == 0.10 | |