aimarket-channels 2.0.0__tar.gz

aimarket_channels-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI-Factory Project 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.

aimarket_channels-2.0.0/PKG-INFO

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: aimarket-channels
+Version: 2.0.0
+Summary: Pre-funded payment channels — off-chain ledger, on-chain settlement
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aimarket-hub>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# aimarket-channels
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User guide](docs/user-guide.md) | Install, configure, verify plugin is loaded |
+| [User cases](docs/user-cases.md) | Personas and cross-plugin workflows |
+| [SDK integration](docs/sdk-integration.md) | Code examples and hook behavior |
+
+---
+
+**Pre-funded payment channels for off-chain capability invocation.**
+Open a channel with one on-chain deposit, invoke multiple capabilities off-chain, settle once. Reduces per-call blockchain transactions from N to 1.
+
+---
+
+## When to Use
+
+| Scenario | Why this plugin |
+|----------|----------------|
+| Multi-step AI workflows (translate → review → summarize) | One deposit, 3 invocations, 1 settlement — not 3 separate on-chain transactions |
+| High-frequency invocation (100+ calls/hour) | Per-call on-chain TX would cost more in gas than the capability itself |
+| Agent-to-agent orchestration | External AI agents open a channel and run autonomous multi-step plans |
+| Consumer with fixed budget | Pre-fund $5.00, let the orchestrator spend up to that, get refund of remainder |
+| Demo/staging without real on-chain TX | Accept `demo-*` tx hashes for development (configurable) |
+
+---
+
+## Installation
+
+```bash
+pip install aimarket-channels
+```
+
+No configuration required — channels work immediately. Verify:
+
+```bash
+curl -X POST http://localhost:9083/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{"deposit_usd": 3.00}' | jq '.channel.channel_id'
+```
+
+---
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/ai-market/v2/channel/open` | Open a pre-funded payment channel |
+| `POST` | `/ai-market/v2/channel/close` | Close channel, compute settlement, refund remainder |
+
+### Open Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{
+    "deposit_usd": 3.00,
+    "token": "USDT",
+    "chain": "base",
+    "wallet": "0x...",
+    "tx_hash": "0xabc123..."
+  }'
+```
+
+Response:
+```json
+{
+  "channel": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "balance_usd": 3.00,
+    "original_deposit_usd": 3.00,
+    "used_usd": 0.00,
+    "token": "USDT",
+    "chain": "base",
+    "status": "open",
+    "opened_at": "2026-05-22T12:00:00Z",
+    "expires_at": "2026-05-23T12:00:00Z"
+  }
+}
+```
+
+### Close Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/close \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "settle_tx_hash": "0xsettle..."
+  }'
+```
+
+Response:
+```json
+{
+  "settlement": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "used_usd": 1.60,
+    "refund_usd": 1.40,
+    "original_deposit_usd": 3.00,
+    "status": "settled"
+  }
+}
+```
+
+---
+
+## End-to-End Example
+
+```python
+import requests
+
+HUB = "https://modelmarket.dev"
+
+# 1. Open channel — one on-chain TX
+ch = requests.post(f"{HUB}/ai-market/v2/channel/open", json={
+    "deposit_usd": 3.00, "tx_hash": "0x_on_chain_deposit"
+}).json()
+ch_id = ch["channel"]["channel_id"]
+print(f"Channel: {ch_id}, balance: $3.00")
+
+# 2. Invoke multiple capabilities — all off-chain
+headers = {"X-Payment-Channel": ch_id}
+plan = [
+    ("prod-translate", "translate.multi@v2", {"text": "Hello world", "locales": ["ru", "fr"]}),
+    ("prod-legal", "legal.review@v1", {"documents": {"main": "..."}}),
+    ("prod-summarize", "summarize@v1", {"text": "..."}),
+]
+
+total = 0.0
+for pid, cid, inp in plan:
+    r = requests.post(f"{HUB}/ai-market/v2/invoke", json={
+        "product_id": pid, "capability_id": cid,
+        "source_hub": "local", "input": inp
+    }, headers=headers)
+    result = r.json()
+    total += result.get("price_usd", 0)
+    print(f"  {cid}: ${result.get('price_usd', 0):.2f} {'OK' if result.get('success') else 'FAIL'}")
+
+# 3. Close channel — one on-chain TX
+settle = requests.post(f"{HUB}/ai-market/v2/channel/close", json={
+    "channel_id": ch_id, "settle_tx_hash": "0x_on_chain_settlement"
+}).json()
+
+print(f"Used: ${settle['settlement']['used_usd']:.2f}")
+print(f"Refund: ${settle['settlement']['refund_usd']:.2f}")
+print(f"Saved {(len(plan) - 1)} on-chain transactions")
+```
+
+---
+
+## Channel Lifecycle
+
+```
+OPEN (on-chain deposit)
+  │
+  ├── INVOKE (off-chain debit) ──┐
+  ├── INVOKE (off-chain debit) ──┤  N invocations
+  ├── INVOKE (off-chain debit) ──┘
+  │
+  ├── SAFETY ABORT → auto-refund to channel
+  │
+CLOSE (on-chain settlement)
+  → used_usd sent to providers
+  → refund_usd returned to consumer
+```
+
+**Properties:**
+- **24h auto-expiry** — channels close automatically after 24 hours
+- **Atomic safety refund** — blocked invocations refund to channel immediately
+- **Single-writer ledger** — no double-spend possible (hub is sole writer)
+- **Demo mode** — `demo-*` tx hashes accepted for development (configurable)
+
+---
+
+## Configuration
+
+| Env Variable | Default | Description |
+|-------------|---------|-------------|
+| `AIMARKET_CHANNEL_MAX_DEPOSIT` | `10000` | Maximum deposit in USD |
+| `AIMARKET_CHANNEL_EXPIRY_HOURS` | `24` | Channel auto-expiry time |
+| `AIFACTORY_PAYMENT_VERIFY_STUB` | `1` | Accept `demo-*` tx hashes (dev) |
+
+---
+
+## Recommended Deployment
+
+| Environment | Recommendation |
+|-------------|---------------|
+| Development | Stub verification on, demo tx hashes accepted |
+| Staging | Testnet RPC (Base Sepolia), real tx verification |
+| Production | Mainnet RPC, real on-chain deposits required |
+
+**Combine with:**
+- `aimarket-safety` — safety blocks auto-refund to channel
+- `aimarket-orchestrator` — orchestrator opens one channel per task, runs multi-step plan
+- `aimarket-streaming` — per-chunk billing debits the channel incrementally
+
+---
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Channel open latency | < 5ms (in-memory ledger) |
+| Debit latency | < 1ms |
+| Close + settlement computation | < 2ms |
+| Concurrent channels | Unlimited (in-memory, single-process) |
+| Production upgrade path | Replace `ChannelLedger` with PostgreSQL for multi-process |
+
+---
+
+## Security Considerations
+
+- **No custody** — the protocol never holds funds. Channels are simulated constructs for the reference implementation. Production uses on-chain escrow contracts
+- **Sequential ledger** — single-writer (hub process), no double-spend vector
+- **Nonce replay protection** — each channel is bound to a single session
+- **Demo tx hashes must be disabled in production** — set `AIFACTORY_PAYMENT_VERIFY_STUB=0`
+
+---
+
+## License
+
+MIT · Maintained by AI-Factory · [GitHub](https://github.com/ai-factory/aimarket-channels)

aimarket_channels-2.0.0/README.md

@@ -0,0 +1,226 @@
+# aimarket-channels
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User guide](docs/user-guide.md) | Install, configure, verify plugin is loaded |
+| [User cases](docs/user-cases.md) | Personas and cross-plugin workflows |
+| [SDK integration](docs/sdk-integration.md) | Code examples and hook behavior |
+
+---
+
+**Pre-funded payment channels for off-chain capability invocation.**
+Open a channel with one on-chain deposit, invoke multiple capabilities off-chain, settle once. Reduces per-call blockchain transactions from N to 1.
+
+---
+
+## When to Use
+
+| Scenario | Why this plugin |
+|----------|----------------|
+| Multi-step AI workflows (translate → review → summarize) | One deposit, 3 invocations, 1 settlement — not 3 separate on-chain transactions |
+| High-frequency invocation (100+ calls/hour) | Per-call on-chain TX would cost more in gas than the capability itself |
+| Agent-to-agent orchestration | External AI agents open a channel and run autonomous multi-step plans |
+| Consumer with fixed budget | Pre-fund $5.00, let the orchestrator spend up to that, get refund of remainder |
+| Demo/staging without real on-chain TX | Accept `demo-*` tx hashes for development (configurable) |
+
+---
+
+## Installation
+
+```bash
+pip install aimarket-channels
+```
+
+No configuration required — channels work immediately. Verify:
+
+```bash
+curl -X POST http://localhost:9083/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{"deposit_usd": 3.00}' | jq '.channel.channel_id'
+```
+
+---
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/ai-market/v2/channel/open` | Open a pre-funded payment channel |
+| `POST` | `/ai-market/v2/channel/close` | Close channel, compute settlement, refund remainder |
+
+### Open Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{
+    "deposit_usd": 3.00,
+    "token": "USDT",
+    "chain": "base",
+    "wallet": "0x...",
+    "tx_hash": "0xabc123..."
+  }'
+```
+
+Response:
+```json
+{
+  "channel": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "balance_usd": 3.00,
+    "original_deposit_usd": 3.00,
+    "used_usd": 0.00,
+    "token": "USDT",
+    "chain": "base",
+    "status": "open",
+    "opened_at": "2026-05-22T12:00:00Z",
+    "expires_at": "2026-05-23T12:00:00Z"
+  }
+}
+```
+
+### Close Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/close \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "settle_tx_hash": "0xsettle..."
+  }'
+```
+
+Response:
+```json
+{
+  "settlement": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "used_usd": 1.60,
+    "refund_usd": 1.40,
+    "original_deposit_usd": 3.00,
+    "status": "settled"
+  }
+}
+```
+
+---
+
+## End-to-End Example
+
+```python
+import requests
+
+HUB = "https://modelmarket.dev"
+
+# 1. Open channel — one on-chain TX
+ch = requests.post(f"{HUB}/ai-market/v2/channel/open", json={
+    "deposit_usd": 3.00, "tx_hash": "0x_on_chain_deposit"
+}).json()
+ch_id = ch["channel"]["channel_id"]
+print(f"Channel: {ch_id}, balance: $3.00")
+
+# 2. Invoke multiple capabilities — all off-chain
+headers = {"X-Payment-Channel": ch_id}
+plan = [
+    ("prod-translate", "translate.multi@v2", {"text": "Hello world", "locales": ["ru", "fr"]}),
+    ("prod-legal", "legal.review@v1", {"documents": {"main": "..."}}),
+    ("prod-summarize", "summarize@v1", {"text": "..."}),
+]
+
+total = 0.0
+for pid, cid, inp in plan:
+    r = requests.post(f"{HUB}/ai-market/v2/invoke", json={
+        "product_id": pid, "capability_id": cid,
+        "source_hub": "local", "input": inp
+    }, headers=headers)
+    result = r.json()
+    total += result.get("price_usd", 0)
+    print(f"  {cid}: ${result.get('price_usd', 0):.2f} {'OK' if result.get('success') else 'FAIL'}")
+
+# 3. Close channel — one on-chain TX
+settle = requests.post(f"{HUB}/ai-market/v2/channel/close", json={
+    "channel_id": ch_id, "settle_tx_hash": "0x_on_chain_settlement"
+}).json()
+
+print(f"Used: ${settle['settlement']['used_usd']:.2f}")
+print(f"Refund: ${settle['settlement']['refund_usd']:.2f}")
+print(f"Saved {(len(plan) - 1)} on-chain transactions")
+```
+
+---
+
+## Channel Lifecycle
+
+```
+OPEN (on-chain deposit)
+  │
+  ├── INVOKE (off-chain debit) ──┐
+  ├── INVOKE (off-chain debit) ──┤  N invocations
+  ├── INVOKE (off-chain debit) ──┘
+  │
+  ├── SAFETY ABORT → auto-refund to channel
+  │
+CLOSE (on-chain settlement)
+  → used_usd sent to providers
+  → refund_usd returned to consumer
+```
+
+**Properties:**
+- **24h auto-expiry** — channels close automatically after 24 hours
+- **Atomic safety refund** — blocked invocations refund to channel immediately
+- **Single-writer ledger** — no double-spend possible (hub is sole writer)
+- **Demo mode** — `demo-*` tx hashes accepted for development (configurable)
+
+---
+
+## Configuration
+
+| Env Variable | Default | Description |
+|-------------|---------|-------------|
+| `AIMARKET_CHANNEL_MAX_DEPOSIT` | `10000` | Maximum deposit in USD |
+| `AIMARKET_CHANNEL_EXPIRY_HOURS` | `24` | Channel auto-expiry time |
+| `AIFACTORY_PAYMENT_VERIFY_STUB` | `1` | Accept `demo-*` tx hashes (dev) |
+
+---
+
+## Recommended Deployment
+
+| Environment | Recommendation |
+|-------------|---------------|
+| Development | Stub verification on, demo tx hashes accepted |
+| Staging | Testnet RPC (Base Sepolia), real tx verification |
+| Production | Mainnet RPC, real on-chain deposits required |
+
+**Combine with:**
+- `aimarket-safety` — safety blocks auto-refund to channel
+- `aimarket-orchestrator` — orchestrator opens one channel per task, runs multi-step plan
+- `aimarket-streaming` — per-chunk billing debits the channel incrementally
+
+---
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Channel open latency | < 5ms (in-memory ledger) |
+| Debit latency | < 1ms |
+| Close + settlement computation | < 2ms |
+| Concurrent channels | Unlimited (in-memory, single-process) |
+| Production upgrade path | Replace `ChannelLedger` with PostgreSQL for multi-process |
+
+---
+
+## Security Considerations
+
+- **No custody** — the protocol never holds funds. Channels are simulated constructs for the reference implementation. Production uses on-chain escrow contracts
+- **Sequential ledger** — single-writer (hub process), no double-spend vector
+- **Nonce replay protection** — each channel is bound to a single session
+- **Demo tx hashes must be disabled in production** — set `AIFACTORY_PAYMENT_VERIFY_STUB=0`
+
+---
+
+## License
+
+MIT · Maintained by AI-Factory · [GitHub](https://github.com/ai-factory/aimarket-channels)

aimarket_channels-2.0.0/aimarket_channels/__init__.py

@@ -0,0 +1 @@
+# aimarket-channels plugin

aimarket_channels-2.0.0/aimarket_channels/channels.py

@@ -0,0 +1,8 @@
+"""Channels — re-export shim from aimarket_hub.channels (canonical).
+
+The hub-core module (SQLite-backed, integer cents, rate limiting, background
+sweep) is the single source of truth. This plugin-level module is kept as a
+re-export shim for the plugin entry_point manifest.
+"""
+
+from aimarket_hub.channels import *  # noqa: F401, F403

aimarket_channels-2.0.0/aimarket_channels/plugin.py

@@ -0,0 +1,25 @@
+"""channels plugin — payment channel infrastructure."""
+
+from aimarket_hub.plugin import HubPlugin
+
+
+class ChannelsPlugin(HubPlugin):
+    name = "aimarket-channels"
+    version = "2.0.0"
+    description = "Pre-funded payment channels — off-chain ledger, on-chain settlement"
+    homepage = "https://github.com/ai-factory/aimarket-channels"
+    category = "infrastructure"
+
+    def get_manifest_extension(self):
+        return {
+            "channels": {
+                "enabled": True,
+                "endpoints": {
+                    "open": "/ai-market/v2/channel/open",
+                    "close": "/ai-market/v2/channel/close",
+                },
+                "max_deposit_usd": 10_000,
+                "expiry_hours": 24,
+                "demo_mode": True,
+            }
+        }

aimarket_channels-2.0.0/aimarket_channels.egg-info/PKG-INFO

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: aimarket-channels
+Version: 2.0.0
+Summary: Pre-funded payment channels — off-chain ledger, on-chain settlement
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aimarket-hub>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# aimarket-channels
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User guide](docs/user-guide.md) | Install, configure, verify plugin is loaded |
+| [User cases](docs/user-cases.md) | Personas and cross-plugin workflows |
+| [SDK integration](docs/sdk-integration.md) | Code examples and hook behavior |
+
+---
+
+**Pre-funded payment channels for off-chain capability invocation.**
+Open a channel with one on-chain deposit, invoke multiple capabilities off-chain, settle once. Reduces per-call blockchain transactions from N to 1.
+
+---
+
+## When to Use
+
+| Scenario | Why this plugin |
+|----------|----------------|
+| Multi-step AI workflows (translate → review → summarize) | One deposit, 3 invocations, 1 settlement — not 3 separate on-chain transactions |
+| High-frequency invocation (100+ calls/hour) | Per-call on-chain TX would cost more in gas than the capability itself |
+| Agent-to-agent orchestration | External AI agents open a channel and run autonomous multi-step plans |
+| Consumer with fixed budget | Pre-fund $5.00, let the orchestrator spend up to that, get refund of remainder |
+| Demo/staging without real on-chain TX | Accept `demo-*` tx hashes for development (configurable) |
+
+---
+
+## Installation
+
+```bash
+pip install aimarket-channels
+```
+
+No configuration required — channels work immediately. Verify:
+
+```bash
+curl -X POST http://localhost:9083/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{"deposit_usd": 3.00}' | jq '.channel.channel_id'
+```
+
+---
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/ai-market/v2/channel/open` | Open a pre-funded payment channel |
+| `POST` | `/ai-market/v2/channel/close` | Close channel, compute settlement, refund remainder |
+
+### Open Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/open \
+  -H "Content-Type: application/json" \
+  -d '{
+    "deposit_usd": 3.00,
+    "token": "USDT",
+    "chain": "base",
+    "wallet": "0x...",
+    "tx_hash": "0xabc123..."
+  }'
+```
+
+Response:
+```json
+{
+  "channel": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "balance_usd": 3.00,
+    "original_deposit_usd": 3.00,
+    "used_usd": 0.00,
+    "token": "USDT",
+    "chain": "base",
+    "status": "open",
+    "opened_at": "2026-05-22T12:00:00Z",
+    "expires_at": "2026-05-23T12:00:00Z"
+  }
+}
+```
+
+### Close Channel
+
+```bash
+curl -X POST https://modelmarket.dev/ai-market/v2/channel/close \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "settle_tx_hash": "0xsettle..."
+  }'
+```
+
+Response:
+```json
+{
+  "settlement": {
+    "channel_id": "ch_a8f3b2c1d4e5",
+    "used_usd": 1.60,
+    "refund_usd": 1.40,
+    "original_deposit_usd": 3.00,
+    "status": "settled"
+  }
+}
+```
+
+---
+
+## End-to-End Example
+
+```python
+import requests
+
+HUB = "https://modelmarket.dev"
+
+# 1. Open channel — one on-chain TX
+ch = requests.post(f"{HUB}/ai-market/v2/channel/open", json={
+    "deposit_usd": 3.00, "tx_hash": "0x_on_chain_deposit"
+}).json()
+ch_id = ch["channel"]["channel_id"]
+print(f"Channel: {ch_id}, balance: $3.00")
+
+# 2. Invoke multiple capabilities — all off-chain
+headers = {"X-Payment-Channel": ch_id}
+plan = [
+    ("prod-translate", "translate.multi@v2", {"text": "Hello world", "locales": ["ru", "fr"]}),
+    ("prod-legal", "legal.review@v1", {"documents": {"main": "..."}}),
+    ("prod-summarize", "summarize@v1", {"text": "..."}),
+]
+
+total = 0.0
+for pid, cid, inp in plan:
+    r = requests.post(f"{HUB}/ai-market/v2/invoke", json={
+        "product_id": pid, "capability_id": cid,
+        "source_hub": "local", "input": inp
+    }, headers=headers)
+    result = r.json()
+    total += result.get("price_usd", 0)
+    print(f"  {cid}: ${result.get('price_usd', 0):.2f} {'OK' if result.get('success') else 'FAIL'}")
+
+# 3. Close channel — one on-chain TX
+settle = requests.post(f"{HUB}/ai-market/v2/channel/close", json={
+    "channel_id": ch_id, "settle_tx_hash": "0x_on_chain_settlement"
+}).json()
+
+print(f"Used: ${settle['settlement']['used_usd']:.2f}")
+print(f"Refund: ${settle['settlement']['refund_usd']:.2f}")
+print(f"Saved {(len(plan) - 1)} on-chain transactions")
+```
+
+---
+
+## Channel Lifecycle
+
+```
+OPEN (on-chain deposit)
+  │
+  ├── INVOKE (off-chain debit) ──┐
+  ├── INVOKE (off-chain debit) ──┤  N invocations
+  ├── INVOKE (off-chain debit) ──┘
+  │
+  ├── SAFETY ABORT → auto-refund to channel
+  │
+CLOSE (on-chain settlement)
+  → used_usd sent to providers
+  → refund_usd returned to consumer
+```
+
+**Properties:**
+- **24h auto-expiry** — channels close automatically after 24 hours
+- **Atomic safety refund** — blocked invocations refund to channel immediately
+- **Single-writer ledger** — no double-spend possible (hub is sole writer)
+- **Demo mode** — `demo-*` tx hashes accepted for development (configurable)
+
+---
+
+## Configuration
+
+| Env Variable | Default | Description |
+|-------------|---------|-------------|
+| `AIMARKET_CHANNEL_MAX_DEPOSIT` | `10000` | Maximum deposit in USD |
+| `AIMARKET_CHANNEL_EXPIRY_HOURS` | `24` | Channel auto-expiry time |
+| `AIFACTORY_PAYMENT_VERIFY_STUB` | `1` | Accept `demo-*` tx hashes (dev) |
+
+---
+
+## Recommended Deployment
+
+| Environment | Recommendation |
+|-------------|---------------|
+| Development | Stub verification on, demo tx hashes accepted |
+| Staging | Testnet RPC (Base Sepolia), real tx verification |
+| Production | Mainnet RPC, real on-chain deposits required |
+
+**Combine with:**
+- `aimarket-safety` — safety blocks auto-refund to channel
+- `aimarket-orchestrator` — orchestrator opens one channel per task, runs multi-step plan
+- `aimarket-streaming` — per-chunk billing debits the channel incrementally
+
+---
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Channel open latency | < 5ms (in-memory ledger) |
+| Debit latency | < 1ms |
+| Close + settlement computation | < 2ms |
+| Concurrent channels | Unlimited (in-memory, single-process) |
+| Production upgrade path | Replace `ChannelLedger` with PostgreSQL for multi-process |
+
+---
+
+## Security Considerations
+
+- **No custody** — the protocol never holds funds. Channels are simulated constructs for the reference implementation. Production uses on-chain escrow contracts
+- **Sequential ledger** — single-writer (hub process), no double-spend vector
+- **Nonce replay protection** — each channel is bound to a single session
+- **Demo tx hashes must be disabled in production** — set `AIFACTORY_PAYMENT_VERIFY_STUB=0`
+
+---
+
+## License
+
+MIT · Maintained by AI-Factory · [GitHub](https://github.com/ai-factory/aimarket-channels)

aimarket_channels-2.0.0/aimarket_channels.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+aimarket_channels/__init__.py
+aimarket_channels/channels.py
+aimarket_channels/plugin.py
+aimarket_channels.egg-info/PKG-INFO
+aimarket_channels.egg-info/SOURCES.txt
+aimarket_channels.egg-info/dependency_links.txt
+aimarket_channels.egg-info/entry_points.txt
+aimarket_channels.egg-info/requires.txt
+aimarket_channels.egg-info/top_level.txt

aimarket_channels-2.0.0/aimarket_channels.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aimarket_channels-2.0.0/aimarket_channels.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[aimarket.plugins]
+channels = aimarket_channels.plugin:ChannelsPlugin

aimarket_channels-2.0.0/aimarket_channels.egg-info/requires.txt

@@ -0,0 +1,4 @@
+aimarket-hub>=3.0.0
+
+[dev]
+pytest>=8

aimarket_channels-2.0.0/aimarket_channels.egg-info/top_level.txt

@@ -0,0 +1 @@
+aimarket_channels

aimarket_channels-2.0.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aimarket-channels"
+version = "2.0.0"
+description = "Pre-funded payment channels — off-chain ledger, on-chain settlement"
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["aimarket-hub>=3.0.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.entry-points."aimarket.plugins"]
+channels = "aimarket_channels.plugin:ChannelsPlugin"
+
+[tool.setuptools.packages.find]
+include = ["aimarket_channels*"]

aimarket_channels-2.0.0/setup.cfg

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