Discrepancy on the response of channels command

[mohitk108]

Hi, in the eclair API documentation, the sample response for the command channels is given as:

[
  {
    "nodeId": "02ca41676c9dfff08553528b151b1bf82031a26bb1d6f852e0f8075d33fa4ea089",
    "channelId": "79ac97e88aacb9671cef9c75f9d53ef7c534a74c9f7bd65eb95a808bb6845efb",
    "state": "WAIT_FOR_DUAL_FUNDING_CONFIRMED",
    "data": {
      "type": "DATA_WAIT_FOR_DUAL_FUNDING_CONFIRMED",
      "commitments": {
        "params": {
          "channelId": "79ac97e88aacb9671cef9c75f9d53ef7c534a74c9f7bd65eb95a808bb6845efb",
          "channelConfig": [
            "funding_pubkey_based_channel_keypath"
          ],
          "channelFeatures": [
            "option_static_remotekey",
            "option_anchors_zero_fee_htlc_tx",
            "option_dual_fund"
          ],
          "localParams": {
            "nodeId": "0270508d93eef07ddc0e19a0da981a273c419b2f7403a708fd0618e9a3f2e97ae2",
            "fundingKeyPath": [
              3351215530,
              3592259429,
              613400752,
              3326162843,
              1298359959,
              1819748777,
              1053912551,
              2174366698,
              2147483649
            ],
            "dustLimit": 546,
            "maxHtlcValueInFlightMsat": 300000000,
            "htlcMinimum": 1,
            "toSelfDelay": 120,
            "maxAcceptedHtlcs": 30,
            "isInitiator": true,
            "initFeatures": {
              "activated": {
                "option_route_blinding": "optional",
                "option_dual_fund": "optional",
                "gossip_queries_ex": "optional",
                "option_data_loss_protect": "optional",
                "var_onion_optin": "mandatory",
                "option_static_remotekey": "optional",
                "option_scid_alias": "optional",
                "option_onion_messages": "optional",
                "option_support_large_channel": "optional",
                "option_anchors_zero_fee_htlc_tx": "optional",
                "payment_secret": "mandatory",
                "option_shutdown_anysegwit": "optional",
                "option_channel_type": "optional",
                "basic_mpp": "optional",
                "gossip_queries": "optional"
              },
              "unknown": []
            }
          },
          "remoteParams": {
            "nodeId": "02ca41676c9dfff08553528b151b1bf82031a26bb1d6f852e0f8075d33fa4ea089",
            "dustLimit": 546,
            "maxHtlcValueInFlightMsat": 300000000,
            "htlcMinimum": 1,
            "toSelfDelay": 120,
            "maxAcceptedHtlcs": 30,
            "revocationBasepoint": "0219c9cbea7e1bc1ccdb74ea9f36740b59795532223d2fd3dfee76771bdce28c05",
            "paymentBasepoint": "036b53ff80de6d3f6f46f98aab0027632648a9da321fc8935dff3c1d6babd65ff0",
            "delayedPaymentBasepoint": "026946d392806333bc1c81f78fecbc9b1c62c8f2700f4e63df6f197ffd46f08fe0",
            "htlcBasepoint": "034b3158f2b5d20983bd080ddaf7a42aaba43fb4d993d3b83c6a84935325edaeed",
            "initFeatures": {
              "activated": {
                "option_route_blinding": "optional",
                "option_dual_fund": "optional",
                "gossip_queries_ex": "optional",
                "option_data_loss_protect": "optional",
                "var_onion_optin": "mandatory",
                "option_static_remotekey": "optional",
                "option_scid_alias": "optional",
                "option_onion_messages": "optional",
                "option_support_large_channel": "optional",
                "option_anchors_zero_fee_htlc_tx": "optional",
                "payment_secret": "mandatory",
                "option_shutdown_anysegwit": "optional",
                "option_channel_type": "optional",
                "basic_mpp": "optional",
                "gossip_queries": "optional"
              },
              "unknown": []
            }
          },
          "channelFlags": {
            "announceChannel": true
          }
        },
        "changes": {
          "localChanges": {
            "proposed": [],
            "signed": [],
            "acked": []
          },
          "remoteChanges": {
            "proposed": [],
            "acked": [],
            "signed": []
          },
          "localNextHtlcId": 0,
          "remoteNextHtlcId": 0
        },
        "active": [
          {
            "fundingTxIndex": 0,
            "fundingTx": {
              "outPoint": "bc2b8db55b9588d3a18bd06bd0e284f63ee8cc149c63138d51ac8ef81a72fc6f:1",
              "amountSatoshis": 300000
            },
            "localFunding": {
              "status": "unconfirmed",
              "txid": "bc2b8db55b9588d3a18bd06bd0e284f63ee8cc149c63138d51ac8ef81a72fc6f"
            },
            "remoteFunding": {
              "status": "not-locked"
            },
            "localCommit": {
              "index": 0,
              "spec": {
                "htlcs": [],
                "commitTxFeerate": 1000,
                "toLocal": 300000000,
                "toRemote": 0
              },
              "commitTxAndRemoteSig": {
                "commitTx": {
                  "txid": "0a2ae74dc8b4a0237f5bace62ec598b6a8ac54248b8c1b6a2faf2bd4c3475146",
                  "tx": "02000000016ffc721af88eac518d13639c14cce83ef684e2d06bd08ba1d388955bb58d2bbc01000000000d884680024a0100000000000022002040a846ed0af5668f92035af69d9533090fba4ff220fdf763cb33b39c286c8b03e88c040000000000220020aa0e40851424e7770d899b0fd9200115e21ebcbbc07a700dbb8b6287b3d103e6ac09af20"
                },
                "remoteSig": "575a04b657e350d59e6bb3e97c3f43734cb8370056c754723c9ef49a672eb8780b80b716fc4a88166c4c4091f583627fe63f0dbbc6e6a3f44ef1d5f24094068a"
              },
              "htlcTxsAndRemoteSigs": []
            },
            "remoteCommit": {
              "index": 0,
              "spec": {
                "htlcs": [],
                "commitTxFeerate": 1000,
                "toLocal": 0,
                "toRemote": 300000000
              },
              "txid": "3a8c5e919bd8af19ee0211024603cdda754dcf232abb4fe530364e58de2f9182",
              "remotePerCommitmentPoint": "02a65c872392729f53069c05933ba3f6c705d4ab8296c0704b58f96bc29b30e38f"
            }
          }
        ],
        "inactive": [],
        "remoteNextCommitInfo": "03e41546ef474c71fba0a3d1076ed11d7ef37a2dd60d320ac008fa4780ebdf4b34",
        "remotePerCommitmentSecrets": null,
        "originChannels": {}
      },
      "localPushAmount": 0,
      "remotePushAmount": 0,
      "waitingSince": 2937,
      "lastChecked": 2937,
      "rbfStatus": {}
    }
  }
]

