Expose post to support relaying signed actions

Cargo.toml

@@ -13,9 +13,9 @@ repository = "https://github.com/hyperliquid-dex/hyperliquid-rust-sdk"
 
 [dependencies]
 alloy = { version = "1.0", default-features = false, features = [
-  "dyn-abi",
-  "sol-types",
-  "signer-local",
+    "dyn-abi",
+    "sol-types",
+    "signer-local",
 ] }
 chrono = "0.4.26"
 env_logger = "0.11.8"
@@ -24,9 +24,9 @@ lazy_static = "1.0"
 log = "0.4.19"
 reqwest = "0.12.19"
 serde = { version = "1.0", features = ["derive"] }
-serde_json = "1.0"
+serde_json = { version = "1.0", features = ["preserve_order"] }
 rmp-serde = "1.0"
 thiserror = "2.0"
 tokio = { version = "1.0", features = ["full"] }
-tokio-tungstenite = { version = "0.20.0", features = ["native-tls"] }
+tokio-tungstenite = { version = "0.28.0", features = ["native-tls"] }
 uuid = { version = "1.0", features = ["v4"] }

src/bin/agent.rs

@@ -1,5 +1,7 @@
 use alloy::signers::local::PrivateKeySigner;
-use hyperliquid_rust_sdk::{BaseUrl, ClientLimit, ClientOrder, ClientOrderRequest, ExchangeClient};
+use hyperliquid_rust_sdk::{
+    ClientLimit, ClientOrder, ClientOrderRequest, ExchangeClient, HyperliquidChain,
+};
 use log::info;
 
 #[tokio::main]
