GITBOOK-320: Taproot Assets

Author: Leo Weese

Diff for: .gitbook/assets/loop (2) (2) (2) (2) (2) (2) (2) (2) (2) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (3) (2) (1).png

@@ -39,8 +39,8 @@ Loop is a service that makes it easier to send and receive funds on Lightning, s
 
 Pool is a non-custodial marketplace where users can buy inbound liquidity from node operators. Read our guides on how to join Pool as either a buyer or seller.
 
-{% content-ref url="the-lightning-network/taro/" %}
-[taro](the-lightning-network/taro/)
+{% content-ref url="the-lightning-network/taproot-assets/" %}
+[taproot-assets](the-lightning-network/taproot-assets/)
 {% endcontent-ref %}
 
 Taro is a Taproot-powered protocol for issuing assets on the bitcoin blockchain that can be transferred over the Lightning Network for instant, high volume, low fee transactions.

Diff for: .gitbook/assets/loop (2) (2) (2) (2) (2) (2) (2) (2) (2) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (3) (2) (2).png

@@ -35,10 +35,10 @@
   * [Aperture](the-lightning-network/l402/aperture.md)
   * [📋 Protocol Specification](the-lightning-network/l402/protocol-specification.md)
   * [Implementations and Links](the-lightning-network/l402/implementations-and-links.md)
-* [Taro](the-lightning-network/taro/README.md)
-  * [Taro Protocol](the-lightning-network/taro/taro-protocol.md)
-  * [Taro on Lightning](the-lightning-network/taro/taro-on-lightning.md)
-  * [FAQ](the-lightning-network/taro/faq.md)
+* [Taproot Assets](the-lightning-network/taproot-assets/README.md)
+  * [Taproot Assets Protocol](the-lightning-network/taproot-assets/taproot-assets-protocol.md)
+  * [Taproot Assets on Lightning](the-lightning-network/taproot-assets/taproot-assets-on-lightning.md)
+  * [FAQ](the-lightning-network/taproot-assets/faq.md)
 
 ## Lightning Network Tools
 
@@ -119,9 +119,9 @@
   * [Account Recovery](lightning-network-tools/pool/account\_recovery.md)
   * [gRPC API](lightning-network-tools/pool/grpc-api.md)
   * [FAQs](lightning-network-tools/pool/faq.md)
-* [Taro](lightning-network-tools/taro/README.md)
-  * [Get Started](lightning-network-tools/taro/get-taro.md)
-  * [First Steps](lightning-network-tools/taro/first-steps.md)
+* [Taproot Assets](lightning-network-tools/taproot-assets/README.md)
+  * [Get Started](lightning-network-tools/taproot-assets/get-taro.md)
+  * [First Steps](lightning-network-tools/taproot-assets/first-steps.md)
 * [Faraday](lightning-network-tools/faraday/README.md)
   * [🛠 Get Started](lightning-network-tools/faraday/get-started.md)
   * [The Faraday CLI](lightning-network-tools/faraday/the-faraday-cli.md)

Diff for: .gitbook/assets/loop (2) (2) (2) (2) (2) (2) (2) (2) (2) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (3) (2) (3).png

