@farcaster/miniapp-core 0.0.0-canary-20250630212339

package/esm/schemas/manifest.d.ts

@@ -0,0 +1,236 @@
+import { z } from 'zod/v4';
+export declare const domainMiniAppConfigSchema: z.ZodObject<{
+    version: z.ZodUnion<readonly [z.ZodLiteral<"0.0.0">, z.ZodLiteral<"0.0.1">, z.ZodLiteral<"1">, z.ZodLiteral<"next">]>;
+    name: z.ZodString;
+    iconUrl: z.ZodString;
+    homeUrl: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    buttonTitle: z.ZodOptional<z.ZodString>;
+    splashImageUrl: z.ZodOptional<z.ZodString>;
+    splashBackgroundColor: z.ZodOptional<z.ZodString>;
+    webhookUrl: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    screenshotUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    primaryCategory: z.ZodOptional<z.ZodEnum<{
+        games: "games";
+        social: "social";
+        finance: "finance";
+        utility: "utility";
+        productivity: "productivity";
+        "health-fitness": "health-fitness";
+        "news-media": "news-media";
+        music: "music";
+        shopping: "shopping";
+        education: "education";
+        "developer-tools": "developer-tools";
+        entertainment: "entertainment";
+        "art-creativity": "art-creativity";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    heroImageUrl: z.ZodOptional<z.ZodString>;
+    tagline: z.ZodOptional<z.ZodString>;
+    ogTitle: z.ZodOptional<z.ZodString>;
+    ogDescription: z.ZodOptional<z.ZodString>;
+    ogImageUrl: z.ZodOptional<z.ZodString>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+    requiredChains: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        "eip155:1": "eip155:1";
+        "eip155:8453": "eip155:8453";
+        "eip155:42161": "eip155:42161";
+        "eip155:421614": "eip155:421614";
+        "eip155:84532": "eip155:84532";
+        "eip155:666666666": "eip155:666666666";
+        "eip155:100": "eip155:100";
+        "eip155:10": "eip155:10";
+        "eip155:11155420": "eip155:11155420";
+        "eip155:137": "eip155:137";
+        "eip155:11155111": "eip155:11155111";
+        "eip155:7777777": "eip155:7777777";
+        "eip155:130": "eip155:130";
+        "eip155:10143": "eip155:10143";
+        "eip155:42220": "eip155:42220";
+        "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    }>>, z.ZodTransform<("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[], ("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[]>>>;
+    requiredCapabilities: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        "wallet.getEthereumProvider": "wallet.getEthereumProvider";
+        "wallet.getSolanaProvider": "wallet.getSolanaProvider";
+        "actions.ready": "actions.ready";
+        "actions.openUrl": "actions.openUrl";
+        "actions.close": "actions.close";
+        "actions.setPrimaryButton": "actions.setPrimaryButton";
+        "actions.addMiniApp": "actions.addMiniApp";
+        "actions.signIn": "actions.signIn";
+        "actions.viewCast": "actions.viewCast";
+        "actions.viewProfile": "actions.viewProfile";
+        "actions.composeCast": "actions.composeCast";
+        "actions.viewToken": "actions.viewToken";
+        "actions.sendToken": "actions.sendToken";
+        "actions.swapToken": "actions.swapToken";
+        "haptics.impactOccurred": "haptics.impactOccurred";
+        "haptics.notificationOccurred": "haptics.notificationOccurred";
+        "haptics.selectionChanged": "haptics.selectionChanged";
+        back: "back";
+    }>>, z.ZodTransform<("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[], ("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[]>>>;
+    castShareUrl: z.ZodOptional<z.ZodString>;
+    canonicalDomain: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const domainManifestSchema: z.ZodObject<{
+    accountAssociation: z.ZodObject<{
+        header: z.ZodString;
+        payload: z.ZodString;
+        signature: z.ZodString;
+    }, z.core.$strip>;
+    miniapp: z.ZodOptional<z.ZodObject<{
+        version: z.ZodUnion<readonly [z.ZodLiteral<"0.0.0">, z.ZodLiteral<"0.0.1">, z.ZodLiteral<"1">, z.ZodLiteral<"next">]>;
+        name: z.ZodString;
+        iconUrl: z.ZodString;
+        homeUrl: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        buttonTitle: z.ZodOptional<z.ZodString>;
+        splashImageUrl: z.ZodOptional<z.ZodString>;
+        splashBackgroundColor: z.ZodOptional<z.ZodString>;
+        webhookUrl: z.ZodOptional<z.ZodString>;
+        subtitle: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        screenshotUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        primaryCategory: z.ZodOptional<z.ZodEnum<{
+            games: "games";
+            social: "social";
+            finance: "finance";
+            utility: "utility";
+            productivity: "productivity";
+            "health-fitness": "health-fitness";
+            "news-media": "news-media";
+            music: "music";
+            shopping: "shopping";
+            education: "education";
+            "developer-tools": "developer-tools";
+            entertainment: "entertainment";
+            "art-creativity": "art-creativity";
+        }>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        heroImageUrl: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        ogTitle: z.ZodOptional<z.ZodString>;
+        ogDescription: z.ZodOptional<z.ZodString>;
+        ogImageUrl: z.ZodOptional<z.ZodString>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+        requiredChains: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            "eip155:1": "eip155:1";
+            "eip155:8453": "eip155:8453";
+            "eip155:42161": "eip155:42161";
+            "eip155:421614": "eip155:421614";
+            "eip155:84532": "eip155:84532";
+            "eip155:666666666": "eip155:666666666";
+            "eip155:100": "eip155:100";
+            "eip155:10": "eip155:10";
+            "eip155:11155420": "eip155:11155420";
+            "eip155:137": "eip155:137";
+            "eip155:11155111": "eip155:11155111";
+            "eip155:7777777": "eip155:7777777";
+            "eip155:130": "eip155:130";
+            "eip155:10143": "eip155:10143";
+            "eip155:42220": "eip155:42220";
+            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+        }>>, z.ZodTransform<("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[], ("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[]>>>;
+        requiredCapabilities: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            "wallet.getEthereumProvider": "wallet.getEthereumProvider";
+            "wallet.getSolanaProvider": "wallet.getSolanaProvider";
+            "actions.ready": "actions.ready";
+            "actions.openUrl": "actions.openUrl";
+            "actions.close": "actions.close";
+            "actions.setPrimaryButton": "actions.setPrimaryButton";
+            "actions.addMiniApp": "actions.addMiniApp";
+            "actions.signIn": "actions.signIn";
+            "actions.viewCast": "actions.viewCast";
+            "actions.viewProfile": "actions.viewProfile";
+            "actions.composeCast": "actions.composeCast";
+            "actions.viewToken": "actions.viewToken";
+            "actions.sendToken": "actions.sendToken";
+            "actions.swapToken": "actions.swapToken";
+            "haptics.impactOccurred": "haptics.impactOccurred";
+            "haptics.notificationOccurred": "haptics.notificationOccurred";
+            "haptics.selectionChanged": "haptics.selectionChanged";
+            back: "back";
+        }>>, z.ZodTransform<("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[], ("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[]>>>;
+        castShareUrl: z.ZodOptional<z.ZodString>;
+        canonicalDomain: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    frame: z.ZodOptional<z.ZodObject<{
+        version: z.ZodUnion<readonly [z.ZodLiteral<"0.0.0">, z.ZodLiteral<"0.0.1">, z.ZodLiteral<"1">, z.ZodLiteral<"next">]>;
+        name: z.ZodString;
+        iconUrl: z.ZodString;
+        homeUrl: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        buttonTitle: z.ZodOptional<z.ZodString>;
+        splashImageUrl: z.ZodOptional<z.ZodString>;
+        splashBackgroundColor: z.ZodOptional<z.ZodString>;
+        webhookUrl: z.ZodOptional<z.ZodString>;
+        subtitle: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        screenshotUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        primaryCategory: z.ZodOptional<z.ZodEnum<{
+            games: "games";
+            social: "social";
+            finance: "finance";
+            utility: "utility";
+            productivity: "productivity";
+            "health-fitness": "health-fitness";
+            "news-media": "news-media";
+            music: "music";
+            shopping: "shopping";
+            education: "education";
+            "developer-tools": "developer-tools";
+            entertainment: "entertainment";
+            "art-creativity": "art-creativity";
+        }>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        heroImageUrl: z.ZodOptional<z.ZodString>;
+        tagline: z.ZodOptional<z.ZodString>;
+        ogTitle: z.ZodOptional<z.ZodString>;
+        ogDescription: z.ZodOptional<z.ZodString>;
+        ogImageUrl: z.ZodOptional<z.ZodString>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+        requiredChains: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            "eip155:1": "eip155:1";
+            "eip155:8453": "eip155:8453";
+            "eip155:42161": "eip155:42161";
+            "eip155:421614": "eip155:421614";
+            "eip155:84532": "eip155:84532";
+            "eip155:666666666": "eip155:666666666";
+            "eip155:100": "eip155:100";
+            "eip155:10": "eip155:10";
+            "eip155:11155420": "eip155:11155420";
+            "eip155:137": "eip155:137";
+            "eip155:11155111": "eip155:11155111";
+            "eip155:7777777": "eip155:7777777";
+            "eip155:130": "eip155:130";
+            "eip155:10143": "eip155:10143";
+            "eip155:42220": "eip155:42220";
+            "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+        }>>, z.ZodTransform<("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[], ("eip155:1" | "eip155:8453" | "eip155:42161" | "eip155:421614" | "eip155:84532" | "eip155:666666666" | "eip155:100" | "eip155:10" | "eip155:11155420" | "eip155:137" | "eip155:11155111" | "eip155:7777777" | "eip155:130" | "eip155:10143" | "eip155:42220" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")[]>>>;
+        requiredCapabilities: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            "wallet.getEthereumProvider": "wallet.getEthereumProvider";
+            "wallet.getSolanaProvider": "wallet.getSolanaProvider";
+            "actions.ready": "actions.ready";
+            "actions.openUrl": "actions.openUrl";
+            "actions.close": "actions.close";
+            "actions.setPrimaryButton": "actions.setPrimaryButton";
+            "actions.addMiniApp": "actions.addMiniApp";
+            "actions.signIn": "actions.signIn";
+            "actions.viewCast": "actions.viewCast";
+            "actions.viewProfile": "actions.viewProfile";
+            "actions.composeCast": "actions.composeCast";
+            "actions.viewToken": "actions.viewToken";
+            "actions.sendToken": "actions.sendToken";
+            "actions.swapToken": "actions.swapToken";
+            "haptics.impactOccurred": "haptics.impactOccurred";
+            "haptics.notificationOccurred": "haptics.notificationOccurred";
+            "haptics.selectionChanged": "haptics.selectionChanged";
+            back: "back";
+        }>>, z.ZodTransform<("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[], ("wallet.getEthereumProvider" | "wallet.getSolanaProvider" | "actions.ready" | "actions.openUrl" | "actions.close" | "actions.setPrimaryButton" | "actions.addMiniApp" | "actions.signIn" | "actions.viewCast" | "actions.viewProfile" | "actions.composeCast" | "actions.viewToken" | "actions.sendToken" | "actions.swapToken" | "haptics.impactOccurred" | "haptics.notificationOccurred" | "haptics.selectionChanged" | "back")[]>>>;
+        castShareUrl: z.ZodOptional<z.ZodString>;
+        canonicalDomain: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/esm/schemas/manifest.js

@@ -0,0 +1,124 @@
+import { z } from 'zod/v4';
+import { miniAppHostCapabilityList } from "../types.js";
+import { buttonTitleSchema, createSimpleStringSchema, domainSchema, encodedJsonFarcasterSignatureSchema, hexColorSchema, miniAppNameSchema, secureUrlSchema, } from "./shared.js";
+const primaryCategorySchema = z.enum([
+    'games',
+    'social',
+    'finance',
+    'utility',
+    'productivity',
+    'health-fitness',
+    'news-media',
+    'music',
+    'shopping',
+    'education',
+    'developer-tools',
+    'entertainment',
+    'art-creativity',
+]);
+const chainList = [
+    'eip155:1', // Ethereum mainnet
+    'eip155:8453', // Base mainnet
+    'eip155:42161', // Arbitrum One
+    'eip155:421614', // Arbitrum Sepolia
+    'eip155:84532', // Base Sepolia
+    'eip155:666666666', // Degen
+    'eip155:100', // Gnosis
+    'eip155:10', // Optimism
+    'eip155:11155420', // Optimism Sepolia
+    'eip155:137', // Polygon
+    'eip155:11155111', // Ethereum Sepolia
+    'eip155:7777777', // Zora
+    'eip155:130', // Unichain
+    'eip155:10143', // Monad testnet
+    'eip155:42220', // Celo
+    'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp', // Solana
+];
+function removeArrayDuplicates(arr) {
+    const set = new Set(arr);
+    return Array.from(set);
+}
+export const domainMiniAppConfigSchema = z
+    .object({
+    // 0.0.0 and 0.0.1 are not technically part of the spec but kept for
+    // backwards compatibility. next should always resolve to the most recent
+    // schema version.
+    version: z.union([
+        z.literal('0.0.0'),
+        z.literal('0.0.1'),
+        z.literal('1'),
+        z.literal('next'),
+    ]),
+    name: miniAppNameSchema,
+    iconUrl: secureUrlSchema,
+    homeUrl: secureUrlSchema,
+    /** deprecated, set ogImageUrl instead */
+    imageUrl: secureUrlSchema.optional(),
+    /** deprecated, will rely on fc:frame/fc:miniapp meta tag */
+    buttonTitle: buttonTitleSchema.optional(),
+    splashImageUrl: secureUrlSchema.optional(),
+    splashBackgroundColor: hexColorSchema.optional(),
+    webhookUrl: secureUrlSchema.optional(),
+    /** see: https://github.com/farcasterxyz/miniapps/discussions/191 */
+    subtitle: createSimpleStringSchema({ max: 30 }).optional(),
+    description: createSimpleStringSchema({ max: 170 }).optional(),
+    screenshotUrls: z.array(secureUrlSchema).max(3).optional(),
+    primaryCategory: primaryCategorySchema.optional(),
+    tags: z
+        .array(createSimpleStringSchema({ max: 20, noSpaces: true }))
+        .max(5)
+        .optional(),
+    heroImageUrl: secureUrlSchema.optional(),
+    tagline: createSimpleStringSchema({ max: 30 }).optional(),
+    ogTitle: createSimpleStringSchema({ max: 30 }).optional(),
+    ogDescription: createSimpleStringSchema({ max: 100 }).optional(),
+    ogImageUrl: secureUrlSchema.optional(),
+    /** see: https://github.com/farcasterxyz/miniapps/discussions/204 */
+    noindex: z.boolean().optional(),
+    /** see https://github.com/farcasterxyz/miniapps/discussions/256 */
+    requiredChains: z
+        .array(z.enum(chainList))
+        .transform(removeArrayDuplicates)
+        .optional(),
+    requiredCapabilities: z
+        .array(z.enum(miniAppHostCapabilityList))
+        .transform(removeArrayDuplicates)
+        .optional(),
+    /** see https://github.com/farcasterxyz/miniapps/discussions/158 */
+    /** Documentation will be added once this feature is finalized. */
+    castShareUrl: secureUrlSchema.optional(),
+    /** Canonical domain for the miniapp application */
+    canonicalDomain: domainSchema.optional(),
+})
+    .refine((data) => {
+    if (data.castShareUrl === undefined)
+        return true;
+    try {
+        const homeUrlDomain = new URL(data.homeUrl).hostname;
+        const castShareUrlDomain = new URL(data.castShareUrl).hostname;
+        return homeUrlDomain === castShareUrlDomain;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'castShareUrl must have the same domain as homeUrl',
+    path: ['castShareUrl'],
+});
+export const domainManifestSchema = z
+    .object({
+    accountAssociation: encodedJsonFarcasterSignatureSchema,
+    miniapp: domainMiniAppConfigSchema.optional(),
+    // Support both 'frame' and 'miniapp' during transition period
+    frame: domainMiniAppConfigSchema.optional(),
+})
+    .refine((data) => {
+    // If both are provided, they must be identical
+    if (data.frame && data.miniapp) {
+        return JSON.stringify(data.frame) === JSON.stringify(data.miniapp);
+    }
+    return true;
+}, {
+    message: 'If both "frame" and "miniapp" are provided, they must be identical',
+    path: ['frame', 'miniapp'],
+});

package/esm/schemas/notifications.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod/v4';
+export declare const notificationDetailsSchema: z.ZodObject<{
+    url: z.ZodString;
+    token: z.ZodString;
+}, z.core.$strip>;
+export type MiniAppNotificationDetails = z.infer<typeof notificationDetailsSchema>;
+export declare const sendNotificationRequestSchema: z.ZodObject<{
+    notificationId: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodString;
+    targetUrl: z.ZodString;
+    tokens: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type SendNotificationRequest = z.infer<typeof sendNotificationRequestSchema>;
+export declare const sendNotificationResponseSchema: z.ZodObject<{
+    result: z.ZodObject<{
+        successfulTokens: z.ZodArray<z.ZodString>;
+        invalidTokens: z.ZodArray<z.ZodString>;
+        rateLimitedTokens: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SendNotificationResponse = z.infer<typeof sendNotificationResponseSchema>;

package/esm/schemas/notifications.js

@@ -0,0 +1,20 @@
+import { z } from 'zod/v4';
+import { secureUrlSchema } from "./shared.js";
+export const notificationDetailsSchema = z.object({
+    url: z.string(),
+    token: z.string(),
+});
+export const sendNotificationRequestSchema = z.object({
+    notificationId: z.string().max(128),
+    title: z.string().max(32),
+    body: z.string().max(128),
+    targetUrl: secureUrlSchema,
+    tokens: z.string().array().max(100),
+});
+export const sendNotificationResponseSchema = z.object({
+    result: z.object({
+        successfulTokens: z.array(z.string()),
+        invalidTokens: z.array(z.string()),
+        rateLimitedTokens: z.array(z.string()),
+    }),
+});

package/esm/schemas/shared.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod/v4';
+export declare const createSimpleStringSchema: ({ max, noSpaces, }?: {
+    max?: number;
+    noSpaces?: boolean;
+}) => z.ZodString;
+export declare const secureUrlSchema: z.ZodString;
+export declare const miniAppNameSchema: z.ZodString;
+export declare const buttonTitleSchema: z.ZodString;
+export declare const caip19TokenSchema: z.ZodString;
+export declare const hexColorSchema: z.ZodString;
+export declare const domainSchema: z.ZodString;
+export declare const aspectRatioSchema: z.ZodUnion<readonly [z.ZodLiteral<"1:1">, z.ZodLiteral<"3:2">]>;
+export declare const encodedJsonFarcasterSignatureSchema: z.ZodObject<{
+    header: z.ZodString;
+    payload: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strip>;
+export type EncodedJsonFarcasterSignatureSchema = z.infer<typeof encodedJsonFarcasterSignatureSchema>;
+export declare const jsonFarcasterSignatureHeaderSchema: z.ZodObject<{
+    fid: z.ZodNumber;
+    type: z.ZodLiteral<"app_key">;
+    key: z.ZodString;
+}, z.core.$strip>;
+export type JsonFarcasterSignatureHeaderSchema = z.infer<typeof jsonFarcasterSignatureHeaderSchema>;

package/esm/schemas/shared.js

@@ -0,0 +1,106 @@
+import { z } from 'zod/v4';
+const SPECIAL_CHARS_PATTERN = /[@#$%^&*+=\/\\|~«»]/;
+const REPEATED_PUNCTUATION_PATTERN = /(!{2,}|\?{2,}|-{2,})/;
+// Unicode ranges for emoji detection:
+// \u{1F300}-\u{1F9FF} - Miscellaneous Symbols, Pictographs, Emoticons, Transport, Map, and Supplemental
+// \u{2702}-\u{27B0} - Dingbats
+// \u{2600}-\u{26FF} - Miscellaneous Symbols
+// \u{2B00}-\u{2BFF} - Miscellaneous Symbols and Arrows
+const EMOJI_PATTERN = /[\u{1F300}-\u{1F9FF}]|[\u{2702}-\u{27B0}]|[\u{2600}-\u{26FF}]|[\u{2B00}-\u{2BFF}]/u;
+export const createSimpleStringSchema = ({ max, noSpaces, } = {}) => {
+    const stringValidations = noSpaces
+        ? z
+            .string()
+            .max(max ?? Number.POSITIVE_INFINITY)
+            .regex(/^\S*$/, 'Spaces are not allowed')
+        : z.string().max(max ?? Number.POSITIVE_INFINITY);
+    return stringValidations
+        .refine((value) => !EMOJI_PATTERN.test(value), {
+        message: 'Emojis and symbols are not allowed',
+    })
+        .refine((value) => !SPECIAL_CHARS_PATTERN.test(value), {
+        message: 'Special characters (@, #, $, %, ^, &, *, +, =, /, \\, |, ~, «, ») are not allowed',
+    })
+        .refine((value) => !REPEATED_PUNCTUATION_PATTERN.test(value), {
+        message: 'Repeated punctuations (!!, ??, --) are not allowed',
+    });
+};
+export const secureUrlSchema = z
+    .string()
+    .url()
+    .startsWith('https://', { message: 'Must be an https url' })
+    .max(1024)
+    .refine((url) => !url.includes(' '), {
+    message: 'URL must not contain spaces',
+})
+    .refine((url) => {
+    try {
+        const hostname = new URL(url).hostname;
+        // Check for localhost
+        if (hostname === 'localhost' || hostname.endsWith('.localhost')) {
+            return false;
+        }
+        // Check for IPv4 addresses
+        const ipv4Regex = /^(\d{1,3}\.){3}\d{1,3}$/;
+        if (ipv4Regex.test(hostname)) {
+            return false;
+        }
+        // Check for IPv6 addresses (including brackets)
+        if (hostname.startsWith('[') && hostname.endsWith(']')) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'URL must not use IP addresses or localhost',
+});
+export const miniAppNameSchema = z.string().max(32);
+export const buttonTitleSchema = z.string().max(32);
+const CAIP_19_REGEX = /^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\/(?:[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}(?:\/[-.%a-zA-Z0-9]{1,78})?|native)$/;
+export const caip19TokenSchema = z
+    .string()
+    .regex(CAIP_19_REGEX, { message: 'Invalid CAIP-19 asset ID' });
+export const hexColorSchema = z
+    .string()
+    .regex(/^#([0-9A-F]{3}|[0-9A-F]{6})$/i, {
+    message: 'Invalid hex color code. It should be in the format #RRGGBB or #RGB.',
+});
+// Domain validation regex:
+// - Each label (part between dots) must start and end with alphanumeric
+// - Labels can contain hyphens in the middle
+// - Cannot have consecutive dots
+// - Must have at least one dot (TLD required)
+// - TLD must be at least 2 characters and only letters
+const DOMAIN_REGEX = /^(?!.*\.\.)([a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+export const domainSchema = z
+    .string()
+    .max(1024)
+    .regex(DOMAIN_REGEX, {
+    message: 'Must be a valid domain name (e.g., example.com, sub.example.com)',
+})
+    .refine((value) => !value.includes('://'), {
+    message: 'Domain must not include protocol (http://, https://, etc.)',
+})
+    .refine((value) => !value.includes('/'), {
+    message: 'Domain must not include path separators',
+})
+    .refine((value) => !value.includes('@'), {
+    message: 'Domain must not include @ symbol',
+})
+    .refine((value) => !value.includes(':'), {
+    message: 'Domain must not include port numbers',
+});
+export const aspectRatioSchema = z.union([z.literal('1:1'), z.literal('3:2')]);
+export const encodedJsonFarcasterSignatureSchema = z.object({
+    header: z.string(),
+    payload: z.string(),
+    signature: z.string(),
+});
+export const jsonFarcasterSignatureHeaderSchema = z.object({
+    fid: z.number(),
+    type: z.literal('app_key'),
+    key: z.string().startsWith('0x'),
+});

package/esm/solana.d.ts

@@ -0,0 +1,72 @@
+import { Connection as SolanaConnection, type SendOptions as SolanaSendOptions, type Transaction as SolanaTransaction, type VersionedTransaction as SolanaVersionedTransaction } from '@solana/web3.js';
+export { SolanaConnection };
+export type { SolanaSendOptions };
+export type SolanaCombinedTransaction = SolanaTransaction | SolanaVersionedTransaction;
+export type SolanaConnectRequestArguments = {
+    method: 'connect';
+};
+export type SolanaSignMessageRequestArguments = {
+    method: 'signMessage';
+    params: {
+        message: string;
+    };
+};
+export type SolanaSignAndSendTransactionRequestArguments = {
+    method: 'signAndSendTransaction';
+    params: {
+        transaction: SolanaCombinedTransaction;
+        options?: SolanaSendOptions;
+    };
+};
+export type SolanaSignTransactionRequestArguments<T extends SolanaCombinedTransaction = SolanaTransaction> = {
+    method: 'signTransaction';
+    params: {
+        transaction: T;
+    };
+};
+export type SolanaRequestFn = ((request: SolanaConnectRequestArguments) => Promise<{
+    publicKey: string;
+}>) & ((request: SolanaSignMessageRequestArguments) => Promise<{
+    signature: string;
+}>) & ((request: SolanaSignAndSendTransactionRequestArguments) => Promise<{
+    signature: string;
+}>) & (<T extends SolanaCombinedTransaction>(request: SolanaSignTransactionRequestArguments<T>) => Promise<{
+    signedTransaction: T;
+}>);
+export interface SolanaWalletProvider {
+    request: SolanaRequestFn;
+    signMessage(message: string): Promise<{
+        signature: string;
+    }>;
+    signTransaction<T extends SolanaCombinedTransaction>(transaction: T): Promise<{
+        signedTransaction: T;
+    }>;
+    signAndSendTransaction(input: {
+        transaction: SolanaCombinedTransaction;
+    }): Promise<{
+        signature: string;
+    }>;
+}
+export declare const createSolanaWalletProvider: (request: SolanaRequestFn) => SolanaWalletProvider;
+export type SolanaWireSignAndSendTransactionRequestArguments = {
+    method: 'signAndSendTransaction';
+    params: {
+        transaction: string;
+        options?: SolanaSendOptions;
+    };
+};
+export type SolanaWireSignTransactionRequestArguments = {
+    method: 'signTransaction';
+    params: {
+        transaction: string;
+    };
+};
+export type SolanaWireRequestFn = ((request: SolanaConnectRequestArguments) => Promise<{
+    publicKey: string;
+}>) & ((request: SolanaSignMessageRequestArguments) => Promise<{
+    signature: string;
+}>) & ((request: SolanaWireSignAndSendTransactionRequestArguments) => Promise<{
+    signature: string;
+}>) & ((request: SolanaWireSignTransactionRequestArguments) => Promise<{
+    signedTransaction: string;
+}>);

package/esm/solana.js

@@ -0,0 +1,11 @@
+import { Connection as SolanaConnection, } from '@solana/web3.js';
+export { SolanaConnection };
+export const createSolanaWalletProvider = (request) => ({
+    request,
+    signMessage: (msg) => request({ method: 'signMessage', params: { message: msg } }),
+    signTransaction: (transaction) => request({ method: 'signTransaction', params: { transaction } }),
+    signAndSendTransaction: (input) => request({
+        method: 'signAndSendTransaction',
+        params: input,
+    }),
+});

package/esm/solanaWire.d.ts

@@ -0,0 +1,3 @@
+import type { SolanaRequestFn, SolanaWireRequestFn } from './solana.ts';
+export declare function wrapSolanaProviderRequest(requestFn: SolanaRequestFn): SolanaWireRequestFn;
+export declare function unwrapSolanaProviderRequest(wrappedRequestFn: SolanaWireRequestFn): SolanaRequestFn;