This is the Core Repository for the iot2tangle Gateways. It provides the base API to open Channels and publish signed data to the Tangle.
To learn more about IOTA-Streams clicke here
To look at example implementations we have two Gateways, for HTTP and MQTT, already deployed with the Streams-Gateway-Core.
To interact with Library import it as a dependency by adding it to the Cargo.toml file:
gateway_core = { git = "https://github.com/iot2tangle/streams-gateway-core", branch="master"}
You can then import the library into your project with:
extern crate gateway_core;
To Create a new channel use:
Channel::new(node: String, send_opt: SendTrytesOptions, seed_option: Option<String>);
- node is: the url of an IOTA Node
- send_opt: are options used by the IOTA Client when sending Transaction
- seed_option: Can be None to generate a new Seed or Some(seed) to use an existing seed
To Open the channel and get its address:
let address: String = channel.open().unwrap();
This will open the Channel by generating the channel address and publishing the signature keys
This address will be needed to read the data from the Tangle
To Send signed data over the Tangle by writing to the channel:
write_signed<T>(&mut self, data: T) -> Result<String>
- The type T needs to have the
serde::Serializetrait
If the transaction is succesfully sent the Identifier of the transaction will be returned.
To run the provided example:
cargo run --example test
This will send a "Hello World" message to the Tangle!
The Underlying libraries are not compatible for 32Bit Processors and Operating systems.