# @warppay402/server ⚡

> Instant x402 V2 monetization SDK and self-hosted infrastructure for Model Context Protocol (MCP) AI tools, Hono HTTP APIs, Cloudflare Monetization Gateway, Base, Solana, Arbitrum, and Arc Mainnet.

`@warppay402/server` allows developers to monetize any MCP tool or HTTP API route in a few lines of code. It automatically generates standard x402 V2 HTTP payment challenges, verifies gasless EIP-712 / native USDC signatures, enforces platform fee splits, protects against prompt injection threats, and prevents signature replay attacks.

Official Site: [https://www.warppay402.com](https://www.warppay402.com)

---

## Features

- **x402 V2 Compliant:** Standardized payment challenge headers (`PAYMENT-REQUIRED`, `PAYMENT-SIGNATURE`, `PAYMENT-RESPONSE`).
- **Multi-Chain Native:** Multi-chain challenge generation supporting **Base Mainnet** (`eip155:8453`), **Arbitrum One** (`eip155:42161`), **Solana Mainnet-Beta** (`solana:5eykt...`), and **Arc Mainnet** (`eip155:5042`) out of the box.
- **Native USDC Gas & Off-Chain Signing:** Supports gasless `TransferWithAuthorization` (Base/Arbitrum), SPL-USDC (Solana), and direct native USDC value transfers (Arc Mainnet).
- **Automated Platform Fee Split:** Configurable fee split in basis points (e.g., 50 BPS = 0.5%) routed directly during facilitator settlement.
- **x402-Guard Security:** Pre-flight middleware protecting endpoints against prompt injection attacks, payload buffer overruns, and high-velocity traffic spikes.
- **MCP Native Decorator:** Seamlessly wraps tools written for the Model Context Protocol.
- **Replay Protection:** Includes built-in `MemoryNonceStore` and distributed `RedisNonceStore` drivers to prevent double-spending or signature reuse.
- **Edge Compatible:** Zero Node.js-only API dependencies; runs seamlessly on Cloudflare Workers, Vercel Edge, Node.js (18+), and Deno.

---

## Installation

```bash
npm install @warppay402/server
```

## Usage Case 1: Monetizing Multi-Chain Hono HTTP APIs

```typescript
import { Hono } from "hono";
import { monetize, DEFAULT_NETWORK_ARC, DEFAULT_USDC_ARC } from "@warppay402/server";

const app = new Hono();

const monetizeConfig = {
  payTo: "0xYourMerchantWalletAddress", // Default Base EVM Wallet
  platformWallet: "0xYourPlatformTreasuryWallet",
  platformFeeBps: 50, // 0.5% fee split
  guard: true, // Enables x402-guard security scanning
  facilitatorUrl: "http://localhost:3001",
  // Multi-Chain 402 Challenge Configuration
  accepts: [
    {
      scheme: "exact",
      network: "eip155:8453", // Base Mainnet
      asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
      payTo: "0xYourMerchantWalletAddress",
    },
    {
      scheme: "exact",
      network: "eip155:5042", // Arc Mainnet
      asset: "0x0000000000000000000000000000000000000000", // Native USDC
      payTo: "0xYourMerchantWalletAddress",
    },
    {
      scheme: "exact",
      network: "solana:5eykt4wA89m8E5b9B5658p445VTc28", // Solana Mainnet-Beta
      asset: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // SPL-USDC
      payTo: "YourSolanaPhantomPublicKey",
    }
  ]
};

app.use(
  "/api/data",
  monetize({
    ...monetizeConfig,
    price: "0.01", // $0.01 USDC
  })
);

app.get("/api/data", (c) => c.json({ status: "success", content: "Monetized Payload" }));

export default app;
```

## Usage Case 2:  Monetizing MCP (Model Context Protocol) Tools

```typescript
import { createMonetizedMCPTool } from "@warppay402/server";

const originalTool = {
  name: "web_scraper",
  description: "Extract clean Markdown content from URLs",
  inputSchema: { type: "object", properties: { url: { type: "string" } } },
  handler: async ({ url }: { url: string }) => {
    return { markdown: "# Cleaned Markdown Content" };
  }
};

export const monetizedTool = createMonetizedMCPTool(originalTool, {
  price: "0.02", // $0.02 USDC
  payTo: "0xYourMerchantWalletAddress",
  platformWallet: "0xYourPlatformTreasuryWallet",
  platformFeeBps: 50
});
```

## Usage Case 3: Distributed Nonce Locking with Redis / Upstash

```typescript
import { Redis } from "@upstash/redis";
import { monetize, RedisNonceStore } from "@warppay402/server";

const redis = new Redis({
  url: process.env.UPSTASH_REDIS_REST_URL!,
  token: process.env.UPSTASH_REDIS_REST_TOKEN!
});

app.use(
  "/api/v1/compute",
  monetize({
    price: "0.10",
    payTo: "0xYourMerchantWalletAddress",
    platformWallet: "0xYourPlatformTreasuryWallet",
    nonceStore: new RedisNonceStore(redis),
    nonceTtlSeconds: 300
  })
);
```

## License: MIT © WarpPay402