sra-riskgate 0.1.0__tar.gz

sra_riskgate-0.1.0/.cache/huggingface/.gitignore

@@ -0,0 +1 @@
+*

sra_riskgate-0.1.0/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: sra-riskgate
+Version: 0.1.0
+Summary: Deterministic risk analysis & compliance middleware for stablecoin transactions.
+Author: Sriram Ramakrishnan
+License: Apache-2.0
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.28.0
+Description-Content-Type: text/markdown
+
+# SRA-RiskGate
+
+AI-powered compliance and risk-gating for stablecoin transactions.
+
+## Installation
+```bash
+pip install sra-riskgate

sra_riskgate-0.1.0/README.md

@@ -0,0 +1,7 @@
+# SRA-RiskGate
+
+AI-powered compliance and risk-gating for stablecoin transactions.
+
+## Installation
+```bash
+pip install sra-riskgate

sra_riskgate-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sra-riskgate"
+version = "0.1.0"
+description = "Deterministic risk analysis & compliance middleware for stablecoin transactions."
+readme = "README.md"
+authors = [{ name = "Sriram Ramakrishnan" }]
+license = { text = "Apache-2.0" }
+requires-python = ">=3.10"
+dependencies = [
+    "pydantic>=2.0",
+    "requests>=2.28.0"
+]

sra_riskgate-0.1.0/sra_riskgate/__init__.py

@@ -0,0 +1,4 @@
+from .client import RiskGate
+from .models import TransactionPayload, RiskAssessment, ActionDecision
+
+__all__ = ["RiskGate", "TransactionPayload", "RiskAssessment", "ActionDecision"]

sra_riskgate-0.1.0/sra_riskgate/client.py

@@ -0,0 +1,36 @@
+from .models import TransactionPayload, RiskAssessment, ActionDecision
+
+class RiskGate:
+    def __init__(self, api_key: str = None):
+        self.api_key = api_key
+
+    def inspect(self, tx: TransactionPayload) -> RiskAssessment:
+        dev = float(tx.peg_deviation_pct or 0.0)
+
+        if dev > 1.0 or tx.amount >= 100000.0:
+            decision = ActionDecision.FLAG
+            score = 0.85
+            categories = ["PEG_DEVIATION_ALERT", "HIGH_SLIPPAGE_RISK"]
+            reasoning = f"Significant peg deviation ({dev}%) or high transfer amount detected."
+            remedy = "Hold transaction in dispute escrow and require secondary multi-sig approval."
+        elif tx.amount <= 0:
+            decision = ActionDecision.REJECT
+            score = 1.0
+            categories = ["ZERO_OR_NEGATIVE_VALUE"]
+            reasoning = "Transaction payload has invalid transfer amount."
+            remedy = "Reject transaction."
+        else:
+            decision = ActionDecision.APPROVE
+            score = 0.04
+            categories = ["STANDARD_STABLECOIN_SETTLEMENT"]
+            reasoning = f"Transaction on chain {tx.chain_id} for {tx.amount} {tx.token} conforms to normal risk parameters."
+            remedy = "Proceed with immediate on-chain settlement."
+
+        data = {
+            "decision": decision,
+            "risk_score": score,
+            "categories_detected": categories,
+            "reasoning": reasoning,
+            "recommended_remedy": remedy
+        }
+        return RiskAssessment.model_validate(data)

sra_riskgate-0.1.0/sra_riskgate/models.py

@@ -0,0 +1,25 @@
+from enum import Enum
+from typing import List, Optional
+from pydantic import BaseModel
+
+class ActionDecision(str, Enum):
+    APPROVE = "APPROVE"
+    FLAG = "FLAG"
+    REJECT = "REJECT"
+    ESCROW_DISPUTE = "ESCROW_DISPUTE"
+
+class TransactionPayload(BaseModel):
+    chain_id: int
+    token: str
+    sender: str
+    recipient: str
+    amount: float
+    raw_data: Optional[str] = None
+    peg_deviation_pct: Optional[float] = 0.0
+
+class RiskAssessment(BaseModel):
+    decision: ActionDecision
+    risk_score: float
+    categories_detected: List[str]
+    reasoning: str
+    recommended_remedy: str

sra_riskgate-0.1.0/test.py

@@ -0,0 +1,36 @@
+from sra_riskgate import RiskGate, TransactionPayload
+
+gate = RiskGate()
+
+# Test 1: Normal transaction
+tx1 = TransactionPayload(
+    chain_id=1,
+    token="USDC",
+    sender="0x1111111111111111111111111111111111111111",
+    recipient="0x2222222222222222222222222222222222222222",
+    amount=500.0,
+    peg_deviation_pct=0.01
+)
+
+# Test 2: De-pegged high-risk transaction
+tx2 = TransactionPayload(
+    chain_id=1,
+    token="USDT",
+    sender="0x3333333333333333333333333333333333333333",
+    recipient="0x4444444444444444444444444444444444444444",
+    amount=150000.0,
+    peg_deviation_pct=2.4
+)
+
+print("--- Inspecting Transaction 1 (Normal) ---")
+res1 = gate.inspect(tx1)
+print(f"Decision:    {res1.decision.value}")
+print(f"Risk Score:  {res1.risk_score}")
+print(f"Reasoning:   {res1.reasoning}\n")
+
+print("--- Inspecting Transaction 2 (High Risk) ---")
+res2 = gate.inspect(tx2)
+print(f"Decision:    {res2.decision.value}")
+print(f"Risk Score:  {res2.risk_score}")
+print(f"Reasoning:   {res2.reasoning}")
+print(f"Remedy:      {res2.recommended_remedy}\n")