tWallet v1 (Neutrino)
v1 is the recommended tWallet line. It uses the Neutrino light‑client protocol (BIP157/BIP158) to sync without relying on a third‑party Electrum server.
Capabilities
- Built‑in FLND (Flokicoin Lightning Network Daemon) for integrated Lightning operations.
- Address types: segwit (BIP173) and taproot (BIP341, BIP342).
- Seed format: aezeed (LND seed, new format) for backup and recovery.
note
Default address type is segwit. You can switch via addresstype=segwit|nested-segwit|taproot in twallet.conf.
important
Why Neutrino
- Built-in: Neutrino is integrated directly into tWallet, no external server required.
- Trust‑minimized: You verify headers and use compact block filters; no single server dictates your view of the chain.
- Privacy: Queries are not centralized at an Electrum server.
Install
tip
Install via myFloki plug-and-play:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/myfloki/community-tools/main/downloader.sh)"
After installation, run twallet.
See myfloki.com for details on the bundled components.
Download the latest 1.0.8-beta release assets from GitHub and extract them.
Extract and make the binary executable where applicable:
tar -xvf twallet-*.tar.gz
chmod +x twallet
Configure
You can run twallet without a config file; add one only when you need custom settings (for example, running a second wallet).
Create a twallet.conf file next to the binary or in your app data directory. Minimal example:
twallet.conf (v1 minimal)
# walletdir = ./loki
# addresstype = segwit # segwit | nested-segwit | taproot
# feeurl = https://flokichain.info/api/v1/fees/recommended
# debuglevel = info
# connectiontimeout = 50s
# rpclisten = 127.0.0.1:10005 # RPC API
# restlisten = 127.0.0.1:5050 # REST API
# restcors = * # CORS for REST API
# transactiondisplaylimit=121
Full sample (annotated):
Full sample (v1)
; Directory for the wallet database
# walletdir = ./loki
; Network settings (only one can be true)
; If both regtest and testnet are false, mainnet will be used by default.
; Use the regression test network
; regtest = false
; Use the test network
; testnet = false
; The timeout value for network connections {ms, s, m, h}
; Default is '50s'
;connectiontimeout = 50s
; Logging level for all subsystems {trace, debug, info, warn, error, critical}
; Default is 'info'
;debuglevel=info
; Logging level for the twallet application {trace, debug, info, warn, error, fatal, panic}
; Default is 'info'
;loglevel=info
; Connect only to the specified peers at startup
; connect=node.example.org
; Use default passphrase for locking (TESTING ONLY, DO NOT USE IN MAINNET OR PRODUCTION ENVIRONMENTS)
# defaultpassword=pass
; Address type to generate (taproot, segwit, or nested-segwit)
; Default is 'segwit'
# addresstype=segwit
# Custom fee estimation API endpoint (optional).
# The URL below is only an example — you can replace it with your own fee provider.
# Expected response format:
# {"fastestFee":1,"halfHourFee":1,"hourFee":1,"economyFee":0,"minimumFee":0}
# feeurl=https://flokichain.info/api/v1/fees/recommended
; Adds an extra IP to the generated certificate. One IP per line.
# tlsextraip=0.0.0.0
; Adds an extra domain to the generated certificate. One domain per line.
# tlsextradomain=localhost
; Re-generate TLS certificate and key if the IPs or domains are changed.
# tlsautorefresh=true
; Add an interface/port/socket to listen for RPC connections.
; One listen address per line. Example: rpclisten=0.0.0.0:10005
# rpclisten=0.0.0.0:10005
; Add an interface/port/socket to listen for REST connections.
; One listen address per line. Example: restlisten=0.0.0.0:5050
# restlisten=0.0.0.0:5050
; Add an interface/port to listen for peer connections.
; One listen address per line. Example: listen=0.0.0.0:5521
# listen=0.0.0.0:5521
; Add an ip:port or hostname to allow cross-origin access to the REST API.
; One entry per line. To allow all origins, use: restcors=*
; Examples:
; restcors=http://localhost:3000
; restcors=https://mydomain.com
# restcors=*
; Maximum number of transactions to display.
; This does NOT affect how many transactions are fetched internally;
; it only limits how many are presented at once.
# transactiondisplaylimit=121
Run
On macOS/Linux:
./twallet
On Windows:
twallet.exe
If your OS flags the binary, allow it explicitly.
Releases
See the sidebar for the latest v1 release notes and assets.
Security
- Back up your seed phrase (24 words recommended) and test recovery.
- Set a spending passphrase and lock your wallet when idle.
- Keep tWallet up to date: https://github.com/flokiorg/tWallet/releases