File size: 8,592 Bytes
2e10c7a daf11c9 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | """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
|