Skip to content

useTransferFunds

Hook for transferring a fraction of account balance to a recipient.

Import

typescript
import { useTransferFunds } from '@growae/reactive-react'

Usage

tsx
import { useTransferFunds } from '@growae/reactive-react'

function TransferHalf() {
  const { mutate: transferFunds, isPending, isSuccess, data } = useTransferFunds()

  return (
    <div>
      <button
        onClick={() =>
          transferFunds({ fraction: 0.5, recipient: 'ak_...' })
        }
        disabled={isPending}
      >
        Transfer 50%
      </button>
      {isSuccess && <p>Tx: {data.hash}</p>}
    </div>
  )
}

Return Type

See TanStack Query mutation docs for full return type.

data

See transferFunds Return Type.

Parameters

See transferFunds Parameters for all available options.

Key parameters:

ParameterTypeDefaultDescription
fractionnumberRequired. Fraction of balance to transfer (0–1).
recipientstringRequired. Recipient address (ak_...).
ttlnumber300Transaction TTL in blocks.
waitMinedbooleantrueWhether to wait for the transaction to be mined.

mutation

See TanStack Query mutation docs for mutation options.

Action