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:27000

/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

Deprecated

Estimate gas price (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:27000

/rpc/v1/transactions/estimate_gas_price

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

Responses

200

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

application/json

get

/rpc/v1/transactions/estimate_gas_price

HTTPcURLJavaScriptPython

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

200

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

{
  "mean_gas_price": 1,
  "max_gas_price": 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:27000

/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

Simulate a 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:27000

/rpc/v1/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/v1/transactions/simulate

HTTPcURLJavaScriptPython

POST /rpc/v1/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"
      }
    }
  }
}

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 (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:27000

/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

Get transaction by hash (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:27000

/rpc/v1/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

Responseone of

nullOptional

or

get

/rpc/v1/transactions/{hash}

HTTPcURLJavaScriptPython

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

200

Transaction data of the given transaction hash

No content

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:27000

/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
}

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:27000

/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"
}

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:27000

/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"
}

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:27000

/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: 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

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:27000

/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:27000

/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:

Responses

200

Transaction data of the given transaction hash

application/json

Responseone of

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"
}