nirium 0.6.0__tar.gz → 0.6.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,23 +1,28 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: nirium
3
- Version: 0.6.0
3
+ Version: 0.6.2
4
4
  Summary: Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)
5
- Author: Nirium Protocol
6
- License: MIT
7
- Project-URL: Homepage, https://nirium.dev
8
- Project-URL: Repository, https://github.com/nirium/nirium
9
- Project-URL: Documentation, https://nirium.dev/docs
10
- Keywords: nirium,stellar,defi,sdk,soroban,agent,x402,mpp,agentic-payments,usdc
11
- Requires-Python: >=3.9
5
+ Author: Nirium Team
6
+ Author-email: Nirium Protocol <xvaiosx7@gmail.com>
7
+ License-Expression: Apache-2.0
8
+ Project-URL: Homepage, https://nirium.xyz
9
+ Project-URL: Repository, https://github.com/Eras256/nirium-core-private
10
+ Project-URL: Documentation, https://nirium.xyz/docs
11
+ Project-URL: Bug Tracker, https://github.com/nirium/nirium/issues
12
+ Keywords: nirium,stellar,soroban,defi,sdk,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
13
+ Requires-Python: >=3.10
12
14
  Description-Content-Type: text/markdown
13
15
  Requires-Dist: aiohttp>=3.9.0
14
16
  Requires-Dist: websockets>=13.0
15
17
  Requires-Dist: stellar-sdk>=11.0.0
18
+ Dynamic: author
16
19
  Dynamic: requires-python
17
20
 
18
21
  # nirium
19
22
 
20
- Official Python SDK for the **Nirium Protocol** — autonomous DeFi agent infrastructure on Stellar/Soroban.
23
+ Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
24
+
25
+ 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.
21
26
 
22
27
  ## Install
23
28
 
@@ -32,7 +37,7 @@ import asyncio
32
37
  from nirium import Agent
33
38
 
34
39
  agent = Agent(
35
- api_url="https://api.nirium.xyz",
40
+ api_url="https://nirium-agent.fly.dev",
36
41
  api_key="sk_inst_your_key_here",
37
42
  )
38
43
 
@@ -45,9 +50,9 @@ async def main():
45
50
  market = await agent.get_market()
46
51
  print(f"XLM Price: ${market['xlmPrice']:.4f}")
47
52
 
48
- # Execute a strategy
49
- result = await agent.execute("flash-loan-arb", "XLM-USDC", {"amount": 5000})
50
- print(f"Profit: {result['profit']}")
53
+ # Execute a treasury rebalance strategy
54
+ result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
55
+ print(f"Success: {result['success']} | TX: {result.get('txHash')}")
51
56
 
52
57
  asyncio.run(main())
53
58
  ```
@@ -55,7 +60,7 @@ asyncio.run(main())
55
60
  ## Real-Time Signals (WebSocket)
56
61
 
57
62
  ```python
58
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
63
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
59
64
 
60
65
  @agent.on("signal")
61
66
  async def on_signal(data):
@@ -68,10 +73,10 @@ asyncio.run(agent.subscribe())
68
73
 
69
74
  ```python
70
75
  # API Key for REST endpoints
71
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...")
76
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...")
72
77
 
73
78
  # With JWT token for WebSocket
74
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
79
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
75
80
  ```
76
81
 
77
82
  ## Payment Protocols
@@ -83,8 +88,7 @@ agent.init_x402(
83
88
  network="stellar:testnet"
84
89
  )
85
90
 
86
- response = await agent.x402_fetch("https://api.nirium.xyz/api/v1/premium/signals")
87
- data = await response.json()
91
+ response = await agent.x402_fetch("https://nirium-agent.fly.dev/api/v1/premium/signals")
88
92
  ```
89
93
 
90
94
  ### MPP — Session-Based Budget Delegation
@@ -92,11 +96,9 @@ data = await response.json()
92
96
  agent.init_mpp(
93
97
  secret_key="S...",
94
98
  network="stellar:testnet",
95
- mode="pull"
96
99
  )
97
100
 
98
- response = await agent.mpp_fetch("https://api.nirium.xyz/api/v1/mpp/signals")
99
- data = await response.json()
101
+ response = await agent.mpp_fetch("https://nirium-agent.fly.dev/api/v1/mpp/signals")
100
102
  ```
