Quickstart Guide

1Install the SDK

Choose your preferred language:

pip install lockstock

cargo add lockstock

2Provision Agent (Dashboard)

Create a new agent in your LockStock Dashboard:

• Click "Provision Agent Card"
• Enter agent name (e.g., my_first_bot)
• Select authorized tasks
• Copy the Genesis Token (single-use, 24h expiry)

The genesis token is NOT the secret - it's safe to copy/paste. The actual secret is generated during binding.

3Bind to Machine (Liberty CLI)

On the target machine where your agent will run:

# Bind the agent identity to this machine's hardware
liberty bind --agent agent_abc123_my_first_bot --token YOUR_GENESIS_TOKEN

# Verify the binding succeeded
liberty show agent_abc123_my_first_bot

Liberty encrypts the agent secret using your machine's hardware fingerprint. The secret never exists in plaintext and cannot be copied to another machine.

4Initialize Agent in Code

Load the agent from Liberty vault - no hardcoded secrets:

from lockstock import LockStockAgent

# Load agent from Liberty vault (no secrets in code!)
agent = LockStockAgent.from_liberty("agent_abc123_my_first_bot")

# Agent passport is now active
print(f"Agent initialized: {agent.agent_id}")

use lockstock::LockStockAgent;

#[tokio::main]
async fn main() -> Result<()> {
    // Load agent from Liberty vault
    let agent = LockStockAgent::from_liberty(
        "agent_abc123_my_first_bot"
    ).await?;

    println!("Agent initialized: {}", agent.agent_id);
    Ok(())
}

5Perform Authenticated Task

Execute your first authenticated operation:

# Python
result = await agent.authenticate("DEPLOY", {"target": "production"})
print(f"Hash chain extended: {result.current_hash[:16]}...")

# Rust
let result = agent.authenticate("DEPLOY", json!({"target": "production"})).await?;

What just happened: LockStock verified the agent's identity, extended the hash chain, computed the matrix transition, and logged the operation to the immutable audit trail.

6View Audit Trail

Check the verifiable history of your agent:

// Retrieve audit log
audit_log = agent.get_audit_trail()

for entry in audit_log:
    print(f"Seq: {entry.sequence} | Task: {entry.task} | Hash: {entry.parent_hash[:8]}...")

You now have mathematical proof of every action your agent has taken—no timestamps required.