/channels-examples

Sample code for IOTA Channels

Primary LanguageRust

About

This repository contains sample code for you to get started with the Channels application in IOTA Streams.

You can find documentation for these examples on the IOTA documentation portal.

Getting started

To get started you need Git and Rust installed on your device.

  1. Clone this repository

    git clone https://github.com/kwek20/channels-examples.git
cd channels-examples

  2. Open the src/main.rs file and change the author's secret to something secure

    // REPLACE THE SECRET WITH YOUR OWN
let mut author = Author::new("MYAUTHORSECRET", ...);

  3. Start the author and follow the prompts

    cargo +nightly run --release --bin author

    When you run this command for the first time, it may take a minute or two to download and compile the dependencies.

    In the console, you should see something like the following:

    Creating a new channel
Channel published

Sending signed message
Published signed message

Now, in a new terminal window, use the subscriber to publish a `Subscribe` message on the channel

cargo +nightly run --release --bin subscriber 276f7c4ecca06dda9f46480fae75364a0b8f995f9ffad7ab354c8fc806b4d7660000000000000000 bf48e8635ef335611e5db26e 6ae36d590eae46fe3b1fa219
Tangle Address/channel: LACDPDXBOGYEADBHXEPBRBO9LFID9BTBK9HERENCXEGIZGIFZAVBHEKGF9RFZGUC9999999999999999
Tangle announce_message tag: BGRBPHRCMC9IZAPCCALCPFBD
Tangle signed_message tag: YCKHADHCN9LFPBKIEBDA9FY9

Enter the message identifier of the `Subscribe` message that was published by the subscriber:

  4. Open the bin/subscriber.rs file, and change the subscriber's secret to something secure

     // REPLACE THE SECRET WITH YOUR OWN
let mut subscriber = Subscriber::new("MYSUBSCRIBERSECRET", ...);

  5. Copy the cargo run command and paste it into a new terminal window to start the subscriber

    cargo +nightly run --release --bin subscriber 276f7c4ecca06dda9f46480fae75364a0b8f995f9ffad7ab354c8fc806b4d7660000000000000000 bf48e8635ef335611e5db26e 6ae36d590eae46fe3b1fa219

    The first argument is the channel address, the second argument is the Announce message identifier, and the third argument is the SignedPacket message identifier.

    The subscriber needs all this information to get the messages from the channel.

  6. Follow the prompts

    In the console, you should see that the subscriber was able to subscribe to the channel and read the encrypted message.

Supporting the project

Channels is an alpha project that is being developed as a built-in protocol of the Streams framework.

If you want to support the sample code in this repository, consider:

If you want to support the Streams project, please head over to the GitHub repository and take a look at the contribution guidelines.

Joining the discussion

If you want to get involved in discussions about this technology, or you're looking for support, go to the #streams-discussion channel on Discord.