Quickstart

Installation & Usage for Vector SDK

Installation

To use the Vector Bot Library, add it as a dependency in your Cargo.toml:

[dependencies]
vector_library = { path = "path/to/vector_library" }

Usage

Sending a Text Message

use vector_library::VectorBot;
use nostr_sdk::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // Generate new random keys
    let keys = Keys::generate();

    // Create a new VectorBot with default metadata
    let bot = VectorBot::quick(keys).await;

    // Get a chat channel for a specific public key
    let chat_npub = PublicKey::from_bech32("npub1example...")?;
    let chat = bot.get_chat(chat_npub).await;

    // Send a private message
    let success = chat.send_private_message("Hello, world!").await;
    println!("Message sent: {}", success);

    Ok(())
}

Sending an Image

use vector_library::{VectorBot, AttachmentFile};
use nostr_sdk::prelude::*;
use std::fs;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // Generate new random keys
    let keys = Keys::generate();

    // Create a new VectorBot with default metadata
    let bot = VectorBot::quick(keys).await;

    // Get a chat channel for a specific public key
    let chat_npub = PublicKey::from_bech32("npub1example...")?;
    let chat = bot.get_chat(chat_npub).await;

    // Read image file
    let image_path = "path/to/your/image.png";
    let image_data = fs::read(image_path)?;

    // Create an AttachmentFile
    let attachment = AttachmentFile {
        bytes: image_data,
        img_meta: None, // Optional: Add image metadata if available
        extension: "png".to_string(),
    };

    // Send the image
    let success = chat.send_private_file(Some(attachment)).await;
    println!("Image sent: {}", success);

    Ok(())
}