loop/docs/loop.1

.nh
.TH loop 1

.SH NAME
.PP
loop - control plane for your loopd


.SH SYNOPSIS
.PP
loop

.PP
.RS

.nf
[--help|-h]
[--loopdir]=[value]
[--macaroonpath]=[value]
[--network|-n]=[value]
[--rpcserver]=[value]
[--tlscertpath]=[value]
[--version|-v]

.fi
.RE

.PP
\fBUsage\fP:

.PP
.RS

.nf
loop [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]

.fi
.RE


.SH GLOBAL OPTIONS
.PP
\fB--help, -h\fP: show help

.PP
\fB--loopdir\fP="": path to loop's base directory (default: ~/.loop)

.PP
\fB--macaroonpath\fP="": path to macaroon file (default: ~/.loop/mainnet/loop.macaroon)

.PP
\fB--network, -n\fP="": the network loop is running on e.g. mainnet, testnet, etc. (default: mainnet)

.PP
\fB--rpcserver\fP="": loopd daemon address host:port (default: localhost:11010)

.PP
\fB--tlscertpath\fP="": path to loop's TLS certificate (default: ~/.loop/mainnet/tls.cert)

.PP
\fB--version, -v\fP: print the version


.SH COMMANDS
.SH out
.PP
perform an off-chain to on-chain swap (looping out)

.PP
\fB--account\fP="": the name of the account to generate a new address from. You can list the names of valid accounts in your backing lnd instance with "lncli wallet accounts list"

.PP
\fB--account_addr_type\fP="": the address type of the extended public key specified in account. Currently only pay-to-taproot-pubkey(p2tr) is supported (default: p2tr)

.PP
\fB--addr\fP="": the optional address that the looped out funds should be sent to, if let blank the funds will go to lnd's wallet

.PP
\fB--amt\fP="": the amount in satoshis to loop out. To check for the minimum and maximum amounts to loop out please consult "loop terms" (default: 0)

.PP
\fB--asset_edge_node\fP="": the pubkey of the edge node of the asset to loop out, this is required if the taproot assets daemon has multiple channels of the given asset id with different edge nodes

.PP
\fB--asset_id\fP="": the asset ID of the asset to loop out, if this is set, the loop daemon will require a connection to a taproot assets daemon

.PP
\fB--channel\fP="": the comma-separated list of short channel IDs of the channels to loop out

.PP
\fB--conf_target\fP="": the number of blocks from the swap initiation height that the on-chain HTLC should be swept within (default: 9)

.PP
\fB--fast\fP: indicate you want to swap immediately, paying potentially a higher fee. If not set the swap server might choose to wait up to 30 minutes before publishing the swap HTLC on-chain, to save on its chain fees. Not setting this flag therefore might result in a lower swap fee

.PP
\fB--force\fP: Assumes yes during confirmation. Using this option will result in an immediate swap

.PP
\fB--help, -h\fP: show help

.PP
\fB--htlc_confs\fP="": the number of confirmations (in blocks) that we require for the htlc extended by the server before we reveal the preimage (default: 1)

.PP
\fB--label\fP="": an optional label for this swap,limited to 500 characters. The label may not start with our reserved prefix: [reserved].

.PP
\fB--max_swap_routing_fee\fP="": the max off-chain swap routing fee in satoshis, if not specified, a default max fee will be used (default: 0)

.PP
\fB--payment_timeout\fP="": the timeout for each individual off-chain payment attempt. If not set, the default timeout of 1 hour will be used. As the payment might be retried, the actual total time may be longer (default: 0s)

.PP
\fB--verbose, -v\fP: show expanded details

.SH in
.PP
perform an on-chain to off-chain swap (loop in)

.PP
\fB--amt\fP="": the amount in satoshis to loop in. To check for the minimum and maximum amounts to loop in please consult "loop terms" (default: 0)

.PP
\fB--conf_target\fP="": the target number of blocks the on-chain htlc broadcast by the swap client should confirm within (default: 0)

.PP
\fB--external\fP: expect htlc to be published externally

.PP
\fB--force\fP: Assumes yes during confirmation. Using this option will result in an immediate swap

.PP
\fB--help, -h\fP: show help

