Zano API Distribution CLI

⚠️ Security Warning: Do NOT use the received gift / voucher wallet to store funds. After importing/syncing the voucher wallet, immediately send the funds to a new wallet you control. The ticket creator can reclaim the ticket funds later; voucher wallets are temporary transit wallets only.

This CLI tool allows you to distribute Zano or fUSD tokens to multiple ticket wallets, generate printable voucher sheets, and optionally reclaim tickets.

Claiming Vouchers

Use the Bitcoin.com Wallet to access voucher funds:

1. Download the Bitcoin.com Wallet from Bitcoin.com (install and open it).
2. Tap Add/Import Wallet.
3. Choose Import Wallet.
4. Select Zano.
5. Use the Scan / QR feature to scan the voucher QR code.
6. Confirm the import and send the voucher funds to a secure wallet you control.

Ensure you only use the official Bitcoin.com Wallet from the link above.

Prerequisites

• Rust (latest stable recommended)
• macOS (required; this tool is designed for Mac only)

Installing Rust on macOS with Homebrew

If you are on macOS, you can install Rust using Homebrew:

brew install rust

Alternatively, you can use the official Rust installer:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Make sure you are running this on a Mac, as this CLI is only supported on macOS.

Setup

1 Build the project:

cargo build --release

Running the CLI

Start the CLI with:

cargo run --release

Usage Flow

1. Wallet Setup

   • Enter a wallet name (default: main_wallet)
   • Enter a wallet password

2. Token Selection

   • Choose which token to use: zano or fusd
   • If fusd is selected, the wallet will automatically whitelist the fUSD asset.

3. Mode Selection

   • Choose whether to run in "reclaim mode" (reclaim tickets) or "distribution mode" (distribute tokens).

4. Distribution Mode

   • Enter the total amount of tokens to distribute.
   • Enter the number of tickets to issue.
   • The CLI calculates the amount per ticket and checks if it covers the transaction fee.
   • Confirm the distribution operation.

5. Deposit

   • The CLI displays the main wallet address.
   • Deposit the required tokens to this address and press Enter once done.

6. Ticket Wallets

   • The tool creates ticket wallets and prints their addresses.
   • Distributes the specified amount to each ticket wallet.

7. Voucher Sheets

   • Generates printable voucher sheets for each ticket wallet, including QR codes and amount labels.

8. Completion

   • The CLI confirms when all ticket wallets are funded and the process is complete.

Reclaim Mode

• If you choose reclaim mode, the CLI will attempt to reclaim all tickets using the provided wallet credentials.

Notes

• Make sure your wallet has enough Zano to cover transaction fees, especially when distributing fUSD.
• For troubleshooting, check the CLI output.

Example CLI Session

💎 === Zano Distribution Tool ===

📝 Enter wallet name [main_wallet]:
🔒 Enter wallet password:
🪙 Which token to use? (zano/fusd) [zano]:
✅ Selected token: Zano
♻️ Do you want to run in reclaim mode? (y/n) [n]:
💰 Enter total zano amount to distribute:
🎟️ Enter number of tickets to issue:
...

License

Apache License 2.0

Experimental software: use at your own risk.