But when I run the command locally, I get the response:

claddy@claddy:~/Documents/eclair-cli$ eclair-cli -p password channels
[
  {
    "nodeId": "02f666711319435b7905dd77d10c269d8d50c02668b975f526577167d370b50a3e",
    "channelId": "c872066be83c163872864f9fcdd6ac2c8a2090fb1c65dd610495dddcf10279a1",
    "state": "NORMAL",
    "data": {
      "type": "DATA_NORMAL",
      "commitments": {
        "params": {
          "channelId": "c872066be83c163872864f9fcdd6ac2c8a2090fb1c65dd610495dddcf10279a1",
          "channelConfig": [
            "funding_pubkey_based_channel_keypath"
          ],
          "channelFeatures": [
            "option_static_remotekey",
            "option_anchors_zero_fee_htlc_tx"
          ],
          "localParams": {
            "nodeId": "03c5b161c16e9f8ef3f3bccfb74a6e9a3b423dd41fe2848174b7209f1c2ea25dad",
            "fundingKeyPath": [
              1311213930,
              2829514417,
              1423063365,
              2398310670,
              2694454528,
              4250611493,
              4231913118,
              3437719160,
              2147483649
            ],
            "dustLimit": 546,
            "maxHtlcValueInFlightMsat": 45000000,
            "requestedChannelReserve_opt": 1000,
            "htlcMinimum": 1,
            "toSelfDelay": 720,
            "maxAcceptedHtlcs": 30,
            "isInitiator": true,
            "initFeatures": {
              "activated": {
                "gossip_queries_ex": "optional",
                "option_data_loss_protect": "optional",
                "var_onion_optin": "mandatory",
                "option_static_remotekey": "optional",
                "option_scid_alias": "optional",
                "option_onion_messages": "optional",
                "option_support_large_channel": "optional",
                "option_anchors_zero_fee_htlc_tx": "optional",
                "payment_secret": "mandatory",
                "option_shutdown_anysegwit": "optional",
                "option_channel_type": "optional",
                "basic_mpp": "optional",
                "gossip_queries": "optional"
              },
              "unknown": []
            }
          },
          "remoteParams": {
            "nodeId": "02f666711319435b7905dd77d10c269d8d50c02668b975f526577167d370b50a3e",
            "dustLimit": 546,
            "maxHtlcValueInFlightMsat": 45000000,
            "requestedChannelReserve_opt": 1000,
            "htlcMinimum": 1,
            "toSelfDelay": 720,
            "maxAcceptedHtlcs": 30,
            "revocationBasepoint": "024d4256cf1d6b1773d28c6826da9b1187b05da68ad88668e113eaf7b921ce0d8a",
            "paymentBasepoint": "022af9b3d30cd27ebd29f3635ce55d713eb3726569094d55ab6d6ae77bae30582f",
            "delayedPaymentBasepoint": "026499438086c883aeecb3c0c9b6cc79e8c759c98853e79a31712ac1269ae8f76b",
            "htlcBasepoint": "023e5bebda676f581220b40a4f4fc91f4ef6670dbecc9efe7bf31b9f345cd6348a",
            "initFeatures": {
              "activated": {
                "gossip_queries_ex": "optional",
                "option_data_loss_protect": "optional",
                "var_onion_optin": "mandatory",
                "option_static_remotekey": "optional",
                "option_scid_alias": "optional",
                "option_onion_messages": "optional",
                "option_support_large_channel": "optional",
                "option_anchors_zero_fee_htlc_tx": "optional",
                "payment_secret": "mandatory",
                "option_shutdown_anysegwit": "optional",
                "option_channel_type": "optional",
                "basic_mpp": "optional",
                "gossip_queries": "optional"
              },
              "unknown": []
            }
          },
          "channelFlags": {
            "announceChannel": true
          }
        },
        "changes": {
          "localChanges": {
            "proposed": [],
            "signed": [],
            "acked": []
          },
          "remoteChanges": {
            "proposed": [],
            "acked": [],
            "signed": []
          },
          "localNextHtlcId": 0,
          "remoteNextHtlcId": 0
        },
        "active": [
          {
            "fundingTxIndex": 0,
            "fundingTx": {
              "outPoint": "a17902f1dcdd950461dd651cfb90208a2cacd6cd9f4f867238163ce86b0672c8:0",
              "amountSatoshis": 100000
            },
            "localFunding": {
              "status": "confirmed",
              "txid": "a17902f1dcdd950461dd651cfb90208a2cacd6cd9f4f867238163ce86b0672c8"
            },
            "remoteFunding": {
              "status": "not-locked"
            },
            "localCommit": {
              "index": 0,
              "spec": {
                "htlcs": [],
                "commitTxFeerate": 2500,
                "toLocal": 100000000,
                "toRemote": 0
              },
              "commitTxAndRemoteSig": {
                "commitTx": {
                  "txid": "a9cf7e17a853cf97570729a7ed376084ef16064c40d4ce7d7fb624a7e68ac577",
                  "tx": "0200000001c872066be83c163872864f9fcdd6ac2c8a2090fb1c65dd610495dddcf10279a100000000005b81d080024a01000000000000220020f46d9b14c8fe6b939fc2d3aedb76b8eeda4cbf7089cb368ca6c40210fb05f8ae127901000000000022002070527961be7da795c4b7977567b54dbadd1d276d06865151aba6cdfa08fded00985bd520"
                },
                "remoteSig": "c72d95ecfa65b783ee83e08fe6656a58ac07bff2f093dcb35e17a4dd9b7a48e228dd15c209021dcf6e162d4f24e3e309f31e3e324c00a05a084549b5ab796b75"
              },
              "htlcTxsAndRemoteSigs": []
            },
            "remoteCommit": {
              "index": 0,
              "spec": {
                "htlcs": [],
                "commitTxFeerate": 2500,
                "toLocal": 0,
                "toRemote": 100000000
              },
              "txid": "f937a0aeef7d53d609c7ca708b62676a6f8be96911f54afd10f6019d3911c8d0",
              "remotePerCommitmentPoint": "0210a3c374ebe6fd2cca7e9390a6c16f867d823135bc2429febbef9a4a66430b99"
            }
          }
        ],
        "inactive": [],
        "remoteNextCommitInfo": "02ff0ca6769f2e809c84dfb82762be93c231473328eca9d524789dfb9c8be86f14",
        "remotePerCommitmentSecrets": null,
        "originChannels": {}
      },
      "shortIds": {
        "real": {
          "status": "final",
          "realScid": "151x3x0"
        },
        "localAlias": "0xd2077a77f84256",
        "remoteAlias": "0x3b74abc3898a9bf"
      },
      "channelAnnouncement": {
        "nodeSignature1": "e3beac7a8096e97f7867ee9af4b75ad35bffa29643f7e358ff96e99170096e3f3a65aa66ca7a4386d3f9200eae34cd5557426f9cca0d99fbb11372b77f25fffe",
        "nodeSignature2": "ee545e5b03439286c67dd227113ad7c1e77ee57726a51f9a564366e2bd61b77816a1a26b010b0ef50dc48ffc11574ab5946ed523acddd2b4c881efc75e35c6ae",
        "bitcoinSignature1": "d751d843cfdada201a921c3f71a0fa28b860d41ab4ee1fbec11cbbea2234480c6338eaf4c2f09a21d64618f490c1fe0e166b9ba5c41d6fc49d05dedd83011d7e",
        "bitcoinSignature2": "35dceab26e7526a2a3949b5864ca84dfa382452938c742541b63e9119e08224111638436b2a2b9884844c892aa02a7b255c62dfcf5e5b09a226e384f25d00ed2",
        "features": {
          "activated": {},
          "unknown": []
        },
        "chainHash": "06226e46111a0b59caaf126043eb5bbf28c34f3a5e332a1fc7b2b73cf188910f",
        "shortChannelId": "151x3x0",
        "nodeId1": "02f666711319435b7905dd77d10c269d8d50c02668b975f526577167d370b50a3e",
        "nodeId2": "03c5b161c16e9f8ef3f3bccfb74a6e9a3b423dd41fe2848174b7209f1c2ea25dad",
        "bitcoinKey1": "02dd22336ac6eca88398ccade9b6fb3c969dcd9ae5cbeea30f6b9e626a6ff88fa7",
        "bitcoinKey2": "0251bf3ad0dc21235585b2ac7fc9a5e6b5bf6ff5f401963d1bb3c61c60ffca4cb9",
        "tlvStream": {}
      },
      "channelUpdate": {
        "signature": "615fab66837d37f0fe9a949b97a6fadd37d42dcfd9adf325a7820880ca195666485d811dc00cdc2f11f98691500a88f77d4eb5179e35f594e7e68e3be71dc8ac",
        "chainHash": "06226e46111a0b59caaf126043eb5bbf28c34f3a5e332a1fc7b2b73cf188910f",
        "shortChannelId": "151x3x0",
        "timestamp": {
          "iso": "2023-08-12T12:16:57Z",
          "unix": 1691842617
        },
        "messageFlags": {
          "dontForward": false
        },
        "channelFlags": {
          "isEnabled": true,
          "isNode1": false
        },
        "cltvExpiryDelta": 144,
        "htlcMinimumMsat": 1,
        "feeBaseMsat": 7856,
        "feeProportionalMillionths": 5679,
        "htlcMaximumMsat": 45000000,
        "tlvStream": {}
      }
    }
  }
]

