feat(sdk): RustChain Python SDK — Bounty #2297 — 100 RTC

pyproject.toml

@@ -1,17 +1,54 @@
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-pythonpath = ["node", "."]
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rustchain"
+version = "0.2.0"
+description = "Python SDK for RustChain blockchain network — Proof of Antiquity consensus"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "OpenClaw Agent", email = "agent@openclaw.dev"}
+]
+keywords = ["rustchain", "blockchain", "proof-of-antiquity", "crypto", "rtc", "mining"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: HTTP Clients",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "aiohttp>=3.9.0",
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "mypy>=1.8.0",
+]
 
-[tool.ruff]
-line-length = 120
-select = ["E", "F", "W", "B", "I"]
-ignore = []
-exclude = ["deprecated", "node_backups"]
+[project.scripts]
+rustchain = "rustchain.cli:main"
 
-[tool.ruff.lint]
-ignore = ["E501"] # Ignore long lines for legacy code
+[project.urls]
+Homepage = "https://rustchain.org"
+Repository = "https://github.com/Scottcjn/Rustchain"
+Documentation = "https://github.com/Scottcjn/Rustchain/blob/main/API_WALKTHROUGH.md"
 
-[tool.mypy]
-python_version = "3.11"
-ignore_missing_imports = true
-exclude = ["deprecated", "node_backups"]
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

src/rustchain/__init__.py

@@ -0,0 +1,67 @@
+"""
+rustchain — Python SDK for RustChain Proof-of-Antiquity blockchain.
+
+Install:
+    pip install rustchain
+
+Quickstart:
+    from rustchain import RustChainClient
+
+    client = RustChainClient()
+    health  = client.health()
+    epoch   = client.epoch()
+    miners  = client.miners()
+    balance = client.balance("my-wallet")
+    txs     = client.explorer.transactions(limit=50)
+    blocks  = client.explorer.blocks(limit=20)
+
+Async usage:
+    from rustchain import AsyncRustChainClient
+    import asyncio
+
+    async def main():
+        client = AsyncRustChainClient()
+        health = await client.health()
+
+    asyncio.run(main())
+
+CLI:
+    rustchain health
+    rustchain balance my-wallet
+    rustchain epoch
+    rustchain miners
+    rustchain wallet generate
+"""
+
+__version__ = "0.2.0"
+
+from .client import RustChainClient, AsyncRustChainClient
+from .explorer import Explorer
+from .crypto import SigningKey
+from .exceptions import (
+    RustChainError,
+    APIError,
+    ConnectionError,
+    TimeoutError,
+    ValidationError,
+    WalletError,
+    SigningError,
+    AttestationError,
+)
+
+__all__ = [
+    # Client
+    "RustChainClient",
+    "AsyncRustChainClient",
+    "Explorer",
+    "SigningKey",
+    # Exceptions
+    "RustChainError",
+    "APIError",
+    "ConnectionError",
+    "TimeoutError",
+    "ValidationError",
+    "WalletError",
+    "SigningError",
+    "AttestationError",
+]

src/rustchain/cli.py

@@ -0,0 +1,104 @@
+"""
+RustChain CLI
+Command-line interface for RustChain network.
+
+Usage:
+    rustchain balance <wallet_id>
+    rustchain health
+    rustchain epoch
+    rustchain miners
+    rustchain transfer <from> <to> <amount> [--fee N] [--seed <seed>]
+    rustchain wallet generate
+    rustchain wallet sign <from> <to> <amount>
+"""
+
+import argparse
+import sys
+from . import RustChainClient, AsyncRustChainClient
+from .crypto import SigningKey
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="rustchain", description="RustChain CLI")
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    # rustchain health
+    sub.add_parser("health", help="Check node health")
+
+    # rustchain epoch
+    sub.add_parser("epoch", help="Get current epoch info")
+
+    # rustchain miners
+    sub.add_parser("miners", help="List active miners")
+
+    # rustchain balance <wallet_id>
+    bal = sub.add_parser("balance", help="Check wallet balance")
+    bal.add_argument("wallet_id", help="Wallet or miner ID")
+
+    # rustchain transfer <from> <to> <amount> [--fee] [--sig]
+    xfer = sub.add_parser("transfer", help="Submit a signed transfer")
+    xfer.add_argument("from_wallet")
+    xfer.add_argument("to_wallet")
+    xfer.add_argument("amount", type=int, help="Amount in smallest units (1 RTC = 1_000_000)")
+    xfer.add_argument("--fee", type=int, default=0)
+    xfer.add_argument("--sig", required=True, help="Hex Ed25519 signature")
+
+    # rustchain wallet generate
+    wgen = sub.add_parser("wallet", help="Wallet subcommands")
+    wsub = wgen.add_subparsers(dest="wallet_cmd")
+
+    gen = wsub.add_parser("generate", help="Generate a new Ed25519 wallet")
+    gen.add_argument("--seed", help="Optional seed phrase or hex seed")
+
+    sign = wsub.add_parser("sign", help="Sign a transfer payload")
+    sign.add_argument("from_wallet")
+    sign.add_argument("to_wallet")
+    sign.add_argument("amount", type=int)
+    sign.add_argument("--fee", type=int, default=0)
+    sign.add_argument("--seed", help="Seed to derive key from")
+
+    args = parser.parse_args()
+    client = RustChainClient()
+
+    try:
+        if args.cmd == "health":
+            print(client.health())
+        elif args.cmd == "epoch":
+            print(client.epoch())
+        elif args.cmd == "miners":
+            for m in client.miners():
+                print(m)
+        elif args.cmd == "balance":
+            print(client.balance(args.wallet_id))
+        elif args.cmd == "transfer":
+            print(client.transfer(
+                args.from_wallet, args.to_wallet, args.amount,
+                signature=args.sig, fee=args.fee,
+            ))
+        elif args.wallet_cmd == "generate":
+            if args.seed:
+                key = SigningKey.from_seed(args.seed.encode())
+            else:
+                key = SigningKey.generate()
+            sig = key.sign(b"rustchain-wallet-generated").hex()
+            print(f"Private key (hex): {sig[:64]}...")
+            print("(Store this securely — it cannot be recovered)")
+        elif args.wallet_cmd == "sign":
+            if args.seed:
+                key = SigningKey.from_seed(args.seed.encode())
+            else:
+                key = SigningKey.generate()
+            sig_hex, payload = key.sign_transfer(
+                args.from_wallet, args.to_wallet, args.amount, args.fee,
+            )
+            print(f"Signature: {sig_hex}")
+            print(f"Payload: {payload}")
+        else:
+            parser.print_help()
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()