v0.6.0

[Roasbeef]

Database Migrations

tapd v0.6.0 contains non-revertible database migrations. After running tapd v0.6.0, these database migrations prevent downgrading tapd to a previous release. Create backups of tapd database state, before upgrading to tapd v0.6.0. Please report any database migration issues.

Breaking changes

See previous version v0.5.1 release notes for changes prior to v0.5.x.
There are no breaking changes between v0.5.1 and v0.6.0, but grouped asset channel funding will only work with the next version of Lightning Terminal (v0.15.0-alpha) which is going to be published soon.

Verifying the Release

In order to verify the release, you'll need to have gpg or gpg2 installed on your system. Once you've obtained a copy (and hopefully verified that as well), you'll first need to import the keys that have signed this release if you haven't done so already:

curl https://raw.githubusercontent.com/lightninglabs/taproot-assets/main/scripts/keys/roasbeef.asc | gpg --import

Once you have the required PGP keys, you can verify the release (assuming manifest-roasbeef-v0.6.0.sig and manifest-v0.6.0.txt are in the current directory) with:

gpg --verify manifest-roasbeef-v0.6.0.sig manifest-v0.6.0.txt

You should see the following if the verification was successful:

gpg: Signature made Wed Sep 30 17:35:20 2020 PDT
gpg:                using RSA key 60A1FA7DA5BFF08BDCBBE7903BBD59E99B280306
gpg: Good signature from "Olaoluwa Osuntokun <[email protected]>" [ultimate]

That will verify the signature of the manifest file, which ensures integrity and authenticity of the archive you've downloaded locally containing the binaries. Next, depending on your operating system, you should then re-compute the sha256 hash of the archive with shasum -a 256 <filename>, compare it with the corresponding one in the manifest file, and ensure they match exactly.

Verifying the Release Timestamp

In addition to time-stamping the git tag with OpenTimestamps, we also timestamp the manifest file along with its signature. Two files are included in our release artifacts: manifest-roasbeef-v0.6.0.sig.ots and manifest-v0.6.0.txt.ots.

Assuming you have the opentimestamps client installed locally, the timestamps can be verified with the following commands:

ots verify manifest-roasbeef-v0.6.0.sig.ots -f manifest-roasbeef-v0.6.0.sig
ots verify manifest-v0.6.0.txt.ots -f manifest-v0.6.0.txt

Alternatively, the OpenTimestamps website can be used to verify these timestamps if one doesn't have a bitcoind instance accessible locally.

Assuming you are using the OpenTimestamps ots-git-gpg-wrapper you can verify the timestamp of the git tag by verifying the tag as explained in Verifying the Release Binaries.

These timestamps should give users confidence in the integrity of this release even after the key that signed the release expires.

Verifying the Release Binaries

Our release binaries are fully reproducible. Third parties are able to verify that the release binaries were produced properly without having to trust the release manager(s). See our reproducible builds guide for how this can be achieved.
The release binaries are compiled with go1.23.9, which is required by verifiers to arrive at the same ones.

The make release command can be used to ensure one rebuilds with all the same flags used for the release. If one wishes to build for only a single platform, then make release sys=<OS-ARCH> tag=<tag> can be used.

Finally, you can also verify the tag itself with the following command:

$ git verify-tag v0.6.0
gpg: Signature made Tue Sep 15 18:55:00 2020 PDT
gpg:                using RSA key 60A1FA7DA5BFF08BDCBBE7903BBD59E99B280306
gpg: Good signature from "Olaoluwa Osuntokun <[email protected]>" [ultimate]

Verifying the Docker Images

To verify the tapd and tapcli binaries inside the docker images against the signed, reproducible release binaries, there is a verification script in the image that can be called (before starting the container for example):

$ docker run --rm --entrypoint="" lightninglabs/taproot-assets:v0.6.0 /verify-install.sh v0.6.0
$ OK=$?
$ if [ "$OK" -ne "0" ]; then echo "Verification failed!"; exit 1; done
$ docker run lightninglabs/taproot-assets [command-line options]

Building the Contained Release

Users are able to rebuild the target release themselves without having to fetch any of the dependencies. In order to do so, assuming
that vendor.tar.gz and tapd-source-v0.6.0.tar.gz are in the current directory, follow these steps:

tar -xvzf vendor.tar.gz
tar -xvzf tapd-source-v0.6.0.tar.gz
go install -v -mod=vendor -ldflags "-X github.com/lightninglabs/taproot-assets/build.Commit=v0.6.0" ./cmd/tapd
go install -v -mod=vendor -ldflags "-X github.com/lightninglabs/taproot-assets/build.Commit=v0.6.0" ./cmd/tapcli

The -mod=vendor flag tells the go build command that it doesn't need to fetch the dependencies, and instead, they're all enclosed in the local vendor directory.

