@farcaster/frame-core 0.0.27 → 0.0.29

package/esm/types.d.ts

@@ -1,121 +1,75 @@
-import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox';
-import type { AddFrame, SignIn, Swap, ViewProfile, ViewToken } from './actions';
-import type { FrameContext } from './context';
-import type { EventFrameAdded, EventFrameRemoved, EventNotificationsDisabled, EventNotificationsEnabled } from './schemas';
+import type {
+  AddFrame,
+  Ready,
+  SignIn,
+  Swap,
+  ViewProfile,
+  ViewToken,
+} from './actions'
+import type { FrameContext } from './context'
+import type {
+  EventFrameAdded,
+  EventFrameRemoved,
+  EventNotificationsDisabled,
+  EventNotificationsEnabled,
+} from './schemas'
+import type { Ethereum } from './wallet'
 export type SetPrimaryButtonOptions = {
-    text: string;
-    loading?: boolean;
-    disabled?: boolean;
-    hidden?: boolean;
-};
-export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void;
-export type EthProviderRequest = Provider.RequestFn<RpcSchema.Default>;
-export type ReadyOptions = {
-    /**
-     * Disable native gestures. Use this option if your frame uses gestures
-     * that conflict with native gestures.
-     *
-     * @defaultValue false
-     */
-    disableNativeGestures: boolean;
-};
-export declare const DEFAULT_READY_OPTIONS: ReadyOptions;
-export type SignInOptions = {
-    /**
-     * A random string used to prevent replay attacks.
-     */
-    nonce: string;
-    /**
-     * Start time at which the signature becomes valid.
-     * ISO 8601 datetime.
-     */
-    notBefore?: string;
-    /**
-     * Expiration time at which the signature is no longer valid.
-     * ISO 8601 datetime.
-     */
-    expirationTime?: string;
-};
+  text: string
+  loading?: boolean
+  disabled?: boolean
+  hidden?: boolean
+}
+export * from './wallet/ethereum'
+export { DEFAULT_READY_OPTIONS, ReadyOptions } from './actions/Ready'
+export type SignInOptions = SignIn.SignInOptions
+export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void
 export type WireFrameHost = {
-    context: FrameContext;
-    close: () => void;
-    ready: (options?: Partial<ReadyOptions>) => void;
-    openUrl: (url: string) => void;
-    signIn: SignIn.WireSignIn;
-    setPrimaryButton: SetPrimaryButton;
-    ethProviderRequest: EthProviderRequest;
-    ethProviderRequestV2: RpcTransport;
-    eip6963RequestProvider: () => void;
-    addFrame: AddFrame.WireAddFrame;
-    viewProfile: ViewProfile.ViewProfile;
-    viewToken: ViewToken.ViewToken;
-    swap: Swap.Swap;
-};
+  context: FrameContext
+  close: () => void
+  ready: Ready.Ready
+  openUrl: (url: string) => void
+  signIn: SignIn.WireSignIn
+  setPrimaryButton: SetPrimaryButton
+  ethProviderRequest: Ethereum.EthProvideRequest
+  ethProviderRequestV2: Ethereum.RpcTransport
+  eip6963RequestProvider: () => void
+  addFrame: AddFrame.WireAddFrame
+  viewProfile: ViewProfile.ViewProfile
+  viewToken: ViewToken.ViewToken
+  swap: Swap.Swap
+}
 export type FrameHost = {
-    context: FrameContext;
-    close: () => void;
-    ready: (options?: Partial<ReadyOptions>) => void;
-    openUrl: (url: string) => void;
-    signIn: SignIn.SignIn;
-    setPrimaryButton: SetPrimaryButton;
-    ethProviderRequest: EthProviderRequest;
-    ethProviderRequestV2: RpcTransport;
-    /**
-     * Receive forwarded eip6963:requestProvider events from the frame document.
-     * Hosts must emit an EventEip6963AnnounceProvider in response.
-     */
-    eip6963RequestProvider: () => void;
-    addFrame: AddFrame.AddFrame;
-    viewProfile: ViewProfile.ViewProfile;
-    viewToken: ViewToken.ViewToken;
-    swap: Swap.Swap;
-};
-export type FrameEthProviderEventData = {
-    type: 'frame_eth_provider_event';
-} & EthProviderWireEvent;
-export type RpcTransport = (request: RpcRequest.RpcRequest) => Promise<RpcResponse.RpcResponse>;
-export type ProviderRpcError = {
-    code: number;
-    details?: string;
-    message?: string;
-};
-export type EthProviderWireEvent = {
-    event: 'accountsChanged';
-    params: [readonly Address.Address[]];
-} | {
-    event: 'chainChanged';
-    params: [string];
-} | {
-    event: 'connect';
-    params: [Provider.ConnectInfo];
-} | {
-    event: 'disconnect';
-    params: [ProviderRpcError];
-} | {
-    event: 'message';
-    params: [Provider.Message];
-};
-export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(event: event, params: Extract<EthProviderWireEvent, {
-    event: event;
-}>['params']) => void;
+  context: FrameContext
+  close: () => void
+  ready: Ready.Ready
+  openUrl: (url: string) => void
+  signIn: SignIn.SignIn
+  setPrimaryButton: SetPrimaryButton
+  ethProviderRequest: Ethereum.EthProvideRequest
+  ethProviderRequestV2: Ethereum.RpcTransport
+  /**
+   * Receive forwarded eip6963:requestProvider events from the frame document.
+   * Hosts must emit an EventEip6963AnnounceProvider in response.
+   */
+  eip6963RequestProvider: () => void
+  addFrame: AddFrame.AddFrame
+  viewProfile: ViewProfile.ViewProfile
+  viewToken: ViewToken.ViewToken
+  swap: Swap.Swap
+}
 export type EventFrameAddRejected = {
-    event: 'frame_add_rejected';
-    reason: AddFrame.AddFrameRejectedReason;
-};
+  event: 'frame_add_rejected'
+  reason: AddFrame.AddFrameRejectedReason
+}
 export type EventPrimaryButtonClicked = {
-    event: 'primary_button_clicked';
-};
-/**
- * Metadata of the EIP-1193 Provider.
- */
-export interface EIP6963ProviderInfo {
-    icon: `data:image/${string}`;
-    name: string;
-    rdns: string;
-    uuid: string;
+  event: 'primary_button_clicked'
 }
