What this commit does:
Implements a method `set_node_alias` on NodeBuilder to allow
callers customize/set the value of the node alias. This method
sanitizes the user-provided alias by ensuring the following:
 + Node alias is UTF-8-encoded String
 + Node alias is non-empty
 + Node alias cannot exceed 32 bytes
 + Node alias is only valid up to the first null byte. Every
   character after the null byte is discraded

Additionally, a test case is provided to cover sanitizing
empty node alias, as well as an alias with emojis (copied and
modified from rust-lightning) and a sandwiched null byte.

What this commit does:
Broadcasts node announcement with the user-provided alias, if set,
else, uses the default [0u8;32].

Additionally, adds a random node alias generating function for use
in the generation of random configuration.

     alias sanitization

- Skips broadcasting node announcement in the event that either
  the node alias or the listening addresses are not set.
- Aligns the InvalidNodeAlias error variant with the others to
  make it work with language bindings.
- Simplifies the method to set the node alias.
- Cleans up the alias sanitizing function to ensure that protocol-
  compliant aliases (in this case, empty strings) are not flagged.
  Additionally, removes the check for sandwiched null byte.
- Finally, adds the relevant update to struct and interface to
  reflect changes in Rust types.

…onfigured

What this commit does:
+ Updates the sanitization function for node alias to return NodeAlias
+ Updates the node alias type in the configuration to NodeAlias and implements a conversion to/from String for bindings
+ With this update, regardless of where the alias is set, i.e. in the set_node_alias or directly, sanitization occurs.

What this commit does:
+ Decomposes connect_open_channel into two different functions:
   open_channel and open_announced_channel. This allows opening
   announced channels based on configured node alias and listening
   addresses values.
+ This enforces channel announcement only on the condition that
    both configuration values are set.
+ Additionally, a new error variant `OpenAnnouncedChannelFailed`
    is introduced to capture failure.

    Note: I thought I added the `InvalidNodeAlias` variant in the
    previous commit

What this commit does:
+ Replaces calls to `connect_open_channel` with `open_channel` and
    `open_announced_channel` where appropriate.

Status: Work In Progress (WIP)

Observation:
+ The integration tests are now flaky and need further investigation
    to ascertain the reason(s) why and then to fix.

What this commit does:
+ Removes the wrapping Arc from the channel config. This is a missed
    update after rebasing.

This commit addresses changes necessary to:
- fix failing tests for generated bindings
- remove unnecessary error variant previously introduced to capture
  failure associated with opening announced channels, and re-use
  existing variants that better capture the reasons, i.e. `InvalidNodeAlias`
  and `InvalidSocketAddress`, why opening an announced channel failed.
- correct visibility specifiers for objects, and
- cleanup nitpicks

Specific modifications across several files include:
- updating the UDL file, as well as tests related to python and kotlin
  that call `open_channel` and/or open_announced_channel
- repositioning/rearranging methods and struct fields
- introducing enums (`ChannelAnnouncementStatus` & `ChannelAnnouncementBlocker`)
  to capture and codify channel announceable eligibility, providing reasons
  for unannounceable channels
- modifying `can_announce_channel` to utilize the aforementioned enums,
  as opposed to simply returning a boolean value.
- cleaning up and renaming `connect_open_channel` to `open_channel_inner`,
  and maintaining a boolean flag for channel announcement
- updating documentation, unit, and integration tests that factor all
  these changes

… addresses

This commit addresses flaky test issues related to conditional channel
opening between nodes, considering node aliases and listening addresses.

Changes in test modules:
- Add/modify helper functions to randomize channel announcement flags
- Generate random node aliases based on announcement flags:
  * Set custom alias if announce_channel is true
  * Use default alias otherwise
- Update channel opening logic to account for node and channel announcements