tapdb: add implementation of supplycommit.SupplyTreeView

[Roasbeef]

In this commit, we add an implementation of the supplycommitment.SupplyTreeView interface to tapdb. This provides us with a concrete interface to be used along side #1464.

The structure is similar to the existing multi-verse trees, but we instead of scoping by proof type (issuance or transfer), we instead scope by the group key of a given asset.

Along the way we do some refactors to allow us to do atomic inserts across all the sub-trees, and also the root tree.

[ffranr]

I suspect it probably would be best to update the supply tree root here also as the TODO suggests. Within the same db transaction. If not here then where?

[Roasbeef]

So this is done in the final PR of the series. We broke out these internal functions to add to each supply tree as the final PR uses these to update the root supply tree all at once. Just like we have methods to update an individual universe tree, but in practice we always update the multiverse trees afterwards.

The reason I isolated this logic to the state machine is to ensure that via that interface, the set of supply roots are always consistent.

[lightninglabs-deploy]

@Roasbeef, remember to re-request review from reviewers when ready

[guggero]

Needs a linter fix and perhaps a rebase. Otherwise looks good to me.

[ffranr]

This patch fixes lint errors:

Subject: [PATCH] wallet: add method LndRpcWalletAnchor.DeriveNextKey()

Add `DeriveNextKey` method to `LndRpcWalletAnchor`, enabling it to
satisfy the `supplycommit.Wallet` interface.
---
Index: tapdb/universe.go
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/tapdb/universe.go b/tapdb/universe.go
--- a/tapdb/universe.go	(revision b8988d3a5a2c8f5a5b5c252698955c1b4b14f5cb)
+++ b/tapdb/universe.go	(date 1750685612847)
@@ -130,31 +130,6 @@
 		arg UpsertUniverseSupplyRoot) (int64, error)
 }
 
-// specifierToIdentifier converts an asset.Specifier into a universe.Identifier
-// for a specific proof type.
-//
-// NOTE: This makes an assumption that only specifiers with a group key are
-// valid for the ignore and burn proof types.
-func specifierToIdentifier(spec asset.Specifier,
-	proofType universe.ProofType) (universe.Identifier, error) {
-
-	var id universe.Identifier
-
-	// The specifier must have a group key to be able to be used within the
-	// ignore or burn tree context.
-	requireGroupKey := proofType == universe.ProofTypeIgnore ||
-		proofType == universe.ProofTypeBurn
-	if requireGroupKey && !spec.HasGroupPubKey() {
-		return id, fmt.Errorf("group key must be set for proof type %v",
-			proofType)
-	}
-
-	id.GroupKey = spec.UnwrapGroupKeyToPtr()
-	id.ProofType = proofType
-
-	return id, nil
-}
-
 // getUniverseTreeSum retrieves the sum of a universe tree specified by its
 // identifier.
 func getUniverseTreeSum(ctx context.Context, db BatchedUniverseTree,
Index: tapdb/supply_tree.go
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/tapdb/supply_tree.go b/tapdb/supply_tree.go
--- a/tapdb/supply_tree.go	(revision b8988d3a5a2c8f5a5b5c252698955c1b4b14f5cb)
+++ b/tapdb/supply_tree.go	(date 1750685675569)
@@ -278,7 +278,8 @@
 
 	groupKey, err := assetSpec.UnwrapGroupKeyOrErr()
 	if err != nil {
-		return nil, fmt.Errorf("group key must be specified for mint supply: %w", err)
+		return nil, fmt.Errorf("group key must be specified for "+
+			"mint supply: %w", err)
 	}
 	subNs := subTreeNamespace(groupKey, supplycommit.MintTreeType)
 
@@ -361,9 +362,8 @@
 
 	groupKey, err := spec.UnwrapGroupKeyOrErr()
 	if err != nil {
-		return nil, fmt.Errorf(
-			"group key must be specified for supply updates: %w", err,
-		)
+		return nil, fmt.Errorf("group key must be specified for "+
+			"supply updates: %w", err)
 	}
 
 	// Group updates by their sub-tree type, this'll simplify the logic

[ffranr]

If helpful, I cleaned up the linter errors and rebased the branch here: https://github.com/ffranr/taproot-assets/tree/rebased-universe-supply-trees

[Roasbeef]

Merging as the unit test failure is unrelated:

--- FAIL: TestBatchedAssetIssuance (86.69s)
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/001/tmp.db
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/002/tmp.db
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/003/tmp.db
    --- FAIL: TestBatchedAssetIssuance/minting_with_cancellation (61.28s)
        planter_test.go:312: 
            	Error Trace:	/home/runner/work/taproot-assets/taproot-assets/tapgarden/planter_test.go:312
            	            				/home/runner/work/taproot-assets/taproot-assets/tapgarden/planter_test.go:1312
            	            				/home/runner/work/taproot-assets/taproot-assets/tapgarden/planter_test.go:2048
            	Error:      	Condition never satisfied
            	Test:       	TestBatchedAssetIssuance/minting_with_cancellation
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/004/tmp.db
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/005/tmp.db
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/006/tmp.db
    test_sqlite.go:11: Creating new SQLite DB handle for testing: /tmp/TestBatchedAssetIssuance1396529981/007/tmp.db