Skip to content

Commit ff41abc

Browse files
Leo Weesegitbook-bot
authored andcommitted
GITBOOK-449: change request with no subject merged in GitBook
1 parent cf2f008 commit ff41abc

File tree

4 files changed

+54
-1
lines changed

4 files changed

+54
-1
lines changed

SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,7 @@
137137
* [RFQ](lightning-network-tools/taproot-assets/rfq.md)
138138
* [Collectibles](lightning-network-tools/taproot-assets/collectibles.md)
139139
* [Universes](lightning-network-tools/taproot-assets/universes.md)
140+
* [Debugging Tapd](lightning-network-tools/taproot-assets/debugging-tapd.md)
140141
* [Multisignature](lightning-network-tools/taproot-assets/multisignature.md)
141142
* [Lightning Polar](lightning-network-tools/taproot-assets/polar.md)
142143
* [Operational Safety Guidelines](lightning-network-tools/taproot-assets/operational-safety-guidelines.md)
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
description: Help improve the Taproot Assets Daemon by submitting your logs and issues.
3+
---
4+
5+
# Debugging Tapd
6+
7+
Taproot Assets is alpha software. You can help improve the software by providing feedback, submitting issues and making pull requests.
8+
9+
This guide aims to help you debug issues you might encounter when running `litd` with `tapd` in integrated mode.
10+
11+
## Is Taproot Assets running?
12+
13+
Taproot Assets runs as part of `litd`, and it may not be apparent when `tapd` fails to start as part of the wider bundle. You can always check which subsystems are enabled and running by calling:
14+
15+
`litcli status`
16+
17+
## Logging
18+
19+
The logs provide invaluable clues as to why a system might not be starting, or why a command fails to execute. In integrated mode, all logs are written to `lnd.log`, typically located in `~/.lnd/logs/bitcoin/mainnet/lnd.log`
20+
21+
To adjust the debug level, you may run:
22+
23+
`lncli debuglevel --level trace,SRVR=debug,PEER=info,BTCN=warn,GRPC=error`
24+
25+
Alternatively, you can also add the following to your `lit.conf` to set the debugging level permanently:
26+
27+
`lnd.debuglevel=trace,SRVR=debug,PEER=info,BTCN=warn,GRPC=error`
28+
29+
You can use the following to increase the number of log files and their maximum size, allowing you to look further into the past in search for clues:
30+
31+
`lnd.maxlogfilesize=100`\
32+
`lnd.maxlogfiles=100`
33+
34+
## Profiling
35+
36+
A go profile helps determine the state of a go program. You can enable profiling with at any port:
37+
38+
`lnd.profile=9736`
39+
40+
You can then call the profile with:
41+
42+
`curl http://localhost:9736/debug/pprof/goroutine?debug=2 > goprofile.txt`
43+
44+
## Filing issues
45+
46+
All issues may be filed on the project’s Github repository. Please be as clear as possible, and include logs and go profile.
47+
48+
{% embed url="https://github.com/lightninglabs/taproot-assets/issues" %}

lightning-network-tools/taproot-assets/taproot-assets-channels.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ For example:
4545

4646
In all following example commands, this detail is omitted for simplicity.
4747

48+
[Read more: Debugging Tapd](debugging-tapd.md)
49+
4850
## Open channels <a href="#docs-internal-guid-726c810f-7fff-a475-78a5-501c81d0113e" id="docs-internal-guid-726c810f-7fff-a475-78a5-501c81d0113e"></a>
4951

5052
To open a channel, we will identify the asset that we would like to deposit into our channel. We can get the asset ids of the Taproot Assets we hold using `tapcli assets list`. To open the channel, we will need the `asset_id` and how many of these tokens we want to deposit into our channel.
@@ -138,7 +140,7 @@ As the channel is opening, you will see the channel `txid`. You should be able t
138140

139141
To be able to generate invoices, you must have a channel with a remote balance for the asset you are requesting. Your peer also needs to be configured for RFQ (request for quote).
140142

141-
Learn: How to set up RFQ and become an Edge Node
143+
[Learn: How to set up RFQ and become an Edge Node](rfq.md)
142144

143145
The invoice generation format follows that of LND.
144146

the-lightning-network/taproot-assets/edge-nodes.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ Through Edge Nodes, Taproot Assets-enabled wallets are able to plug into the exi
2020

2121
As Edge nodes swap Taproot Assets to BTC through traditional [HTLCs](../multihop-payments/hash-time-lock-contract-htlc.md), they do not hold client assets or require custodial arrangements of any other kind.
2222

23+
[Read more: Set up an Edge node](../../lightning-network-tools/taproot-assets/rfq.md)
24+
2325
## What does an Edge node do <a href="#docs-internal-guid-9848fd86-7fff-5305-d8ad-ff2ea6ce4686" id="docs-internal-guid-9848fd86-7fff-5305-d8ad-ff2ea6ce4686"></a>
2426

2527
* **Open channels**

0 commit comments

Comments
 (0)