- Intro
- History
- State
- Tokens
- Submit new transaction
Validate clearing transaction of an AppAgent
POST
https://api.trait.tech/tx/examine/clearing_transaction
Submit new transaction
The endpoint doesn't take into account any pending transactions, not finalised by the blockchain yet.
Request
Body Params application/json
Request params for the endpoint `/tx/examine/clearing_transaction`.
tx
object (ClearingTransactionPayload)
required
tx_origin
string
Tx Origin
>= 47 characters<= 49 characters
Match pattern:
^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{47,49}$
app_agent_id
integer
App Agent Id
>= 0<= 4294967295
atomics
array[object (ClearingTransactionAtomic) {1}]
Atomics
Example
{
"tx": {
"tx_origin": "ttmcLgs3b7tegED6wRMFAA6WLYWhYeCL1TgHv6u4VDWptiz8L",
"app_agent_id": 1017,
"atomics": [
{
"actions": [
{
"action_origin": {
"app_agent_address": "ttrnYjkipbBQVVvpcx349CsAvbQvF35JrXHosmbAULSZa7Uyv"
},
"module_name": "Nfts",
"function_name": "mint",
"arguments": [
17,
10000,
"ttmLfYytQ5CgTCrwrCZYUXRN6R4sJeDzSxmAqGAgRnhmeBCzB"
]
}
]
}
]
}
}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.trait.tech/tx/examine/clearing_transaction' \
--header 'Content-Type: application/json' \
--data-raw '{
"tx": {
"tx_origin": "ttmcLgs3b7tegED6wRMFAA6WLYWhYeCL1TgHv6u4VDWptiz8L",
"app_agent_id": 1017,
"atomics": [
{
"actions": [
{
"action_origin": {
"app_agent_address": "ttrnYjkipbBQVVvpcx349CsAvbQvF35JrXHosmbAULSZa7Uyv"
},
"module_name": "Nfts",
"function_name": "mint",
"arguments": [
17,
10000,
"ttmLfYytQ5CgTCrwrCZYUXRN6R4sJeDzSxmAqGAgRnhmeBCzB"
]
}
]
}
]
}
}'
Responses
🟢200OK
application/json
Body
Response schema for the endpoint `/tx/examine/clearing_transaction`.
metadata
object (ResponseMetadata)
required
request_context
object (ResponseBlockId)
required
blockchain_head
object (ResponseBlockId)
required
data
object (ClearingTransactionExaminationInfo)
required
acceptance
boolean
Acceptance
true
if the transaction will be accepted by the blockchain.rejection_info
Rejection Info
Example
{
"metadata": {
"request_context": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000
},
"blockchain_head": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000
}
},
"data": {
"acceptance": true,
"rejection_info": null
}
}
🟠422Parameter Error
Modified at 2024-11-21 18:59:09