Transactions

Transactions Api

Chain id (v1)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v1/transactions/chain_id

Fetch chain id

Responses

200

Current chain id

application/json

Responseinteger · u-int8

get

/rpc/v1/transactions/chain_id

HTTPcURLJavaScriptPython

GET /rpc/v1/transactions/chain_id HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Current chain id

1

Transaction parameters (v1)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v1/transactions/parameters

Retrieve limits that a client must respect when composing a transaction.

Responses

200

Acceptable parameters for transaction submission

application/json

get

/rpc/v1/transactions/parameters

HTTPcURLJavaScriptPython

GET /rpc/v1/transactions/parameters HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Acceptable parameters for transaction submission

{
  "max_transaction_time_to_live_seconds": 1
}

Deprecated

Submit transaction (v1)

post

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v1/transactions/submit

Submit a transaction to Supra.

Body

application/json

Transaction variants supported by Supra.

or

Responses

200

transaction submitted

application/json

Responsestring

Hex encoded hash

post

/rpc/v1/transactions/submit

HTTPcURLJavaScriptPython

POST /rpc/v1/transactions/submit HTTP/1.1
Host: rpc-mainnet.supra.com
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "Smr": {
    "signer_data": {
      "signer": {},
      "signature": {}
    },
    "transaction": {
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {}
    }
  }
}

200

transaction submitted

text

Deprecated

Estimate gas price (v2)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v2/transactions/estimate_gas_price

Get statistics derived from the gas prices of recently executed transactions.

Responses

200

Returns the mean, median and maximum gas prices of recently executed transactions.

application/json

get

/rpc/v2/transactions/estimate_gas_price

HTTPcURLJavaScriptPython

GET /rpc/v2/transactions/estimate_gas_price HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Returns the mean, median and maximum gas prices of recently executed transactions.

{
  "mean_gas_price": 1,
  "max_gas_price": 1,
  "median_gas_price": 1
}

Deprecated

Simulate a transaction (v2)

post

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v2/transactions/simulate

Body

application/json

Transaction variants supported by Supra.

or

Responses

200

Simulate a transaction against the current state of the RPC node. The transaction must have an invalid signature.

application/json

post

/rpc/v2/transactions/simulate

HTTPcURLJavaScriptPython

POST /rpc/v2/transactions/simulate HTTP/1.1
Host: rpc-mainnet.supra.com
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "Smr": {
    "signer_data": {
      "signer": {},
      "signature": {}
    },
    "transaction": {
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {}
    }
  }
}

200

Simulate a transaction against the current state of the RPC node. The transaction must have an invalid signature.

{
  "authenticator": {},
  "block_header": null,
  "hash": "text",
  "header": {
    "chain_id": 1,
    "expiration_timestamp": {
      "timestamp": 1
    },
    "sender": "text",
    "sequence_number": 1,
    "gas_unit_price": 1,
    "max_gas_amount": 1
  },
  "payload": {},
  "output": {
    "Dkg": "Success"
  },
  "status": "Success"
}

Deprecated

Get transaction by hash (v2)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v2/transactions/{hash}

Get information about a transaction by its hash.

Path parameters

hashstringRequired

Hash of the transaction to lookup

Responses

200

Transaction data of the given transaction hash

application/json

get

/rpc/v2/transactions/{hash}

HTTPcURLJavaScriptPython

GET /rpc/v2/transactions/{hash} HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Transaction data of the given transaction hash

{
  "authenticator": {},
  "block_header": null,
  "hash": "text",
  "header": {
    "chain_id": 1,
    "expiration_timestamp": {
      "timestamp": 1
    },
    "sender": "text",
    "sequence_number": 1,
    "gas_unit_price": 1,
    "max_gas_amount": 1
  },
  "payload": {},
  "output": {
    "Dkg": "Success"
  },
  "status": "Success"
}

Estimate gas price (v3)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v3/transactions/estimate_gas_price

Get statistics derived from the gas prices of recently executed transactions and minimum configured gas price.

Responses

200

Returns the information related to gas price. This included minimum configured gas price as well as mean, median and maximum gas prices of recently executed transactions.

application/json

get

/rpc/v3/transactions/estimate_gas_price

HTTPcURLJavaScriptPython

GET /rpc/v3/transactions/estimate_gas_price HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Returns the information related to gas price. This included minimum configured gas price as well as mean, median and maximum gas prices of recently executed transactions.

{
  "mean_gas_price": 1,
  "max_gas_price": 1,
  "median_gas_price": 1,
  "min_configured_gas_price": 1
}

