Enhance `lncli` listchannels command with the chan_id and short_chan_id (human readable format) by NishantBansal2003 · Pull Request #9390 · lightningnetwork/lnd

NishantBansal2003 · 2024-12-28T09:51:27Z

Change Description

Fixes: #8650
This PR enhances channel ID representation by introducing both integer and string formats for ShortChannelId:

Renamed ChanId to ShortChanIdInt:
- Renamed to better reflect its role as the integer representation of ShortChannelId.
Added ShortChanId:
- Introduced a string representation of ShortChannelId in the format block x transaction x output.
Introduced chan_id:
- Added chan_id based on the definition in the BOLT-2 Peer Protocol specification, aligning with Lightning Network standards.

Steps to Test

Steps for reviewers to follow to test the change.

Pull Request Checklist

Testing

Your PR passes all CI checks.
Tests covering the positive and negative (error paths) are included.
Bug fixes contain tests triggering the bug to prevent regressions.

Code Style and Documentation

The change obeys the Code Documentation and Commenting guidelines, and lines wrap at 80.
Commits follow the Ideal Git Commit Structure.
Any new logging statements use an appropriate subsystem and logging level.
Any new lncli commands have appropriate tags in the comments for the rpc in the proto file.
There is a change description in the release notes, or [skip ci] in the commit message for small changes.

📝 Please see our Contribution Guidelines for further guidance.

coderabbitai · 2024-12-28T09:51:34Z

Important

Review skipped

Auto reviews are limited to specific labels.

🏷️ Labels to auto review (1)

llm-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

Review comments: Directly reply to a review comment made by CodeRabbit. Example:
- I pushed a fix in commit <commit_id>, please review it.
- Generate unit testing code for this file.
- Open a follow-up GitHub issue for this discussion.
Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
- @coderabbitai generate unit testing code for this file.
- @coderabbitai modularize this function.
PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
- @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
- @coderabbitai read src/utils.ts and generate unit testing code.
- @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
- @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

@coderabbitai pause to pause the reviews on a PR.
@coderabbitai resume to resume the paused reviews.
@coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
@coderabbitai full review to do a full review from scratch and review all the files again.
@coderabbitai summary to regenerate the summary of the PR.
@coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
@coderabbitai resolve resolve all the CodeRabbit review comments.
@coderabbitai configuration to show the current CodeRabbit configuration for the repository.
@coderabbitai help to get help.

Other keywords and placeholders

Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (`.coderabbit.yaml`)

You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
Please see the configuration documentation for more information.
If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

Visit our Documentation for detailed information on how to use CodeRabbit.
Join our Discord Community to get help, request features, and share feedback.
Follow us on X/Twitter for updates and announcements.

NishantBansal2003 · 2024-12-29T05:56:41Z

PTAL @ziggie1984

ziggie1984 · 2024-12-29T07:42:28Z

Please read the contribution guidelines thoroughly in particular what was immediately catching my eye is the commit structure

NishantBansal2003 · 2024-12-29T07:52:04Z

Please read the contribution guidelines thoroughly in particular what was immediately catching my eye is the commit structure

Got it! Working on it Now...

alexbosworth · 2024-12-29T16:47:07Z

Maybe people should be warned that a renaming an API attribute would break things

NishantBansal2003 · 2025-01-01T10:09:26Z

Hey @ziggie1984, I have addressed the Git commit structure and made the required changes based on your review. Please take a look.

ziggie1984 · 2025-01-01T22:44:08Z

Thank you for the PR, I think it is enough to have the short_chan_id and the normal channel_id in the rpc msg. Then when for example depicting the channel struct via lncli listchannels we should show both representation for the short channel id, but we should not put the different types into the protofile (int&string) that should then happen at the lncli or application level.

NishantBansal2003 · 2025-01-02T18:01:42Z

Thank you for the PR, I think it is enough to have the short_chan_id and the normal channel_id in the rpc msg. Then when for example depicting the channel struct via lncli listchannels we should show both representation for the short channel id, but we should not put the different types into the protofile (int&string) that should then happen at the lncli or application level.

Addresses the reviewed changes. Here is how the lncli listchannels output now appears (on the regtest network):