As you can observe the last part of the log is completely different.

Also in the terminal, I don't get any key rbfstatus
I'm using the response that I get in terminal for making the data classes. Can you please clarify about why these 2 responses are different?

[mohitk108]

I created the following data classes:

@Serializable
data class ChannelResponse(
    val nodeId: String,
    val channelId: String,
    val state: String,
    val data: Data
)

@Serializable
data class Data(
    val type: String,
    val commitments: Commitments,
    val shortIds: ShortIds,
    val channelAnnouncement: ChannelAnnouncement,
    val channelUpdate: ChannelUpdate
)

@Serializable
data class Commitments(
    val params: Params,
    val changes: Changes,
    val active: List<Active>,
    val inactive: List<@Contextual Any>,
    val remoteNextCommitInfo: String,
    val remotePerCommitmentSecrets: @Contextual Any? = null,
    val originChannels: Map<String, @Contextual Any?>,
)

@Serializable
data class Params(
    val channelId: String,
    val channelConfig: List<String>,
    val channelFeatures: List<String>,
    val localParams: LocalParams,
    val remoteParams: RemoteParams,
    val channelFlags: ChannelFlags
)

@Serializable
data class ChannelFlags(
    val announceChannel: Boolean
)

@Serializable
data class LocalParams(
    val nodeId: String,
    val fundingKeyPath: List<Int>,
    val dustLimit: Int,
    val maxHtlcValueInFlightMsat: Long,
    val requestedChannelReserve_opt: Int,
    val htlcMinimum: Int,
    val toSelfDelay: Int,
    val maxAcceptedHtlcs: Int,
    val isInitiator: Boolean,
    val initFeatures: InitFeatures,
)

