> For the complete documentation index, see [llms.txt](https://docs.lightning.engineering/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lightning.engineering/lightning-network-tools/taproot-assets/debugging-tapd.md).

# Debugging Tapd

Taproot Assets is alpha software. You can help improve the software by providing feedback, submitting issues and making pull requests.

This guide aims to help you debug issues you might encounter when running `litd` with `tapd` in integrated mode.

## Is Taproot Assets running?

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:

`litcli status`

## Logging

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`

To adjust the debug level, you may run:

`lncli debuglevel --level trace,SRVR=debug,PEER=info,BTCN=warn,GRPC=error`

Alternatively, you can also add the following to your `lit.conf` to set the debugging level permanently:

`lnd.debuglevel=trace,SRVR=debug,PEER=info,BTCN=warn,GRPC=error`

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:

`lnd.maxlogfilesize=100`\
`lnd.maxlogfiles=100`

## Profiling

A go profile helps determine the state of a go program. You can enable profiling at any port:

`lnd.profile=9736`

You can then call the profile with:

`curl http://localhost:9736/debug/pprof/goroutine?debug=2 > goprofile.txt`

## Filing issues

All issues may be filed on the project’s Github repository. Please be as clear as possible, and include logs and go profile.

{% embed url="<https://github.com/lightninglabs/taproot-assets/issues>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightning.engineering/lightning-network-tools/taproot-assets/debugging-tapd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.