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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
use crate::{
Block,
Ciphertext,
InnerPublicVariables,
OuterPublicVariables,
PoSWScheme,
Program,
ProgramPublicVariables,
};
use snarkvm_algorithms::{crypto_hash::PoseidonDefaultParametersField, merkle_tree::MerklePath, prelude::*};
use snarkvm_curves::{AffineCurve, PairingEngine, ProjectiveCurve, TwistedEdwardsParameters};
use snarkvm_fields::{Field, PrimeField, ToConstraintField};
use snarkvm_gadgets::{
traits::algorithms::{CRHGadget, EncryptionGadget, PRFGadget, SignatureGadget},
FpGadget,
GroupGadget,
MaskedCRHGadget,
SNARKVerifierGadget,
};
use snarkvm_utilities::{
fmt::{Debug, Display},
hash::Hash,
FromBytes,
ToBytes,
ToMinimalBits,
UniformRand,
};
use anyhow::Result;
use rand::{CryptoRng, Rng};
use serde::{de::DeserializeOwned, Serialize};
use std::{borrow::Borrow, cell::RefCell, ops::Deref, rc::Rc, str::FromStr};
pub trait Bech32Locator<F: Field>:
From<F>
+ Borrow<F>
+ Deref<Target = F>
+ ToConstraintField<F>
+ Into<Vec<F>>
+ UniformRand
+ Copy
+ Clone
+ Default
+ Debug
+ Display
+ FromStr
+ ToBytes
+ FromBytes
+ Serialize
+ DeserializeOwned
+ PartialEq
+ Eq
+ Hash
+ Sync
+ Send
{
fn prefix() -> String;
fn data_size_in_bytes() -> usize;
fn data_string_length() -> usize;
}
pub trait Bech32Object<T: Clone + Debug + ToBytes + FromBytes + PartialEq + Eq + Sync + Send>:
From<T>
+ Borrow<T>
+ Deref<Target = T>
+ Clone
+ Debug
+ Display
+ ToBytes
+ FromBytes
+ PartialEq
+ Eq
+ Serialize
+ DeserializeOwned
+ Sync
+ Send
{
fn prefix() -> String;
fn size_in_bytes() -> usize;
}
#[rustfmt::skip]
pub trait Network: 'static + Copy + Clone + Debug + Default + PartialEq + Eq + Serialize + DeserializeOwned + Send + Sync {
const NETWORK_ID: u16;
const NETWORK_NAME: &'static str;
const NUM_INPUT_RECORDS: usize;
const NUM_OUTPUT_RECORDS: usize;
const NUM_TOTAL_RECORDS: usize = Self::NUM_INPUT_RECORDS + Self::NUM_OUTPUT_RECORDS;
const NUM_TRANSITIONS: u8;
const NUM_EVENTS: u16;
const BLOCK_HASH_PREFIX: u16;
const LEDGER_ROOT_PREFIX: u16;
const PROGRAM_ID_PREFIX: u16;
const TRANSITION_ID_PREFIX: u16;
const TRANSACTION_ID_PREFIX: u16;
const COMMITMENT_PREFIX: u16;
const FUNCTION_INPUTS_HASH_PREFIX: u16;
const FUNCTION_ID_PREFIX: u16;
const HEADER_NONCE_PREFIX: u16;
const HEADER_ROOT_PREFIX: u16;
const HEADER_TRANSACTIONS_ROOT_PREFIX: u16;
const INNER_CIRCUIT_ID_PREFIX: u16;
const RECORD_RANDOMIZER_PREFIX: u16;
const RECORD_VIEW_KEY_COMMITMENT_PREFIX: u16;
const SERIAL_NUMBER_PREFIX: u16;
const HEADER_PROOF_PREFIX: u32;
const INNER_PROOF_PREFIX: u32;
const OUTER_PROOF_PREFIX: u32;
const PROGRAM_PROOF_PREFIX: u32;
const RECORD_CIPHERTEXT_PREFIX: u32;
const RECORD_VIEW_KEY_PREFIX: u32;
const SIGNATURE_PREFIX: u32;
const ADDRESS_SIZE_IN_BYTES: usize;
const HEADER_SIZE_IN_BYTES: usize;
const HEADER_PROOF_SIZE_IN_BYTES: usize;
const INNER_PROOF_SIZE_IN_BYTES: usize;
const OUTER_PROOF_SIZE_IN_BYTES: usize;
const PROGRAM_PROOF_SIZE_IN_BYTES: usize;
const RECORD_SIZE_IN_BYTES: usize;
const RECORD_CIPHERTEXT_SIZE_IN_BYTES: usize;
const RECORD_PAYLOAD_SIZE_IN_BYTES: usize;
const RECORD_VIEW_KEY_SIZE_IN_BYTES: usize;
const SIGNATURE_SIZE_IN_BYTES: usize;
const HEADER_TRANSACTIONS_TREE_DEPTH: usize;
const HEADER_TREE_DEPTH: usize;
const LEDGER_TREE_DEPTH: usize;
const PROGRAM_TREE_DEPTH: usize;
const TRANSITION_TREE_DEPTH: usize;
const TRANSACTION_TREE_DEPTH: usize;
const ALEO_BLOCK_TIME_IN_SECS: i64;
const ALEO_STARTING_SUPPLY_IN_CREDITS: i64;
const ALEO_FUTURE_TIME_LIMIT_IN_SECS: i64;
const ALEO_MAXIMUM_FORK_DEPTH: u32;
type InnerCurve: PairingEngine<Fr = Self::InnerScalarField, Fq = Self::OuterScalarField>;
type InnerScalarField: PrimeField + PoseidonDefaultParametersField;
type OuterCurve: PairingEngine;
type OuterBaseField: PrimeField;
type OuterScalarField: PrimeField + PoseidonDefaultParametersField;
type ProgramAffineCurve: AffineCurve<BaseField = Self::ProgramBaseField>;
type ProgramAffineCurveGadget: GroupGadget<Self::ProgramAffineCurve, Self::InnerScalarField>;
type ProgramProjectiveCurve: ProjectiveCurve<BaseField = Self::ProgramBaseField>;
type ProgramCurveParameters: TwistedEdwardsParameters;
type ProgramBaseField: PrimeField;
type ProgramScalarField: PrimeField;
type InnerSNARK: SNARK<ScalarField = Self::InnerScalarField, BaseField = Self::OuterScalarField, VerifierInput = InnerPublicVariables<Self>>;
type InnerSNARKGadget: SNARKVerifierGadget<Self::InnerSNARK>;
type InnerProof: Bech32Object<<Self::InnerSNARK as SNARK>::Proof>;
type OuterSNARK: SNARK<ScalarField = Self::OuterScalarField, BaseField = Self::OuterBaseField, VerifierInput = OuterPublicVariables<Self>>;
type OuterProof: Bech32Object<<Self::OuterSNARK as SNARK>::Proof>;
type ProgramSNARK: SNARK<ScalarField = Self::InnerScalarField, BaseField = Self::OuterScalarField, VerifierInput = ProgramPublicVariables<Self>, ProvingKey = Self::ProgramProvingKey, VerifyingKey = Self::ProgramVerifyingKey, UniversalSetupConfig = usize>;
type ProgramSNARKGadget: SNARKVerifierGadget<Self::ProgramSNARK>;
type ProgramProvingKey: Clone + ToBytes + FromBytes + Send + Sync;
type ProgramVerifyingKey: ToConstraintField<Self::OuterScalarField> + Clone + ToBytes + FromBytes + ToMinimalBits + Send + Sync;
type ProgramProof: Bech32Object<<Self::ProgramSNARK as SNARK>::Proof>;
type PoSWSNARK: SNARK<ScalarField = Self::InnerScalarField, BaseField = Self::OuterScalarField, VerifierInput = Vec<Self::InnerScalarField>, UniversalSetupConfig = usize>;
type PoSWProof: Bech32Object<<Self::PoSWSNARK as SNARK>::Proof>;
type PoSW: PoSWScheme<Self>;
type AccountEncryptionScheme: EncryptionScheme<PrivateKey = Self::ProgramScalarField, PublicKey = Self::ProgramAffineCurve, CiphertextRandomizer = Self::ProgramBaseField, SymmetricKeyCommitment = Self::ProgramBaseField>;
type AccountEncryptionGadget: EncryptionGadget<Self::AccountEncryptionScheme, Self::InnerScalarField>;
type AccountSeedPRF: PRF<Input = Vec<Self::ProgramScalarField>, Seed = Self::AccountSeed, Output = Self::ProgramScalarField>;
type AccountSeed: FromBytes + ToBytes + PartialEq + Eq + Clone + Default + Debug + UniformRand;
type AccountSignatureScheme: SignatureScheme<PrivateKey = (Self::ProgramScalarField, Self::ProgramScalarField), PublicKey = Self::ProgramAffineCurve>
+ SignatureSchemeOperations<AffineCurve = Self::ProgramAffineCurve, BaseField = Self::ProgramBaseField, ScalarField = Self::ProgramScalarField, Signature = <Self::AccountSignatureScheme as SignatureScheme>::Signature>;
type AccountSignatureGadget: SignatureGadget<Self::AccountSignatureScheme, Self::InnerScalarField>;
type AccountSignaturePublicKey: ToConstraintField<Self::InnerScalarField> + Clone + Default + Debug + Display + ToBytes + FromBytes + PartialEq + Eq + Hash + Sync + Send;
type AccountSignature: Bech32Object<<Self::AccountSignatureScheme as SignatureScheme>::Signature>;
type BlockHashCRH: CRH<Output = Self::InnerScalarField>;
type BlockHashCRHGadget: CRHGadget<Self::BlockHashCRH, Self::InnerScalarField>;
type BlockHash: Bech32Locator<<Self::BlockHashCRH as CRH>::Output>;
type BlockHeaderRootCRH: CRH<Output = Self::InnerScalarField>;
type BlockHeaderRootCRHGadget: MaskedCRHGadget<<Self::BlockHeaderRootParameters as MerkleParameters>::H, Self::InnerScalarField, OutputGadget = <Self::PoSWMaskPRFGadget as PRFGadget<Self::PoSWMaskPRF, Self::InnerScalarField>>::Seed>;
type BlockHeaderRootParameters: MaskedMerkleParameters<H = Self::BlockHeaderRootCRH>;
type BlockHeaderRoot: Bech32Locator<<Self::BlockHeaderRootCRH as CRH>::Output>;
type CommitmentScheme: CRH<Output = Self::InnerScalarField>;
type CommitmentGadget: CRHGadget<Self::CommitmentScheme, Self::InnerScalarField>;
type Commitment: Bech32Locator<<Self::CommitmentScheme as CRH>::Output>;
type FunctionIDCRH: CRH<Output = Self::OuterScalarField>;
type FunctionIDCRHGadget: CRHGadget<Self::FunctionIDCRH, Self::OuterScalarField>;
type FunctionID: Bech32Locator<<Self::FunctionIDCRH as CRH>::Output>;
type FunctionInputsCRH: CRH<Output = Self::InnerScalarField>;
type FunctionInputsCRHGadget: CRHGadget<Self::FunctionInputsCRH, Self::InnerScalarField>;
type FunctionInputsHash: Bech32Locator<<Self::FunctionInputsCRH as CRH>::Output>;
type InnerCircuitIDCRH: CRH<Output = Self::OuterScalarField>;
type InnerCircuitIDCRHGadget: CRHGadget<Self::InnerCircuitIDCRH, Self::OuterScalarField>;
type InnerCircuitID: Bech32Locator<<Self::InnerCircuitIDCRH as CRH>::Output>;
type LedgerRootCRH: CRH<Output = Self::InnerScalarField>;
type LedgerRootCRHGadget: CRHGadget<Self::LedgerRootCRH, Self::InnerScalarField>;
type LedgerRootParameters: MerkleParameters<H = Self::LedgerRootCRH>;
type LedgerRoot: Bech32Locator<<Self::LedgerRootCRH as CRH>::Output>;
type PoSWMaskPRF: PRF<Input = Vec<Self::InnerScalarField>, Seed = Self::InnerScalarField, Output = Self::InnerScalarField>;
type PoSWMaskPRFGadget: PRFGadget<Self::PoSWMaskPRF, Self::InnerScalarField>;
type PoSWNonce: Bech32Locator<Self::InnerScalarField>;
type ProgramIDCRH: CRH<Output = Self::OuterScalarField>;
type ProgramIDCRHGadget: CRHGadget<Self::ProgramIDCRH, Self::OuterScalarField>;
type ProgramIDParameters: MerkleParameters<H = Self::ProgramIDCRH>;
type ProgramID: Bech32Locator<<Self::ProgramIDCRH as CRH>::Output>;
type RecordCiphertext: Bech32Object<Ciphertext<Self>> + Hash;
type RecordRandomizer: Bech32Locator<<Self::AccountEncryptionScheme as EncryptionScheme>::CiphertextRandomizer>;
type RecordViewKey: Bech32Object<<Self::AccountEncryptionScheme as EncryptionScheme>::SymmetricKey> + Default;
type RecordViewKeyCommitment: Bech32Locator<<Self::AccountEncryptionScheme as EncryptionScheme>::SymmetricKeyCommitment>;
type SerialNumberPRF: PRF<Input = Vec<<Self::CommitmentScheme as CRH>::Output>, Seed = Self::InnerScalarField, Output = Self::InnerScalarField>;
type SerialNumberPRFGadget: PRFGadget<
Self::SerialNumberPRF,
Self::InnerScalarField,
Seed = FpGadget<Self::InnerScalarField>,
Input = Vec<<Self::CommitmentGadget as CRHGadget<Self::CommitmentScheme, Self::InnerScalarField>>::OutputGadget>
>;
type SerialNumber: Bech32Locator<<Self::SerialNumberPRF as PRF>::Output>;
type TransactionsRootCRH: CRH<Output = Self::InnerScalarField>;
type TransactionsRootCRHGadget: CRHGadget<Self::TransactionsRootCRH, Self::InnerScalarField>;
type TransactionsRootParameters: MerkleParameters<H = Self::TransactionsRootCRH>;
type TransactionsRoot: Bech32Locator<<Self::TransactionsRootCRH as CRH>::Output>;
type TransactionIDCRH: CRH<Output = Self::InnerScalarField>;
type TransactionIDCRHGadget: CRHGadget<Self::TransactionIDCRH, Self::InnerScalarField>;
type TransactionIDParameters: MerkleParameters<H = Self::TransactionIDCRH>;
type TransactionID: Bech32Locator<<Self::TransactionIDCRH as CRH>::Output>;
type TransitionIDCRH: CRH<Output = Self::InnerScalarField>;
type TransitionIDCRHGadget: CRHGadget<Self::TransitionIDCRH, Self::InnerScalarField>;
type TransitionIDParameters: MerkleParameters<H = Self::TransitionIDCRH>;
type TransitionID: Bech32Locator<<Self::TransitionIDCRH as CRH>::Output>;
fn account_encryption_scheme() -> &'static Self::AccountEncryptionScheme;
fn account_signature_scheme() -> &'static Self::AccountSignatureScheme;
fn block_hash_crh() -> &'static Self::BlockHashCRH;
fn block_header_root_parameters() -> &'static Self::BlockHeaderRootParameters;
fn commitment_scheme() -> &'static Self::CommitmentScheme;
fn function_id_crh() -> &'static Self::FunctionIDCRH;
fn inner_circuit_id_crh() -> &'static Self::InnerCircuitIDCRH;
fn ledger_root_parameters() -> &'static Self::LedgerRootParameters;
fn program_id_parameters() -> &'static Self::ProgramIDParameters;
fn transactions_root_parameters() -> &'static Self::TransactionsRootParameters;
fn transaction_id_parameters() -> &'static Self::TransactionIDParameters;
fn transition_id_parameters() -> &'static Self::TransitionIDParameters;
fn inner_circuit_id() -> &'static Self::InnerCircuitID;
fn inner_proving_key() -> &'static <Self::InnerSNARK as SNARK>::ProvingKey;
fn inner_verifying_key() -> &'static <Self::InnerSNARK as SNARK>::VerifyingKey;
fn noop_program() -> &'static Program<Self>;
fn noop_program_id() -> &'static Self::ProgramID;
fn noop_program_path() -> &'static MerklePath<Self::ProgramIDParameters>;
fn noop_function_id() -> &'static Self::FunctionID;
fn noop_circuit_proving_key() -> &'static <Self::ProgramSNARK as SNARK>::ProvingKey;
fn noop_circuit_verifying_key() -> &'static <Self::ProgramSNARK as SNARK>::VerifyingKey;
fn outer_proving_key() -> &'static <Self::OuterSNARK as SNARK>::ProvingKey;
fn outer_verifying_key() -> &'static <Self::OuterSNARK as SNARK>::VerifyingKey;
fn posw_proving_key() -> &'static <Self::PoSWSNARK as SNARK>::ProvingKey;
fn posw_verifying_key() -> &'static <Self::PoSWSNARK as SNARK>::VerifyingKey;
fn posw() -> &'static Self::PoSW;
fn genesis_block() -> &'static Block<Self>;
fn function_id(
verifying_key: &<Self::ProgramSNARK as SNARK>::VerifyingKey,
) -> Result<Self::FunctionID> {
Ok(Self::function_id_crh().hash_bits(&verifying_key.to_minimal_bits())?.into())
}
fn program_srs<R: Rng + CryptoRng>(
rng: &mut R,
) -> Rc<RefCell<SRS<R, <Self::ProgramSNARK as SNARK>::UniversalSetupParameters>>>;
}