sra-riskgate

Risk checks for stablecoin and AI-agent payments.

This repository contains:

• sra-riskgate, a small Python SDK with deterministic pre-filter rules (address validation, self-transfer blocking, amount ceilings, USDC depeg checks in both directions) and a Coinbase AgentKit action provider that sends USDC only after those rules approve.
• eval/, the scripts used to benchmark the SRA-RiskGate-4B model on sra-stablecoin-risk-bench.

The SDK does not load the 4B model and does not perform sanctions screening. It is a fast, deterministic first layer; the model handles the full policy and evidence review.

Install

pip install sra-riskgate                 # core rules (only dependency: pydantic)
pip install "sra-riskgate[agentkit]"     # plus the Coinbase AgentKit integration
pip install "sra-riskgate[x402]"         # plus the x402 integration

Rule pre-filter

from sra_riskgate import RulePreFilter, TransactionPayload

gate = RulePreFilter(max_amount=50_000, depeg_hold_pct=1.0, depeg_reject_pct=5.0)

verdict = gate.inspect(TransactionPayload(
    chain_id=1, token="USDC",
    sender="0x" + "a" * 40, recipient="0x" + "b" * 40,
    amount=5000.0, peg_deviation_pct=-1.5,
))
print(verdict.decision.value, verdict.flags, verdict.required_actions)
# hold ['MODERATE_DEPEG'] ['manual_review']

AgentKit action provider

from coinbase_agentkit import AgentKit, AgentKitConfig, CdpEvmWalletProvider, CdpEvmWalletProviderConfig
from sra_riskgate.integrations.agentkit import RiskGateActionProvider

wallet = CdpEvmWalletProvider(CdpEvmWalletProviderConfig(
    api_key_id="...", api_key_secret="...", wallet_secret="...", network_id="base-sepolia",
))
agentkit = AgentKit(AgentKitConfig(
    wallet_provider=wallet,
    # Register ONLY this provider for payments: AgentKit's wallet and ERC-20
    # providers expose their own transfer actions that bypass the gate.
    action_providers=[RiskGateActionProvider(max_amount=1000.0, peg_feed=my_usdc_peg_feed)],
))

The agent gets one action, risk_gated_usdc_transfer. It sends USDC as an ERC-20 transfer (never the native token) on Ethereum, Base and Base Sepolia, reads the chain from the wallet, reports reverted transactions as failures, and holds the transfer if the peg feed errors. Without a peg_feed, depeg checks are disabled and every result says so.

x402 hooks

Works with the official x402 Python SDK through its lifecycle hooks, so the same checks run wherever x402 is used.

from x402 import x402FacilitatorSync, x402ClientSync
from sra_riskgate.integrations.x402_hooks import RiskGateX402Hooks

# Resource server or facilitator: checked before verification and before settlement
facilitator = RiskGateX402Hooks(max_amount=1000).attach_to_facilitator(x402FacilitatorSync())

# Paying agent: checked before the agent signs anything
client = RiskGateX402Hooks(max_amount=50, payer_address=MY_WALLET).attach_to_client(x402ClientSync())

Rejected, held, malformed or unknown payments are aborted with a reason starting with sra_riskgate_ (for example sra_riskgate_hold), which x402 raises as PaymentAbortedError. USDC on Ethereum, Base and Base Sepolia is checked; other assets are aborted unless allow_unsupported_assets=True. Pass peg_feed to enable depeg checks and on_decision to log every decision. x402's own client spend controls stay active alongside these checks.

Requires x402 2.25 or newer. Coinbase AgentKit 0.7.x currently depends on the older x402 1.x, so install the [agentkit] and [x402] extras in separate environments.

Model results

Independently reproduced on all 2,000 held-out test cases, with every prediction published in sra-bench-results:

See the model card for the full table and limitations. To reproduce or add a model, see eval/README.md.

Development

pip install -e ".[test]"            # core tests
pip install -e ".[agentkit,test]"   # plus AgentKit integration tests
pytest -q

Every push and pull request runs the test suite on GitHub Actions. Before publishing to PyPI, build the wheel, install it in a fresh virtual environment and run the tests against the installed package.

License

Apache-2.0