@sentinelhq/eliza

Sentinel security plugin for elizaOS agents.

Install

npm install @sentinelhq/eliza

Requires Node.js 20+

Usage

import { SentinelPlugin } from '@sentinelhq/eliza';

const plugin = await SentinelPlugin({
  policy: {
    spendingLimits: {
      maxPerTx: 1_000_000_000,   // 1 SOL
    },
  },
});

agent.use(plugin);

The plugin hooks into three elizaOS lifecycle events:

| Hook | Action | |------|--------| | beforeUserInput | Scans user input for prompt-injection threats | | beforeTransaction | Simulates the transaction and enforces policy | | afterTransaction | Writes an on-chain memo attestation |

If a threat is detected or a policy is violated, the action is blocked and the agent receives a SentinelBlockedError.

Configuration

The plugin accepts the same configuration object as @sentinelhq/core — prompt guard mode, execution sandbox policy, and attestation settings are all supported.

Related Packages

| Package | Description | |----------|-------------| | @sentinelhq/core | Core SDK — Prompt Guard, Execution Sandbox, Memo Attestation | | @sentinelhq/cli | CLI — sentinel scan, simulate, attest, verify | | @sentinelhq/agent-kit | Solana Agent Kit middleware | | @sentinelhq/openclaw | OpenClaw agent hook |

License

MIT