Skip to content

[feature]: make tapcli commands aware of off chain assets in a channel #1634

Open
@ZZiigguurraatt

Description

@ZZiigguurraatt

tapcli provides a number of commands to list assets, asset groups, asset UTXOs, and asset balances. The docs for these commands use the word "all", but this is very misleading. These commands do not show assets in a channel. For example, if edward opens a taproot asset channel with frank, tapcli on frank will not show any assets at all.

If these commands are not going to show assets in a channel, the docs should more clearly state that and not use the word "all", but I'd really prefer these commands indicating both the off chain and on chain balances. I would like the asset UTXOs command to show what shared UTXOs are related to an open channel.

6c8e0655152b:/$ tapcli assets list -h
NAME:
   tapcli assets list - list all assets

USAGE:
   tapcli assets list [command options] [arguments...]

DESCRIPTION:
   list all pending and mined assets

OPTIONS:
   --show_witness            include the asset's witness data
   --show_spent              include fully spent assets in the list
   --show_leased             include leased assets in the list
   --show_unconfirmed_mints  include freshly minted and not yet confirmed assets in the list
   --script_key_type value   filter assets by the type of script key they use; possible values are: bip86, script-path, burn, tombstone, channel, unknown
   
6c8e0655152b:/$ 
6c8e0655152b:/$ tapcli assets groups -h
NAME:
   tapcli assets groups - list all asset groups

USAGE:
   tapcli assets groups [arguments...]

DESCRIPTION:
   list all asset groups known to the daemon
6c8e0655152b:/$ 
6c8e0655152b:/$ tapcli assets utxos -h
NAME:
   tapcli assets utxos - list all utxos

USAGE:
   tapcli assets utxos [command options] [arguments...]

DESCRIPTION:
   list all utxos managing assets

OPTIONS:
   --show_leased            include leased assets in the list
   --script_key_type value  filter assets by the type of script key they use; possible values are: bip86, script-path, burn, tombstone, channel, unknown
   
6c8e0655152b:/$ 
6c8e0655152b:/$ tapcli assets balance -h
NAME:
   tapcli assets balance - list asset balances

USAGE:
   tapcli assets balance [command options] [arguments...]

DESCRIPTION:
   list balances for all assets or a selected asset

OPTIONS:
   --by_group               Group asset balances by group key
   --include_leased         Include leased assets in balances
   --asset_id value         A specific asset ID to run the balance query against
   --group_key value        A specific asset group key to run the balance query against. Must be used together with --by_group
   --script_key_type value  filter assets by the type of script key they use; possible values are: script-path, burn, tombstone, channel, unknown, bip86
   
6c8e0655152b:/$ 

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions