metaflux-client 0.8.0

Rust SDK for the MetaFlux derivatives L1 — REST + WebSocket, EIP-712 signing, and typed builders for the full signed-action surface (orders, TWAP, margin, vaults, staking, spot/Earn).
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
54
55
56
57
58
59
60
61
62
63

//! MetaBridge withdrawal — debit cross-collateral and queue an outbound release.
//!
//! Sender-authorized: the signer is the account whose cross-collateral is
//! debited. The withdrawal queues an outbound message for validator co-signing,
//! which releases funds on the destination chain.

use serde::{Deserialize, Serialize};

/// Destination chain for a MetaBridge withdrawal. Serializes in PascalCase to
/// match the node's chain enum (`"Base"` / `"Arbitrum"` / `"Solana"`).
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum MbChain {
    /// Base.
    Base,
    /// Arbitrum.
    Arbitrum,
    /// Solana.
    Solana,
}

/// Action — withdraw cross-collateral to a destination chain.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub struct MbWithdraw {
    /// Destination chain.
    pub chain: MbChain,
    /// MetaFlux asset id (currently only `0` = USDC cross-collateral).
    pub asset: u32,
    /// Amount in base units.
    pub amount: u64,
    /// Destination address as `0x`-hex: a 20-byte EVM address (Base / Arbitrum)
    /// or a 32-byte recipient (Solana).
    pub dst_addr: String,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn mb_chain_serializes_pascal_case() {
        assert_eq!(serde_json::to_string(&MbChain::Base).unwrap(), "\"Base\"");
        assert_eq!(
            serde_json::to_string(&MbChain::Solana).unwrap(),
            "\"Solana\""
        );
    }

    #[test]
    fn mb_withdraw_round_trips() {
        let a = MbWithdraw {
            chain: MbChain::Base,
            asset: 0,
            amount: 1_000_000,
            dst_addr: "0xabababababababababababababababababababab".into(),
        };
        let j = serde_json::to_value(&a).unwrap();
        assert!(j["amount"].is_number(), "amount is a plain integer");
        assert_eq!(j["chain"], serde_json::json!("Base"));
        let dec: MbWithdraw = serde_json::from_value(j).unwrap();
        assert_eq!(a, dec);
    }
}