Skip to main content

Apply inputs to contract

Build an unsigned (Cardano) transaction body which applies inputs to an open Marlowe contract. This unsigned transaction must be signed by a wallet (such as a CIP-30 or CIP-45 wallet) before being submitted. To submit the signed transaction, use the PUT /contracts/{contractId}/transactions/{transactionId} endpoint.

Path Parameters
contractId string REQUIRED

Possible values: Value must match regular expression ^[a-fA-F0-9]{64}%23[0-9]+$

A reference to a transaction output with a transaction ID and index. The value must be URL encoded by replacing the '#' character with %23.

Header Parameters
X-Change-Address string REQUIRED

A cardano address, in Bech32 format

X-Address string

A comma-separated list of values

X-Collateral-UTxO string

A comma-separated list of values

Request Body
inputs undefined[] REQUIRED
invalidBefore yyyy-mm-ddThh:MM:ssZ
invalidHereafter yyyy-mm-ddThh:MM:ssZ
metadata object REQUIRED
tags object REQUIRED
version string REQUIRED

Possible values: [v1]

A version of the Marlowe language.

Responses
201
Schema OPTIONAL
links object
transaction string OPTIONAL
resource object

The "type" property of "tx" must be "Tx BabbageEra" or "Tx ConwayEra"

contractId string

Possible values: Value must match regular expression ^[a-fA-F0-9]{64}#[0-9]+$

A reference to a transaction output with a transaction ID and index.

transactionId string

Possible values: Value must match regular expression ^[a-fA-F0-9]{64}$

The hex-encoded identifier of a Cardano transaction

tx object
cborHex string
description string
type string

What type of data is encoded in the CBOR Hex. Valid values include "Tx era", "TxBody era", and "ShelleyTxWitness era" where era is one of "BabbageEra", "ConwayEra".

400

Invalid X-Collateral-UTxO or X-Address or X-Change-Address or body

404

contractId not found