Content Server

Decentraland is a virtual world that is owned by its users. One of the biggest differentiators about Decentraland is its level of decentralization. Users can own LAND, wearables, and probably other types of items in the future. Each of these items is an NFT in itself, and therefore ownership is determined by the Ethereum (or EVM-compatible) blockchain. Now, when a new wearable is created, or when a user uploads a scene to their LAND/parcel, all necessary files (3d models, textures, music, etc) are uploaded to a "content server". Why are we using these servers instead of the blockchain? Mainly because it would be prohibitively expensive to store files as big as 3d models in the blockchain. Users would have to pay fees so high to upload content to their parcels that nobody would do it. So this is where content servers come into play. The content server is mainly a server where users can upload these files we mentioned before. Each server will verify against the blockchain that the user making the upload is actually allowed to do so. For example, in the case of scenes, the server will check that the deployer owns all the parcels they are trying to modify. And the most important part is that all content servers will then sync with each other. So, for example, if a scene is modified in one server, the update itself will be broadcasted to the other ones. Then, in the case a content server goes down for some reason, all content will still be present in the other ones.

Get information about an entity

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/audit/{entityType}/{entityId}

Get information about an entity, such us Scenes Profiles or Wearables, with the specified entityId.

Path parameters

entityTypestring · enumRequired

Specify the type of entity to audit

Example: profilePossible values:

entityIdstringRequired

id of the entity

Example: QmQgezF4UWTZpD5VqKs2AGCzucRJdm8zU87MxdSRH9heZR

Responses

200

Entity version, AuthChain and if the deployment was overwritten

application/json; charset=utf-8

versionstringRequired

localTimestampnumberRequired

overwrittenBystringOptional

isDenylistedbooleanOptional

denylistedContentstring[]Optional

400

Unrecognized Entity type

application/json; charset=utf-8

404

Not Found

application/json; charset=utf-8

get

/content/audit/{entityType}/{entityId}

HTTPcURLJavaScriptPython

GET /content/audit/{entityType}/{entityId} HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

{
  "version": "v3",
  "localTimestamp": 1628271052660,
  "authChain": [
    {
      "type": "SIGNER",
      "payload": "0x6B9d61D2AF37F0661dc3c3492fF74a6b13d13B86",
      "signature": ""
    },
    {
      "type": "ECDSA_EPHEMERAL",
      "payload": "Decentraland Login\nEphemeral address: 0x422AF1a8705Caa58E16F21E7ECA64C8B868118Ca\nExpiration: 2021-08-13T11:30:32.697Z",
      "signature": "0x35a35fa65783f963bab9faa73035eedef019b783394d414df583ab0b89d859444168e985b0d71ff6c7fca57e77c0b609bb48c83ca997687d6072abe70f7e99ed1b"
    },
    {
      "type": "ECDSA_SIGNED_ENTITY",
      "payload": "QmQgezF4UWTZpD5VqKs2AGCzucRJdm8zU87MxdSRH9heZR",
      "signature": "0x085e17af656af3f60ee2cc98de99e458949b58cd5c5aa417f2cdb1f17cd1dde0370a719dc8385345969a9ee0c642d19b3650bc1076be593c59eb97f38ee0b2be1c"
    }
  ]
}

Validate if the Server is part of the DAO

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/challenge

Used by the Server to figure out their identity on the DAO by themselves, so they will generate a random challenge text, and then query each server for it. If the text matches, then they have found themselves.

Responses

200

Challenge text

application/json; charset=utf-8

challengeTextstringRequired

get

/content/challenge

HTTPcURLJavaScriptPython

GET /content/challenge HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

200

Challenge text

{
  "challengeText": "186a1c51-2c4c-4dae-913c-b87670600c56"
}

Download content file

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/contents/{hashId}

Download the binary file associated with the specified hashId

Path parameters

hashIdstringRequired

Hash of the file to be retrieved, you can search for the hashId in the content section of a deployment. If the entity version greater than or equal to v4, then the hashing algorithm will be IPFS, if the entity version is v3 or below then it will be SHA-256

Example: QmVzr55TyXcrbQUWBN6rf7K7zkZsTFnBK19LvgYM9CxFbu

Responses

200

Binary file with the specified hashId

application/octet-stream

Responsestring · binaryExample: binary

404

File with the specified hashId Not Found

application/json; charset=utf-8

get

/content/contents/{hashId}

HTTPcURLJavaScriptPython

GET /content/contents/{hashId} HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

binary

Check if a content file exists

head

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/contents/{hashId}

Check if a content file exists

Path parameters

hashIdstringRequired

