Metadata-Version: 2.4
Name: limina-sdk
Version: 0.1.0
Summary: The Liminal Layer for Agentic Strategies on Robinhood Chain
Author-email: Limina <dev@limina.fi>
License-Expression: MIT
Project-URL: Homepage, https://x.com/liminafi
Project-URL: Documentation, http://localhost:5173
Project-URL: Repository, https://github.com/liminafi/limina-sdk
Keywords: ai-agents,robinhood-chain,web3,arbitrum-orbit,guardrails,evm-simulation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: web3>=6.0.0
Requires-Dist: pydantic>=2.0.0

# 🌿 Limina SDK (`limina-sdk`)
> **The Liminal Layer for Agentic Strategies on Robinhood Chain**

[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-emerald.svg)](https://www.python.org)
[![Robinhood Chain](https://img.shields.io/badge/Robinhood_Chain-Native-01241A.svg)](https://x.com/liminafi)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

`limina-sdk` is an open-source Python framework designed to bridge non-deterministic AI decisions (LLM outputs) with deterministic EVM execution on **Robinhood Chain**.

---

## ⚡ Key Features

* 🛡️ **Deterministic Guardrails:** Hard caps on daily USD spend, max slippage tolerance, stop-loss triggers, and contract whitelists.
* ⚡ **Anvil Microsecond EVM Dry-Run:** Local state fork test before broadcasting transactions to Robinhood L2.
* 🔌 **Framework Adapters:** Pre-built adapters for ElizaOS, LangChain, CrewAI, AutoGen, and custom Python LLM loops.
* 🚀 **Zero-Gas Intent Relays:** Intent aggregation & batching optimized for Robinhood Chain liquidity.

---

## 🚀 Quickstart

### 1. Installation

```bash
pip install limina-sdk
```

### 2. Basic Example

```python
from limina import LiminaAgent, Guardrails, RobinhoodChain

# Define dynamic guardrails
guard = Guardrails(
    max_daily_spend_usd=250.0,
    max_slippage_pct=0.5,
    anvil_simulation=True
)

# Instantiate safe agent
agent = LiminaAgent(chain=RobinhoodChain.MAINNET, guardrails=guard)

# Execute safe swap on Robinhood L2
result = agent.swap(from_token="USDC", to_token="WETH", amount_usd=50.0)

print("Status:", result["status"])
print("Tx Hash:", result["tx_hash"])
```

---

## 🛠️ Architecture

```
[ AI Agent Output (LangChain/ElizaOS) ]
                 │
                 ▼
┌────────────────────────────────────────────────────────┐
│  LIMINA GUARDRAIL ENGINE (Python)                      │
│  ├─ 1. Daily Spend Check ($ Limit)                     │
│  ├─ 2. Slippage Tolerance Check (%)                    │
│  ├─ 3. Contract Whitelist Verification                 │
│  └─ 4. Anvil EVM State Fork Dry-Run (20ms)            │
└────────────────────────────────────────────────────────┘
                 │ (Signed Attestation Payload)
                 ▼
[ Robinhood Chain L2 (Arbitrum Orbit) ]
  └─ ERC-4337 Smart Account Settlement
```

---

## 💬 Community & Support

* **X (Twitter):** [@liminafi](https://x.com/liminafi)
* **Website & Simulator:** [http://localhost:5173](http://localhost:5173)
