Cosanta Wallet Documentation

Cosanta Wallet is an open-source, non-custodial wallet for the Cosanta network. Private keys are generated on your machine, encrypted with your spending password and never leave the device. There is no account, no email and no identity verification — the wallet talks directly to the Cosanta peer-to-peer network.

1. 1Open the Download page and pick the build for your operating system.
2. 2Verify the checksum of the downloaded file before running it.
3. 3Windows: run the .exe installer and accept the security prompt. macOS: open the .dmg and drag Cosanta Wallet to Applications. Linux: make the AppImage executable, then launch it.
4. 4Start the wallet. On first launch it creates its data directory and begins peer discovery.

# Verify the download (Linux / macOS)
shasum -a 256 cosanta-wallet-*.AppImage

# Make it executable and run
chmod +x cosanta-wallet-*.AppImage
./cosanta-wallet-*.AppImage

1. 1Choose “Create new wallet”.
2. 2Set a strong spending password — it encrypts the key store on disk.
3. 3Write the 12 or 24 recovery words on paper, in order. Do not screenshot or type them into any online service.
4. 4Confirm the words when prompted so the wallet knows the backup is correct.
5. 5Wait for the initial sync to complete, then open the Receive tab to get your first address.

1. 1Open the Receive tab and copy the displayed address or share the QR code.
2. 2Optionally add a label so the payment is easy to recognise later.
3. 3Use a fresh address for each payer to keep your history private.
4. 4Incoming funds appear as pending and become spendable after network confirmations.

1. 1Open Send and paste the recipient address — verify the first and last characters.
2. 2Enter the amount, or use Max to sweep the available balance minus the fee.
3. 3Pick a fee level; the wallet estimates it from current network conditions.
4. 4Review the summary, enter your spending password and confirm.
5. 5The transaction is signed locally and broadcast to connected peers.

• Transactions cannot be cancelled once broadcast.
• Unspent change returns to an internal change address in your own wallet.
• Every transaction can be inspected on the public block explorer.

The wallet is hierarchical-deterministic: every address is derived from the same recovery phrase, so a single backup covers all current and future addresses.

m / 44' / coin_type' / account' / change / index

change = 0  → receiving addresses
change = 1  → internal change addresses

• Label addresses and transactions for bookkeeping — labels stay local.
• Save frequent recipients as contacts to avoid pasting mistakes.
• Export the transaction history to CSV for accounting.

The recovery phrase (BIP39 mnemonic) mathematically generates every private key in the wallet. Whoever holds it holds the coins — on any device, without your password.

• Write it on paper or steel, never in a photo, note app, email or cloud drive.
• Store at least two copies in separate physical locations.
• Never type it into a website, form or support chat — no legitimate party ever asks for it.
• Consider an optional passphrase (25th word) for an extra, memorised layer.

1. 1Install Cosanta Wallet on the new device.
2. 2Choose “Restore wallet” and enter the words in the exact original order.
3. 3Set a new spending password for this device.
4. 4Let the wallet rescan the chain — balances and history reappear automatically.

The spending password encrypts the wallet file on disk and is required for every outgoing transaction. It protects a stolen laptop; it does not replace the recovery phrase.

• Use a long, unique password stored in a password manager.
• Changing it re-encrypts the key store but never changes the recovery phrase.
• Forgotten password? Restore from the phrase and set a new one.

• Keep the operating system and the wallet up to date.
• Send a small test amount before any large transfer.
• Bookmark the official site — most theft starts with a look-alike domain.
• Use a dedicated, clean machine for large holdings.
• Treat unsolicited “support” messages as attacks by default.

Deterministic masternodes secure the network through Long-Living Masternode Quorums and earn a share of block rewards. Running one requires locked collateral and an always-on server.

• Block rewards are shared between stakers and masternode operators.
• Emission halves roughly every four years, capping supply near 56.04M COSA.
• Rewards land as normal transactions and appear in your history.
• The wallet must stay connected for staking participation.

• On first launch the wallet discovers peers and downloads chain data.
• Sync progress and peer count are shown in the status bar.
• You can point the wallet at your own node in Settings → Network.
• A rescan re-reads the chain for your addresses without touching keys.

Every transaction, address and block is publicly verifiable on the Cosanta block explorer at explorer.cosanta.net. Paste a transaction ID to check confirmations independently of the wallet.

• Is the wallet free? Yes — free and MIT-licensed. Only network fees apply.
• Do you hold my keys? No. Keys are generated and stored on your device only.
• Can I use one phrase on several devices? Yes, the same phrase restores the same wallet everywhere.
• Does it support other coins? No, Cosanta Wallet is COSA-only.
• Is any personal data collected? No account, email or KYC is required.

Write to support@cosantawallet.com with your operating system, wallet version, what you expected and what happened. Include the transaction ID when relevant.