Hosted Facilitator

We provide a managed facilitator service for developers who prefer not to manage their own infrastructure.

No infrastructure to deploy — just add your projectKey from the dashboard and start accepting payments.

Setup

1. Get Project Key

Go to Dashboard
Create a project
Buy transaction pack (pay with MNT)
Copy your project key (pk_xxx)

The same project key is used for both transaction processing and telemetry/analytics. You don't need separate keys.

2. Configure Your Server

import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/nextjs';

// Hosted mode - no facilitatorUrl needed!
const pay = mantlePaywall({
  priceUsd: 0.01,
  payTo: '0xYourWallet',
  projectKey: 'pk_xxx'  // Get from dashboard
});
// facilitatorUrl defaults to hosted service automatically

That's it! No need to specify facilitatorUrl — it defaults to our hosted service.

3. Client Configuration

// Client auto-detects settings from backend 402 response
const { postWithPayment } = useMantleX402();

// Or for vanilla JS:
const client = createMantleClient({
  resourceUrl: 'https://your-api.com',
  getProvider: () => window.ethereum,
  getAccount: () => userAddress
  // facilitatorUrl and projectKey auto-detected!
});

Benefits

Zero configuration — No facilitator URL to configure
No infrastructure to manage — We handle servers, updates, and monitoring
We pay gas fees — No need to maintain MNT balance
High availability — Redundant infrastructure
Automatic updates — Always running latest version
Built-in analytics — Track payments in dashboard

Pricing

You top up your project balance with MNT, and we pay gas fees for your transactions.

Rate: 1 MNT = 100 transactions

In the Dashboard you can:

Top up balance — Send MNT to our facilitator
Monitor usage — Track remaining transactions
View analytics — See payment history and statistics

No monthly fees, no subscriptions — just top up when needed.

Comparison with Self-Hosted

Feature	Self-Hosted (Recommended)	Hosted
Setup complexity	Deploy + configure	Just add projectKey
Infrastructure management	You manage	We handle it
Gas fees	You pay	We pay
Per-transaction fee	No	Yes (1 MNT = 100 tx)
URL configuration	Required	Auto-detected
Control	Full control	Standard config
Data location	Your servers	Our servers

When to Use Hosted

Choose hosted facilitator when:

You want to get started quickly
You don't want to manage infrastructure
You prefer predictable per-transaction pricing
You don't need custom facilitator configuration
You want zero-config client setup

When to Self-Host

Consider self-hosting when:

You need full control over your infrastructure
You want to avoid per-transaction fees
You have specific compliance requirements
You want data to stay on your servers

Next Steps

Facilitator Overview — How facilitators work
Self-Hosted Facilitator — Run your own
Dashboard — Manage projects and analytics

Desktop Only