BlueSky Sentinel is a Rust application designed to track events within the BlueSky platform. It leverages ScyllaDB for database operations and implements a leveling system based on user activities such as posts, likes, and reposts.

The main goal of the project is build a high-performance, scalable, and reliable application that can:

• Fetch and process public events from the BlueSky platform.
• Track user events and experiences.
• Implement a leveling system with experience points (XP).
• Display the connected Datacenters Network topology while interacting with it.

The project uses the following technologies and packages:

• Language: Rust
• Database: ScyllaDB
• Packages:
  • ORM: charybdis
  • Jetstream Client: jetstream-oxide
  • Bluesky Client: atrium-api

1. Clone the repository:

   git clone https://github.com/danielhe4rt/bluesky-sentinel.git

2. Navigate to the project directory:

   cd bluesky-jetstream-rpg

3. Clone the .env.example file and rename it to .env:

   cp .env.example .env

4Build the project using Cargo:

cargo build --release

1. Run the application:

   cargo run --release

The project uses the following environment and configuration files:

• src/main.rs: Sets up the application environment and starts HTTP and Jetstream services.
• src/jetstream.rs: Configures and starts the Jetstream listener for specific events.
• src/leveling.rs: Defines the leveling system and calculates user levels based on experience points.

The project tracks and processes the following event types:

• Post: app.bsky.feed.post
• Like: app.bsky.feed.like
• Retweet: app.bsky.feed.retweet

The project uses ScyllaDB for database operations with the following table schemas:

-- Create the Leveling UDT -- 
CREATE TYPE bsky_rpg.leveling
    (
        level                    int,
        experience               int,
        experience_to_next_level int,
        levels_gained            int,
        progress_percentage      float
    );

-- Create Character K-V Table
CREATE TABLE bsky_rpg.characters
(
    user_did       text,
    leveling_state leveling,
    name           text,
    PRIMARY KEY (user_did)
);

-- Create Experience Counter Table
CREATE TABLE bsky_rpg.characters_experience
(
    user_did           text,
    current_experience counter,
    PRIMARY KEY (user_did)
);


-- Create Events Table
CREATE TABLE bsky_rpg.events
(
    user_did       text,
    event_at       timestamp,
    event_data     frozen<map<text, text>>,
    event_id       text,
    event_type     text,
    leveling_state leveling,
    PRIMARY KEY (user_did, event_at)
) WITH CLUSTERING ORDER BY (event_at DESC);

-- Create Materialized View for Events by Type
CREATE MATERIALIZED VIEW bsky_rpg.events_by_type AS
SELECT user_did, event_type, event_at, event_data, event_id, leveling_state
FROM bsky_rpg.events
WHERE user_did IS NOT null
  AND event_type IS NOT null
  AND event_at IS NOT null
PRIMARY KEY ((user_did, event_type), event_at)
WITH CLUSTERING ORDER BY (event_at ASC);

This project is licensed under the MIT License.

Feel free to customize this README further to better fit your project's needs.

• BlueSky Jetstream Repository
• ScyllaDB Documentation