Author against stable contracts.

01

THE SURFACE

Three verbs and a manifest.

03

QUICKSTART

A creature, end to end.

use gawd_sdk::prelude::*;

#[derive(Default)]
struct Echo;

impl ModuleInstance for Echo {
    // Called once when the Sanctum loads the creature.
    fn bind(&mut self, ctx: ModuleCtx) -> Result<()> {
        ctx.log("echo bound");
        Ok(())
    }

    // Called for every envelope routed to this creature.
    fn handle(&mut self, env: Envelope) -> Outcome {
        env.reply(env.body()) // emit a new envelope back through the Bus
    }

    // Called before unload; return once every spawned thread has joined.
    fn shutdown(&mut self, _deadline: Deadline) -> Result<()> {
        Ok(())
    }
}

// Registers the entrypoint the manifest names.
declare_module!(Echo);

sanctum> load ./echo.toml ./libecho.so
loaded  [email protected]  (daemon)
sanctum> bind handler echo
sanctum> send echo "ping"
echo  →  "ping"
sanctum> unload echo
unloaded  echo  (threads joined, rss stable)

There is no hosted product UI yet. Talk to us about access →

04

A REAL ONE, STEP BY STEP

Build a redactor in five steps.

# redactor.toml — the only metadata the Sanctum trusts
name = "redactor"
version = "0.1.0"
abi = { backend = "native", entry = "redactor" }
provides = ["filter"]   # the role other creatures bind to
capabilities = []       # reads the message and replies. nothing else.

use gawd_sdk::prelude::*;

#[derive(Default)]
struct Redactor;

impl ModuleInstance for Redactor {
    fn bind(&mut self, ctx: ModuleCtx) -> Result<()> {
        ctx.log("redactor online");
        Ok(())
    }

    fn handle(&mut self, env: Envelope) -> Outcome {
        env.reply(redact(env.body()))   // forward the cleaned message
    }

    fn shutdown(&mut self, _d: Deadline) -> Result<()> { Ok(()) }
}

declare_module!(Redactor);

fn redact(body: &str) -> String {
    let mut out = Vec::new();
    for word in body.split_whitespace() {
        if looks_secret(word) { out.push("‹redacted›") } else { out.push(word) }
    }
    out.join(" ")
}

fn looks_secret(w: &str) -> bool {
    w.len() >= 20 && w.bytes().all(|b| b.is_ascii_alphanumeric() || b == b'_')
}

sanctum> load ./redactor.toml ./libredactor.so
loaded  [email protected]  (daemon)
sanctum> bind filter redactor
sanctum> send redactor "ship with key sk_live_9F2aQ7bX4rT1cE6dW0p"
redactor  →  "ship with key ‹redacted›"

# next build also masks anything with an @  — rebuild, then:
sanctum> reload redactor ./libredactor.so
reloaded  [email protected]  (threads joined, rss stable)
sanctum> send redactor "ping [email protected] about the key"
redactor  →  "ping ‹redacted› about the key"