Transactions

Submit transaction

Changed on

This endpoint accepts transaction submissions in two formats.

To submit a transaction as JSON, you must submit a SubmitTransactionRequest. To build this request, do the following:

  1. Encode the transaction as BCS. If you are using a language that has native BCS support, make sure of that library. If not, you may take advantage of /transactions/encode_submission. When using this endpoint, make sure you trust the node you're talking to, as it is possible they could manipulate your request.
  2. Sign the encoded transaction and use it to create a TransactionSignature.
  3. Submit the request. Make sure to use the "application/json" Content-Type.

To submit a transaction as BCS, you must submit a SignedTransaction encoded as BCS. See SignedTransaction in types/src/transaction/mod.rs. Make sure to use the application/x.lumio.signed_transaction+bcs Content-Type.

post/transactions

Request

  • Base URL
    /v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /v1/transactions
  • Auth
    none declared

Request body

SubmitTransactionRequest required(unresolved $ref)

Response

PendingTransaction required(unresolved $ref)

Changes

  • 5bfbbc5f3ce7Revision changes
    • breaking

      removed the media type application/x.aptos.signed_transaction+bcs from the request body

    • breaking

      the mandatory response header X-APTOS-BLOCK-HEIGHT removed for the status 202

    • breaking

      the mandatory response header X-APTOS-CHAIN-ID removed for the status 202

    • breaking

      the mandatory response header X-APTOS-EPOCH removed for the status 202

    • breaking

      the mandatory response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 202

    • breaking

      the mandatory response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 202

    • breaking

      the mandatory response header X-APTOS-LEDGER-VERSION removed for the status 202

    • breaking

      the mandatory response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 202

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 400

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 403

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 404

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 413

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 500

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 503

    • warning

      the optional response header X-APTOS-BLOCK-HEIGHT removed for the status 507

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 400

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 403

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 404

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 413

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 500

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 503

    • warning

      the optional response header X-APTOS-CHAIN-ID removed for the status 507

    • warning

      the optional response header X-APTOS-CURSOR removed for the status 202

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 400

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 403

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 404

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 413

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 500

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 503

    • warning

      the optional response header X-APTOS-EPOCH removed for the status 507

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 202

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 400

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 403

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 404

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 413

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 500

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 503

    • warning

      the optional response header X-APTOS-GAS-USED removed for the status 507

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 400

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 403

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 404

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 413

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 500

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 503

    • warning

      the optional response header X-APTOS-LEDGER-OLDEST-VERSION removed for the status 507

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 400

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 403

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 404

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 413

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 500

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 503

    • warning

      the optional response header X-APTOS-LEDGER-TIMESTAMPUSEC removed for the status 507

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 400

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 403

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 404

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 413

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 500

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 503

    • warning

      the optional response header X-APTOS-LEDGER-VERSION removed for the status 507

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 400

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 403

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 404

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 413

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 500

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 503

    • warning

      the optional response header X-APTOS-OLDEST-BLOCK-HEIGHT removed for the status 507

    • info

      added the media type application/x.lumio.signed_transaction+bcs to the request body

  • 7974a45a29e4Revision changes
    • breaking

      removed from the //////// request property oneOf list

    • breaking

      removed from the ///////////// request property oneOf list

    • breaking

      removed from the ////////// request property oneOf list

    • breaking

      removed from the ///////// request property oneOf list

    • breaking

      removed from the ////////// request property oneOf list

    • breaking

      removed from the ///////// request property oneOf list

    • breaking

      added to the //////// response property oneOf list for the response status

    • breaking

      added to the ///////////// response property oneOf list for the response status

    • breaking

      added to the ////////// response property oneOf list for the response status

    • breaking

      added to the ///////// response property oneOf list for the response status

    • breaking

      added to the ////////// response property oneOf list for the response status

    • breaking

      added to the ///////// response property oneOf list for the response status

    • info

      added abstract_signature discriminator mapping keys to the //////// request property

    • info

      added abstract_signature discriminator mapping keys to the ///////////// request property

    • info

      added abstract_signature discriminator mapping keys to the ////////// request property

    • info

      added abstract_signature discriminator mapping keys to the ///////// request property

    • info

      added abstract_signature discriminator mapping keys to the ////////// request property

    • info

      added abstract_signature discriminator mapping keys to the ///////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the //////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the ///////////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the ////////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the ///////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the ////////// request property

    • info

      removed abstraction_signature discriminator mapping keys from the ///////// request property

    • info

      added to the //////// request property oneOf list

    • info

      added to the ///////////// request property oneOf list

    • info

      added to the ////////// request property oneOf list

    • info

      added to the ///////// request property oneOf list

    • info

      added to the ////////// request property oneOf list

    • info

      added to the ///////// request property oneOf list

    • info

      added abstract_signature discriminator mapping keys to the //////// response property for the response status

    • info

      added abstract_signature discriminator mapping keys to the ///////////// response property for the response status

    • info

      added abstract_signature discriminator mapping keys to the ////////// response property for the response status

    • info

      added abstract_signature discriminator mapping keys to the ///////// response property for the response status

    • info

      added abstract_signature discriminator mapping keys to the ////////// response property for the response status

    • info

      added abstract_signature discriminator mapping keys to the ///////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the //////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the ///////////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the ////////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the ///////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the ////////// response property for the response status

    • info

      removed abstraction_signature discriminator mapping keys from the ///////// response property for the response status

    • info

      removed from the //////// response property oneOf list for the response status

    • info

      removed from the ///////////// response property oneOf list for the response status

    • info

      removed from the ////////// response property oneOf list for the response status

    • info

      removed from the ///////// response property oneOf list for the response status

    • info

      removed from the ////////// response property oneOf list for the response status

    • info

      removed from the ///////// response property oneOf list for the response status