Hash of the file to be checked

Example: QmVzr55TyXcrbQUWBN6rf7K7zkZsTFnBK19LvgYM9CxFbu

Responses

200

Content file exists

404

File with the specified hashId Not Found

application/json; charset=utf-8

head

/content/contents/{hashId}

HTTPcURLJavaScriptPython

HEAD /content/contents/{hashId} HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

No content

List of entityIds associated with a hashId

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/contents/{hashId}/active-entities

Get the list of entity ids whose deployments are associated with the specified content hash. This endpoint is currently intended for troubleshooting as there is no specific use case for it.

Path parameters

hashIdstringRequired

Hash of the content file

Example: QmWFLwHGfvhB9a1epaRpS38HEwbHvhpaYzHEsNhDRgon7P

Responses

200

List of all the entities associated with the hashId

application/json; charset=utf-8

string[]Optional

404

Entities not found for the specified hash

application/json; charset=utf-8

get

/content/contents/{hashId}/active-entities

HTTPcURLJavaScriptPython

GET /content/contents/{hashId}/active-entities HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

[
  "QmY4GFuf2jR3ocfuXuFLgvUrGEpjo84Byg44Pv2wduuinW",
  "QmZbAEFPF7LSq9xVZTCAZoHPNV1QX7YiSbKL2g881MJLj8"
]

Validates if file exists on the Server

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/available-content

Given a list of hashes, validates if the corresponding files exist in the storage of the server

Query parameters

cidstring[]Required

Hash of the content file

Example: QmWFLwHGfvhB9a1epaRpS38HEwbHvhpaYzHEsNhDRgon7P

Responses

200

List of objects with the hasIds and a boolean value specifying 'true' if the files exists on the server and 'false' if it doesn't.

application/json; charset=utf-8

cidstringRequired

availablebooleanRequired

400

Missing query parameters in the request

application/json; charset=utf-8

get

/content/available-content

HTTPcURLJavaScriptPython

GET /content/available-content?cid=QmWFLwHGfvhB9a1epaRpS38HEwbHvhpaYzHEsNhDRgon7P HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

[
  {
    "cid": "QmWFLwHGfvhB9a1epaRpS38HEwbHvhpaYzHEsNhDRgon7P",
    "available": true
  },
  {
    "cid": "MfWFLwHGfvhB9a1epaRpJ38HEwbHvhpaYzHEsNhDRgon8H",
    "available": false
  }
]

Deploys an entity

post

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/entities

Deploys an entity in the content server. This request must contain a file with the entity itself and also the files associated with it, such as 3D models, as well as information about the entity and requester. This request will succeed only if the hash of the entity file matches the entityId and also if the signature is valid has the correct permission to modify the pointers associated with it.

Body

multipart/form-data

filesstring · binary[]Optional

entityIdstringOptionalExample: QmY4GFuf2jR3ocfuXuFLgvUrGEpjo84Byg44Pv2wduuinW

authChainstringOptionalExample: [{"type":"SIGNER","payload":"0x716954738e57686a08902d9dd586e813490fee23"},{"type":"ECDSA_EPHEMERAL","payload":"Decentraland Login\nEphemeral address: 0x90a43461d3e970785B945FFe8f7628F2BC962D6a\nExpiration: 2021-07-10T20:55:42.215Z","signature":"0xe64e46fdd7d8789c0debec54422ae77e31b77e5a28287e072998e1114e252c57328c17756400d321e9e77032347c9d05e63fb59a3b6c3ab754565f9db86b8c481b"},{"type":"ECDSA_SIGNED_ENTITY","payload":"QmNMZBy7khBxdigikA8mcJMyv6yeBXfMv3iAcUiBr6n72C","signature":"0xbed22719dcdc19580353108027c41c65863404879592c65014d806efa961c629777adc76986193eaee4e48f278ec59feb1c289827254230af85b2955157ec8061b"}]

ethAddressstringOptionalExample: 0x89205A3A3b2A69De6Dbf7f01ED13B2108B2c43e7

signaturestringOptional

Responses

200

Entity created successfully. The response will contain the timestamp and result.

application/json; charset=utf-8

creationTimestampnumberRequired

400

Bad request. Returns the error object with the list of errors from the server response.

application/json; charset=utf-8

post

/content/entities

HTTPcURLJavaScriptPython