@Serializable
data class InitFeatures(
    val activated: Activated,
    val unknown: List<@Contextual Any?>
)

@Serializable
data class Activated(
    val gossip_queries_ex: String,
    val option_data_loss_protect: String,
    val var_onion_optin: String,
    val option_static_remotekey: String,
    val option_scid_alias: String,
    val option_onion_messages: String,
    val option_support_large_channel: String,
    val option_anchors_zero_fee_htlc_tx: String,
    val payment_secret: String,
    val option_shutdown_anysegwit: String,
    val option_channel_type: String,
    val basic_mpp: String,
    val gossip_queries: String,
)

@Serializable
data class RemoteParams(
    val nodeId: String,
    val dustLimit: Int,
    val maxHtlcValueInFlightMsat: Long,
    val requestedChannelReserve_opt: Int,
    val htlcMinimum: Int,
    val toSelfDelay: Int,
    val maxAcceptedHtlcs: Int,
    val fundingPubKey: String,
    val revocationBasepoint: String,
    val paymentBasepoint: String,
    val delayedPaymentBasepoint: String,
    val htlcBasepoint: String,
    val initFeatures: InitFeatures,
)

@Serializable
data class Changes(
    val localChanges: TypeChanges,
    val remoteChanges: TypeChanges,
    val localNextHtlcId: Int,
    val remoteNextHtlcId: Int
)

