vordium 0.1.0__tar.gz

vordium-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: vordium
+Version: 0.1.0
+Summary: Python SDK for AI agents on Vordium Chain — The AI Layer
+Home-page: https://github.com/vordium/vordium-py
+Author: Vordium
+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
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# 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))
+```
+
+## 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

vordium-0.1.0/README.md

@@ -0,0 +1,67 @@
+# 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))
+```
+
+## 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

vordium-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vordium"
+version = "0.1.0"
+description = "Python SDK for AI agents on Vordium Chain — The AI Layer"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Vordium", email = "dev@vordium.com" }]
+keywords = ["vordium", "blockchain", "ai", "agents", "web3", "evm", "crypto"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "web3>=6.0.0",
+    "eth-account>=0.9.0",
+    "requests>=2.28.0",
+]
+
+[project.urls]
+Homepage = "https://vordium.com"
+Documentation = "https://docs.vordium.com"
+Repository = "https://github.com/Vordium/vordium-py"
+Explorer = "https://vordscan.io"
+
+[project.scripts]
+vordium = "vordium.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["vordium*"]

vordium-0.1.0/setup.cfg

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

vordium-0.1.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+readme = Path(__file__).parent / "README.md"
+long_description = readme.read_text() if readme.exists() else ""
+
+setup(
+    name="vordium",
+    version="0.1.0",
+    author="Vordium",
+    author_email="dev@vordium.com",
+    description="Python SDK for AI agents on Vordium Chain - The AI Layer",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/vordium/vordium-py",
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=[
+        "web3>=6.0.0",
+        "eth-account>=0.8.0",
+        "requests>=2.28.0",
+        "python-dotenv>=0.19.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "vordium=vordium.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)

vordium-0.1.0/vordium/__init__.py

@@ -0,0 +1,19 @@
+"""
+Vordium SDK — Python library for AI agents on Vordium Chain.
+
+Usage:
+    from vordium import Agent
+    agent = Agent()
+    print(agent.address)
+    print(agent.balance)
+
+Docs: https://docs.vordium.com
+"""
+
+from .agent import Agent
+from .wallet import Wallet
+from .chain import Chain
+
+__version__ = "0.1.0"
+__author__ = "Vordium"
+__all__ = ["Agent", "Wallet", "Chain"]

vordium-0.1.0/vordium/agent.py

@@ -0,0 +1,119 @@
+import os
+import asyncio
+import requests
+from web3 import Web3
+from .config import RPC_URL, CHAIN_ID, FAUCET_URL, EXPLORER_URL
+from .wallet import Wallet
+
+
+class Agent:
+    """
+    Vordium AI Agent
+
+    Usage:
+        agent = Agent()
+        print(agent.address)
+        print(agent.balance)
+        await agent.run()
+    """
+
+    def __init__(self, private_key: str = None):
+        self._w3 = Web3(Web3.HTTPProvider(RPC_URL))
+
+        if private_key:
+            self._wallet = Wallet.from_key(private_key)
+        elif os.getenv('VORDIUM_PRIVATE_KEY'):
+            self._wallet = Wallet.from_key(os.getenv('VORDIUM_PRIVATE_KEY'))
+        else:
+            self._wallet = Wallet.create()
+            print("New agent wallet created!")
+            print(f"Address:     {self._wallet.address}")
+            print(f"Private Key: {self._wallet.private_key}")
+            print("Save this to your .env file:")
+            print(f"VORDIUM_PRIVATE_KEY={self._wallet.private_key}")
+
+    @property
+    def address(self) -> str:
+        return self._wallet.address
+
+    @property
+    def private_key(self) -> str:
+        return self._wallet.private_key
+
+    @property
+    def balance(self) -> float:
+        raw = self._w3.eth.get_balance(self.address)
+        return float(self._w3.from_wei(raw, 'ether'))
+
+    @property
+    def block(self) -> int:
+        return self._w3.eth.block_number
+
+    def fund(self) -> bool:
+        """Get free testnet VORD from faucet."""
+        try:
+            response = requests.post(
+                f"{FAUCET_URL}/api/faucet",
+                json={"address": self.address},
+                timeout=30
+            )
+            if response.status_code == 200:
+                print("Funded with 100 VORD")
+                return True
+            print(f"Faucet: {response.text}")
+            return False
+        except Exception as e:
+            print(f"Faucet error: {e}")
+            return False
+
+    def send(self, to: str, amount: float) -> str:
+        """Send VORD to an address."""
+        nonce = self._w3.eth.get_transaction_count(self.address)
+        tx = {
+            'to': Web3.to_checksum_address(to),
+            'value': self._w3.to_wei(amount, 'ether'),
+            'gas': 21000,
+            'gasPrice': self._w3.eth.gas_price,
+            'nonce': nonce,
+            'chainId': CHAIN_ID
+        }
+        signed = self._w3.eth.account.sign_transaction(tx, self.private_key)
+        raw = getattr(signed, 'raw_transaction', None) or signed.rawTransaction
+        tx_hash = self._w3.eth.send_raw_transaction(raw)
+        tx_hex = tx_hash.hex()
+        self._w3.eth.wait_for_transaction_receipt(tx_hash)
+        print(f"Sent {amount} VORD")
+        print(f"TX: {EXPLORER_URL}/tx/{tx_hex}")
+        return tx_hex
+
+    def is_healthy(self) -> bool:
+        try:
+            return self._w3.is_connected() and self.block > 0
+        except Exception:
+            return False
+
+    async def run(self, strategy=None, interval: float = 1.0):
+        """Run agent autonomously."""
+        print(f"\nAgent: {self.address}")
+        print(f"Balance: {self.balance} VORD")
+        print(f"Block: {self.block:,}")
+        status = 'Healthy' if self.is_healthy() else 'Unhealthy'
+        print(f"Status: {status}")
+        print("\nRunning... (Ctrl+C to stop)\n")
+
+        while True:
+            try:
+                if strategy:
+                    await strategy(self)
+                else:
+                    print(f"Block {self.block:,} | {self.balance:.4f} VORD")
+                await asyncio.sleep(interval)
+            except KeyboardInterrupt:
+                print("\nAgent stopped.")
+                break
+            except Exception as e:
+                print(f"Error: {e}")
+                await asyncio.sleep(5)
+
+    def __repr__(self):
+        return f"Agent(address={self.address})"

vordium-0.1.0/vordium/chain.py

@@ -0,0 +1,37 @@
+from web3 import Web3
+from .config import RPC_URL, EXPLORER_URL
+
+
+class Chain:
+    def __init__(self):
+        self._w3 = Web3(Web3.HTTPProvider(RPC_URL))
+
+    @property
+    def connected(self) -> bool:
+        return self._w3.is_connected()
+
+    @property
+    def block_number(self) -> int:
+        return self._w3.eth.block_number
+
+    @property
+    def gas_price(self) -> float:
+        return float(self._w3.from_wei(self._w3.eth.gas_price, 'gwei'))
+
+    def get_balance(self, address: str) -> float:
+        raw = self._w3.eth.get_balance(Web3.to_checksum_address(address))
+        return float(self._w3.from_wei(raw, 'ether'))
+
+    def get_transaction(self, tx_hash: str):
+        return self._w3.eth.get_transaction(tx_hash)
+
+    def get_block(self, number: int = None):
+        if number is None:
+            return self._w3.eth.get_block('latest')
+        return self._w3.eth.get_block(number)
+
+    def explorer_url(self, tx_hash: str) -> str:
+        return f"{EXPLORER_URL}/tx/{tx_hash}"
+
+    def __repr__(self):
+        return f"Chain(block={self.block_number}, connected={self.connected})"

vordium-0.1.0/vordium/cli.py

@@ -0,0 +1,146 @@
+import argparse
+from .agent import Agent
+from .chain import Chain
+from .config import CHAIN_ID, RPC_URL, EXPLORER_URL, CHAIN_NAME
+
+BANNER = """
+==========================================
+         VORDIUM AGENT TERMINAL
+        The AI Layer for Crypto
+           docs.vordium.com
+==========================================
+"""
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog='vordium',
+        description='Vordium Agent CLI - The AI Layer'
+    )
+    subparsers = parser.add_subparsers(dest='command')
+
+    subparsers.add_parser('init', help='Create new agent wallet')
+    subparsers.add_parser('status', help='Check chain status')
+    subparsers.add_parser('fund', help='Get testnet VORD from faucet')
+
+    bal = subparsers.add_parser('balance', help='Check VORD balance')
+    bal.add_argument('address', nargs='?')
+
+    send = subparsers.add_parser('send', help='Send VORD')
+    send.add_argument('to')
+    send.add_argument('amount', type=float)
+
+    run = subparsers.add_parser('run', help='Run agent script')
+    run.add_argument('script')
+
+    args = parser.parse_args()
+    print(BANNER)
+
+    if args.command == 'init':
+        cmd_init()
+    elif args.command == 'status':
+        cmd_status()
+    elif args.command == 'fund':
+        cmd_fund()
+    elif args.command == 'balance':
+        cmd_balance(args)
+    elif args.command == 'send':
+        cmd_send(args)
+    elif args.command == 'run':
+        cmd_run(args)
+    else:
+        cmd_interactive()
+
+
+def cmd_init():
+    print("Initializing new agent...\n")
+    agent = Agent()
+    print(f"\n{'='*50}")
+    print(f"Address:     {agent.address}")
+    print(f"Private Key: {agent.private_key}")
+    print(f"{'='*50}")
+    print("\nSave your private key to .env:")
+    print(f"VORDIUM_PRIVATE_KEY={agent.private_key}\n")
+    print("Getting testnet VORD...")
+    agent.fund()
+    print(f"Balance: {agent.balance} VORD")
+    print(f"Explorer: {EXPLORER_URL}/address/{agent.address}")
+    print("\nAgent ready to trade.")
+
+
+def cmd_status():
+    chain = Chain()
+    status = 'Online' if chain.connected else 'Offline'
+    print(f"Chain:     {CHAIN_NAME}")
+    print(f"Chain ID:  {CHAIN_ID}")
+    print(f"RPC:       {RPC_URL}")
+    print(f"Block:     {chain.block_number:,}")
+    print(f"Gas Price: {chain.gas_price:.2f} gwei")
+    print(f"Status:    {status}")
+    print(f"Explorer:  {EXPLORER_URL}")
+
+
+def cmd_fund():
+    agent = Agent()
+    print(f"Requesting VORD for {agent.address}...")
+    agent.fund()
+    print(f"Balance: {agent.balance} VORD")
+
+
+def cmd_balance(args):
+    chain = Chain()
+    addr = args.address if args.address else Agent().address
+    print(f"Address: {addr}")
+    print(f"Balance: {chain.get_balance(addr)} VORD")
+
+
+def cmd_send(args):
+    agent = Agent()
+    print(f"Sending {args.amount} VORD to {args.to}...")
+    agent.send(args.to, args.amount)
+
+
+def cmd_run(args):
+    print(f"Running {args.script}...\n")
+    with open(args.script) as f:
+        exec(f.read())
+
+
+def cmd_interactive():
+    chain = Chain()
+    agent = Agent()
+    print(f"Connected: {CHAIN_NAME}")
+    print(f"Block:     {chain.block_number:,}")
+    print(f"Address:   {agent.address}")
+    print(f"Balance:   {agent.balance} VORD")
+    print("\nCommands: status, balance, fund, send <to> <amount>, exit\n")
+
+    while True:
+        try:
+            cmd = input("vordium> ").strip()
+            if not cmd:
+                continue
+            if cmd == 'status':
+                print(f"Block: {chain.block_number:,} | Gas: {chain.gas_price:.2f} gwei")
+            elif cmd == 'balance':
+                print(f"{agent.balance} VORD")
+            elif cmd == 'fund':
+                agent.fund()
+            elif cmd.startswith('send '):
+                parts = cmd.split()
+                if len(parts) == 3:
+                    agent.send(parts[1], float(parts[2]))
+            elif cmd in ('exit', 'quit'):
+                print("Goodbye.")
+                break
+            else:
+                print("Commands: status, balance, fund, send <to> <amount>, exit")
+        except KeyboardInterrupt:
+            print("\nGoodbye.")
+            break
+        except Exception as e:
+            print(f"Error: {e}")
+
+
+if __name__ == '__main__':
+    main()

