Response Detail

Transaction Validation

Parameter	Type	Description
used_gas	uint	Gas used. The data is represented in base-10 (decimal).
is_revert	bool	If the Txn is reverted
revert_reason	string	Revert Reson
is_simulated	bool	If the simulation successed
simulate_failed_reason	string	Why if simulation failed
suspicious_url	bool	If the user is integrating with suspicious URL
logs	Logs[]	Logs
native_balance_changes	native_balance_changes[]	Change in the native token balance of the address before and after the transaction.
erc20_balance_changes	erc20_balance_changes[]	Details of ERC20 token changes before and after the transaction.
erc721_balance_changes	erc721_balance_changes[]	Details of ERC721 NFT changes before and after the transaction.
erc1155_balance_changes	erc1155_balance_changes[]	Details of ERC721 NFT changes before and
erc20_allowance_changes	erc20_allowance_changes[]	Details of token approval changes for the address before and after the transaction.
erc721_allowance_changes	erc721_allowance_changes[]	Details of ERC721 NFT approval changes for the address before and after the transaction.
erc1155_allowance_changes	erc1155_allowance_changes[]	Details of ERC1155 NFT token approval changes for the address before and after the transaction.
flagged	flagged[]	Risk flag
suspicious_addresses	suspicious_addresses[]	List of suspicious addresses involved in the transaction.

Log Entry

Parameter	Type	Example	Description
address	string	`0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c`	The contract address that emitted the event (i.e., the event source)
topics	Array	`["0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c","0x0000000000000000000000000000111122223333444455556666777788889999"]`	List of event topics.
data	string	`0x0000000000000000000000000000000000000000000000000100000000000000`	Log data.

LogEntry Example

{
    "logs": [
        {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "topics": [
                "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
                "0x0000000000000000000000000000111122223333444455556666777788889999"
            ],
            "data": "0x0000000000000000000000000000000000000000000000000100000000000000"
        }
    ]
}

Native Balance Changes

Parameter	Type	Example	Description
address	string	`0x0000111122223333444455556666777788889999`	Address
before	string	`0x1000000000000000000`	Balance before the transaction
after	string	`0xffff00000000000000`	Balance after the transaction
change	string	`-0x100000000000000`	Balance change after the transaction; can be negative. A negative value indicates a decrease.

nativeBalanceChanges Example

{
    "native_balance_changes": [
        {
            "address": "0x0000111122223333444455556666777788889999",
            "native_change": {
                "change": "-0x100000000000000",
                "before": "0x1000000000000000000",
                "after": "0xffff00000000000000"
            }
        }
    ]
}

ERC20 Balance Changes

Parameter	Type	Example	Description
address	string	`0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c`	Address
token_address	string	`0x68ca006db91312cd60a2238ce775be5f9f738bba`	Token Contract address
token_name	string	`$ USDCGift.com`	Token Name
token_symbol	string	`$ USDCGift.com \<- Visit to claim bonus`	Token Symbol
decimals	string	`0x12`	Decimals
change	string	`0x100000000000000`	Tokne balance change after the transaction; can be negative. A negative value indicates a decrease.

erc20BalanceChanges Example 

{
    "erc20_balance_changes": [
        {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "erc20_change": [
              {
                  	"decimals":"0x12",
                  	"token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
                  	"token_name": "$ USDCGift.com",
                  	"token_symbol": "$ USDCGift.com \<- Visit to claim bonus",
                  	"change": "0x100000000000000"
              }
            ]
              }
    ]
}

ERC721 Balance Changes

Parameter	Type	Example	Description
address	string	`0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c`	Address
token_address	string	`0xc2c747e0f7004f9e8817db2ca4997657a7746928`	Erc721 Token addres
token_name	string	`Hashmasks`	Token Name
token_symbol	string	`HM`	Token Symbol
token_id	string	`0x4783`	NFT ID
received	bool	`false`	Receiving or sending NFT

erc721BalanceChanges Example 

{
    "erc721_changes": {
        "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
        "erc721Change": [
            {
                "token_aAddress": "0xc2c747e0f7004f9e8817db2ca4997657a7746928",
                "token_id": "0x4783",
                "token_name": "Hashmasks",
                "token_symbol": "HM",
                "received": false
            }
        ]
    }
}

ERC1155 Balance Changes

Parameter	Type	Example	Description
address	string	`0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c`	Address
token_address	string	`0xa5d52b8c3cf7abc9983ec891010f0ac3bc58e162`	NFT address
change	string	`0x100000000000000`	Tokne balance change after the transaction; can be negative. A negative value indicates a decrease.
token_id	string	`0x4783`	ERC1155 tokenId
token_name	string	`LORE SEAL`	Token name
token_symbol	string	`LORE`	Token symbol

erc1155BalanceChanges Example 

