df-papertrade-core 0.0.11-beta

Papertrade SDK for Rust on df-hyperliquid-core: intents, relayer, live account, session keys, signed writes, deposits and exact venue math. Wasm-ready.
Documentation 
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

//! The mint curve: flat below the cliff, decayed on the tail as the live figures show, and the
//! PAPER a loss mints at a rate.

use super::*;

/// Live figures from the 2026-10-13 summary: tracked LP past the $2M cliff and tail progress
/// $114.27M, so `100 * (120 / 234.27)^2`, about 26.2 PAPER a dollar.
#[test]
fn the_mint_rate_is_flat_below_the_cliff_and_decays_past_it() {
    let rate = 100 * WAD;
    let cliff = 2_000_000 * WAD;
    let decay = 120_000_000 * WAD;
    let tracked = 4_840_851_053_562_728_341_709_751;
    let tail = 114_265_779_761_243_460_574_521_289;
    // (name, tracked LP, decay scale, tail progress, rate)
    let cases = [
        ("under water", -5, decay, 0, rate),
        ("a unit under the cliff", 1_999_999 * 10i128.pow(18), decay, 0, rate),
        ("at the cliff, no tail yet", 2_000_000 * 10i128.pow(18), decay, 0, rate),
        ("the live figures", tracked, decay, tail, 26_238_849_242_755_169_239),
        ("a tail past any reach", tracked, decay, u128::MAX, 0),
        ("no decay scale and no tail", tracked, 0, 0, 0),
    ];
    for (name, tracked, decay, tail, expected) in cases {
        assert_eq!(mint_rate(tracked, cliff, rate, decay, tail), expected, "{name}");
    }
}

#[test]
fn a_loss_mints_its_dollars_times_the_rate() {
    let rate = 26_238_849_242_755_169_239;
    for (loss, expected) in [(2 * WAD, 2 * rate), (WAD / 2, rate / 2), (0, 0), (u128::MAX, 0)] {
        assert_eq!(paper_for_loss(loss, rate), expected, "{loss}");
    }
}