@elizaos/plugin-x402 2.0.0-alpha.5 → 2.0.0-beta.1

package/dist/index.d.ts

@@ -1,2 +1,57 @@
-export * from "./index";
-export { default } from "./index";
+/**
+ * x402 Payment Middleware for ElizaOS
+ *
+ * Provides micropayment protection for plugin routes using the x402 protocol.
+ *
+ * **Why this module exists (product):** plugin authors should declare `x402` on
+ * routes and get a consistent gate—402 with payment options, verification, and
+ * optional facilitator settlement—without reimplementing payment math, replay
+ * safety, or HTTP header quirks in every plugin.
+ *
+ * **Why both “legacy JSON 402” and V2 headers:** older clients and scanners read
+ * the JSON body; protocol V2 buyers read `PAYMENT-REQUIRED` / `PAYMENT-RESPONSE`.
+ * Serving both avoids breaking existing integrations while still interoperating
+ * with modern wallets.
+ *
+ * @example
+ * ```typescript
+ * import { applyPaymentProtection } from '@elizaos/plugin-x402';
+ *
+ * // In your plugin:
+ * export const routes: Route[] = [
+ *   {
+ *     type: 'GET',
+ *     path: '/api/analytics/trending',
+ *     public: true,
+ *     x402: {
+ *       priceInCents: 10,
+ *       paymentConfigs: ['base_usdc', 'solana_usdc']
+ *     },
+ *     handler: async (req, res, runtime) => {
+ *       // Your handler logic
+ *     }
+ *   }
+ * ];
+ * ```
+ */
+export type { BuiltInPaymentConfig, CharacterX402Settings, PaymentEnabledRoute, X402Config, X402RequestValidator, X402ValidationResult, } from "@elizaos/core";
+export type { Network } from "./payment-config.js";
+export { atomicAmountForPriceInCents, BUILT_IN_NETWORKS, getBaseUrl, getPaymentAddress, getPaymentConfig, getX402Health, listX402Configs, PAYMENT_ADDRESSES, PAYMENT_CONFIGS, type PaymentConfigDefinition, registerX402Config, toResourceUrl, toX402Network, } from "./payment-config.js";
+export { applyPaymentProtection, createPaymentAwareHandler, isRoutePaymentWrapped, X402_ROUTE_PAYMENT_WRAPPED, } from "./payment-wrapper.js";
+export { resolveEffectiveX402, X402_EVENT_PAYMENT_REQUIRED, X402_EVENT_PAYMENT_VERIFIED, } from "./x402-resolve.js";
+export { type StartupValidationResult, validateAndThrowIfInvalid, validateX402Startup, } from "./startup-validator.js";
+export { type Accepts, createAccepts, createX402Response, type OutputSchema, validateAccepts, validateX402Response, type X402Response, type X402ScanNetwork, } from "./x402-types.js";
+import type { Plugin } from "@elizaos/core";
+/**
+ * elizaOS plugin descriptor for x402.
+ *
+ * The middleware exported above is the actual integration surface — plugins
+ * declare `x402` on their routes and the agent's HTTP dispatch wraps them via
+ * `applyPaymentProtection` / `createPaymentAwareHandler`. This Plugin object
+ * exists so the runtime's plugin loader can register `@elizaos/plugin-x402` as
+ * a first-class auto-loadable plugin (config: `x402.enabled`).
+ */
+declare const x402Plugin: Plugin;
+export default x402Plugin;
+export { x402Plugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,uBAAuB,EAC5B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,OAAO,EACZ,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,eAAe,EACf,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU,EAAE,MAQjB,CAAC;AAEF,eAAe,UAAU,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,CAAC"}