Crate octra_sqlite 

Real SQLite inside an Octra Circle.

octra-sqlite provides a small Rust client for querying and writing to a SQLite database whose engine runs inside an Octra wasm_v1 Circle. The crate keeps the first story deliberately small: create a Client, open a Database, then run SQL.

use octra_sqlite::{Client, Result};

fn main() -> Result<()> {
    let client = Client::from_default_config()?;
    let db = client.database("art")?;
    let rows = db.query("select * from artist order by name;")?;
    println!("{} rows", rows.row_count);
    Ok(())
}

A public-read database can be queried without local wallet setup:

use octra_sqlite::{Client, Result};

fn main() -> Result<()> {
    let client = Client::default();
    let db = client.database(
        "oct://devnet/octQfYK2fE9RvR9kfj8FJfMBQw1e4EzfHB8Q5Z9J2DCnRBQ",
    )?;
    let rows = db.query("select id, name from artist order by id;")?;
    println!("{} rows", rows.row_count);
    Ok(())
}

Sealed databases use signed Octra view auth for reads. Public-read databases use unsigned Octra Circle views for SQL reads while keeping writes owner-signed through OSW1 owner write intent. Pass a saved database name or a full oct://NETWORK/<circle> URI to Client::database. The client detects the Circle’s Octra read surface unless read_mode is explicitly set.

Feature flags:

• cli: build the octra-sqlite command line interface.
• http: include the default blocking HTTP RPC transport.
• wasm-behavior: enable host-harness tests for the bundled Circle WASM.

The CLI JSON envelopes and OSR1/OSW1 wire formats are treated as public surfaces. The Rust API is still 0.x; breaking Rust API cleanup happens in minor versions.

Re-exports

pub use client::AuthInfo;

pub use client::Client;

pub use client::ClientOptions;

pub use client::Database;

pub use client::Error;

pub use client::ErrorKind;

pub use client::ExecuteResult;

pub use client::ProgramInfo;

pub use client::QueryResult;

pub use client::Result;

pub use client::SubmittedTransaction;

pub use protocol::target::ReadMode;

Modules

client

protocol

Enums

Value

Represents any valid JSON value.