Core Scope Operations

• getList scopes by specification
• postCreate scope
• getGet scope
• patchPatch scope

API docs by Redocly

Blockvault Core Scope Operations (v1.0.0)

Download OpenAPI specification:Download

NUVA Labs: inbound@nuvalabs.com URL: https://nuvalabs.com/ License: Apache 2.0 Terms of Service

API Documentation for Blockvault Core Scope Operations

List scopes by specification

Authorizations:

BearerAuth

path Parameters

required

string or string (ScopeSpecificationId) Scope specification identifier

Responses

NUVA Labs API Server

https://api.provlabs.com/metadata/scope-specification/{id}/scope

Response samples

• 200
• 400
• 401
• 404

Content type

application/json

{

• "scopes": [

  • {

    • "scope": {

      • "scope": {

        • "scope_id": "scope1qq7cmetahks5vddrwu7e4zju8l9qspkte8",
        • "specification_id": "scopespec1q3ry4x6dj4k5j355dxntlhpfywssp5u67a",
        • "specification_uuid": "2ccb7b54-e0f1-4057-99ba-2716e82263d7",
        • "data_access": [

          • "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
          • "tp1dpqhlfd6uwaezmv8skm47d95yn6pfv7ngg8lgp"

          ],
        • "owners": [

          • {

            • "address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
            • "role": "PARTY_TYPE_ORIGINATOR",
            • "optional": false

            }

          ],
        • "value_owner_address": "tp1400nc66h0aag5f8qjnj4q575nd57caz2lpdfa2"

        },
      • "scope_id_info": {

        • "scope_addr": "scope1qq7cmetahks5vddrwu7e4zju8l9qspkte8",
        • "scope_uuid": "3d8de57d-bda1-4635-a377-3d9a8a5c3fca"

        }

      },
    • "records": [

      • {

        • "record": {

          • "name": "personal_info",
          • "output_hash": "7q773TGOJVti7Q7JyE+xMbn0XgNrb7BQpm1MgnfeWRo=",
          • "process": {

            • "name": "personal_info",
            • "method": "personal_info",
            • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

            }

          },
        • "record_id_info": {

          • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

          }

        },
      • {

        • "record": {

          • "name": "address",
          • "output_hash": "VVbmLl/sibYvt3EM0IfqPKYtg9L5fs132aC9V7R6dGc=",
          • "process": {

            • "name": "address",
            • "method": "address",
            • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

            }

          },
        • "record_id_info": {

          • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

          }

        },
      • {

        • "record": {

          • "name": "occupation",
          • "output_hash": "fmWZGseUHzilKIfCy0ybcq4Wn0Cnj1YNJ7+5aOfIB2Y=",
          • "process": {

            • "name": "occupation",
            • "method": "occupation",
            • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

            }

          },
        • "record_id_info": {

          • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

          }

        },
      • {

        • "record": {

          • "name": "is_over_50",
          • "output_hash": "/LzxZZCN0YqeSff/J4EBdtuOn2O0NSITdBZkJFIk+Ko=",
          • "process": {

            • "name": "is_over_50",
            • "method": "is_over_50",
            • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

            }

          },
        • "record_id_info": {

          • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

          }

        }

      ]

    }

  ]

}

Create scope

Authorizations:

BearerAuth

path Parameters

required

string or string (ScopeSpecificationId) Scope specification identifier

Request Body schema: application/json

required

data_access	Array of strings or null Addresses in this list are authorized to receive off-chain data associated with this scope
	null or (ScopeId (ScopeId (string) or ScopeId (string)))
	Array of objects or null (Party) These parties represent top level owners of the records within. These parties must sign any requests that modify the data within the scope. These addresses are in union with parties listed on the sessions.
usd_mills	integer or null <int64> >= 0 Value of scope in usd mills (1234 = $1.234) used for net asset value
value_owner_address	string or null An address that controls the value associated with this scope. Standard blockchain accounts and marker accounts are supported for this value. This attribute may only be changed by the entity indicated once it is set.

Responses

NUVA Labs API Server

https://api.provlabs.com/metadata/scope-specification/{id}/scope

Request samples

• Payload

Content type

application/json

{

• "owners": [

  • {

    • "address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
    • "role": "PARTY_TYPE_OWNER"

    }

  ],
• "data_access": [

  • "tp1frfpejz0wvfehgxks8ghda4qxesehxsf5ue6w9"

  ],
• "value_owner_address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
• "usd_mills": 1000000

}

Response samples

• 201
• 400
• 401
• 404

Content type

application/json

{

• "tx_hash": "3ea1b237f303455d1e7c04fc128168cf9a6b903759b8b06bc05315e9333da1ae",
• "height": 18621414,
• "id": "scope1qrx6trnp5eq5wxve49crgevg36nsp05nc3",
• "uuid": "464a9b4d-956d-4946-9469-a6bfdc2923a1"

}

Get scope

Authorizations:

BearerAuth

path Parameters

required

string or string (ScopeId) Scope identifier

query Parameters

hydrate	Array of strings or null A list of record names to hydrate and return raw data for, defaults to hydrating all records when not provided. Hydration of records is a time consuming process so it is recommended to not hydrate more than is needed for improved response times.
block_height	integer or null <int64> >= 0 When provided, fetches a scope's state based on a previous block height. Defaults to the current (head) chain state.