@@ -598,7 +598,7 @@ Taproot is a bitcoin transaction type introduced in November 2021 that allows fo
 
 Taro is a protocol for issuing assets on Bitcoin. It uses [Merkle Sum trees](glossary.md#docs-internal-guid-da9e136d-7fff-c284-15eb-82132eee8d94) and [Sparse Merkle trees](glossary.md#docs-internal-guid-3885545f-7fff-a51b-405a-54b62b6131d5) to commit assets to the Bitcoin Blockchain. Taro assets can be committed to [Lightning channels](glossary.md#channel) to instant transfers.
 
-[Read more: Understanding Taro](../the-lightning-network/taro/)
+[Read more: Understanding Taro](../the-lightning-network/taproot-assets/)
 
 ## Time Lock Delta
 

Diff for: .gitbook/assets/settings (2) (2) (2) (2) (2) (2) (2) (2) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (3) (2) (1).png

@@ -0,0 +1,15 @@
+---
+description: Learn how to install Taproot Assets, mint and transfer assets.
+---
+
+# Taproot Assets
+
+The Taproot Assets Daemon `tapd` implements the [Taproot Assets protocol](../../the-lightning-network/taproot-assets/taproot-assets-protocol.md) (formerly Taro) for issuing assets on the Bitcoin blockchain. Taproot Assets leverages Taproot transactions to commit to newly created assets and their transfers in an efficient and scalable manner. Multiple assets can be created and transferred in a single bitcoin UTXO, while witness data is transacted and kept off-chain.
+
+{% content-ref url="get-taro.md" %}
+[get-taro.md](get-taro.md)
+{% endcontent-ref %}
+
+{% content-ref url="first-steps.md" %}
+[first-steps.md](first-steps.md)
+{% endcontent-ref %}

Diff for: .gitbook/assets/settings (2) (2) (2) (2) (2) (2) (2) (2) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (1) (3) (2) (2).png

@@ -0,0 +1,42 @@
+---
+description: >-
+  The Taproot Assets Daemon tapd implements the Taproot Assets Protocol for
+  issuing assets on the Bitcoin blockchain.
+---
+
+# Get Started
+
+## #Craeful <a href="#docs-internal-guid-f9af6317-7fff-eeb2-2957-b358d3da86da" id="docs-internal-guid-f9af6317-7fff-eeb2-2957-b358d3da86da"></a>
+
+Taproot Assets is alpha software. It is configured to run on regtest, testnet3 and simnet only, where it’s okay if bitcoin or Taproot Assets are irrevocably lost.
+
+## Prerequisites <a href="#docs-internal-guid-29b5ec39-7fff-4a26-d7e9-dfa1d01ff2c6" id="docs-internal-guid-29b5ec39-7fff-4a26-d7e9-dfa1d01ff2c6"></a>
+
+Taproot Assets requires [LND](https://github.com/lightningnetwork/lnd/) v0.16.2. If [compiled from source](../lnd/run-lnd.md#docs-internal-guid-8ffda72d-7fff-a07e-3bb8-93cdf01b5103), it needs to be built with `tags=signrpc walletrpc chainrpc invoicesrpc`. LND needs to be synced and running on the same bitcoin network as you are doing your testing. RPC connections need to be accepted and Macaroons need to be set. [Learn how to set up LND using the default configuration here](../lnd/run-lnd.md).
+
+## Installation: <a href="#docs-internal-guid-0652b60a-7fff-d0e5-15fc-159e8557bc88" id="docs-internal-guid-0652b60a-7fff-d0e5-15fc-159e8557bc88"></a>
+
+### From source: <a href="#docs-internal-guid-5879af55-7fff-021d-8347-7ef95cd98105" id="docs-internal-guid-5879af55-7fff-021d-8347-7ef95cd98105"></a>
+
+Compile Taproot Assets from source by cloning the taproot-assets repository. [Go version 1.18](https://go.dev/dl/) or higher is required (you may check what version of go is running with go version).
+
+`git clone https://github.com/lightninglabs/taproot-assets.git`\
+`cd taproot-assets`\
+`make install`
+
+## Configuration: <a href="#docs-internal-guid-8aa3849c-7fff-4b8e-530a-a563b8d9d0b8" id="docs-internal-guid-8aa3849c-7fff-4b8e-530a-a563b8d9d0b8"></a>
+
+Optionally, create a Taproot Assets configuration file under `~/.taproot-assets/tap.conf` on Linux or BSD, `~/Library/Application Support/Taproot-assets/tap.conf` in Mac OS or `$LOCALAPPDATA/Taproot-assets/tap.conf` in Windows.
+
+Within the `tap.conf` file you can permanently set your variables, such as directory, macaroon or other paths and how to connect to your LND.
+
+## Running tapd: <a href="#docs-internal-guid-ebf73e49-7fff-b5ed-44ff-b9b0953c6082" id="docs-internal-guid-ebf73e49-7fff-b5ed-44ff-b9b0953c6082"></a>
+
+Run Taproot Assets with the command `tapd`. Specify how Taproot Assets can reach LND and what bitcoin network to run Taproot Assets with by passing it additional flags.
+
+`tapd –network=testnet –debuglevel=debug —lnd.host=localhost:10009 --lnd.macaroonpath=/.lnd/data/chain/bitcoin/testnet/admin.macaroon --lnd.tlspath=/.lnd/tls.cert --tapdir=~/.taprooot-assets --rpclisten=127.0.0.1:10029 --restlisten=127.0.0.1:8089`
+
+You may run multiple tapd instances on the same machine, but you will also have to set up multiple LND instances. [Refer to this guide](../lnd/run-lnd.md) for how to set up multiple LND instances with a single Bitcoin backend using `rpcpolling`. When running multiple `tapd` instances on one machine, don’t forget to set an alternate Taproot Assets directory and API endpoints and specify these when calling `tapcli` as well.
+
+You can make use of `tapcli profiles` to make calls to separate `tapd` instances on the same machine.
+