Skip to main content

useMutation

Callable

  • useMutation<TAction, TChainId>(action: TAction, options?: ChainComposableOptions<TChainId> & { signer?: MaybeRefOrGetter<PolkadotSigner>; txOptions?: any }): { data: Ref<TxEvent, TxEvent>; error: Ref<unknown, unknown>; execute: (...args: Parameters<TAction>[length] extends 2 ? [submitOptions: SubmitOptions] : [submitOptions?: SubmitOptions]) => Subject<TxEvent>; status: Ref<error | idle | pending | success, error | idle | pending | success> }

  • Composable for sending transactions to chains.


    Type parameters

    • TAction: (tx: any, variables: any) => Transaction<any, any, any, any>
    • TChainId: any

    Parameters

    • action: TAction

      The function to create the transaction

    • optionaloptions: ChainComposableOptions<TChainId> & { signer?: MaybeRefOrGetter<PolkadotSigner>; txOptions?: any }

      Additional options

    Returns { data: Ref<TxEvent, TxEvent>; error: Ref<unknown, unknown>; execute: (...args: Parameters<TAction>[length] extends 2 ? [submitOptions: SubmitOptions] : [submitOptions?: SubmitOptions]) => Subject<TxEvent>; status: Ref<error | idle | pending | success, error | idle | pending | success> }

    The current transaction state & submit function

    • data: Ref<TxEvent, TxEvent>
    • error: Ref<unknown, unknown>
    • execute: (...args: Parameters<TAction>[length] extends 2 ? [submitOptions: SubmitOptions] : [submitOptions?: SubmitOptions]) => Subject<TxEvent>
        • (...args: Parameters<TAction>[length] extends 2 ? [submitOptions: SubmitOptions] : [submitOptions?: SubmitOptions]): Subject<TxEvent>
        • Parameters

          • rest...args: Parameters<TAction>[length] extends 2 ? [submitOptions: SubmitOptions] : [submitOptions?: SubmitOptions]

          Returns Subject<TxEvent>

    • status: Ref<error | idle | pending | success, error | idle | pending | success>