nirium 0.9.2__tar.gz → 0.10.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nirium
-Version: 0.9.2
+Version: 0.10.0
 Summary: Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client
 Author: Nirium Team
 Author-email: Nirium Protocol <niriumprotocol@gmail.com>
@@ -50,7 +50,9 @@ async def main():
     market = await agent.get_market()
     print(f"XLM Price: ${market['xlmPrice']:.4f}")
 
-    # Execute a treasury rebalance strategy
+    # Trigger a demo strategy on Nirium's own shared testnet vault — a real,
+    # working transaction, not a simulation, but it moves Nirium's testnet
+    # funds, not yours. To rebalance YOUR OWN vault, see Treasury Rebalance below.
     result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
     print(f"Success: {result['success']} | TX: {result.get('txHash')}")
 
@@ -130,6 +132,33 @@ Licensed for **independent service payments only** — contractors, freelancers,
 
 Mainnet is invite-only during early access and additionally requires `client_info`.
 
+## Treasury Rebalance
+
+Two ways to rebalance a DeFindex vault between idle cash and an invested strategy. Neither is a swap — the contract's `rebalance()` exposes exactly two instructions, `Unwind` and `Invest`, and neither accepts a destination address, so withdrawing anywhere but back into the vault itself is not expressible.
+
+### Propose — you review and sign, available to everyone today
+
+The agent decides what it would do, using the same decision logic as the autonomous signer below, but it never signs. Public, no allowlist, no invite required — works for any vault where you're already the on-chain rebalance manager.
+
+```python
+proposal = await agent.propose_treasury_rebalance(
+    vault="CABC...",
+    caller="GABC...",   # must already be this vault's rebalanceManager on-chain
+    enter_at=2.5,        # your own mandate — Nirium never supplies a default here
+    exit_at=2.0,
+)
+
+if proposal["instructions"]:
+    signed_xdr = sign_with_your_wallet(proposal["xdr"])
+    await agent.submit_treasury_tx(signed_xdr)
+else:
+    print("Nothing to propose:", proposal["reason"])
+```
+
+### Autonomous — Nirium signs, invite-only during legal review
+
+`execute_treasury_rebalance()` has Nirium sign and submit with its own RebalanceManager key — full autonomy, no per-cycle approval. **This is invite-only while a specific legal question stays open**: whether executing on a client's behalf without taking custody still counts as regulated facilitation under Mexican law. It only runs against vaults explicitly allowlisted server-side; calling it against any other vault returns 403, and Nirium's mainnet infrastructure returns 501 for it entirely, since that box holds no signing key by design. Ask if you want autonomous execution today — otherwise, `propose_treasury_rebalance()` above gives you the same decision-making with you as the one who signs.
+
 ## Audit Trail
 
 Anchor evidence to IPFS and get back a CID — an integrity seal, not notarization.
@@ -159,6 +188,7 @@ Anchor a **hash** rather than the data itself: IPFS content cannot be deleted, s
 | Revenue | `get_revenue()`, `get_info()` |
 | Nodes | `get_nodes()` |
 | Payouts | `create_payout_run()`, `submit_payout()`, `onboard_payout_recipient()`, `submit_payout_onboard()`, `get_payout_runs()`, `get_payout_terms()`, `get_payout_info()` |
+| Treasury | `get_treasury_info()`, `get_treasury_vault()`, `get_treasury_vaults()`, `get_treasury_strategy_asset()`, `deploy_treasury_vault()`, `deposit_to_treasury_vault()`, `withdraw_from_treasury_vault()`, `set_treasury_rebalance_manager()`, `build_treasury_rebalance()`, `propose_treasury_rebalance()`, `execute_treasury_rebalance()`, `submit_treasury_tx()` |
 | Audit Trail | `anchor_audit_record()`, `get_audit_info()` |
 | Reporting | `get_reporting_summary()`, `get_reporting_export()` |
 | Admin | `configure_llm()` |

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

@@ -30,7 +30,9 @@ async def main():
     market = await agent.get_market()
     print(f"XLM Price: ${market['xlmPrice']:.4f}")
 
-    # Execute a treasury rebalance strategy
+    # Trigger a demo strategy on Nirium's own shared testnet vault — a real,
+    # working transaction, not a simulation, but it moves Nirium's testnet
+    # funds, not yours. To rebalance YOUR OWN vault, see Treasury Rebalance below.
     result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
     print(f"Success: {result['success']} | TX: {result.get('txHash')}")
 
