¶ Balance and Transactions
Your wallet contains two different Balance screens.
The Deposit Account balance screen opens when you launch Samourai Wallet and is considered your default account. The balance at the top of the screen should match the balance of the wallet minus any funds mixed or pending mixing, or any outputs marked as "Unspendable".
The second account with a balance screen is the Postmix account. Tap the Samourai icon in the top left-hand corner of the screen to quickly access this account view.
¶ Network Manager
Press the button in the toolbar
- Toggle Tor On/Off
- Toggle Data connection On/Off
- View Dojo Status
¶ QR Code Scanner
Press the button in the toolbar
- Launches the QR code scanner
- Scan a bitcoin address, payment request, private key, PayNym address, or Cahoots request
¶ More Options
Press the ⋮ button in the toolbar
- Sweep private key
- Export encrypted wallet backup
- Show unspent outputs
- Spend from Whirlpool account
- Paste Cahoots payload
- Support
- Settings
¶ Transactions List
- Transactions with the icon denote transactions that have been sent
- Transactions with icon denote transactions that have been received.
- You can tap any transaction in the list to reveal the Transaction Details screen.
¶ Floating Action Button
Tap the blue floating action button (FAB) on the Balance screen to open the main interaction menu of your wallet.
The FAB is contextual to the Account you are currently interacting with. If you are on the Deposit Account you will see the full list of possible interactions. If you are on the Post-mix Account then you will only see the Send interaction.
¶ Receive
Pressing this green Receive button will open the receive screen.
¶ Send
Pressing this red Send button will open the send screen.
¶ PayNym
Pressing this purple PayNyms button will open the PayNym screen.
¶ Whirlpool
Pressing this blue Whirlpool button will open the Whirlpool screen.
¶ Receive
Your wallet contains an infinite amount of bitcoin addresses that get used once and then are archived. This means your bitcoin address will change all the time, this is not cause for alarm, consider your addresses as 'one-time-use' and disposable. While it is possible to reuse addresses more than once it is strongly discouraged.
Your wallet doesn't reuse addresses, this is a strategy to help protect your privacy on the blockchain.
¶ Share Address
- Tap the address text and press YES to copy the address to your clipboard
- Press in the toolbar to share the QR code image
¶ Request Amount
- Tap to display advanced receiving options
- Enter the amount you wish to receive in
BTCorsats
¶ Change Address Type
- Tap to display advanced receiving options
- Tap the select box with Segwit native (bech32)
- Select the new address type.
If you are having problems with the default address Samourai provides, try changing the address type to
segwit compatibility
¶ Collaborate in a Cahoots
If you are participating in a STONEWALLx2 or Stowaway transaction with a friend they will ask you to go to "receive online cahoots" to begin the process. This is how you do it.
- Press ⋮ in the toolbar
- Press Receive online Cahoots
- Wait for the Cahoots to appear and follow instructions on screen.
¶ Send
¶ Video
By default your wallet will attempt to compose the best transaction for maximizing your privacy on the blockchain. Depending on the number of available unspent outputs in your wallet at any given time your default transactions will differ in composition.
¶ Destination Address and Amount
¶ QR Code Scanner
- Tap in the toolbar
- Scan a bitcoin address or BIP21 Payment Request
- This will fill the
Tofield and possibly theamountfield.
¶ Send To PayNym Contact
- Press in the toolbar
- Select any PayNym contact you have connected to.
- This will fill the
Tofield with the PayNym contact you are sending to.
¶ Enter Amount
- Enter an amount to send this address
¶ Ricochet
Ricochet defends against bitcoin blacklists by adding additional decoy transactions between the initial send and eventual recipient.
You should consider using Ricochet when sending to Bitcoin Exchanges, and other companies that are known to close accounts and lock funds.
¶ Enable Ricochet
- Navigate to the Send screen for either the Deposit account or the Postmix account
Add Final Destination And Amount
- Use in the toolbar to scan a QR code
- Use to select a PayNym Contact
- Directly paste an address in the
Tofield. - Enter an amount to send this address
Toggle Ricochet
- Tap the toggle button next to Ricochet so it is enabled (color blue)
Optionally Enable Staggered Delivery
- Staggered Ricochet will space out the decoy transactions 1 block apart from each other. This means that final delivery to the destination could take between 30 minutes and 2 hours.
- Tap the toggle button next to Staggered Delivery if you wish to enable staggered delivery
¶ Ricochet Costs
- A Ricochet is considered a premium transaction and costs
0.001 BTCplus miner fees
¶ Review Transaction Details
- Press Review Transaction on the bottom of the send screen to reveal the second and final step of the sending process
¶ Transaction Priority
The fee slider features three different priority 'profiles', and these are based on how quickly you need the transaction to be added to a block.
¶ Understanding the Fee Slider
- Profile
As you slide the slider the profile will change to either "Low", "Normal", or "Urgent". - Fee Rate
Directly under the Profile is the fee rate that this transaction will use insat/byte - Total Miner Fee
This displays what the total cost of the miner fee will be for this transaction based on the fee slider position - Estimated wait time
This displays an estimate of how long you will wait until this transaction is included in the blockchain.
¶ STONEWALL Protection
STONEWALL is a unique way of building transactions that increases the deniability of the link between sender and recipient of a transaction. A STONEWALL is designed to improve your privacy on the blockchain by introducing a large element of doubt and uncertainty into the datasets of blockchain analysis platforms.
There will be times when it is not possible for the wallet to compose a STONEWALL, if this is the case, the STONEWALL option will be disabled.
If Ricochet was enabled in the previous step then STONEWALL will not be available.
¶ STONEWALL Costs
- STONEWALL is enabled by default in Samourai wherever possible and there is no extra charge for using it.
- Miner fees will be slightly higher than normal bitcoin transactions
¶ Disable STONEWALL
- Tap the toggle button next to STONEWALL so it is disabled (color grey)
It is recommended you leave STONEWALL enabled if possible.
¶ Broadcast Transaction
- Press the green Send button at the bottom of your screen
- Review the details carefully one final time.
- Press Yes to broadcast the transaction
¶ PayNym
A PayNym is a permanent and reusable code that you can share with anyone. It is tied to your secret words. It looks similar to a bitcoin address but it is longer and starts with 'PM8T'. Here is an example:-
PM8TJMAFUAKXAhjcw2symZVJBZXwDTtjJz5NiEnBSj7ryYvwohy6R9Ee4BpugTWvyiTMT29qzbmXtFTZ3WsEgqW3rbK8KttuxjdX3dcnxRKP18TMi1F7
Payment Codes in Samourai are the first implementation of the BIP47 Proposal by the Open Bitcoin Privacy Project
¶ Share your PayNym
Unlike a static bitcoin address you can share your PayNym publicly without revealing your entire balance or transaction history. Anyone with Samourai Wallet or any wallet that follows the BIP47 proposal can connect to your payment code and generate private bitcoin addresses on demand for sending bitcoin to your wallet.
- Navigate to the PayNym screen
- Press to view your PayNym QR code and text string.
- You can share this publicly or directly with your contacts.
¶ Follow PayNyms
Just like others can follow your PayNym you can also follow others as well.
Once you have a mutal following with a PayNym you can use them as a collaborator in Cahoots transactions
¶ Follow Back
- Tap on the PayNym in the "Followers" tab of the PayNym screen.
- Press FOLLOW to add this PayNym to your list of followed Nyms
- There is no charge to follow a PayNym
¶ Add Payment Code Manually
- Press the blue on the lower right-hand side of the PayNym screen.
- Tap SCAN QR CODE or Paste Payment Code to load a PayNym profile
- Press FOLLOW to add this PayNym to your list of followed Nyms.
¶ Search Online Directory
If you have the PayNym name (eg;+samouraiwallet) you can visit the public directory page
https://paynym.is/+samouraiwallet to view a web profile for this PayNym.
- Press the Open In Wallet button on the
PayNym.is/+botnamepage in your mobile browser to automatically open the PayNym profile in your wallet - Scan the QR code on the webpage with your wallet
- Manually copy and paste the payment code from the webpage
¶ Connecting to a PayNym
For direct payments to another PayNym (without using cahoots transactions), after following you must also 'Connect'. This connection transaction is what facilitates the information sharing between the two wallets and enables them to generate their private Bitcoin addresses. Connecting to a PayNym can be useful for users with whom you plan to make repeat 'regular type' payments to.
- The connection transaction costs
0.00015 BTCor15,000 satsplus miner fees
¶ Whirlpool
Whirlpool mathematically disassociates the ownership of inputs to outputs in a given bitcoin transaction and deterministically breaks all prior history of an output with future activity. This is to increase the privacy of the users involved, protect against financial surveillance, and to increase the fungibility of the Bitcoin network as a whole.
- Navigate to the Whirlpool screen
¶ Unspent Output List
Press the button in the toolbar
- Launches the list of unspent outputs available in your Postmix account.
¶ QR Code Scanner
Press the button in the toolbar
- Launches the QR code scanner
- Scan a bitcoin address, payment request, private key, PayNym address, or Cahoots request
- The wallet will automatically only select mixed outputs for the resulting transaction.
¶ Add a discount code
Press the button in the toolbar
- Press Whirlpool SCODE
- Input the discount code exactly as it is presented
- Press OK
- The Whirlpool service will close and you will be returned to your main Balance and Transactions screen.
- Once you reopen the Whirlpool screen the discount code will be applied.
¶ Start a new mix
- Press the blue whirlpool button on the bottom-right side of your screen.
- Press Mix UTXOs
¶ Choose UTXOs
- A list of outputs belonging to your Deposit account will be displayed here. Choose one or more outputs to create an amount of at least 0.0015 BTC and then press the blue NEXT button
¶ Choose miner fee and pool
- Select a miner fee priority of either
low,normal, orhigh. This will impact the total fees paid for the initial mix transaction. - Next select a mixing pool and press the blue REVIEW CYCLE DETAILS button at the bottom of the screen.
¶ Review Details
The review screen shows a few details
- Pool
The denonination of the pool you have selected for this mix. - UTXOs Created
The number of unspent outputs that will be created with fresh histories - Deterministic Links
The number of deterministically linked inputs and outputs in the resulting mix transaction - Combinations
The number of potential combinations when attempting to link inputs to outputs of a single mix transaction - Entropy
The score of the resulting transaction when measured with the Boltzmann transaction analyzer tool.
Additionally there are details regarding the total fees to review
- Pool Fee
The fixed fee required to enter the pool - Total premix fee
The total miner fees for the Premix outputs created - Miner fee
The miner fee for the Tx0 transaction being created - Unmixed Change
The amount of BTC returning to your wallet that hasn't been mixed - Total Fees
Total premix fee + Miner fee + Pool Fee
¶ Begin Cycle
- Press Begin Cycle at the bottom of the screen to broadcast the initial mix transaction. Once the transaction receives 1 blockchain confirmation mixing will begin.
¶ Mark Doxxic Change
Decide what you want to do with the Toxic Change output (unmixed)
- Press yes (recommended) to mark the UTXO as "Do Not Spend" - which you can then make spendable at a later date.
- The automatic labeling of "toxic change" will stay, even if you uninstall/reinstall from your encrypted backup. Labels are another helpful tool to manage UTXOs and avoid privacy slips.
¶ Transaction Details
- Navigate to the Balance and Transactions screen for either your Deposit or Postmix account
- Tap on any transaction in the list under the top balance
¶ Screen Overview
- Date
The date this transaction was first seen on the bitcoin network - Status
The number of confirmations of this transaction on the bitcoin blockchain - Miner fee rate
The miner fee rate expressed insatoshi/byte - Miner fee paid
The total amount paid to the miners in this transaction expressed insatoshi - Transaction ID
The unique transaction hash that can be used to look up this transaction on a block explorer
¶ View in Block Explorer
Press the button in the toolbar
¶ Dojo
The most private way to back your Samourai Wallet is with your own Dojo. There are many ways to get your own Dojo, each implementation will have marginally different connection steps but the steps within the wallet will be identical.
¶ Erase Wallet
Skip this step if you are starting with a new Samourai Wallet
- If you have an existing Samourai wallet, check your seed words and passphrase.
- Press the ⋮ in the top-right corner and select Settings then Wallet.
- At the bottom of this screen tap Secure erase wallet
¶ Connect to Dojo
- From the start screen, select main net and activate Tor
- Toggle the Dojo button on to connect to your own Dojo server
- Scan the pairing QR code displayed by your chosen Dojo implementation
- Tap Restore an existing wallet then I have a Samourai backup file
- Carefully enter your passphrase then tap Finish
¶ Zero balance?
If you have followed the above steps and do not see a balance, do not be alarmed! You simply need to rescan your wallet's public keys to tell your Dojo about the wallet you control.
¶ Stealth Mode
Stealth Mode allows you to hide the Samourai Wallet app icon on your device's home screen. Instead of the Samourai Wallet icon, you can choose from four decoy apps. This provides protection from physical searches of your device.
¶ Turn on Stealth Mode
- Navigate to Settings > Wallet > Stealth Mode
- Tap the toggle to ON
¶ Select your decoy app
Choose from the following:
¶ Enable Stealth Mode
Stealth Mode will only be enabled by exiting the app in the proper fashion. This allows you to be able to use Samourai when multi-tasking without Stealth Mode being enabled by accident.
- From the Deposit screen, tap your PayNym icon in the top left corner.
- Tap Exit Wallet
¶ Disable Stealth Mode
Each stealth/decoy app is disabled using a different method. First open the decoy app, then:
- Calculator: Tap "=" symbol 5 times.
- Edge VPN: Select the specified VPN location (see Note 1 and 2).
- QR Scanner: Tap "QR scanner" at the bottom of screen 5 times.
- Notepad: Tap "Notepad" at top of screen 5 times.
Note 1: The default location is "United States Chicago". Within the Stealth Mode settings, it is possible to change the VPN location which is selected to disable Stealth Mode.
Note 2: The Edge VPN app is not a functioning VPN.