Z-TextDocs

Wallet

Z-Text includes a built-in BitcoinZ wallet for managing your messaging credits and viewing transaction history.

Wallet Purpose

The wallet in Z-Text is designed to manage messaging credits for the Z-Text protocol. Any use of BTCZ outside of Z-Text messaging is at your own risk and outside the scope of this service.

Balance Overview

The wallet screen shows your total BTCZ balance across both shielded (z-address) and transparent (t-address) pools. The balance updates automatically as new blocks are synced.

  • Shielded balance -- funds in your z-address, used for messaging and private transactions
  • Transparent balance -- funds in your t-address, visible on the public blockchain
  • Pending -- incoming transactions awaiting confirmation

Sending BTCZ

To send BTCZ to another address:

  1. Navigate to the Wallet tab
  2. Tap Send
  3. Enter the recipient's address (z-address or t-address) or scan their QR code
  4. Enter the amount in BTCZ
  5. Review the transaction details and confirm with your PIN

Shielded vs Transparent

Sending from a z-address to another z-address is fully shielded -- the amount, sender, and recipient are all private. Sending to a t-address reveals the amount and recipient on the public ledger.

Receiving BTCZ

To receive BTCZ, share your address or QR code with the sender. You can find your addresses in the wallet screen under Receive.

  • Tap Receive to display your QR code
  • Toggle between your z-address and t-address
  • Copy the address text or let the sender scan the QR code

Transaction History

The transaction history shows all incoming and outgoing transactions with timestamps, amounts, and confirmation status. Shielded transactions show the counterparty only if they are a known contact.

Address Types

TypePrefixPrivacyUse Case
z-address (shielded)zs1...Full privacyMessaging, private transactions
t-address (transparent)t1...PublicReceiving funds, public transactions

Transaction Fees

All transactions on the BitcoinZ network require a small fee. Shielded transactions (z-to-z) have slightly higher fees due to the zk-SNARK proof generation, but these are still negligible. The app automatically calculates the appropriate fee.

Keep a Balance

You need BTCZ in your wallet to send messages (which are blockchain transactions). Make sure to maintain a small balance for ongoing messaging.