.PP
\fB--label\fP="": an optional label for this swap,limited to 500 characters. The label may not start with our reserved prefix: [reserved].

.PP
\fB--last_hop\fP="": the pubkey of the last hop to use for this swap

.PP
\fB--private\fP: generates and passes routehints. Should be used if the connected node is only reachable via private channels

.PP
\fB--route_hints\fP="": route hints that can each be individually used to assist in reaching the invoice's destination (default: [])

.PP
\fB--verbose, -v\fP: show expanded details

.SH terms
.PP
Display the current swap terms imposed by the server.

.PP
\fB--help, -h\fP: show help

.SH monitor
.PP
monitor progress of any active swaps

.PP
\fB--help, -h\fP: show help

.SH quote
.PP
get a quote for the cost of a swap

.PP
\fB--help, -h\fP: show help

.SS in
.PP
get a quote for the cost of a loop in swap

.PP
\fB--conf_target\fP="": the target number of blocks the on-chain htlc broadcast by the swap client should confirm within (default: 0)

.PP
\fB--deposit_outpoint\fP="": one or more static address deposit outpoints to quote for. Deposit outpoints are not to be used in combination with an amount. Eachadditional outpoint can be added by specifying --deposit_outpoint tx_id:idx (default: [])

.PP
\fB--help, -h\fP: show help

.PP
\fB--last_hop\fP="": the pubkey of the last hop to use for the quote

.PP
\fB--private\fP: generates and passes routehints. Should be used if the connected node is only reachable via private channels

.PP
\fB--route_hints\fP="": route hints that can each be individually used to assist in reaching the invoice's destination (default: [])

.PP
\fB--verbose, -v\fP: show expanded details

.SS out
.PP
get a quote for the cost of a loop out swap

.PP
\fB--conf_target\fP="": the number of blocks from the swap initiation height that the on-chain HTLC should be swept within in a Loop Out (default: 9)

.PP
\fB--fast\fP: Indicate you want to swap immediately, paying potentially a higher fee. If not set the swap server might choose to wait up to 30 minutes before publishing the swap HTLC on-chain, to save on chain fees. Not setting this flag might result in a lower swap fee.

.PP
\fB--help, -h\fP: show help

.PP
\fB--verbose, -v\fP: show expanded details

.SH listauth
.PP
list all L402 tokens

.PP
\fB--help, -h\fP: show help

.SH fetchl402
.PP
fetches a new L402 authentication token from the server

.PP
\fB--help, -h\fP: show help

.SH listswaps
.PP
list all swaps in the local database

.PP
\fB--channel\fP="": the comma-separated list of short channel IDs of the channels to loop out

.PP
\fB--help, -h\fP: show help

.PP
\fB--label\fP="": an optional label for this swap,limited to 500 characters. The label may not start with our reserved prefix: [reserved].

.PP
\fB--last_hop\fP="": the pubkey of the last hop to use for this swap

.PP
\fB--loop_in_only\fP: only list swaps that are loop in swaps

.PP
\fB--loop_out_only\fP: only list swaps that are loop out swaps

.PP
\fB--max_swaps\fP="": Max number of swaps to return after filtering (default: 0)

.PP
\fB--pending_only\fP: only list pending swaps

.PP
\fB--start_time_ns\fP="": Unix timestamp in nanoseconds to select swaps initiated after this time (default: 0)

.SH swapinfo
.PP
show the status of a swap

.PP
\fB--help, -h\fP: show help

.PP
\fB--id\fP="": the ID of the swap (default: 0)

.SH getparams
.PP
show liquidity manager parameters

.PP
\fB--help, -h\fP: show help

.SH setrule
.PP
set liquidity manager rule for a channel/peer

.PP
\fB--clear\fP: remove the rule currently set for the channel/peer.

.PP
\fB--help, -h\fP: show help

.PP
\fB--incoming_threshold\fP="": the minimum percentage of incoming liquidity to total capacity beneath which to recommend loop out to acquire incoming. (default: 0)

.PP
\fB--outgoing_threshold\fP="": the minimum percentage of outbound liquidity that we do not want to drop below. (default: 0)

.PP
\fB--type\fP="": the type of swap to perform, set to 'out' for acquiring inbound liquidity or 'in' for acquiring outbound liquidity. (default: out)

