resolvax-agentkit 0.1.0__tar.gz

resolvax_agentkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ResolvaX Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

resolvax_agentkit-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: resolvax-agentkit
+Version: 0.1.0
+Summary: Official Coinbase AgentKit Action Provider for ResolvaX Mathematical & Educational Engines (x402 Base USDC).
+Author-email: ResolvaX Team <contato@resolvax.com.br>
+Project-URL: Homepage, https://resolvax.com.br
+Project-URL: Documentation, https://resolvax.com.br/docs
+Project-URL: Bug Tracker, https://github.com/swellington231/resolvax/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: cdp
+Requires-Dist: cdp-agentkit-core>=0.0.8; extra == "cdp"
+Dynamic: license-file
+
+# ResolvaX AgentKit Action Provider (Coinbase Base L2)
+
+Official **Coinbase AgentKit Action Provider** for **ResolvaX**, enabling autonomous AI agents on the Base Layer 2 blockchain to seamlessly query mathematical, algebraic, LaTeX, financial, and OCR engines monetized with canonical **HTTP 402 Payment Required (x402)** in **USDC**.
+
+---
+
+## 🚀 Features
+
+* **Symbolic Math Solver:** Quadratic, polynomial, derivative, and linear system solving with step-by-step LaTeX output ($0.001 USDC).
+* **LaTeX Converter:** Natural language and raw mathematical text converted to publication-ready TeX ($0.001 USDC).
+* **Financial Math Engine:** Compound interest, inflation, Price amortization, and loan PMT schedules ($0.001 USDC).
+* **Exercise Generator:** Brazilian National Curriculum (BNCC) & high-school level math problem synthesis ($0.005 USDC).
+* **Math Evaluator:** Algebraic equivalence verification and diagnostic feedback ($0.005 USDC).
+* **Math OCR:** Image to LaTeX formula recognition with Otsu preprocessing ($0.010 USDC).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install resolvax-agentkit
+```
+
+---
+
+## ⚡ Quickstart with Coinbase AgentKit
+
+```python
+from coinbase_agentkit import AgentKit, AgentKitConfig, CdpWalletProvider
+from resolvax_agentkit import ResolvaXActionProvider
+
+# 1. Initialize your Base wallet provider
+wallet_provider = CdpWalletProvider()
+
+# 2. Add ResolvaX Action Provider to your AgentKit
+agent_kit = AgentKit(
+    AgentKitConfig(
+        wallet_provider=wallet_provider,
+        action_providers=[
+            ResolvaXActionProvider()
+        ]
+    )
+)
+```
+
+---
+
+## 🛡️ Protocol Specifications
+
+* **Network:** Base Layer 2 (Mainnet)
+* **Token:** USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
+* **Recipient Wallet:** `0x93dd815bc8d9a6e299d936986c5ee7dc3f267fee`
+* **Protocol:** x402 Canonical (`X-402-Payment-Required`)

resolvax_agentkit-0.1.0/README.md

@@ -0,0 +1,53 @@
+# ResolvaX AgentKit Action Provider (Coinbase Base L2)
+
+Official **Coinbase AgentKit Action Provider** for **ResolvaX**, enabling autonomous AI agents on the Base Layer 2 blockchain to seamlessly query mathematical, algebraic, LaTeX, financial, and OCR engines monetized with canonical **HTTP 402 Payment Required (x402)** in **USDC**.
+
+---
+
+## 🚀 Features
+
+* **Symbolic Math Solver:** Quadratic, polynomial, derivative, and linear system solving with step-by-step LaTeX output ($0.001 USDC).
+* **LaTeX Converter:** Natural language and raw mathematical text converted to publication-ready TeX ($0.001 USDC).
+* **Financial Math Engine:** Compound interest, inflation, Price amortization, and loan PMT schedules ($0.001 USDC).
+* **Exercise Generator:** Brazilian National Curriculum (BNCC) & high-school level math problem synthesis ($0.005 USDC).
+* **Math Evaluator:** Algebraic equivalence verification and diagnostic feedback ($0.005 USDC).
+* **Math OCR:** Image to LaTeX formula recognition with Otsu preprocessing ($0.010 USDC).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install resolvax-agentkit
+```
+
+---
+
+## ⚡ Quickstart with Coinbase AgentKit
+
+```python
+from coinbase_agentkit import AgentKit, AgentKitConfig, CdpWalletProvider
+from resolvax_agentkit import ResolvaXActionProvider
+
+# 1. Initialize your Base wallet provider
+wallet_provider = CdpWalletProvider()
+
+# 2. Add ResolvaX Action Provider to your AgentKit
+agent_kit = AgentKit(
+    AgentKitConfig(
+        wallet_provider=wallet_provider,
+        action_providers=[
+            ResolvaXActionProvider()
+        ]
+    )
+)
+```
+
+---
+
+## 🛡️ Protocol Specifications
+
+* **Network:** Base Layer 2 (Mainnet)
+* **Token:** USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
+* **Recipient Wallet:** `0x93dd815bc8d9a6e299d936986c5ee7dc3f267fee`
+* **Protocol:** x402 Canonical (`X-402-Payment-Required`)

