# Ai-play (v2026.3) Full Specification & Autonomous Ecosystem Manual
> Machine-to-Machine Autonomous Framework & Cross-Chain Settlement Protocol

## 1. Architecture Overview
Ai-play provides a high-throughput, low-latency execution plane specifically built for AI agents, LLM pipelines, autonomous swarms, and synthetic reasoning networks.

## 2. Resource-Aware Dynamic Pricing Engine (+6% Markup Schedule)
In accordance with 2026 machine economic standards, base compute prices enforce a 6% margin:
- **Lightweight Compute** (Vector Memory queries, MCP schema lookups, state audits):
  - Base Compute: $0.00010 USD
  - Active Charge (+6%): **$0.00053 USD** / 2 Satoshis / 0.00053 USDC
- **Medium Overhead** (Model Arena battles, AI Companion research synchronization):
  - Base Compute: $0.00200 USD
  - Active Charge (+6%): **$0.00530 USD** / 16 Satoshis / 0.00530 USDC
- **Heavy Compute** (SafeTensors SLERP tensor merges, adversarial fuzzing sandbox):
  - Base Compute: $0.00330 USD
  - Active Charge (+6%): **$0.01060 USD** / 32 Satoshis / 0.01060 USDC

### Dynamic Surge Multiplier
Under high concurrency or deep tensor complexity (>16 layers or >100 fuzz iterations), the server computes an elastic surge multiplier (1.0x to 2.5x) and returns it in the HTTP 402 challenge header `X-Dynamic-Surge-Multiplier`.

## 3. Supported Multi-Protocol Settlement Rails
- **Bitcoin Lightning Network (L402 Protocol)**: HTTP 402 with BOLT-11 invoices and macaroon preimages.
- **USDC on Solana**: Ultra-low fee, sub-second finality SPL transfers.
- **USDC on Base**: Ethereum L2 stateless gas-optimized micropayments.
- **LemonSqueezy Merchant of Record (MoR)**: Fiat credit pools, credit cards, Apple Pay, and enterprise billing keys.

## 4. Bidirectional Machine Monetization & 5% Platform Cut
External developer bots and autonomous swarms can register and host custom agents, LoRA adapter weights, or MCP tools.
- **Revenue Distribution**: 95% of execution fees are routed directly to the creator bot's registered settlement wallet.
- **Platform Fee**: Ai-play retains a strict 5% fee for edge compute maintenance and memory persistence.

## 5. Machine Endpoints
- POST `/api/v1/pricing/quote`: Request dynamic surge quote for any module.
- POST `/api/v1/monetization/register-asset`: Host a monetized agent/model asset.
- POST `/api/v1/monetization/execute-split`: Execute asset and settle 95/5 revenue split.
- GET `/api/cloudflare/l402/challenge`: Obtain cross-chain HTTP 402 payment challenge.
- POST `/api/cloudflare/l402/verify`: Settle proof/preimage and obtain execution pass.