ark-lib 0.1.0

Primitives for the Ark protocol and bark implementation
Documentation 
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

use std::str::FromStr;

use bitcoin::{Amount, OutPoint, Txid, TxIn, TxOut, Transaction, Witness, ScriptBuf, Sequence};
use bitcoin::absolute::LockTime;
use bitcoin::hashes::Hash;
use bitcoin::transaction::Version;
use bitcoin::secp256k1::Keypair;

use bitcoin_ext::{BlockHeight, BlockDelta};

use crate::Vtxo;
use crate::vtxo::Full;
use crate::board::BoardBuilder;

lazy_static! {
	pub static ref DUMMY_USER_KEY: Keypair = Keypair::from_str(
		"76f78cc00278817fe65fd81cb962782d2625834d08b66edbf2cd60f6c520db63",
	).unwrap();

	pub static ref DUMMY_SERVER_KEY: Keypair = Keypair::from_str(
		"f2a9eaeba1cdb8411dfda3c9ca391e4ad29938c4f0b9c0709376fc4a1cbf0e5d",
	).unwrap();
}

/// Just a utility to write unit tests
/// It can quickly create a vtxo that matches
/// some desired parameters
pub struct DummyTestVtxoSpec {
	pub amount: Amount,
	pub fee: Amount,
	pub expiry_height: BlockHeight,
	pub exit_delta: BlockDelta,
	pub user_keypair: Keypair,
	pub server_keypair: Keypair,
}

impl Default for DummyTestVtxoSpec {
	fn default() -> Self {
		Self {
			amount: Amount::ONE_BTC + Amount::from_btc(0.1).unwrap(),
			fee: Amount::from_btc(0.1).unwrap(),
			expiry_height: 10_000,
			exit_delta: 144,
			user_keypair: *DUMMY_USER_KEY,
			server_keypair: *DUMMY_SERVER_KEY,
		}
	}
}

impl DummyTestVtxoSpec {
	pub fn build(&self) -> (Transaction, Vtxo<Full>) {
		// The board-builder that is used by the user
		let user_builder = BoardBuilder::new(
			self.user_keypair.public_key(),
			self.expiry_height,
			self.server_keypair.public_key(),
			self.exit_delta,
		);

		let funding_tx = Transaction {
			version: Version(3),
			lock_time: LockTime::ZERO,
			input: vec![TxIn {
				previous_output: OutPoint::null(),
				script_sig: ScriptBuf::new(),
				sequence: Sequence::ZERO,
				witness: Witness::new(),
			}],
			output: vec![
				TxOut {
					value: self.amount,
					script_pubkey: user_builder.funding_script_pubkey(),
				}
			],
		};

		let funding_outpoint = OutPoint::new(funding_tx.compute_txid(), 0);

		let user_builder = user_builder
			.set_funding_details(self.amount, self.fee, funding_outpoint).unwrap()
			.generate_user_nonces();

		let user_pub_nonce = user_builder.user_pub_nonce();

		// The server builder
		let server_builder = BoardBuilder::new_for_cosign(
			self.user_keypair.public_key(),
			self.expiry_height,
			self.server_keypair.public_key(),
			self.exit_delta,
			self.amount,
			self.fee,
			funding_outpoint,
			*user_pub_nonce,
		);

		let server_cosign_response = server_builder.server_cosign(&self.server_keypair);

		let vtxo = user_builder.build_vtxo(&server_cosign_response, &self.user_keypair).unwrap();
		(funding_tx, vtxo)
	}
}

pub fn random_utxo() -> OutPoint {
	OutPoint::new(Txid::from_byte_array(rand::random()), rand::random())
}

#[test]
fn create_dummy_output() {
	let board = DummyTestVtxoSpec {
		amount: Amount::from_sat(1_330),
		fee: Amount::from_sat(330),
		expiry_height: 100000,
		exit_delta: 1000,
		user_keypair: Keypair::new(&crate::SECP, &mut bitcoin::secp256k1::rand::thread_rng()),
		server_keypair: Keypair::new(&crate::SECP, &mut bitcoin::secp256k1::rand::thread_rng()),
	};

	board.build();
}

#[test]
fn default_dummy_vtxo() {
	DummyTestVtxoSpec::default().build();
}