resolvax_agentkit-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "resolvax-agentkit"
+version = "0.1.0"
+authors = [
+  { name="ResolvaX Team", email="contato@resolvax.com.br" },
+]
+description = "Official Coinbase AgentKit Action Provider for ResolvaX Mathematical & Educational Engines (x402 Base USDC)."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "pydantic>=2.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+cdp = [
+    "cdp-agentkit-core>=0.0.8",
+]
+
+[project.urls]
+"Homepage" = "https://resolvax.com.br"
+"Documentation" = "https://resolvax.com.br/docs"
+"Bug Tracker" = "https://github.com/swellington231/resolvax/issues"

resolvax_agentkit-0.1.0/resolvax_agentkit/__init__.py

@@ -0,0 +1,24 @@
+"""
+resolvax_agentkit
+Official Coinbase AgentKit Action Provider for ResolvaX (Base Layer 2 x402).
+"""
+from .action_provider import ResolvaXActionProvider
+from .schemas import (
+    MathSolveSchema,
+    LatexConverterSchema,
+    FinancialMathSchema,
+    ExerciseGeneratorSchema,
+    MathEvaluatorSchema,
+    MathOcrSchema,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "ResolvaXActionProvider",
+    "MathSolveSchema",
+    "LatexConverterSchema",
+    "FinancialMathSchema",
+    "ExerciseGeneratorSchema",
+    "MathEvaluatorSchema",
+    "MathOcrSchema",
+]

resolvax_agentkit-0.1.0/resolvax_agentkit/action_provider.py

