# cloud.substratum.place.site

> Published by [official.fileorbit.cloud](https://lexicon.garden/identity/did:plc:s6kq5tsir7nbyrciloncz5b3)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.site)
- [Documentation](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.site/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.site/examples)

## Definitions

### `cloud.substratum.place.site`

**Type**: `object`

Durable place identity on the operator PDS (ADR 70).

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `placeId` | `string` | Yes | Stable place id (e.g. personal_node:{peer_id}). |
| `createdAt` | `string` (datetime) | Yes |  |
| `placeKind` | `string` | Yes | Place role; v1 personal_node only on ledger. |
| `meshPeerId` | `string` | No | libp2p peer id when known. |
| `displayName` | `string` | Yes |  |
| `operatorDid` | `string` (did) | Yes |  |
| `trustedSpaceOfferBytes` | `integer` | No | Bytes offered for household copies on this Place (default 0). |

## Raw Schema

```json
{
  "id": "cloud.substratum.place.site",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "placeId",
        "placeKind",
        "operatorDid",
        "displayName",
        "createdAt"
      ],
      "properties": {
        "placeId": {
          "type": "string",
          "description": "Stable place id (e.g. personal_node:{peer_id})."
        },
        "createdAt": {
          "type": "string",
          "format": "datetime"
        },
        "placeKind": {
          "type": "string",
          "description": "Place role; v1 personal_node only on ledger.",
          "knownValues": [
            "personal_node"
          ]
        },
        "meshPeerId": {
          "type": "string",
          "description": "libp2p peer id when known."
        },
        "displayName": {
          "type": "string"
        },
        "operatorDid": {
          "type": "string",
          "format": "did"
        },
        "trustedSpaceOfferBytes": {
          "type": "integer",
          "minimum": 0,
          "description": "Bytes offered for household copies on this Place (default 0)."
        }
      },
      "description": "Durable place identity on the operator PDS (ADR 70)."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```