uvd-x402-sdk 2.14.1 → 2.15.2

package/dist/providers/near/index.d.mts

@@ -12,6 +12,17 @@ import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Versio
  * 3. SignedDelegateAction is sent to facilitator
  * 4. Facilitator wraps it and submits to NEAR, paying all gas
  *
+ * NEP-366 Wallet Support:
+ * For apps that need wallet selector integration, call setupWalletSelector() early:
+ *
+ * ```ts
+ * // In your app's initialization (e.g., App.tsx or main.ts)
+ * await NEARProvider.setupWalletSelector({
+ *   walletUrl: 'https://mynearwallet.ultravioletadao.xyz',
+ *   contractId: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+ * });
+ * ```
+ *
  * @example
  * ```ts
  * import { NEARProvider } from 'uvd-x402-sdk/near';
@@ -29,6 +40,17 @@ import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Versio
  * ```
  */
 
+/**
+ * Options for configuring the NEAR wallet selector helper
+ */
+interface WalletSelectorOptions {
+    /** URL of the MyNearWallet instance (default: https://mynearwallet.ultravioletadao.xyz) */
+    walletUrl?: string;
+    /** USDC contract ID for NEAR (default: 17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1) */
+    contractId?: string;
+    /** NEAR network ID (default: mainnet) */
+    networkId?: string;
+}
 /**
  * NEARProvider - Wallet adapter for NEAR Protocol via MyNearWallet/Meteor
  */
