curl --request POST \
  --url 'http://localhost:7575/v2/package-vetting/update' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"changes":[{}],"dryRun":false,"synchronizerId":"string","expectedTopologySerial":{"serial":{}},"updateVettedPackagesForceFlags":["UPDATE_VETTED_PACKAGES_FORCE_FLAG_UNSPECIFIED"]}'

{
  "pastVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  },
  "newVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  }
}

{
  "code": "string",
  "cause": "string",
  "correlationId": "string",
  "traceId": "string",
  "context": {},
  "resources": [
    [
      "string"
    ]
  ],
  "errorCategory": 0,
  "grpcCodeValue": 0,
  "retryInfo": "string",
  "definiteAnswer": false
}

POST

package-vetting

update

curl --request POST \
  --url 'http://localhost:7575/v2/package-vetting/update' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"changes":[{}],"dryRun":false,"synchronizerId":"string","expectedTopologySerial":{"serial":{}},"updateVettedPackagesForceFlags":["UPDATE_VETTED_PACKAGES_FORCE_FLAG_UNSPECIFIED"]}'

{
  "pastVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  },
  "newVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  }
}

{
  "code": "string",
  "cause": "string",
  "correlationId": "string",
  "traceId": "string",
  "context": {},
  "resources": [
    [
      "string"
    ]
  ],
  "errorCategory": 0,
  "grpcCodeValue": 0,
  "retryInfo": "string",
  "definiteAnswer": false
}

JSON Ledger API

Update the vetted packages of this participant

OpenAPISince 3.4Changed 3.5

Protocol Details

Operation IDpostV2Package-vettingUpdate

AuthenticationBearer token

Published3.5

Inputs

Request body

application/json

object[]

required

OpenAPI type: VettedPackagesChange[].Changes to apply to the current vetting state of the participant on the specified synchronizer. The changes are applied in order. Any package not changed will keep their previous vetting state. Required: must be non-empty

boolean

If dry_run is true, then the changes are only prepared, but not applied. If a request would trigger an error when run (e.g. TOPOLOGY_DEPENDENCIES_NOT_VETTED), it will also trigger an error when dry_run. Use this flag to preview a change before applying it. Defaults to false. Optional

string

If set, the requested changes will take place on the specified synchronizer. If synchronizer_id is unset and the participant is only connected to a single synchronizer, that synchronizer will be used by default. If synchronizer_id is unset and the participant is connected to multiple synchronizers, the request will error out with PACKAGE_SERVICE_CANNOT_AUTODETECT_SYNCHRONIZER. Optional

object

OpenAPI type: PriorTopologySerial.The serial of last VettedPackages topology transaction on a given participant and synchronizer.

string[]

Controls whether potentially unsafe vetting updates are allowed. Optional: can be empty

Outputs

200

application/json

VettedPackages

The list of packages vetted on a given participant and synchronizer, modelled after VettedPackages in

topology.proto &lt;https://github.com/digital-asset/canton/blob/main/community/base/src/main/protobuf/com/digitalasset/canton/protocol/v30/topology.proto#L206&gt;

_. The list only contains packages that matched a filter in the query that originated it.

VettedPackages

required

The list of packages vetted on a given participant and synchronizer, modelled after VettedPackages in

topology.proto &lt;https://github.com/digital-asset/canton/blob/main/community/base/src/main/protobuf/com/digitalasset/canton/protocol/v30/topology.proto#L206&gt;

_. The list only contains packages that matched a filter in the query that originated it.

400

text/plain

string

required

default

application/json

string

required

string

required

string

Map_String

required

Tuple2_String_String[]

integer (int32)

required

integer (int32)

string

boolean

History

Changed3.5

The POST /v2/package-vetting/update operation changed in this snapshot.

Introduced3.4

curl --request POST \
  --url 'http://localhost:7575/v2/package-vetting/update' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"changes":[{}],"dryRun":false,"synchronizerId":"string","expectedTopologySerial":{"serial":{}},"updateVettedPackagesForceFlags":["UPDATE_VETTED_PACKAGES_FORCE_FLAG_UNSPECIFIED"]}'

{
  "pastVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  },
  "newVettedPackages": {
    "packages": [
      {}
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  }
}

{
  "code": "string",
  "cause": "string",
  "correlationId": "string",
  "traceId": "string",
  "context": {},
  "resources": [
    [
      "string"
    ]
  ],
  "errorCategory": 0,
  "grpcCodeValue": 0,
  "retryInfo": "string",
  "definiteAnswer": false
}

⌘I

Ledger API

Daml Standard Library

Daml Script

TypeScript

dApp API

Wallet Gateway

Splice APIs

Admin API

Update the vetted packages of this participant

Update the vetted packages of this participant

Protocol Details

Inputs

Request body

Outputs

200

400

default

History

​Update the vetted packages of this participant

​Protocol Details

​Inputs

​Request body

​Outputs

​200

​400

​default

​History

Update the vetted packages of this participant

Protocol Details

Inputs

Request body

Outputs

200

400

default

History