Skip to content

tapassets: persist asset state for mixed OOR transfers #1038

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
darioAnongba wants to merge 2 commits into from
Closed

tapassets: persist asset state for mixed OOR transfers #1038

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
71bc12a
docs: plan durable Taproot Asset state
darioAnongba Jul 21, 2026
abbf783
tapassets: persist asset state for mixed OOR transfers
darioAnongba Jul 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 26 additions & 4 deletions arkrpc/ark.pb.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 8 additions & 0 deletions arkrpc/ark.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,14 @@ message RegisterTaprootAssetVTXORequest {
// taproot_asset_root is repeated explicitly so cheap request bounds and
// script composition checks can run before persistence.
bytes taproot_asset_root = 4;

// taproot_asset_ref is the opaque SDK-level asset identity committed by
// the sealed package.
string taproot_asset_ref = 5;

// taproot_asset_amount is the number of asset units in the admitted
// output. The anchor output value remains carrier satoshis.
uint64 taproot_asset_amount = 6;
}

message RegisterTaprootAssetVTXOResponse {
Expand Down
112 changes: 100 additions & 12 deletions arkrpc/indexer.pb.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

32 changes: 32 additions & 0 deletions arkrpc/indexer.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,14 @@ message OORRecipientEvent {
// taproot_asset_transfer is the optional versioned Wavelength container
// of sealed tap-sdk packages for the checkpoint and Ark transitions.
bytes taproot_asset_transfer = 11;

// taproot_asset_ref is the opaque SDK-level asset identity carried by
// this recipient output.
string taproot_asset_ref = 12;

// taproot_asset_amount is the number of asset units carried by this
// output. value remains the separate Bitcoin carrier amount.
uint64 taproot_asset_amount = 13;
}

// OORSessionPackage carries finalized package artifacts for one OOR session.
Expand Down Expand Up @@ -468,6 +476,18 @@ message VTXO {
// IncomingVTXOEvent) does not yet carry this field and adopts it as a
// fast-follow. Today the only understood value is 1.
uint32 construction_version = 20;

// taproot_asset_root is the optional 32-byte Taproot Asset commitment
// root anchored in this VTXO.
bytes taproot_asset_root = 21;

// taproot_asset_ref is the opaque SDK-level asset identity carried by
// this VTXO.
string taproot_asset_ref = 22;

// taproot_asset_amount is the number of asset units carried by this VTXO.
// value_sat remains the separate Bitcoin carrier value.
uint64 taproot_asset_amount = 23;
}

message ListVTXOsByScriptsRequest {
Expand Down Expand Up @@ -642,4 +662,16 @@ message IncomingVTXOEvent {
// commitment transaction. This is distinct from the leaf txid
// carried in the outpoint field.
bytes commitment_txid = 11;

// taproot_asset_root is the optional 32-byte Taproot Asset commitment
// root anchored in this VTXO.
bytes taproot_asset_root = 12;

// taproot_asset_ref is the opaque SDK-level asset identity carried by
// this VTXO.
string taproot_asset_ref = 13;

// taproot_asset_amount is the number of asset units carried by this VTXO.
// value_sat remains the separate Bitcoin carrier value.
uint64 taproot_asset_amount = 14;
}
6 changes: 5 additions & 1 deletion db/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ For field-level detail, use `go doc github.com/lightninglabs/wavelength/db.<Symb
safety bounds enforced during `DeserializeTree`.
- `resolveInputPackage` / `loadPackageBundleBySessionID` — two-stage
OOR ancestry resolver (`oor_unroll_resolver.go`).
- `LatestMigrationVersion = 17` — current schema version.
- `LatestMigrationVersion = 18` — current schema version.
- `PendingIntentPersistenceStore` — implements `wallet.PendingIntentStore`,
the persistence half of the generic restart-safe intent outbox (header
`pending_intents` + per-kind detail tables + `pending_intent_anchors`).
Expand Down Expand Up @@ -203,6 +203,10 @@ when adding one.
VTXO descriptors; generic Bitcoin coin selection excludes these rows.
- `000017_oor_taproot_asset_packages` — optional sealed Taproot Asset
transition container on finalized OOR package rows.
- `000018_taproot_asset_vtxo_metadata` — optional SDK-neutral asset reference
and full-width unsigned asset amount on VTXO descriptors. The amount is an
eight-byte big-endian BLOB because SQL `BIGINT` cannot represent all
`uint64` Taproot Asset quantities.

## Deep Docs

Expand Down
2 changes: 1 addition & 1 deletion db/migrations.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ const (
// daemon.
//
// NOTE: This MUST be updated when a new migration is added.
LatestMigrationVersion uint = 17
LatestMigrationVersion uint = 18
)

// MigrationTarget is a functional option that can be passed to applyMigrations
Expand Down
Loading