feat: subscription tiers, plugin marketplace, professional services, web interface, SDK, grants, and Solidity template packs

Complete monetization and developer ecosystem build:

- Subscription system: Free / Pro ($4.99) / Enterprise ($19.99) with Stripe
  integration, usage tracking, feature gating, and 3-day free trials
- Plugin marketplace: developer plugin store with 90/10 revenue split,
  submission review pipeline, purchase flow, and download tracking
- Professional services: Glasswing security audit ($299+) and smart contract
  conversion ($499+) as paid service tiers
- Web interface: landing, chat, pricing, audit, marketplace, and conversion
  service pages — all dark theme, responsive, production-ready
- Gateway routes: 25 new endpoints wired into server.py for all new subsystems
- A2A commerce: agent-to-agent service registry, job submission, and discovery
- Social integration: Twitter and Discord automated announcement system
- JavaScript SDK: @opnmatrx/sdk npm package with TypeScript, SSE streaming,
  and WebSocket support
- Swift blocks: 7 copy-paste-ready SwiftUI files for MTRX iOS subscription UI
- Solidity template packs: 15 production contracts across DeFi, Creator, and
  Business packs for Gumroad ($49 each, $119 bundle)
- Grant applications: Base Ecosystem Fund, Ethereum Foundation ESP, Optimism
  RPGF, Gitcoin Grants with submission checklist
- Extensions registry: JSON-based platform extension system with schema
  validation
- Multi-chain support: chains.py with Base, Ethereum, Polygon, Arbitrum,
  and Optimism configurations
- Documentation: MONETIZATION.md, PLUGIN_DEVELOPMENT.md, updated API
  reference with all new endpoints, updated README with subscription tiers
  and web interface sections, updated ROADMAP with completed milestones
  and revenue breakdown
- Tests: full test suite for subscription store, usage tracker, and feature gate

All revenue routes to NeoSafe multisig 0x46fF491D7054A6F500026B3E81f358190f8d8Ec5.

Author: Neo

.env.example

@@ -19,3 +19,17 @@
 
 # ── Notifications ──
 # TELEGRAM_BOT_TOKEN=
+
+# ── Stripe (subscription payments) ──
+# STRIPE_SECRET_KEY=
+# STRIPE_WEBHOOK_SECRET=
+# STRIPE_PRO_PRICE_ID=
+# STRIPE_ENTERPRISE_PRICE_ID=
+
+# ── Social media ──
+# TWITTER_API_KEY=
+# TWITTER_API_SECRET=
+# TWITTER_ACCESS_TOKEN=
+# TWITTER_ACCESS_SECRET=
+# DISCORD_WEBHOOK_URL=
+# DISCORD_ANNOUNCEMENTS_WEBHOOK=

README.md

@@ -292,6 +292,71 @@ See `docs/RUNBOOK.md` for the full on-call playbook and
 
 ---
 
+## Subscription Tiers
+
+| Feature | Free | Pro ($4.99/mo) | Enterprise ($19.99/mo) |
+|---------|------|----------------|----------------------|
+| Contract conversions | 5/month | 100/month | Unlimited |
+| NFT mints | 3/month | 50/month | Unlimited |
+| DeFi loan volume | $5,000/month | $500,000/month | Unlimited |
+| API calls | 20/min | 120/min | 600/min |
+| Dashboard export | — | ✓ | ✓ |
+| Team accounts | — | — | ✓ |
+| Priority support | — | — | ✓ |
+
+All tiers include a 3-day free trial. See `/pricing` for full details.
+
+---
+
+## Web Interface
+
+The gateway serves a built-in web interface:
+
+- `http://localhost:18790` — Landing page
+- `http://localhost:18790/chat` — Web chat with Trinity
+- `http://localhost:18790/pricing` — Pricing and plans
+- `http://localhost:18790/audit` — Glasswing security audit service
+- `http://localhost:18790/marketplace` — Plugin marketplace
+
+---
+
+## Professional Services
+
+- **Glasswing Security Audit** ($299+) — Automated smart contract security scanning at `/audit`
+- **Contract Conversion** ($499+) — Professional plain-English to Solidity at `/services/conversion`
+
+---
+
+## Plugin Development
+
+Build and sell plugins for 0pnMatrx. Developers keep 90% of revenue.
+
+```bash
+# See the example plugin
+cat runtime/plugins/example_plugin.py
+
+# Full guide
+cat docs/PLUGIN_DEVELOPMENT.md
+```
+
+Submit plugins at `/marketplace` or via `POST /marketplace/plugins/submit`.
+
+---
+
+## JavaScript SDK
+
+```bash
+npm install @opnmatrx/sdk
+```
+
+```typescript
+import { OpenMatrixClient } from '@opnmatrx/sdk';
+const client = new OpenMatrixClient('http://localhost:18790');
+const response = await client.chat('What can you do?');
+```
+
+---
+
 ## Contributing
 
 See `CONTRIBUTING.md` for the Möbius loop contribution model.