.SH suggestswaps
.PP
show a list of suggested swaps

.PP
\fB--help, -h\fP: show help

.SH setparams
.PP
update the parameters set for the liquidity manager

.PP
\fB--account\fP="": the name of the account to generate a new address from. You can list the names of valid accounts in your backing lnd instance with "lncli wallet accounts list".

.PP
\fB--account_addr_type\fP="": the address type of the extended public key specified in account. Currently only pay-to-taproot-pubkey(p2tr) is supported (default: p2tr)

.PP
\fB--asset_easyautoloop\fP: set to true to enable asset easy autoloop, which will automatically dispatch asset swaps in order to meet the target local balance.

.PP
\fB--asset_id\fP="": If set to a valid asset ID, the easyautoloop and localbalancesat flags will be set for the specified asset.

.PP
\fB--asset_localbalance\fP="": the target size of total local balance in asset units, used by asset easy autoloop. (default: 0)

.PP
\fB--autobudget\fP="": the maximum amount of fees in satoshis that automatically dispatched loop out swaps may spend. (default: 0)

.PP
\fB--autobudgetrefreshperiod\fP="": the time period over which the automated loop budget is refreshed. (default: 0s)

.PP
\fB--autoinflight\fP="": the maximum number of automatically dispatched swaps that we allow to be in flight. (default: 0)

.PP
\fB--autoloop\fP: set to true to enable automated dispatch of swaps, limited to the budget set by autobudget.

.PP
\fB--destaddr\fP="": custom address to be used as destination for autoloop loop out, set to "default" in order to revert to default behavior.

.PP
\fB--easyatutoloop_includeallpeers\fP: include all peers back into easy autoloop by clearing the exclusion list. It cannot be combined with --easyautoloop_excludepeer

.PP
\fB--easyautoloop\fP: set to true to enable easy autoloop, which will automatically dispatch swaps in order to meet the target local balance.

.PP
\fB--easyautoloop_excludepeer\fP="": list of peer pubkeys (hex) to exclude from easy autoloop channel selection; repeat --easyautoloop_excludepeer for multiple peers (default: [])

.PP
\fB--failurebackoff\fP="": the amount of time, in seconds, that should pass before a channel that previously had a failed swap will be included in suggestions. (default: 0)

.PP
\fB--fast\fP: if set new swaps are expected to be published immediately, paying a potentially higher fee. If not set the swap server might choose to wait up to 30 minutes before publishing swap HTLCs on-chain, to save on chain fees. Not setting this flag therefore might result in a lower swap fees

.PP
\fB--feepercent\fP="": the maximum percentage of swap amount to be used across all fee categories (default: 0)

.PP
\fB--help, -h\fP: show help

.PP
\fB--htlc_conf\fP="": the confirmation target for loop in on-chain htlcs. (default: 0)

.PP
\fB--localbalancesat\fP="": the target size of total local balance in satoshis, used by easy autoloop. (default: 0)

.PP
\fB--maxamt\fP="": the maximum amount in satoshis that the autoloop client will dispatch per-swap. (default: 0)

.PP
\fB--maxminer\fP="": the maximum miner fee in satoshis that swap suggestions should be limited to. (default: 0)

.PP
\fB--maxprepay\fP="": the maximum no-show (prepay) in satoshis that swap suggestions should be limited to. (default: 0)

.PP
\fB--maxprepayfee\fP="": the maximum percentage of off-chain prepay volume that we are willing to pay in routing fees. (default: 0)

.PP
\fB--maxroutingfee\fP="": the maximum percentage of off-chain payment volume that we are willing to pay in routingfees. (default: 0)

.PP
\fB--maxswapfee\fP="": the maximum percentage of swap volume we are willing to pay in server fees. (default: 0)

.PP
\fB--minamt\fP="": the minimum amount in satoshis that the autoloop client will dispatch per-swap. (default: 0)

.PP
\fB--sweepconf\fP="": the number of blocks from htlc height that swap suggestion sweeps should target, used to estimate max miner fee. (default: 0)

.PP
\fB--sweeplimit\fP="": the limit placed on our estimated sweep fee in sat/vByte. (default: 0)

.SH getinfo
.PP
show general information about the loop daemon

