Guides
Dash CoreDash PlatformDash.orgDash User DocsLog In
These docs are for v0.21.0. Click to read the latest docs for v0.25-redirect.

Platform Protocol (DPP)

Protocol for verifying and validating data on Dash Platform

Overview

To ensure the consistency and integrity of data stored on Layer 2, all data is governed by the Dash Platform Protocol (DPP). Dash Platform Protocol describes serialization and validation rules for the platform's 3 core data structures: data contracts, documents, and state transitions. Each of these structures are briefly described below.

❗️

Breaking changes in Dash Platform 0.20

A number of breaking changes were introduced in DPP 0.20 which updated to a newer version of JSON Schema and also switched to a new regex module for improved security. More details can be found in the GitHub release.

Structure Descriptions

Data Contract

A data contract is a database schema that a developer needs to register with the platform in order to start using any decentralized storage functionality. Data contracts are described using the JSON Schema language and must follow some basic rules as described in the platform protocol repository. Contracts are serialized to binary form using CBOR.

For additional detail, see the Data Contract explanation.

Document

A document is an atomic entity used by the platform to store user-submitted data. It resembles the documents stored in a document-oriented DB (e.g. MongoDB). All documents must follow some specific rules that are defined by a generic document schema. Additionally, documents are always related to a particular application, so they must comply with the rules defined by the application’s data contract. Documents are submitted to the platform API (DAPI) by users during their use of the application.

📘

Document-Oriented Databases

Information about document-oriented databases can be found on the MongoDB site and in this Wikipedia article.

For additional detail, see the Document explanation.

State Transition

A state transition represents a change made by a user to the application and platform states. It consists of either an array of documents or one data contract, the ID of the application to which the change is made, and a user signature. The user signature is made for the binary representation of the state transition using a private key associated with a user identity. A state transition is constructed by a client-side library when the user creates documents and submits them to the platform API.

For additional detail, see the State Transition explanation.