# createQueryFactory

> **createQueryFactory**\<`Service`, `Transform`, `Method`, `Selected`\>(`reactor`, `config`): [`SkippableQueryFactoryFn`](https://ic-reactor.b3pay.net/v3/libs/interfaces/skippablequeryfactoryfn/)\<[`ReactorArgs`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorargs/)\<`Service`, `Method`, `Transform`\>, [`QueryResult`](https://ic-reactor.b3pay.net/v3/libs/interfaces/queryresult/)\<[`QueryFnData`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryfndata/)\<`Service`, `Method`, `Transform`\>, `Selected`, [`QueryError`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryerror/)\<`Service`, `Method`, `Transform`\>\>\>

Defined in: [react/src/createQuery.ts:293](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createQuery.ts#L293)

Create a query factory: a function that takes the method's args and returns
the query object for them, the same object for the same args.

The function also has `getQueryKey()`, the key prefix every query it
returns shares, and `invalidate()`, which invalidates all of them whatever
their args. Pass the function itself to a mutation's `invalidateQueries` to
refresh every instance after the mutation.

It also takes TanStack Query's `skipToken` in place of args, for a
component whose args are not known yet, and returns a query with only
`useQuery()`, which waits without fetching; see
[SkippableQueryFactoryFn](https://ic-reactor.b3pay.net/v3/libs/interfaces/skippablequeryfactoryfn/).

## Type Parameters

### Service

`Service`

### Transform

`Transform` *extends* keyof [`TransformArgsRegistry`](https://ic-reactor.b3pay.net/v3/libs/interfaces/transformargsregistry/)\<`unknown`\>

### Method

`Method` *extends* `string` = [`FunctionName`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/functionname/)\<`Service`\>

### Selected

`Selected` = [`QueryFnData`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryfndata/)\<`Service`, `Method`, `Transform`\>

## Parameters

### reactor

[`Reactor`](https://ic-reactor.b3pay.net/v3/libs/classes/reactor/)\<`Service`, `Transform`\>

### config

[`QueryFactoryConfig`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryfactoryconfig/)\<[`NoInfer`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/noinfer/)\<`Service`\>, `Method`, `Transform`, `Selected`\>

## Returns

[`SkippableQueryFactoryFn`](https://ic-reactor.b3pay.net/v3/libs/interfaces/skippablequeryfactoryfn/)\<[`ReactorArgs`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorargs/)\<`Service`, `Method`, `Transform`\>, [`QueryResult`](https://ic-reactor.b3pay.net/v3/libs/interfaces/queryresult/)\<[`QueryFnData`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryfndata/)\<`Service`, `Method`, `Transform`\>, `Selected`, [`QueryError`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/queryerror/)\<`Service`, `Method`, `Transform`\>\>\>

## Example

```ts
const getBalance = createQueryFactory(ledger, {
  functionName: "icrc1_balance_of",
})

// In a component
const { data } = getBalance([{ owner, subaccount: [] }]).useQuery()

// In a component whose owner may not be known yet
const { data: maybe } = getBalance(
  owner ? [{ owner, subaccount: [] }] : skipToken
).useQuery()

// Refetch every account's balance after a transfer
const transfer = createMutation(ledger, {
  functionName: "icrc1_transfer",
  invalidateQueries: [getBalance],
})
```