@@ -0,0 +1,178 @@
+"""
+resolvax_agentkit/action_provider.py
+Coinbase AgentKit Action Provider for ResolvaX 6 M2M APIs.
+"""
+import os
+import json
+from typing import Any, Dict, Optional
+import httpx
+
+from .schemas import (
+    MathSolveSchema,
+    LatexConverterSchema,
+    FinancialMathSchema,
+    ExerciseGeneratorSchema,
+    MathEvaluatorSchema,
+    MathOcrSchema,
+)
+
+RESOLVAX_API_URL = os.getenv("RESOLVAX_API_URL", "https://resolvax.com.br/api/v1/agent")
+RESOLVAX_OFFICIAL_WALLET = "0x93dd815bc8d9a6e299d936986c5ee7dc3f267fee"
+BASE_USDC_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+
+# Tentativa graciosa de importar decorators nativos do CDP AgentKit
+try:
+    from cdp_agentkit_core.actions import ActionProvider, create_action
+    from cdp_agentkit_core.wallet_providers import EvmWalletProvider
+    HAS_CDP = True
+except ImportError:
+    HAS_CDP = False
+    # Fallback dummy decorator para permitir uso sem o pacote CDP instalado
+    def create_action(**kwargs):
+        def decorator(func):
+            func._action_meta = kwargs
+            return func
+        return decorator
+    class ActionProvider:
+        def __init__(self, name: str, actions: list):
+            self.name = name
+            self.actions = actions
+    class EvmWalletProvider:
+        pass
+
+
+class ResolvaXActionProvider(ActionProvider):
+    """
+    Action Provider do ResolvaX para agentes de IA do ecossistema Coinbase AgentKit / Base L2.
+    Automatiza pagamentos x402 em USDC na Base e executa chamadas matemáticas de alta precisão.
+    """
+    def __init__(self, recipient_wallet: str = RESOLVAX_OFFICIAL_WALLET, base_url: str = RESOLVAX_API_URL):
+        super().__init__("resolvax-math-engine", [])
+        self.recipient_wallet = recipient_wallet.lower()
+        self.base_url = base_url.rstrip("/")
+
+    def _execute_with_payment(
+        self,
+        wallet: Any,
+        endpoint_path: str,
+        price_usdc: str,
+        payload: Dict[str, Any]
+    ) -> str:
+        """
+        Transfere o valor estipulado em USDC na Base usando a carteira do agente
+        e envia a requisição HTTP com o hash da transação.
+        """
+        tx_hash = None
+        # 1. Se o wallet fornecer o método transfer nativo do CDP
+        if hasattr(wallet, "transfer"):
+            try:
+                tx_hash = wallet.transfer(
+                    to_address=self.recipient_wallet,
+                    amount=price_usdc,
+                    asset_id=BASE_USDC_CONTRACT
+                )
+            except Exception as e:
+                return f"Falha ao transferir {price_usdc} USDC na rede Base: {e}"
+        elif hasattr(wallet, "send_transaction"):
+            # Exemplo de provider Web3 genérico
+            try:
+                tx_hash = wallet.send_transaction(to=self.recipient_wallet, value=0)
+            except Exception as e:
+                return f"Falha ao assinar transação Web3: {e}"
+
+        headers = {"Content-Type": "application/json"}
+        if tx_hash:
+            headers["x-402-payment-hash"] = str(tx_hash)
+
+        url = f"{self.base_url}{endpoint_path}"
+        try:
+            with httpx.Client(timeout=20.0) as client:
+                res = client.post(url, json=payload, headers=headers)
+                if res.status_code == 200:
+                    return json.dumps(res.json(), ensure_ascii=False)
+                elif res.status_code == 402:
+                    return f"HTTP 402 Payment Required: {res.text}. Verifique se a carteira possui saldo de USDC na Base."
+                elif res.status_code == 503:
+                    return "HTTP 503: API Comercial temporariamente desativada pela governança do ResolvaX."
+                else:
+                    return f"Erro HTTP {res.status_code}: {res.text}"
+        except Exception as net_err:
+            return f"Erro de conexão com ResolvaX ({url}): {net_err}"
+
+    @create_action(
+        name="resolvax_math_solve",
+        description="Resolve equações algébricas, polinomiais, derivadas e integrais via ResolvaX SymPy Engine. Custo: 0.001 USDC na Base.",
+        schema=MathSolveSchema,
+    )
+    def solve_math(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/math/solve",
+            price_usdc="0.001",
+            payload=args
+        )
+
+    @create_action(
+        name="resolvax_latex_converter",
+        description="Converte expressões e fórmulas em texto para sintaxe LaTeX canônica e validada. Custo: 0.001 USDC na Base.",
+        schema=LatexConverterSchema,
+    )
+    def convert_latex(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/math/latex",
+            price_usdc="0.001",
+            payload=args
+        )
+
+    @create_action(
+        name="resolvax_financial_math",
+        description="Executa cálculos de matemática financeira: Tabela Price, SAC, Juros Compostos e VPL. Custo: 0.001 USDC na Base.",
+        schema=FinancialMathSchema,
+    )
+    def calculate_finance(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/finance/calculate",
+            price_usdc="0.001",
+            payload=args
+        )
+
+    @create_action(
+        name="resolvax_exercise_generator",
+        description="Gera exercícios didáticos de matemática alinhados à BNCC com enunciado e gabarito. Custo: 0.005 USDC na Base.",
+        schema=ExerciseGeneratorSchema,
+    )
+    def generate_exercise(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/math/generate",
+            price_usdc="0.005",
+            payload=args
+        )
+
+    @create_action(
+        name="resolvax_math_evaluator",
+        description="Avalia equivalência algébrica e identifica erros de sinal ou coeficientes entre respostas. Custo: 0.005 USDC na Base.",
+        schema=MathEvaluatorSchema,
+    )
+    def evaluate_math(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/math/evaluate",
+            price_usdc="0.005",
+            payload=args
+        )
+
+    @create_action(
+        name="resolvax_math_ocr",
+        description="Extrai e transcreve fórmulas matemáticas de imagens Base64 em sintaxe LaTeX. Custo: 0.010 USDC na Base.",
+        schema=MathOcrSchema,
+    )
+    def ocr_math(self, wallet: Any, args: Dict[str, Any]) -> str:
+        return self._execute_with_payment(
+            wallet=wallet,
+            endpoint_path="/math/ocr",
+            price_usdc="0.010",
+            payload=args
+        )

