# wallet_peerPayments

Lists pending PeerPay payments or receives one selected payment into the embedded BRC-100 wallet. Receiving requires an explicit messageId and internalizes funds before acknowledging the MessageBox item.

## Result

PeerPay inbox, receipt or processing status for the selected operation.

## Permissions

Embedded payment-wallet only. Receiving can internalize funds and acknowledge a message; it is a mutating operation, not a balance read.

## Definition 1 (full)

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

Lists pending PeerPay payments or receives one selected payment into the embedded BRC-100 wallet. Receiving requires an explicit messageId and internalizes funds before acknowledging the MessageBox item.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| operation | "list" \| "receive" | Yes |  |  |
| messageId | string | No |  | minLength: 1; maxLength: 256 |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "receive"
      ]
    },
    "messageId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

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