POST /content/entities HTTP/1.1
Host: peer.decentraland.zone
Content-Type: multipart/form-data
Accept: */*
Content-Length: 787

{
  "files": [
    "binary"
  ],
  "entityId": "QmY4GFuf2jR3ocfuXuFLgvUrGEpjo84Byg44Pv2wduuinW",
  "authChain": [
    {
      "type": "SIGNER",
      "payload": "0x716954738e57686a08902d9dd586e813490fee23"
    },
    {
      "type": "ECDSA_EPHEMERAL",
      "payload": "Decentraland Login\nEphemeral address: 0x90a43461d3e970785B945FFe8f7628F2BC962D6a\nExpiration: 2021-07-10T20:55:42.215Z",
      "signature": "0xe64e46fdd7d8789c0debec54422ae77e31b77e5a28287e072998e1114e252c57328c17756400d321e9e77032347c9d05e63fb59a3b6c3ab754565f9db86b8c481b"
    },
    {
      "type": "ECDSA_SIGNED_ENTITY",
      "payload": "QmNMZBy7khBxdigikA8mcJMyv6yeBXfMv3iAcUiBr6n72C",
      "signature": "0xbed22719dcdc19580353108027c41c65863404879592c65014d806efa961c629777adc76986193eaee4e48f278ec59feb1c289827254230af85b2955157ec8061b"
    }
  ],
  "ethAddress": "0x89205A3A3b2A69De6Dbf7f01ED13B2108B2c43e7",
  "signature": "text"
}

{
  "creationTimestamp": 1628607669304
}

List of active entities matching urn prefix

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/entities/active/collections/{collectionUrn}

Returns the list of active entities which have at least one pointer that matches the prefix given

Path parameters

collectionUrnstringRequired

urn prefix to filter the entities by

Example: urn:decentraland:matic:collections-v2:0x8e674db9b2fc0759b2d94cace9c4bae334a8f0c3

Query parameters

pageSizenumberOptional

Page size (max 1000)

pageNumbernumberOptional

Page number (default: 1)

Responses

200

List of entity Ids matching the condition

application/json; charset=utf-8

totalnumberRequired

get

/content/entities/active/collections/{collectionUrn}

HTTPcURLJavaScriptPython

GET /content/entities/active/collections/{collectionUrn} HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

200

List of entity Ids matching the condition

[
  {
    "pointer": "urn:decentraland:polygon:collections-thirdparty:cryptohats:0xc04528c14c8ffd84c7c1fb6719b4a89853035cdd",
    "entityId": "QmeA8RpAtqU6gCebNaWRXtM9nQs3ugzzbeQm3L7uKrP4Jp"
  },
  {
    "pointer": "urn:decentraland:polygon:collections-thirdparty:cryptohats:0xabcdefghijk",
    "entityId": "QmdajbrYt4pdkkW2R2PcZ8iLz55uzgGceo4hJMCirHEpPK"
  },
  {
    "pointer": "urn:decentraland:polygon:collections-thirdparty:cryptohats:0xlmnopqrst",
    "entityId": "QmXokfUunNwLY9hw7U9x2Q3NJ7VFXt65rVDRGzFzPzEXvX"
  }
]

List active entities by pointers or ids

post

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/entities/active

Returns the list of entities of the specified type with the specified id or pointers. Only one of these filters must be specified in the body.

Body

application/json

pointersstring[]Optional

Entities must be filtered by pointer XOR entityId (ids). Use this parameter if you want to retrieve an entity of the specified type with this pointer.

Example: urn:decentraland:mumbai:collections-v2:0xf6426e0c70c17509038aba78137e721d187499d6:0

idsstring[]Optional

Entities must be filtered by pointer (pointers) XOR entityId. Use this parameter if you want to retrieve an entity of the specified type with this entityId.

Example: QmeA8RpAtqU6gCebNaWRXtM9nQs3ugzzbeQm3L7uKrP4Jp

Responses

200

List of entities corresponding to the matching ids or pointers.

application/json; charset=utf-8

versionstringRequired

idstringRequired

typestringRequired

timestampnumberRequired

pointersstring[]Required

metadataobjectOptional

400

Bad request: ids or pointers must be present in the request, but not both

application/json; charset=utf-8

post

/content/entities/active

HTTPcURLJavaScriptPython

POST /content/entities/active HTTP/1.1
Host: peer.decentraland.zone
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "pointers": [
    "urn:decentraland:mumbai:collections-v2:0xf6426e0c70c17509038aba78137e721d187499d6:0"
  ],
  "ids": [
    "QmeA8RpAtqU6gCebNaWRXtM9nQs3ugzzbeQm3L7uKrP4Jp"
  ]
}

[
  {
    "version": "v3",
    "id": "QmQ9UorFsVTpaVpCwJZAzFyCmaGf7Ksi6aQHYTJVKyzVMh",
    "type": "scene",
    "timestamp": 1581034082829,
    "pointers": [
      "100,0"
    ],
    "content": [
      {
        "file": "Fork_0.glb",
        "hash": "QmdnkhnMwaFWs5ysAQ4Y8r9CSYMoMvpiAcaLr1PJoQFbZU"
      },
      {
        "file": "game.js",
        "hash": "QmXdgLxwgBRr3igNoJAu7Qi6KtMR6WR5kUSRtZVERnQH9A"
      },
      {
        "file": "OpenRoad_0.glb",
        "hash": "QmRF2LA6AdTP8ZTsKpf6WGW8iZesfmKqMzYrg7Yx1nbLU9"
      },
      {
        "file": "scene.json",
        "hash": "QmPgaz3kzicJKAtagqGHN5LYFvECimz4te5CVU9y4EbPgo"
      }
    ],
    "metadata": {
      "display": {
        "title": "Road at 100,0 (open road OpenRoad_0)",
        "favicon": "favicon_asset"
      },
      "contact": {
        "name": "",
        "email": ""
      },
      "owner": "",
      "scene": {
        "parcels": [
          "100,0"
        ],
        "base": "100,0"
      },
      "communications": {
        "type": "webrtc",
        "signalling": "https://signalling-01.decentraland.org"
      },
      "policy": {
        "contentRating": "E",
        "fly": true,
        "voiceEnabled": true,
        "blacklist": [],
        "teleportPosition": ""
      },
      "main": "game.js",
      "tags": []
    }
  }
]

List of failed deployments

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/failed-deployments

Retrieves a list of the failed deployments

Responses

200

Failed deployments list

application/json; charset=utf-8

failedDeploymentsRepostringOptional

entityTypestringRequired

entityIdstringRequired

reasonstringRequired

errorDescriptionstringRequired

get

/content/failed-deployments

HTTPcURLJavaScriptPython

GET /content/failed-deployments HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

200

Failed deployments list

[
  {
    "failedDeploymentsRepo": "https://peer.dclnodes.io/content",
    "entityType": "profile",
    "entityId": "Qmej2ASCw4ubcjd2KHyMkcQz8HbMUfLqGbtheWoxykBt38",
    "reason": "No entity or audit",
    "errorDescription": "During sync, we couldn't fetch the entity or the audit info"
  }
]

List of changes made to a pointer

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/pointer-changes

List of all deltas from the deployments inside the filters that affect the given pointers. It returns a list of changes with the before field (the entity that was overridden with this deployment) and after (the entity that overrides the current one if present).

Query parameters

fromintegerOptional

Acts as a filter in the collection of deployments, this value is the minimum value of local timestamp that any deployment in the collection will have.

Example: 1606829553969

tointegerOptional

Acts as a filter in the collection of deployments, this value is the maximum value of local timestamp that any deployment in the collection will have.

Example: 1606829553969

lastIdstringOptional

It is the last entity id that was visited, so it will be skipped when showing current page.

Example: QmNknKv8MuKbfZ73z4QdUEsNbTd1ZAN1fSuwTFGiNGeCt5

limitintegerOptional

The deployments are a paginated collection, this parameter corresponds to the limit for each page. The default value is 500.

Example: 100

entityTypestring · enumOptional

The type of entities that will be shown in the collection, many values can be sent. Valid values are: profile, scene and wearable.

Example: profilePossible values:

sortingFieldstring · enumOptional

This value is used as the field to order all the deployments in the collection. If no parameter is sent, then the default field to order with will be local_timestamp.

Example: local_timestampPossible values:

sortingOrderstring · enumOptional

This value is used as the order for all the deployments in the collection. If no parameter is sent, then the default field to order with will be DESC.

Example: ASCPossible values:

Responses

200

List of deployment changes made to pointers

application/json; charset=utf-8

400

Bad Request

application/json; charset=utf-8

get

/content/pointer-changes

HTTPcURLJavaScriptPython

GET /content/pointer-changes HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

{
  "deltas": [
    {
      "entityType": "scene",
      "entityId": "QmWBMqDmFebLr4pJWxBpXdtToqTNxqeefzkerQ1C35cGeb",
      "localTimestamp": 1628614712569,
      "pointers": [
        "0,0",
        "0,1"
      ],
      "authChain": [
        {
          "type": "SIGNER",
          "payload": "0x5dB41e2b949a60D60Ae203CdAdabF1c0f0759985",
          "signature": ""
        }
      ]
    },
    {
      "entityType": "scene",
      "entityId": "QmT3EYh8cGtB8oHMEgCc5GuRMPofkHNwb936ZhRocwgrAL",
      "localTimestamp": 1628612595680,
      "pointers": [
        "1,1",
        "1,2"
      ],
      "authChain": [
        {
          "type": "SIGNER",
          "payload": "0x5dB41e2b949a60D60Ae203CdAdabF1c0f0759985",
          "signature": ""
        }
      ]
    },
    {
      "entityType": "scene",
      "entityId": "QmQSBke1rXUtPYHLJvJdrfX85n68YMSRgb4KeGhNL8w8KL",
      "localTimestamp": 1628612397349,
      "pointers": [
        "3,3"
      ],
      "authChain": [
        {
          "type": "SIGNER",
          "payload": "0x5dB41e2b949a60D60Ae203CdAdabF1c0f0759985",
          "signature": ""
        }
      ]
    }
  ]
}

Snapshots with a list of active entities

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/snapshots

Lists all active deployments stored in the database in multiple snapshots for different time ranges. If the information needed is front in time of the most recent snapshot, you may use the /content/pointer-changes endpoint with the necessary from filter.

Responses

200

The result is a list of snapshots. Each "hash" field references the a snapshot with all the active entities that has an entity timestamp within the specified time range. Each hash is a reference to a JSON file containing one line per entity in a JSON format. Once you get the hashes you can download them using the /content/contents/{hashId} endpoint.

application/json; charset=utf-8

hashstringRequired

replacedSnapshotHashesstring[]Optional

numberOfEntitiesnumberRequired

generationTimestampnumberRequired

503

New Snapshots not yet created

get

/content/snapshots

HTTPcURLJavaScriptPython

GET /content/snapshots HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

[
  {
    "hash": "bafkreig6sfhegnp4okzecgx3v6gj6pohh5qzw6zjtrdqtggx64743rkmz4",
    "timeRange": {
      "initTimestamp": 1577836800000,
      "endTimestamp": 1606867200000
    },
    "replacedSnapshotHashes": [
      "bafkreig6sfhegnp4okzecgx3v6gj6pohh5qzw6zjtrdqtggx64743rkmz4"
    ],
    "numberOfEntities": 0,
    "generationTimestamp": 1671126919124
  },
  {
    "hash": "bafkreig6sfhegnp4okzecgx3v6gj6pohh5qzw6zjtrdqtggx64743rkmz4",
    "timeRange": {
      "initTimestamp": 1606867200000,
      "endTimestamp": 1635897600000
    },
    "replacedSnapshotHashes": [],
    "numberOfEntities": 0,
    "generationTimestamp": 1671126611185
  }
]

Content Server status

get

https://peer.decentraland.zonehttps://peer-testing.decentraland.orghttps://peer.decentraland.org

/content/status

Retrieve deteailed information about the content server status

Responses

200

Content Server status information

application/json; charset=utf-8

namestringOptional

versionstringRequired

currentTimenumberOptional

lastImmutableTimenumberOptional

historySizenumberOptional

commitHashstringRequired

ethNetworkstringRequired

get

/content/status

HTTPcURLJavaScriptPython

GET /content/status HTTP/1.1
Host: peer.decentraland.zone
Accept: */*

