Skip to content

Commit e2e8f42

Browse files
committed
feat: Sentinel Lab — interactive fee-engine playground on the site
- lab.html: live SentinelHookV1 state via public RPC polling (graceful snapshot fallback), clickable FeeUpdated history from the on-chain demo, and an interactive simulator replaying 25,309 labeled trades with live policy sliders (k, cap, base, half-life) - lab-data: hook snapshot (72 FeeUpdated events from broadcast receipts) + systematic 1-in-100 trade sample - index.html: lab linked from the research-log banner - sim chart autoscale fix verified via headless render
1 parent 535ac4c commit e2e8f42

5 files changed

Lines changed: 300 additions & 0 deletions

File tree

docs/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ <h2>The evidence already exists &mdash; and it led somewhere unexpected.</h2>
5353
<p class="muted"><strong>The problem is real and severe.</strong> LPs paid adverse-selection costs on 126 of 126 active pool-days. The worst 10% of five-minute windows carried ~80% of all losses. On the flagship native-ETH/USDC pool alone, sampled-day losses reached $8.1M.</p>
5454
<p class="muted"><strong>The v1 signal failed its bar</strong> (trade-level predictability &rho; &asymp; 0.02 vs the pre-registered 0.15) <strong>and the failure was published as committed.</strong> That is what falsifiable research looks like.</p>
5555
<p class="muted"><strong>The post-mortem found where the signal actually lives.</strong> Toxic flow clusters in time: trailing losses predict next-window losses at &rho; = 0.61. Sentinel v2 was rebuilt around that fact &mdash; a self-contained on-chain signal (no oracle), a calibrated continuous fee policy that beat static fees in <strong>18 of 18 out-of-sample configurations</strong>, and a working contract (<a href="https://github.com/chaosxcode/sentinel-hook/blob/main/src/SentinelHookV1.sol">SentinelHookV1.sol</a>) at ~14k gas overhead, inside the safety budget.</p>
56+
<p class="muted"><strong>Try it yourself:</strong> <a href="lab.html">Sentinel Lab</a> — replay the labeled trades through the fee engine, tune the policy, and watch the live hook state.</p>
5657
<p class="muted">Full log: <a href="https://github.com/chaosxcode/sentinel-hook/blob/main/research/FINDINGS.md">research/FINDINGS.md</a> &bull; Pre-registration: <a href="https://github.com/chaosxcode/sentinel-hook/blob/main/research/GATE1_PREREG.md">research/GATE1_PREREG.md</a> &bull; Final v2 claims are reserved for an untouched holdout period, evaluated exactly once.</p>
5758
</section>
5859

