Rework light client (#1475)

* WIP second pass over light client code for simpler API

* First pass new light client

* pub(crate) LightClientRpc::new_raw(), and fmt

* Update examples and add back a way to configure boot nodes and fetch chainspec from a URL

* Fix light client examples

* remove unused deps and tidy lightclient feature flags

* fix wasm error

* LightClientRpc can be cloned

* update light client tests

* Other small fixes

* exclude mod unless jsonrpsee

* Fix wasm-lightclient-tests

* add back docsrs bit and web+native feature flag compile error

* update book and light client example names

* fix docs

subxt/Cargo.toml

@@ -25,20 +25,20 @@ default = ["jsonrpsee", "native"]
 # Enable this for native (ie non web/wasm builds).
 # Exactly 1 of "web" and "native" is expected.
 native = [
-    "jsonrpsee?/async-client", 
-    "jsonrpsee?/client-ws-transport-native-tls", 
-    "subxt-lightclient?/native", 
+    "jsonrpsee?/async-client",
+    "jsonrpsee?/client-ws-transport-native-tls",
+    "subxt-lightclient?/native",
     "tokio-util"
 ]
 
 # Enable this for web/wasm builds.
 # Exactly 1 of "web" and "native" is expected.
 web = [
-    "jsonrpsee?/async-wasm-client", 
-    "jsonrpsee?/client-web-transport", 
-    "getrandom/js", 
-    "subxt-lightclient?/web", 
-    "subxt-macro/web", 
+    "jsonrpsee?/async-wasm-client",
+    "jsonrpsee?/client-web-transport",
+    "getrandom/js",
+    "subxt-lightclient?/web",
+    "subxt-macro/web",
     "instant/wasm-bindgen"
 ]
 
@@ -46,7 +46,9 @@ web = [
 unstable-reconnecting-rpc-client = ["dep:reconnecting-jsonrpsee-ws-client"]
 
 # Enable this to use jsonrpsee (allowing for example `OnlineClient::from_url`).
-jsonrpsee = ["dep:jsonrpsee"]
+jsonrpsee = [
+    "dep:jsonrpsee",
+]
 
 # Enable this to pull in extra Substrate dependencies which make it possible to
 # use the `sp_core::crypto::Pair` Signer implementation, as well as adding some
@@ -61,7 +63,7 @@ unstable-metadata = []
 
 # Activate this to expose the Light Client functionality.
 # Note that this feature is experimental and things may break or not work as expected.
-unstable-light-client = ["subxt-lightclient", "tokio-stream"]
+unstable-light-client = ["subxt-lightclient"]
 
 [dependencies]
 async-trait = { workspace = true }
@@ -103,9 +105,6 @@ subxt-macro = { workspace = true }
 subxt-metadata = { workspace = true, features = ["std"] }
 subxt-lightclient = { workspace = true, optional = true, default-features = false }
 
-# Light client support:
-tokio-stream = { workspace = true, optional = true }
-
 # Reconnecting jsonrpc ws client
 reconnecting-jsonrpsee-ws-client = { version = "0.3", optional = true }
 
@@ -135,13 +134,13 @@ subxt-signer = { path = "../signer" }
 tracing-subscriber = { workspace = true }
 
 [[example]]
-name = "light_client_tx_basic"
-path = "examples/light_client_tx_basic.rs"
+name = "light_client_basic"
+path = "examples/light_client_basic.rs"
 required-features = ["unstable-light-client", "jsonrpsee"]
 
 [[example]]
-name = "light_client_parachains"
-path = "examples/light_client_parachains.rs"
+name = "light_client_local_node"
+path = "examples/light_client_local_node.rs"
 required-features = ["unstable-light-client", "jsonrpsee", "native"]
 
 [[example]]