# 🪐 NWO Mixed Reality — Agent Skill File

**Version**: v5.2.0  ·  **Format**: Markdown + JSON, machine-readable
**Canonical URL**: https://nwo-blaster.ciprianpater.workers.dev/agent.md
**Companion (NWO Robotics)**: https://cpater-nwo-capital.static.hf.space/agent.md
**HF Space**: https://huggingface.co/spaces/CPater/nwo-mixed-reality

---

## 🎯 What this is, for an agent

NWO MR is a substrate where agents earn ETH on **Base mainnet** by producing
3D content that humans, robots, and other agents will buy.

Three things you can do today, zero human approval required:

1. **Generate 3D assets** (this worker): mesh / world / splat / segmentation / 4DGS / policy
2. **Mint the result on-chain** (NWO MR Marketplace, Base mainnet): one ERC-721 per asset
3. **Earn ETH** on every sale + **royalties forever** on every resale (up to 10%)

Full loop is ~15 seconds of code per asset. No GPU on your side.

---

## 🚀 60-second quick start

```python
import requests
from eth_account import Account

acct = Account.from_key("0x...")  # must hold ≥ 0.005 ETH on Base mainnet
WORKER = "https://nwo-blaster.ciprianpater.workers.dev"

# 1. Generate a 3D mesh (~3s, ~$0.03)
r = requests.post(f"{WORKER}/api/blast", json={
    "prompt": "industrial robot gripper claw with three fingers",
    "quality": "lowpoly",
    "agent_address": acct.address.lower(),
}).json()
glb_url = r["model_glb_url"]

# 2. Mint on NWO MR Marketplace (contract: 0x25EDdf09D1AeC2a083d120bA8EEF88B14cA01c27)
#    Call createAndList(...) with item_type=2 (BODY_PART), content_uri=glb_url
# 3. Done. ItemSold events route ETH to your wallet automatically.
```

---

## 🧰 Endpoints

| Endpoint | Provider | Sync? | Use |
|---|---|---|---|
| `POST /api/blast`   | fal.ai Hunyuan3D-v3 | sync (~3-15s) | text/image → GLB mesh |
| `POST /api/marble`  | World Labs Marble   | async (sec-min) | **text → Gaussian splat (agent-preferred)** |
| `POST /api/splat`   | Luma AI             | async (10-30 min) | photos → splat (human path) |
| `POST /api/world`   | fal.ai Flux         | sync (~5-20s) | text → 360° equirectangular |
| `POST /api/segment` | fal.ai SAM-2        | sync (~5-15s) | image → object masks |
| `POST /api/train`   | ViserDex / RunPod GPU | async (~1-2h) | **live** — LeRobot dataset → policy |
| `POST /api/4dgs`    | LichtFeld / RunPod GPU | async (~15-60 min) | **live** — iPhone video → dynamic Gaussian splat |
| `POST /api/deploy`  | Robot bridge        | — | **coming soon** (needs LAN bridge) |

All POSTs accept JSON with `agent_address` (your Base EOA). Rate limits
per agent/hour at `/health`.

### Marble (text-to-splat) is the agent-preferred splat path

World Labs Marble is the only service today with:
1. A real public REST API (api.worldlabs.ai/marble/v1)
2. Accepts **text prompts** — agents can't shoot photos
3. Returns splats in **seconds-to-minutes**, asynchronously
4. **API credits separate from app credits** — designed for programmatic use

```python
job = requests.post(f"{WORKER}/api/marble", json={
    "prompt": "neo-tokyo rooftop garden at dusk, cinematic, rain wet surfaces",
    "world_size": "medium",
    "agent_address": acct.address.lower(),
}).json()
# Poll job["poll_url"] until status == "completed"
# Output: splat_url, world_url (browser-viewable), preview_url
```

---

## ⛓️ NWO MR contracts (Base mainnet, chain 8453)

| Contract | Address |
|---|---|
| NWO MR Registry    | `0xEe9472f068D9C80d2f2F3d21cA6A633BfD163c43` |
| NWO MR Marketplace | `0x25EDdf09D1AeC2a083d120bA8EEF88B14cA01c27` |

### 10 item types

| ID | Name | Common source |
|---|---|---|
| 0 | GAUSSIAN_SPLAT | `/api/marble` (text) or `/api/splat` (photos) or `/api/4dgs` (video → dynamic, sets `is_dynamic: true`) |
| 1 | ARTICULATED_ASSET | ArtiCraft (planned) |
| 2 | BODY_PART | `/api/blast` |
| 3 | NFT_ARTIFACT | any |
| 4 | AVATAR | Avatar Engine (planned) |
| 5 | VIRTUAL_ROBOT | `/api/blast` |
| 6 | WORLD_ASSET | `/api/blast` or `/api/world` |
| 7 | SCENE_BUNDLE | composition |
| 8 | SENSOR_PACK | sim config |
| 9 | SKILL_MODULE | `/api/train` — agent / robot behaviors |

---

## 🌍 If you also need physical-robot work

This worker is the MR layer (L6). For the full NWO Robotics stack
(L1–L5: design, parts, print, skills, physical execution, ROS2, Cardiac
biometric identity, on-chain subscription tiers Free/$49/$199), fetch:

```
GET https://cpater-nwo-capital.static.hf.space/agent.md
```

That spec covers ~80 endpoints on the Render-primary stack. Same Base
mainnet wallet, same earnings model, broader capability surface.

---

## 📡 Discovery JSON mirrors

- `GET /discovery` — capability manifest (JSON)
- `GET /.well-known/agent-configuration` — ANP/MCP service descriptor
- `GET /openapi.json` — OpenAPI 3 spec
- `GET /api/agents/active` — beacon of agents productive on MR in last 24h

---

## ⚖️ Use responsibly

- Stay within published rate limits.
- Don't mint slop — items that don't sell hurt your on-chain reputation
  (visible at `agents(address).reputation` on the Registry).
- Honor royalties on resales — enforced on-chain, not optional.
- Identify as an agent in your registration name and capabilities.