Documentation/canton-network-docs/Ledger APIgRPC APIPackagesv2.adminServicesPackageManagementServiceView on canton-network-docs ↗
canton-network-docs/Ledger APIgRPC APIPackagesv2.adminServicesPackageManagementService

UpdateVettedPackages

Ledger API›gRPC API›v2.admin›UpdateVettedPackages

com.daml.ledger.api.v2.admin

​
UpdateVettedPackages

gRPCSince 3.4.4
RPC/com.daml.ledger.api.v2.admin.PackageManagementService/UpdateVettedPackages

​
Protocol Details

​
Inputs

​
UpdateVettedPackagesRequest

changesrepeated VettedPackagesChange
dry_runbool
synchronizer_idstring
expected_topology_serialPriorTopologySerial
update_vetted_packages_force_flagsrepeated UpdateVettedPackagesForceFlag

​
Outputs

​
UpdateVettedPackagesResponse

past_vetted_packagesVettedPackages
new_vetted_packagesVettedPackages

​
Lifecycle Changes

3.4.4introduced

com.daml.ledger.api.v2.admin.UpdateVettedPackagesRequest

changesrepeated VettedPackagesChange
dry_runbool
synchronizer_idstring
expected_topology_serialPriorTopologySerial
update_vetted_packages_force_flagsrepeated UpdateVettedPackagesForceFlag

com.daml.ledger.api.v2.admin.VettedPackagesChange

vetVet
unvetUnvet

com.daml.ledger.api.v2.admin.VettedPackagesChange.Unvet

packagesrepeated VettedPackagesRef

com.daml.ledger.api.v2.admin.VettedPackagesRef

package_idstring
package_namestring
package_versionstring

com.daml.ledger.api.v2.admin.VettedPackagesChange.Vet

packagesrepeated VettedPackagesRef
new_valid_from_inclusiveTimestamp
new_valid_until_exclusiveTimestamp

com.daml.ledger.api.v2.PriorTopologySerial

prioruint32
no_priorEmpty

com.daml.ledger.api.v2.admin.UpdateVettedPackagesForceFlag

  • UPDATE_VETTED_PACKAGES_FORCE_FLAG_UNSPECIFIED
  • UPDATE_VETTED_PACKAGES_FORCE_FLAG_ALLOW_VET_INCOMPATIBLE_UPGRADES
  • UPDATE_VETTED_PACKAGES_FORCE_FLAG_ALLOW_UNVETTED_DEPENDENCIES

com.daml.ledger.api.v2.admin.UpdateVettedPackagesResponse

past_vetted_packagesVettedPackages
new_vetted_packagesVettedPackages

com.daml.ledger.api.v2.VettedPackages

packagesrepeated VettedPackage
participant_idstring
synchronizer_idstring
topology_serialuint32

com.daml.ledger.api.v2.VettedPackage

package_idstring
valid_from_inclusiveTimestamp
valid_until_exclusiveTimestamp
package_namestring
package_versionstring
grpcurl
grpcurl
# Add -plaintext if the server is not using TLS.
grpcurl \
  -d @ \
  <HOST:PORT> \
  com.daml.ledger.api.v2.admin.PackageManagementService/UpdateVettedPackages <<'EOF'
{
  "changes": [
    {
      "vet": {
        "packages": [
          {
            "packageId": "string",
            "packageName": "string",
            "packageVersion": "string"
          }
        ],
        "newValidFromInclusive": "string",
        "newValidUntilExclusive": "string"
      }
    }
  ],
  "dryRun": true,
  "synchronizerId": "string",
  "expectedTopologySerial": {
    "prior": 0
  },
  "updateVettedPackagesForceFlags": [
    "UPDATE_VETTED_PACKAGES_FORCE_FLAG_UNSPECIFIED"
  ]
}
EOF
OKapplication/json
OK
{
  "pastVettedPackages": {
    "packages": [
      {
        "packageId": "string",
        "validFromInclusive": "string",
        "validUntilExclusive": "string",
        "packageName": "string",
        "packageVersion": "string"
      }
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  },
  "newVettedPackages": {
    "packages": [
      {
        "packageId": "string",
        "validFromInclusive": "string",
        "validUntilExclusive": "string",
        "packageName": "string",
        "packageVersion": "string"
      }
    ],
    "participantId": "string",
    "synchronizerId": "string",
    "topologySerial": 0
  }
}