101
103
 
102
104
  ### Endpoint Access Model
@@ -106,7 +108,8 @@ data = await response.json()
106
108
  | **Public** (no key) | `health`, `loop/status`, `execute-demo`, `signals/recent`, `skills` list |
107
109
  | **Protected** (API key) | `execute`, `market`, `loop/start\|stop\|scan`, `subscriptions`, `skills/install`, `webhooks` |
108
110
  | **WebSocket** (JWT) | `/ws/signals` — real-time signal stream |
109
- | **x402 Premium** | `/api/v1/premium/signals` ($0.02), `/api/v1/premium/market` ($0.05) |
111
+ | **x402 Premium** | `/api/v1/premium/signals` ($0.02 USDC), `/api/v1/premium/market` ($0.05 USDC) |
112
+ | **MPP** | `/api/v1/mpp/signals`, `/api/v1/mpp/market` |
110
113
 
111
114
  ## API Coverage
112
115
 
@@ -134,10 +137,12 @@ data = await response.json()
134
137
 
135
138
  ## Links
136
139
 
137
- - [Full SDK Documentation](../../SDKs.md)
138
- - [API Documentation](../../API_DOCUMENTATION_OPENAPI.yaml)
139
- - [MCP Integration Guide](../../MCP_INTEGRATION_GUIDE.md)
140
+ - [Documentation](https://nirium.xyz/docs)
141
+ - [Developer Sandbox](https://nirium.xyz/sandbox)
142
+ - [API Reference](https://nirium.xyz/docs/api)
143
+ - [MCP Server Integration](https://nirium.xyz/docs/mcp)
144
+ - [GitHub](https://github.com/nirium/nirium)
140
145
 
141
146
  ## License
142
147
 
143
- MIT — Nirium Protocol
148
+ Apache 2.0 — Nirium Protocol
@@ -1,6 +1,8 @@
1
1
  # nirium
2
2
 
3
- Official Python SDK for the **Nirium Protocol** — autonomous DeFi agent infrastructure on Stellar/Soroban.
3
+ Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
4
+
5
+ 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.
4
6
 
5
7
  ## Install
6
8
 
@@ -15,7 +17,7 @@ import asyncio
15
17
  from nirium import Agent
16
18
 
17
19
  agent = Agent(
18
- api_url="https://api.nirium.xyz",
20
+ api_url="https://nirium-agent.fly.dev",
19
21
  api_key="sk_inst_your_key_here",
20
22
  )
21
23
 
@@ -28,9 +30,9 @@ async def main():
28
30
  market = await agent.get_market()
29
31
  print(f"XLM Price: ${market['xlmPrice']:.4f}")
30
32
 
31
- # Execute a strategy
32
- result = await agent.execute("flash-loan-arb", "XLM-USDC", {"amount": 5000})
33
- print(f"Profit: {result['profit']}")
33
+ # Execute a treasury rebalance strategy
34
+ result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
35
+ print(f"Success: {result['success']} | TX: {result.get('txHash')}")
34
36
 
35
37
  asyncio.run(main())
36
38
  ```
@@ -38,7 +40,7 @@ asyncio.run(main())
38
40
  ## Real-Time Signals (WebSocket)
39
41
 
40
42
  ```python
41
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
43
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
42
44
 
43
45
  @agent.on("signal")
44
46
  async def on_signal(data):
@@ -51,10 +53,10 @@ asyncio.run(agent.subscribe())
51
53
 
52
54
  ```python
53
55
  # API Key for REST endpoints
54
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...")
56
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...")
55
57
 
56
58
  # With JWT token for WebSocket
57
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
59
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
58
60
  ```
59
61
 
60
62
  ## Payment Protocols
@@ -66,8 +68,7 @@ agent.init_x402(
66
68
  network="stellar:testnet"
67
69
  )
68
70
 
69
- response = await agent.x402_fetch("https://api.nirium.xyz/api/v1/premium/signals")
70
- data = await response.json()
71
+ response = await agent.x402_fetch("https://nirium-agent.fly.dev/api/v1/premium/signals")
71
72
  ```
72
73
 
73
74
  ### MPP — Session-Based Budget Delegation
@@ -75,11 +76,9 @@ data = await response.json()
75
76
  agent.init_mpp(
76
77
  secret_key="S...",
77
78
  network="stellar:testnet",
78
- mode="pull"
79
79
  )
80
80
 
81
- response = await agent.mpp_fetch("https://api.nirium.xyz/api/v1/mpp/signals")
82
- data = await response.json()
81
+ response = await agent.mpp_fetch("https://nirium-agent.fly.dev/api/v1/mpp/signals")
83
82
  ```
84
83
 
85
84
  ### Endpoint Access Model
@@ -89,7 +88,8 @@ data = await response.json()
89
88
  | **Public** (no key) | `health`, `loop/status`, `execute-demo`, `signals/recent`, `skills` list |
90
89
  | **Protected** (API key) | `execute`, `market`, `loop/start\|stop\|scan`, `subscriptions`, `skills/install`, `webhooks` |
91
90
  | **WebSocket** (JWT) | `/ws/signals` — real-time signal stream |
92
- | **x402 Premium** | `/api/v1/premium/signals` ($0.02), `/api/v1/premium/market` ($0.05) |
91
+ | **x402 Premium** | `/api/v1/premium/signals` ($0.02 USDC), `/api/v1/premium/market` ($0.05 USDC) |
92
+ | **MPP** | `/api/v1/mpp/signals`, `/api/v1/mpp/market` |
93
93
 
94
94
  ## API Coverage
95
95
 
@@ -117,10 +117,12 @@ data = await response.json()
117
117
 
118
118
  ## Links
119
119
 
120
- - [Full SDK Documentation](../../SDKs.md)
121
- - [API Documentation](../../API_DOCUMENTATION_OPENAPI.yaml)
122
- - [MCP Integration Guide](../../MCP_INTEGRATION_GUIDE.md)
120
+ - [Documentation](https://nirium.xyz/docs)
121
+ - [Developer Sandbox](https://nirium.xyz/sandbox)
122
+ - [API Reference](https://nirium.xyz/docs/api)
123
+ - [MCP Server Integration](https://nirium.xyz/docs/mcp)
124
+ - [GitHub](https://github.com/nirium/nirium)
123
125
 
124
126
  ## License
125
127
 
126
- MIT — Nirium Protocol
128
+ Apache 2.0 — Nirium Protocol
@@ -0,0 +1,24 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "nirium"
7
+ version = "0.6.2"
8
+ description = "Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "Apache-2.0"
12
+ authors = [{name = "Nirium Protocol", email = "xvaiosx7@gmail.com"}]
13
+ keywords = ["nirium", "stellar", "soroban", "defi", "sdk", "agent", "autonomous", "treasury", "x402", "mpp", "agentic-payments", "usdc", "cetes", "etherfuse", "rwa"]
14
+ dependencies = [
15
+ "aiohttp>=3.9.0",
16
+ "websockets>=13.0",
17
+ "stellar-sdk>=11.0.0",
18
+ ]
19
+
20
+ [project.urls]
21
+ Homepage = "https://nirium.xyz"
22
+ Repository = "https://github.com/Eras256/nirium-core-private"
23
+ Documentation = "https://nirium.xyz/docs"
24
+ "Bug Tracker" = "https://github.com/nirium/nirium/issues"
@@ -2,16 +2,16 @@ from setuptools import setup, find_packages
2
2
 
3
3
  setup(
4
4
  name="nirium",
5
- version="0.4.0",
5
+ version="0.6.2",
6
6
  package_dir={"": "src"},
7
7
  packages=find_packages(where="src"),
8
8
  install_requires=[
9
- "websockets>=11.0.3",
10
- "aiohttp>=3.8.4",
9
+ "websockets>=13.0",
10
+ "aiohttp>=3.9.0",
11
11
  "stellar-sdk>=11.0.0",
12
12
  ],
13
13
  author="Nirium Team",
14
14
  description="Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)",
15
15
  keywords=["nirium", "stellar", "defi", "x402", "mpp", "agentic-payments", "soroban"],
16
- python_requires=">=3.9",
16
+ python_requires=">=3.10",
17
17
  )
@@ -2,5 +2,5 @@
2
2
 
3
3
  from .client import Agent # type: ignore
4
4
 
5
- __version__ = "0.6.0"
5
+ __version__ = "0.6.1"
6
6
  __all__ = ["Agent"]
@@ -1,5 +1,5 @@
1
1
  # ═══════════════════════════════════════════════════════════════
2
- # Nirium Python SDK v0.6.0 — Official Client (x402 + MPP)
2
+ # Nirium Python SDK v0.6.1 — Official Client (x402 + MPP)
3
3
  # Synced with backend API (real Horizon data, Soroban execution)
4
4
  # ═══════════════════════════════════════════════════════════════
5
5
  import asyncio
@@ -1,23 +1,28 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: nirium
3
- Version: 0.6.0
3
+ Version: 0.6.2
4
4
  Summary: Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)
5
- Author: Nirium Protocol
6
- License: MIT
7
- Project-URL: Homepage, https://nirium.dev
8
- Project-URL: Repository, https://github.com/nirium/nirium
9
- Project-URL: Documentation, https://nirium.dev/docs
10
- Keywords: nirium,stellar,defi,sdk,soroban,agent,x402,mpp,agentic-payments,usdc
11
- Requires-Python: >=3.9
5
+ Author: Nirium Team
6
+ Author-email: Nirium Protocol <xvaiosx7@gmail.com>
7
+ License-Expression: Apache-2.0
8
+ Project-URL: Homepage, https://nirium.xyz
9
+ Project-URL: Repository, https://github.com/Eras256/nirium-core-private
10
+ Project-URL: Documentation, https://nirium.xyz/docs
11
+ Project-URL: Bug Tracker, https://github.com/nirium/nirium/issues
12
+ Keywords: nirium,stellar,soroban,defi,sdk,agent,autonomous,treasury,x402,mpp,agentic-payments,usdc,cetes,etherfuse,rwa
13
+ Requires-Python: >=3.10
12
14
  Description-Content-Type: text/markdown
13
15
  Requires-Dist: aiohttp>=3.9.0
14
16
  Requires-Dist: websockets>=13.0
15
17
  Requires-Dist: stellar-sdk>=11.0.0
18
+ Dynamic: author
16
19
  Dynamic: requires-python
17
20
 
18
21
  # nirium
19
22
 
20
- Official Python SDK for the **Nirium Protocol** — autonomous DeFi agent infrastructure on Stellar/Soroban.
23
+ Official Python SDK for the **Nirium Protocol** — autonomous AI treasury infrastructure on Stellar/Soroban.
24
+
25
+ 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.
21
26
 
22
27
  ## Install
23
28
 
@@ -32,7 +37,7 @@ import asyncio
32
37
  from nirium import Agent
33
38
 
34
39
  agent = Agent(
35
- api_url="https://api.nirium.xyz",
40
+ api_url="https://nirium-agent.fly.dev",
36
41
  api_key="sk_inst_your_key_here",
37
42
  )
38
43
 
@@ -45,9 +50,9 @@ async def main():
45
50
  market = await agent.get_market()
46
51
  print(f"XLM Price: ${market['xlmPrice']:.4f}")
47
52
 
48
- # Execute a strategy
49
- result = await agent.execute("flash-loan-arb", "XLM-USDC", {"amount": 5000})
50
- print(f"Profit: {result['profit']}")
53
+ # Execute a treasury rebalance strategy
54
+ result = await agent.execute("blend-yield", "USDC", {"amount": 5000})
55
+ print(f"Success: {result['success']} | TX: {result.get('txHash')}")
51
56
 
52
57
  asyncio.run(main())
53
58
  ```
@@ -55,7 +60,7 @@ asyncio.run(main())
55
60
  ## Real-Time Signals (WebSocket)
56
61
 
57
62
  ```python
58
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
63
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
59
64
 
60
65
  @agent.on("signal")
61
66
  async def on_signal(data):
@@ -68,10 +73,10 @@ asyncio.run(agent.subscribe())
68
73
 
69
74
  ```python
70
75
  # API Key for REST endpoints
71
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...")
76
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...")
72
77
 
73
78
  # With JWT token for WebSocket
74
- agent = Agent(api_url="https://api.nirium.xyz", api_key="sk_inst_...", token="eyJhbG...")
79
+ agent = Agent(api_url="https://nirium-agent.fly.dev", api_key="sk_inst_...", token="eyJhbG...")
75
80
  ```
76
81
 
77
82
  ## Payment Protocols
@@ -83,8 +88,7 @@ agent.init_x402(
83
88
  network="stellar:testnet"
84
89
  )
85
90
 
86
- response = await agent.x402_fetch("https://api.nirium.xyz/api/v1/premium/signals")
87
- data = await response.json()
91
+ response = await agent.x402_fetch("https://nirium-agent.fly.dev/api/v1/premium/signals")
88
92
  ```
89
93
 
90
94
  ### MPP — Session-Based Budget Delegation
@@ -92,11 +96,9 @@ data = await response.json()
92
96
  agent.init_mpp(
93
97
  secret_key="S...",
94
98
  network="stellar:testnet",
95
- mode="pull"
96
99
  )
97
100
 
98
- response = await agent.mpp_fetch("https://api.nirium.xyz/api/v1/mpp/signals")
99
- data = await response.json()
101
+ response = await agent.mpp_fetch("https://nirium-agent.fly.dev/api/v1/mpp/signals")
100
102
  ```
101
103
 
102
104
  ### Endpoint Access Model
@@ -106,7 +108,8 @@ data = await response.json()
106
108
  | **Public** (no key) | `health`, `loop/status`, `execute-demo`, `signals/recent`, `skills` list |
107
109
  | **Protected** (API key) | `execute`, `market`, `loop/start\|stop\|scan`, `subscriptions`, `skills/install`, `webhooks` |
108
110
  | **WebSocket** (JWT) | `/ws/signals` — real-time signal stream |
109
- | **x402 Premium** | `/api/v1/premium/signals` ($0.02), `/api/v1/premium/market` ($0.05) |
111
+ | **x402 Premium** | `/api/v1/premium/signals` ($0.02 USDC), `/api/v1/premium/market` ($0.05 USDC) |
112
+ | **MPP** | `/api/v1/mpp/signals`, `/api/v1/mpp/market` |
110
113
 
111
114
  ## API Coverage
112
115
 
@@ -134,10 +137,12 @@ data = await response.json()
134
137
 
135
138
  ## Links
136
139
 
137
- - [Full SDK Documentation](../../SDKs.md)
138
- - [API Documentation](../../API_DOCUMENTATION_OPENAPI.yaml)
139
- - [MCP Integration Guide](../../MCP_INTEGRATION_GUIDE.md)
140
+ - [Documentation](https://nirium.xyz/docs)
141
+ - [Developer Sandbox](https://nirium.xyz/sandbox)
142
+ - [API Reference](https://nirium.xyz/docs/api)
143
+ - [MCP Server Integration](https://nirium.xyz/docs/mcp)
144
+ - [GitHub](https://github.com/nirium/nirium)
140
145
 
141
146
  ## License
142
147
 
143
- MIT — Nirium Protocol
148
+ Apache 2.0 — Nirium Protocol
@@ -1,23 +0,0 @@
1
- [build-system]
2
- requires = ["setuptools>=68.0", "wheel"]
3
- build-backend = "setuptools.build_meta"
4
-
5
- [project]
6
- name = "nirium"
7
- version = "0.6.0"
8
- description = "Official Python SDK for Nirium autonomous agents on Stellar (x402 + MPP)"
9
- readme = "README.md"
10
- requires-python = ">=3.10"
11
- license = {text = "MIT"}
12
- authors = [{name = "Nirium Protocol"}]
13
- keywords = ["nirium", "stellar", "defi", "sdk", "soroban", "agent", "x402", "mpp", "agentic-payments", "usdc"]
14
- dependencies = [
15
- "aiohttp>=3.9.0",
16
- "websockets>=13.0",
17
- "stellar-sdk>=11.0.0",
18
- ]
19
-
20
- [project.urls]
21
- Homepage = "https://nirium.dev"
22
- Repository = "https://github.com/nirium/nirium"
23
- Documentation = "https://nirium.dev/docs"
File without changes