Skip to content

Commit

Permalink
GITBOOK-387: change request with no subject merged in GitBook
Browse files Browse the repository at this point in the history
  • Loading branch information
Leo Weese authored and gitbook-bot committed Nov 9, 2023
1 parent 80687ff commit b8e9c9b
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 12 deletions.
10 changes: 1 addition & 9 deletions lightning-network-tools/taproot-assets/first-steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,15 +157,7 @@ Now we can check our groups with:

Taproot Assets uses universes to communicate information about which assets exist and where in the blockchain they are anchored. A universe can be thought of as a virtual mempool, an explorer or a repository.

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 connection with `tapcli universe federation list`.

If you would like to add a universe to this federation, you can do this on testnet with `tapcli universe federation add --universe_host testnet.universe.lightning.finance`

Or on mainnet:

`tapcli universe federation add --universe_host universe.lightning.finance`

Your node will sync with the universes you have added to your federation whenever you create a new taproot asset address with an unknown asset ID, or when specifically instructed to. This requires an asset ID or a group key.
Your node will sync with the universe whenever you create a new taproot asset address with an unknown asset ID, or when specifically instructed to. This requires an asset ID or a group key.

`tapcli universe sync --universe_host <universe_ip:port> --asset_id <asset id>`

Expand Down
12 changes: 9 additions & 3 deletions lightning-network-tools/taproot-assets/universes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,21 @@ Sample`tapd.conf` file:

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.

You can add and remove universes from your local federation with `tapcli universe federation add` or `del`.

The contents of the default universe are also available via a public API:

{% embed url="https://universe.lightning.finance/v1/taproot-assets/universe/roots" %}

## 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`.

If you would like to add a universe to this federation, you can do this on with `tapcli universe federation add --universe_host <universe_ip:port>`

Similarly, you can remove universes from this federation with `tapcli universe federation del --universe_host <universe_ip>:port`

## Syncing to a universe

By default, your `tapd` will sync to universes for which have configured in your local federation, and only for assets which you either hold or have created a taproot address for. You may also manually sync specific asset IDs or group keys.
By default, your `tapd` will sync to universes which have configured in your local federation, and only for assets which you either hold or have created a taproot address for. You may also manually sync specific asset IDs or group keys.

`tapcli universe sync --universe_host <universe_ip:port> --group_key <group key>`

Expand Down

0 comments on commit b8e9c9b

Please sign in to comment.