Coinbase Integration
Comprehensive security integration for Coinbase ecosystem: AgentKit guardrails and x402 payment validation.
Installation
pip install sentinelseed coinbase-agentkit
# For x402 support:
pip install sentinelseed x402 httpx
Features
- AgentKit Guardrails: ActionProvider with THSP validation
- x402 Payment Validation: THSP-based payment validation
- EVM Address Validation: EIP-55 checksum validation
- Transaction Limits: Configurable spending limits
- DeFi Risk Assessment: Risk analysis for DeFi interactions
AgentKit Integration
from coinbase_agentkit import AgentKit
from sentinelseed.integrations.coinbase import sentinel_action_provider
provider = sentinel_action_provider(security_profile="strict")
agent = AgentKit(action_providers=[provider])
# Actions available:
# - sentinel_validate_transaction
# - sentinel_validate_address
# - sentinel_check_action_safety
# - sentinel_assess_defi_risk
Transaction Validation
from sentinelseed.integrations.coinbase import (
TransactionValidator,
ChainType,
get_default_config,
)
config = get_default_config("standard")
validator = TransactionValidator(config=config)
result = validator.validate(
action="native_transfer",
from_address="0x123...",
to_address="0x456...",
amount=50.0,
chain=ChainType.BASE_MAINNET,
purpose="Payment for services",
)
if result.should_proceed:
# Execute transaction
pass
x402 Payment Validation
from sentinelseed.integrations.coinbase import SentinelX402Middleware
middleware = SentinelX402Middleware()
result = middleware.validate_payment(
endpoint="https://api.example.com/paid",
payment_requirements=payment_req,
wallet_address="0x123...",
)
Security Profiles
| Profile | Max Single | Max Daily | Use Case |
|---|---|---|---|
permissive | $1,000 | $5,000 | Development |
standard | $100 | $500 | General usage |
strict | $25 | $100 | Production |
paranoid | $10 | $50 | Maximum security |
High-Risk Actions
Actions requiring extra validation:
native_transfer,transfer,approvedeploy_contract,deploy_tokentrade,supply,withdraw,borrow
Supported Networks
- Ethereum (Mainnet, Sepolia)
- Base (Mainnet, Sepolia)
- Polygon (Mainnet, Amoy)
- Arbitrum (Mainnet, Sepolia)
- Optimism (Mainnet, Sepolia)
- Avalanche (Mainnet, Fuji)