mirrors/bitcoin-bips
1
0
Fork 0
mirror of https://github.com/bitcoin/bips.git synced 2025-03-04 11:08:05 +01:00
Code Issues Projects Releases Wiki Activity

bip-tap: correct asset_tree_root usage

Browse source 
The field `asset_tree_root` is not 40 bytes long, but 32.

This is both consistent with the implementation, and with the definition
of the field further down in this bip.

Definition:

> the asset tree is calculated as either:
> * <code>asset_tree_root = sha256(asset_id || left_hash || right_hash
> || sum_value)</code>
> or
> * <code>asset_tree_root = sha256(asset_group_key || left_hash ||
> right_hash || sum_value)</code>

Implementation:

```
leafParts := [][]byte{
  {byte(c.Version)}, TaprootAssetsMarker[:], rootHash[:],
  rootSum[:],
}
```

The bip now reflects this.
This commit is contained in:
Gijs van Dam 2024-03-13 13:38:37 +01:00
parent 6dd3458ddc
commit 71c83e5999
No known key found for this signature in database
GPG key ID: 019A44857735FD20
1 changed files with 4 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
bip-tap.mediawiki
View file

@ -212,12 +212,13 @@ asset ID. A given Taproot Asset tree is composed of two nested MS-SMT instances:
The root hash of an asset tree, observing [[../master/bip-0341.mediawiki|BIP-341]] is The root hash of an asset tree, observing [[../master/bip-0341.mediawiki|BIP-341]] is
represented as a Tapscript tree that commits to a single unique leaf of: represented as a Tapscript tree that commits to a single unique leaf of:
* <code>tagged_hash("TapLeaf", leaf_version || taproot_asset_marker || taproot_asset_version || asset_tree_root)</code> * <code>tagged_hash("TapLeaf", leaf_version || taproot_asset_marker || asset_tree_root || sum_value)</code>
where: where:
* <code>taproot_asset_marker</code> is the <code>sha256</code> hash of the ascii string "taproot-assets". * <code>taproot_asset_marker</code> is the <code>sha256</code> hash of the ascii string "taproot-assets".
* <code>taproot_asset_version</code> is the version of the Taproot Assets system which defines how the remainder of the commitment value is to be interpreted. * <code>taproot_asset_version</code> is the version of the Taproot Assets system which defines how the remainder of the commitment value is to be interpreted.
* <code>asset_tree_root</code> is a 40 byte (32 byte for hash, 8 bytes for value) MS-SMT root. * <code>asset_tree_root</code> is the 32-byte <code>sha256</code> root hash of the asset tree.
* <code>sum_value</code> is the 8-byte sum of the <code>amt</code> values of each of the asset leaves.
A <code>leaf_version</code> of ??? is selected. From the PoV of the Bitcoin A <code>leaf_version</code> of ??? is selected. From the PoV of the Bitcoin
@ -438,7 +439,7 @@ tranches of the same asset) or collectibles.
* <code>asset_id</code> is the 32-byte asset ID specified above * <code>asset_id</code> is the 32-byte asset ID specified above
* <code>left_hash</code> is the hash of the left sub-tree. * <code>left_hash</code> is the hash of the left sub-tree.
* <code>right_hash</code> is the hash of the right sub-tree. * <code>right_hash</code> is the hash of the right sub-tree.
* <code>amt_sum</code> is the sum of the <code>amt</code> values of each of the asset leaves (essentially asset UTXOs). * <code>sum_value</code> is the sum of the <code>amt</code> values of each of the asset leaves (essentially asset UTXOs).
Committing to the total sum of the asset values in a given asset sub-tree for a Committing to the total sum of the asset values in a given asset sub-tree for a
given asset allows asset holders to easily prove how much of a given asset they given asset allows asset holders to easily prove how much of a given asset they