# query

_Returns the latest revisions of on-chain objects._

## Type

```ts
;<T extends new (...args: any) => any>(
  query:
    | {
        ids: string[]
      }
    | {
        publicKey?: string
        mod?: string
        limit?: number
        offset?: number
        order?: 'ASC' | 'DEC'
      },
) => Promise<string[]>
```

### Parameters

#### `args`

An object with the query parameters.

{.compact}
| Key | Description |
| --------- | ------------------------------------------------------------------------------ |
| publicKey | Return latest revisions of on-chain objects owned by a public key |
| ids | Return latest revision of on-chain objects with ids in order |
| mod | Return the latest revision of on-chain objects created with this module specifier |
| limit | Limit the number of revisions returned |
| offset | Return results starting from offset |
| order | Order results in ascending or descending order |

### Return Value

Given the query parameters, returns an array of strings encoding the latest revisions of on-chain objects that matches the specified conditions.

## Description

The `args` object specifies the on-chain objects of which to return the latest revisions. One can either query by public key to obtain the latests revisions of objects currently owned by that public key

Conditions can be passed in to determine the on-chain objects. When multiple conditions are passed in, the latest revisions of the on-chain objects that satisfy all conditions are returned.

## Example

:::code source="../../../lib/test/lib/computer/query.test.ts" :::

<a href="https://github.com/bitcoin-computer/monorepo/blob/main/packages/lib/test/lib/computer/query.test.ts" target=_blank>Source</a>