nirium 0.9.1__tar.gz → 0.9.2__tar.gz

{nirium-0.9.1 → nirium-0.9.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: nirium
-Version: 0.9.1
-Summary: Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)
+Version: 0.9.2
+Summary: Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client
 Author: Nirium Team
 Author-email: Nirium Protocol <niriumprotocol@gmail.com>
 License-Expression: Apache-2.0
@@ -9,7 +9,7 @@ Project-URL: Homepage, https://nirium.xyz
 Project-URL: Repository, https://github.com/nirium-protocol/nirium-sdk
 Project-URL: Documentation, https://nirium.xyz/docs
 Project-URL: Bug Tracker, https://github.com/nirium-protocol/nirium-sdk/issues
-Keywords: nirium,stellar,soroban,defi,sdk,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
+Keywords: nirium,stellar,soroban,defi,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: aiohttp>=3.9.0
@@ -20,7 +20,7 @@ Dynamic: requires-python
 
 # nirium
 
-Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
+Autonomous treasury and agentic-payments infrastructure for **Nirium Protocol** on Stellar/Soroban — Python client.
 
 Nirium agents rebalance USDC ↔ CETES (tokenized Mexican T-bills via Etherfuse) 24/7 without human intervention. Built for developers who want to integrate autonomous treasury management, agentic payments (x402 + MPP), and real-time market signals into their applications.
 

{nirium-0.9.1 → nirium-0.9.2}/README.md

@@ -1,6 +1,6 @@
 # nirium
 
-Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
+Autonomous treasury and agentic-payments infrastructure for **Nirium Protocol** on Stellar/Soroban — Python client.
 
 Nirium agents rebalance USDC ↔ CETES (tokenized Mexican T-bills via Etherfuse) 24/7 without human intervention. Built for developers who want to integrate autonomous treasury management, agentic payments (x402 + MPP), and real-time market signals into their applications.
 

{nirium-0.9.1 → nirium-0.9.2}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nirium"
-version = "0.9.1"
-description = "Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)"
+version = "0.9.2"
+description = "Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "Apache-2.0"
 authors = [{name = "Nirium Protocol", email = "niriumprotocol@gmail.com"}]
-keywords = ["nirium", "stellar", "soroban", "defi", "sdk", "agent", "autonomous", "treasury", "x402", "mpp", "agentic-payments", "usdc", "cetes", "etherfuse", "rwa"]
+keywords = ["nirium", "stellar", "soroban", "defi", "agent", "autonomous", "treasury", "x402", "mpp", "agentic-payments", "usdc", "cetes", "etherfuse", "rwa"]
 dependencies = [
     "aiohttp>=3.9.0",
     "websockets>=13.0",

{nirium-0.9.1 → nirium-0.9.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="nirium",
-    version="0.9.1",
+    version="0.9.2",
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     install_requires=[
@@ -11,7 +11,7 @@ setup(
         "stellar-sdk>=11.0.0,<16.0.0",
     ],
     author="Nirium Team",
-    description="Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)",
+    description="Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client",
     keywords=["nirium", "stellar", "defi", "x402", "mpp", "agentic-payments", "soroban"],
     python_requires=">=3.10",
 )

{nirium-0.9.1 → nirium-0.9.2}/src/nirium/__init__.py

@@ -2,5 +2,5 @@
 
 from .client import Agent  # type: ignore
 
-__version__ = "0.9.1"
+__version__ = "0.9.2"
 __all__ = ["Agent"]

{nirium-0.9.1 → nirium-0.9.2}/src/nirium/client.py

@@ -416,6 +416,149 @@ class Agent:
             },
         )
 