{
    "channels": [
        {
            "active": true,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "6ab312e3b744e1b80a33a6541697df88766515c31c08e839bf11dc9fcc036a19:0",
            "chan_id": "829031767408640",
            "capacity": "20000",
            "local_balance": "16530",
            "remote_balance": "0",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": true,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "354",
            "remote_chan_reserve_sat": "354",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "11",
            "uptime": "11",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": "",
            "channel_id": "196a03cc9fdc11bf39e8081cc315657688df971654a6330ab8e144b7e312b36a",
            "short_chan_id": "829031767408640",
            "short_chan_id_str": "754x1x0"
        },
        {
            "active": true,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "e428fb553769e4e53dbfb9749f8b057272969517ea85c63f46288487bfd62cf0:0",
            "chan_id": "807041534853120",
            "capacity": "100000",
            "local_balance": "0",
            "remote_balance": "96530",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": false,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "1000",
            "remote_chan_reserve_sat": "1000",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "459",
            "uptime": "421",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": "",
            "channel_id": "f02cd6bf878428463fc685ea1795967272058b9f74b9bf3de5e4693755fb28e4",
            "short_chan_id": "807041534853120",
            "short_chan_id_str": "734x1x0"
        }
    ]
}

ziggie1984 · 2025-01-02T21:25:03Z

While looking at the protobuf file, a lot of the structs use chan_id for the short channel id, so I am at this point not convinced about deprecating this value but rather just adding a new field for the longer channel id to keep the change small.

Maybe something like funding_outpoint_id

I think it is not really worth dealing with all these name changes in the protofiles if so many structs are affected. Wdyt @guggero ?

ziggie1984 · 2025-01-03T10:40:10Z

I have a better idea:

So initial request was to make the lncli listchannels output more detailed by adding the channel_id and also adding the human-readable representation of the short channel_id to the output of the command.

We can do all this by just changing the lncli program rather than touching the lnd core unit. The human-readable representation of the short_channel_id can be derived from the integer value currently already available. Moreover also the Xored ChannelID can be calculated using the ChannelPoint already available in the grpc msg.

So I favour the approach to not change anything in the RPC code, but just add all the information on the lncli side!

NishantBansal2003 · 2025-01-03T17:52:51Z

I have a better idea:

So initial request was to make the lncli listchannels output more detailed by adding the channel_id and also adding the human-readable representation of the short channel_id to the output of the command.

We can do all this by just changing the lncli program rather than touching the lnd core unit. The human-readable representation of the short_channel_id can be derived from the integer value currently already available. Moreover also the Xored ChannelID can be calculated using the ChannelPoint already available in the grpc msg.

So I favour the approach to not change anything in the RPC code, but just add all the information on the lncli side!

Done. Here is how the lncli listchannels output now appears:

{
    "channels": [
        {
            "active": false,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "6ab312e3b744e1b80a33a6541697df88766515c31c08e839bf11dc9fcc036a19:0",
            "funding_outpoint_id": "196a03cc9fdc11bf39e8081cc315657688df971654a6330ab8e144b7e312b36a",
            "chan_id": "829031767408640",
            "chan_id_str": "754x1x0",
            "capacity": "20000",
            "local_balance": "16530",
            "remote_balance": "0",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": true,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "354",
            "remote_chan_reserve_sat": "354",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        },
        {
            "active": false,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "e428fb553769e4e53dbfb9749f8b057272969517ea85c63f46288487bfd62cf0:0",
            "funding_outpoint_id": "f02cd6bf878428463fc685ea1795967272058b9f74b9bf3de5e4693755fb28e4",
            "chan_id": "807041534853120",
            "chan_id_str": "734x1x0",
            "capacity": "100000",
            "local_balance": "0",
            "remote_balance": "96530",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": false,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "1000",
            "remote_chan_reserve_sat": "1000",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        }
    ]
}

NishantBansal2003 · 2025-01-10T04:50:14Z

