ionosphere-0.3.0 doesn't have any documentation.
Ionosphere
Don't use this library in production yet, it's hacky and incomplete! PRs are always welcome :)
This library can send data over Blockstream satellite compatible APIs. By default it will connect to the API endpoint run by Blockstream, but users can choose other providers should they exist at some point.
To use the API you need a running c-lightning
instance on the same machine. It has to be on the same bitcoin network as the API endpoint.
The API network version (currently testnet for Blockstream) can be queried using
IonosphereClient::lightning_node(&self).
Usage example
If you have just funded a new testnet c-lightning node you could run the following code to send some lorem ipsum to earth:
let mut client = new_blockstream_client;
// Open direct lightning channel to API node
client.open_channel.unwrap;
// Place bid and pay for it
client.place_bid.unwrap;
You can find more usage examples in src/bin.
Future development goals
- Stronger typed API, many fields that could be their own types are currently
Strings - Better/complete error handling
- Automatic integration tests
- Support fetching and updating bids
- Add lightning abstraction layer to support
lndandc-lightningand at some pointrust-lightning