+    # ─── Treasury (DeFindex) ───────────────────────────────────
+    #
+    # Nirium never holds these funds. It holds the RebalanceManager role of a
+    # DeFindex vault the client deploys and owns — every write below returns
+    # an UNSIGNED XDR; you decide whether and when to sign it and call
+    # ``submit_treasury_tx``. ``rebalance()`` never takes a destination
+    # address, so withdrawal is not something the role can express.
+
+    async def get_treasury_info(self) -> Dict[str, Any]:
+        """Treasury node metadata: role, custody model, fees, security notes."""
+        return await self._get("/api/treasury/info")
+
+    async def get_treasury_vault(self, vault_id: str, holder: Optional[str] = None) -> Dict[str, Any]:
+        """Read a vault's roles, assets and managed funds.
+
+        Pass ``holder`` to also get its balance in the vault's asset.
+        """
+        return await self._get(f"/api/treasury/vault/{vault_id}", params={"holder": holder})
+
+    async def get_treasury_vaults(self, manager: Optional[str] = None) -> Dict[str, Any]:
+        """List vaults Nirium has deployed or read, on the current network."""
+        return await self._get("/api/treasury/vaults", params={"manager": manager})
+
+    async def get_treasury_strategy_asset(self, strategy_id: str) -> Dict[str, Any]:
+        """Read which asset a strategy manages, as declared by the strategy itself — pairs it correctly before you deploy."""
+        return await self._get(f"/api/treasury/strategy/{strategy_id}")
+
+    async def deploy_treasury_vault(
+        self,
+        manager: str,
+        caller: str,
+        assets: List[Dict[str, Any]],
+        name: str,
+        symbol: str,
+        emergency_manager: Optional[str] = None,
+        fee_receiver: Optional[str] = None,
+        rebalance_manager: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Build an unsigned XDR to deploy a DeFindex vault.
+
+        ``manager`` keeps control (rescue, pause, revoke); Nirium only ever
+        holds ``rebalance_manager``, which cannot withdraw or change roles.
+        ``assets`` is ``[{"address": "C...", "strategies": [{"address": "C...", "name": "..."}]}]``.
+        Sign the returned XDR with ``caller`` and submit via
+        ``submit_treasury_tx``.
+        """
+        payload: Dict[str, Any] = {
+            "manager": manager, "caller": caller, "assets": assets,
+            "name": name, "symbol": symbol,
+        }
+        for key, value in (
+            ("emergencyManager", emergency_manager), ("feeReceiver", fee_receiver),
+            ("rebalanceManager", rebalance_manager),
+        ):
+            if value is not None:
+                payload[key] = value
+        return await self._post("/api/treasury/deploy", payload)
+
+    async def deposit_to_treasury_vault(
+        self,
+        vault: str,
+        from_: str,
+        amounts: List[Any],
+        invest: Optional[bool] = None,
+        max_slippage_bps: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """Build an unsigned deposit XDR.
+
+        ``amounts`` is one amount per vault asset, in stroops, as strings —
+        an i128 does not survive a JSON number. Sign with ``from_`` and
+        submit via ``submit_treasury_tx``.
+        """
+        payload: Dict[str, Any] = {"vault": vault, "from": from_, "amounts": [str(a) for a in amounts]}
+        if invest is not None:
+            payload["invest"] = invest
+        if max_slippage_bps is not None:
+            payload["maxSlippageBps"] = max_slippage_bps
+        return await self._post("/api/treasury/deposit", payload)
+
+    async def withdraw_from_treasury_vault(
+        self,
+        vault: str,
+        from_: str,
+        shares: Optional[Any] = None,
+        max_slippage_bps: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """Build an unsigned withdraw XDR. Omit ``shares`` to withdraw everything.
+
+        Sign with ``from_`` and submit via ``submit_treasury_tx``.
+        """
+        payload: Dict[str, Any] = {"vault": vault, "from": from_}
+        if shares is not None:
+            payload["shares"] = str(shares)
+        if max_slippage_bps is not None:
+            payload["maxSlippageBps"] = max_slippage_bps
+        return await self._post("/api/treasury/withdraw", payload)
+
+    async def set_treasury_rebalance_manager(
+        self, vault: str, manager: str, rebalance_manager: str,
+    ) -> Dict[str, Any]:
+        """Build an unsigned XDR handing the RebalanceManager role to a new address.
+
+        Only the vault's current Manager can sign it — the same door that
+        grants Nirium the role also revokes it.
+        """
+        return await self._post("/api/treasury/set-rebalance-manager", {
+            "vault": vault, "manager": manager, "rebalanceManager": rebalance_manager,
+        })
+
+    async def build_treasury_rebalance(
+        self, vault: str, instructions: List[Dict[str, Any]], caller: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Build an unsigned rebalance XDR.
+
+        ``instructions`` is
+        ``[{"kind": "Unwind" | "Invest", "strategy": "C...", "amount": "1000000"}]``
+        — the vault's own strategies only, no other instruction is
+        expressible. Sign with the vault's RebalanceManager and submit via
+        ``submit_treasury_tx``. To have Nirium sign with its own key instead,
+        see ``execute_treasury_rebalance``.
+        """
+        payload: Dict[str, Any] = {"vault": vault, "instructions": instructions}
+        if caller is not None:
+            payload["caller"] = caller
+        return await self._post("/api/treasury/rebalance", payload)
+
+    async def execute_treasury_rebalance(
+        self, vault: str, instructions: List[Dict[str, Any]], caller: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Sign and submit a rebalance with Nirium's own RebalanceManager key and wait for confirmation.
+
+        Only available where that key actually lives — mainnet's
+        receive-only box returns 501 by design, not a broken 500.
+        """
+        payload: Dict[str, Any] = {"vault": vault, "instructions": instructions}
+        if caller is not None:
+            payload["caller"] = caller
+        return await self._post("/api/treasury/rebalance/execute", payload)
+
+    async def submit_treasury_tx(self, xdr: str) -> Dict[str, Any]:
+        """Broadcast an XDR you already signed (deploy/deposit/withdraw/rebalance/set-rebalance-manager) and wait for confirmation."""
+        return await self._post("/api/treasury/submit", {"xdr": xdr})
+
     # ─── Admin ───────────────────────────────────────────────
 
     async def configure_llm(

{nirium-0.9.1 → nirium-0.9.2}/src/nirium.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: nirium
-Version: 0.9.1
-Summary: Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)
+Version: 0.9.2
+Summary: Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client
 Author: Nirium Team
 Author-email: Nirium Protocol <niriumprotocol@gmail.com>
 License-Expression: Apache-2.0
@@ -9,7 +9,7 @@ Project-URL: Homepage, https://nirium.xyz
 Project-URL: Repository, https://github.com/nirium-protocol/nirium-sdk
 Project-URL: Documentation, https://nirium.xyz/docs
 Project-URL: Bug Tracker, https://github.com/nirium-protocol/nirium-sdk/issues
-Keywords: nirium,stellar,soroban,defi,sdk,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
+Keywords: nirium,stellar,soroban,defi,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: aiohttp>=3.9.0
@@ -20,7 +20,7 @@ Dynamic: requires-python
 
 # nirium
 
-Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
+Autonomous treasury and agentic-payments infrastructure for **Nirium Protocol** on Stellar/Soroban — Python client.
 
 Nirium agents rebalance USDC ↔ CETES (tokenized Mexican T-bills via Etherfuse) 24/7 without human intervention. Built for developers who want to integrate autonomous treasury management, agentic payments (x402 + MPP), and real-time market signals into their applications.