df-lighter-core 0.0.1-beta

Lighter SDK for Rust: markets, account, trading, transfers, pools and binary options on Lighter and on Robinhood Chain, with exact decimals and the API key signer in Rust. Native and wasm.
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Registering an API key at a slot: `ChangePubKey`, signed by the new key itself and by the
//! owner's wallet over "Register Lighter Account". The venue takes it at the slot's own nonce, so
//! a fresh slot starts at whatever `nextNonce` says, and the registration replaces whatever key
//! sat there before.

use crate::utils::hex;
use crate::utils::json::Json;
use crate::utils::sign::PublicKey;
use crate::utils::sign::goldilocks::Fp;
use crate::utils::sign::tx::{Envelope, Tx, TxType, byte_string, hex16};

/// `ChangePubKey`: `public_key` takes the envelope's slot of the envelope's account.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct ChangePubKey {
    pub public_key: PublicKey,
}

impl ChangePubKey {
    #[must_use]
    pub const fn new(public_key: PublicKey) -> ChangePubKey {
        ChangePubKey { public_key }
    }
}

impl Tx for ChangePubKey {
    fn tx_type(&self) -> TxType {
        TxType::ChangePubKey
    }

    fn hash_fields(&self) -> Vec<Fp> {
        self.public_key.limbs().0.to_vec()
    }

    fn info_fields(&self) -> Vec<(&'static str, Json)> {
        vec![("PubKey", byte_string(self.public_key.bytes())), ("L1Sig", Json::String(String::new()))]
    }

    /// Always asked: no key registers without the owner.
    fn l1_message(&self, envelope: &Envelope, _chain_id: u32) -> Option<String> {
        Some(format!(
            "Register Lighter Account\n\npubkey: 0x{}\nnonce: {}\naccount index: {}\napi key index: {}\nOnly sign this message for a trusted client!",
            hex::encode(self.public_key.bytes()),
            hex16(envelope.nonce),
            hex16(envelope.account.get()),
            hex16(u64::from(envelope.api_key.get())),
        ))
    }
}

#[cfg(test)]
#[cfg(feature = "sign")]
#[path = "tests/register.rs"]
mod tests;