@alleyboss/micropay-solana-x402-paywall 3.3.11 → 3.3.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +26 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -133,6 +133,32 @@ const withMicropay = createX402Middleware({
133
133
  | **Setup** | Zero-config | Requires RPC URL |
134
134
  | **Best For** | Quick startups, MVPs | Production, High-Volume, Agents |
135
135
 
136
+ ## 🌐 Public Facilitator Mode (New in v3.3.12)
137
+
138
+ Use a public facilitator service like [x402.org](https://x402.org) or [PayAI Network](https://facilitator.payai.network) without running your own RPC node:
139
+
140
+ ```typescript
141
+ import { RemoteSvmFacilitator } from '@alleyboss/micropay-solana-x402-paywall';
142
+
143
+ // Use a public facilitator for verification
144
+ const facilitator = new RemoteSvmFacilitator('https://x402.org/facilitator');
145
+
146
+ // Or in middleware config
147
+ const withMicropay = createX402Middleware({
148
+ walletAddress: 'YOUR_WALLET',
149
+ network: 'mainnet-beta',
150
+ facilitatorUrl: 'https://facilitator.payai.network'
151
+ // No rpcUrl = uses remote facilitator
152
+ });
153
+ ```
154
+
155
+ ### 🆚 Verification Modes Comparison
156
+
157
+ | Mode | Class | Best For |
158
+ |------|-------|----------|
159
+ | **Self-Sovereign** | `LocalSvmFacilitator` | Full control, privacy, production |
160
+ | **Public Facilitator** | `RemoteSvmFacilitator` | Quick setup, no RPC management |
161
+
136
162
  ## 🤖 AI Agent Payments
137
163
 
138
164
  Enable autonomous AI agents to pay for premium API access.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alleyboss/micropay-solana-x402-paywall",
3
- "version": "3.3.11",
3
+ "version": "3.3.12",
4
4
  "description": "Production-ready Solana micropayments library wrapper for official x402 SDK",
5
5
  "author": "AlleyBoss",
6
6
  "license": "MIT",