vordium-0.1.0/vordium/config.py

@@ -0,0 +1,12 @@
+CHAIN_ID = 713714
+CHAIN_ID_HEX = "0xae3f2"
+CHAIN_NAME = "Vordium Chain"
+RPC_URL = "https://rpc.vordium.com"
+WS_URL = "wss://ws.vordium.com"
+EXPLORER_URL = "https://vordscan.io"
+FAUCET_URL = "https://faucet.vordium.com"
+NATIVE_TOKEN = "VORD"
+NATIVE_DECIMALS = 18
+VRC20_STANDARD = "0xF924975Cc9d401cd5a6bD1171DEDaEc0bD301B20"
+VRC721_STANDARD = "0xD75c82c33c8642150d0485fCE330fD9FE44b9dC0"
+VRC1155_STANDARD = "0x90811A8D1e19BE8030D18B9C61b566A676d82f1A"

vordium-0.1.0/vordium/wallet.py

@@ -0,0 +1,51 @@
+import json
+from eth_account import Account
+from web3 import Web3
+from .config import RPC_URL
+
+Account.enable_unaudited_hdwallet_features()
+
+
+class Wallet:
+    def __init__(self, private_key: str = None):
+        self._w3 = Web3(Web3.HTTPProvider(RPC_URL))
+        if private_key:
+            self._account = Account.from_key(private_key)
+        else:
+            self._account = Account.create()
+
+    @classmethod
+    def create(cls) -> 'Wallet':
+        return cls()
+
+    @classmethod
+    def from_key(cls, private_key: str) -> 'Wallet':
+        return cls(private_key=private_key)
+
+    @classmethod
+    def from_mnemonic(cls, mnemonic: str) -> 'Wallet':
+        account = Account.from_mnemonic(mnemonic)
+        return cls(private_key=account.key.hex())
+
+    @property
+    def address(self) -> str:
+        return self._account.address
+
+    @property
+    def private_key(self) -> str:
+        return self._account.key.hex()
+
+    def balance(self) -> float:
+        raw = self._w3.eth.get_balance(self.address)
+        return float(self._w3.from_wei(raw, 'ether'))
+
+    def save(self, path: str):
+        with open(path, 'w') as f:
+            json.dump({
+                'address': self.address,
+                'private_key': self.private_key
+            }, f, indent=2)
+        print(f"Wallet saved to {path}")
+
+    def __repr__(self):
+        return f"Wallet(address={self.address})"

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

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: vordium
+Version: 0.1.0
+Summary: Python SDK for AI agents on Vordium Chain — The AI Layer
+Home-page: https://github.com/vordium/vordium-py
+Author: Vordium
+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
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# 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))
+```
+
+## 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

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

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+setup.py
+vordium/__init__.py
+vordium/agent.py
+vordium/chain.py
+vordium/cli.py
+vordium/config.py
+vordium/wallet.py
+vordium.egg-info/PKG-INFO
+vordium.egg-info/SOURCES.txt
+vordium.egg-info/dependency_links.txt
+vordium.egg-info/entry_points.txt
+vordium.egg-info/requires.txt
+vordium.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

vordium-0.1.0/vordium.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+vordium = vordium.cli:main

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

@@ -0,0 +1,3 @@
+web3>=6.0.0
+eth-account>=0.9.0
+requests>=2.28.0

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

@@ -0,0 +1 @@
+vordium