-export type EventEip6963AnnounceProvider = {
-    event: 'eip6963:announceProvider';
-    info: EIP6963ProviderInfo;
-};
-export type FrameClientEvent = EventFrameAdded | EventFrameAddRejected | EventFrameRemoved | EventNotificationsEnabled | EventNotificationsDisabled | EventPrimaryButtonClicked | EventEip6963AnnounceProvider;
+export type FrameClientEvent =
+  | EventFrameAdded
+  | EventFrameAddRejected
+  | EventFrameRemoved
+  | EventNotificationsEnabled
+  | EventNotificationsDisabled
+  | EventPrimaryButtonClicked
+  | Ethereum.EventEip6963AnnounceProvider

package/esm/types.js

@@ -1,3 +1,3 @@
-export const DEFAULT_READY_OPTIONS = {
-    disableNativeGestures: false,
-};
+// start backwards compat, remove in 1.0
+export * from './wallet/ethereum'
+export { DEFAULT_READY_OPTIONS } from './actions/Ready'

package/esm/wallet/ethereum.d.ts

@@ -0,0 +1,58 @@
+import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox'
+export type EthProvideRequest<
+  schema extends RpcSchema.Generic = RpcSchema.Default,
+> = Provider.RequestFn<schema>
+export type FrameEthProviderEventData = {
+  type: 'frame_eth_provider_event'
+} & EthProviderWireEvent
+export type RpcTransport = (
+  request: RpcRequest.RpcRequest,
+) => Promise<RpcResponse.RpcResponse>
+export type ProviderRpcError = {
+  code: number
+  details?: string
+  message?: string
+}
+export type EthProviderWireEvent =
+  | {
+      event: 'accountsChanged'
+      params: [readonly Address.Address[]]
+    }
+  | {
+      event: 'chainChanged'
+      params: [string]
+    }
+  | {
+      event: 'connect'
+      params: [Provider.ConnectInfo]
+    }
+  | {
+      event: 'disconnect'
+      params: [ProviderRpcError]
+    }
+  | {
+      event: 'message'
+      params: [Provider.Message]
+    }
+export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(
+  event: event,
+  params: Extract<
+    EthProviderWireEvent,
+    {
+      event: event
+    }
+  >['params'],
+) => void
+/**
+ * Metadata of the EIP-1193 Provider.
+ */
+export interface EIP6963ProviderInfo {
+  icon: `data:image/${string}`
+  name: string
+  rdns: string
+  uuid: string
+}
+export type EventEip6963AnnounceProvider = {
+  event: 'eip6963:announceProvider'
+  info: EIP6963ProviderInfo
+}

