     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

    // Copyright 2015-2017 Brian Smith.
    //
    // Permission to use, copy, modify, and/or distribute this software for any
    // purpose with or without fee is hereby granted, provided that the above
    // copyright notice and this permission notice appear in all copies.
    //
    // THE SOFTWARE IS PROVIDED "AS IS" AND AND THE AUTHORS DISCLAIM ALL WARRANTIES
    // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
    // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
    // SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
    // OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
    // CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

    //! This module exists to make `signature_from_bytes()` public within the crate
    //! but private outside of the crate.

    use ec;

    /// A public key signature returned from a signing operation.
    pub struct Signature {
        value: [u8; MAX_LEN],
        len: usize,
    }

    impl AsRef<[u8]> for Signature {
        fn as_ref(&self) -> &[u8] { &self.value[..self.len] }
    }

    pub fn signature_from_bytes(bytes: &[u8]) -> Signature {
        let mut r = Signature {
           value: [0; MAX_LEN],
            len: bytes.len(),
        };
        r.value[..bytes.len()].copy_from_slice(bytes);
        r
    }

    /// The longest signature is an ASN.1 P-384 signature where *r* and *s* are of
    /// maximum length with the leading high bit set on each. Then each component
    /// will have a tag, a one-byte length, and a one-byte “I'm not negative”
    /// prefix, and the outer sequence will have a two-byte length.
    pub const MAX_LEN: usize = 1/*tag:SEQUENCE*/ + 2/*len*/ +
        (2 * (1/*tag:INTEGER*/ + 1/*len*/ + 1/*zero*/ + ec::SCALAR_MAX_BYTES));

# 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`)