Similar to ExecuteSubmissionAndWait but additionally returns the transaction

POST /v2/interactive-submission/executeAndWaitForTransaction

Request

curl --request POST \
  --url 'http://localhost:7575/v2/interactive-submission/executeAndWaitForTransaction' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"preparedTransaction":"string","partySignatures":{"signatures":[{}]},"deduplicationPeriod":{},"submissionId":"string","userId":"string","hashingSchemeVersion":"HASHING_SCHEME_VERSION_UNSPECIFIED","minLedgerTime":{"time":{}},"transactionFormat":{"eventFormat":{},"transactionShape":"TRANSACTION_SHAPE_UNSPECIFIED"}}'

200 response

{
  "transaction": {
    "updateId": "string",
    "commandId": "string",
    "workflowId": "string",
    "effectiveAt": "string",
    "events": [
      {}
    ],
    "offset": 0,
    "synchronizerId": "string",
    "traceContext": {},
    "recordTime": "string",
    "externalTransactionHash": "string",
    "paidTrafficCost": 0
  }
}

JSON Ledger API

Similar to ExecuteSubmissionAndWait but additionally returns the transaction

OpenAPISince 3.4Changed 3.5

Similar to ExecuteSubmissionAndWait but additionally returns the transaction

Protocol Details

Operation IDpostV2Interactive-submissionExecuteandwaitfortransaction

AuthenticationBearer token

Published3.5

Inputs

Request body

application/json

preparedTransaction · string · required

the prepared transaction Typically this is the value of the prepared_transaction field in PrepareSubmissionResponse obtained from calling prepareSubmission. Required

partySignatures · object · required

OpenAPI type: PartySignatures.

Additional signatures provided by the submitting parties

deduplicationPeriod · object

OpenAPI type: DeduplicationPeriod2.

submissionId · string · required

A unique identifier to distinguish completions for different submissions with the same change ID. Typically a random UUID. Applications are expected to use a different UUID for each retry of a submission with the same change ID. Must be a valid LedgerString (as described in value.proto). Required

userId · string

See [PrepareSubmissionRequest.user_id] Optional

hashingSchemeVersion · string · required

The hashing scheme version used when building the hash Required

minLedgerTime · object

OpenAPI type: MinLedgerTime.

transactionFormat · object

OpenAPI type: TransactionFormat.

A format that specifies what events to include in Daml transactions and what data to compute and include for them.

Outputs

200

application/json

transaction · JsTransaction · required

Filtered view of an on-ledger transaction’s create and archive events.

400

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

Changed3.5

The POST /v2/interactive-submission/executeAndWaitForTransaction operation changed in this snapshot.

Introduced3.4

Request

curl --request POST \
  --url 'http://localhost:7575/v2/interactive-submission/executeAndWaitForTransaction' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"preparedTransaction":"string","partySignatures":{"signatures":[{}]},"deduplicationPeriod":{},"submissionId":"string","userId":"string","hashingSchemeVersion":"HASHING_SCHEME_VERSION_UNSPECIFIED","minLedgerTime":{"time":{}},"transactionFormat":{"eventFormat":{},"transactionShape":"TRANSACTION_SHAPE_UNSPECIFIED"}}'

200 response

{
  "transaction": {
    "updateId": "string",
    "commandId": "string",
    "workflowId": "string",
    "effectiveAt": "string",
    "events": [
      {}
    ],
    "offset": 0,
    "synchronizerId": "string",
    "traceContext": {},
    "recordTime": "string",
    "externalTransactionHash": "string",
    "paidTrafficCost": 0
  }
}