program / program-test / cli / js / client / confidential-transfer:Port from SPL

clients/cli/Cargo.toml

@@ -0,0 +1,61 @@
+[package]
+authors = ["Solana Labs Maintainers <[email protected]>"]
+description = "SPL-Token Command-line Utility"
+edition = "2021"
+homepage = "https://spl.solana.com/token"
+license = "Apache-2.0"
+name = "spl-token-cli"
+repository = "https://github.com/solana-labs/solana-program-library"
+version = "5.0.0"
+
+[build-dependencies]
+walkdir = "2"
+
+[dependencies]
+base64 = "0.22.1"
+clap = "3.2.23"
+console = "0.15.10"
+futures = "0.3"
+serde = "1.0.217"
+serde_derive = "1.0.103"
+serde_json = "1.0.135"
+solana-account-decoder = "2.1.0"
+solana-clap-v3-utils = "2.1.0"
+solana-cli-config = "2.1.0"
+solana-cli-output = "2.1.0"
+solana-client = "2.1.0"
+solana-logger = "2.1.0"
+solana-remote-wallet = "2.1.0"
+solana-sdk = "2.1.0"
+solana-transaction-status = "2.1.0"
+spl-associated-token-account-client = { version = "2.0.0", path = "../../associated-token-account/client" }
+spl-token = { version = "7.0", path = "../program", features = [
+  "no-entrypoint",
+] }
+spl-token-2022 = { version = "6.0.0", path = "../program-2022", features = [
+  "no-entrypoint",
+] }
+spl-token-client = { version = "0.13.0", path = "../client" }
+spl-token-confidential-transfer-proof-generation = { version = "0.2.0", path = "../confidential-transfer/proof-generation" }
+spl-token-metadata-interface = { version = "0.6.0", path = "../../token-metadata/interface" }
+spl-token-group-interface = { version = "0.5.0", path = "../../token-group/interface" }
+spl-memo = { version = "6.0", features = ["no-entrypoint"] }
+strum = "0.26"
+strum_macros = "0.26"
+tokio = "1.42"
+
+[dev-dependencies]
+solana-test-validator = "2.1.0"
+assert_cmd = "2.0.16"
+libtest-mimic = "0.8"
+serial_test = "3.2.0"
+tempfile = "3.14.0"
+
+[[bin]]
+name = "spl-token"
+path = "src/main.rs"
+
+[[test]]
+name = "command"
+path = "tests/command.rs"
+harness = false

clients/cli/README.md

@@ -0,0 +1,42 @@
+# SPL Token program command-line utility
+
+A basic command-line for creating and using SPL Tokens.  See <https://spl.solana.com/token> for more details
+
+## Build
+
+To build the CLI locally, simply run:
+
+```sh
+cargo build
+```
+
+## Testing
+
+The tests require locally built programs for Token, Token-2022, and Associated
+Token Account. To build these, you can run:
+
+```sh
+BUILD_DEPENDENT_PROGRAMS=1 cargo build
+```
+
+This method uses the local `build.rs` file, which can be error-prone, so alternatively,
+you can build the programs by running the following commands from this directory:
+
+```sh
+cargo build-sbf --manifest-path ../program/Cargo.toml
+cargo build-sbf --manifest-path ../program-2022/Cargo.toml
+cargo build-sbf --manifest-path ../../associated-token-account/program/Cargo.toml
+```
+
+After that, you can run the tests as any other Rust project:
+
+```sh
+cargo test
+```
+
+To run it locally you can do it like this:
+
+```sh
+cargo build --manifest-path token/cli/Cargo.toml
+target/debug/spl-token <command>
+```

clients/cli/build.rs