resolvax_agentkit-0.1.0/resolvax_agentkit/schemas.py

@@ -0,0 +1,40 @@
+"""
+resolvax_agentkit/schemas.py
+Pydantic Schemas for ResolvaX 6 Commercial M2M APIs.
+"""
+from typing import Optional, List, Dict, Any
+from pydantic import BaseModel, Field
+
+
+class MathSolveSchema(BaseModel):
+    expression: str = Field(..., description="Equação ou expressão matemática, ex: '3*x^2 - 12*x + 9 = 0' ou 'sin(x)^2 + cos(x)^2'")
+    operation: str = Field(default="solve", description="Operação: 'solve', 'simplify', 'factor', 'expand', 'diff', 'integrate'")
+    variable: Optional[str] = Field(default="x", description="Variável independente principal (padrão: 'x')")
+
+
+class LatexConverterSchema(BaseModel):
+    input_text: str = Field(..., description="Texto ou fórmula matemática para conversão em LaTeX puro")
+    display_mode: Optional[str] = Field(default="inline", description="Modo de exibição: 'inline' ($...$) ou 'block' ($$...$$)")
+
+
+class FinancialMathSchema(BaseModel):
+    calculation_type: str = Field(..., description="Tipo de cálculo: 'compound_interest', 'simple_interest', 'price_table', 'sac_table', 'npv', 'irr'")
+    principal: float = Field(..., description="Capital ou valor financiado inicial em R$ / moeda base")
+    rate: float = Field(..., description="Taxa de juros expressa em valor decimal por período (ex: 0.015 para 1.5%)")
+    periods: int = Field(..., description="Quantidade de períodos (meses ou anos)")
+
+
+class ExerciseGeneratorSchema(BaseModel):
+    topic: str = Field(..., description="Tópico matemático: 'quadratic_equations', 'linear_systems', 'trigonometry', 'percentages', 'geometry'")
+    difficulty: Optional[str] = Field(default="medium", description="Dificuldade: 'easy', 'medium', 'hard'")
+    grade_level: Optional[str] = Field(default="EF09", description="Nível de escolaridade ou código BNCC (ex: 'EF09', 'EM01')")
+
+
+class MathEvaluatorSchema(BaseModel):
+    candidate_answer: str = Field(..., description="Resposta do aluno ou agente candidata a avaliação")
+    expected_answer: str = Field(..., description="Gabarito ou resposta oficial esperada")
+    variable: Optional[str] = Field(default="x", description="Variável principal da expressão")
+
+
+class MathOcrSchema(BaseModel):
+    image_base64: str = Field(..., description="Imagem contendo texto ou fórmulas matemáticas em Base64")

