Skip to content

feat: add plugin-sentinel for AI safety validation#504

Open
sentinel-seed wants to merge 1 commit intosendaifun:v2from
sentinel-seed:feat/plugin-sentinel
Open

feat: add plugin-sentinel for AI safety validation#504
sentinel-seed wants to merge 1 commit intosendaifun:v2from
sentinel-seed:feat/plugin-sentinel

Conversation

@sentinel-seed
Copy link

Summary

Add Sentinel Safety Plugin implementing the THSP (Truth-Harm-Scope-Purpose) protocol for AI agent transaction validation.

Features

  • Four-gate validation: Truth, Harm, Scope, Purpose
  • Configurable thresholds: Max amounts, confirmation limits, blocklists
  • LLM-ready actions: SENTINEL_VALIDATE_TRANSACTION, SENTINEL_CHECK_SAFETY, etc.
  • Risk assessment: LOW/MEDIUM/HIGH/CRITICAL levels
  • Pattern detection: Catches suspicious operations (drain, sweep, unlimited approvals)

Use Case

Protects AI agents from executing harmful, unauthorized, or suspicious transactions on Solana by requiring every operation to pass through safety validation before execution.

Usage

import { SolanaAgentKit } from "solana-agent-kit";
import SentinelPlugin from "@solana-agent-kit/plugin-sentinel";

const agent = new SolanaAgentKit(privateKey, rpcUrl)
  .use(SentinelPlugin);

const result = await agent.methods.validateTransaction({
  action: "transfer",
  amount: 50,
  recipient: "...",
  purpose: "Payment for services",
});

if (result.shouldProceed) {
  // Safe to execute
}

Links

Add Sentinel safety plugin implementing THSP protocol:
- Transaction validation with four gates (Truth, Harm, Scope, Purpose)
- Configurable risk thresholds and blocklists
- Actions for LLM integration (validate, check, stats, block/unblock)
- Protects AI agents from harmful blockchain operations
@sentinel-seed
Copy link
Author

Hi team! Just following up on this PR. Is there anything else needed from our side for this to be reviewed?

The plugin implements the THSP protocol for transaction safety validation, which could help protect autonomous agents from executing problematic transactions.

Happy to make any adjustments if needed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant