nautilus_hyperliquid/signing/types.rs
1// -------------------------------------------------------------------------------------------------
2// Copyright (C) 2015-2026 Nautech Systems Pty Ltd. All rights reserved.
3// https://nautechsystems.io
4//
5// Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6// You may not use this file except in compliance with the License.
7// You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16use std::fmt::Display;
17
18use serde::{Deserialize, Serialize};
19
20/// Unique identifier for a signer (API wallet or user address).
21#[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)]
22pub struct SignerId(pub String);
23
24impl Display for SignerId {
25 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
26 write!(f, "{}", self.0)
27 }
28}
29
30impl From<String> for SignerId {
31 fn from(value: String) -> Self {
32 Self(value)
33 }
34}
35
36impl From<&str> for SignerId {
37 fn from(value: &str) -> Self {
38 Self(value.to_string())
39 }
40}
41
42/// Hyperliquid action types for different signing schemes.
43#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
44pub enum HyperliquidActionType {
45 /// L1 actions (agent deposits, withdrawals) - signed with L1 scheme.
46 L1,
47 /// User actions (trading) - signed with user-signed scheme.
48 UserSigned,
49}