Responses

NUVA Labs API Server

https://api.provlabs.com/metadata/scope/{id}

Response samples

• 200
• 400
• 401
• 404

Content type

application/json

{

• "scope": {

  • "scope": {

    • "scope_id": "scope1qq7cmetahks5vddrwu7e4zju8l9qspkte8",
    • "specification_id": "scopespec1q3ry4x6dj4k5j355dxntlhpfywssp5u67a",
    • "specification_uuid": "2ccb7b54-e0f1-4057-99ba-2716e82263d7",
    • "data_access": [

      • "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
      • "tp1dpqhlfd6uwaezmv8skm47d95yn6pfv7ngg8lgp"

      ],
    • "owners": [

      • {

        • "address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
        • "role": "PARTY_TYPE_ORIGINATOR",
        • "optional": false

        }

      ],
    • "value_owner_address": "tp1400nc66h0aag5f8qjnj4q575nd57caz2lpdfa2"

    },
  • "scope_id_info": {

    • "scope_addr": "scope1qq7cmetahks5vddrwu7e4zju8l9qspkte8",
    • "scope_uuid": "3d8de57d-bda1-4635-a377-3d9a8a5c3fca"

    }

  },
• "records": [

  • {

    • "record": {

      • "name": "personal_info",
      • "output_hash": "7q773TGOJVti7Q7JyE+xMbn0XgNrb7BQpm1MgnfeWRo=",
      • "process": {

        • "name": "personal_info",
        • "method": "personal_info",
        • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

        },
      • "value": {

        • "name": "George Castanza",
        • "age": "31"

        }

      },
    • "record_id_info": {

      • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

      }

    },
  • {

    • "record": {

      • "name": "address",
      • "output_hash": "VVbmLl/sibYvt3EM0IfqPKYtg9L5fs132aC9V7R6dGc=",
      • "process": {

        • "name": "address",
        • "method": "address",
        • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

        },
      • "value": "Manhattan, New York"

      },
    • "record_id_info": {

      • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

      }

    },
  • {

    • "record": {

      • "name": "occupation",
      • "output_hash": "fmWZGseUHzilKIfCy0ybcq4Wn0Cnj1YNJ7+5aOfIB2Y=",
      • "process": {

        • "name": "occupation",
        • "method": "occupation",
        • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

        },
      • "value": {

        • "employer": "Vandelay Industries",
        • "title": "Importer/exporter"

        }

      },
    • "record_id_info": {

      • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

      }

    },
  • {

    • "record": {

      • "name": "is_over_50",
      • "output_hash": "/LzxZZCN0YqeSff/J4EBdtuOn2O0NSITdBZkJFIk+Ko=",
      • "process": {

        • "name": "is_over_50",
        • "method": "is_over_50",
        • "hash": "sha256:cca4139ba7356c686c5796333bb9c0764ff50a5e28d66f49b667d8b36965fa5d"

        },
      • "value": false

      },
    • "record_id_info": {

      • "record_addr": "record1qgruqx7pglkyf799y8wpmpfudamsd6lrzs702zd4yh02s5p4tcwmg344xmr"

      }

    }

  ]

}

Patch scope

Authorizations:

BearerAuth

path Parameters

required

string or string (ScopeId) Scope identifier

Request Body schema: application/json

required

        Patch scope level fields. All fields are optional. Any omitted field will retain its current value.

        * NOTE: There's currently a Provenance protocol bug where existing records cannot be updated by new scope owners without the previous record writers signature.
        This is slated to be fixed in 1.21.

data_access	Array of strings or null Addresses in this list are authorized to receive off-chain data associated with this scope
	Array of objects or null (Party) These parties represent top level owners of the records within. These parties must sign any requests that modify the data within the scope. These addresses are in union with parties listed on the sessions.
specification_uuid	string or null <uuid> If the owners of a scope are changed, it is often the case that the "scope_specification" must be changed as well.
usd_mills	integer or null <int64> >= 0 Value of scope in usd mills (1234 = $1.234) used for net asset value
value_owner_address	string or null An address that controls the value associated with this scope. Standard blockchain accounts and marker accounts are supported for this value. This attribute may only be changed by the entity indicated once it is set.

Responses

NUVA Labs API Server

https://api.provlabs.com/metadata/scope/{id}

Request samples

• Payload

Content type

application/json

{

• "specification_uuid": "6459fb07-d662-482d-860b-b69bf2255960",
• "owners": [

  • {

    • "address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
    • "role": "PARTY_TYPE_OWNER"

    }

  ],
• "data_access": [

  • "tp1frfpejz0wvfehgxks8ghda4qxesehxsf5ue6w9"

  ],
• "value_owner_address": "tp1tledwnl9zsgcqynmjzmp8f3j25l0rj7hvx4g22",
• "usd_mills": 1000000

}

Response samples

• 200
• 400
• 401
• 404

Content type

application/json

{

• "tx_hash": "3ea1b237f303455d1e7c04fc128168cf9a6b903759b8b06bc05315e9333da1ae",
• "height": 18621389

}