ROADMAP.md

@@ -9,11 +9,31 @@
 - ~~Glasswing security audit layer~~ ✓ — 12-point vulnerability scanning on all contracts
 - ~~Managed agent orchestration~~ ✓ — event-driven coordination, session lifecycle, hooks
 - ~~Contract Conversion pipeline~~ ✓ — pseudocode/Solidity/Vyper → optimised Solidity → audit → compile → on-chain deploy → EAS attestation
+- ~~Subscription tiers~~ ✓ — Free / Pro ($4.99) / Enterprise ($19.99) with Stripe integration, usage tracking, and feature gating
+- ~~Plugin marketplace~~ ✓ — developer plugin store with 90/10 revenue split, submissions, purchases, and download tracking
+- ~~Web interface~~ ✓ — landing, chat, pricing, audit, marketplace, and conversion service pages
+- ~~Professional services~~ ✓ — Glasswing audit ($299+) and contract conversion ($499+) as paid tiers
+- ~~A2A commerce~~ ✓ — agent-to-agent service registry and discovery protocol
+- ~~JavaScript SDK~~ ✓ — `@opnmatrx/sdk` npm package with TypeScript support
+- ~~Social media integration~~ ✓ — Twitter and Discord automated announcements
 - Unified Rexhepi Framework — full deployment
 - Consumer Layer — public-facing protocol
 - Local LLM support expansion
 - Distributed agent coordination — remote agent support, cross-node HiveMind
 
+## Revenue
+
+All revenue flows through the NeoSafe multisig at `0x46fF491D7054A6F500026B3E81f358190f8d8Ec5`.
+
+- **Subscriptions** — Free / Pro ($4.99/mo) / Enterprise ($19.99/mo) via Stripe
+- **On-chain platform fees** — transparent, visible on-chain, disclosed before first transaction
+- **Plugin marketplace** — 10% platform commission (developers keep 90%)
+- **Professional services** — Glasswing audit ($299+), contract conversion ($499+)
+- **Solidity template packs** — DeFi, Creator, Business packs via Gumroad ($49 each, $119 bundle)
+- **Grants** — Base Ecosystem Fund, Ethereum Foundation ESP, Optimism RPGF, Gitcoin Grants
+
+See `docs/MONETIZATION.md` for the full breakdown.
+
 ## Blockchain Activation
 
 The full execution layer is wired and tested in offline mode — every one

docs/MONETIZATION.md

@@ -0,0 +1,81 @@
+# 0pnMatrx Monetization Model
+
+How 0pnMatrx generates revenue while keeping the free tier genuinely useful.
+
+## Philosophy
+
+The free tier is real. It will always exist and will always provide genuine access
+to all 30 blockchain services with reasonable limits. We believe that making
+blockchain accessible to everyone is more important than maximising revenue.
+
+Revenue funds continued development, infrastructure costs, and the team.
+
+## Revenue Streams
+
+### 1. Subscription Tiers
+
+| Tier | Price | Target |
+|------|-------|--------|
+| Free | $0/month | Everyone — personal use, learning, small projects |
+| Pro | $4.99/month | Power users, small businesses, developers |
+| Enterprise | $19.99/month | Teams, agencies, enterprises |
+
+The free tier includes all 30 services with monthly limits (5 contract conversions,
+3 NFT mints, $5k DeFi volume, etc.). Pro raises limits significantly. Enterprise
+removes them entirely and adds team features.
+
+A 3-day free trial is available for both paid tiers.
+
+### 2. On-Chain Platform Fees
+
+Small, transparent fees are applied to certain on-chain transactions (NFT mints,
+contract deployments, marketplace sales). These fees:
+
+- Are fully visible on-chain
+- Route to the NeoSafe multisig at `0x46fF491D7054A6F500026B3E81f358190f8d8Ec5`
+- Fund platform development, infrastructure, and contract audits
+- Are disclosed to users before their first transaction of each type
+
+### 3. Professional Services
+
+- **Glasswing Security Audit** — $299 / $599 / $999 per contract
+  Automated + manual smart contract security auditing
+
+- **Smart Contract Conversion** — $499 one-time / $1,499/month (5) / $3,999/month unlimited
+  Professional plain-English to Solidity conversion with audit included
+
+### 4. Plugin Marketplace
+
+Third-party developers can sell plugins that extend the platform. Revenue split:
+**developers keep 90%, platform takes 10%**. Free plugins are always welcome.
+
+### 5. Solidity Template Packs (Gumroad)
+
+Pre-built, production-ready smart contract templates sold as digital products:
+- DeFi Primitives Pack — $49
+- Creator Economy Pack — $49
+- Business Infrastructure Pack — $49
+- All Three Packs — $119
+
+### 6. Grants
+
+The platform applies for ecosystem grants to fund public-good development:
+- Base Ecosystem Fund
+- Ethereum Foundation ESP
+- Optimism RPGF
+- Gitcoin Grants
+
+## Ownership & Revenue Routing
+
+All revenue routes through the NeoSafe multisig wallet. The multisig ensures
+transparent fund management with on-chain accountability.
+
+**NeoSafe Address:** `0x46fF491D7054A6F500026B3E81f358190f8d8Ec5`
+
+## What Will Never Change
+
+1. The free tier will always exist
+2. Core functionality will never be paywalled
+3. The platform will always be open source (MIT)
+4. Platform fees will always be transparent and on-chain
+5. No token, no speculative asset, no ICO

