Common Issues & Solutions

Overview

This guide covers frequently encountered issues with SSP Wallet based on actual user experiences and known technical limitations. All solutions are based on SSP's actual implementation.

⬆️ Upgrading to v2.0.0

Question: "Will updating to v2 make me re-pair or restore my wallet?"

No. Updating SSP Wallet or SSP Key to v2.0.0 in place keeps your wallet, password, pairing, settings, and history exactly as they were. You never need to re-pair or restore from seed because of the update. See What's New in SSP v2.0.0.

Question: "Do I have to update both apps at the same time?"

No. Update in any order — SSP Wallet v2 works with SSP Key v1 and vice versa. Multi-chain batch sync and the pairing verification code activate once both apps are on v2; until then, chains sync one at a time exactly as before.

Question: "Where did the Settings menu go?"

Settings became the Menu tab — the ☰ icon in the bottom bar. Everything from the old menus is there: language, currency, theme, change password, network configuration, WalletConnect, Address Details, SSP Wallet Details, message signing, and the tutorial. See Navigating SSP Wallet.

Problem: "The verification words on my two devices don't match"

Stop — do not use that pairing. After every sync, both devices derive a 6-word verification code from the synced keys; a mismatch means the sync must not be trusted. Choose "They don't match" in the wallet and re-pair. If it repeats, report it. Details: Pairing Verification Code.

🔄 Device Synchronization Issues

Problem: "Cannot sync SSP Wallet and SSP Key"

SSP's 2-of-2 Architecture Requirements:

• Browser extension (SSP Wallet) must sync with mobile app (SSP Key)

• Both devices need public key exchange to generate multisig addresses

• Synchronization can be done via QR code or manual input

Solutions:

One-Tap Sync (both apps on v2)

1. SSP Wallet: Request the sync (pairing screen or chain activation) — the request is delivered to your paired SSP Key through the relay

2. SSP Key: Review the request and slide to approve — a batch request activates several chains with one approval

3. Verify: Both devices show the same 6-word verification code and the same wallet addresses

QR Code Sync Method

1. SSP Wallet: Display QR code during sync process

2. SSP Key: Use "Scan Code" to scan the QR code

3. Verify: Both devices show the same verification code (v2) and same wallet addresses after sync

Manual Input Method

1. SSP Wallet: Open the chain's Sync with SSP Key view (in SSP Wallet Details) and copy the sync data — it has the form chain:xpub (the same value encoded in the sync QR code).

