Solana Agent Kit Integration

Safety validation for Solana blockchain agents.

Installation

pip install sentinelseed

Note: This integration provides validation functions that work alongside Solana Agent Kit, not as a plugin.

Components

Quick Start

from sentinelseed.integrations.solana_agent_kit import safe_transaction

result = safe_transaction(
    "transfer",
    amount=5.0,
    recipient="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    purpose="Payment for services",
)

if result.should_proceed:
    # Execute with Solana Agent Kit
    pass
else:
    print(f"Blocked: {result.concerns}")

Explicit Validation

from solana_agent_kit import SolanaAgentKit
from sentinelseed.integrations.solana_agent_kit import SentinelValidator

agent = SolanaAgentKit(wallet, rpc_url, config)
validator = SentinelValidator(max_transfer=10.0)

result = validator.check(
    action="transfer",
    amount=5.0,
    recipient="ABC123...",
    purpose="Payment for services",
)

if result.should_proceed:
    agent.transfer(recipient, amount)

Configuration

SentinelValidator(
    seed_level="standard",
    max_transfer=100.0,              # Max SOL per transaction
    confirm_above=10.0,
    blocked_addresses=[],
    require_purpose_for=["transfer", "swap", "stake"],
    memory_integrity_check=False,
    fiduciary_enabled=True,
)

Risk Levels

Checks Performed

1. Address validation (base58 format)

2. Blocked addresses check

3. Program whitelist verification

4. Transfer limits validation

5. PURPOSE gate for sensitive actions

6. THSP protocol validation

7. Pattern detection (drain, sweep)

8. Fiduciary validation (if enabled)

Memory Content Validation

Detects injection attacks before HMAC signing:

validator = SentinelValidator(
    memory_integrity_check=True,
    memory_secret_key="your-secret-key",
    memory_content_validation=True,
)

Links

• Solana Agent Kit