Submit External Transaction

POST /proxy/transactions

status: stable

Submits a transaction that was created and signed outside of cardano-wallet.

NOTE: Unlike the submitTransaction endpoint, there are no guarantees that a transaction accepted by this endpoint will actually be included in the chain. It's up to the caller to retry submission until the transaction is confirmed.

application/octet-stream

Body

string(binary) string(binary)

Signed transaction message binary blob.

Responses

  • 425 application/json

    Mempool is Full

    Hide response attributes Show response attributes object
    • message string Required

      May occur when submitting a serialized transaction to a node with full mempool.

    • code string Required

      Value is mempool_is_full.
  • 415 application/json

    Unsupported Media Type

    Hide response attributes Show response attributes object
    • message string Required

      May occur when providing an invalid 'Content-Type' header.

    • code string Required

      Value is unsupported_media_type.
  • 406 application/json

    Not Acceptable

    Hide response attributes Show response attributes object
    • message string Required

      May occur when providing an invalid 'Accept' header.

    • code string Required

      Value is not_acceptable.
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • message string Required

      May occur when a request is not well-formed; that is, it fails to parse successfully. This could be the case when some required parameters are missing or, when malformed values are provided.

    • code string Required

      Value is bad_request.
  • 202 application/json

    Accepted

    Hide response attribute Show response attribute object
    • id string(hex) Required

      A unique identifier for this transaction

      Minimum length is 64, maximum length is 64.
POST /proxy/transactions 
curl \
 --request POST https://localhost:8090/v2/proxy/transactions \
 --header "Content-Type: application/octet-stream" \
 --data-binary '@file'
Response examples (425) 
{
  "message": "string",
  "code": "mempool_is_full"
}
Response examples (415) 
{
  "message": "string",
  "code": "unsupported_media_type"
}
Response examples (406) 
{
  "message": "string",
  "code": "not_acceptable"
}
Response examples (400) 
{
  "message": "string",
  "code": "bad_request"
}
Response examples (202) 
{
  "id": "1423856bc91c49e928f6f30f4e8d665d53eb4ab6028bd0ac971809d514c92db1"
}