@@ -39,6 +61,22 @@ declare class NEARProvider implements WalletAdapter {
     private accountId;
     private publicKey;
     private rpcUrl;
+    /**
+     * Setup wallet selector for NEP-366 meta-transaction support.
+     *
+     * Call this once early in your app initialization (e.g., App.tsx or main.ts)
+     * to configure the NEAR wallet selector before using NEARProvider.
+     *
+     * @param options - Configuration options for wallet selector
+     * @example
+     * ```ts
+     * await NEARProvider.setupWalletSelector({
+     *   walletUrl: 'https://mynearwallet.ultravioletadao.xyz',
+     *   contractId: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+     * });
+     * ```
+     */
+    static setupWalletSelector(options?: WalletSelectorOptions): Promise<void>;
     /**
      * Check if NEAR wallet is available
      */
@@ -100,4 +138,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { NEARProvider, NEARProvider as default };
+export { NEARProvider, type WalletSelectorOptions, NEARProvider as default };

package/dist/providers/near/index.d.ts

@@ -12,6 +12,17 @@ import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Versio
  * 3. SignedDelegateAction is sent to facilitator
  * 4. Facilitator wraps it and submits to NEAR, paying all gas
  *
+ * NEP-366 Wallet Support:
+ * For apps that need wallet selector integration, call setupWalletSelector() early:
+ *
+ * ```ts
+ * // In your app's initialization (e.g., App.tsx or main.ts)
+ * await NEARProvider.setupWalletSelector({
+ *   walletUrl: 'https://mynearwallet.ultravioletadao.xyz',
+ *   contractId: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+ * });
+ * ```
+ *
  * @example
  * ```ts
  * import { NEARProvider } from 'uvd-x402-sdk/near';
@@ -29,6 +40,17 @@ import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Versio
  * ```
  */
 
+/**
+ * Options for configuring the NEAR wallet selector helper
+ */
+interface WalletSelectorOptions {
+    /** URL of the MyNearWallet instance (default: https://mynearwallet.ultravioletadao.xyz) */
+    walletUrl?: string;
+    /** USDC contract ID for NEAR (default: 17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1) */
+    contractId?: string;
+    /** NEAR network ID (default: mainnet) */
+    networkId?: string;
+}
 /**
  * NEARProvider - Wallet adapter for NEAR Protocol via MyNearWallet/Meteor
  */
@@ -39,6 +61,22 @@ declare class NEARProvider implements WalletAdapter {
     private accountId;
     private publicKey;
     private rpcUrl;
+    /**
+     * Setup wallet selector for NEP-366 meta-transaction support.
+     *
+     * Call this once early in your app initialization (e.g., App.tsx or main.ts)
+     * to configure the NEAR wallet selector before using NEARProvider.
+     *
+     * @param options - Configuration options for wallet selector
+     * @example
+     * ```ts
+     * await NEARProvider.setupWalletSelector({
+     *   walletUrl: 'https://mynearwallet.ultravioletadao.xyz',
+     *   contractId: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+     * });
+     * ```
+     */
+    static setupWalletSelector(options?: WalletSelectorOptions): Promise<void>;
     /**
      * Check if NEAR wallet is available
      */
@@ -100,4 +138,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { NEARProvider, NEARProvider as default };
+export { NEARProvider, type WalletSelectorOptions, NEARProvider as default };

package/dist/providers/near/index.js

@@ -785,6 +785,73 @@ var NEARProvider = class {
   accountId = null;
   publicKey = null;
   rpcUrl = NEAR_CONFIG.nodeUrl;
+  /**
+   * Setup wallet selector for NEP-366 meta-transaction support.
+   *
+   * Call this once early in your app initialization (e.g., App.tsx or main.ts)
+   * to configure the NEAR wallet selector before using NEARProvider.
+   *
+   * @param options - Configuration options for wallet selector
+   * @example
+   * ```ts
+   * await NEARProvider.setupWalletSelector({
+   *   walletUrl: 'https://mynearwallet.ultravioletadao.xyz',
+   *   contractId: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+   * });
+   * ```
+   */
+  static async setupWalletSelector(options = {}) {
+    const {
+      walletUrl = "https://mynearwallet.ultravioletadao.xyz",
+      contractId = "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
+      networkId = "mainnet"
+    } = options;
+    if (typeof window === "undefined") {
+      throw new X402Error(
+        "setupWalletSelector() must be called in a browser environment",
+        "WALLET_NOT_FOUND"
+      );
+    }
+    try {
+      const [{ setupWalletSelector }, { setupMyNearWallet }] = await Promise.all([
+        import('@near-wallet-selector/core'),
+        import('@near-wallet-selector/my-near-wallet')
+      ]);
+      const selector = await setupWalletSelector({
+        network: networkId,
+        modules: [
+          setupMyNearWallet({
+            walletUrl
+          })
+        ]
+      });
+      const win = window;
+      win.nearWalletSelector = {
+        isSignedIn: () => selector.isSignedIn(),
+        getAccountId: () => {
+          const state = selector.store.getState();
+          return state.accounts[0]?.accountId || null;
+        },
+        signIn: async (signInOptions) => {
+          const wallet = await selector.wallet("my-near-wallet");
+          const signInFn = wallet.signIn;
+          await signInFn({
+            contractId: signInOptions?.contractId || contractId
+          });
+        },
+        signOut: async () => {
+          const wallet = await selector.wallet("my-near-wallet");
+          await wallet.signOut();
+        }
+      };
+    } catch (error) {
+      throw new X402Error(
+        `Failed to setup wallet selector: ${error instanceof Error ? error.message : "Unknown error"}. Make sure @near-wallet-selector/core and @near-wallet-selector/my-near-wallet are installed.`,
+        "WALLET_NOT_FOUND",
+        error
+      );
+    }
+  }
   /**
    * Check if NEAR wallet is available
    */
@@ -830,7 +897,7 @@ var NEARProvider = class {
         return accountId;
       }
       throw new X402Error(
-        "No NEAR wallet found. Please install MyNearWallet or Meteor.",
+        "No NEAR wallet found. Call NEARProvider.setupWalletSelector() first, or install MyNearWallet/Meteor.",
         "WALLET_NOT_FOUND"
       );
     } catch (error) {
@@ -1044,6 +1111,22 @@ var NEARProvider = class {
    */
   async signMessage(message) {
     const win = window;
+    if (win.nearWalletSelector?.wallet) {
+      try {
+        const wallet = await win.nearWalletSelector.wallet();
+        if (wallet?.signMessage) {
+          const nonce = crypto.getRandomValues(new Uint8Array(32));
+          const result = await wallet.signMessage({
+            message,
+            recipient: "uvd-x402-sdk",
+            nonce
+          });
+          return result.signature;
+        }
+      } catch (e) {
+        console.debug("Wallet selector signMessage failed:", e);
+      }
+    }
     if (win.myNearWallet?.signMessage) {
       const result = await win.myNearWallet.signMessage({
         message,