docs/PLUGIN_DEVELOPMENT.md

@@ -0,0 +1,151 @@
+# Plugin Development Guide
+
+Build and sell plugins for the 0pnMatrx platform.
+
+## Quick Start
+
+```python
+from runtime.plugins.base import OpenMatrixPlugin
+
+class MyPlugin(OpenMatrixPlugin):
+    @property
+    def name(self) -> str:
+        return "my-plugin"
+
+    @property
+    def version(self) -> str:
+        return "1.0.0"
+
+    async def on_load(self, config: dict) -> None:
+        print("Plugin loaded!")
+
+    async def on_unload(self) -> None:
+        print("Plugin unloaded!")
+```
+
+## Plugin Lifecycle
+
+1. **Discovery** — The `PluginLoader` scans `plugins/installed/` for Python packages
+2. **Loading** — Each package is imported and scanned for `OpenMatrixPlugin` subclasses
+3. **Initialization** — `on_load(config)` is called with the platform config
+4. **Runtime** — Hooks are called during message processing
+5. **Shutdown** — `on_unload()` is called on platform shutdown
+
+## Available Hooks
+
+| Hook | When Called | Can Modify? |
+|------|-----------|-------------|
+| `on_load(config)` | Plugin startup | No |
+| `on_unload()` | Plugin shutdown | No |
+| `on_message(agent, message)` | Before agent processes a message | Yes — return modified message |
+| `on_tool_call(tool_name, args)` | Before a tool executes | Yes — return modified args |
+| `get_tools()` | During initialization | Registers new tools |
+| `get_commands()` | During initialization | Registers slash commands |
+
+## Registering Custom Tools
+
+```python
+def get_tools(self) -> list[dict]:
+    return [{
+        "name": "my_custom_tool",
+        "description": "Does something useful",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "input": {"type": "string", "description": "The input data"}
+            },
+            "required": ["input"]
+        },
+        "handler": self.handle_tool,
+    }]
+
+async def handle_tool(self, input: str, **kwargs) -> str:
+    return f"Processed: {input}"
+```
+
+## Plugin Marketplace
+
+### Selling Your Plugin
+
+1. Build and test your plugin locally
+2. Submit it via `POST /marketplace/plugins/submit` (requires Enterprise tier)
+3. Wait for review and approval
+4. Your plugin appears on the marketplace
+
+### Revenue Share
+
+**You keep 90%. We take 10%.**
+
+Set your price when submitting. Free plugins are always welcome and don't require
+any revenue share.
+
+### Pricing Options
+
+- **One-time** — User pays once, gets the plugin forever
+- **Monthly** — Recurring subscription for ongoing access
+
+## Directory Structure
+
+```
+plugins/installed/my-plugin/
+├── __init__.py          # Must contain OpenMatrixPlugin subclass
+├── handlers.py          # Optional: tool and command handlers
+├── config.py            # Optional: plugin configuration
+└── README.md            # Optional: documentation
+```
+
+## Tier Requirements
+
+Plugins can specify a minimum tier:
+
+```python
+@property
+def min_tier(self) -> str:
+    return "pro"  # Only Pro and Enterprise users can install
+```
+
+## Example: Portfolio Tracker Plugin
+
+```python
+from runtime.plugins.base import OpenMatrixPlugin
+
+class PortfolioTracker(OpenMatrixPlugin):
+    @property
+    def name(self) -> str:
+        return "portfolio-tracker"
+
+    @property
+    def version(self) -> str:
+        return "1.0.0"
+
+    @property
+    def description(self) -> str:
+        return "Track your DeFi portfolio across multiple chains"
+
+    def get_commands(self) -> list[dict]:
+        return [{
+            "name": "/portfolio",
+            "description": "Show your current portfolio balances",
+            "handler": self.show_portfolio,
+        }]
+
+    async def show_portfolio(self, **kwargs) -> str:
+        return "Portfolio: ETH 2.5, USDC 1000, ..."
+```
+
+## Testing Your Plugin
+
+```python
+import pytest
+from my_plugin import MyPlugin
+
+@pytest.mark.asyncio
+async def test_plugin_loads():
+    plugin = MyPlugin()
+    await plugin.on_load({})
+    assert plugin.name == "my-plugin"
+```
+
+## API Reference
+
+See `docs/api-reference.md` for the full gateway API including marketplace endpoints.