feat: add transfer and useTransfer

core/substrate/balances/mod.ts

@@ -1 +1,3 @@
 export * from './getBalance.ts';
+export * from './transfer.ts';
+

core/substrate/balances/transfer.ts

@@ -0,0 +1,19 @@
+import {
+  AddressOrPair,
+  ApiPromise,
+  Hash,
+  SignerOptions,
+} from '../../types/mod.ts';
+
+export const transfer = async (
+  api: ApiPromise | undefined,
+  to: string | undefined,
+  amount: number,
+  signer: AddressOrPair,
+  options?: SignerOptions,
+): Promise<Hash | undefined> => {
+  if (!api?.tx?.balances?.transfer || !to) return;
+  const transfer = api.tx.balances.transfer(to, amount);
+
+  return await transfer.signAndSend(signer, options);
+};

core/types/substrate.ts

@@ -23,6 +23,7 @@ export type {
   DispatchError,
   EventRecord,
   ExtrinsicStatus,
+  Hash,
   Header,
   RuntimeDispatchInfo,
   StorageDeposit,
@@ -31,6 +32,7 @@ export type {
 } from '@polkadot/types/interfaces';
 
 export type {
+  AddressOrPair,
   ApiBase,
   QueryableModuleCalls,
   SignerOptions,

react/hooks/substrate/mod.ts

@@ -1,3 +1,4 @@
 export * from './useApi.ts';
 export * from './useBalance.ts';
 export * from './useBlockHeader.ts';
+export * from './useTransfer.ts';

react/hooks/substrate/useTransfer.ts

@@ -0,0 +1,47 @@
+import { useCallback, useMemo, useState } from 'react';
+import { useApi } from './useApi.ts';
+import { ChainId } from '../../../chains/mod.ts';
+import { useChain, useWallet } from '../mod.ts';
+import { Hash, SignerOptions, transfer } from '../../../core/mod.ts';
+
+export type SignAndSendTransfer = (
+  to: string,
+  amount: number,
+  options?: SignerOptions,
+) => void;
+
+export interface TransferState {
+  signAndSend: SignAndSendTransfer;
+  hash: Hash | undefined;
+  error: unknown | undefined;
+  resetState: () => void;
+  isSubmitting: boolean;
+}
+
+export const useTransfer = (chainId?: ChainId): TransferState | undefined => {
+  const [hash, setHash] = useState<Hash>();
+  const [error, setError] = useState<unknown>();
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const { account } = useWallet();
+  const chainConfig = useChain(chainId);
+  const chain = useApi(chainConfig?.id);
+
+  const resetState = useCallback(() => {
+    setHash(undefined);
+    setError(undefined);
+  }, []);
+
+  const signAndSend: SignAndSendTransfer = useMemo(
+    () => (to, amount, options) => {
+      if (!chain?.api || !account || !account.address || !account.wallet) {
+        return;
+      }
+      setIsSubmitting(true);
+      transfer(chain.api, to, amount, account?.wallet.extension.signer, options)
+        .then(setHash).catch(setError).finally(() => setIsSubmitting(false));
+    },
+    [chain?.api, account?.address],
+  );
+
+  return { signAndSend, error, hash, resetState, isSubmitting };
+};