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
// Copyright (C) 2019-2023 Aleo Systems Inc.
// This file is part of the snarkOS library.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:
// http://www.apache.org/licenses/LICENSE-2.0
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use super::{CurrentNetwork, Developer};
use snarkvm::{
prelude::{ConsensusStore, Plaintext, PrivateKey, ProgramID, Query, Record, VM},
synthesizer::store::helpers::memory::ConsensusMemory,
};
use anyhow::Result;
use clap::Parser;
use colored::Colorize;
use std::str::FromStr;
/// Deploys an Aleo program.
#[derive(Debug, Parser)]
pub struct Deploy {
/// The name of the program to deploy.
program_id: ProgramID<CurrentNetwork>,
/// A path to a directory containing a manifest file. Defaults to the current working directory.
#[clap(long)]
path: Option<String>,
/// The private key used to generate the deployment.
#[clap(short, long)]
private_key: String,
/// The endpoint to query node state from.
#[clap(short, long)]
query: String,
/// The deployment fee in microcredits.
#[clap(short, long)]
fee: u64,
/// The record to spend the fee from.
#[clap(short, long)]
record: String,
/// Display the generated transaction.
#[clap(short, long, conflicts_with = "broadcast")]
display: bool,
/// The endpoint used to broadcast the generated transaction.
#[clap(short, long, conflicts_with = "display")]
broadcast: Option<String>,
/// Store generated deployment transaction to a local file.
#[clap(long)]
store: Option<String>,
}
impl Deploy {
/// Deploys an Aleo program.
pub fn parse(self) -> Result<String> {
// Specify the query
let query = Query::from(self.query);
// Retrieve the private key.
let private_key = PrivateKey::from_str(&self.private_key)?;
// Fetch the program from the directory.
let program = Developer::parse_program(self.program_id, self.path)?;
println!("📦 Creating deployment transaction for '{}'...\n", &self.program_id.to_string().bold());
// Generate the deployment transaction.
let deployment = {
// Initialize an RNG.
let rng = &mut rand::thread_rng();
// Initialize the VM.
let store = ConsensusStore::<CurrentNetwork, ConsensusMemory<CurrentNetwork>>::open(None)?;
let vm = VM::from(store)?;
// Prepare the fees.
let fee = (Record::<CurrentNetwork, Plaintext<CurrentNetwork>>::from_str(&self.record)?, self.fee);
// Create a new transaction.
vm.deploy(&private_key, &program, fee, Some(query), rng)?
};
println!("✅ Created deployment transaction for '{}'", self.program_id.to_string().bold());
// Determine if the transaction should be broadcast, stored, or displayed to user.
Developer::handle_transaction(self.broadcast, self.display, self.store, deployment, self.program_id.to_string())
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::commands::{Command, CLI};
#[test]
fn clap_snarkos_deploy() {
let arg_vec = vec![
"snarkos",
"developer",
"deploy",
"--private-key",
"PRIVATE_KEY",
"--query",
"QUERY",
"--fee",
"77",
"--record",
"RECORD",
"hello.aleo",
];
let cli = CLI::parse_from(arg_vec);
if let Command::Developer(Developer::Deploy(deploy)) = cli.command {
assert_eq!(deploy.program_id, "hello.aleo".try_into().unwrap());
assert_eq!(deploy.private_key, "PRIVATE_KEY");
assert_eq!(deploy.query, "QUERY");
assert_eq!(deploy.fee, 77);
assert_eq!(deploy.record, "RECORD");
} else {
panic!("Unexpected result of clap parsing!");
}
}
}