@@ -110,6 +112,33 @@ Licensed for **independent service payments only** — contractors, freelancers,
 
 Mainnet is invite-only during early access and additionally requires `client_info`.
 
+## Treasury Rebalance
+
+Two ways to rebalance a DeFindex vault between idle cash and an invested strategy. Neither is a swap — the contract's `rebalance()` exposes exactly two instructions, `Unwind` and `Invest`, and neither accepts a destination address, so withdrawing anywhere but back into the vault itself is not expressible.
+
+### Propose — you review and sign, available to everyone today
+
+The agent decides what it would do, using the same decision logic as the autonomous signer below, but it never signs. Public, no allowlist, no invite required — works for any vault where you're already the on-chain rebalance manager.
+
+```python
+proposal = await agent.propose_treasury_rebalance(
+    vault="CABC...",
+    caller="GABC...",   # must already be this vault's rebalanceManager on-chain
+    enter_at=2.5,        # your own mandate — Nirium never supplies a default here
+    exit_at=2.0,
+)
+
+if proposal["instructions"]:
+    signed_xdr = sign_with_your_wallet(proposal["xdr"])
+    await agent.submit_treasury_tx(signed_xdr)
+else:
+    print("Nothing to propose:", proposal["reason"])
+```
+
+### Autonomous — Nirium signs, invite-only during legal review
+
+`execute_treasury_rebalance()` has Nirium sign and submit with its own RebalanceManager key — full autonomy, no per-cycle approval. **This is invite-only while a specific legal question stays open**: whether executing on a client's behalf without taking custody still counts as regulated facilitation under Mexican law. It only runs against vaults explicitly allowlisted server-side; calling it against any other vault returns 403, and Nirium's mainnet infrastructure returns 501 for it entirely, since that box holds no signing key by design. Ask if you want autonomous execution today — otherwise, `propose_treasury_rebalance()` above gives you the same decision-making with you as the one who signs.
+
 ## Audit Trail
 
 Anchor evidence to IPFS and get back a CID — an integrity seal, not notarization.
@@ -139,6 +168,7 @@ Anchor a **hash** rather than the data itself: IPFS content cannot be deleted, s
 | Revenue | `get_revenue()`, `get_info()` |
 | Nodes | `get_nodes()` |
 | Payouts | `create_payout_run()`, `submit_payout()`, `onboard_payout_recipient()`, `submit_payout_onboard()`, `get_payout_runs()`, `get_payout_terms()`, `get_payout_info()` |