2. SSP Key: On the sync screen, tap Manual Input and paste the copied wallet sync data (or use Scan Code to scan the wallet's QR instead).

3. The SSP Key builds the 2-of-2 multisig from the wallet's key and posts its own public key back through the relay; the SSP Wallet completes the sync automatically once it verifies the derived address matches.

4. Verify both devices show the same addresses. Repeat per chain if any chain is out of sync. (Sync data always flows Wallet → Key; there is no "Export Public Key" option in SSP Key.)

Problem: "Addresses don't match between devices"

Root Cause: Incomplete or failed synchronization

Solution:

1. Verify both devices completed sync process

2. Check that both devices show "Connected" or "Synced" status

3. If addresses differ, repeat synchronization process

4. Ensure you're viewing the same blockchain network on both devices

🔑 Authentication Issues

Problem: "Cannot unlock SSP Wallet"

Password Recovery:

1. Click "Restore Wallet" option

2. Enter your 24-word seed phrase

3. Set new password

4. Re-sync with SSP Key

Problem: "Cannot unlock SSP Key"

PIN/Biometric Recovery:

• If PIN forgotten: Use seed phrase to restore SSP Key on same or new device

• If biometric fails: Use PIN as fallback

• Complete recovery: Uninstall/reinstall app and restore from seed phrase

💸 Transaction Issues

Problem: "Transaction not completing"

SSP's 2-of-2 Requirement:

• Every transaction needs approval from BOTH devices

• SSP Wallet initiates transaction

• SSP Key must approve transaction

• Both signatures required for blockchain broadcast

Solutions:

1. Ensure both devices are online and synced

2. Check that SSP Key receives transaction notification

3. Approve transaction on SSP Key mobile app

4. Wait for blockchain confirmation (varies by network)

Problem: "Transaction stuck or pending"

Blockchain-Level Issues:

• Bitcoin: Transaction may be waiting in mempool

• Ethereum: May need higher gas fee for faster confirmation

• Network congestion can delay confirmations

Solutions:

1. Wait for network confirmation (can take minutes to hours)

2. Check transaction status on blockchain explorer

3. For Ethereum: Some wallets support transaction speed-up (if implemented)

📱 Mobile App Issues

Problem: "SSP Key app crashes"

Basic Solutions:

1. Force close app and restart

2. Restart mobile device

3. Update to latest version from app store

4. If persistent: Uninstall, reinstall, restore from seed

Problem: "Not receiving transaction notifications"

Notification Settings:

1. Enable notifications for SSP Key in device settings

2. Ensure app has permission to send notifications

3. Check that device is not in Do Not Disturb mode

💻 Browser Extension Issues

Problem: "SSP Wallet extension not working"

Browser Extension Solutions:

1. Check extension is enabled in browser settings

2. Update to latest version

3. Try disabling other extensions temporarily

4. Clear browser cache and cookies

5. If corrupted: Remove extension, reinstall, restore from seed

Problem: "Extension data lost"

Recovery Process:

1. Click "Restore Wallet" in extension

2. Enter 24-word seed phrase

3. Set new password

4. Re-sync with SSP Key mobile app

🌐 Network Issues

Problem: "Cannot connect to blockchain networks"

Network Connectivity:

• SSP Wallet connects to blockchain RPC endpoints

• Some networks may have intermittent connectivity

• Corporate firewalls may block blockchain connections

Solutions:

1. Check internet connection

2. Try different network (mobile data vs WiFi)

3. Contact IT department if using corporate network

4. Wait and retry if blockchain network is experiencing issues

🔧 Recovery Scenarios

Device Loss Recovery

Lost Computer (SSP Wallet):

1. Install SSP Wallet on new computer/browser

2. Restore using wallet seed phrase

3. Re-sync with existing SSP Key

Lost Mobile Device (SSP Key):

1. Install SSP Key on new mobile device

2. Restore using SSP Key seed phrase

3. Re-sync with existing SSP Wallet

Lost Both Devices:

1. Need BOTH seed phrases for complete recovery

2. Install SSP Wallet and restore with wallet seed phrase

3. Install SSP Key and restore with key seed phrase

4. Sync both restored devices

Important Recovery Notes

• Each device has its own seed phrase

• Both seed phrases needed for full wallet recovery

• Cannot recover if either seed phrase is lost

• Test recovery process with small amounts

📞 Getting Help

Official Support Channels

Primary Support:

• Support Center: sspwallet.io/support - FAQ and guides

• Support Tickets: support.runonflux.io - Direct support

• Contact Form: sspwallet.io/contact - Message support team

Community Support:

• Discord: discord.gg/runonflux - Community help

• GitHub Issues: github.com/RunOnFlux/ssp-wallet/issues - Bug reports

Before Contacting Support

Gather This Information:

• Device types and operating system versions

• SSP Wallet and SSP Key version numbers

• Browser type and version (for SSP Wallet)

• Exact error messages or screenshots

• Steps you took before the issue occurred

Security Issues

• Report via: GitHub Security

• Critical Issues: Use GitHub's security advisory feature

Prevention Best Practices

Regular Maintenance

• Keep both apps updated to latest versions

• Verify seed phrase backups are secure and accessible

• Test sync functionality periodically

• Keep devices charged during transaction operations

Security Best Practices

• Store seed phrases securely offline (paper, never digital)

• Use strong passwords/PINs on both devices

• Never share seed phrases with anyone

• Always verify transaction details before approving

---

Note: This guide focuses on issues specific to SSP Wallet's 2-of-2 multisignature architecture. For general cryptocurrency or blockchain issues, consult respective network documentation.