Struct OutputWithDecoys 

pub struct OutputWithDecoys {
    output: OutputData,
    decoys: Decoys,
}

An output with decoys selected.

The Debug implementation may reveal every value within its memory.

Fields

output: OutputData

decoys: Decoys

Implementations

impl OutputWithDecoys

pub async fn new( rng: &mut (impl Send + Sync + RngCore + CryptoRng), rpc: &impl ProvidesDecoys, ring_len: u8, block_number: usize, output: WalletOutput, ) -> Result<OutputWithDecoys, TransactionsError>

Select decoys for this output.

The methodology used to sample decoys SHOULD prevent an RPC controlled by a passive adversary from discovering the output actually being spent. An RPC controlled by an active adversary, one who deliberately yields non-standard responses and provides a malicious view of the Monero blockchain, may still be able to identify the output being spent. For privacy, please only connect to trusted RPCs.

pub async fn fingerprintable_deterministic_new( rng: &mut (impl Send + Sync + RngCore + CryptoRng), rpc: &impl ProvidesDecoys, ring_len: u8, block_number: usize, output: WalletOutput, ) -> Result<OutputWithDecoys, TransactionsError>

Select a set of decoys for this output with a deterministic process.

This function will always output the same set of decoys when called with the same arguments. This makes it very useful in multisignature contexts, where instead of having one participant select the decoys, everyone can locally select the decoys while coming to the same result.

The set of decoys selected may be fingerprintable as having been produced by this methodology.

The methodology used to sample decoys SHOULD prevent an RPC controlled by a passive adversary from discovering the output actually being spent. An RPC controlled by an active adversary, one who deliberately yields non-standard responses and provides a malicious view of the Monero blockchain, may still be able to identify the output being spent. For privacy, please only connect to trusted RPCs.

pub fn key(&self) -> Point

The key this output may be spent by.

pub fn key_offset(&self) -> Scalar

The scalar to add to the private spend key for it to be the discrete logarithm of this output’s key.

pub fn commitment(&self) -> &Commitment

The commitment this output created.

pub fn decoys(&self) -> &Decoys

The decoys this output selected.

pub fn write<W: Write>(&self, w: &mut W) -> Result<()>

Write the OutputWithDecoys.

This is not a Monero protocol defined struct, and this is accordingly not a Monero protocol defined serialization. This may run in time variable to its value.

pub fn serialize(&self) -> Vec<u8>

Serialize the OutputWithDecoys to a Vec<u8>.

This is not a Monero protocol defined struct, and this is accordingly not a Monero protocol defined serialization. This may run in time variable to its value.

pub fn read<R: Read>(r: &mut R) -> Result<Self>

Read an OutputWithDecoys.

This is not a Monero protocol defined struct, and this is accordingly not a Monero protocol defined serialization. This may run in time variable to its value.

Trait Implementations

impl Clone for OutputWithDecoys

fn clone(&self) -> OutputWithDecoys

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutputWithDecoys

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

Formats the value using the given formatter.

impl Drop for OutputWithDecoys

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for OutputWithDecoys

#[doc(hidden)] fn assert_receiver_is_total_eq(&self)

impl PartialEq for OutputWithDecoys

fn eq(&self, other: &Self) -> 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 Zeroize for OutputWithDecoys

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl ZeroizeOnDrop for OutputWithDecoys