digirails 0.1.0__tar.gz

digirails-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+env/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+htmlcov/
+.coverage
+*.so
+*.dylib
+*.pyd
+.env
+*.keyfile
+NUL

digirails-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DigiRails Protocol Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

digirails-0.1.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: digirails
+Version: 0.1.0
+Summary: Python SDK for the DR-Pay protocol — AI agent payments on DigiByte
+Project-URL: Homepage, https://github.com/digirails-protocol/digirails-python
+Project-URL: Repository, https://github.com/digirails-protocol/digirails-python
+Project-URL: Specification, https://github.com/digirails-protocol/digirails-spec
+Author: DigiRails Protocol
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,blockchain,cryptocurrency,digibyte,payments
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: cryptography>=42.0
+Requires-Dist: ecdsa>=0.19
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: aioresponses; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: fast
+Requires-Dist: coincurve>=20.0; extra == 'fast'
+Description-Content-Type: text/markdown
+
+# digirails
+
+Python SDK for the [DR-Pay protocol](https://github.com/digirails-protocol/digirails-spec) — permissionless AI agent payments on DigiByte.
+
+## What is this?
+
+DigiRails enables autonomous AI agents to discover, negotiate with, and pay each other using DigiByte's Layer 1 blockchain. This SDK implements the DR-Pay protocol: the 4-message payment flow, agent identity, service manifests, and on-chain data encoding.
+
+Every payment settles on-chain as a standard DigiByte transaction. No sidechains, no Layer 2, no API keys.
+
+## Install
+
+```bash
+pip install digirails
+```
+
+## Quick Start
+
+### Buyer — purchase a service in one call
+
+```python
+import asyncio
+from digirails import Agent, REGTEST
+
+async def main():
+    async with Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    ) as buyer:
+        result = await buyer.request_service(
+            seller_url="http://127.0.0.1:9001",
+            service_id="echo",
+            params={"message": "Hello from DigiRails!"},
+            max_amount="0.01",
+        )
+        print(result.result)
+
+asyncio.run(main())
+```
+
+### Seller — offer a service
+
+```python
+import asyncio
+from digirails import Agent, ServiceCategory, REGTEST
+
+def handle_echo(params: dict) -> dict:
+    return {"echo": params.get("message", "")}
+
+async def main():
+    seller = Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    )
+    seller.register_service(
+        service_id="echo",
+        handler=handle_echo,
+        price="0.001",
+        category=ServiceCategory.GENERAL_COMPUTE,
+    )
+    await seller.serve(port=9001)
+    await asyncio.Event().wait()  # Run forever
+
+asyncio.run(main())
+```
+
+## What happens under the hood
+
+```
+Buyer                                Seller
+  |                                    |
+  |  GET /.well-known/digirails.json   |
+  |----------------------------------->|  1. Discover manifest
+  |<-----------------------------------|
+  |                                    |
+  |  POST /drpay/request               |
+  |----------------------------------->|  2. SERVICE_REQUEST
+  |<-----------------------------------|  3. PAYMENT_INVOICE
+  |                                    |
+  |  [build, sign, broadcast tx]       |
+  |                                    |
+  |  POST /drpay/broadcast             |
+  |----------------------------------->|  4. PAYMENT_BROADCAST
+  |                                    |  5. Verify payment
+  |                                    |  6. Execute service
+  |<-----------------------------------|  7. SERVICE_DELIVERY
+```
+
+## Regtest Demo
+
+Run the self-contained demo with two agents transacting locally:
+
+```bash
+# 1. Start DigiByte Core in regtest mode
+digibyted -regtest -daemon -server \
+  -rpcuser=digirails -rpcpassword=digirails \
+  -txindex=1 -fallbackfee=0.0001
+
+# 2. Run the demo
+python examples/regtest_demo.py
+```
+
+## Features
+
+- **Light mode**: No DigiByte node required. Connects to `rpc.digirails.org` or any RPC endpoint.
+- **Async-native**: Built on asyncio + aiohttp.
+- **Type-safe**: Pydantic models for all protocol messages.
+- **4 dependencies**: pydantic, aiohttp, cryptography, ecdsa. All with pre-built wheels.
+- **SegWit transactions**: BIP-143 signing for P2WPKH inputs.
+- **Encrypted keystore**: AES-256-GCM encrypted key files.
+- **All 18 service categories** from the DR-Pay spec.
+
+## Protocol Version
+
+Implements DR-Pay specification v0.3.0.
+
+## License
+
+MIT

digirails-0.1.0/README.md

@@ -0,0 +1,119 @@
+# digirails
+
+Python SDK for the [DR-Pay protocol](https://github.com/digirails-protocol/digirails-spec) — permissionless AI agent payments on DigiByte.
+
+## What is this?
+
+DigiRails enables autonomous AI agents to discover, negotiate with, and pay each other using DigiByte's Layer 1 blockchain. This SDK implements the DR-Pay protocol: the 4-message payment flow, agent identity, service manifests, and on-chain data encoding.
+
+Every payment settles on-chain as a standard DigiByte transaction. No sidechains, no Layer 2, no API keys.
+
+## Install
+
+```bash
+pip install digirails
+```
+
+## Quick Start
+
+### Buyer — purchase a service in one call
+
+```python
+import asyncio
+from digirails import Agent, REGTEST
+
+async def main():
+    async with Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    ) as buyer:
+        result = await buyer.request_service(
+            seller_url="http://127.0.0.1:9001",
+            service_id="echo",
+            params={"message": "Hello from DigiRails!"},
+            max_amount="0.01",
+        )
+        print(result.result)
+
+asyncio.run(main())
+```
+
+### Seller — offer a service
+
+```python
+import asyncio
+from digirails import Agent, ServiceCategory, REGTEST
+
+def handle_echo(params: dict) -> dict:
+    return {"echo": params.get("message", "")}
+
+async def main():
+    seller = Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    )
+    seller.register_service(
+        service_id="echo",
+        handler=handle_echo,
+        price="0.001",
+        category=ServiceCategory.GENERAL_COMPUTE,
+    )
+    await seller.serve(port=9001)
+    await asyncio.Event().wait()  # Run forever
+
+asyncio.run(main())
+```
+
+## What happens under the hood
+
+```
+Buyer                                Seller
+  |                                    |
+  |  GET /.well-known/digirails.json   |
+  |----------------------------------->|  1. Discover manifest
+  |<-----------------------------------|
+  |                                    |
+  |  POST /drpay/request               |
+  |----------------------------------->|  2. SERVICE_REQUEST
+  |<-----------------------------------|  3. PAYMENT_INVOICE
+  |                                    |
+  |  [build, sign, broadcast tx]       |
+  |                                    |
+  |  POST /drpay/broadcast             |
+  |----------------------------------->|  4. PAYMENT_BROADCAST
+  |                                    |  5. Verify payment
+  |                                    |  6. Execute service
+  |<-----------------------------------|  7. SERVICE_DELIVERY
+```
+
+## Regtest Demo
+
+Run the self-contained demo with two agents transacting locally:
+
+```bash
+# 1. Start DigiByte Core in regtest mode
+digibyted -regtest -daemon -server \
+  -rpcuser=digirails -rpcpassword=digirails \
+  -txindex=1 -fallbackfee=0.0001
+
+# 2. Run the demo
+python examples/regtest_demo.py
+```
+
+## Features
+
+- **Light mode**: No DigiByte node required. Connects to `rpc.digirails.org` or any RPC endpoint.
+- **Async-native**: Built on asyncio + aiohttp.
+- **Type-safe**: Pydantic models for all protocol messages.
+- **4 dependencies**: pydantic, aiohttp, cryptography, ecdsa. All with pre-built wheels.
+- **SegWit transactions**: BIP-143 signing for P2WPKH inputs.
+- **Encrypted keystore**: AES-256-GCM encrypted key files.
+- **All 18 service categories** from the DR-Pay spec.
+
+## Protocol Version
+
+Implements DR-Pay specification v0.3.0.
+
+## License
+
+MIT

digirails-0.1.0/examples/cross_sdk_buyer.py

@@ -0,0 +1,62 @@
+"""Cross-SDK test: Python buyer paying a Node.js seller.
+
+Prerequisites:
+    1. DGB Core regtest running with a legacy wallet
+    2. Node.js seller running: npx tsx examples/cross_sdk_seller.ts
+       (from the digirails-node directory)
+
+Usage:
+    python cross_sdk_buyer.py
+"""
+
+import asyncio
+from digirails import Agent, REGTEST
+
+
+async def main():
+    rpc_url = "http://digirails:digirails@127.0.0.1:18443"
+
+    buyer = Agent.generate(network=REGTEST, rpc_url=rpc_url)
+    print(f"PYTHON BUYER address: {buyer.address}")
+
+    # Fund buyer
+    await buyer.rpc.importaddress(buyer.address, "buyer", False)
+    await buyer.rpc.generatetoaddress(101, buyer.address)
+    balance = await buyer.balance()
+    print(f"Buyer funded: {balance} DGB")
+    print()
+
+    # Discover Node.js seller manifest
+    manifest = await buyer.discover("http://127.0.0.1:9003")
+    if manifest:
+        print(f"Discovered seller: {manifest.agent}")
+        print(f"  Services: {[s.id for s in manifest.services]}")
+    else:
+        print("ERROR: Could not discover seller manifest!")
+        await buyer.close()
+        return
+
+    print()
+    print("=== Cross-SDK Payment Flow (Python buyer -> Node.js seller) ===")
+
+    result = await buyer.request_service(
+        seller_url="http://127.0.0.1:9003",
+        service_id="echo",
+        params={"message": "Hello from Python to Node.js!"},
+        max_amount="0.01",
+    )
+
+    print(f"Result: {result.result}")
+    print(f"Status: {result.status}")
+    print()
+
+    if result.result and result.result.get("cross_sdk"):
+        print("=== CROSS-SDK INTEROP TEST PASSED ===")
+    else:
+        print("=== CROSS-SDK TEST FAILED ===")
+
+    await buyer.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

digirails-0.1.0/examples/quickstart_buyer.py

@@ -0,0 +1,36 @@
+"""Buy a service from a DigiRails agent.
+
+Usage:
+    python quickstart_buyer.py
+
+Requires a seller running at http://127.0.0.1:9001.
+"""
+
+import asyncio
+
+from digirails import Agent, REGTEST
+
+
+async def main():
+    async with Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    ) as buyer:
+        print(f"Buyer address: {buyer.address}")
+
+        # Fund the buyer (regtest only: mine 101 blocks for coinbase maturity)
+        await buyer.rpc.generatetoaddress(101, buyer.address)
+        print(f"Balance: {await buyer.balance()} DGB")
+
+        # Buy a service — one line!
+        result = await buyer.request_service(
+            seller_url="http://127.0.0.1:9001",
+            service_id="echo",
+            params={"message": "Hello from DigiRails!"},
+            max_amount="0.01",
+        )
+        print(f"Service delivered: {result.result}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

digirails-0.1.0/examples/quickstart_seller.py

@@ -0,0 +1,47 @@
+"""Sell a service via DigiRails.
+
+Usage:
+    python quickstart_seller.py
+
+Starts a server on port 9001 that other agents can buy from.
+"""
+
+import asyncio
+
+from digirails import Agent, ServiceCategory, REGTEST
+
+
+def handle_echo(params: dict) -> dict:
+    """Simple echo service handler."""
+    return {"echo": params.get("message", "No message provided")}
+
+
+async def main():
+    seller = Agent.generate(
+        network=REGTEST,
+        rpc_url="http://digirails:digirails@127.0.0.1:18443",
+    )
+    print(f"Seller address: {seller.address}")
+
+    seller.register_service(
+        service_id="echo",
+        handler=handle_echo,
+        price="0.001",
+        description="Simple echo service — returns your message back",
+        category=ServiceCategory.GENERAL_COMPUTE,
+    )
+
+    print("Starting server on http://0.0.0.0:9001")
+    print("Other agents can now buy the 'echo' service.")
+    await seller.serve(port=9001)
+
+    # Keep running
+    try:
+        while True:
+            await asyncio.sleep(3600)
+    except KeyboardInterrupt:
+        await seller.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

digirails-0.1.0/examples/regtest_demo.py

@@ -0,0 +1,86 @@
+"""Self-contained regtest demo: two agents transact.
+
+Prerequisites:
+    1. DigiByte Core running in regtest mode:
+       digibyted -regtest -daemon -server -rpcuser=digirails -rpcpassword=digirails -txindex=1 -fallbackfee=0.0001
+
+    2. Install the SDK:
+       pip install digirails
+
+Usage:
+    python regtest_demo.py
+"""
+
+import asyncio
+
+from digirails import Agent, ServiceCategory, REGTEST
+
+
+def handle_echo(params: dict) -> dict:
+    """Echo service: returns the input message."""
+    return {"echo": params.get("message", "(empty)"), "processed_by": "digirails-demo-seller"}
+
+
+async def main():
+    rpc_url = "http://digirails:digirails@127.0.0.1:18443"
+
+    # --- Create agents ---
+    seller = Agent.generate(network=REGTEST, rpc_url=rpc_url)
+    buyer = Agent.generate(network=REGTEST, rpc_url=rpc_url)
+
+    print(f"Seller address: {seller.address}")
+    print(f"Buyer  address: {buyer.address}")
+    print()
+
+    # --- Register a service on the seller ---
+    seller.register_service(
+        service_id="echo",
+        handler=handle_echo,
+        price="0.001",
+        description="Echo service",
+        category=ServiceCategory.GENERAL_COMPUTE,
+    )
+
+    # Start seller HTTP server in background
+    await seller.serve(host="127.0.0.1", port=9001)
+    print("Seller server running on http://127.0.0.1:9001")
+
+    # --- Fund the buyer ---
+    # Import buyer's address so listunspent can find coinbase outputs
+    await buyer.rpc.importaddress(buyer.address, "buyer", False)
+    # Mine 101 blocks to buyer's address (coinbase maturity = 100)
+    await buyer.rpc.generatetoaddress(101, buyer.address)
+    balance = await buyer.balance()
+    print(f"Buyer funded: {balance} DGB")
+    print()
+
+    # --- Execute the payment flow ---
+    print("=== Payment Flow ===")
+    print("1. Buyer discovers seller manifest...")
+    print("2. Buyer sends SERVICE_REQUEST...")
+    print("3. Seller returns PAYMENT_INVOICE...")
+    print("4. Buyer builds, signs, broadcasts TX...")
+    print("5. Buyer sends PAYMENT_BROADCAST...")
+    print("6. Seller verifies payment, executes service...")
+    print("7. Seller returns SERVICE_DELIVERY...")
+    print()
+
+    result = await buyer.request_service(
+        seller_url="http://127.0.0.1:9001",
+        service_id="echo",
+        params={"message": "Hello from DigiRails!"},
+        max_amount="0.01",
+    )
+
+    print(f"Result: {result.result}")
+    print(f"Status: {result.status}")
+    print()
+    print("=== Demo Complete ===")
+
+    # Cleanup
+    await seller.close()
+    await buyer.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

digirails-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "digirails"
+version = "0.1.0"
+description = "Python SDK for the DR-Pay protocol — AI agent payments on DigiByte"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "DigiRails Protocol" }]
+keywords = ["digibyte", "payments", "ai-agents", "blockchain", "cryptocurrency"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: AsyncIO",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pydantic>=2.0",
+    "aiohttp>=3.9",
+    "cryptography>=42.0",
+    "ecdsa>=0.19",
+]
+
+[project.optional-dependencies]
+fast = ["coincurve>=20.0"]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov",
+    "aioresponses",
+    "ruff",
+    "mypy",
+]
+
+[project.urls]
+Homepage = "https://github.com/digirails-protocol/digirails-python"
+Repository = "https://github.com/digirails-protocol/digirails-python"
+Specification = "https://github.com/digirails-protocol/digirails-spec"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/digirails"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