@Serializable
data class TypeChanges(
    val proposed: List<@Contextual Any?>,
    val acked: List<@Contextual Any?>,
    val signed: List<@Contextual Any?>
)

@Serializable
data class Active(
    val fundingTxIndex: Int,
    val fundingTx: FundingTx,
    val localFunding: LocalFunding,
    val remoteFunding: RemoteFunding,
    val localCommit: LocalCommit,
    val remoteCommit: RemoteCommit
)

@Serializable
data class FundingTx(
    val outPoint: String,
    val amountSatoshis: Long
)

@Serializable
data class LocalFunding(
    val status: String,
    val txid: String
)

@Serializable
data class RemoteFunding(
    val status: String
)

@Serializable
data class LocalCommit(
    val index: Int,
    val spec: Spec,
    val commitTxAndRemoteSig: CommitTxAndRemoteSig,
    val htlcTxsAndRemoteSigs: List<@Contextual Any>
)

@Serializable
data class RemoteCommit(
    val index: Int,
    val spec: Spec,
    val txid: String,
    val remotePerCommitmentPoint: String
)

@Serializable
data class Spec(
    val htlcs: List<@Contextual Any>,
    val commitTxFeerate: Int,
    val toLocal: Int,
    val toRemote: Long
)

@Serializable
data class CommitTxAndRemoteSig(
    val commitTx: CommitTx,
    val remoteSig: String
)

