@metamask/snaps-rpc-methods
Version:
MetaMask Snaps JSON-RPC method implementations
244 lines • 16.4 kB
text/typescript
import type { JsonRpcEngineEndCallback } from "@metamask/json-rpc-engine";
import type { Messenger } from "@metamask/messenger";
import type { PermissionControllerHasPermissionAction } from "@metamask/permission-controller";
import type { UpdateInterfaceParams, UpdateInterfaceResult } from "@metamask/snaps-sdk";
import { type InferMatching } from "@metamask/snaps-utils";
import type { PendingJsonRpcResponse } from "@metamask/utils";
import type { JsonRpcRequestWithOrigin, SnapInterfaceControllerUpdateInterfaceAction } from "../types.mjs";
export type UpdateInterfaceMethodActions = PermissionControllerHasPermissionAction | SnapInterfaceControllerUpdateInterfaceAction;
/**
* Update an interactive interface. For use in
* [interactive UI](https://docs.metamask.io/snaps/features/custom-ui/interactive-ui/).
*
* @example
* ```tsx
* import { Box, Heading, Text } from '@metamask/snaps-sdk/jsx';
*
* // First, create an interface and get its ID.
* const id = await snap.request({
* method: 'snap_createInterface',
* params: {
* ui: (
* <Box>
* ...
* </Box>
* ),
* },
* });
*
* // Later, update the interface with new content using the ID.
* snap.request({
* method: 'snap_updateInterface',
* params: {
* id: 'interface-id',
* ui: (
* <Box>
* <Heading>Updated Interface</Heading>
* <Text>This interface has been updated.</Text>
* </Box>
* ),
* },
* });
* ```
*/
export declare const updateInterfaceHandler: {
implementation: typeof getUpdateInterfaceImplementation;
actionNames: ("SnapInterfaceController:updateInterface" | "PermissionController:hasPermission")[];
};
declare const UpdateInterfaceParametersStruct: import("@metamask/superstruct").Struct<{
id: string;
ui: import("@metamask/snaps-sdk").Panel | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AccountSelectorProps, "AccountSelector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AddressInputProps, "AddressInput"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AssetSelectorProps, "AssetSelector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ButtonProps, "Button"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CheckboxProps, "Checkbox"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").DateTimePickerProps, "DateTimePicker"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FormProps, "Form"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FieldProps, "Field"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FileInputProps, "FileInput"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").InputProps, "Input"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").DropdownProps, "Dropdown"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SelectorProps, "Selector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BoldProps, "Bold"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ItalicProps, "Italic"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AvatarProps, "Avatar"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AddressProps, "Address"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BoxProps, "Box"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CardProps, "Card"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ContainerProps, "Container"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CopyableProps, "Copyable"> | import("@metamask/snaps-sdk/jsx").SnapElement<Record<string, never>, "Divider"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").IconProps, "Icon"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").LinkProps, "Link"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").RowProps, "Row"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SectionProps, "Section"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CollapsibleSectionProps, "CollapsibleSection"> | import("@metamask/snaps-sdk/jsx").SnapElement<Record<string, never>, "Spinner"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").TextProps, "Text"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").TooltipProps, "Tooltip"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BannerProps, "Banner"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SkeletonProps, "Skeleton"> | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Copyable;
sensitive?: boolean | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Divider;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Heading;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Image;
} | {
type: import("@metamask/snaps-sdk").NodeType.Spinner;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Text;
markdown?: boolean | undefined;
} | {
value: `0x${string}`;
type: import("@metamask/snaps-sdk").NodeType.Address;
} | {
value: {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Image;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Text;
markdown?: boolean | undefined;
} | {
value: `0x${string}`;
type: import("@metamask/snaps-sdk").NodeType.Address;
};
type: import("@metamask/snaps-sdk").NodeType.Row;
label: string;
variant?: "default" | "critical" | "warning" | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Input;
name: string;
value?: string | undefined;
label?: string | undefined;
inputType?: "number" | "text" | "password" | undefined;
placeholder?: string | undefined;
error?: string | undefined;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Button;
variant?: "primary" | "secondary" | undefined;
name?: string | undefined;
buttonType?: "button" | "submit" | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Form;
name: string;
children: ({
type: import("@metamask/snaps-sdk").NodeType.Input;
name: string;
value?: string | undefined;
label?: string | undefined;
inputType?: "number" | "text" | "password" | undefined;
placeholder?: string | undefined;
error?: string | undefined;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Button;
variant?: "primary" | "secondary" | undefined;
name?: string | undefined;
buttonType?: "button" | "submit" | undefined;
})[];
} | import("@metamask/snaps-sdk/jsx").SnapElement<{
src: string;
alt?: string | undefined;
borderRadius?: import("@metamask/snaps-sdk/jsx").BorderRadius;
height?: number | undefined;
width?: number | undefined;
}, "Image"> | import("@metamask/snaps-sdk/jsx").SnapElement<{
name: string;
value?: string | undefined;
children: import("@metamask/snaps-sdk/jsx").SnapsChildren<import("@metamask/snaps-sdk/jsx").SnapElement<{
value: string;
children: string;
disabled?: boolean | undefined;
}, "Radio">>;
disabled?: boolean | undefined;
}, "RadioGroup"> | import("@metamask/snaps-sdk/jsx").SnapElement<{
children: import("@metamask/snaps-sdk/jsx").StringElement;
size?: "sm" | "md" | "lg" | undefined;
}, "Heading">;
context?: Record<string, import("@metamask/snaps-sdk").Json> | undefined;
}, {
id: import("@metamask/superstruct").Struct<string, null>;
ui: import("@metamask/superstruct").Struct<import("@metamask/snaps-sdk").Panel | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AccountSelectorProps, "AccountSelector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AddressInputProps, "AddressInput"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AssetSelectorProps, "AssetSelector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ButtonProps, "Button"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CheckboxProps, "Checkbox"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").DateTimePickerProps, "DateTimePicker"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FormProps, "Form"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FieldProps, "Field"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").FileInputProps, "FileInput"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").InputProps, "Input"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").DropdownProps, "Dropdown"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SelectorProps, "Selector"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BoldProps, "Bold"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ItalicProps, "Italic"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AvatarProps, "Avatar"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").AddressProps, "Address"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BoxProps, "Box"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CardProps, "Card"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").ContainerProps, "Container"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CopyableProps, "Copyable"> | import("@metamask/snaps-sdk/jsx").SnapElement<Record<string, never>, "Divider"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").IconProps, "Icon"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").LinkProps, "Link"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").RowProps, "Row"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SectionProps, "Section"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").CollapsibleSectionProps, "CollapsibleSection"> | import("@metamask/snaps-sdk/jsx").SnapElement<Record<string, never>, "Spinner"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").TextProps, "Text"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").TooltipProps, "Tooltip"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").BannerProps, "Banner"> | import("@metamask/snaps-sdk/jsx").SnapElement<import("@metamask/snaps-sdk/jsx").SkeletonProps, "Skeleton"> | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Copyable;
sensitive?: boolean | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Divider;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Heading;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Image;
} | {
type: import("@metamask/snaps-sdk").NodeType.Spinner;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Text;
markdown?: boolean | undefined;
} | {
value: `0x${string}`;
type: import("@metamask/snaps-sdk").NodeType.Address;
} | {
value: {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Image;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Text;
markdown?: boolean | undefined;
} | {
value: `0x${string}`;
type: import("@metamask/snaps-sdk").NodeType.Address;
};
type: import("@metamask/snaps-sdk").NodeType.Row;
label: string;
variant?: "default" | "critical" | "warning" | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Input;
name: string;
value?: string | undefined;
label?: string | undefined;
inputType?: "number" | "text" | "password" | undefined;
placeholder?: string | undefined;
error?: string | undefined;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Button;
variant?: "primary" | "secondary" | undefined;
name?: string | undefined;
buttonType?: "button" | "submit" | undefined;
} | {
type: import("@metamask/snaps-sdk").NodeType.Form;
name: string;
children: ({
type: import("@metamask/snaps-sdk").NodeType.Input;
name: string;
value?: string | undefined;
label?: string | undefined;
inputType?: "number" | "text" | "password" | undefined;
placeholder?: string | undefined;
error?: string | undefined;
} | {
value: string;
type: import("@metamask/snaps-sdk").NodeType.Button;
variant?: "primary" | "secondary" | undefined;
name?: string | undefined;
buttonType?: "button" | "submit" | undefined;
})[];
} | import("@metamask/snaps-sdk/jsx").SnapElement<{
src: string;
alt?: string | undefined;
borderRadius?: import("@metamask/snaps-sdk/jsx").BorderRadius;
height?: number | undefined;
width?: number | undefined;
}, "Image"> | import("@metamask/snaps-sdk/jsx").SnapElement<{
name: string;
value?: string | undefined;
children: import("@metamask/snaps-sdk/jsx").SnapsChildren<import("@metamask/snaps-sdk/jsx").SnapElement<{
value: string;
children: string;
disabled?: boolean | undefined;
}, "Radio">>;
disabled?: boolean | undefined;
}, "RadioGroup"> | import("@metamask/snaps-sdk/jsx").SnapElement<{
children: import("@metamask/snaps-sdk/jsx").StringElement;
size?: "sm" | "md" | "lg" | undefined;
}, "Heading">, null>;
context: import("@metamask/superstruct").Struct<Record<string, import("@metamask/snaps-sdk").Json> | undefined, null>;
}>;
export type UpdateInterfaceParameters = InferMatching<typeof UpdateInterfaceParametersStruct, UpdateInterfaceParams>;
/**
* The `snap_updateInterface` method implementation.
*
* @param req - The JSON-RPC request object.
* @param res - The JSON-RPC response object.
* @param _next - The `json-rpc-engine` "next" callback. Not used by this
* function.
* @param end - The `json-rpc-engine` "end" callback.
* @param _hooks - The RPC method hooks. Not used by this function.
* @param messenger - The messenger used to call controller actions.
* @returns Nothing.
*/
declare function getUpdateInterfaceImplementation(req: JsonRpcRequestWithOrigin<UpdateInterfaceParameters>, res: PendingJsonRpcResponse<UpdateInterfaceResult>, _next: unknown, end: JsonRpcEngineEndCallback, _hooks: never, messenger: Messenger<string, UpdateInterfaceMethodActions>): void;
export {};
//# sourceMappingURL=updateInterface.d.mts.map