๐Ÿ’ผWeb Wallet

A Flutter web wallet for PotCoin with PIN + biometrics, BIP39 seed phrase, custom Electrum servers, and a built-in Solana bridge tab. Live at wallet.potcoin.com.

What this wallet is

The PotCoin web wallet is a Flutter web app derived from the Peercoin Flutter wallet, branded for POT. It connects to the chain via ElectrumX SPV โ€” no full node required. You can use it from any browser, install it as a PWA on iOS, or run the same codebase as the Android/iOS native app.

PropertyValue
Connection modeElectrumX SPV (light client)
Seed standardBIP39, 12โ€“24 words
AuthPIN required, biometrics optional
Bridge integrationBuilt-in tab, connects to Phantom / Solflare
Multi-walletYes โ€” switcher at /wallet-list
Custom ElectrumYes, per-wallet under server settings

First-time setup

  1. Visit wallet.potcoin.com

    The Flutter app loads (โ‰ˆ6MB main bundle) and walks you through onboarding:

    1. setup-language โ€” pick your language
    2. setup-legal โ€” read and accept the license switch
    3. setup-auth โ€” choose PIN, optionally enable biometrics
    4. setup-feeds โ€” pick price feed source (or skip)
    5. setup-create-wallet OR setup-import-seed
  2. Create a new wallet

    Drag the seed-length slider (12, 15, 18, 21, or 24 words). 12 is fine for normal use; 24 is paranoid-grade. Tap Generate.

  3. Back up the seed phrase

    The wallet shows your BIP39 seed words one at a time. Write them down with pen and paper, in order. Do not screenshot. Do not store in a password manager. Do not paste anywhere.

    This is your only backup Lose the seed phrase = lose your coins. Have it leaked = anyone can drain you. The wallet enforces a re-entry quiz to make sure you wrote it down correctly.
  4. Set a PIN

    Required. Used to unlock the wallet and to sign transactions. Optionally enable biometrics on devices that support it.

  5. You're at the main screen

    Bottom nav has 4 tabs: Receive ยท Transactions ยท Address Book ยท Send. Top-level screens like Bridge, Wallet List, and Settings live in the menu.

Restoring an existing wallet

  1. From onboarding, choose Import Seed instead of Create.
  2. Type each word from your backup. The wallet validates on the fly โ€” input less than 12 words and you'll get import_seed_error_1.
  3. Set a fresh PIN (independent of the original wallet's PIN โ€” the seed is what matters).
  4. The wallet rescans via Electrum and your balance/history populates within a few seconds.

Receiving POT

  1. Tap the Receive tab
  2. The current address (P-prefix) is shown with a QR code
  3. Tap Show QR for a larger QR, or Share to send via OS share sheet
  4. Optionally tap Enter Amount to encode a specific POT amount into the QR โ€” Phantom-style
  5. Add a label hint if it's tied to a specific person/use case
Address rotation Tap New Address to generate a fresh receive address. Reusing addresses links your transactions in the public graph. New address per payment = better privacy hygiene on a transparent chain.

Sending POT

  1. Tap Send
  2. Paste or scan the recipient's P-address
  3. Enter the amount (toggle to fiat display via the price feed if helpful)
  4. Set the fee โ€” minimum is 0.420 POT
  5. (Optional) attach an OP_RETURN with up to 80 bytes of metadata via send_op_return
  6. (Optional) add multiple recipients via send_import_csv
  7. Review on the confirm screen โ€” send_total shows amount + fee + change
  8. Enter PIN (or biometric) to sign and broadcast

The built-in Bridge tab

The web wallet has a bridge directly inside it โ€” no need to bounce out to the standalone bridge page. Open the Bridge screen from the menu.

  1. Connect a Solana wallet

    Tap Connect Phantom or Connect Solflare. The wallet uses @solana/web3.js loaded from CDN to talk to your Solana wallet directly.

  2. Verify your SPL POT balance

    Shown as Your SPL POT Balance. Pulled live from the Solana mainnet RPC. SPL mint: PotzPaFGzK3cbu1u3g5HtoZbyTUkyhka8T2aBy8LMEq.

  3. Set the bridge amount

    Type the amount in the Amount to Bridge field.

  4. Confirm your mainchain receiving address

    Auto-filled from your active wallet โ€” labeled Your Mainchain Receiving Address. You can override, but the default is the safe choice.

  5. Tap Bridge SPL POT โ†’ Mainchain

    Phantom (or Solflare) pops up. Approve the SPL Transfer + Memo transaction. The Memo carries POT:<your-mainchain-addr> so the bridge knows where to deliver.

  6. Watch confirmation

    Toast: "Transaction Sent!", then a View on SolScan link, and a heads-up: "Your mainchain POT will arrive shortly". The Bridge Transactions history at the bottom tracks status.

Live bridge The in-wallet bridge tab is wired to the real PotCoin bridge service (static-supply escrow swap model). Both directions are tested end-to-end.

Settings

SettingWhat it does
ThemeLight / dark / system
LanguageSearchable list, all UI strings translated
BiometricsToggle Face ID / fingerprint to unlock
Change PINReplace your unlock PIN (seed unaffected)
Default walletWhich wallet opens at app launch (multi-wallet)
Wallet orderingDrag-reorder the wallet list
NotificationsPush alerts for incoming transactions
Price feedSearchable list of fiat conversion sources
ExperimentalHidden feature flags (use at your own risk)
Reveal seedRe-displays your BIP39 phrase (PIN required)
Server settingsPer-wallet custom Electrum endpoint โ€” point at your own ElectrumX

Custom Electrum server

If you don't want to trust the default Electrum endpoints, run your own ElectrumX node and point the wallet at it. Defaults are seeds.potcoin.com:50001 (TCP) and seeds.potcoin.com:50002 (SSL).

  1. Open Server Settings from the per-wallet menu
  2. Tap Add Server
  3. Enter host:port (e.g. my-electrum.example.com:50002) and select SSL/TCP
  4. Move your custom server to the top of the list โ€” the wallet tries them in order
  5. Tap Test Connection โ€” should return the chain tip height

Import a paper wallet (sweep)

  1. From the per-wallet menu, choose Import โ†’ Paper Wallet
  2. Either scan the private-key QR with your camera, or type the WIF
  3. The wallet calculates the address, queries the balance via Electrum, and offers to sweep
  4. Tap Sweep โ€” funds move into your active wallet at a fresh address

If the WIF is BIP38-encrypted (starts with 6P), use Wallet Details on paper.potcoin.com to decrypt first.

Multi-wallet setup

Open Wallet List to manage multiple wallets in the same app โ€” useful for separating cold/hot, business/personal, or for using one wallet exclusively with the bridge.