limina-sdk 0.1.0__tar.gz

limina_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+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)

limina_sdk-0.1.0/README.md

@@ -0,0 +1,77 @@
+# 🌿 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)

limina_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "limina-sdk"
+version = "0.1.0"
+description = "The Liminal Layer for Agentic Strategies on Robinhood Chain"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    {name = "Limina", email = "dev@limina.fi"}
+]
+keywords = ["ai-agents", "robinhood-chain", "web3", "arbitrum-orbit", "guardrails", "evm-simulation"]
+dependencies = [
+    "web3>=6.0.0",
+    "pydantic>=2.0.0"
+]
+
+[project.scripts]
+limina = "limina.cli:main"
+
+[project.urls]
+Homepage = "https://x.com/liminafi"
+Documentation = "http://localhost:5173"
+Repository = "https://github.com/liminafi/limina-sdk"

limina_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

limina_sdk-0.1.0/src/limina_sdk.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+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)

limina_sdk-0.1.0/src/limina_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/limina_sdk.egg-info/PKG-INFO
+src/limina_sdk.egg-info/SOURCES.txt
+src/limina_sdk.egg-info/dependency_links.txt
+src/limina_sdk.egg-info/entry_points.txt
+src/limina_sdk.egg-info/requires.txt
+src/limina_sdk.egg-info/top_level.txt
+tests/test_guardrails.py
+tests/test_new_features.py

limina_sdk-0.1.0/src/limina_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

limina_sdk-0.1.0/src/limina_sdk.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+limina = limina.cli:main

limina_sdk-0.1.0/src/limina_sdk.egg-info/requires.txt

@@ -0,0 +1,2 @@
+web3>=6.0.0
+pydantic>=2.0.0

limina_sdk-0.1.0/src/limina_sdk.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+assets
+components

limina_sdk-0.1.0/tests/test_guardrails.py

@@ -0,0 +1,36 @@
+"""
+Unit tests for Limina Guardrails & Agent Execution
+"""
+
+import unittest
+import sys
+import os
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from limina import LiminaAgent, Guardrails, RobinhoodChain, LiminaGuardrailException
+
+
+class TestLiminaGuardrails(unittest.TestCase):
+    def test_guardrail_spend_limit(self):
+        guard = Guardrails(max_daily_spend_usd=100.0)
+        agent = LiminaAgent(chain=RobinhoodChain.MAINNET, guardrails=guard)
+
+        # Valid spend
+        res = agent.swap("USDC", "WETH", 50.0)
+        self.assertEqual(res["status"], "APPROVED")
+
+        # Exceeding spend limit raises exception
+        with self.assertRaises(LiminaGuardrailException):
+            agent.swap("USDC", "WETH", 60.0)
+
+    def test_guardrail_slippage_limit(self):
+        guard = Guardrails(max_slippage_pct=0.5)
+        agent = LiminaAgent(chain=RobinhoodChain.MAINNET, guardrails=guard)
+
+        # Exceeding slippage limit raises exception
+        with self.assertRaises(LiminaGuardrailException):
+            agent.execute_strategy(action="SWAP", amount_usd=10.0, expected_slippage_pct=1.5)
+
+
+if __name__ == "__main__":
+    unittest.main()

limina_sdk-0.1.0/tests/test_new_features.py

@@ -0,0 +1,61 @@
+"""
+Unit tests for Limina Strategies, Attestation Ledger & Contract Helpers
+"""
+
+import unittest
+import sys
+import os
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from limina import (
+    LiminaAgent,
+    Guardrails,
+    RobinhoodChain,
+    DCAVolatilityStrategy,
+    YieldRebalanceStrategy,
+    AttestationLedger,
+    ERC20ContractHelper,
+)
+
+
+class TestLiminaNewFeatures(unittest.TestCase):
+    def setUp(self):
+        self.guard = Guardrails(max_daily_spend_usd=500.0)
+        self.agent = LiminaAgent(chain=RobinhoodChain.MAINNET, guardrails=self.guard)
+
+    def test_dca_strategy(self):
+        strategy = DCAVolatilityStrategy(self.agent, amount_usd=50.0, volatility_threshold=0.05)
+        # Volatility <= 0.05 triggers execution
+        res = strategy.evaluate_and_execute(current_market_volatility=0.03)
+        self.assertIsNotNone(res)
+        self.assertEqual(res["status"], "APPROVED")
+
+        # Volatility > 0.05 does not trigger
+        res_none = strategy.evaluate_and_execute(current_market_volatility=0.08)
+        self.assertIsNone(res_none)
+
+    def test_yield_rebalance_strategy(self):
+        strategy = YieldRebalanceStrategy(self.agent, "0x1111111111111111111111111111111111111111", "0x2222222222222222222222222222222222222222")
+        res = strategy.rebalance(yield_a_apy=3.0, yield_b_apy=6.5, amount_usd=100.0)
+        self.assertIsNotNone(res)
+        self.assertEqual(res["status"], "APPROVED")
+
+    def test_attestation_ledger(self):
+        ledger = AttestationLedger()
+        att = ledger.create_attestation(
+            agent_wallet=self.agent.wallet_address,
+            action="SWAP_USDC_WETH",
+            amount_usd=50.0,
+            target_contract="0x3a82e91a0c8b919e0000000000000000000019e0",
+            payload_data={"slippage": 0.15},
+        )
+        self.assertTrue(att.attestation_id.startswith("attest_"))
+        self.assertEqual(len(ledger.export_ledger()), 1)
+
+    def test_erc20_contract_helper(self):
+        calldata = ERC20ContractHelper.encode_approve("0x3a82e91a0c8b919e0000000000000000000019e0", 1000000)
+        self.assertTrue(calldata.startswith("0x095ea7b3"))  # approve function selector
+
+
+if __name__ == "__main__":
+    unittest.main()