@dexterai/x402 1.8.2 → 1.9.1

package/dist/react/index.d.cts

@@ -1,7 +1,10 @@
-import { a as X402Client } from '../x402-client-Dk9q2QQF.cjs';
-import { W as WalletSet, B as BalanceInfo } from '../types-B477nBpg.cjs';
-import { a as AccessPassTier } from '../types-DYLi7SuF.cjs';
-export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-DYLi7SuF.cjs';
+import { a as X402Client } from '../sponsored-access-BCB2CxdG.cjs';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-BCB2CxdG.cjs';
+import { W as WalletSet, B as BalanceInfo } from '../types-DmqH9yD8.cjs';
+import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+import { a as AccessPassTier } from '../types-BQvaF8lB.cjs';
+export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-BQvaF8lB.cjs';
 
 /**
  * React Hook for x402 v2 Payments
@@ -114,6 +117,12 @@ interface UseX402PaymentReturn {
         /** Seconds remaining on the pass */
         remainingSeconds: number | null;
     } | null;
+    /**
+     * Sponsored recommendations from the most recent payment.
+     * Populated when the facilitator returns sponsored-access extensions
+     * in the settlement response. Null if no recommendations were delivered.
+     */
+    sponsoredRecommendations: SponsoredRecommendation[] | null;
 }
 /**
  * React hook for managing x402 v2 payments across chains

package/dist/react/index.d.ts

@@ -1,7 +1,10 @@
-import { a as X402Client } from '../x402-client-D9b3PHai.js';
-import { W as WalletSet, B as BalanceInfo } from '../types-BWnUAPvD.js';
-import { a as AccessPassTier } from '../types-DYLi7SuF.js';
-export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-DYLi7SuF.js';
+import { a as X402Client } from '../sponsored-access-H1EX6zpi.js';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-H1EX6zpi.js';
+import { W as WalletSet, B as BalanceInfo } from '../types-ENcnkof8.js';
+import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+import { a as AccessPassTier } from '../types-BQvaF8lB.js';
+export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-BQvaF8lB.js';
 
 /**
  * React Hook for x402 v2 Payments
@@ -114,6 +117,12 @@ interface UseX402PaymentReturn {
         /** Seconds remaining on the pass */
         remainingSeconds: number | null;
     } | null;
+    /**
+     * Sponsored recommendations from the most recent payment.
+     * Populated when the facilitator returns sponsored-access extensions
+     * in the settlement response. Null if no recommendations were delivered.
+     */
+    sponsoredRecommendations: SponsoredRecommendation[] | null;
 }
 /**
  * React hook for managing x402 v2 payments across chains

package/dist/react/index.js

@@ -124,7 +124,7 @@ var SolanaAdapter = class {
     const connection = new Connection(url, "confirmed");
     const userPubkey = new PublicKey(wallet.publicKey.toBase58());
     const { payTo, asset, extra } = accept;
-    const amount = accept.amount || accept.maxAmountRequired;
+    const amount = accept.amount ?? accept.maxAmountRequired;
     if (!amount) {
       throw new Error("Missing amount in payment requirements");
     }
@@ -362,7 +362,7 @@ var EvmAdapter = class {
       throw new Error("Wallet not connected");
     }
     const { payTo, asset, extra } = accept;
-    const amount = accept.amount || accept.maxAmountRequired;
+    const amount = accept.amount ?? accept.maxAmountRequired;
     if (!amount) {
       throw new Error("Missing amount in payment requirements");
     }
@@ -390,7 +390,9 @@ var EvmAdapter = class {
         { name: "nonce", type: "bytes32" }
       ]
     };
-    const nonce = "0x" + [...Array(32)].map(() => Math.floor(Math.random() * 256).toString(16).padStart(2, "0")).join("");
+    const nonceBytes = new Uint8Array(32);
+    (globalThis.crypto ?? (await import("crypto")).webcrypto).getRandomValues(nonceBytes);
+    const nonce = "0x" + [...nonceBytes].map((b) => b.toString(16).padStart(2, "0")).join("");
     const now = Math.floor(Date.now() / 1e3);
     const authorization = {
       from: wallet.address,
@@ -447,6 +449,9 @@ function isKnownUSDC(asset) {
 
 // src/client/x402-client.ts
 var receiptStore = /* @__PURE__ */ new WeakMap();
