# org.realarchive.record

> Published by [realarchive.org](https://lexicon.garden/identity/did:plc:zl3avw5bkiqdip5zfm5ucdlm)

✓ This is the authoritative definition for this NSID.

## Description

A verifiable media record: signed provenance metadata plus BitTorrent distribution pointers.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:zl3avw5bkiqdip5zfm5ucdlm/org.realarchive.record)
- [Documentation](https://lexicon.garden/lexicon/did:plc:zl3avw5bkiqdip5zfm5ucdlm/org.realarchive.record/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:zl3avw5bkiqdip5zfm5ucdlm/org.realarchive.record/examples)

## Definitions

### `org.realarchive.record`

**Type**: `record`

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | `string` | Yes |  |
| `magnet` | `string` | Yes | magnet:?xt=urn:btih:<infohash> |
| `fileHash` | `string` | Yes | SHA-256 hex digest of the distributed file |
| `fileSize` | `integer` | Yes |  |
| `location` | `ref` → `#location` | No |  |
| `mimeType` | `string` | Yes |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `capturedAt` | `string` (datetime) | No | Self-asserted capture time |
| `supersedes` | `string` | No | AT URI of the record this one replaces |
| `description` | `string` | No |  |
| `gpgSignature` | `string` | No | ASCII-armored detached GPG signature of the canonical manifest |
| `gpgKeyFingerprint` | `string` | No |  |
| `authorizationLevel` | `string` | Yes | POC supports public only |

### `org.realarchive.record#location`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `lat` | `string` | No |  |
| `lon` | `string` | No |  |
| `placeName` | `string` | No |  |

## Raw Schema

```json
{
  "id": "org.realarchive.record",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "fileHash",
          "fileSize",
          "mimeType",
          "magnet",
          "title",
          "authorizationLevel",
          "createdAt"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 256
          },
          "magnet": {
            "type": "string",
            "maxLength": 2048,
            "description": "magnet:?xt=urn:btih:<infohash>"
          },
          "fileHash": {
            "type": "string",
            "maxLength": 64,
            "description": "SHA-256 hex digest of the distributed file"
          },
          "fileSize": {
            "type": "integer",
            "minimum": 1
          },
          "location": {
            "ref": "#location",
            "type": "ref"
          },
          "mimeType": {
            "type": "string",
            "maxLength": 128
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "capturedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Self-asserted capture time"
          },
          "supersedes": {
            "type": "string",
            "maxLength": 512,
            "description": "AT URI of the record this one replaces"
          },
          "description": {
            "type": "string",
            "maxLength": 2048
          },
          "gpgSignature": {
            "type": "string",
            "maxLength": 8192,
            "description": "ASCII-armored detached GPG signature of the canonical manifest"
          },
          "gpgKeyFingerprint": {
            "type": "string",
            "maxLength": 64
          },
          "authorizationLevel": {
            "enum": [
              "public"
            ],
            "type": "string",
            "description": "POC supports public only"
          }
        }
      }
    },
    "location": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "string",
          "maxLength": 32
        },
        "lon": {
          "type": "string",
          "maxLength": 32
        },
        "placeName": {
          "type": "string",
          "maxLength": 256
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A verifiable media record: signed provenance metadata plus BitTorrent distribution pointers."
}
```