{
    "erc1155_balance_changes": [
        {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "erc1155_change": [
                {
                    "token_address": "0x495f947276749Ce646f68AC8c248420045cb7b5e",
                    "token_id": "0x4783",
                    "change": "0x100000000000000",
                    "token_name": "LORE SEAL",
                    "token_symbol":"LORE"                    
                }
            ]
        }
    ]
}

ERC20 Allowance Changes

Parameter	Type	Example	Description
token_address	string	`0x68ca006db91312cd60a2238ce775be5f9f738bba`	Token address
owner	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	Owner address
spender	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	Spender address
amount	string	`0xffff00000000000000`	Final approval amount
token_name	string	`Hashmasks`	Token Name
token_symbol	string	`HM`	Token Symbol
decimals	string	`0x12`	Decimals

erc20AllowanceChanges Example

{
    "erc20_allowance_changes": [
            {
                "token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
                "owner": "0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a",
                "spender": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
              	"amount": "0xffff00000000000000",
                "decimals":"0x12",
                "token_address": "0x68ca006db91312cd60a2238ce775be5f9f738bba",
               	"token_name": "$ USDCGift.com",
                "token_symbol": "$ USDCGift.com \<- Visit to claim bonus",

            }
        ]
}

ERC721 Allowance Changes

Parameter	Type	Example	Description
token_address	string	`0xc2c747e0f7004f9e8817db2ca4997657a7746928`	Contract address
owner	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	NFT owner
operater	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	NFT operater
token_id	string	`0x4318`	NFT token ID, would return `""` when approvedForAll is `ture`
approved_for_all	bool	`false`	If is approveForAll
approved	bool	`false`	`ture` for approve, `false` for revoke
token_name	string	`Hashmasks`	Token Name
token_symbol	string	`HM`	Token Symbol

erc721AllowanceChanges Example

{
    "erc721_allowance_changes": [
            {
                "token_address": "0xc2c747e0f7004f9e8817db2ca4997657a7746928",
                "owner": "0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a",
                "spender": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
                "token_id":"0x4318",
                "approved_for_all":false,
                "approved":true,
                "operater": "0x15bE78054060335C49E0Fa00264A456C288bB66d",
                "token_name": "Hashmasks",
                "token_symbol": "HM"
            },
            {
                "token_address": "0xc2c747e0f7004f9e8817db2ca4997657a7746928",
                "owner": "0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a",
                "spender": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
                "token_id":"",
                "approved_for_all":true,
                "approved":true,
                "operater": "0x15bE78054060335C49E0Fa00264A456C288bB66d",
                "token_name": "Hashmasks",
                "token_symbol": "HM"
            },
        ]
}

ERC1155 Allowance Changes

Parameter	Type	Example	Description
token_address	string	`0xa5d52b8c3cf7abc9983ec891010f0ac3bc58e162`	Contract address
owner	string	`0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a`	NFT owner
operater	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	NFT operater
approved	bool	`false`	`ture` for approve, `false` for revoke
token_name	string	`LORE SEAL`	Token name
token_symbol	string	`LORE`	Token symbol

erc1155AllowanceChange Example

{
    "erc1155_allowance_changes": [
            {
                "token_address": "0xa5d52b8c3cf7abc9983ec891010f0ac3bc58e162",
                "owner": "0x40b0aae9cd48526f28d5bbdb5792c9f21b1c115a",
                "spender": "0x10ed43c718714eb63d5aa57b78b54704e256024e",
                "approved":false,
                "operater": "0x15bE78054060335C49E0Fa00264A456C288bB66d",
                "token_name": "LORE SEAL",
                "token_symbol":"LORE"         
            }
        ]
}

Flag

Parameter	Type	Example	Description
type	string	e.g. 'high_risk', 'medium_risk', 'potential_risk'	Potential risk in this Txn.
message	string	e.g. e.g. ‘This transaction is likely to be a contract attack, which will cause a loss of $’, From/TO address 0x… is related to honeypot tokens or has created scam tokens.	Risk detail

Flag Example

{
    "flagged": [
        {
            "type": "high_risk",
            "message": "From/TO address 0x… is related to honeypot tokens or has created scam tokens",
        },
        {
            "type": "high_risk",
            "message": "This transaction is likely to be a contract attack, which will cause a loss of $",
        }
    ]
}

Suspicious Address Integration

Parameter	Type	Example	Description
address	string	`0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22`	Suspicious address integrated in this Txn.
labels	string[]	`["contract_attack", "honeypot_related_address"…]`	Risk label

SuspiciousAddressIntegration Example

{
    "suspicious_addresses": [
        {
            "address": "0x742d35Cc6634C0532925a3b8D03A4bC0c0996C22",
            "labels": ["honeypot_related_address"],
        },
        {
            "address": "0x632d35Cc6634C0532925a3b8D03A4bC0c0996776",
            "labels": ["contract_attack"],
        }
    ]
}