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 catalog · Legacy local wallet; Legacy local identity; External BRC-100 wallet

Field	Type / required	Description
labelsJSON	string Optional	JSON array of label strings default: "[]"
labelQueryMode	"any" \| "all" Optional	See schema for details. default: "any"
includeLabels	boolean Optional	See schema for details. default: true
includeInputs	boolean Optional	See schema for details. default: false
includeInputSourceLockingScripts	boolean Optional	See schema for details. default: false
includeInputUnlockingScripts	boolean Optional	See schema for details. default: false
includeOutputs	boolean Optional	See schema for details. default: false
includeOutputLockingScripts	boolean Optional	See schema for details. default: false
limit	number Optional	See schema for details. default: 25
offset	number Optional	See schema for details. default: 0
seekPermission	boolean Optional	See schema for details.

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "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 catalog · Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Local Vault + sponsor

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

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "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"
}