From 92c07e6cc2eeb949556975f3ab943b4db10b0e5a Mon Sep 17 00:00:00 2001
From: Jon C <me@jonc.dev>
Date: Tue, 9 Apr 2024 23:29:36 +0200
Subject: [PATCH] docs: Add confidential transfer test script (#6561)

---
 docs/src/confidential-token/quickstart.md   |  5 ++
 token/cli/examples/confidential-transfer.sh | 77 +++++++++++++++++++++
 2 files changed, 82 insertions(+)
 create mode 100755 token/cli/examples/confidential-transfer.sh

diff --git a/docs/src/confidential-token/quickstart.md b/docs/src/confidential-token/quickstart.md
index 6a758249f25..a73334618da 100644
--- a/docs/src/confidential-token/quickstart.md
+++ b/docs/src/confidential-token/quickstart.md
@@ -15,6 +15,11 @@ about Token-2022 and the concept of extensions.
 See the [Token Setup Guide](../token#setup) to install the client utilities.
 Token-2022 shares the same CLI and NPM packages for maximal compatibility.
 
+All of the commands here exist in a
+[helper script](https://github.com/solana-labs/solana-program-library/tree/master/token/cli/examples/confidential-transfer.sh)
+at the
+[Token CLI Examples](https://github.com/solana-labs/solana-program-library/tree/master/token/cli/examples).
+
 ### Example: Create a mint with confidential transfers
 
 To create a new mint with confidential transfers enabled, run:
diff --git a/token/cli/examples/confidential-transfer.sh b/token/cli/examples/confidential-transfer.sh
new file mode 100755
index 00000000000..00536e4a470
--- /dev/null
+++ b/token/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 "..."