siwx-svm 0.3.1

Sign In with X
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

//! # siwx-svm — Solana verification for Sign-In with X
//!
//! Implements the CAIP-122 namespace profile for Solana:
//! - **Ed25519** signature verification
//!
//! # Quick start
//!
//! ```rust,no_run
//! use siwx::{SiwxMessage, Verifier};
//! use siwx_svm::Ed25519Verifier;
//!
//! # async fn run() -> Result<(), Box<dyn std::error::Error>> {
//! let message = SiwxMessage::new(
//!     "example.com",
//!     "GwAF45zjfyGzUbd3i3hXxzGeuchzEZXwpRYHZM5912F1",
//!     "https://example.com/login",
//!     "1",
//!     "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d",
//! )?;
//! let _text = Ed25519Verifier::format_message(&message);
//! // let pubkey: [u8; 32] = ...; // Ed25519 public key
//! // let sig_bytes: [u8; 64] = ...; // Ed25519 signature
//! // Ed25519Verifier::new(pubkey).verify(&message, &sig_bytes).await?;
//! # Ok(())
//! # }
//! ```

mod ed25519;

pub use ed25519::Ed25519Verifier;
use siwx::SiwxError;

/// Human-readable chain label embedded in the CAIP-122 preamble.
pub const CHAIN_NAME: &str = "Solana";

/// Validate that `address` is a valid base58-encoded Solana public key (32
/// bytes decoded).
///
/// # Errors
///
/// Returns [`SiwxError::InvalidAddress`] if the format is wrong.
pub fn validate_address(address: &str) -> Result<(), SiwxError> {
    let bytes = bs58::decode(address)
        .into_vec()
        .map_err(|e| SiwxError::InvalidAddress(format!("invalid base58: {e}")))?;
    if bytes.len() != 32 {
        return Err(SiwxError::InvalidAddress(format!(
            "expected 32 bytes, got {}",
            bytes.len()
        )));
    }
    Ok(())
}

#[cfg(test)]
mod tests {
    use siwx::{SiwxMessage, Verifier};

    use super::*;

    #[test]
    fn validate_address_accepts_canonical_formats() {
        assert!(validate_address("11111111111111111111111111111111").is_ok());
        assert!(validate_address("GwAF45zjfyGzUbd3i3hXxzGeuchzEZXwpRYHZM5912F1").is_ok());
    }

    #[test]
    fn validate_address_rejects_bad_formats() {
        assert!(validate_address("not-valid").is_err());
        assert!(validate_address("").is_err());
    }

    #[test]
    fn format_message_uses_solana_preamble() {
        let msg = SiwxMessage::new(
            "example.com",
            "GwAF45zjfyGzUbd3i3hXxzGeuchzEZXwpRYHZM5912F1",
            "https://example.com",
            "1",
            "1",
        )
        .expect("valid");
        let text = Ed25519Verifier::format_message(&msg);
        assert!(text.starts_with("example.com wants you to sign in with your Solana account:"));
    }
}