+function getPaymentReceipt(response) {
+  return receiptStore.get(response);
+}
 function createX402Client(config) {
   const {
     adapters = [createSolanaAdapter({ verbose: config.verbose }), createEvmAdapter({ verbose: config.verbose })],
@@ -482,10 +487,11 @@ function createX402Client(config) {
       const parts = jwt.split(".");
       if (parts.length === 3) {
         const payload = JSON.parse(atob(parts[1].replace(/-/g, "+").replace(/_/g, "/")));
-        if (payload.exp) {
-          passCache.set(host, { jwt, expiresAt: payload.exp });
-          log("Access pass cached for", host, "| expires:", new Date(payload.exp * 1e3).toISOString());
-        }
+        const now = Math.floor(Date.now() / 1e3);
+        const maxExp = now + 86400;
+        const expiresAt = Math.min(typeof payload.exp === "number" ? payload.exp : now, maxExp);
+        passCache.set(host, { jwt, expiresAt });
+        log("Access pass cached for", host, "| expires:", new Date(expiresAt * 1e3).toISOString());
       }
     } catch {
       log("Failed to cache access pass");
@@ -566,7 +572,7 @@ function createX402Client(config) {
     if (adapter.name === "Solana" && !accept.extra?.feePayer) return null;
     const decimals = accept.extra?.decimals ?? (isKnownUSDC(accept.asset) ? 6 : void 0);
     if (typeof decimals !== "number") return null;
-    const paymentAmount = accept.amount || accept.maxAmountRequired;
+    const paymentAmount = accept.amount ?? accept.maxAmountRequired;
     if (!paymentAmount) return null;
     const rpcUrl = getRpcUrl(accept.network, adapter);
     const balance = await adapter.getBalance(accept, wallet, rpcUrl);
@@ -710,7 +716,7 @@ function createX402Client(config) {
         "Payment option missing decimals - provide in extra or use a known stablecoin"
       );
     }
-    const paymentAmount = accept.amount || accept.maxAmountRequired;
+    const paymentAmount = accept.amount ?? accept.maxAmountRequired;
     if (!paymentAmount) {
       throw new X402Error("missing_amount", "Payment option missing amount");
     }
@@ -875,6 +881,28 @@ function getExplorerUrl(txSignature, network) {
   return `https://solscan.io/tx/${txSignature}`;
 }
 
+// src/client/sponsored-access.ts
+function getSponsoredAccessInfo(response) {
+  const receipt = getPaymentReceipt(response);
+  if (!receipt?.extensions?.["sponsored-access"]) return void 0;
+  return receipt.extensions["sponsored-access"];
+}
+function getSponsoredRecommendations(response) {
+  const info = getSponsoredAccessInfo(response);
+  if (!info?.recommendations?.length) return void 0;
+  return info.recommendations;
+}
+async function fireImpressionBeacon(response) {
+  const info = getSponsoredAccessInfo(response);
+  const beaconUrl = info?.tracking?.impressionBeacon;
+  if (!beaconUrl) return false;
+  try {
+    await fetch(beaconUrl, { method: "GET" });
+  } catch {
+  }
+  return true;
+}
+
 // src/react/useX402Payment.ts
 function useX402Payment(config) {
   const {
@@ -890,6 +918,7 @@ function useX402Payment(config) {
   const [transactionId, setTransactionId] = useState(null);
   const [transactionNetwork, setTransactionNetwork] = useState(null);
   const [balances, setBalances] = useState([]);
+  const [sponsoredRecommendations, setSponsoredRecommendations] = useState(null);
   const log = useCallback((...args) => {
     if (verbose) console.log("[useX402Payment]", ...args);
   }, [verbose]);
@@ -921,7 +950,7 @@ function useX402Payment(config) {
           const accept = {
             scheme: "exact",
             network: SOLANA_MAINNET_NETWORK,
-            maxAmountRequired: "0",
+            amount: "0",
             asset: USDC_MINT,
             payTo: "",
             maxTimeoutSeconds: 60,
@@ -946,7 +975,7 @@ function useX402Payment(config) {
           const accept = {
             scheme: "exact",
             network: BASE_MAINNET_NETWORK,
-            maxAmountRequired: "0",
+            amount: "0",
             asset: USDC_BASE,
             payTo: "",
             maxTimeoutSeconds: 60,
@@ -977,6 +1006,7 @@ function useX402Payment(config) {
     setError(null);
     setTransactionId(null);
     setTransactionNetwork(null);
+    setSponsoredRecommendations(null);
   }, []);
   const client = useMemo(() => createX402Client({
     adapters,
@@ -1014,6 +1044,13 @@ function useX402Payment(config) {
           log("Could not parse PAYMENT-RESPONSE header");
         }
       }
+      const recs = getSponsoredRecommendations(response);
+      setSponsoredRecommendations(recs ?? null);
+      if (recs) {
+        log("Sponsored recommendations received:", recs.length);
+        fireImpressionBeacon(response).catch(() => {
+        });
+      }
       setStatus("success");
       return response;
     } catch (err) {
@@ -1044,8 +1081,9 @@ function useX402Payment(config) {
     isAnyWalletConnected,
     reset,
     refreshBalances,
-    accessPass: null
+    accessPass: null,
     // Access pass state managed by useAccessPass hook for granular control
+    sponsoredRecommendations
   };
 }
 
@@ -1243,6 +1281,8 @@ function useAccessPass(config) {
 }
 export {
   X402Error,
+  fireImpressionBeacon,
+  getSponsoredRecommendations,
   useAccessPass,
   useX402Payment
 };