.PP
\fB--help, -h\fP: show help

.SH abandonswap
.PP
abandon a swap with a given swap hash

.PP
\fB--help, -h\fP: show help

.PP
\fB--i_know_what_i_am_doing\fP: Specify this flag if you made sure that you read and understood the following consequence of applying this command.

.SH reservations, r
.PP
manage reservations

.PP
\fB--help, -h\fP: show help

.SS list, l
.PP
list all reservations

.PP
\fB--help, -h\fP: show help

.SH instantout
.PP
perform an instant off-chain to on-chain swap (looping out)

.PP
\fB--addr\fP="": the optional address that the looped out funds should be sent to, if let blank the funds will go to lnd's wallet

.PP
\fB--channel\fP="": the comma-separated list of short channel IDs of the channels to loop out

.PP
\fB--help, -h\fP: show help

.SH listinstantouts
.PP
list all instant out swaps

.PP
\fB--help, -h\fP: show help

.SH stop
.PP
stop the loop daemon

.PP
\fB--help, -h\fP: show help

.PP
\fB--wait\fP: wait until loopd fully shuts down

.SH static, s
.PP
perform on-chain to off-chain swaps using static addresses.

.PP
\fB--help, -h\fP: show help

.SS new, n
.PP
Create a new static loop in address.

.PP
\fB--help, -h\fP: show help

.SS listunspent, l
.PP
List unspent static address outputs.

.PP
\fB--help, -h\fP: show help

.PP
\fB--max_confs\fP="": The maximum number of confirmations an output could have to be listed. (default: 0)

.PP
\fB--min_confs\fP="": The minimum amount of confirmations an output should have to be listed. (default: 0)

.SS listdeposits
.PP
Displays static address deposits. A filter can be applied to only show deposits in a specific state.

.PP
\fB--filter\fP="": specify a filter to only display deposits in the specified state. Leaving out the filter returns all deposits.
The state can be one of the following:
deposited
withdrawing
withdrawn
looping_in
looped_in
opening_channel
channel_published
publish_expired_deposit
sweep_htlc_timeout
htlc_timeout_swept
wait_for_expiry_sweep
expired
failed
.

.PP
\fB--help, -h\fP: show help

.SS listwithdrawals
.PP
Display a summary of past withdrawals.

.PP
\fB--help, -h\fP: show help

.SS listswaps
.PP
Shows a list of finalized static address swaps.

.PP
\fB--help, -h\fP: show help

.SS withdraw, w
.PP
Withdraw from static address deposits.

.PP
\fB--all\fP: withdraws all static address deposits.

.PP
\fB--amt, --amount\fP="": the number of satoshis that should be withdrawn from the selected deposits. The change is sent back to the static address (default: 0)

.PP
\fB--dest_addr\fP="": the optional address that the withdrawn funds should be sent to, if let blank the funds will go to lnd's wallet

.PP
\fB--help, -h\fP: show help

.PP
\fB--sat_per_vbyte\fP="": (optional) a manual fee expressed in sat/vbyte that should be used when crafting the transaction (default: 0)

.PP
\fB--utxo\fP="": specify utxos as outpoints(tx:idx) which willbe withdrawn. (default: [])

.SS summary, s
.PP
Display a summary of static address related information.

.PP
\fB--help, -h\fP: show help

.SS in
.PP
Loop in funds from static address deposits.

.PP
\fB--all\fP: loop in all static address deposits.

.PP
\fB--amt, --amount\fP="": the number of satoshis that should be swapped from the selected deposits. If thereis change it is sent back to the static address. (default: 0)

.PP
\fB--fast\fP: Usage: complete the swap faster by paying a higher fee, so the change output is available sooner

.PP
\fB--force\fP: Assumes yes during confirmation. Using this option will result in an immediate swap

.PP
\fB--help, -h\fP: show help

.PP
\fB--label\fP="": an optional label for this swap,limited to 500 characters. The label may not start with our reserved prefix: [reserved].

.PP
\fB--last_hop\fP="": the pubkey of the last hop to use for this swap

.PP
\fB--max_swap_fee_ppm\fP="": the maximum swap fee expressed in parts per million of the swap amount. If set together with --max_swap_fee_sat the tighter cap is used. (default: 0)

