@farcaster/frame-sdk 0.0.37 → 0.0.39

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { AddFrame, ComposeCast, Context, FrameNotificationDetails, Ready, SendToken, SetPrimaryButtonOptions, SignIn, SwapToken, ViewProfile, ViewToken } from '@farcaster/frame-core';
+import type { AddFrame, ComposeCast, Context, FrameNotificationDetails, Ready, SendToken, SetPrimaryButtonOptions, SignIn, SolanaWalletProvider, SwapToken, ViewProfile, ViewToken } from '@farcaster/frame-core';
 import type { EventEmitter } from 'eventemitter3';
 import type * as Provider from 'ox/Provider';
 declare global {
@@ -29,6 +29,7 @@ export type EventMap = {
 export type Emitter = Compute<EventEmitter<EventMap>>;
 type SetPrimaryButton = (options: SetPrimaryButtonOptions) => Promise<void>;
 export type FrameSDK = {
+    isInMiniApp: () => Promise<boolean>;
     context: Promise<Context.FrameContext>;
     actions: {
         ready: (options?: Partial<Ready.ReadyOptions>) => Promise<void>;
@@ -44,6 +45,7 @@ export type FrameSDK = {
         viewToken: ViewToken.ViewToken;
         sendToken: SendToken.SendToken;
         swapToken: SwapToken.SwapToken;
+        solanaProvider?: SolanaWalletProvider;
     };
     wallet: {
         ethProvider: Provider.Provider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/frame-sdk",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
     "comlink": "^4.4.2",
     "eventemitter3": "^5.0.1",
     "ox": "^0.4.4",
-    "@farcaster/frame-core": "0.0.34"
+    "@farcaster/frame-core": "0.0.35"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/sdk.ts

@@ -1,4 +1,10 @@
-import { AddFrame, type FrameClientEvent, SignIn } from '@farcaster/frame-core'
+import {
+  AddFrame,
+  type FrameClientEvent,
+  SignIn,
+  type SolanaRequestFn,
+  createSolanaWalletProvider,
+} from '@farcaster/frame-core'
 import { EventEmitter } from 'eventemitter3'
 import { frameHost } from './frameHost'
 import { provider } from './provider'
@@ -28,9 +34,52 @@ export function createEmitter(): Emitter {
 }
 
 const emitter = createEmitter()
+let cachedIsInMiniAppResult: boolean | null = null
+
+/**
+ * Determines if the current environment is a MiniApp context.
+ *
+ * @param timeoutMs - Optional timeout in milliseconds (default: 50)
+ * @returns Promise resolving to boolean indicating if in MiniApp context
+ */
+async function isInMiniApp(timeoutMs = 50): Promise<boolean> {
+  // Return cached result if we've already determined we are in a MiniApp
+  if (cachedIsInMiniAppResult === true) {
+    return true
+  }
+
+  // Check for SSR environment - definitely not a MiniApp
+  if (typeof window === 'undefined') {
+    return false
+  }
+
+  // Short-circuit: definitely NOT a MiniApp
+  if (!window.ReactNativeWebView && window === window.parent) {
+    return false
+  }
+
+  // At this point, we MIGHT be in a MiniApp (iframe or RN WebView)
+  // but need to verify by checking for context communication.
+  const isInMiniApp = await Promise.race([
+    frameHost.context.then((context) => !!context), // Check if context resolves to truthy
+    new Promise<boolean>((resolve) => {
+      setTimeout(() => resolve(false), timeoutMs) // Timeout resolves to false
+    }),
+  ]).catch(() => {
+    return false
+  })
+
+  // Cache the result ONLY if true (we are confirmed to be in a MiniApp)
+  if (isInMiniApp) {
+    cachedIsInMiniAppResult = true
+  }
+
+  return isInMiniApp
+}
 
 export const sdk: FrameSDK = {
   ...emitter,
+  isInMiniApp,
   context: frameHost.context,
   actions: {
     setPrimaryButton: frameHost.setPrimaryButton.bind(frameHost),
@@ -77,6 +126,11 @@ export const sdk: FrameSDK = {
     viewToken: frameHost.viewToken.bind(frameHost),
     sendToken: frameHost.sendToken.bind(frameHost),
     swapToken: frameHost.swapToken.bind(frameHost),
+    solanaProvider: frameHost.solanaProviderRequest
+      ? createSolanaWalletProvider(
+          frameHost.solanaProviderRequest as unknown as SolanaRequestFn,
+        )
+      : undefined,
   },
   wallet: {
     ethProvider: provider,

package/src/types.ts

@@ -7,6 +7,7 @@ import type {
   SendToken,
   SetPrimaryButtonOptions,
   SignIn,
+  SolanaWalletProvider,
   SwapToken,
   ViewProfile,
   ViewToken,
@@ -51,6 +52,7 @@ export type Emitter = Compute<EventEmitter<EventMap>>
 type SetPrimaryButton = (options: SetPrimaryButtonOptions) => Promise<void>
 
 export type FrameSDK = {
+  isInMiniApp: () => Promise<boolean>
   context: Promise<Context.FrameContext>
   actions: {
     ready: (options?: Partial<Ready.ReadyOptions>) => Promise<void>
@@ -68,6 +70,7 @@ export type FrameSDK = {
     viewToken: ViewToken.ViewToken
     sendToken: SendToken.SendToken
     swapToken: SwapToken.SwapToken
+    solanaProvider?: SolanaWalletProvider
   }
   wallet: {
     ethProvider: Provider.Provider