@@ -11,9 +13,10 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     /*
         Create a new wallet with the agent.
@@ -27,9 +30,10 @@ async fn main() {
 
     info!("Agent address: {:?}", wallet.address());
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     let order = ClientOrderRequest {
         asset: "ETH".to_string(),

src/bin/approve_builder_fee.rs

@@ -1,5 +1,5 @@
 use alloy::{primitives::address, signers::local::PrivateKeySigner};
-use hyperliquid_rust_sdk::{BaseUrl, ExchangeClient};
+use hyperliquid_rust_sdk::{ExchangeClient, HyperliquidChain};
 use log::info;
 
 #[tokio::main]
@@ -11,10 +11,15 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client =
-        ExchangeClient::new(None, wallet.clone(), Some(BaseUrl::Testnet), None, None)
-            .await
-            .unwrap();
+    let exchange_client = ExchangeClient::new(
+        None,
+        wallet.clone(),
+        Some(HyperliquidChain::Testnet),
+        None,
+        None,
+    )
+    .await
+    .unwrap();
 
     let max_fee_rate = "0.1%";
     let builder = address!("0x1ab189B7801140900C711E458212F9c76F8dAC79");

src/bin/bridge_withdraw.rs

@@ -1,5 +1,5 @@
 use alloy::signers::local::PrivateKeySigner;
-use hyperliquid_rust_sdk::{BaseUrl, ExchangeClient};
+use hyperliquid_rust_sdk::{ExchangeClient, HyperliquidChain};
 use log::info;
 
 #[tokio::main]
@@ -11,9 +11,10 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     let usd = "5"; // 5 USD
     let destination = "0x0D1d9635D0640821d15e323ac8AdADfA9c111414";

src/bin/claim_rewards.rs

@@ -1,5 +1,5 @@
 use alloy::signers::local::PrivateKeySigner;
-use hyperliquid_rust_sdk::{BaseUrl, ExchangeClient, ExchangeResponseStatus};
+use hyperliquid_rust_sdk::{ExchangeClient, ExchangeResponseStatus, HyperliquidChain};
 use log::info;
 
 #[tokio::main]
@@ -11,9 +11,10 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     let response = exchange_client.claim_rewards(None).await.unwrap();
 

src/bin/class_transfer.rs

@@ -1,5 +1,5 @@
 use alloy::signers::local::PrivateKeySigner;
-use hyperliquid_rust_sdk::{BaseUrl, ExchangeClient};
+use hyperliquid_rust_sdk::{ExchangeClient, HyperliquidChain};
 use log::info;
 
 #[tokio::main]
@@ -11,15 +11,16 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     let usdc = 1.0; // 1 USD
     let to_perp = false;
 
     let res = exchange_client
-        .class_transfer(usdc, to_perp, None)
+        .usd_class_transfer(usdc, to_perp, None)
         .await
         .unwrap();
     info!("Class transfer result: {res:?}");

src/bin/convert_to_multi_sig_user.rs

@@ -0,0 +1,102 @@
+use alloy::{primitives::Address, signers::local::PrivateKeySigner};
+use hyperliquid_rust_sdk::{ExchangeClient, HyperliquidChain};
+use log::info;
+
+async fn setup_exchange_client() -> (Address, ExchangeClient) {
+    // Key was randomly generated for testing and shouldn't be used with any real funds
+    let wallet: PrivateKeySigner =
+        "e908f86dbb4d55ac876378565aafeabc187f6690f046459397b17d9b9a19688e"
+            .parse()
+            .unwrap();
+
+    let address = wallet.address();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
+
+    (address, exchange_client)
+}
+
+#[tokio::main]
+async fn main() {
+    env_logger::init();
+
+    let (address, exchange_client) = setup_exchange_client().await;
+
+    // Ensure we're using the actual user's wallet, not an agent
+    if address != exchange_client.wallet.address() {
+        panic!("Agents do not have permission to convert to multi-sig user");
+    }
+
+    // Addresses that will be authorized to sign for the multi-sig account
+    let authorized_user_1: Address = "0x0000000000000000000000000000000000000000"
+        .parse()
+        .unwrap();
+    let authorized_user_2: Address = "0x0000000000000000000000000000000000000001"
+        .parse()
+        .unwrap();
+
+    // Threshold: minimum number of signatures required to execute any transaction
+    // This matches the Python example where threshold is 1
+    let threshold = 1;
+
+    info!("=== Convert to Multi-Sig User Example ===");
+    info!("Current user address: {}", address);
+    info!("Connected to: {:?}", exchange_client.http_client.chain);
+    info!("");
+    info!("Configuration:");
+    info!("  Authorized user 1: {}", authorized_user_1);
+    info!("  Authorized user 2: {}", authorized_user_2);
+    info!("  Threshold: {}", threshold);
+    info!("");
+
+    // Step 1: Convert the user to a multi-sig account
+    info!("Step 1: Converting to multi-sig account...");
+    match exchange_client.convert_to_multi_sig(threshold, None).await {
+        Ok(response) => {
+            info!("Convert to multi-sig response: {:?}", response);
+            info!("Successfully converted to multi-sig!");
+        }
+        Err(e) => {
+            info!("Convert to multi-sig failed (this is expected if already converted or on testnet): {}", e);
+        }
+    }
+
+    // Step 2: Add authorized addresses
+    info!("Step 2: Adding authorized addresses...");
+    match exchange_client
+        .update_multi_sig_addresses(
+            vec![authorized_user_1, authorized_user_2],
+            vec![], // No addresses to remove
+            None,
+        )
+        .await
+    {
+        Ok(response) => {
+            info!("Update multi-sig addresses response: {:?}", response);
+            info!("Successfully added authorized addresses!");
+        }
+        Err(e) => {
+            info!("Update multi-sig addresses failed: {}", e);
+        }
+    }
+
+    info!("");
+    info!("Multi-sig setup complete!");
+    info!("Now you can use the multi-sig methods with the authorized wallets:");
+    info!("- multi_sig_order()");
+    info!("- multi_sig_usdc_transfer()");
+    info!("- multi_sig_spot_transfer()");
+    info!("");
+    info!("IMPORTANT: After converting to multi-sig:");
+    info!("1. The account can only be controlled by the authorized addresses");
+    info!(
+        "2. You need {} signatures to execute any transaction",
+        threshold
+    );
+    info!("3. Make sure you have access to the authorized private keys!");
+    info!("4. This is a one-way conversion - test on testnet first!");
+
+    info!("Example completed - multi-sig conversion functionality demonstrated");
+}

src/bin/info.rs

@@ -1,13 +1,15 @@
 use alloy::primitives::Address;
-use hyperliquid_rust_sdk::{BaseUrl, InfoClient};
+use hyperliquid_rust_sdk::{HyperliquidChain, InfoClient};
 use log::info;
 
 const ADDRESS: &str = "0xc64cc00b46101bd40aa1c3121195e85c0b0918d8";
 
 #[tokio::main]
 async fn main() {
     env_logger::init();
-    let info_client = InfoClient::new(None, Some(BaseUrl::Testnet)).await.unwrap();
+    let info_client = InfoClient::new(None, Some(HyperliquidChain::Testnet))
+        .await
+        .unwrap();
     open_orders_example(&info_client).await;
     user_state_example(&info_client).await;
     user_states_example(&info_client).await;

src/bin/leverage.rs

@@ -1,5 +1,5 @@
 use alloy::signers::local::PrivateKeySigner;
-use hyperliquid_rust_sdk::{BaseUrl, ExchangeClient, InfoClient};
+use hyperliquid_rust_sdk::{ExchangeClient, HyperliquidChain, InfoClient};
 use log::info;
 
 #[tokio::main]
@@ -13,10 +13,13 @@ async fn main() {
             .unwrap();
 
     let address = wallet.address();
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
+    let info_client = InfoClient::new(None, Some(HyperliquidChain::Testnet))
         .await
         .unwrap();
-    let info_client = InfoClient::new(None, Some(BaseUrl::Testnet)).await.unwrap();
 
     let response = exchange_client
         .update_leverage(5, "ETH", false, None)

src/bin/market_order_and_cancel.rs

@@ -2,8 +2,8 @@ use std::{thread::sleep, time::Duration};
 
 use alloy::signers::local::PrivateKeySigner;
 use hyperliquid_rust_sdk::{
-    BaseUrl, ExchangeClient, ExchangeDataStatus, ExchangeResponseStatus, MarketCloseParams,
-    MarketOrderParams,
+    ExchangeClient, ExchangeDataStatus, ExchangeResponseStatus, HyperliquidChain,
+    MarketCloseParams, MarketOrderParams,
 };
 use log::info;
 
@@ -16,9 +16,10 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     // Market open order
     let market_open_params = MarketOrderParams {

src/bin/market_order_with_builder_and_cancel.rs

@@ -2,7 +2,7 @@ use std::{thread::sleep, time::Duration};
 
 use alloy::signers::local::PrivateKeySigner;
 use hyperliquid_rust_sdk::{
-    BaseUrl, BuilderInfo, ExchangeClient, ExchangeDataStatus, ExchangeResponseStatus,
+    BuilderInfo, ExchangeClient, ExchangeDataStatus, ExchangeResponseStatus, HyperliquidChain,
     MarketCloseParams, MarketOrderParams,
 };
 use log::info;
@@ -16,9 +16,10 @@ async fn main() {
             .parse()
             .unwrap();
 
-    let exchange_client = ExchangeClient::new(None, wallet, Some(BaseUrl::Testnet), None, None)
-        .await
-        .unwrap();
+    let exchange_client =
+        ExchangeClient::new(None, wallet, Some(HyperliquidChain::Testnet), None, None)
+            .await
+            .unwrap();
 
     // Market open order
     let market_open_params = MarketOrderParams {