HL Price Guard: read Hyperliquid prices safely from HyperEVMHL Price Guard: HyperEVM から Hyperliquid の価格を安全に読む
A Solidity library for any HyperEVM app that leans on HyperCore prices. It returns the oracle price and refuses it when other views of the market disagree beyond bounds you set.HyperCore の価格に頼る HyperEVM のアプリなら、どれでも使える Solidity のライブラリです。オラクル価格を返し、市場の別の見え方と決めた幅以上に食い違うときは受け取りを拒みます。
What it doesできること
Price read価格を読む
Reads the oracle, mark and best bid/ask through the precompiles, with the two index encodings they use (checked on mainnet).プリコンパイル経由でオラクル・マーク・最良気配を読みます。プリコンパイルごとに異なる2種類の番号の付け方に対応しています(mainnet で確認済み)。
Deviation checks乖離の検知
Rejects the oracle when the book or the mark is too far from it.板やマークがオラクルから離れすぎているときは、オラクルを拒みます。
Independent reference独立の参照
Compares against a price from outside Hyperliquid (Pyth on HyperEVM).Hyperliquid の外の価格(HyperEVM 上の Pyth)と比べます。
Jump latch跳ねの検知
Trips on a jump between reads and stays tripped until the app re-arms it, which it should do only after checking the price independently.読むたびの価格の跳ねで止まり、アプリが戻すまで止まったままです。戻すのは、価格を独立に確かめてからにします。
Exposure cap露出の上限
Caps the notional settled per time window, including a rolling window no stretch of time can exceed.一定時間に決済できる額に上限をかけます。どの区間を切り取っても上限を超えない移動窓もあります。
Request an Operator Readiness Review運営準備レビューを依頼する
For teams opening a HIP-3 market, or already running one.HIP-3 の市場をこれから開くチーム、すでに運営しているチームのためのレビューです。
Where it stopsここまでしかしない
It reads and checks prices and caps exposure. Pools, liquidation and UI belong to the apps that use it.価格を読んで確かめ、露出に上限をかけるところまでです。プール・清算・画面は、使う側のアプリが持ちます。
Versions are tagged. Apps should pin a tag and move to a new one deliberately.版にはタグを付けています。使う側はタグの付いた版に固定し、新しい版へは意図して移るべきです。
Evidence根拠
Two incidents rebuilt from public data: one wallet that moved ETH's mid on Hyperliquid and settled 500x positions against it (2026-10-10), and a deployer oracle that fell 15.6% in one update (xyz:SKHX, 2026-07-27). In the first, the oracle also moved with the push, so a bounds check would not have caught it; in our replay, an exposure cap of $3.3M per minute would have cut the take to an estimated $55K, below the $130,873 the push cost (assuming the incident's average edge and pushes that cost what Papertrade's did; an estimate, not a bound).公開データから2つの事故を組み立て直しました。1つのウォレットが Hyperliquid の ETH の仲値を動かし、それに対して 500 倍の建玉を決済した件(2026-10-10)と、運営者のオラクルが1回の更新で 15.6% 下がった件(xyz:SKHX、2026-07-27)です。前者ではオラクルも押し込みで動いたため、乖離のチェックでは止められませんでした。再現では、1分あたり $3.3M の露出上限なら、得られる額は約 $55K と見積もられ、押し込みにかかった $130,873 を下回ります(事故時の平均的な取り分を当てはめ、押し込みのコストが Papertrade と同じだと仮定した推定で、上限の保証ではありません)。
The SK Hynix replay in HIP-3 RecordHIP-3 Record の SK Hynix の記録Where it standsいまの状態
- Tested with forge, with the precompiles mocked at their real addresses using mainnet values.forge でテストしています。プリコンパイルは本来のアドレスに mainnet の値で模しています。
- It has not been audited.監査は受けていません。
- The source is public under Apache-2.0: github.com/fabrknt/hl-price-guard. Pin a tagged version.ソースは Apache-2.0 で公開しています: github.com/fabrknt/hl-price-guard。タグの付いた版に固定して使ってください。
Operator Readiness Review運営準備レビュー
For teams opening a HIP-3 market, or already running one. We check your setup against what has gone wrong for HIP-3 operators in the public record, and say what we could not check.HIP-3 の市場をこれから開くチーム、すでに運営しているチームのためのレビューです。公開の記録で HIP-3 の運営者に実際に起きたことと照らして体制を確かめ、確かめられなかったことも書きます。