kucoin 0.7.4

A robust and asynchronous Rust client for the KuCoin exchange API.
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use base64::{engine::general_purpose::STANDARD, Engine};
use ethers::core::k256::sha2::Sha256;
use hmac::{self, Hmac, Mac};

/// Use API-Secret to encrypt the prehash string {timestamp+method+endpoint+body} with sha256 HMAC.
///
/// # Parameters
/// - api_secret: KC-API Secret key.
/// - timestamp : Must be consistent with the 'KC-API-TIMESTAMP' field in the request header.
/// - method    : HTTP-method in UPPER-CASE (POST, GET...).
/// - endpoint  : API-link.
/// - payload   : The request body is a JSON string and need to be the same with the parameters passed by the API.
///
/// # Returns
/// - Encoded prehash as base64
pub fn encrypt_prehash(
    api_secret: &str,
    timestamp: &str,
    method: &str,
    endpoint: &str,
    body: &str,
) -> String {
    // Initialize HMAC-sha256 with secret api key.
    let mut mac = Hmac::<Sha256>::new_from_slice(api_secret.as_bytes())
        .expect("Use API-Secret to encrypt the prehash");
    // Add prehash-string to be hashed.
    let prehash = format!("{}{}{}{}", timestamp, method, endpoint, body);
    mac.update(prehash.as_bytes());

    // Compute HMAC & encode it as base64
    let result = mac.finalize();
    let sign = result.into_bytes();
    STANDARD.encode(sign)
}

/// Encrypt passphrase with HMAC-sha256 via API-Secret.
///
/// # Parameters
/// - api_secret: KC-API Secret key.
/// - passphrase: KC-pass.
///
/// # Returns
/// - Encrypted passcode as base64.
pub fn encrypt_pass(api_secret: String, passphrase: String) -> String {
    // Initialize HMAC-sha256 with secret api key.
    let mut mac = Hmac::<Sha256>::new_from_slice(api_secret.as_bytes())
        .expect("Use API-Secret to encrypt the passphrase");
    // include prehash-string to be hashed.
    mac.update(passphrase.as_bytes());

    // Compute HMAC & encode it as base64
    let result = mac.finalize();
    let sign = result.into_bytes();
    STANDARD.encode(sign)
}

#[cfg(test)]
mod test {
    use super::*;
    use std::time::SystemTime;
    use std::time::UNIX_EPOCH;

    #[test]
    fn test_hmac() {
        // Setup data needed to generate HMAC-SHA256
        let timestamp = SystemTime::now()
            .duration_since(UNIX_EPOCH)
            .expect("Clock may have gone backwards")
            .as_millis()
            .to_string();
        let payload = r#"{"clientOid": "235b7471-0190-4e10-a4cf-953c83a06af5", "side": "sell", "symbol": "ETH-USDT", "type": "market", "isIsolated": false, "funds": "1"}"#;

        // Generate encode 64 sign msg
        let en64_sign = encrypt_prehash(
            "1a422807-19f5-4e8f-9135-b89707845621",
            &timestamp,
            "POST",
            "/api/v3/hf/margin/order",
            payload,
        );

        println!("{}", en64_sign);
    }

    #[test]
    fn test_passphrase() {
        let _passphrase = "910988".to_string();
        let en64_pass = encrypt_pass(
            "1a922807-19f5-4e6c-9135-b89707845621".to_string(),
            _passphrase,
        );
        println!("{}", en64_pass);
    }
}