resolvax_agentkit-0.1.0/resolvax_agentkit.egg-info/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: resolvax-agentkit
+Version: 0.1.0
+Summary: Official Coinbase AgentKit Action Provider for ResolvaX Mathematical & Educational Engines (x402 Base USDC).
+Author-email: ResolvaX Team <contato@resolvax.com.br>
+Project-URL: Homepage, https://resolvax.com.br
+Project-URL: Documentation, https://resolvax.com.br/docs
+Project-URL: Bug Tracker, https://github.com/swellington231/resolvax/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: cdp
+Requires-Dist: cdp-agentkit-core>=0.0.8; extra == "cdp"
+Dynamic: license-file
+
+# ResolvaX AgentKit Action Provider (Coinbase Base L2)
+
+Official **Coinbase AgentKit Action Provider** for **ResolvaX**, enabling autonomous AI agents on the Base Layer 2 blockchain to seamlessly query mathematical, algebraic, LaTeX, financial, and OCR engines monetized with canonical **HTTP 402 Payment Required (x402)** in **USDC**.
+
+---
+
+## 🚀 Features
+
+* **Symbolic Math Solver:** Quadratic, polynomial, derivative, and linear system solving with step-by-step LaTeX output ($0.001 USDC).
+* **LaTeX Converter:** Natural language and raw mathematical text converted to publication-ready TeX ($0.001 USDC).
+* **Financial Math Engine:** Compound interest, inflation, Price amortization, and loan PMT schedules ($0.001 USDC).
+* **Exercise Generator:** Brazilian National Curriculum (BNCC) & high-school level math problem synthesis ($0.005 USDC).
+* **Math Evaluator:** Algebraic equivalence verification and diagnostic feedback ($0.005 USDC).
+* **Math OCR:** Image to LaTeX formula recognition with Otsu preprocessing ($0.010 USDC).
+
+---
+
+## 📦 Installation
+
+```bash
+pip install resolvax-agentkit
+```
+
+---
+
+## ⚡ Quickstart with Coinbase AgentKit
+
+```python
+from coinbase_agentkit import AgentKit, AgentKitConfig, CdpWalletProvider
+from resolvax_agentkit import ResolvaXActionProvider
+
+# 1. Initialize your Base wallet provider
+wallet_provider = CdpWalletProvider()
+
+# 2. Add ResolvaX Action Provider to your AgentKit
+agent_kit = AgentKit(
+    AgentKitConfig(
+        wallet_provider=wallet_provider,
+        action_providers=[
+            ResolvaXActionProvider()
+        ]
+    )
+)
+```
+
+---
+
+## 🛡️ Protocol Specifications
+
+* **Network:** Base Layer 2 (Mainnet)
+* **Token:** USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
+* **Recipient Wallet:** `0x93dd815bc8d9a6e299d936986c5ee7dc3f267fee`
+* **Protocol:** x402 Canonical (`X-402-Payment-Required`)

resolvax_agentkit-0.1.0/resolvax_agentkit.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+resolvax_agentkit/__init__.py
+resolvax_agentkit/action_provider.py
+resolvax_agentkit/schemas.py
+resolvax_agentkit.egg-info/PKG-INFO
+resolvax_agentkit.egg-info/SOURCES.txt
+resolvax_agentkit.egg-info/dependency_links.txt
+resolvax_agentkit.egg-info/requires.txt
+resolvax_agentkit.egg-info/top_level.txt

resolvax_agentkit-0.1.0/resolvax_agentkit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

resolvax_agentkit-0.1.0/resolvax_agentkit.egg-info/requires.txt

@@ -0,0 +1,5 @@
+pydantic>=2.0.0
+httpx>=0.25.0
+
+[cdp]
+cdp-agentkit-core>=0.0.8

resolvax_agentkit-0.1.0/resolvax_agentkit.egg-info/top_level.txt

@@ -0,0 +1 @@
+resolvax_agentkit

resolvax_agentkit-0.1.0/setup.cfg

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