I have a better idea:
So initial request was to make the lncli listchannels output more detailed by adding the channel_id and also adding the human-readable representation of the short channel_id to the output of the command.
We can do all this by just changing the lncli program rather than touching the lnd core unit. The human-readable representation of the short_channel_id can be derived from the integer value currently already available. Moreover also the Xored ChannelID can be calculated using the ChannelPoint already available in the grpc msg.
So I favour the approach to not change anything in the RPC code, but just add all the information on the lncli side!

Done. Here is how the lncli listchannels output now appears:

{
    "channels": [
        {
            "active": false,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "6ab312e3b744e1b80a33a6541697df88766515c31c08e839bf11dc9fcc036a19:0",
            "funding_outpoint_id": "196a03cc9fdc11bf39e8081cc315657688df971654a6330ab8e144b7e312b36a",
            "chan_id": "829031767408640",
            "chan_id_str": "754x1x0",
            "capacity": "20000",
            "local_balance": "16530",
            "remote_balance": "0",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": true,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "354",
            "remote_chan_reserve_sat": "354",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        },
        {
            "active": false,
            "remote_pubkey": "02769271ddfb03149bc9e2e6124bb8d83209284dda3affed0dead73f57b64f45dd",
            "channel_point": "e428fb553769e4e53dbfb9749f8b057272969517ea85c63f46288487bfd62cf0:0",
            "funding_outpoint_id": "f02cd6bf878428463fc685ea1795967272058b9f74b9bf3de5e4693755fb28e4",
            "chan_id": "807041534853120",
            "chan_id_str": "734x1x0",
            "capacity": "100000",
            "local_balance": "0",
            "remote_balance": "96530",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": false,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "1000",
            "remote_chan_reserve_sat": "1000",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "02769271ddfb03149bc9",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        }
    ]
}

Hi @ziggie1984, just following up in case my previous message was missed.

ziggie1984

Yes this is the right approach, left some suggestions. Please also update all the comments as well if you adopt them.

ziggie1984 · 2025-01-13T08:37:49Z

  This is a protocol gadget required for Dynamic Commitments and Splicing that
  will be added later.

