Metadata-Version: 2.4
Name: vordium
Version: 0.3.0
Summary: Python SDK for AI agents on Vordium Chain — The AI Layer
Author-email: Vordium <dev@vordium.com>
License: MIT
Project-URL: Homepage, https://vordium.com
Project-URL: Documentation, https://docs.vordium.com
Project-URL: Repository, https://github.com/Vordium/vordium-py
Project-URL: Explorer, https://vordscan.io
Keywords: vordium,blockchain,ai,agents,web3,evm,crypto
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: web3>=6.0.0
Requires-Dist: eth-account>=0.9.0
Requires-Dist: requests>=2.28.0

# Vordium Python SDK

The AI Layer for Crypto.

## Install

```bash
pip install vordium
```

## Quick Start

### Initialize your agent

```bash
vordium init
```

### Python

```python
from vordium import Agent

agent = Agent()
print(agent.address)
print(agent.balance)
```

### Run autonomously

```python
import asyncio
from vordium import Agent

agent = Agent()

async def strategy(agent):
    print(f"Block {agent.block} | {agent.balance} VORD")

asyncio.run(agent.run(strategy=strategy))
```

## Agent Operator (session-key trading, bounded by on-chain caps)

Point an AI at your agent. A **session key** trades within **on-chain caps**
(AA1436) — it can never withdraw or change caps (owner-only). The SDK is a
convenience + local pre-check; **the chain is the authority**. Full guide:
[OPERATOR.md](OPERATOR.md).

```python
from vordium import SessionSigner, AgentBox, Operator

signer = SessionSigner.from_env()          # reads VORDIUM_SESSION_KEY (never hardcode)
box = AgentBox()                           # graceful reads (None until predeploys live)
op = Operator(owner="0xYourTradingAccount", signer=signer, box=box)

caps = box.read_caps(op.owner)             # None until the agent predeploys go live
resp = op.place_order(                     # local cap pre-check -> session-sign -> submit
    pair_id=1, side=0, size=10**18, price=250000000000,
    leverage_bps=20000, client_nonce=1, caps=caps,
)
```

Templates you run on your own infra: `examples/operator_market_maker.py`,
`examples/operator_momentum.py`, `examples/operator_grid.py`.

## CLI Commands

```
vordium init                 Create new agent wallet
vordium status               Check chain status
vordium balance              Check VORD balance
vordium fund                 Get testnet VORD
vordium send <to> <amount>   Send VORD
vordium run agent.py         Run agent script
vordium                      Interactive mode
```

## Network

| | |
|---|---|
| Chain ID | 713714 |
| RPC | https://rpc.vordium.com |
| Explorer | https://vordscan.io |
| Faucet | https://faucet.vordium.com |

## Links

- Docs: https://docs.vordium.com
- GitHub: https://github.com/vordium/vordium-py
