fly-trader / tests /test_creator_rules.py
bryceweiner's picture
release 20 (e30ce773f3) (part 2)
daf11c9 verified
Raw History Blame Contribute Delete
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