docs/lab-data/hook-snapshot.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"poolId":"0x585a22c80ab10732e362ab61c7b028e0016bcf44f3fb1f04b08b509abb36af2d","hook":"0x290d2d0af6dd11b6e235eac6d7528f5474753080","finalFee":7108,"feeUpdatedCount":72,"events":[{"t":"0x6a8b7b04","old":500,"new":862,"ema":0.000215503087865723,"tx":"0xb5586aaaaf0ff19ff3e407b513699e5386652712311826335984e1508ebcf5ea"},{"t":"0x6a8b7b05","old":862,"new":1015,"ema":0.000253766884170296,"tx":"0x4d9a931438709218ffaffc9bea2f29d893d79c24d970eb030b002072e1742813"},{"t":"0x6a8b7b07","old":1015,"new":1336,"ema":0.000334074383339536,"tx":"0x1f2a28e13bf32bc5079fe82b569a9fb4ecd369ab90cba8360176cd78d3f46631"},{"t":"0x6a8b7b08","old":1336,"new":1503,"ema":0.000375920654480646,"tx":"0xd43465178ae50f0e125ebb8bfc1bac06dd1de222ec169b636d4868d6b725b798"},{"t":"0x6a8b7b09","old":1503,"new":1678,"ema":0.000419637979930019,"tx":"0x31efa76294dd5948cbef5e5dbab7680fab4aff4c4abd0f353f144a976fe4597f"},{"t":"0x6a8b7b0b","old":1678,"new":1959,"ema":0.000489807406597043,"tx":"0xabb7feac6d8fd696d741695d6fbec896ebd0e38ef177793fed6b621798896a9a"},{"t":"0x6a8b7b0c","old":1959,"new":2106,"ema":0.000526620076985933,"tx":"0xda44b836e5b5814033235cf94873fb44f1b89c71c62dbd6b71b41512e6697a89"},{"t":"0x6a8b7b0e","old":2106,"new":2416,"ema":0.000604018755482872,"tx":"0xdb98d651bd2b318ff224775931384c12656d0607c190c4e96e4c6e8df33096f6"},{"t":"0x6a8b7b10","old":2416,"new":2739,"ema":0.000684810038420776,"tx":"0x12d25eba8b167229b26c769a1095d825bac6de75d603d5100e79367767482740"},{"t":"0x6a8b7b12","old":2739,"new":3075,"ema":0.000768961314384279,"tx":"0xc9c154f50973dc0a4300c1f194b3cc7c65ecaf5bca9c12a7e009d11bb6aa2c9b"},{"t":"0x6a8b7b14","old":3075,"new":3425,"ema":0.000856440219144367,"tx":"0x2e2eb46c2fe4e7fc85aaf0e57f577f4f2a53278a44854a0637377e3b9a662834"},{"t":"0x6a8b7b15","old":3425,"new":3548,"ema":0.000887206931210277,"tx":"0x68bb7cfa0dfd355bac0ccc4c7f9e4589c9707270bed9125c013e2d990623b3ae"},{"t":"0x6a8b7b16","old":3548,"new":3679,"ema":0.000919869737092877,"tx":"0xe49569716edefb014f3b9483d0dd6127f2466508f9ae4c2fca864030b8027c37"},{"t":"0x6a8b7b17","old":3679,"new":3817,"ema":0.000954419617158308,"tx":"0x378ddf7a979d4581b3d12d51abef30a46f0eb32e49ecae8f630aa1dc3747d3da"},{"t":"0x6a8b7b19","old":3817,"new":4109,"ema":0.001027285731098942,"tx":"0x17b7dac7a0043a516f806f3a66e88328edefd0ebca0ef53140f0ecef33671398"},{"t":"0x6a8b7b1b","old":4109,"new":4414,"ema":0.001103553884146954,"tx":"0x2b18ece55f894465f94c4978c43bf4b92800705737194534e0ab8982efec5d17"},{"t":"0x6a8b7b1d","old":4414,"new":4732,"ema":0.001183191459761205,"tx":"0x0b230d8fe5f8a3c0140c36efbd5afa09b01761efb2ae1cbbc3fc9c03a56ed211"},{"t":"0x6a8b7b1f","old":4732,"new":4981,"ema":0.001245399252490018,"tx":"0x60a8ff3cef8e804e7d518d0b4434aca91d9c52a1e48eb34335aec2792e4fe8b8"},{"t":"0x6a8b7b21","old":4981,"new":5244,"ema":0.001311085865428859,"tx":"0x63bc13d538630863a717ee70f65d29eb9c0a3c61077be774b48176ad85a01db0"},{"t":"0x6a8b7b23","old":5244,"new":5520,"ema":0.001380218150616883,"tx":"0x9f6ef08fddbee633a00ebf412a15f5033d169d5814123f03bfcfac31184d6679"},{"t":"0x6a8b7b24","old":5520,"new":5665,"ema":0.001416483313593924,"tx":"0x125974370a9b37e9d5ebc0c8d32ed1352f834ad21eee8a1bfdb0d233c335ede7"},{"t":"0x6a8b7b25","old":5665,"new":5818,"ema":0.001454605903637726,"tx":"0xd3d117230d0d46b7cd8745aca62d594a5e8922d7c38026538821b6963b4797b7"},{"t":"0x6a8b7b27","old":5818,"new":6138,"ema":0.001534563698735662,"tx":"0xe5b6a1e72b800f21764a607b4180d22a6f61f5096d15dd4de252e73013e8f55d"},{"t":"0x6a8b7b29","old":6138,"new":6372,"ema":0.001593040200231698,"tx":"0x11cde213aca6c37110985110db748f6b12686f7700946d5593a063cb27ed1177"},{"t":"0x6a8b7b2a","old":6372,"new":6496,"ema":0.001624013095324977,"tx":"0xfe41c57bca20a8c0082d9aac59b5c7d402a35df3fe330d49ac55a980d9746b0d"},{"t":"0x6a8b7b2b","old":6496,"new":6627,"ema":0.001656855522470671,"tx":"0x8da578885f0c931e5e26931ebb2e622eb07c435b0bfb19e9c82d11d9fda2d31e"},{"t":"0x6a8b7b2d","old":6627,"new":6905,"ema":0.001726279341767105,"tx":"0xd42f37a970db74664d593ba951fd36fce1523995cacfe01a395dd55e02567975"},{"t":"0x6a8b7b2f","old":6905,"new":7196,"ema":0.001799086357940147,"tx":"0x146443cbb3ed9b54b3c2cfc802ce59f06f280ca732569280cf1ed1746130ddc3"},{"t":"0x6a8b7b31","old":7196,"new":7484,"ema":0.001871178548059093,"tx":"0xc585fe37848fc900e3aee750a912944b7a86d157994e2cd48744e7f4644a1a25"},{"t":"0x6a8b7b34","old":7484,"new":7765,"ema":0.001941414171874772,"tx":"0x30dfd2a086b5319648b879d4314ec59c50afe5d10c65347638c383c2ae48bff2"},{"t":"0x6a8b7b36","old":7765,"new":7950,"ema":0.001987527080196607,"tx":"0xc0a3c9b39d156ebfc402aee1c8863fc1e12603aca52d55674a3fb3baf6ed8dd8"},{"t":"0x6a8b7b38","old":7950,"new":8132,"ema":0.002033171560692549,"tx":"0x924547b86e451ee87bae8668e2eda5e0c8a11f68d3e01d9a4436301301fa0b08"},{"t":"0x6a8b7b39","old":8132,"new":8223,"ema":0.002055750897172072,"tx":"0xe1d5052a8522729ffacc2c5d3afa06768c6163e678b4647c393bba0b3a527da0"},{"t":"0x6a8b7b3b","old":8223,"new":8402,"ema":0.002100679857293623,"tx":"0x599a11dfc73d57b7181b67d62d95315d3ab631a89d22cec540891fe8123c30a4"},{"t":"0x6a8b7b3d","old":8402,"new":8483,"ema":0.002120862186058613,"tx":"0x8d137b56ab2b9ec164579e05a4dc2d47d4456c2ec900a3e4a1615e069871f55e"},{"t":"0x6a8b7b3f","old":8483,"new":8563,"ema":0.002140815433192484,"tx":"0x336513f19e4c9b332815305e3587a7594c95aea0f5141a3281fc7e28a6bc2b5b"},{"t":"0x6a8b7b41","old":8563,"new":8642,"ema":0.002160541715228792,"tx":"0x5f2a0e085293080aa543a0ff856ca053537676586dd2249bde4d4675a944b80b"},{"t":"0x6a8b7b43","old":8642,"new":8720,"ema":0.002180043129141796,"tx":"0xf7a9cfb8571464ef4b0ee7f7398c95934cc4cc6e18ceecf58fbdd0c6ce776fa7"},{"t":"0x6a8b7b45","old":8720,"new":8797,"ema":0.002199321752526813,"tx":"0xdb86a521b9fcfaf4a48a5b922de6c8393510b9beb7338fbe45f9969d7002c7c4"},{"t":"0x6a8b7b47","old":8797,"new":8777,"ema":0.002194378456465478,"tx":"0xffb953158678cf41daf503e342fa143d46f1846e95bb362e8a20dc5832fe5a9e"},{"t":"0x6a8b7b49","old":8777,"new":8757,"ema":0.002189437990352215,"tx":"0x4db89993916955ba7082c8d95ae4f0d90003f0cb9f39cdbaaaa5db6a3c91a990"},{"t":"0x6a8b7b4a","old":8757,"new":8747,"ema":0.00218695747116248,"tx":"0x7a1097f665479d3faa8c8a8e524e4f977056758597479973217d3873615feb65"},{"t":"0x6a8b7b4d","old":8747,"new":8718,"ema":0.002179556184899107,"tx":"0xe9ad0363e4457f74860f64a6d658b435fa7a6eb72b60c7ea4d5d3128e477d0d5"},{"t":"0x6a8b7b4e","old":8718,"new":8708,"ema":0.002177078526393932,"tx":"0xd5f9d63c77811ac8e41018f1ef9850c83e9d01b1374ed8528154d7ab7170c1f8"},{"t":"0x6a8b7b4f","old":8708,"new":8669,"ema":0.002167370887255008,"tx":"0x483f79256aee9f18ebc7df8e3b4ab53f2881c70d655ed97afe8841d3ff415bf1"},{"t":"0x6a8b7b51","old":8669,"new":8592,"ema":0.00214811096864278,"tx":"0x086a181226d50f04775e98e2f3277e6d904727a9eed72dd581672acef92416d4"},{"t":"0x6a8b7b53","old":8592,"new":8516,"ema":0.002129071245965592,"tx":"0xafe95a02250c2eb1d70e37349e079c8ddb2e5ef1c851a4a87a7e3dd1e99ad122"},{"t":"0x6a8b7b55","old":8516,"new":8440,"ema":0.002110249691363154,"tx":"0xf98447c5ac27c260e7a2cadebcf4ad4a091a8788986a161b8c659a02eda7a447"},{"t":"0x6a8b7b56","old":8440,"new":8403,"ema":0.002100935728231201,"tx":"0xfac1a80cf28b3f42eacfc36d20434b453ee873640b68b28ce4063b3ec3e264e0"},{"t":"0x6a8b7b58","old":8403,"new":8329,"ema":0.002082458826474669,"tx":"0x63da798caebb2876a7811f2c15d132578f0b8b0f5eb45132db1d4cf2dcc83a3e"},{"t":"0x6a8b7b59","old":8329,"new":8293,"ema":0.002073315750767925,"tx":"0xa59cd3c10fca05a58878f868269e6c167ab2b5f196671164c392c8dd9ae8c20a"},{"t":"0x6a8b7b5b","old":8293,"new":8219,"ema":0.002054922925208848,"tx":"0xa295ca825699295f2cf80df1e91f390dd95417f8d8e6c8b335e2c641de6ff5d9"},{"t":"0x6a8b7b5d","old":8219,"new":8146,"ema":0.002036742314131836,"tx":"0xc05c8e86daaf052b12788bf564dd1c01ae205deceff27246598aecf51605cda6"},{"t":"0x6a8b7b5f","old":8146,"new":8075,"ema":0.002018771963140851,"tx":"0xf280e38343b62680fa75df6f5bc35d308c5ca833c92c493436fe0ecfc71165c8"},{"t":"0x6a8b7b60","old":8075,"new":8039,"ema":0.002009880172512397,"tx":"0x555e2b271caa5fb180e472bf4ee9e93cf36a2fa50fc1163b12755a681479d5c8"},{"t":"0x6a8b7b61","old":8039,"new":8004,"ema":0.002001050736616694,"tx":"0x492e70a8f9ead8399f76dd8ab7f706d421d8de2f02fef6487d2cb38ecad7f970"},{"t":"0x6a8b7b63","old":8004,"new":7934,"ema":0.001983537364079576,"tx":"0xbb0f6a4b7e9bc38ab750a886f385ca0aa8c326d06c8c6466a3fb8880320bdc14"},{"t":"0x6a8b7b64","old":7934,"new":7899,"ema":0.001974872145813054,"tx":"0xac35ae670988b846ed73a4bce1418ebdf153273a74e992a9b915b507df4de97d"},{"t":"0x6a8b7b66","old":7899,"new":7829,"ema":0.001957472377951432,"tx":"0xd325ed097f17e7149448bae5e8a4816e38f1c9d2fd9f7a80f76c65168103db81"},{"t":"0x6a8b7b67","old":7829,"new":7795,"ema":0.001948863579867082,"tx":"0xc4c2af36b12687841d64f739e02d7b5b7a0de3d1e7500979a8c0cf7b248eed62"},{"t":"0x6a8b7b69","old":7795,"new":7727,"ema":0.001931788896793293,"tx":"0x4d0af776a9cd0d575844adf7ecfc1aeaf26a483ece5f7e66047464db770f4fe7"},{"t":"0x6a8b7b6b","old":7727,"new":7659,"ema":0.001914914290153056,"tx":"0x93921207a5cd790107e0f333be2d7b13e7fd3c096e82bcc25289d7cb7c1b9e33"},{"t":"0x6a8b7b6d","old":7659,"new":7592,"ema":0.001898237917254692,"tx":"0xe508c90f0e28f688fa7ee0246817f0784a703b97faec412057c3e40523bf4f21"},{"t":"0x6a8b7b6e","old":7592,"new":7559,"ema":0.001889987801314107,"tx":"0xf811a493b61a0c4dcfd133654c793a616b251646918299ff54f1684c1476d7f2"},{"t":"0x6a8b7b70","old":7559,"new":7493,"ema":0.00187337094105962,"tx":"0xd7f3077b1d7a9658e3ac6f4c67cb15b03008430f87aab65ade3b7c55a0f47c8e"},{"t":"0x6a8b7b72","old":7493,"new":7427,"ema":0.001856949945098892,"tx":"0x7f63941a09459bc89b4bde961abef23d32b3ca557fc1c93065ca36b183dc352c"},{"t":"0x6a8b7b74","old":7427,"new":7362,"ema":0.001840723009492422,"tx":"0xf7edec7139e168ac265f0caa2492e5e2b9f6bd1d8e563860ad5e01c8e1693e07"},{"t":"0x6a8b7b75","old":7362,"new":7330,"ema":0.001832695851737083,"tx":"0x608a201600bb7b139c93984406c7b41a1cc58d8db081e0aba8c1834b2127665c"},{"t":"0x6a8b7b77","old":7330,"new":7267,"ema":0.001816777855783246,"tx":"0xbb6ddc6d81aee8ff7f1bc74acec41a55ed434068dcd872f184f154ed6e4fb89e"},{"t":"0x6a8b7b79","old":7267,"new":7203,"ema":0.001800793612281961,"tx":"0x6f6c97b23b4303fc343fc87b07fb605100ef3c2f75de15c7a174774e236f71f6"},{"t":"0x6a8b7b7a","old":7203,"new":7171,"ema":0.001792886898267237,"tx":"0xd6c60c8ca03fc7fe77dcdbe2c7d9eb01695e1ed929301bb62dc50d357cff5e3c"},{"t":"0x6a8b7b7c","old":7171,"new":7108,"ema":0.001777208259743731,"tx":"0x212344c4c147382caa602f8d0864c777d13af4848c9469477b5dda8d0924b0a1"}],"topic0":"0x2c104de20fbb789c970f86b1b18f92a4f05c52783081e90e25ef1e4156e40bf3","note":"FeeUpdated events (topic0 0x2c104de2..., signature FeeUpdated(bytes32,uint24,uint24,uint128)) emitted by SentinelHookV1 during the Unichain Sepolia demo. Verify any tx on sepolia.uniscan.xyz."}

docs/lab-data/m2-trades-sample.json

Lines changed: 1 addition & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)