# wallet_read

Read-only wallet operations. Select operation and pass that operation's arguments in args.

## Result

The selected full-tool operation's result, wrapped by the compact dispatcher.

## Permissions

Uses the selected wallet's read permissions. Whole-wallet balance is absent for external signers.

## Compact operations

Pass the full tool name as operation and its inputs as args.

- [wallet_getAddress](https://bsvmcp.com/docs/tools/wallet_getAddress)
- [wallet_getBalance](https://bsvmcp.com/docs/tools/wallet_getBalance)
- [wallet_getOrdinals](https://bsvmcp.com/docs/tools/wallet_getOrdinals)
- [wallet_listTokens](https://bsvmcp.com/docs/tools/wallet_listTokens)
- [wallet_getBsv21Balances](https://bsvmcp.com/docs/tools/wallet_getBsv21Balances)
- [wallet_getLockData](https://bsvmcp.com/docs/tools/wallet_getLockData)
- [wallet_getHeight](https://bsvmcp.com/docs/tools/wallet_getHeight)
- [wallet_getHeaderForHeight](https://bsvmcp.com/docs/tools/wallet_getHeaderForHeight)
- [wallet_getNetwork](https://bsvmcp.com/docs/tools/wallet_getNetwork)
- [wallet_getVersion](https://bsvmcp.com/docs/tools/wallet_getVersion)
- [wallet_getPublicKey](https://bsvmcp.com/docs/tools/wallet_getPublicKey)
- [wallet_isAuthenticated](https://bsvmcp.com/docs/tools/wallet_isAuthenticated)
- [wallet_waitForAuthentication](https://bsvmcp.com/docs/tools/wallet_waitForAuthentication)

## Definition 1 (compact)

Registered in: Legacy local wallet; Legacy local identity.

Read-only wallet operations. Select operation and pass that operation's arguments in args.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "wallet_getAddress" \| "wallet_getBalance" \| "wallet_getOrdinals" \| "wallet_listTokens" \| "wallet_getBsv21Balances" \| "wallet_getLockData" | Yes |  |  |
| args | object | No |  | default: {} |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "wallet_getAddress",
        "wallet_getBalance",
        "wallet_getOrdinals",
        "wallet_listTokens",
        "wallet_getBsv21Balances",
        "wallet_getLockData"
      ]
    },
    "args": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Definition 2 (compact)

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

Read-only wallet operations. Select operation and pass that operation's arguments in args.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "wallet_getAddress" \| "wallet_getBalance" \| "wallet_getOrdinals" \| "wallet_listTokens" \| "wallet_getBsv21Balances" \| "wallet_getLockData" \| "wallet_getHeight" \| "wallet_getHeaderForHeight" \| "wallet_getNetwork" \| "wallet_getVersion" \| "wallet_getPublicKey" \| "wallet_isAuthenticated" \| "wallet_waitForAuthentication" | Yes |  |  |
| args | object | No |  | default: {} |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "wallet_getAddress",
        "wallet_getBalance",
        "wallet_getOrdinals",
        "wallet_listTokens",
        "wallet_getBsv21Balances",
        "wallet_getLockData",
        "wallet_getHeight",
        "wallet_getHeaderForHeight",
        "wallet_getNetwork",
        "wallet_getVersion",
        "wallet_getPublicKey",
        "wallet_isAuthenticated",
        "wallet_waitForAuthentication"
      ]
    },
    "args": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Definition 3 (compact)

Registered in: Local Vault · payment role only.

Read-only wallet operations. Select operation and pass that operation's arguments in args.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "wallet_getAddress" \| "wallet_getBalance" \| "wallet_getHeight" \| "wallet_getHeaderForHeight" \| "wallet_getNetwork" \| "wallet_getVersion" \| "wallet_getPublicKey" \| "wallet_isAuthenticated" \| "wallet_waitForAuthentication" | Yes |  |  |
| args | object | No |  | default: {} |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "wallet_getAddress",
        "wallet_getBalance",
        "wallet_getHeight",
        "wallet_getHeaderForHeight",
        "wallet_getNetwork",
        "wallet_getVersion",
        "wallet_getPublicKey",
        "wallet_isAuthenticated",
        "wallet_waitForAuthentication"
      ]
    },
    "args": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Definition 4 (compact)

Registered in: Project · payments scope.

Read-only wallet operations. Select operation and pass that operation's arguments in args.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "wallet_getAddress" \| "wallet_getBalance" | Yes |  |  |
| args | object | No |  | default: {} |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "wallet_getAddress",
        "wallet_getBalance"
      ]
    },
    "args": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Definition 5 (compact)

Registered in: External BRC-100 wallet.

Read-only wallet operations. Select operation and pass that operation's arguments in args.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "wallet_getAddress" \| "wallet_getOrdinals" \| "wallet_listTokens" \| "wallet_getBsv21Balances" \| "wallet_getLockData" \| "wallet_getHeight" \| "wallet_getHeaderForHeight" \| "wallet_getNetwork" \| "wallet_getVersion" \| "wallet_getPublicKey" \| "wallet_isAuthenticated" \| "wallet_waitForAuthentication" | Yes |  |  |
| args | object | No |  | default: {} |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "wallet_getAddress",
        "wallet_getOrdinals",
        "wallet_listTokens",
        "wallet_getBsv21Balances",
        "wallet_getLockData",
        "wallet_getHeight",
        "wallet_getHeaderForHeight",
        "wallet_getNetwork",
        "wallet_getVersion",
        "wallet_getPublicKey",
        "wallet_isAuthenticated",
        "wallet_waitForAuthentication"
      ]
    },
    "args": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

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