@w-pay/appkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hector Morel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @w-pay/appkit
+
+Pay an ENS name with [Reown AppKit Pay](https://www.npmjs.com/package/@reown/appkit-pay).
+
+```bash
+npm install @w-pay/appkit @w-pay/sdk @reown/appkit-pay viem
+```
+
+```ts
+import * as appkitPay from "@reown/appkit-pay";
+import { payToName } from "@w-pay/appkit";
+
+await payToName(publicClient, appkitPay, {
+  to: "demo.w-pay.eth",
+  amount: 15,
+  currency: "USDC",
+});
+```
+
+That's the whole integration. The name is resolved to a chain, token and plain
+address, and `pay()` is called with the address.
+
+## Preview before the wallet opens
+
+```ts
+import { previewPayment } from "@w-pay/appkit";
+
+const intent = await previewPayment(publicClient, { to: "demo.w-pay.eth", amount: 15 });
+// show intent.recipient, intent.chainId, intent.token in a confirmation UI
+```
+
+## Why this is a wrapper and not a plugin
+
+AppKit Pay has no provider, plugin, or middleware registration API. Its exports
+are `pay`, `openPay`, `getPayResult`, `getPayError`, `getIsPaymentInProgress`
+and `getExchanges` — there is no `.use()` and no resolver hook. The headless
+WalletConnect Pay SDK does have an injectable "seams" system, but the set is
+closed (`transport`, `wallet`, `clock`, `telemetry`, plus a signing strategy)
+and contains no identity seam.
+
+More to the point: `pay()` validates the recipient with `isAddress()` and
+**throws** on anything that is not a plain address. Passing an ENS name directly
+is not merely unsupported — it is an error.
+
+So the only correct integration is outside-in: resolve the name first, then hand
+`pay()` an address. That is what this package does, in about thirty lines. It
+needs nobody's permission and works against every version of AppKit that ships
+`pay()`.
+
+The AppKit module is **injected** rather than imported, so this package pins no
+AppKit version and can be tested with a stub.
+
+---
+
+Source and architecture: **https://github.com/RWA-ID/w-pay-eth**
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @w-pay/appkit — pay an ENS name with Reown AppKit Pay.
+ *
+ * ## Why this is a wrapper and not a plugin
+ *
+ * AppKit Pay has no provider, plugin, or middleware registration API. Its
+ * exports are `pay`, `openPay`, `getPayResult`, `getPayError`,
+ * `getIsPaymentInProgress` and `getExchanges` — there is no `.use()` and no
+ * resolver hook. The headless WalletConnect Pay SDK does have an injectable
+ * "seams" system, but the set is closed (`transport`, `wallet`, `clock`,
+ * `telemetry`, plus a signing strategy) and contains no identity seam.
+ *
+ * Worse for our purposes, `pay()` validates the recipient with
+ * `CoreHelperUtil.isAddress()` and THROWS on anything that is not a plain
+ * address — so passing an ENS name directly is not merely unsupported, it is
+ * an error. On the merchant side, WalletConnect Pay's `CreatePayment` request
+ * has no recipient field at all; the payee is the onboarded merchant's
+ * configured settlement destination.
+ *
+ * So the only correct integration is outside-in: resolve the name to
+ * `{chainId, token, address}` first, then hand `pay()` a plain address. That is
+ * exactly what this package does, in about thirty lines. It needs nobody's
+ * permission and works against every version of AppKit that ships `pay()`.
+ */
+import type { PublicClient } from "viem";
+import { type CreatePaymentOptions, type PaymentIntent } from "@w-pay/sdk";
+/** The subset of `@reown/appkit-pay` this adapter needs. */
+export interface AppKitPayLike {
+    pay(options: {
+        paymentAsset: {
+            network: string;
+            asset: string;
+            metadata: {
+                name: string;
+                symbol: string;
+                decimals: number;
+            };
+        };
+        recipient: string;
+        amount: number;
+    }): Promise<unknown>;
+}
+export interface PayToNameOptions extends Omit<CreatePaymentOptions, "to"> {
+    /** ENS name or plain address to pay. */
+    to: string;
+}
+/**
+ * Resolve a name and pay it via AppKit Pay.
+ *
+ * ```ts
+ * import * as appkitPay from "@reown/appkit-pay";
+ * await payToName(publicClient, appkitPay, {
+ *   to: "coffee.w-pay.eth", amount: 15, currency: "USDC",
+ * });
+ * ```
+ *
+ * The AppKit module is injected rather than imported so this package adds no
+ * hard dependency on a specific AppKit version, and so it can be tested with a
+ * stub.
+ */
+export declare function payToName(client: PublicClient, appkit: AppKitPayLike, options: PayToNameOptions): Promise<{
+    intent: PaymentIntent;
+    result: unknown;
+}>;
+/**
+ * Resolve without paying — useful for showing the payee and the exact target
+ * chain/token in a confirmation UI before the wallet opens.
+ */
+export declare function previewPayment(client: PublicClient, options: PayToNameOptions): Promise<PaymentIntent>;
+export type { PaymentIntent };
+//# 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAiB,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1F,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE;QACX,YAAY,EAAE;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC;SAC9D,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC;IACxE,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAIrD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+/**
+ * @w-pay/appkit — pay an ENS name with Reown AppKit Pay.
+ *
+ * ## Why this is a wrapper and not a plugin
+ *
+ * AppKit Pay has no provider, plugin, or middleware registration API. Its
+ * exports are `pay`, `openPay`, `getPayResult`, `getPayError`,
+ * `getIsPaymentInProgress` and `getExchanges` — there is no `.use()` and no
+ * resolver hook. The headless WalletConnect Pay SDK does have an injectable
+ * "seams" system, but the set is closed (`transport`, `wallet`, `clock`,
+ * `telemetry`, plus a signing strategy) and contains no identity seam.
+ *
+ * Worse for our purposes, `pay()` validates the recipient with
+ * `CoreHelperUtil.isAddress()` and THROWS on anything that is not a plain
+ * address — so passing an ENS name directly is not merely unsupported, it is
+ * an error. On the merchant side, WalletConnect Pay's `CreatePayment` request
+ * has no recipient field at all; the payee is the onboarded merchant's
+ * configured settlement destination.
+ *
+ * So the only correct integration is outside-in: resolve the name to
+ * `{chainId, token, address}` first, then hand `pay()` a plain address. That is
+ * exactly what this package does, in about thirty lines. It needs nobody's
+ * permission and works against every version of AppKit that ships `pay()`.
+ */
+import { createPayment } from "@w-pay/sdk";
+/**
+ * Resolve a name and pay it via AppKit Pay.
+ *
+ * ```ts
+ * import * as appkitPay from "@reown/appkit-pay";
+ * await payToName(publicClient, appkitPay, {
+ *   to: "coffee.w-pay.eth", amount: 15, currency: "USDC",
+ * });
+ * ```
+ *
+ * The AppKit module is injected rather than imported so this package adds no
+ * hard dependency on a specific AppKit version, and so it can be tested with a
+ * stub.
+ */
+export async function payToName(client, appkit, options) {
+    const intent = await createPayment(client, options);
+    const result = await appkit.pay(intent.appkitPayArgs);
+    return { intent, result };
+}
+/**
+ * Resolve without paying — useful for showing the payee and the exact target
+ * chain/token in a confirmation UI before the wallet opens.
+ */
+export async function previewPayment(client, options) {
+    return createPayment(client, options);
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@w-pay/appkit",
+  "version": "0.1.0",
+  "description": "Pay an ENS name with Reown AppKit Pay. Resolves the name, then calls pay() with a plain address.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "@reown/appkit-pay": ">=1.8.0",
+    "@w-pay/sdk": "^0.1.0",
+    "viem": "^2.21.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "viem": "^2.52.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RWA-ID/w-pay-eth.git",
+    "directory": "packages/appkit"
+  },
+  "homepage": "https://github.com/RWA-ID/w-pay-eth/tree/main/packages/appkit#readme",
+  "bugs": {
+    "url": "https://github.com/RWA-ID/w-pay-eth/issues"
+  },
+  "keywords": [
+    "ens",
+    "payments",
+    "reown",
+    "appkit",
+    "walletconnect",
+    "ethereum",
+    "identity"
+  ]
+}