Validate clearing transaction of an AppAgent

POST

https://api.trait.tech/tx/examine/clearing_transaction

The endpoint checks whether the provided clearing transaction will be accepted by the blockchain.

The endpoint performs all checks using the state of the blockchain for the specified finalised block.
The endpoint doesn't take into account any pending transactions, not finalised by the blockchain yet.

Request

Body Params application/json

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Successful Response

Body

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

Validate transfer of nft tokens

Build info for new transaction