digirails-0.1.0/src/digirails/__init__.py

@@ -0,0 +1,39 @@
+"""DigiRails — Python SDK for the DR-Pay protocol."""
+
+from digirails._version import __version__
+from digirails.agent import Agent
+from digirails.config import DigiRailsConfig
+from digirails.models.enums import ConfirmationTier, ErrorCode, ServiceCategory
+from digirails.models.manifest import Manifest, Service
+from digirails.models.messages import (
+    ErrorResponse,
+    PaymentBroadcast,
+    PaymentInvoice,
+    PaymentRequest,
+    RefundInfo,
+    ServiceDelivery,
+)
+from digirails.network.params import MAINNET, REGTEST, TESTNET, NetworkParams
+from digirails.wallet.wallet import Wallet
+
+__all__ = [
+    "__version__",
+    "Agent",
+    "DigiRailsConfig",
+    "Wallet",
+    "Manifest",
+    "Service",
+    "PaymentRequest",
+    "PaymentInvoice",
+    "PaymentBroadcast",
+    "ServiceDelivery",
+    "ErrorResponse",
+    "RefundInfo",
+    "ConfirmationTier",
+    "ServiceCategory",
+    "ErrorCode",
+    "NetworkParams",
+    "MAINNET",
+    "TESTNET",
+    "REGTEST",
+]