Struct Hash

pub struct Hash(/* private fields */);

A SHA-256 hash, most commonly used for blockhashes.

Args: hash_bytes (bytes): the hashed bytes.

Implementations

impl Hash

pub const LENGTH: usize = 32usize

pub fn new(hash_bytes: [u8; 32]) -> Self

pub fn new_from_string(s: &str) -> PyResult<Self>

Create a Hash from a base-58 string.

Args: s (str): The base-58 encoded string

Returns: Hash: a Hash object.

Example:

>>> from solders.hash import Hash
>>> Hash.from_string("4uQeVj5tqViQh7yWWGStvkEG1Zmhx6uasJtWCJziofM")
Hash(
    4uQeVj5tqViQh7yWWGStvkEG1Zmhx6uasJtWCJziofM,
)

pub fn new_unique() -> Self

Create a unique Hash for tests and benchmarks.

Returns: Hash: a Hash object.

pub fn new_default() -> Self

The default Hash object.

Returns: Hash: a Hash object. Example: >>> from solders.hash import Hash >>> Hash.default() Hash( 11111111111111111111111111111111, )

pub fn hash(val: &[u8]) -> Self

Return a Sha256 hash for the given data.

Args: val (bytes): the data to hash.

Returns: Hash: a Hash object.

Example: >>> from solders.hash import Hash >>> Hash.hash(b“foo“) Hash( 3yMApqCuCjXDWPrbjfR5mjCPTHqFG8Pux1TxQrEM35jj, )

pub fn from_bytes(raw_bytes: [u8; 32]) -> PyResult<Self>

Construct from bytes. Equivalent to Hash.__init__ but included for the sake of consistency.

Args: raw_bytes (bytes): the hashed bytes.

Returns: Hash: a Hash object.

pub fn __hash__(&self) -> u64

pub fn __richcmp__(&self, other: &Self, op: CompareOp) -> bool

pub fn __bytes__<'a>(&self, py: Python<'a>) -> &'a PyBytes

pub fn __str__(&self) -> String

pub fn __repr__(&self) -> String

pub fn __reduce__(&self) -> PyResult<(PyObject, PyObject)>

pub fn to_json(&self) -> String

Convert to a JSON string.

pub fn from_json(raw: &str) -> PyResult<Self>

Build from a JSON string.

Trait Implementations

impl AsRef<[u8]> for Hash

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<Hash> for Hash

fn as_ref(&self) -> &HashOriginal

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Hash

fn clone(&self) -> Hash

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CommonMethods<'_> for Hash

fn py_to_json(&self) -> String

fn py_from_json(raw: &'a str) -> Result<Self, PyErr>

impl CommonMethodsCore for Hash

fn pybytes<'b>(&self, py: Python<'b>) -> &'b PyBytes

fn pystr(&self) -> String

fn pyrepr(&self) -> String

fn py_from_bytes(raw: &[u8]) -> Result<Self, PyErr>

fn pyreduce(&self) -> Result<(Py<PyAny>, Py<PyAny>), PyErr>

impl Debug for Hash

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Hash

fn default() -> Hash

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Hash

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Hash

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Hash> for Hash

fn from(original: HashOriginal) -> Hash

Converts to this type from the input type.

impl From<Hash> for Hash

fn from(original: Hash) -> Self

Converts to this type from the input type.

impl FromStr for Hash

type Err = ParseHashError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Hash

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoPy<Py<PyAny>> for Hash

fn into_py(self, py: Python<'_>) -> PyObject

Performs the conversion.

impl Ord for Hash

fn cmp(&self, other: &Hash) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Hash

fn eq(&self, other: &Hash) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Hash

fn partial_cmp(&self, other: &Hash) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PyBytesGeneral for Hash

fn pybytes_general<'a>(&self, py: Python<'a>) -> &'a PyBytes

impl PyBytesSlice for Hash

fn pybytes_slice<'a>(&self, py: Python<'a>) -> &'a PyBytes

impl PyClass for Hash

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for Hash

const IS_BASETYPE: bool = true

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<Hash>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature<Hash> for PyClassImplCollector<Hash>

fn new_text_signature(self) -> Option<&'static str>

impl PyFromBytesGeneral for Hash

fn py_from_bytes_general(raw: &[u8]) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a Hash

type Holder = Option<PyRef<'py, Hash>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a mut Hash

type Holder = Option<PyRefMut<'py, Hash>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl PyHash for Hash

fn pyhash(&self) -> u64

impl PyMethods<Hash> for PyClassImplCollector<Hash>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for Hash

const NAME: &'static str = "Hash"

Class name.

const MODULE: Option<&'static str>

Module name, if any.

type AsRefTarget = PyCell<Hash>

Utility type to make Py::as_ref work.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> &PyType

Returns the safe abstraction over the type object.

fn is_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type.

impl RichcmpFull for Hash

fn richcmp(&self, other: &Self, op: CompareOp) -> bool

impl Serialize for Hash

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Hash

impl Eq for Hash

impl StructuralPartialEq for Hash