Additionally, it's now possible to use the enclosed release.sh script to bundle a release for a specific system like so:

make release sys="linux-arm64 darwin-amd64"

⚡️⚡️⚡️ OK, now to the rest of the release notes! ⚡️⚡️⚡️

Release Notes (auto generated)

What's Changed

• rpcserver: better rfq channel selection by @GeorgeTsagk in rpcserver: better rfq channel selection #1357
• Proof of Concept: Simplifying Concurrency with ContextGuard.Goroutine by @ffranr in Proof of Concept: Simplifying Concurrency with ContextGuard.Goroutine #1380
• cmd/commands: add offset and limit params to roots cmd by @guggero in cmd/commands: add offset and limit params to roots cmd #1393
• Refactor Group Key Code by @ffranr in Refactor Group Key Code #1396
• scripts: update georgetsagk.asc gpg key by @GeorgeTsagk in scripts: update georgetsagk.asc gpg key #1394
• misc CI/build system improvements by @guggero in misc CI/build system improvements #1381
• rfq+rfqmath: fix sats-per-asset conversion in mock price oracle by @ffranr in rfq+rfqmath: fix sats-per-asset conversion in mock price oracle #1399
• tapdb+sqlc: sqlc: add script to merge SQL migrations into consolidated schemas by @Roasbeef in tapdb+sqlc: sqlc: add script to merge SQL migrations into consolidated schemas  #1387
• Remove redundant PayToTaprootScript functions by @ffranr in Remove redundant PayToTaprootScript functions #1404
• Support Directory Exclusion in Golang Version Linter Check by @ffranr in Support Directory Exclusion in Golang Version Linter Check #1405
• make: fix sqlc-check by @guggero in make: fix sqlc-check #1406
• Implement PrevId[] UTXO selection for FundVirtualPSBT RPC method; valid for single PrevId at first by @habibitcoin in Implement PrevId[] UTXO selection for FundVirtualPSBT RPC method; valid for single PrevId at first #1172
• tapdb: expand allowed proof types in universe-related tables by @Roasbeef in tapdb: expand allowed proof types in universe-related tables #1386
• proof: add new IgnoreChecker proof rejection cache by @Roasbeef in proof: add new IgnoreChecker proof rejection cache  #1400
• tapdb: fix aider mistakes and inconsistencies by @guggero in tapdb: fix aider mistakes and inconsistencies #1415
• [wallet 1/3]: refactor in preparation for group key channel funding by @guggero in [wallet 1/3]: refactor in preparation for group key channel funding #1402
• Add sync loadtest by @GeorgeTsagk in Add sync loadtest #1352
• [wallet 2/3]: refactor funding logic to use allocation code by @guggero in [wallet 2/3]: refactor funding logic to use allocation code #1407
• Add pre-commitment output to mint anchor TX by @ffranr in Add pre-commitment output to mint anchor TX #1325
• Support group keys for RFQ negotiation flows by @GeorgeTsagk in Support group keys for RFQ negotiation flows #1382
• Add itest oracle harness by @GeorgeTsagk in Add itest oracle harness #1395
• Update lnd compile-time dependency to v0.19 by @guggero in Update lnd compile-time dependency to v0.19 #1422
• build(deps): bump the go_modules group across 2 directories with 1 update by @dependabot in build(deps): bump the go_modules group across 2 directories with 1 update #1449
• tapcli: Global flags to accept ENV vars overrides. by @gcaracuel in tapcli: Global flags to accept ENV vars overrides. #1447
• multi: update to tagged lnd v0.19.0-beta.rc1 by @guggero in multi: update to tagged lnd v0.19.0-beta.rc1 #1454
• tapchannel: validate proof courier before opening or accepting channels by @guggero in tapchannel: validate proof courier before opening or accepting channels #1412
• [custom channels]: refactor channel JSON, add more custom data parsers by @guggero in [custom channels]: refactor channel JSON, add more custom data parsers #1441
• Support group keys on SendPayment & AddInvoice by @GeorgeTsagk in Support group keys on SendPayment & AddInvoice #1423
• tapd+tapdb: return anchor block height in ListTransfers if available by @bhandras in tapd+tapdb: return anchor block height in ListTransfers if available #1461
• build(deps): bump golang.org/x/crypto from 0.33.0 to 0.35.0 in /tools in the go_modules group across 1 directory by @dependabot in build(deps): bump golang.org/x/crypto from 0.33.0 to 0.35.0 in /tools in the go_modules group across 1 directory #1469
• [wallet 3/3]: group key support for channel funding by @guggero in [wallet 3/3]: group key support for channel funding #1413
• Block on Proof Courier Service Connection Attempt by @ffranr in Block on Proof Courier Service Connection Attempt #1203
• tapdb+universe: implement initial version of universe ignore tree by @Roasbeef in tapdb+universe: implement initial version of universe ignore tree #1420
• Add method Proof.Bytes by @ffranr in Add method Proof.Bytes #1474
• build(deps): bump the go_modules group across 2 directories with 1 update by @dependabot in build(deps): bump the go_modules group across 2 directories with 1 update #1472
• Extract non-controversion commits from Proof-system-v1 PR by @guggero in Extract non-controversion commits from Proof-system-v1 PR #1465
• Updated ListAssetRequest to include additional filter options by @itsrachelfish in Updated ListAssetRequest to include additional filter options #1199
• taprpc: TransferOutputAnchor to include the anchor pkscript by @bhandras in taprpc: TransferOutputAnchor to include the anchor pkscript #1473
• tapdb+universe: implement new Universe tree for 1st party burns by @Roasbeef in tapdb+universe: implement new Universe tree for 1st party burns #1456
• PaymentBandwidth uses HtlcView by @GeorgeTsagk in PaymentBandwidth uses HtlcView #1462
• mssmt: add new Copy method and InsertMany to optimize slightly by @Roasbeef in mssmt: add new Copy method and InsertMany to optimize slightly  #1467
• Add Transfer Label Support for Asset Sends by @ffranr in Add Transfer Label Support for Asset Sends #1468
• Add preliminary proof courier connection check to ChainPorter by @ffranr in Add preliminary proof courier connection check to ChainPorter #1470
• Allow setting sats/msats to taprpc.AddInvoice by @GeorgeTsagk in Allow setting sats/msats to taprpc.AddInvoice #1448
• Fix bandwidth related issues by @guggero in Fix bandwidth related issues #1478
• Fix CI Unit Test Flakes by @ffranr in Fix CI Unit Test Flakes #1482
• basic-price-oracle: clarify price oracle demo asset rate documentation by @ffranr in basic-price-oracle: clarify price oracle demo asset rate documentation #1479
• taprpc: support custom lock ID and expiration in CommitVirtualPsbts by @bhandras in taprpc: support custom lock ID and expiration in CommitVirtualPsbts #1475
• tapdb: correctly fill pkScript for outputs of QueryParcels by @bhandras in tapdb: correctly fill pkScript for outputs of QueryParcels #1491
• tapchannel: add extra logging when we cancel incoming invoice HTLCs by @Roasbeef in tapchannel: add extra logging when we cancel incoming invoice HTLCs  #1490
• multi: Add label to PublishTransaction by @gijswijs in multi: Add label to PublishTransaction #1411
• GitHub: use master again for litd itests by @guggero in GitHub: use master again for litd itests #1499
• Add chain_anchor with block_timestamp to AssetLeaves RPC by @jamaljsr in Add chain_anchor with block_timestamp to AssetLeaves RPC #1480
• [tapdb]: add script key type enum, run Golang based post migration checks by @guggero in [tapdb]: add script key type enum, run Golang based post migration checks #1198
• taprpc: extract as standalone Go submodule for WASM clients by @ffranr in taprpc: extract as standalone Go submodule for WASM clients #1487
• rfq: store outgoing request before sending message by @guggero in rfq: store outgoing request before sending message #1506
• rpcserver+taprpc: add issuance reveal data to proof leaf by @guggero in rpcserver+taprpc: add issuance reveal data to proof leaf #1486
• channels: fix coop close asset distribution for grouped asset channels by @guggero in channels: fix coop close asset distribution for grouped asset channels #1505
• rfq+rpcserver: match event to order by @guggero in rfq+rpcserver: match event to order #1509
• monitoring: expand Prometheus buckets for RPC endpoint latency by @ffranr in monitoring: expand Prometheus buckets for RPC endpoint latency #1500
• itest flake: fixes flake in burn test by @guggero in itest flake: fixes flake in burn test #1514
• build: bump version to v0.6 rc1 by @Roasbeef in build: bump version to v0.6 rc1 #1511
• minting: fix re-issuing into existing group with external key by @guggero in minting: fix re-issuing into existing group with external key #1517
• fix itest flake: allow AssertNonInteractiveRecvComplete more time to execute by @ffranr in fix itest flake: allow AssertNonInteractiveRecvComplete more time to execute #1494
• rpcserver: stop SendPayment update stream when payment fails by @ffranr in rpcserver: stop SendPayment update stream when payment fails #1532
• Fix panic when listing unfunded pending batch with verbose by @ffranr in Fix panic when listing unfunded pending batch with verbose #1536
• misc: fix litcli command docs, add group key support to DecodeAssetPayReq by @guggero in misc: fix litcli command docs, add group key support to DecodeAssetPayReq #1498
• tapchannel: don't break backward compatibility by @guggero in tapchannel: don't break backward compatibility #1537
• Multi rfq receive (AddInvoice multiple hop hints) by @GeorgeTsagk in Multi rfq receive (AddInvoice multiple hop hints) #1457
• Add support for skipping anchor transaction broadcast during asset transfer by @ffranr in Add support for skipping anchor transaction broadcast during asset transfer #1530
• tapgarden: increase unit test default timeout from 10s to 30s by @ffranr in tapgarden: increase unit test default timeout from 10s to 30s #1544
• rpcserver: fix "mutually exclusive" err when using sats by @guggero in rpcserver: fix "mutually exclusive" err when using sats #1546
• tapdb: fix unit race flakes by @guggero in tapdb: fix unit race flakes #1547
• Refactor in Preparation for Ignore Tree RPC Endpoints by @ffranr in Refactor in Preparation for Ignore Tree RPC Endpoints #1541
• Proof-system-v1 by @gijswijs in Proof-system-v1 #1453
• multi: add testnet4 support by @guggero in multi: add testnet4 support #1553
• build: bump version to v0.6 rc2 by @Roasbeef in build: bump version to v0.6 rc2 #1552
• tapdb: allow reinsertion of an existing address to the book by @bhandras in tapdb: allow reinsertion of an existing address to the book #1549
• mod+taprpc: bump lnd to final v0.19.0 version by @guggero in mod+taprpc: bump lnd to final v0.19.0 version #1564
• tapd: allow skipping the funding step in CommitVirtualPsbts by @bhandras in tapd: allow skipping the funding step in CommitVirtualPsbts #1563
• proof: verify stxo proofs if present in v0 proofs by @gijswijs in proof: verify stxo proofs if present in v0 proofs #1568
• taprpc: fix AddInvoice documentation by @GeorgeTsagk in taprpc: fix AddInvoice documentation #1561
• docs: add support for asset group key in price oracle by @ffranr in docs: add support for asset group key in price oracle #1579
• sample-tapd.conf+tapcfg: add default signet/testnet4 uni servers by @guggero in sample-tapd.conf+tapcfg: add default signet/testnet4 uni servers #1555
• tapfreighter: fix OutboundParcel.Copy and add generic Copy fn test by @bhandras in tapfreighter: fix OutboundParcel.Copy and add generic Copy fn test #1580
• channels: check RFQ quote compatibility with channel at pathfind time by @guggero in channels: check RFQ quote compatibility with channel at pathfind time #1583
• version: bump version to v0.6.0-rc3 by @guggero in version: bump version to v0.6.0-rc3 #1584
• rpcserver: add decimal display to asset stats rpc by @jamaljsr in rpcserver: add decimal display to asset stats rpc #1566
• chain_bridge+fn: add retry logic for RPC calls to improve reliability in load-balanced environments by @Roasbeef in chain_bridge+fn: add retry logic for RPC calls to improve reliability in load-balanced environments #1585
• rpc: allow minting assets with empty metadata by @Roasbeef in rpc: allow minting assets with empty metadata #1592
• tapdb: use testing.TB for common test utilities, downgrade universe pref test to benchmark by @Roasbeef in tapdb: use testing.TB for common test utilities, downgrade universe pref test to benchmark  #1597
• Bump minimum compatible lnd version to v0.19.0, fix fee rounding issue in FundPsbt by @guggero in Bump minimum compatible lnd version to v0.19.0, fix fee rounding issue in FundPsbt #1600
• asset: tighten GroupKey equality checks and update tests by @ffranr in asset: tighten GroupKey equality checks and update tests #1599
• bugfix: fix btc-only balance force close, fix incorrect policy in invoice hop hint by @guggero in bugfix: fix btc-only balance force close, fix incorrect policy in invoice hop hint #1601
• tapchannel: add additional logging for commitment sort error cases by @Roasbeef in tapchannel: add additional logging for commitment sort error cases #1603
• proof: add debug utilities for manually fixing proofs by @guggero in proof: add debug utilities for manually fixing proofs #1604
• rpcserver: enforce keysend minimum carrier HTLC amount by @guggero in rpcserver: enforce keysend minimum carrier HTLC amount #1606
• build: bump version to v0.6.0 by @Roasbeef in build: bump version to v0.6.0 #1605

New Contributors

• @gcaracuel made their first contribution in tapcli: Global flags to accept ENV vars overrides. #1447
• @itsrachelfish made their first contribution in Updated ListAssetRequest to include additional filter options #1199
• @jamaljsr made their first contribution in Add chain_anchor with block_timestamp to AssetLeaves RPC #1480

Full Changelog: v0.5.1...v0.6.0

---

This discussion was created from the release v0.6.0.