      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
     95
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130

    use std::io::{self, Read, Write};
    use std::io::ErrorKind::InvalidData;

    use crypto::ed25519;
    use public_key::{CryptoSystem, KeyPair};
    use rand::{self, Rng};

    pub static ED25519: CryptoSystem = CryptoSystem {
        id: "ed25519",
        generate_key_pair: Ed25519KeyPair::generate,
        import: Ed25519KeyPair::import,
        read_public: Ed25519KeyPair::read_public,
    };

    struct Ed25519KeyPair {
        private: Option<[u8; 64]>,
        public: [u8; 32],
    }

    impl Ed25519KeyPair {
        fn generate(_: Option<u32>) -> Box<KeyPair> {
            let mut seed = [0u8; 32];
            let mut rng = rand::thread_rng();
            rng.fill_bytes(&mut seed);

            let (private, public) = ed25519::keypair(&seed);
            Box::new(Ed25519KeyPair {
                private: Some(private),
                public: public,
            })
        }

        fn import(mut r: &mut Read) -> io::Result<Box<KeyPair>> {
            use packet::ReadPacketExt;

            if r.read_utf8()? != "ssh-ed25519" {
                return Err(io::Error::new(InvalidData, "not a ED25519 key"));
            }

            if r.read_uint32()? != 32 {
                return Err(io::Error::new(InvalidData, "invalid ED25519 key"));
            }

            let mut public = [0u8; 32];
            r.read_exact(&mut public)?;

            if r.read_uint32()? != 64 {
                return Err(io::Error::new(InvalidData, "invalid ED25519 key"));
            }

            let mut private = [0u8; 64];
            r.read_exact(&mut private)?;

            Ok(Box::new(Ed25519KeyPair {
                public: public,
                private: Some(private),
            }))
        }

        fn read_public(mut r: &mut Read) -> io::Result<Box<KeyPair>> {
            use packet::ReadPacketExt;

            if r.read_uint32()? != 32 {
                return Err(io::Error::new(InvalidData, "invalid ED25519 key"));
            }

            let mut public = [0u8; 32];
            r.read_exact(&mut public)?;

            Ok(Box::new(Ed25519KeyPair {
                private: None,
                public: public,
            }))
        }
    }

    impl KeyPair for Ed25519KeyPair {
        fn system(&self) -> &'static CryptoSystem {
            &ED25519
        }

        fn has_private(&self) -> bool {
            self.private.is_some()
        }

        fn verify(&self, data: &[u8], signature: &[u8]) -> Result<bool, ()> {
            use packet::ReadPacketExt;
            use std::io::Cursor;

            let mut reader = Cursor::new(signature);
            let id = reader.read_string().unwrap_or(vec![]);

            if id == b"ssh-ed25519" {
                if let Ok(sig) = reader.read_string() {
                    return Ok(ed25519::verify(data, &self.public, sig.as_slice()));
                }
            }
            Err(())
        }

        fn sign(&self, data: &[u8]) -> Result<Vec<u8>, ()> {
            use packet::WritePacketExt;
            if let Some(private_key) = self.private {
                let mut result = Vec::new();
                let sig = ed25519::signature(data, &private_key);
                result.write_string("ssh-ed25519").or(Err(()))?;
                result.write_bytes(&sig).or(Err(()))?;
                Ok(result)
            }
            else {
                Err(())
            }
        }

        fn write_public(&self, w: &mut Write) -> io::Result<()> {
            use packet::WritePacketExt;
            w.write_string("ssh-ed25519")?;
            w.write_bytes(&self.public)
        }

        fn export(&self, w: &mut Write) -> io::Result<()> {
            use packet::WritePacketExt;
            w.write_string("ssh-ed25519")?;
            w.write_bytes(&self.public)?;
            if let Some(private_key) = self.private {
                w.write_bytes(&private_key)?;
            }
            Ok(())
        }
    }

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)