@farcaster/snap 2.7.0 → 2.7.1

package/dist/react/index.d.ts

@@ -13,6 +13,27 @@ export type SnapPage = {
     effects?: string[];
     ui: Spec;
 };
+export type SnapSendTransactionParams = {
+    chainId: string;
+    to: string;
+    data?: string;
+    value?: string;
+    gas?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+};
+export type SnapSendCallsParams = {
+    version?: "1.0";
+    chainId: string;
+    atomicRequired?: boolean;
+    id?: string;
+    calls: Array<{
+        to?: string;
+        data?: string;
+        value?: string;
+    }>;
+};
 export type SnapActionHandlers = {
     submit: (target: string, inputs: Record<string, JsonValue>) => void;
     open_url: (target: string) => void;
@@ -42,6 +63,8 @@ export type SnapActionHandlers = {
         sellToken?: string;
         buyToken?: string;
     }) => void;
+    send_transaction?: (params: SnapSendTransactionParams) => void;
+    send_calls?: (params: SnapSendCallsParams) => void;
 };
 export type { SnapRenderState };
 export declare function SnapCard({ snap, handlers, loading, appearance, maxWidth, showOverflowWarning, onValidationError, validationErrorFallback, actionError, plain, loadingOverlay, initialRenderState, onRenderStateChange, }: {

package/dist/react/snap-view-core.js

@@ -8,6 +8,14 @@ import { resolveSnapPaletteHex } from "./lib/resolve-palette-hex.js";
 import { snapPreviewPrimaryCssProperties } from "./lib/preview-primary-css.js";
 import { applyStatePaths, buildInitialRenderState, cloneSnapRenderState, getUnpresentedSnapEffects, markSnapEffectsPresented, } from "../render-state.js";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+function asRecord(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function optionalString(value) {
+    return value ? String(value) : undefined;
+}
 function withDefaultElementProps(spec) {
     if (!spec || typeof spec !== "object" || !("elements" in spec))
         return spec;
@@ -330,6 +338,38 @@ export function SnapViewCore({ snap, handlers, loading = false, appearance = "da
                     buyToken: p.buyToken ? String(p.buyToken) : undefined,
                 });
                 break;
+            case "send_transaction":
+                handlers.send_transaction?.({
+                    chainId: String(p.chainId ?? ""),
+                    to: String(p.to ?? ""),
+                    data: optionalString(p.data),
+                    value: optionalString(p.value),
+                    gas: optionalString(p.gas),
+                    gasPrice: optionalString(p.gasPrice),
+                    maxFeePerGas: optionalString(p.maxFeePerGas),
+                    maxPriorityFeePerGas: optionalString(p.maxPriorityFeePerGas),
+                });
+                break;
+            case "send_calls":
+                handlers.send_calls?.({
+                    version: p.version === "1.0" ? "1.0" : undefined,
+                    chainId: String(p.chainId ?? ""),
+                    atomicRequired: typeof p.atomicRequired === "boolean"
+                        ? p.atomicRequired
+                        : undefined,
+                    id: optionalString(p.id),
+                    calls: Array.isArray(p.calls)
+                        ? p.calls.map((call) => {
+                            const c = asRecord(call);
+                            return {
+                                to: optionalString(c.to),
+                                data: optionalString(c.data),
+                                value: optionalString(c.value),
+                            };
+                        })
+                        : [],
+                });
+                break;
             default:
                 break;
         }

package/dist/react-native/snap-view-core.js

@@ -9,6 +9,14 @@ import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { ActivityIndicator, StyleSheet, View } from "react-native";
 import { DEFAULT_THEME_ACCENT, PALETTE_LIGHT_HEX, PALETTE_DARK_HEX, } from "@farcaster/snap";
 import { applyStatePaths, buildInitialRenderState, cloneSnapRenderState, getUnpresentedSnapEffects, markSnapEffectsPresented, } from "../render-state.js";
+function asRecord(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function optionalString(value) {
+    return value ? String(value) : undefined;
+}
 function withDefaultElementProps(spec) {
     if (!spec || typeof spec !== "object" || !("elements" in spec))
         return spec;
@@ -155,6 +163,38 @@ export function SnapViewCoreInner({ snap, handlers, loading = false, loadingOver
                     buyToken: p.buyToken ? String(p.buyToken) : undefined,
                 });
                 break;
+            case "send_transaction":
+                h.send_transaction?.({
+                    chainId: String(p.chainId ?? ""),
+                    to: String(p.to ?? ""),
+                    data: optionalString(p.data),
+                    value: optionalString(p.value),
+                    gas: optionalString(p.gas),
+                    gasPrice: optionalString(p.gasPrice),
+                    maxFeePerGas: optionalString(p.maxFeePerGas),
+                    maxPriorityFeePerGas: optionalString(p.maxPriorityFeePerGas),
+                });
+                break;
+            case "send_calls":
+                h.send_calls?.({
+                    version: p.version === "1.0" ? "1.0" : undefined,
+                    chainId: String(p.chainId ?? ""),
+                    atomicRequired: typeof p.atomicRequired === "boolean"
+                        ? p.atomicRequired
+                        : undefined,
+                    id: optionalString(p.id),
+                    calls: Array.isArray(p.calls)
+                        ? p.calls.map((call) => {
+                            const c = asRecord(call);
+                            return {
+                                to: optionalString(c.to),
+                                data: optionalString(c.data),
+                                value: optionalString(c.value),
+                            };
+                        })
+                        : [],
+                });
+                break;
             default:
                 break;
         }

package/dist/react-native/types.d.ts

@@ -12,6 +12,27 @@ export type SnapPage = {
     effects?: string[];
     ui: Spec;
 };
+export type SnapSendTransactionParams = {
+    chainId: string;
+    to: string;
+    data?: string;
+    value?: string;
+    gas?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+};
+export type SnapSendCallsParams = {
+    version?: "1.0";
+    chainId: string;
+    atomicRequired?: boolean;
+    id?: string;
+    calls: Array<{
+        to?: string;
+        data?: string;
+        value?: string;
+    }>;
+};
 export type SnapActionHandlers = {
     submit: (target: string, inputs: Record<string, JsonValue>) => void;
     open_url: (target: string) => void;
@@ -41,4 +62,6 @@ export type SnapActionHandlers = {
         sellToken?: string;
         buyToken?: string;
     }) => void;
+    send_transaction?: (params: SnapSendTransactionParams) => void;
+    send_calls?: (params: SnapSendCallsParams) => void;
 };

package/dist/ui/catalog.d.ts

@@ -572,6 +572,33 @@ export declare const snapJsonRenderCatalog: import("@json-render/core").Catalog<
                 buyToken: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         };
+        send_transaction: {
+            description: string;
+            params: z.ZodObject<{
+                chainId: z.ZodString;
+                to: z.ZodString;
+                data: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodString>;
+                gas: z.ZodOptional<z.ZodString>;
+                gasPrice: z.ZodOptional<z.ZodString>;
+                maxFeePerGas: z.ZodOptional<z.ZodString>;
+                maxPriorityFeePerGas: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
+        send_calls: {
+            description: string;
+            params: z.ZodObject<{
+                version: z.ZodOptional<z.ZodLiteral<"1.0">>;
+                chainId: z.ZodString;
+                atomicRequired: z.ZodOptional<z.ZodBoolean>;
+                id: z.ZodOptional<z.ZodString>;
+                calls: z.ZodArray<z.ZodObject<{
+                    to: z.ZodOptional<z.ZodString>;
+                    data: z.ZodOptional<z.ZodString>;
+                    value: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        };
         paginator_next: {
             description: string;
             params: z.ZodObject<{

package/dist/ui/catalog.js

@@ -151,6 +151,33 @@ export const snapJsonRenderCatalog = defineCatalog(snapJsonRenderSchema, {
                 buyToken: z.string().optional(),
             }),
         },
+        send_transaction: {
+            description: "Request an EVM transaction through the host wallet using eth_sendTransaction.",
+            params: z.object({
+                chainId: z.string(),
+                to: z.string(),
+                data: z.string().optional(),
+                value: z.string().optional(),
+                gas: z.string().optional(),
+                gasPrice: z.string().optional(),
+                maxFeePerGas: z.string().optional(),
+                maxPriorityFeePerGas: z.string().optional(),
+            }),
+        },
+        send_calls: {
+            description: "Request one or more EVM calls through the host wallet using wallet_sendCalls.",
+            params: z.object({
+                version: z.literal("1.0").optional(),
+                chainId: z.string(),
+                atomicRequired: z.boolean().optional(),
+                id: z.string().optional(),
+                calls: z.array(z.object({
+                    to: z.string().optional(),
+                    data: z.string().optional(),
+                    value: z.string().optional(),
+                })),
+            }),
+        },
         paginator_next: {
             description: "Move the snap's paginator to the next page locally. Does not POST and is ignored when no paginator is rendered.",
             params: z.object({ page: z.number().int().min(0).optional() }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/snap",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "Farcaster Snaps 🫰",
   "repository": {
     "type": "git",

package/src/react/index.tsx

@@ -25,6 +25,29 @@ export type SnapPage = {
   ui: Spec;
 };
 
+export type SnapSendTransactionParams = {
+  chainId: string;
+  to: string;
+  data?: string;
+  value?: string;
+  gas?: string;
+  gasPrice?: string;
+  maxFeePerGas?: string;
+  maxPriorityFeePerGas?: string;
+};
+
+export type SnapSendCallsParams = {
+  version?: "1.0";
+  chainId: string;
+  atomicRequired?: boolean;
+  id?: string;
+  calls: Array<{
+    to?: string;
+    data?: string;
+    value?: string;
+  }>;
+};
+
 export type SnapActionHandlers = {
   submit: (target: string, inputs: Record<string, JsonValue>) => void;
   open_url: (target: string) => void;
@@ -45,6 +68,8 @@ export type SnapActionHandlers = {
     recipientAddress?: string;
   }) => void;
   swap_token: (params: { sellToken?: string; buyToken?: string }) => void;
+  send_transaction?: (params: SnapSendTransactionParams) => void;
+  send_calls?: (params: SnapSendCallsParams) => void;
 };
 
 export type { SnapRenderState };

package/src/react/snap-view-core.tsx

@@ -26,6 +26,16 @@ import {
 } from "react";
 import type { JsonValue, SnapActionHandlers, SnapPage } from "./index";
 
+function asRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === "object"
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+function optionalString(value: unknown): string | undefined {
+  return value ? String(value) : undefined;
+}
+
 function withDefaultElementProps(spec: Spec): Spec {
   if (!spec || typeof spec !== "object" || !("elements" in spec)) return spec;
   const elements = spec.elements as unknown as Record<
@@ -493,6 +503,39 @@ export function SnapViewCore({
             buyToken: p.buyToken ? String(p.buyToken) : undefined,
           });
           break;
+        case "send_transaction":
+          handlers.send_transaction?.({
+            chainId: String(p.chainId ?? ""),
+            to: String(p.to ?? ""),
+            data: optionalString(p.data),
+            value: optionalString(p.value),
+            gas: optionalString(p.gas),
+            gasPrice: optionalString(p.gasPrice),
+            maxFeePerGas: optionalString(p.maxFeePerGas),
+            maxPriorityFeePerGas: optionalString(p.maxPriorityFeePerGas),
+          });
+          break;
+        case "send_calls":
+          handlers.send_calls?.({
+            version: p.version === "1.0" ? "1.0" : undefined,
+            chainId: String(p.chainId ?? ""),
+            atomicRequired:
+              typeof p.atomicRequired === "boolean"
+                ? p.atomicRequired
+                : undefined,
+            id: optionalString(p.id),
+            calls: Array.isArray(p.calls)
+              ? p.calls.map((call) => {
+                  const c = asRecord(call);
+                  return {
+                    to: optionalString(c.to),
+                    data: optionalString(c.data),
+                    value: optionalString(c.value),
+                  };
+                })
+              : [],
+          });
+          break;
         default:
           break;
       }

package/src/react-native/snap-view-core.tsx

@@ -30,6 +30,16 @@ import {
 } from "../render-state";
 import type { SnapPage, SnapActionHandlers, JsonValue } from "./types";
 
+function asRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === "object"
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+function optionalString(value: unknown): string | undefined {
+  return value ? String(value) : undefined;
+}
+
 function withDefaultElementProps(spec: Spec): Spec {
   if (!spec || typeof spec !== "object" || !("elements" in spec)) return spec;
   const elements = spec.elements as unknown as Record<
@@ -228,6 +238,39 @@ export function SnapViewCoreInner({
           buyToken: p.buyToken ? String(p.buyToken) : undefined,
         });
         break;
+      case "send_transaction":
+        h.send_transaction?.({
+          chainId: String(p.chainId ?? ""),
+          to: String(p.to ?? ""),
+          data: optionalString(p.data),
+          value: optionalString(p.value),
+          gas: optionalString(p.gas),
+          gasPrice: optionalString(p.gasPrice),
+          maxFeePerGas: optionalString(p.maxFeePerGas),
+          maxPriorityFeePerGas: optionalString(p.maxPriorityFeePerGas),
+        });
+        break;
+      case "send_calls":
+        h.send_calls?.({
+          version: p.version === "1.0" ? "1.0" : undefined,
+          chainId: String(p.chainId ?? ""),
+          atomicRequired:
+            typeof p.atomicRequired === "boolean"
+              ? p.atomicRequired
+              : undefined,
+          id: optionalString(p.id),
+          calls: Array.isArray(p.calls)
+            ? p.calls.map((call) => {
+                const c = asRecord(call);
+                return {
+                  to: optionalString(c.to),
+                  data: optionalString(c.data),
+                  value: optionalString(c.value),
+                };
+              })
+            : [],
+        });
+        break;
       default:
         break;
     }

package/src/react-native/types.ts

@@ -18,6 +18,29 @@ export type SnapPage = {
   ui: Spec;
 };
 
+export type SnapSendTransactionParams = {
+  chainId: string;
+  to: string;
+  data?: string;
+  value?: string;
+  gas?: string;
+  gasPrice?: string;
+  maxFeePerGas?: string;
+  maxPriorityFeePerGas?: string;
+};
+
+export type SnapSendCallsParams = {
+  version?: "1.0";
+  chainId: string;
+  atomicRequired?: boolean;
+  id?: string;
+  calls: Array<{
+    to?: string;
+    data?: string;
+    value?: string;
+  }>;
+};
+
 export type SnapActionHandlers = {
   submit: (target: string, inputs: Record<string, JsonValue>) => void;
   open_url: (target: string) => void;
@@ -38,4 +61,6 @@ export type SnapActionHandlers = {
     recipientAddress?: string;
   }) => void;
   swap_token: (params: { sellToken?: string; buyToken?: string }) => void;
+  send_transaction?: (params: SnapSendTransactionParams) => void;
+  send_calls?: (params: SnapSendCallsParams) => void;
 };

package/src/ui/catalog.ts

@@ -172,6 +172,37 @@ export const snapJsonRenderCatalog = defineCatalog(snapJsonRenderSchema, {
         buyToken: z.string().optional(),
       }),
     },
+    send_transaction: {
+      description:
+        "Request an EVM transaction through the host wallet using eth_sendTransaction.",
+      params: z.object({
+        chainId: z.string(),
+        to: z.string(),
+        data: z.string().optional(),
+        value: z.string().optional(),
+        gas: z.string().optional(),
+        gasPrice: z.string().optional(),
+        maxFeePerGas: z.string().optional(),
+        maxPriorityFeePerGas: z.string().optional(),
+      }),
+    },
+    send_calls: {
+      description:
+        "Request one or more EVM calls through the host wallet using wallet_sendCalls.",
+      params: z.object({
+        version: z.literal("1.0").optional(),
+        chainId: z.string(),
+        atomicRequired: z.boolean().optional(),
+        id: z.string().optional(),
+        calls: z.array(
+          z.object({
+            to: z.string().optional(),
+            data: z.string().optional(),
+            value: z.string().optional(),
+          }),
+        ),
+      }),
+    },
     paginator_next: {
       description:
         "Move the snap's paginator to the next page locally. Does not POST and is ignored when no paginator is rendered.",