CCPEDIAby Unity Nodes
Documentation/Canton Network Docs/Ledger APIOpenAPIView on Canton Network Docs ↗

POST /v2/dars/validate

POST
/
v2
/
dars
/
validate
Try it
cURL
curl --request POST \
  --url 'http://localhost:7575/v2/dars/validate' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@request.bin'
400
default
<string>

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

Validates the DAR and checks the upgrade compatibility of the DAR’s packages with the set of the already vetted packages on the target vetting synchronizer. See ValidateDarFileRequest for details regarding the target vetting synchronizer. The operation has no effect on the state of the participant or the Canton ledger: the DAR payload and its packages are not persisted neither are the packages vetted.

OpenAPIUpdated 3.5
cURL
curl --request POST \
  --url 'http://localhost:7575/v2/dars/validate' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@request.bin'
400
default
<string>

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

​
Authorizations

​
httpAuth

​
Authorization
string
required
HTTP bearer authentication. Send the token as Authorization: Bearer &lt;token&gt;. Ledger API standard JWT token

​
apiKeyAuth

​
Sec-WebSocket-Protocol
string
required
API key authentication in the header. Ledger API standard JWT token (websocket)

​
Query parameters

​
synchronizerId
string

​
Body

application/octet-stream
​
value
string
required
OpenAPI type: string (binary).

​
Responses

​
200

​
400

Invalid value, Invalid value for: body, Invalid value for: query parameter synchronizerId
text/plain
​
value
string
required

​
default

application/json
​
code
string
required
​
cause
string
required
​
correlationId
string
​
traceId
string
​
context
Map_String
required
​
resources
Tuple2_String_String[]
​
errorCategory
integer (int32)
required
​
grpcCodeValue
integer (int32)
​
retryInfo
string
​
definiteAnswer
boolean

​
History

Updated3.5

The POST /v2/dars/validate operation changed in this snapshot.