{"_id":"@aipayagnet/express","name":"@aipayagnet/express","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aipayagnet/express","version":"0.1.0","description":"AiPay payment middleware for Express — monetize any API with x402 USDC payments","main":"src/index.js","types":"src/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch"},"keywords":["aipay","x402","payment","usdc","express","middleware","ai","agent","monetize","crypto"],"license":"MIT","author":{"name":"AiPay","email":"66474902@qq.com"},"repository":{"type":"git","url":"git+https://github.com/aipay-work/aipay.git"},"homepage":"https://aipay.work","peerDependencies":{"express":"^4.18.0"},"_id":"@aipayagnet/express@0.1.0","bugs":{"url":"https://github.com/aipay-work/aipay/issues"},"_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-g4jNDibx3ygFk07CuELbTg5fXNYhXCzXUfhQmt8FY5YyhrPGQ0aRWidvd4Dr0KDmBuuQf99/bTWYtoQF99vUqg==","shasum":"7721f418ebea4ea801806aa59a50d920b4abc30d","tarball":"https://registry.npmjs.org/@aipayagnet/express/-/express-0.1.0.tgz","fileCount":5,"unpackedSize":7581,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC/BGPNeTQh/rzfn508iv/ZtS8y3IQxA8JvM9yoEm6jGAiAFcC/mZbwsWwzlsCTz1JV4+O3FoFf840P2cGCAQXUQXA=="}]},"_npmUser":{"name":"aipayagnet","email":"66474902@qq.com"},"directories":{},"maintainers":[{"name":"aipayagnet","email":"66474902@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/express_0.1.0_1783244436245_0.12053219688650785"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-05T09:40:36.129Z","0.1.0":"2026-07-05T09:40:36.393Z","modified":"2026-07-05T09:40:36.619Z"},"maintainers":[{"name":"aipayagnet","email":"66474902@qq.com"}],"description":"AiPay payment middleware for Express — monetize any API with x402 USDC payments","homepage":"https://aipay.work","keywords":["aipay","x402","payment","usdc","express","middleware","ai","agent","monetize","crypto"],"repository":{"type":"git","url":"git+https://github.com/aipay-work/aipay.git"},"author":{"name":"AiPay","email":"66474902@qq.com"},"bugs":{"url":"https://github.com/aipay-work/aipay/issues"},"license":"MIT","readme":"# @aipay/express\n\nAiPay payment middleware for Express — monetize any API with x402 USDC payments.\n\n## Install\n\n```bash\nnpm install @aipay/express\n```\n\n## Quick Start\n\n```javascript\nimport { paymentMiddleware } from \"@aipay/express\";\nimport express from \"express\";\n\nconst app = express();\n\n// Protect any route with a paywall\napp.use(\n  \"/api/premium\",\n  paymentMiddleware({\n    endpointId: \"ep_xxx\", // Your AiPay endpoint ID\n    facilitatorUrl: \"https://facilitator.aipay.work\", // Optional: override facilitator\n  })\n);\n\napp.get(\"/api/premium/search\", (req, res) => {\n  // req.payment contains verified payment info\n  res.json({ results: \"premium data\" });\n});\n\napp.listen(3000);\n```\n\n## How It Works\n\n1. When a request hits a paid endpoint without a valid `X-PAYMENT` header, the middleware returns `402 Payment Required` with x402 payment requirements.\n2. The client pays (USDC on Polygon/Base/Ethereum) and retries with the `X-PAYMENT` header.\n3. The middleware verifies the payment via the facilitator and settles it after a successful response.\n\n## API\n\n### `paymentMiddleware(config)`\n\nReturns an Express middleware function.\n\n| Parameter | Type | Description |\n|---|---|---|\n| `config.endpointId` | `string` | Your AiPay endpoint ID (e.g., `ep_xxx`) |\n| `config.facilitatorUrl` | `string?` | Override facilitator URL (defaults to `https://facilitator.aipay.work`) |\n\n## License\n\nMIT © [AiPay](https://aipay.work)\n","readmeFilename":"README.md","_rev":"1-d073030c674b053a400679cc774ef148"}