+* [Added]((https://github.com/lightningnetwork/lnd/pull/9390)) 


add the release notes under the lncli section

NishantBansal2003 · 2025-01-13T17:38:04Z

New output:

{
    "channels": [
        {
            "active": false,
            "remote_pubkey": "0367cb414c9487311a1466b51b911c994d3438713edc373a27110a7162ac1046f5",
            "chan_point": "6ab312e3b744e1b80a33a6541697df88766515c31c08e839bf11dc9fcc036a19:0",
            "chan_id": "196a03cc9fdc11bf39e8081cc315657688df971654a6330ab8e144b7e312b36a",
            "scid": "829031767408640",
            "scid_str": "754x1x0",
            "capacity": "20000",
            "local_balance": "0",
            "remote_balance": "16530",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": false,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "354",
            "remote_chan_reserve_sat": "354",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "354",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "19800000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "0367cb414c9487311a14",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        },
        {
            "active": false,
            "remote_pubkey": "0367cb414c9487311a1466b51b911c994d3438713edc373a27110a7162ac1046f5",
            "chan_point": "e428fb553769e4e53dbfb9749f8b057272969517ea85c63f46288487bfd62cf0:0",
            "chan_id": "f02cd6bf878428463fc685ea1795967272058b9f74b9bf3de5e4693755fb28e4",
            "scid": "807041534853120",
            "scid_str": "734x1x0",
            "capacity": "100000",
            "local_balance": "96530",
            "remote_balance": "0",
            "commit_fee": "3140",
            "commit_weight": "772",
            "fee_per_kw": "2500",
            "unsettled_balance": "0",
            "total_satoshis_sent": "0",
            "total_satoshis_received": "0",
            "num_updates": "0",
            "pending_htlcs": [],
            "csv_delay": 144,
            "private": false,
            "initiator": true,
            "chan_status_flags": "ChanStatusDefault",
            "local_chan_reserve_sat": "1000",
            "remote_chan_reserve_sat": "1000",
            "static_remote_key": false,
            "commitment_type": "ANCHORS",
            "lifetime": "0",
            "uptime": "0",
            "close_address": "",
            "push_amount_sat": "0",
            "thaw_height": 0,
            "local_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "remote_constraints": {
                "csv_delay": 144,
                "chan_reserve_sat": "1000",
                "dust_limit_sat": "354",
                "max_pending_amt_msat": "99000000",
                "min_htlc_msat": "1",
                "max_accepted_htlcs": 483
            },
            "alias_scids": [],
            "zero_conf": false,
            "zero_conf_confirmed_scid": "0",
            "peer_alias": "0367cb414c9487311a14",
            "peer_scid_alias": "0",
            "memo": "",
            "custom_channel_data": ""
        }
    ]
}

ziggie1984

Great work, had some final comments.

ziggie1984

LGTM 🎉

guggero

Thanks for the PR. Approach ACK.

guggero · 2025-01-14T08:45:24Z

+			// Format a new JSON field for the scid (chan_id),
+			// including both its numeric representation and its
+			// string representation (scid_str).
+			scidStr := lnwire.NewShortChanIDFromInt(scid).String()


Related to my previous comment, we could either call into the alternative method here or do some replacement here directly.

guggero · 2025-01-14T08:46:47Z

  now update the channel policy if the edge was not found in the graph
  database if the `create_missing_edge` flag is set.

+* [Enhance](https://github.com/lightningnetwork/lnd/pull/9390) the `lncli listchannels` output by adding the human readable short channel id and the channel id defined in BOLT02. Moreover change the misnomer of `chan_id` which was describing the short channel id to `scid` to represent what it really is.


Please wrap lines at 80 characters here as well.

ziggie1984

Can you squash the commits

guggero

Nice, thanks for the update. Two more nits then we're good to go!

guggero · 2025-01-15T08:57:58Z

 	return fmt.Sprintf("%d:%d:%d", c.BlockHeight, c.TxIndex, c.TxPosition)
 }

+// String generates a human-readable representation of the channel ID


The Godoc domment needs to match the actual method name here.

guggero · 2025-01-15T08:58:19Z

+			)[1]
+
+			chanOutpoint, err := wire.NewOutPointFromString(
+				chanPoint)


nit: closing parenthesis should go to a new line.

ziggie1984 · 2025-01-15T09:08:01Z

Maybe I was not clear enough in my previous comment but I meant to squash unnecessary commits that didn't mean squashing the release notes for example.

Add the `AltString` method for `ShortChannelID` to produce a human-readable format with 'x' as a separator (block x transaction x output). Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

ziggie1984

Can squash the unit test commit with the commit which introduces the functions.

LGTM

Added scid_str as a string representation of chan_id, replacing chan_id with scid, and including chan_id(BOLT02) in lncli listchannels output. Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

NishantBansal2003 force-pushed the append-channel branch from 6cf95f0 to 755d729 Compare December 28, 2024 10:00

ziggie1984 reviewed Dec 29, 2024

View reviewed changes

Comment thread lnrpc/lightning.proto Outdated

NishantBansal2003 force-pushed the append-channel branch from 755d729 to 3d19e19 Compare January 1, 2025 10:04

NishantBansal2003 changed the title ~~lnrpc: append listchannels command with the chan_id and short_chan_id~~ lnrpc+lnwire: append listchannels command with the chan_id and short_chan_id Jan 1, 2025

NishantBansal2003 requested a review from ziggie1984 January 1, 2025 10:09

NishantBansal2003 force-pushed the append-channel branch from 90ed477 to de85265 Compare January 3, 2025 17:50

ziggie1984 requested changes Jan 13, 2025

View reviewed changes

NishantBansal2003 force-pushed the append-channel branch from de85265 to 2999a81 Compare January 13, 2025 17:37

ziggie1984 added lncli no-itest labels Jan 13, 2025

saubyk self-requested a review January 13, 2025 18:00

saubyk assigned NishantBansal2003 Jan 13, 2025

ziggie1984 changed the title ~~lnrpc+lnwire: append listchannels command with the chan_id and short_chan_id~~ Enhance lncli listchannels command with the chan_id and short_chan_id (human readable format) Jan 13, 2025

ziggie1984 requested changes Jan 13, 2025

View reviewed changes

Comment thread cmd/commands/commands.go Outdated

Comment thread cmd/commands/commands.go Outdated

Comment thread cmd/commands/commands.go Outdated

Comment thread docs/release-notes/release-notes-0.19.0.md Outdated

NishantBansal2003 force-pushed the append-channel branch from 2999a81 to 7e44c02 Compare January 14, 2025 04:38

ziggie1984 approved these changes Jan 14, 2025

View reviewed changes

guggero reviewed Jan 14, 2025

View reviewed changes

ziggie1984 requested changes Jan 14, 2025

View reviewed changes

NishantBansal2003 force-pushed the append-channel branch from 64bf8a9 to 0b11cec Compare January 14, 2025 14:52

guggero self-requested a review January 14, 2025 15:52

guggero reviewed Jan 15, 2025

View reviewed changes

lnwire: add 'x' separator in ShortChannelID method

7f8e89f

Add the `AltString` method for `ShortChannelID` to produce a human-readable format with 'x' as a separator (block x transaction x output). Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

NishantBansal2003 force-pushed the append-channel branch from 0b11cec to 58cb93a Compare January 15, 2025 10:19

ziggie1984 approved these changes Jan 15, 2025

View reviewed changes

Comment thread cmd/commands/commands_test.go

Comment thread cmd/commands/commands_test.go Outdated

ziggie1984 removed the request for review from saubyk January 15, 2025 10:37

NishantBansal2003 added 2 commits January 15, 2025 17:58

cmd/lncli: update listchannels output fields

103a194

Added scid_str as a string representation of chan_id, replacing chan_id with scid, and including chan_id(BOLT02) in lncli listchannels output. Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

docs: add release notes.

c2897a4

Signed-off-by: Nishant Bansal <nishant.bansal.282003@gmail.com>

NishantBansal2003 force-pushed the append-channel branch from 58cb93a to c2897a4 Compare January 15, 2025 12:29

guggero self-requested a review January 15, 2025 12:30

guggero approved these changes Jan 15, 2025

View reviewed changes

guggero merged commit 572784a into lightningnetwork:master Jan 15, 2025

ziggie1984 mentioned this pull request Jan 15, 2025

Add human-readable short channel ID #8676

Closed

7 tasks

ziggie1984 mentioned this pull request Feb 10, 2025

For some lncli cmds we should not replace the content with other data #9493

Merged

Conversation

NishantBansal2003 commented Dec 28, 2024

Change Description

Steps to Test

Pull Request Checklist

Testing

Code Style and Documentation

Uh oh!

coderabbitai Bot commented Dec 28, 2024

Review skipped

Chat

CodeRabbit Commands (Invoked using PR comments)

Other keywords and placeholders

CodeRabbit Configuration File (.coderabbit.yaml)

Documentation and Community

Uh oh!

NishantBansal2003 commented Dec 29, 2024

Uh oh!

ziggie1984 commented Dec 29, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

NishantBansal2003 commented Dec 29, 2024

Uh oh!

alexbosworth commented Dec 29, 2024

Uh oh!

Uh oh!

NishantBansal2003 commented Jan 1, 2025

Uh oh!

ziggie1984 commented Jan 1, 2025

Uh oh!

NishantBansal2003 commented Jan 2, 2025

Uh oh!

ziggie1984 commented Jan 2, 2025

Uh oh!

ziggie1984 commented Jan 3, 2025

Uh oh!

NishantBansal2003 commented Jan 3, 2025

Uh oh!

NishantBansal2003 commented Jan 10, 2025

Uh oh!

ziggie1984 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ziggie1984 Jan 13, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

NishantBansal2003 commented Jan 13, 2025

Uh oh!

ziggie1984 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ziggie1984 left a comment

Choose a reason for hiding this comment

Uh oh!

guggero left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

guggero Jan 14, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

guggero Jan 14, 2025

Choose a reason for hiding this comment

Uh oh!

ziggie1984 left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

guggero left a comment

Choose a reason for hiding this comment

Uh oh!

guggero Jan 15, 2025

CodeRabbit Configuration File (`.coderabbit.yaml`)

ziggie1984 commented Dec 29, 2024 •

edited

Loading

ziggie1984 left a comment •

edited

Loading