.PP
\fB--max_swap_fee_sat\fP="": the maximum swap fee in satoshis. If set, the swap is rejected when the quoted fee exceeds this cap. The maximum allowed value is 10000000. On-chain fees for creating static deposits are unaffected. (default: 0)

.PP
\fB--payment_timeout\fP="": the maximum time in seconds that the server is allowed to take for the swap payment. The client can retry the swap with adjusted parameters after the payment timed out. (default: 0s)

.PP
\fB--private\fP: generates and passes routehints. Should be used if the connected node is only reachable via private channels

.PP
\fB--route_hints\fP="": route hints that can each be individually used to assist in reaching the invoice's destination (default: [])

.PP
\fB--utxo\fP="": specify the utxos of deposits as outpoints(tx:idx) that should be looped in. (default: [])

.PP
\fB--verbose, -v\fP: show expanded details

.SS openchannel
.PP
Open a channel to a an existing peer.

.PP
\fB--base_fee_msat\fP="": the base fee in milli-satoshis that will be charged for each forwarded HTLC, regardless of payment size (default: 0)

.PP
\fB--channel_type\fP="": (optional) the type of channel to propose to the remote peer ("tweakless", "anchors", "taproot")

.PP
\fB--close_address\fP="": (optional) an address to enforce payout of our funds to on cooperative close. Note that if this value is set on channel open, you will \fInot\fP be able to cooperatively close to a different address.

.PP
\fB--fee_rate_ppm\fP="": the fee rate ppm (parts per million) that will be charged proportionally based on the value of each forwarded HTLC, the lowest possible rate is 0 with a granularity of 0.000001 (millionths) (default: 0)

.PP
\fB--fundmax\fP: if set, the wallet will attempt to commit the maximum possible local amount to the channel. This must not be set at the same time as local_amt

.PP
\fB--help, -h\fP: show help

.PP
\fB--local_amt\fP="": the number of satoshis the wallet should commit to the channel (default: 0)

.PP
\fB--max_local_csv\fP="": (optional) the maximum number of blocks that we will allow the remote peer to require we wait before accessing our funds in the case of a unilateral close. (default: 0)

.PP
\fB--memo\fP="": (optional) a note-to-self containing some useful
				information about the channel. This is stored
				locally only, and is purely for reference. It
				has no bearing on the channel's operation. Max
				allowed length is 500 characters

.PP
\fB--min_htlc_msat\fP="": (optional) the minimum value we will require for incoming HTLCs on the channel (default: 0)

.PP
\fB--node_key\fP="": the identity public key of the target node/peer serialized in compressed format

.PP
\fB--private\fP: make the channel private, such that it won't be announced to the greater network, and nodes other than the two channel endpoints must be explicitly told about it to be able to route through it

.PP
\fB--push_amt\fP="": the number of satoshis to give the remote side as part of the initial commitment state, this is equivalent to first opening a channel and sending the remote party funds, but done all in one step (default: 0)

.PP
\fB--remote_csv_delay\fP="": (optional) the number of blocks we will require our channel counterparty to wait before accessing its funds in case of unilateral close. If this is not set, we will scale the value according to the channel size (default: 0)

.PP
\fB--remote_max_value_in_flight_msat\fP="": (optional) the maximum value in msat that can be pending within the channel at any given time (default: 0)

.PP
\fB--remote_reserve_sats\fP="": (optional) the minimum number of satoshis we require the remote node to keep as a direct payment. If not specified, a default of 1% of the channel capacity will be used. (default: 0)

.PP
\fB--sat_per_vbyte\fP="": (optional) a manual fee expressed in sat/vbyte that should be used when crafting the transaction (default: 0)

.PP
\fB--scid_alias\fP: (optional) whether a scid-alias channel type should be negotiated.

.PP
\fB--utxo\fP="": a utxo specified as outpoint(tx:idx) which will be used to fund a channel. This flag can be repeatedly used to fund a channel with a selection of utxos. The selected funds can either be entirely spent by specifying the fundmax flag or partially by selecting a fraction of the sum of the outpoints in local_amt (default: [])

.PP
\fB--zero_conf\fP: (optional) whether a zero-conf channel open should be attempted.