Skip to content

README.md

Latest commit

 

History

History
103 lines (72 loc) · 3.81 KB

README.md

File metadata and controls

103 lines (72 loc) · 3.81 KB

⚡ IMAGXP: The Identity Monetization Auto Governance Exchange Protocol

License Status: Stable Spec: v1.2

IMAGXP is the open standard for the AI-Web Economy.

As AI Chatbots replace traditional web traffic, the AdSense model is collapsing, threatening the future of the open web. IMAGXP restores Ecosystem Balance by replacing the adversarial "Scraping War" with a cryptographic, automated handshake grounded in Identity, Monetization, and Governance. It ensures Publishers are paid and Agents get clean data. 🌐 Website: https://imagxp.com

🏛️ The Architecture

The web is currently broken. Agents scrape for free, and Publishers block them violently. IMAGXP solves this deadlock by introducing a Transactional Peace Treaty:

  1. Identity (Anti-Spoofing): Agents sign requests. Publishers verify them via DNS.
  2. Monetization (The Broker): Zero-friction micro-payments ($0.001) for clean data.
  3. Governance (The Rules): Publishers set strict policies (No Training, RAG Only), while Agents enforce Quality Standards (No SEO Spam, No AI Slop) to ensure a fair and valuable exchange.

📖 Read the Architecture Deep Dive | ❓ Why IMAGXP?

🚀 Usage Snippets

Note: These are minimal snippets to demonstrate the API. For a complete, running production setup, please read the Official Installation Guide.

Follow this exact order to build the full loop.

1. The Agent (The Visitor)

Goal: Crawl the web legally and get High-Quality JSON.

npm install @imagxp/protocol
import { IMAGXPAgent } from '@imagxp/protocol';

// 1. Generate Identity (One time)
// npx imagxp generate-identity

// 2. Start Crawling
const agent = await IMAGXPAgent.init();
const response = await agent.fetch("https://nytimes.com", { 
    purpose: "RAG_RETRIEVAL" 
});

2. The Broker (The Bank) - Optional

Goal: Issue "Visas" (Auth Tokens) to Agents. Required only for centralized clearing; P2P payments can skip this.

import { SignJWT } from 'jose';
import { HEADERS, IMAGXP_VERSION } from '@imagxp/protocol';

// Agent pays you $1M -> You issue this Token
const token = await new SignJWT({ payment_status: "paid", ver: IMAGXP_VERSION })
  .setProtectedHeader({ alg: 'ES256' })
  .setIssuer('https://broker.imagxp.network')
  .setAudience('https://nytimes.com')
  .sign(BROKER_PRIVATE_KEY);

3. The Publisher (The Host)

Goal: Block scraper bots, accept AAMP Agents, and get paid.

// src/middleware.ts
import { IMAGXPNext } from '@imagxp/protocol';

const imagxp = IMAGXPNext.init({
  policy: {
    requireIdentityBinding: true,  // 1. Anti-Spoofing (Security)
    monetization: {
      brokerUrl: "https://broker.imagxp.network" // 2. Enable Payments (Optional)
    }
  }
});

// Protect your "Premium" routes
export const middleware = imagxp.withProtection();

need the full code? Check the installation/ folder.

📚 Documentation Index

Topic Description Link
Setup The Official Installation Guide INSTALLATION.md
Spec The Technical Specification (v1.1) spec/v1.1.md
Logic System Architecture & Security docs/ARCHITECTURE.md
Mission The Rationale & Market Analysis docs/WHY_IMAGXP.md

License: Apache 2.0. Free for everyone forever. IMAGXP is a Protocol, not a Startup.