@@ -0,0 +1,79 @@
+extern crate walkdir;
+
+use {
+    std::{env, path::Path, process::Command},
+    walkdir::WalkDir,
+};
+
+fn rerun_if_changed(directory: &Path) {
+    let src = directory.join("src");
+    let files_in_src: Vec<_> = WalkDir::new(src)
+        .into_iter()
+        .map(|entry| entry.unwrap())
+        .filter(|entry| {
+            if !entry.file_type().is_file() {
+                return false;
+            }
+            true
+        })
+        .map(|f| f.path().to_str().unwrap().to_owned())
+        .collect();
+
+    for file in files_in_src {
+        if !Path::new(&file).is_file() {
+            panic!("{} is not a file", file);
+        }
+        println!("cargo:rerun-if-changed={}", file);
+    }
+    let toml = directory.join("Cargo.toml").to_str().unwrap().to_owned();
+    println!("cargo:rerun-if-changed={}", toml);
+}
+
+fn build_bpf(program_directory: &Path) {
+    let toml_file = program_directory.join("Cargo.toml");
+    let toml_file = format!("{}", toml_file.display());
+    let args = vec!["build-sbf", "--manifest-path", &toml_file];
+    let output = Command::new("cargo")
+        .args(&args)
+        .output()
+        .expect("Error running cargo build-sbf");
+    if let Ok(output_str) = std::str::from_utf8(&output.stdout) {
+        let subs = output_str.split('\n');
+        for sub in subs {
+            println!("cargo:warning=(not a warning) {}", sub);
+        }
+    }
+}
+
+fn main() {
+    let is_debug = env::var("DEBUG").map(|v| v == "true").unwrap_or(false);
+    let build_dependent_programs = env::var("BUILD_DEPENDENT_PROGRAMS")
+        .map(|v| v != "false" && v != "0")
+        .unwrap_or(false);
+    if is_debug && build_dependent_programs {
+        let cwd = env::current_dir().expect("Unable to get current working directory");
+        let spl_token_2022_dir = cwd
+            .parent()
+            .expect("Unable to get parent directory of current working dir")
+            .join("program-2022");
+        rerun_if_changed(&spl_token_2022_dir);
+        let spl_token_dir = cwd
+            .parent()
+            .expect("Unable to get parent directory of current working dir")
+            .join("program");
+        rerun_if_changed(&spl_token_dir);
+        let spl_associated_token_account_dir = cwd
+            .parent()
+            .expect("Unable to get parent directory of current working dir")
+            .parent()
+            .expect("Unable to get parent directory of current working dir")
+            .join("associated-token-account")
+            .join("program");
+        rerun_if_changed(&spl_associated_token_account_dir);
+
+        build_bpf(&spl_token_dir);
+        build_bpf(&spl_token_2022_dir);
+        build_bpf(&spl_associated_token_account_dir);
+    }
+    println!("cargo:rerun-if-changed=build.rs");
+}

clients/cli/examples/confidential-transfer.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+
+# Set whichever network you would like to test with
+# solana config set -ul
+
+program_id="TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+
+echo "Setup keypairs"
+solana-keygen new -o confidential-mint.json --no-bip39-passphrase
+solana-keygen new -o confidential-source.json --no-bip39-passphrase
+solana-keygen new -o confidential-destination.json --no-bip39-passphrase
+mint_pubkey=$(solana-keygen pubkey "confidential-mint.json")
+source_pubkey=$(solana-keygen pubkey "confidential-source.json")
+destination_pubkey=$(solana-keygen pubkey "confidential-destination.json")
+
+set -ex
+echo "Initializing mint"
+spl-token --program-id "$program_id" create-token confidential-mint.json --enable-confidential-transfers auto
+echo "Displaying"
+spl-token display "$mint_pubkey"
+read  -n 1 -p "..."
+
+echo "Setting up transfer accounts"
+spl-token create-account "$mint_pubkey" confidential-source.json
+spl-token configure-confidential-transfer-account --address "$source_pubkey"
+spl-token create-account "$mint_pubkey" confidential-destination.json
+spl-token configure-confidential-transfer-account --address "$destination_pubkey"
+spl-token mint "$mint_pubkey" 100 confidential-source.json
+
+echo "Displaying"
+spl-token display "$source_pubkey"
+read  -n 1 -p "..."
+
+echo "Depositing into confidential"
+spl-token deposit-confidential-tokens "$mint_pubkey" 100 --address "$source_pubkey"
+echo "Displaying"
+spl-token display "$source_pubkey"
+read  -n 1 -p "..."
+
+echo "Applying pending balances"
+spl-token apply-pending-balance --address "$source_pubkey"
+echo "Displaying"
+spl-token display "$source_pubkey"
+read  -n 1 -p "..."
+
+echo "Transferring 10"
+spl-token transfer "$mint_pubkey" 10 "$destination_pubkey" --from "$source_pubkey" --confidential
+echo "Displaying source"
+spl-token display "$source_pubkey"
+echo "Displaying destination"
+spl-token display "$destination_pubkey"
+read  -n 1 -p "..."
+
+echo "Applying balance on destination"
+spl-token apply-pending-balance --address "$destination_pubkey"
+echo "Displaying destination"
+spl-token display "$destination_pubkey"
+read  -n 1 -p "..."
+
+echo "Transferring 0"
+spl-token transfer "$mint_pubkey" 0 "$destination_pubkey" --from "$source_pubkey" --confidential
+echo "Displaying destination"
+spl-token display "$destination_pubkey"
+read  -n 1 -p "..."
+
+echo "Transferring 0 again"
+spl-token transfer "$mint_pubkey" 0 "$destination_pubkey" --from "$source_pubkey" --confidential
+echo "Displaying destination"
+spl-token display "$destination_pubkey"
+read  -n 1 -p "..."
+
+echo "Withdrawing 10 from destination"
+spl-token apply-pending-balance --address "$destination_pubkey"
+spl-token withdraw-confidential-tokens "$mint_pubkey" 10 --address "$destination_pubkey"
+echo "Displaying destination"
+spl-token display "$destination_pubkey"
+read  -n 1 -p "..."