useReactorMutation

useReactorMutation is a React hook for calling update methods on Internet Computer canisters using a Reactor instance. It is the raw version of useActorMutation.

Import

import { useReactorMutation } from "@ic-reactor/react"

Usage

import { useReactorMutation } from "@ic-reactor/react"
import { backend } from "./reactor"

function CreatePost() {
  const { mutate, isPending } = useReactorMutation({
    reactor: backend, // 👈 Required
    functionName: "createPost",
  })

  return (
    <button
      onClick={() => mutate([{ title: "Hello", content: "World" }])}
      disabled={isPending}
    >
      {isPending ? "Creating..." : "Create Post"}
    </button>
  )
}

Options

Required Options

Option	Type	Description
reactor	Reactor<A, T>	The Reactor instance to use
functionName	string	The canister method to call

Optional Options

Same as useActorMutation.

Return Value

Returns a TanStack Query mutation result object, same as useActorMutation.

Examples

Basic Mutation

const { mutate } = useReactorMutation({
  reactor: backend,
  functionName: "transfer",
})

// Arguments are supplied at call time, not in the hook config
mutate([recipient, amount])

With Callbacks

const { mutate } = useReactorMutation({
  reactor: backend,
  functionName: "createPost",
  onSuccess: () => console.log("Post created!"),
})

See Also

• useActorMutation — Bound version
• Reactor Hooks Overview