# wallet_listActions

Lists wallet transactions filtered by labels, with optional input/output details.

## Result

The BRC-100 listActions result, encoded as JSON text. Wallet failures return an error result.

## Permissions

Forwarded to the connected wallet under the configured app origin. Its protocol, certificate or basket permission checks apply to the requested operation.

Use walletRole to choose an assigned wallet. Otherwise the configured role is used. A disabled role cannot borrow another key.

## Definition 1 (full)

Registered in: Legacy local wallet; Legacy local identity; External BRC-100 wallet.

Lists wallet transactions filtered by labels, with optional input/output details.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| labelsJSON | string | No | JSON array of label strings | default: "[]" |
| labelQueryMode | "any" \| "all" | No |  | default: "any" |
| includeLabels | boolean | No |  | default: true |
| includeInputs | boolean | No |  | default: false |
| includeInputSourceLockingScripts | boolean | No |  | default: false |
| includeInputUnlockingScripts | boolean | No |  | default: false |
| includeOutputs | boolean | No |  | default: false |
| includeOutputLockingScripts | boolean | No |  | default: false |
| limit | number | No |  | default: 25 |
| offset | number | No |  | default: 0 |
| seekPermission | boolean | No |  |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "labelsJSON": {
      "default": "[]",
      "description": "JSON array of label strings",
      "type": "string"
    },
    "labelQueryMode": {
      "default": "any",
      "type": "string",
      "enum": [
        "any",
        "all"
      ]
    },
    "includeLabels": {
      "default": true,
      "type": "boolean"
    },
    "includeInputs": {
      "default": false,
      "type": "boolean"
    },
    "includeInputSourceLockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "includeInputUnlockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "includeOutputs": {
      "default": false,
      "type": "boolean"
    },
    "includeOutputLockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "type": "number"
    },
    "offset": {
      "default": 0,
      "type": "number"
    },
    "seekPermission": {
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Definition 2 (full)

Registered in: Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Local Vault + sponsor.

Lists wallet transactions filtered by labels, with optional input/output details.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| labelsJSON | string | No | JSON array of label strings | default: "[]" |
| labelQueryMode | "any" \| "all" | No |  | default: "any" |
| includeLabels | boolean | No |  | default: true |
| includeInputs | boolean | No |  | default: false |
| includeInputSourceLockingScripts | boolean | No |  | default: false |
| includeInputUnlockingScripts | boolean | No |  | default: false |
| includeOutputs | boolean | No |  | default: false |
| includeOutputLockingScripts | boolean | No |  | default: false |
| limit | number | No |  | default: 25 |
| offset | number | No |  | default: 0 |
| seekPermission | boolean | No |  |  |
| walletRole | "payments" \| "identity" \| "ordinals" \| "encryption" | No | Select the configured root key for this BRC-100 call. Defaults to the role for the method; action continuations retain their original role. |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "labelsJSON": {
      "default": "[]",
      "description": "JSON array of label strings",
      "type": "string"
    },
    "labelQueryMode": {
      "default": "any",
      "type": "string",
      "enum": [
        "any",
        "all"
      ]
    },
    "includeLabels": {
      "default": true,
      "type": "boolean"
    },
    "includeInputs": {
      "default": false,
      "type": "boolean"
    },
    "includeInputSourceLockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "includeInputUnlockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "includeOutputs": {
      "default": false,
      "type": "boolean"
    },
    "includeOutputLockingScripts": {
      "default": false,
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "type": "number"
    },
    "offset": {
      "default": 0,
      "type": "number"
    },
    "seekPermission": {
      "type": "boolean"
    },
    "walletRole": {
      "description": "Select the configured root key for this BRC-100 call. Defaults to the role for the method; action continuations retain their original role.",
      "type": "string",
      "enum": [
        "payments",
        "identity",
        "ordinals",
        "encryption"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

[All tools](https://bsvmcp.com/docs/tools)