+| Treasury | `get_treasury_info()`, `get_treasury_vault()`, `get_treasury_vaults()`, `get_treasury_strategy_asset()`, `deploy_treasury_vault()`, `deposit_to_treasury_vault()`, `withdraw_from_treasury_vault()`, `set_treasury_rebalance_manager()`, `build_treasury_rebalance()`, `propose_treasury_rebalance()`, `execute_treasury_rebalance()`, `submit_treasury_tx()` |
 | Audit Trail | `anchor_audit_record()`, `get_audit_info()` |
 | Reporting | `get_reporting_summary()`, `get_reporting_export()` |
 | Admin | `configure_llm()` |

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nirium"
-version = "0.9.2"
+version = "0.10.0"
 description = "Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client"
 readme = "README.md"
 requires-python = ">=3.10"

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

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="nirium",
-    version="0.9.2",
+    version="0.10.0",
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     install_requires=[

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

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

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

@@ -542,6 +542,29 @@ class Agent:
             payload["caller"] = caller
         return await self._post("/api/treasury/rebalance", payload)
 
+    async def propose_treasury_rebalance(
+        self, vault: str, caller: str, enter_at: float, exit_at: float,
+        min_idle: Optional[Any] = None,
+    ) -> Dict[str, Any]:
+        """Ask the agent what it would propose for this vault — the same decision
+        logic the autonomous signer uses (rate vs. your own ``enter_at``/``exit_at``),
+        but this never signs. Returns an unsigned XDR for you to review and sign
+        yourself, or an empty ``instructions`` list with a ``reason`` if there's
+        nothing to do right now. Public: no allowlist, no invite — works for any
+        vault where ``caller`` is already the on-chain rebalanceManager. Unlike
+        ``execute_treasury_rebalance``, Nirium never executes on your behalf here,
+        so this doesn't wait on the same legal review the fully autonomous path does.
+
+        ``enter_at``/``exit_at`` are your mandate, not a Nirium default. ``min_idle``
+        is stroops, as a string or number — omit for no minimum (0).
+        """
+        payload: Dict[str, Any] = {
+            "vault": vault, "caller": caller, "enterAt": enter_at, "exitAt": exit_at,
+        }
+        if min_idle is not None:
+            payload["minIdle"] = str(min_idle)
+        return await self._post("/api/treasury/rebalance/propose", payload)
+
     async def execute_treasury_rebalance(
         self, vault: str, instructions: List[Dict[str, Any]], caller: Optional[str] = None,
     ) -> Dict[str, Any]:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nirium
-Version: 0.9.2
+Version: 0.10.0
 Summary: Autonomous treasury and agentic-payments infrastructure for Stellar (x402 + MPP) — Python client
 Author: Nirium Team
 Author-email: Nirium Protocol <niriumprotocol@gmail.com>
@@ -50,7 +50,9 @@ async def main():
     market = await agent.get_market()
     print(f"XLM Price: ${market['xlmPrice']:.4f}")
 
-    # Execute a treasury rebalance strategy
+    # Trigger a demo strategy on Nirium's own shared testnet vault — a real,
+    # working transaction, not a simulation, but it moves Nirium's testnet
+    # funds, not yours. To rebalance YOUR OWN vault, see Treasury Rebalance below.
     result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
     print(f"Success: {result['success']} | TX: {result.get('txHash')}")
 
@@ -130,6 +132,33 @@ Licensed for **independent service payments only** — contractors, freelancers,
 
 Mainnet is invite-only during early access and additionally requires `client_info`.
 
+## Treasury Rebalance
+
+Two ways to rebalance a DeFindex vault between idle cash and an invested strategy. Neither is a swap — the contract's `rebalance()` exposes exactly two instructions, `Unwind` and `Invest`, and neither accepts a destination address, so withdrawing anywhere but back into the vault itself is not expressible.
+
+### Propose — you review and sign, available to everyone today
+
+The agent decides what it would do, using the same decision logic as the autonomous signer below, but it never signs. Public, no allowlist, no invite required — works for any vault where you're already the on-chain rebalance manager.
+
+```python
+proposal = await agent.propose_treasury_rebalance(
+    vault="CABC...",
+    caller="GABC...",   # must already be this vault's rebalanceManager on-chain
+    enter_at=2.5,        # your own mandate — Nirium never supplies a default here
+    exit_at=2.0,
+)
+
+if proposal["instructions"]:
+    signed_xdr = sign_with_your_wallet(proposal["xdr"])
+    await agent.submit_treasury_tx(signed_xdr)
+else:
+    print("Nothing to propose:", proposal["reason"])
+```
+
+### Autonomous — Nirium signs, invite-only during legal review
+
+`execute_treasury_rebalance()` has Nirium sign and submit with its own RebalanceManager key — full autonomy, no per-cycle approval. **This is invite-only while a specific legal question stays open**: whether executing on a client's behalf without taking custody still counts as regulated facilitation under Mexican law. It only runs against vaults explicitly allowlisted server-side; calling it against any other vault returns 403, and Nirium's mainnet infrastructure returns 501 for it entirely, since that box holds no signing key by design. Ask if you want autonomous execution today — otherwise, `propose_treasury_rebalance()` above gives you the same decision-making with you as the one who signs.
+
 ## Audit Trail
 
 Anchor evidence to IPFS and get back a CID — an integrity seal, not notarization.
@@ -159,6 +188,7 @@ Anchor a **hash** rather than the data itself: IPFS content cannot be deleted, s
 | Revenue | `get_revenue()`, `get_info()` |
 | Nodes | `get_nodes()` |
 | Payouts | `create_payout_run()`, `submit_payout()`, `onboard_payout_recipient()`, `submit_payout_onboard()`, `get_payout_runs()`, `get_payout_terms()`, `get_payout_info()` |
+| Treasury | `get_treasury_info()`, `get_treasury_vault()`, `get_treasury_vaults()`, `get_treasury_strategy_asset()`, `deploy_treasury_vault()`, `deposit_to_treasury_vault()`, `withdraw_from_treasury_vault()`, `set_treasury_rebalance_manager()`, `build_treasury_rebalance()`, `propose_treasury_rebalance()`, `execute_treasury_rebalance()`, `submit_treasury_tx()` |
 | Audit Trail | `anchor_audit_record()`, `get_audit_info()` |
 | Reporting | `get_reporting_summary()`, `get_reporting_export()` |
 | Admin | `configure_llm()` |