200

Content Server status information

{
  "name": "",
  "version": "v3",
  "currentTime": 1628618042062,
  "lastImmutableTime": 0,
  "historySize": 968083,
  "synchronizationStatus": {
    "otherServers": [
      {
        "address": "https://peer.dclnodes.io/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617995540
      },
      {
        "address": "https://peer-wc1.decentraland.org/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617952275
      },
      {
        "address": "https://peer-ec1.decentraland.org/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617951020
      },
      {
        "address": "https://peer-eu1.decentraland.org/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617964042
      },
      {
        "address": "https://peer.kyllian.me/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617996216
      },
      {
        "address": "https://peer-ap1.decentraland.org/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617993064
      },
      {
        "address": "https://peer.uadevops.com/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617962087
      },
      {
        "address": "https://peer.melonwave.com/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617994238
      },
      {
        "address": "https://interconnected.online/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617976603
      },
      {
        "address": "https://peer.decentral.games/content",
        "connectionState": "Connected",
        "lastDeploymentTimestamp": 1628617977558
      }
    ],
    "lastSyncWithDAO": 1628616434517,
    "synchronizationState": "Synced",
    "lastSyncWithOtherServers": 1628617998093
  },
  "commitHash": "7890de4598f88a382863ea5f399b9cc17b80b42e",
  "catalystVersion": "1.3.3",
  "ethNetwork": "mainnet"
}