--- name: "electrum" section: "1" platform: "linux" package: "electrum" version: "4.5.8+ds-6" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/electrum" --- # electrum(1) easy to use Bitcoin client ## NAME electrum - easy to use Bitcoin client ## SYNOPSIS **electrum**\ Launch the Electrum GUI with the default options. **electrum** *url*\ Launch the Electrum GUI with a specific Bitcoin URI or a BIP70 file. See *url* for syntax information. **electrum** \[*command*\] \[*options*\] \[*global\_options*\] \[*positional\_arguments*\]\ Specify possible commands, options, global options, and positional arguments. **electrum help** *command*\ List detailed help for the specified command. ## DESCRIPTION Electrum is a lightweight Bitcoin wallet focused is speed, with low resource usage and simplifying Bitcoin. Startup times are instant because it operates in conjunction with high-performance servers that handle the most complicated parts of the Bitcoin system. Electrum has a list of possible options specific to each command as well as a set of global options. Some commands also accept positional arguments at the end of the options list. Running **electrum help** *command* will list the options and positional arguments compatible with that command. ## COMMANDS - **gui** Run the GUI. This is the default if no command is specified. May use the *url* positional argument. - **daemon** Run the daemon. - **add\_peer** Add a peer. Requires the *connection\_string* positional argument. - **add\_request** Create a payment request, using the first unused address of the wallet. The address will be considered as used after this operation. If no payment is received, the address will be considered as unused if the payment request is deleted from the wallet. Requires the *amount* positional argument. - **addtransaction** Add a transaction to the wallet history. Requires the *tx* positional argument. - **broadcast** Broadcast a transaction to the network. Requires the *tx* positional argument. - **bumpfee** Bump the fee for an unconfirmed transaction. Requires the *tx* and *new\_fee\_rate* positional arguments. - **changegaplimit** Change the gap limit of the wallet. See https://support.ledger.com/hc/en-us/articles/360010892360-Address-gap-limit and https://blog.lopp.net/mind-the-bitcoin-address-gap/ for more information. Requires the *new\_limit* positional argument. - **clear\_invoices** Remove all invoices. - **clear\_ln\_blacklist** Clear the Lightning blacklist. - **clear\_requests** Remove all payment requests. - **close\_channel** Close a Lightning channel. Requires the *channel\_point* positional argument. - **close\_wallet** Close the wallet. - **commands** List the available commands. - **convert\_currency** Convert the given amount from one currency to another using the configured exchange rate source. - **convert\_xkey** Convert the xtype of a master key. E.G. xpub -\> ypub. Valid options are 'xprv', 'yprv', 'zprv', 'Yprv', 'Zprv', 'xpub', 'ypub', 'zpub', 'Ypub', and 'Zpub'. Requires the *xkey* and *xtype* positional arguments. - **create** Create a new wallet. If you want to be prompted for an argument in a concealed fashion, use '?' or ':' for the argument value. - **createmultisig** Create a MultiSig address. Requires the *num* and *pubkeys* positional arguments. - **createnewaddress** Create a new receiving address, beyond the gap limit of the wallet. See https://support.ledger.com/hc/en-us/articles/360010892360-Address-gap-limit and https://blog.lopp.net/mind-the-bitcoin-address-gap/ for more information. - **decode\_invoice** Decode an invoice. Requires the *invoice* positional argument. - **decrypt** Decode a message encrypted with a public key. Requires the *pubkey* and *encrypted* positional arguments. - **delete\_invoice** Delete an invoice. Requires the *invoice\_id* positional argument. - **delete\_request** Delete a request. Requires the *request\_id* positional argument. - **deserialize** Delete a serialized transaction. Requires the *tx* positional argument. - **dumpprivkeys** This command is deprecated. - **enable\_htlc\_settle** Enable Hashed TimeLock Contract settlement. See https://www.investopedia.com/terms/h/hashed-timelock-contract.asp for more information. Requires the *b* positional argument. - **encrypt** Encrypt a message with a public key. Use quotes if the message contains whitespace. Requires the *pubkey* and *message* positional arguments. - **export\_channel\_backup** Export the channel backup. Requires the *channel\_point* positional argument. - **freeze** Freeze the funds in one of your wallet's addresses. Requires the *address* positional argument. - **freeze\_utxo** Freeze a UTXO (Unspent Transaction Output) so that the wallet will not spend it. See https://river.com/learn/bitcoins-utxo-model for more information. Requires the *coin* positional argument. - **get** Return an item from the wallet storage. Requires the *key* positional argument. - **get\_channel\_ctx** Return the current channel's commitment transaction. Requires the *channel\_point* positional argument. - **get\_invoice** Return the specified invoice (request for outgoing payment). Requires the *invoice\_id* positional argument. - **get\_request** Return the specified payment request. Requires the *request\_id* positional argument. - **get\_tx\_status** Return information regarding the transaction (for now, only the number of confirmations). The transaction must be related to the wallet. Requires the *txid* positional argument. - **get\_watchtower\_ctn** Return the local watchtower's CTN of channel. Used in regtests. Requires the *channel\_point* positional argument. - **getaddressbalance** Return the balance of a Bitcoin address. Note that this is a walletless server query, meaning that the results are not checked by SPV (Simple Payment Verification). Requires the *address* positional argument. - **getaddresshistory** Return the transaction history of a Bitcoin address. Note that this is a walletless server query, meaning that the results are not checked by SPV (Simple Payment Verification). Requires the *address* positional argument. - **getaddressunspent** Return the UTXO (Unspent Transaction Output) list of a Bitcoin address. Note that this is a walletless server query, meaning that the results are not checked by SPV (Simple Payment Verification). Requires the *address* positional argument. - **getalias** Retrieve an alias. This looks in your list of contacts, and for an OpenAlias DNS record. Requires the *key* positional argument. - **getbalance** Return the balance of your wallet. - **getconfig** Return a configuration variable. Requires the *key* positional argument. - **getfeerate** Return the current suggested fee rate (in sat/kvByte), according to the config settings or the supplied parameters. - **getinfo** Return the current network information. - **getmasterprivate** Return the wallet's master private key. - **getmerkle** Return the Merkle branch of a transaction included in a block. Electrum uses this to verify transactions (Simple Payment Verification). Requires the *txid* and *height* positional arguments. - **getminacceptablegap** Return the minimum value for gap limit that would be sufficient to discover all known addresses in the wallet. - **getmpk** Return the wallet's master public key. - **getprivatekeyforpath** Return the private key corresponding to a derivation path (address index). *path* can be either a str such as "m/0/50" or a list of ints such as \[0, 50\]. See https://learnmeabitcoin.com/technical/derivation-paths for more information. Requires the *path* positional argument. - **getprivatekeys** Return the private key of an address. You may pass a single wallet address or a list of wallet addresses. Requires the *address* positional argument. - **getpubkeys** Return the public key of an address. Requires the *address* positional argument. - **getseed** Return the wallet's generation seed phrase. - **getservers** Return the list of known servers (connections candidates). - **gettransaction** Return a transaction. Requires the *txid* positional argument. - **getunusedaddress** Return the wallet's first unused address, or None if all addresses are used. An address is considered to be used if it has received a transaction or if it is used in a payment request. - **help** Display help information. This is the same as the **-h** and **--help** options. Calling **help** followed by another command will display specific options for that command. - **import\_channel\_backup** Import a channel backup. Requires the *encrypted* positional argument. - **importprivkey** Import a private key. If you want to be prompted for an argument in a concealed fashion, use '?' for the argument value. Requires the *privkey* positional argument. - **is\_synchronized** Return the wallet synchronization status. - **ismine** Check if address is in the wallet. Requires the *address* positional argument. - **lightning\_history** Return the lightning history. - **list\_channels** Return a list of the channels. - **list\_invoices** Return a list of invoices (requests for outgoing payments) saved in the wallet. - **list\_peers** Return a list of lightning peers. - **list\_requests** Return a list of incoming payment requests saved in the wallet. - **list\_wallets** Return a list of wallets open in the daemon. - **listaddresses** Return a list of all addresses in the wallet. Use options to filter the results. - **listcontacts** Return a list of contacts. - **listunspent** Return a list of unspent transaction outputs in the wallet. - **lnpay** Lightning Pay. Requires the *invoice* positional argument. - **load\_wallet** Load a wallet in the daemon. - **make\_seed** Create a seed. - **nodeid** Return the lightning node ID. - **normal\_swap** Perform a normal submarine swap, which is to send on-chain BTC and receive on Lightning. Note that your funds will be locked for 24h if you do not have enough incoming capacity. Requires the *onchain\_amount* and *lightning\_amount* positional arguments. - **notify** Watch an address. Every time the address changes, a HTTP POST is sent to the URL. Call with an empty URL to stop watching an address. Requires the *address* and *URL* positional arguments. - **onchain\_history** Return the on-chain transaction history of the wallet. - **open\_channel** Open a channel. Requires the *connection\_string* and *amount* positional arguments. - **password** Change the wallet password. - **payto** Create a transaction. Requires the *destination* and *amount* positional arguments. - **paytomany** Create a multi-output transaction. Requires the *outputs* positional argument. - **rebalance\_channels** Rebalance the channels. If trampoline is used, the channels must be with different trampolines. Requires the *from\_scid*, *dest\_scid*, and *amount* positional arguments. - **removelocaltx** Remove a local transaction, and it dependent transactions, from the wallet. Requires the *txid* positional argument. - **request\_force\_close** Request the remove to force-close a channel. If a connection string is passed, it can be used without having a state or any backup for the channel. Assumes that the channel was originally opened with the same local peer (node\_keypair). Requires the *channel\_point* positional argument. - **reset\_liquidity\_hints** Reset the liquidity hints. - **restore** Restore a wallet from text, which can be a seed phrase, a master public key, a master private key, a list of Bitcoin addresses, or a list of Bitcoin private keys. If you want to be prompted for the text in a concealed fashion, use '?' or ':' for the argument value. Requires the *text* positional argument. - **reverse\_swap** Perform a reverse submarine swap, which is to send on Lightning and receive on-chain BTC. Requires the *lighting\_amount* and *onchain\_amount* positional arguments. - **searchcontacts** Return contacts that match the query. Requires the *query* positional argument. - **serialize** Create a signed raw transaction from a JSON transaction template. An example value for the *jsontx* argument would be: { "inputs": \[ {"prevout\_hash": "9d221a69ca3997cbeaf5624d723e7dc5f829b1023078c177d37bdae95f37c539", "prevout\_n": 1, "value\_sats": 1000000, "privkey": "p2wpkh:cVDXzzQg6RoCTfiKpe8MBvmm5d5cJc6JLuFApsFDKwWa6F5TVHpD"} \], "outputs": \[ {"address": "tb1q4s8z6g5jqzllkgt8a4har94wl8tg0k9m8kv5zd", "value\_sats": 990000} \] }. Requires the *jsontx* positional argument. - **setconfig** Set a configuration variable. *value* may be a string or a Python expression. Requires the *key* and *value* positional arguments. - **setlabel** Assign a label to a Bitcoin address or a transaction ID. Requires the *key* and *label* positional arguments. - **signmessage** Sign a message with the address key. Use quotes if the message contain whitespaces. Requires the *address* and *message* positional arguments. - **signtransaction** Sign a transaction with the wallet keys. Requires the *tx* positional argument. - **signtransaction\_with\_privkey** Sign a transaction with the provided list of private keys. Requires the *tx* and *privkey* positional argument. - **stop** Stop the daemon. - **sweep** Sweep a private key, which return a transaction that spends UTXOs (Unspent Transaction Outputs) from the private key to a destination address. The transaction is not broadcast. Requires the *privkey* and *destination* positional arguments. - **unfreeze** Unfreeze the funds in one of your wallet's addresses. Requires the *address* positional argument. - **unfreeze\_utxo** Unfreeze a UTXO (Unspent Transaction Output) so that the wallet will can spend it. See https://river.com/learn/bitcoins-utxo-model for more information. Requires the *coin* positional argument. - **validateaddress** Check that an address is valid. Requires the *address* positional argument. - **verifymessage** Verify a message signature. Requires the *address*, *signature*, and *message* positional arguments. - **version** Display the version information. This is the same as the **--version** option. - **version\_info** Display information about dependencies, such as their version and path. ## OPTIONS - **-h**, **--help** Display help information. This is the same as using the **help** command with no arguments. Can be used by any command. - **--version** Display the version. This is the same as using the **version** command. Typically used without any command. - **--addtransaction** Specify whether to add the transaction to the wallet, so that it can be used for broadcasting afterwards. Can be used by the **payto** and **paytomany** commands. - **-b**, **--balance** Show the balances of the listed addresses. Can be used by the **listaddresses** command. - **-c** *CHANGE\_ADDR***, --change\_addr** *CHANGE\_ADDR* Change the address. The default is a spare address, or the source address if it is not in the wallet. Can be used by the **payto** and **paytomany** commands. - **--change** Show only change addresses. Can be used by the **listaddresses** command. - **--connection\_string** *CONNECTION\_STRING* The Lightning network node ID or network address. Can be used by the **request\_force\_close** command. - **-d**, **--detached** Run the daemon in detached mode. Can be used by the **daemon** command. - **--daemon** Keep the daemon running after the GUI exits. Can be used by the **gui** command. - **--decrease\_payment** Specify whether the payment amount will be decreased (true/false). Can be used by the **bumpfee** command. - **--encrypt\_file** *ENCRYPT\_FILE* Specify whether the file on disk should be encrypted with the provided password. Can be used by the **create**, **password**, and **restore** commands. - **--expired** Show only expired requests. Can be used by the **list\_invoices** and **list\_requests** commands. - **--expiry** *EXPIRY* The expiry time in seconds. Can be used by the **add\_request** command. - **-f** *SERVERFINGERPRINT***, --serverfingerprint** *SERVERFINGERPRINT* Only connect to servers with a matching SSL certificate SHA256 fingerprint. To calculate this yourself: '$ openssl x509 -noout -fingerprint -sha256 -inform pem -in servercertfile.crt'. The server fingerprint should be entered as 64 hexadecimal characters. Can be used by the **gui** and **daemon** commands. - **-f** *FEE***, --fee** *FEE* The transaction fee (absolute, in BTC). Can be used by the **payto**, **paytomany**, and **sweep** commands. - **-F** *FROM\_ADDR***, --from\_addr** *FROM\_ADDR* The source address, which must be a wallet address. Use **sweep** to spend from a non-wallet address. Can be used by the **payto** and **paytomany** commands. - **--feerate** *FEERATE* The transaction fee rate (in sat/byte). Can be used by the **payto** and **paytomany** commands. - **--fee\_level** *FEE\_LEVEL* A float between 0.0 and 1.0, representing the fee slider position. Can be used by the **getfeerate** command. - **--fee\_method** *FEE\_METHOD* The fee estimation method to use. Can be used by the **getfeerate** command. - **--force** Create a new address beyond the gap limit if no more addresses are available. Can be used by the **add\_request** command. - **--forgetconfig** Forget the config on exit. Can be used by the **gui**, **add\_peer**, **add\_request**, **addtransaction**, **bumpfee**, **changegaplimit**, **clear\_invoices**, **clear\_requests**, **close\_channel**, **close\_wallet**, **create**, **createnewaddress**, **decrypt**, **delete\_invoice**, **delete\_request**, **enable\_htlc\_settle**, **export\_channel\_backup**, **freeze**, **freeze\_utxo**, **get**, **get\_channel\_ctx**, **get\_invoice**, **get\_request**, **get\_tx\_status**, **get\_watchtower\_ctn**, **getalias**, **getbalance**, **getmasterprivate**, **getminacceptablegap**, **getmpk**, **getprivatekeyforpath**, **getprivatekeys**, **getpubkeys**, **getseed**, **gettransaction**, **getunusedaddress**, **import\_channel\_backup**, **importprivkey**, **is\_synchronized**, **ismine**, **lightning\_history**, **list\_channels**, **list\_invoices**, **list\_peers**, **list\_requests**, **listaddresses**, **listcontacts**, **listunspent**, **lnpay**, **load\_wallet**, **nodeid**, **normal\_swap**, **onchain\_history**, **open\_channel**, **password**, **payto**, **paytomany**, **rebalance\_channels**, **removelocaltx**, **request\_force\_close**, **restore**, **reverse\_swap**, **searchcontacts**, **setlabel**, **signmessage**, **signtransaction**, **unfreeze**, and **unfreeze\_utxo** commands. - **--from\_amount** *FROM\_AMOUNT* The amount to convert (the default is 1). Can be used by the **convert\_currency** command. - **--from\_ccy** *FROM\_CCY* The currency to convert from. Can be used by the **convert\_currency** command. - **--from\_coins** *FROM\_COINS* The source coins, which must be in the wallet. Use **sweep** to spend from a non-wallet address. Can be used by the **bumpfee**, **payto**, and **paytomany** commands. - **--from\_height** *FROM\_HEIGHT* Only show transactions that confirmed after the specified block height. Can be used by the **onchain\_history** command. - **--frozen** Show only frozen addresses. Can be used by the **listaddresses** command. - **--funded** Show only funded addresses. Can be used by the **listaddresses** command. - **-g** *GUI***, --GUI** *GUI* Specify the GUI. Valid arguments are 'qt', 'kivy', 'text', 'stdio', and 'qml'. The default is Qt. Kivy and QML are used for the Android GUI and are not included in the Debian package. The text dependencies are also not included in the Debian package. Can be used by the **gui** command. - **--gossip** Apply the command to the gossip node instead of the wallet. Can be used by the **add\_peer** and **list\_peers** commands. - **--iknowwhatiamdoing** Acknowledge that you understand the full implications of what you are about to do. Can be used by the **changegaplimit** and **get\_channel\_ctx** commands. - **--imax** *IMAX* Specify the maximum number of inputs. Can be used by the **sweep** command. - **-l**, **--labels** Show the labels of the listed addresses. Can be used by the **listaddresses** command. - **-L** *LANGUAGE***, --lang** *LANGUAGE* Specify the language. Can be used by the **gui** and **make\_seed** commands. - **--locktime** *LOCKTIME* Set the locktime block number. Can be used by the **payto** and **paytomany** commands. - **-m** *MEMO***, --memo** *MEMO* The description of the request. Can be used by the **add\_request** command. - **--new\_password** *NEW\_PASSWORD* The new password. Can be used by the **password** command. - **--nbits** *NBITS* The number of bits of entropy. Can be used by the **make\_seed** command. - **--nocheck** Do not verify aliases. Can be used by the **payto**, **paytomany**, and **sweep** commands. - **--noonion** Do not connect to onion servers. Can be used by the **gui** and **daemon** commands. - **--nosegwit** Do not create SegWit (Segregated Witness) wallets. See https://en.wikipedia.org/wiki/SegWit for more information. Can be used by the **gui** command. - **-1**, **--oneserver** Only connect to one server. Can be used by the Can be used by the **gui** and **daemon** commands. - **-p** *PROXY***, --proxy** *PROXY* Specify the proxy using the \[*type*:\]*host*\[:*port*\] syntax (or 'none' to disable the proxy), where type is either 'socks4', 'socks5', or 'http'. Can be used by the **gui** and **daemon** commands. - **--paid** Show only paid requests. Can be used by the **list\_invoices** and **list\_requests** commands. - **--passphrase** *PASSPHRASE* The seed extension. Can be used by the **create** and **restore** commands. - **--pending** Show only pending requests. Can be used by the **list\_invoices** and **list\_requests** commands. - **--push\_amount** *PUSH\_AMOUNT* The push initial amount (in BTC). Can be used by the **open\_channel** command. - **--rbf** *RBF* Specify whether to signal opt-in Replace-By-Fee in the transaction (true/false). Can be used by the **payto and paytomany** commands. - **--receiving** Show only receiving addresses. Can be used by the **listaddresses** command. - **--rpchost** *RPCHOST* The RPC host used by the RPC daemon. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. Can be used by the **daemon** command. - **--rpcport** *RPCPORT* The RPC port used by the RPC daemon. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. Can be used by the **daemon** command. - **--rpcsock** *TYPE* The RPC socket type used by the RPC daemon. Valid arguments are 'unix', 'tcp', and 'auto'. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. Can be used by the **daemon** command. - **--rpcsockpath** *TYPE* The RPC socket file location used by the RPC daemon. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. Can be used by the **daemon** command. - **-s** *SERVER***, --server** *SERVER* Specify the server using the *host*:*port*:*protocol* syntax, where protocol is either 't' (TCP) or 's' (SSL). Can be used by the **gui** and **daemon** commands. - **--seed\_type** *SEED\_TYPE* Specify the seed type. Valid arguments are 'standard', 'segwit', '2fa', and '2fa\_segwit'. The default is 'segwit'. Can be used by the **create** and **make\_seed** commands. - **--show\_addresses** Show the input and output addresses. Can be used by the **onchain\_history** command. - **--show\_fiat** Show the fiat value of transactions. Can be used by the **lightning\_history** and **onchain\_history** commands. - **--skipmerklecheck** Tolerate invalid Merkle proofs from the server. See https://medium.com/crypto-0-nite/merkle-proofs-explained-6dd429623dc5 for more information. Can be used by the **gui** and **daemon** commands. - **--timeout** *TIMEOUT* The timeout in seconds. Can be used by the **add\_peer** and **lnpay** commands. - **--to\_ccy** *TO\_CCY* The currency to convert to. Can be used by the **convert\_currency** command. - **--to\_height** *TO\_HEIGHT* Only show transactions that confirmed before the specified block height. Can be used by the **onchain\_history** command. - **-u**, **--unsigned** Do not sign the transaction. Can be used by the **bumpfee**, **payto**, and **paytomany** commands. - **--unused** Show only unused addresses. Can be used by the **listaddresses** command. - **-w** *WALLET\_PATH***, --wallet** *WALLET\_PATH* Set the wallet path. Can be used by the **gui**, **add\_peer**, **add\_request**, **addtransaction**, **bumpfee**, **changegaplimit**, **clear\_invoices**, **clear\_requests**, **close\_channel**, **close\_wallet**, **create**, **createnewaddress**, **decrypt**, **delete\_invoice**, **delete\_request**, **enable\_htlc\_settle**, **export\_channel\_backup**, **freeze**, **freeze\_utxo**, **get**, **get\_channel\_ctx**, **get\_invoice**, **get\_request**, **get\_tx\_status**, **get\_watchtower\_ctn**, **getalias**, **getbalance**, **getmasterprivate**, **getminacceptablegap**, **getmpk**, **getprivatekeyforpath**, **getprivatekeys**, **getpubkeys**, **getseed**, **gettransaction**, **getunusedaddress**, **import\_channel\_backup**, **importprivkey**, **is\_synchronized**, **ismine**, **lightning\_history**, **list\_channels**, **list\_invoices**, **list\_peers**, **list\_requests**, **listaddresses**, **listcontacts**, **listunspent**, **lnpay**, **load\_wallet**, **nodeid**, **normal\_swap**, **onchain\_history**, **open\_channel**, **password**, **payto**, **paytomany**, **rebalance\_channels**, **removelocaltx**, **request\_force\_close**, **restore**, **reverse\_swap**, **searchcontacts**, **setlabel**, **signmessage**, **signtransaction**, **unfreeze**, and **unfreeze\_utxo** commands. - **-W** *PASSWORD***, --password** *PASSWORD* The password. Can be used by the **bumpfee**, **create**, **decrypt**, **getmasterprivate**, **getprivatekeyforpath**, **getprivatekeys**, **getseed**, **importprivkey**, **load\_wallet**, **normal\_swap**, **open\_channel**, **password**, **payto**, **paytomany**, **restore**, **signmessage**, and **signtransaction** commands. - **--year** *YEAR* Show history for a given year. Can be used by the **onchain\_history** command. ## GLOBAL OPTIONS - **-D** *ELECTRUM\_PATH***, --dir** *ELECTRUM\_PATH* Set the electrum data directory. The default is ~/.electrum. - **-o**, **--offline** Run electrum in offline mode. - **-P**, **--portable** Run electrum in portable mode, which uses ./electrum\_data (electrum\_data in the current directory) instead of ~/.electrum for the data directory. - **--rpcuser** *RPCUSER* Set the RPC user. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. - **--rpcpassword** *RPCPASSWORD* Set the RPC password. See https://electrum.readthedocs.io/en/latest/jsonrpc.html for more information. - **--regtest** Run in regtest (regression test) mode. The default data directory is ~/.electrum/regtest. See https://developer.bitcoin.org/examples/testing.html and https://bitcoin.stackexchange.com/questions/98462/how-to-use-electrum-with-a-local-regtest-network for more information. - **--simnet** Run in simnet (simulation test network) mode. The default data directory is ~/.electrum/simnet. See https://bitcoin.stackexchange.com/questions/81260/bitcoin-node-what-is-the-difference-between-simnet-and-regtest for more information. - **--signet** Run in signet (signature network), which is similar to testnet but adds a signature requirement for block verification. The default data directory is ~./electrum/signet. See https://en.bitcoin.it/wiki/Signet for more information. - **--testnet** Run in testnet mode, which connects to Bitcoin's testnet network instead of the mainnet one. The coins on testnet have no value, which allows users to safely test functionality without risk. The default data directory is ~/.electrum/testnet. See https://developer.bitcoin.org/examples/testing.html for more information. - **-v** *VERBOSITY* Set the verbosity (log level). - **-V** *VERBOSITY\_SHORTCUTS* Set the verbosity (shortcut-filter list). ## POSITIONAL ARGUMENTS - *address* The Bitcoin address. Can be used by the **freeze**, **getaddressbalance**, **getaddresshistory**, **getaddressunspent**, **getprivatekeys**, **getpubkeys**, **ismine**, **notify**, **signmessage**, **unfreeze**, **validateaddress**, and **verifymessage** commands. - *amount* The amount to be sent (in BTC). Use '!' to send the maximum available. Can be used by the **add\_request**, **open\_channel**, **payto**, and **rebalance\_channels** commands. - *b* B. Can be used by the **enable\_htlc\_settle** command. - *channel\_point* The channel point. Can be used by the **close\_channel**, **export\_channel\_backup**, **get\_channel\_ctx**, **get\_watchtower\_ctn**, and **request\_force\_close** commands. - *coin* The coin, otherwise known as the UTXO (Unspent Transaction Output). Can be used by the **freeze\_utxo** and **unfreeze\_utxo** commands. - *connection\_string* The Lightning network node ID or network address. Can be used by the **add\_peer** and **open\_channel** commands. - *dest\_scid* The destination Short Channel Identifier. Can be used by the **rebalance\_channels** command. - *destination* A Bitcoin address, contact, or alias. Can be used by the **payto** and **sweep** commands. - *encrypted* The encrypted message. Can be used by the **decrypt** and **import\_channel\_backup** commands. - *from\_scid* The from Short Channel Identifier. Can be used by the **rebalance\_channels** command. - *height* The block height. Can be used by the **getmerkle** command. - *invoice* The invoice. Can be used by the **decode\_invoice** and **lnpay** commands. - *invoice\_id* The invoice ID. Can be used by the **delete\_invoice** and **get\_invoice** commands. - *jsontx* The JSON transaction. An example value would be: { "inputs": \[ {"prevout\_hash": "9d221a69ca3997cbeaf5624d723e7dc5f829b1023078c177d37bdae95f37c539", "prevout\_n": 1, "value\_sats": 1000000, "privkey": "p2wpkh:cVDXzzQg6RoCTfiKpe8MBvmm5d5cJc6JLuFApsFDKwWa6F5TVHpD"} \], "outputs": \[ {"address": "tb1q4s8z6g5jqzllkgt8a4har94wl8tg0k9m8kv5zd", "value\_sats": 990000} \] }. Can be used by the **serialize** command. - *key* The variable name. Can be used by the **get**, **getalias**, **getconfig**, **setconfig**, and **setlabel** commands. - *label* The label. Can be used by the **setlabel** command. - *lightning\_amount* The amount sent or received in a submarine swap. Set it to 'dryrun' to receive a value. Can be used by the **normal\_swap** and **reverse\_swap** commands. - *message* The message. Use quotes if it contains whitespaces. Can be used by the **encrypt**, **signmessage**, and **verifymessage** commands. - *new\_fee\_rate* The new fee rate. Can be used by the **bumpfee** command. - *new\_limit* The new gap limit. Can be used by the **changegaplimit** command. - *num* The number of signatures. Can be used by the **createmultisig** command. - *onchain\_amount* The amount sent or received in a submarine swap. Set it to 'dryrun' to receive a value. Can be used by the **normal\_swap** and **reverse\_swap** commands. - *outputs* A list of \["address", amount \]. Can be used by the **paytomany** command. - *path* The derivation path (address index). Can be used by the **getprivatekeyforpath** command. - *privkey* The private key. In the case of **signtransaction\_with\_privkey** a list of private keys can be used. If you want to be prompted for the *privkey* in a concealed fashion, use '?' for the argument value. Can be used by the **getprivatekeyforpath**, **importprivkey**, **signtransaction\_with\_privkey**, and **sweep** commands. - *pubkey* The public key. Can be used by the **decrypt** and **encrypt** commands. - *pubkeys* The public keys. Can be used by the **createmultisig** command. - *query* The query. Can be used by the **searchcontacts** command. - *requset\_id* The request ID. Can be used by the **delete\_request** and **get\_request** commands. - *signature* The signature. Can be used by the **verifymessage** command. - *text* The text, which can be a seed phrase, a master public key, a master private key, a list of Bitcoin addresses, or a list of Bitcoin private keys. If you want to be prompted for the text in a concealed fashion, use '?' or ':' for the argument value. Can be used by the **restore** command. - *tx* A serialized transaction in hexadecimal. Can be used by the **addtransaction**, **broadcast**, **bumpfee**, **deserialize**, **signtransaction**, and **signtransaction\_with\_privkey** commands. - *txid* The transaction ID. Can be used by the **get\_tx\_status**, **getmerkle**, **gettransaction**, and **removelocaltx** commands. - *value* The value, which may be a string or a Python expression. Can be used by the **setconfig** command. - *url* A Bitcoin URI or a BIP70 file. The Bitcoin URI syntax is bitcoin:*address*\[?amount=*amount*\]\[?label=*label*\]\[?message=*message*\]. Can be used by the **gui** command. - *URL* A standard web URL that can receive HTTP POST commands. Can be used by the **notify** command. - *xkey* The XKey. Can be used by the **convert\_xkey** command. - *xtype* The XType. Can be used by the **convert\_xkey** command. ## AUTHOR Documentation author: Soren Stoutner \