package/esm/wallet/ethereum.js

@@ -0,0 +1 @@
+export {}

package/esm/wallet/index.d.ts

@@ -0,0 +1 @@
+export * as Ethereum from './ethereum'

package/esm/wallet/index.js

@@ -0,0 +1 @@
+export * as Ethereum from './ethereum'

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "@farcaster/frame-core",
-  "version": "0.0.27",
+  "version": "0.0.29",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farcasterxyz/frames.git",
+    "directory": "packages/frame-core"
+  },
   "main": "dist/index.js",
   "module": "esm/index.js",
   "files": [
@@ -11,7 +17,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^2.1.8",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8",
+    "vitest": "^2.1.9",
     "@farcaster/tsconfig": "0.0.2"
   },
   "dependencies": {

package/src/actions/Ready.ts

@@ -0,0 +1,15 @@
+export type ReadyOptions = {
+  /**
+   * Disable native gestures. Use this option if your frame uses gestures
+   * that conflict with native gestures.
+   *
+   * @defaultValue false
+   */
+  disableNativeGestures: boolean
+}
+
+export const DEFAULT_READY_OPTIONS = {
+  disableNativeGestures: false,
+} satisfies ReadyOptions
+
+export type Ready = (options?: Partial<ReadyOptions>) => void

package/src/actions/index.ts

@@ -1,5 +1,6 @@
 export * as AddFrame from './AddFrame'
-export * as ViewProfile from './ViewProfile'
-export * as ViewToken from './ViewToken'
+export * as Ready from './Ready'
 export * as SignIn from './SignIn'
 export * as Swap from './Swap'
+export * as ViewProfile from './ViewProfile'
+export * as ViewToken from './ViewToken'

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './actions'
+export * from './wallet'
 export * as Context from './context'
 export * from './types'
 export * from './schemas'

package/src/types.ts

@@ -1,5 +1,11 @@
-import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox'
-import type { AddFrame, SignIn, Swap, ViewProfile, ViewToken } from './actions'
+import type {
+  AddFrame,
+  Ready,
+  SignIn,
+  Swap,
+  ViewProfile,
+  ViewToken,
+} from './actions'
 import type { FrameContext } from './context'
 import type {
   EventFrameAdded,
@@ -7,6 +13,7 @@ import type {
   EventNotificationsDisabled,
   EventNotificationsEnabled,
 } from './schemas'
+import type { Ethereum } from './wallet'
 
 export type SetPrimaryButtonOptions = {
   text: string
@@ -15,52 +22,23 @@ export type SetPrimaryButtonOptions = {
   hidden?: boolean
 }
 
-export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void
-
-export type EthProviderRequest = Provider.RequestFn<RpcSchema.Default>
-
-export type ReadyOptions = {
-  /**
-   * Disable native gestures. Use this option if your frame uses gestures
-   * that conflict with native gestures.
-   *
-   * @defaultValue false
-   */
-  disableNativeGestures: boolean
-}
-
-export const DEFAULT_READY_OPTIONS: ReadyOptions = {
-  disableNativeGestures: false,
-}
-
-export type SignInOptions = {
-  /**
-   * A random string used to prevent replay attacks.
-   */
-  nonce: string
-
-  /**
-   * Start time at which the signature becomes valid.
-   * ISO 8601 datetime.
-   */
-  notBefore?: string
+// start backwards compat, remove in 1.0
+export * from './wallet/ethereum'
+export { DEFAULT_READY_OPTIONS, ReadyOptions } from './actions/Ready'
+export type SignInOptions = SignIn.SignInOptions
+// end backwards compat
 
-  /**
-   * Expiration time at which the signature is no longer valid.
-   * ISO 8601 datetime.
-   */
-  expirationTime?: string
-}
+export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void
 
 export type WireFrameHost = {
   context: FrameContext
   close: () => void
-  ready: (options?: Partial<ReadyOptions>) => void
+  ready: Ready.Ready
   openUrl: (url: string) => void
   signIn: SignIn.WireSignIn
   setPrimaryButton: SetPrimaryButton
-  ethProviderRequest: EthProviderRequest
-  ethProviderRequestV2: RpcTransport
+  ethProviderRequest: Ethereum.EthProvideRequest
+  ethProviderRequestV2: Ethereum.RpcTransport
   eip6963RequestProvider: () => void
   addFrame: AddFrame.WireAddFrame
   viewProfile: ViewProfile.ViewProfile
@@ -71,12 +49,12 @@ export type WireFrameHost = {
 export type FrameHost = {
   context: FrameContext
   close: () => void
-  ready: (options?: Partial<ReadyOptions>) => void
+  ready: Ready.Ready
   openUrl: (url: string) => void
   signIn: SignIn.SignIn
   setPrimaryButton: SetPrimaryButton
-  ethProviderRequest: EthProviderRequest
-  ethProviderRequestV2: RpcTransport
+  ethProviderRequest: Ethereum.EthProvideRequest
+  ethProviderRequestV2: Ethereum.RpcTransport
   /**
    * Receive forwarded eip6963:requestProvider events from the frame document.
    * Hosts must emit an EventEip6963AnnounceProvider in response.
@@ -88,47 +66,6 @@ export type FrameHost = {
   swap: Swap.Swap
 }
 
-export type FrameEthProviderEventData = {
-  type: 'frame_eth_provider_event'
-} & EthProviderWireEvent
-
-export type RpcTransport = (
-  request: RpcRequest.RpcRequest,
-) => Promise<RpcResponse.RpcResponse>
-
-export type ProviderRpcError = {
-  code: number
-  details?: string
-  message?: string
-}
-
-export type EthProviderWireEvent =
-  | {
-      event: 'accountsChanged'
-      params: [readonly Address.Address[]]
-    }
-  | {
-      event: 'chainChanged'
-      params: [string]
-    }
-  | {
-      event: 'connect'
-      params: [Provider.ConnectInfo]
-    }
-  | {
-      event: 'disconnect'
-      params: [ProviderRpcError]
-    }
-  | {
-      event: 'message'
-      params: [Provider.Message]
-    }
-
-export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(
-  event: event,
-  params: Extract<EthProviderWireEvent, { event: event }>['params'],
-) => void
-
 export type EventFrameAddRejected = {
   event: 'frame_add_rejected'
   reason: AddFrame.AddFrameRejectedReason
@@ -138,21 +75,6 @@ export type EventPrimaryButtonClicked = {
   event: 'primary_button_clicked'
 }
 
-/**
- * Metadata of the EIP-1193 Provider.
- */
-export interface EIP6963ProviderInfo {
-  icon: `data:image/${string}` // RFC-2397
-  name: string
-  rdns: string
-  uuid: string
-}
-
-export type EventEip6963AnnounceProvider = {
-  event: 'eip6963:announceProvider'
-  info: EIP6963ProviderInfo
-}
-
 export type FrameClientEvent =
   | EventFrameAdded
   | EventFrameAddRejected
@@ -160,4 +82,4 @@ export type FrameClientEvent =
   | EventNotificationsEnabled
   | EventNotificationsDisabled
   | EventPrimaryButtonClicked
-  | EventEip6963AnnounceProvider
+  | Ethereum.EventEip6963AnnounceProvider

package/src/wallet/ethereum.ts

@@ -0,0 +1,61 @@
+import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox'
+
+export type EthProvideRequest<
+  schema extends RpcSchema.Generic = RpcSchema.Default,
+> = Provider.RequestFn<schema>
+
+export type FrameEthProviderEventData = {
+  type: 'frame_eth_provider_event'
+} & EthProviderWireEvent
+
+export type RpcTransport = (
+  request: RpcRequest.RpcRequest,
+) => Promise<RpcResponse.RpcResponse>
+
+export type ProviderRpcError = {
+  code: number
+  details?: string
+  message?: string
+}
+
+export type EthProviderWireEvent =
+  | {
+      event: 'accountsChanged'
+      params: [readonly Address.Address[]]
+    }
+  | {
+      event: 'chainChanged'
+      params: [string]
+    }
+  | {
+      event: 'connect'
+      params: [Provider.ConnectInfo]
+    }
+  | {
+      event: 'disconnect'
+      params: [ProviderRpcError]
+    }
+  | {
+      event: 'message'
+      params: [Provider.Message]
+    }
+
+export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(
+  event: event,
+  params: Extract<EthProviderWireEvent, { event: event }>['params'],
+) => void
+
+/**
+ * Metadata of the EIP-1193 Provider.
+ */
+export interface EIP6963ProviderInfo {
+  icon: `data:image/${string}` // RFC-2397
+  name: string
+  rdns: string
+  uuid: string
+}
+
+export type EventEip6963AnnounceProvider = {
+  event: 'eip6963:announceProvider'
+  info: EIP6963ProviderInfo
+}

package/src/wallet/index.ts

@@ -0,0 +1 @@
+export * as Ethereum from './ethereum'