# 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.

In role-routed configurations, walletRole selects an assigned wallet. Identity methods default to the identity role; encryption and HMAC use the encryption role. Transaction and basket operations follow their assigned role. An unavailable role fails rather than borrowing 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)