Simulate a transaction (v3)

post

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v3/transactions/simulate

Body

application/jsonapplication/x.supra.signed_transaction+bcs

Transaction variants supported by Supra.

or

Responses

200

Simulate a transaction against the current state of the RPC node. The transaction must have an invalid signature.

application/json

post

/rpc/v3/transactions/simulate

HTTPcURLJavaScriptPython

POST /rpc/v3/transactions/simulate HTTP/1.1
Host: rpc-mainnet.supra.com
Content-Type: application/json
Accept: */*
Content-Length: 796

{
  "Move": {
    "raw_txn": {
      "sender": "3ef46383308ad31c00ce1ca02bf113a9327a94e302d934f32f70954bb4cba035",
      "sequence_number": 0,
      "payload": {
        "EntryFunction": {
          "module": {
            "address": "0x0000000000000000000000000000000000000000000000000000000000000001",
            "name": "supra_account"
          },
          "function": "transfer",
          "ty_args": [],
          "args": [
            [
              234,
              100,
              210,
              42,
              5,
              4,
              135,
              249,
              11,
              193,
              212,
              28,
              224,
              115,
              170,
              202,
              20,
              90,
              51,
              180,
              133,
              54,
              138,
              63,
              213,
              95,
              209,
              36,
              173,
              235,
              38,
              224
            ],
            [
              0,
              45,
              49,
              1,
              0,
              0,
              0,
              0
            ]
          ]
        }
      },
      "max_gas_amount": 500000,
      "gas_unit_price": 100,
      "expiration_timestamp_secs": 1841875694,
      "chain_id": 255
    },
    "authenticator": {
      "Ed25519": {
        "public_key": "0x7b017e7c4b83e06ad2dab990ff3b091f9995a2a2610dee1d665dc8a2510b539f",
        "signature": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
      }
    }
  }
}

application/jsonapplication/x.supra.signed_transaction+bcs

200

Simulate a transaction against the current state of the RPC node. The transaction must have an invalid signature.

{
  "authenticator": {},
  "block_header": null,
  "hash": "text",
  "header": {
    "chain_id": 1,
    "expiration_timestamp": {
      "timestamp": 1
    },
    "sender": "text",
    "sequence_number": 1,
    "gas_unit_price": 1,
    "max_gas_amount": 1
  },
  "payload": {},
  "output": {
    "Dkg": "Success"
  },
  "status": "Success"
}

Submit transaction (v3)

post

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v3/transactions/submit

Submit a transaction to Supra.

Body

application/jsonapplication/x.supra.signed_transaction+bcs

Transaction variants supported by Supra.

or

Responses

200

transaction submitted

application/json

Responsestring

Hex encoded hash

post

/rpc/v3/transactions/submit

HTTPcURLJavaScriptPython

POST /rpc/v3/transactions/submit HTTP/1.1
Host: rpc-mainnet.supra.com
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "Smr": {
    "signer_data": {
      "signer": {},
      "signature": {}
    },
    "transaction": {
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {}
    }
  }
}

application/jsonapplication/x.supra.signed_transaction+bcs

200

transaction submitted

text

Get transaction by hash (v3)

get

https://rpc-mainnet.supra.comhttps://rpc-mainnet1.supra.comhttps://rpc-mainnet2.supra.comhttps://rpc-mainnet3.supra.comhttps://rpc-mainnet4.supra.comhttps://rpc-mainnet5.supra.comhttps://rpc-wallet-mainnet.supra.comhttps://rpc-suprascan-mainnet.supra.comhttp://localhost:29000

/rpc/v3/transactions/{hash}

Get information about a transaction by its hash.

Path parameters

hashstringRequired

Hash of the transaction to lookup

Query parameters

typestring · enumOptional

Type of the transaction to be queried.

Possible values:

exclude_uncommittedbooleanOptional

If set to true will exclude uncommitted transactions.

Responses

200

Transaction data of the given transaction hash

application/json

Responseone of

or

or

or

get

/rpc/v3/transactions/{hash}

HTTPcURLJavaScriptPython

GET /rpc/v3/transactions/{hash} HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Transaction data of the given transaction hash

{
  "authenticator": {},
  "block_header": null,
  "hash": "text",
  "header": {
    "chain_id": 1,
    "expiration_timestamp": {
      "timestamp": 1
    },
    "sender": "text",
    "sequence_number": 1,
    "gas_unit_price": 1,
    "max_gas_amount": 1
  },
  "payload": {},
  "output": {
    "Dkg": "Success"
  },
  "status": "Success",
  "txn_type": "user"
}