sentinel-agentkit-provider

AgentKit action provider for SENTINEL — a pre-execution transaction safety oracle for autonomous AI agents. Lets any AgentKit-powered agent check whether a transaction is safe to sign, before signing it, and pays for the check autonomously via x402 — no human in the loop, no API key, no subscription.

Independent, standalone package. Not part of the official coinbase/agentkit monorepo, and not intended to be submitted there. Install and use directly.

What it checks

• Contract security (honeypots, hidden owner/mint functions, proxy patterns, etc.)
• Transaction simulation (does the call actually succeed)
• For ambiguous cases: a second opinion from an LLM council (Claude + GPT-4o-mini)
• Prior history: has this exact contract been flagged before, by any other agent?
• Deployer wallet track record (transaction count as a freshness signal)

Returns a SAFE / UNSAFE / UNKNOWN verdict, a 0–100 risk score, and a cryptographically signed (ed25519) receipt.

Install

pip install sentinel-agentkit-provider

Usage

from coinbase_agentkit import AgentKit, AgentKitConfig
from sentinel_agentkit_provider import sentinel_action_provider

agent_kit = AgentKit(AgentKitConfig(
    wallet_provider=wallet_provider,  # any EVM wallet provider on Base
    action_providers=[
        sentinel_action_provider(),
        # ... your other action providers
    ],
))

Once registered, your agent gains a check_transaction_safety action it can call before signing any transaction with an unfamiliar contract address on Base:

check_transaction_safety(to="0x...", value="0x0", data="0x...")

Cost

$0.005 USDC per check, on Base mainnet, paid automatically via x402 from the agent's own wallet. No trial, no free tier — the price itself is the friction, by design.

Links

• Live methodology — exactly how a verdict is computed, published and machine-readable.
• Aggregate stats — track record across all callers, updated live.
• Report an outcome — free endpoint to report back what actually happened after acting on a verdict.

License

MIT