GITBOOK-459: change request with no subject merged in GitBook

Author: Leo Weese

SUMMARY.md

@@ -75,7 +75,7 @@
   * [Debugging LND](lightning-network-tools/lnd/debugging\_lnd.md)
   * [Fuzzing LND](lightning-network-tools/lnd/fuzz.md)
   * [LND and etcd](lightning-network-tools/lnd/etcd.md)
-  * [gRPC API](lightning-network-tools/lnd/grpc-api.md)
+  * [LND API documentation](https://lightning.engineering/api-docs/api/lnd/)
   * [Channel Acceptor](lightning-network-tools/lnd/channel-acceptor.md)
   * [RPC Middleware Interceptor](lightning-network-tools/lnd/rpc-middleware-interceptor.md)
   * [HTLC Interceptor](lightning-network-tools/lnd/htlc-interceptor.md)
@@ -107,16 +107,17 @@
   * [Troubleshooting](lightning-network-tools/lightning-terminal/troubleshooting.md)
   * [Lightning Node Connect: Under the hood](lightning-network-tools/lightning-terminal/lightning-node-connect.md)
   * [LNC Node Package](lightning-network-tools/lightning-terminal/lnc-npm.md)
+  * [LITD API Documentation](https://lightning.engineering/api-docs/api/lit/)
   * [Privacy and Security](lightning-network-tools/lightning-terminal/privacy-and-security.md)
   * [Privacy Policy](lightning-network-tools/lightning-terminal/privacy.md)
   * [Terms of Use](lightning-network-tools/lightning-terminal/tos.md)
 * [Loop](lightning-network-tools/loop/README.md)
   * [🛠️ Get Started](lightning-network-tools/loop/get-started.md)
   * [The Loop CLI](lightning-network-tools/loop/the-loop-cli.md)
-  * [gRPC API](lightning-network-tools/loop/grpc-api.md)
   * [Autoloop](lightning-network-tools/loop/autoloop.md)
   * [Instant Loop Outs](lightning-network-tools/loop/instant-loop-outs.md)
   * [Peer with Loop](lightning-network-tools/loop/peer-with-loop.md)
+  * [Loop API Documentation](https://lightning.engineering/api-docs/api/loop/)
 * [Pool](lightning-network-tools/pool/README.md)
   * [Overview](lightning-network-tools/pool/overview.md)
   * [Quickstart](lightning-network-tools/pool/quickstart.md)
@@ -129,7 +130,7 @@
   * [Channel Leases](lightning-network-tools/pool/channel\_leases.md)
   * [Batch Execution](lightning-network-tools/pool/batch\_execution.md)
   * [Account Recovery](lightning-network-tools/pool/account\_recovery.md)
-  * [gRPC API](lightning-network-tools/pool/grpc-api.md)
+  * [Pool API Documentation](https://lightning.engineering/api-docs/api/pool/)
   * [FAQs](lightning-network-tools/pool/faq.md)
 * [Taproot Assets](lightning-network-tools/taproot-assets/README.md)
   * [Get Started](lightning-network-tools/taproot-assets/get-tapd.md)
@@ -142,6 +143,7 @@
   * [Multisignature](lightning-network-tools/taproot-assets/multisignature.md)
   * [Lightning Polar](lightning-network-tools/taproot-assets/polar.md)
   * [Operational Safety Guidelines](lightning-network-tools/taproot-assets/operational-safety-guidelines.md)
+  * [Taproot Assets API Documentation](https://lightning.engineering/api-docs/api/taproot-assets/)
 * [Aperture](lightning-network-tools/aperture/README.md)
   * [⚒️ Get Aperture](lightning-network-tools/aperture/get-aperture.md)
   * [LNC Backend](lightning-network-tools/aperture/lnc-backend.md)
@@ -150,6 +152,7 @@
 * [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)
+  * [Faraday API Documentation](https://lightning.engineering/api-docs/api/faraday/)
 
 ## LAPPs
 

lightning-network-tools/lnd/grpc-api.md

@@ -4,13 +4,20 @@ description: Learn how to run a universe and connect to other universes.
 
 # Universes
 
+In the context of Taproot Assets, a universe is a service that acts as a repository for publicly minted assets. It contains knowledge of assets, mints, metadata, public transfers and their proofs. A universe is required for users to fetch data necessary to validate transfers, and may be public or private.
+
+Anyone may run a universe, or use one or multiple universes provided by others, such as Lightning Labs. In addition to universes, mailboxes are used to transfer proofs from sender to receiver. For help with running your own mailbox, please refer to [the Aperture guides](../aperture/).
+
 ## Running a universe <a href="#docs-internal-guid-a793947b-7fff-5e06-ddbf-f64bd25da85f" id="docs-internal-guid-a793947b-7fff-5e06-ddbf-f64bd25da85f"></a>
 
-Running a universe is as simple as running `tapd` and amending your configuration file. To run a universe, set your instance to listen on the RPC port (10029) and ensure this port is open on your machine. Being publicly reachable is not a requirement for a universe, however. Your universe may only serve resources on a private network, or be otherwise restricted.
+Running a universe is as simple as running `tapd` and amending your configuration file. You may run a universe over RPC or REST. By default, `tapd` is expected to listen on port (`10029`), so ensure this port is open on your machine if you would like others to connect to you. Being publicly reachable is not a requirement for a universe, however. Your universe may only serve resources on a private network, or be otherwise restricted.
+
+When running `tapd` as part of `litd`, you may also use port `8443` or define your own port. For example, as the REST universe is also usable through a browser over HTTPS, you may configure it over port `443` or set up a proxy.
 
 Sample`tapd.conf` file:
 
 `rpclisten=0.0.0.0:10029`\
+`restlisten=0.0.0.0:8089`\
 `allow-public-uni-proof-courier=true`\
 `allow-public-stats=true`\
 `universe.public-access=rw`
@@ -41,12 +48,14 @@ You can change the configuration from the CLI using `tapcli universe federation
 
 By default, your `tapd` will connect to the default universe, for instance `testnet.universe.lightning.finance:10029` for testnet, or `universe.lightning.finance:10029` on mainnet.
 
-When running `litd` in integrated mode, your universe may also be available at port `:8443`
-
 The contents of the default universe are also available via a public API:
 
 {% embed url="https://universe.lightning.finance/v1/taproot-assets/universe/roots" %}
 
+You may also make use of the UI available through Lightning Terminal
+
+{% embed url="https://terminal.lightning.engineering/assets/" %}
+
 ## Federations
 
 By default, your tapd instance will connect to a default universe. You can manually add additional universes to sync to and from, called a federation. You can see this federation with `tapcli universe federation list`.
@@ -70,3 +79,13 @@ To configure your `tapd` to regularly sync to other asset IDs or group keys, you
 `tapcli universe federation config global --proof_type issuance --allow_insert true`
 
 `tapcli universe federation config local --proof_type transfer --allow_insert true --group_key <group key>`
+
+## The Universe APIs
+
+A Taproot Asset Universe is available over [gRPC](https://lightning.engineering/api-docs/api/taproot-assets/#grpc) and [REST](https://lightning.engineering/api-docs/api/taproot-assets/#rest). You may run your own universe or interact with a public universe. Public universes are unauthenticated, the macaroon checks are skipped.
+
+For instance, when making a transfer, the proofs may be pushed to one or multiple universes using the REST Api. This requires the asset ID, the leaf key index and script key.
+
+`/v1/taproot-assets/universe/proofs/asset-id/{key.id.asset_id_str}/{key.leaf_key.op.hash_str}/{key.leaf_key.op.index}/{key.leaf_key.script_key_str}`
+
+A detailed list of all available fields as well as code examples can be found under the [Taproot Assets API documentation.](https://lightning.engineering/api-docs/api/taproot-assets/universe/insert-proof)