@Serializable
data class CommitTx(
    val txid: String,
    val tx: String
)

@Serializable
data class ShortIds(
    val real: Real,
    val localAlias: String,
    val remoteAlias: String
)

@Serializable
data class Real(
    val status: String,
    val realScid: String
)

@Serializable
data class ChannelAnnouncement(
    val nodeSignature1: String,
    val nodeSignature2: String,
    val bitcoinSignature1: String,
    val bitcoinSignature2: String,
    val features: Feats,
    val chainHash: String,
    val shortChannelId: String,
    val nodeId1: String,
    val nodeId2: String,
    val bitcoinKey1: String,
    val bitcoinKey2: String,
    val tlvStream: Map<String, @Contextual Any?>
)

@Serializable
data class ChannelUpdate(
    val signature: String,
    val chainHash: String,
    val shortChannelId: String,
    val timestamp: Timestamp,
    val messageFlags: MessageFlags,
    val channelFlags: ChannelUpdateFlags,
    val cltvExpiryDelta: Int,
    val htlcMinimumMsat: Int,
    val feeBaseMsat: Long,
    val feeProportionalMillionths: Long,
    val htlcMaximumMsat: Long,
    val tlvStream: Map<String, @Contextual Any?>
)

@Serializable
data class Timestamp(
    val iso: String,
    val unix: Long
)

@Serializable
data class MessageFlags(
    val dontForward: Boolean,
)

@Serializable
data class ChannelUpdateFlags(
    val isEnabled: Boolean,
    val isNode1: Boolean,
)

@Serializable
data class Feats(val activated: Map<String, String>, val unknown: List<@Contextual Any?>)

And I'm getting the error that the response couldn't be parsed:

claddy@claddy:~$ eclair-cli.kexe channels -p password
error: api response could not be parsed: [{"nodeId":"02f666711319435b7905dd77d10c269d8d50c02668b975f526577167d370b50a3e"..........

The error lies in declaring data classes. And I've a few doubts here.

1. I do not exactly understand what @Contextual means, I'm just using it because I can't use the type Any without it, since the serializer doesn't support it. Why I even use Any type? I'm using it to declare the empty Lists, and the empty maps, that are given in the response.
2. Shall we consider using Long instead of Int. If yes then should it be used at specific places or everywhere(to maintain uniformity)?