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

use crate::common::{
    crypto::signature::{signature_context_with_chain_separation, Signed},
    quantity::Quantity,
};

pub const SIGNATURE_CONTEXT: &[u8] = b"oasis-core/consensus: tx";

fn signature_context(chain_context: &String) -> Vec<u8> {
    let context = SIGNATURE_CONTEXT.to_vec();
    signature_context_with_chain_separation(context, chain_context)
}

/// Unsigned consensus transaction.
#[derive(Debug, cbor::Encode, cbor::Decode)]
#[cbor(no_default)]
pub struct Transaction {
    /// Nonce to prevent replay.
    pub nonce: u64,
    /// Optional fee that the sender commits to pay to execute this transaction.
    pub fee: Option<Fee>,

    /// Method that should be called.
    pub method: MethodName,
    /// Method call body.
    pub body: cbor::Value,
}

/// Signed consensus transaction.
pub type SignedTransaction = Signed;

impl SignedTransaction {
    /// Returns true iff the signature is valid.
    pub fn verify(&self, chain_context: &String) -> bool {
        let context = signature_context(chain_context);
        self.signature.verify(&context, &self.blob)
    }
}

/// Consensus transaction fee the sender wishes to pay for operations which
/// require a fee to be paid to validators.
#[derive(Debug, Default, cbor::Encode, cbor::Decode)]
pub struct Fee {
    /// Fee amount to be paid.
    pub amount: Quantity,
    /// Maximum gas that a transaction can use.
    pub gas: Gas,
}

/// Consensus gas representation.
pub type Gas = u64;

/// Method name.
pub type MethodName = String;

/// Proof of transaction inclusion in a block.
#[derive(Debug, Default, cbor::Encode, cbor::Decode)]
pub struct Proof {
    /// Block height at which the transaction was published.
    pub height: u64,
    /// Actual raw proof.
    pub raw_proof: Vec<u8>,
}

/// Signed consensus transaction with a proof of its inclusion in a block.
#[derive(Debug, Default, cbor::Encode, cbor::Decode)]
pub struct SignedTransactionWithProof {
    /// Signed transaction.
    pub signed_tx: SignedTransaction,
    /// Proof of transaction inclusion in a block.
    pub proof: Proof,
}