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. |
erc20_allowance_changes | erc20_allowance_changes[] | Details of 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 |
erc721Changes Example
{
"erc721_changes": {
"address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
"erc721Change": [
{
"token_aAddress": "0xc2c747e0f7004f9e8817db2ca4997657a7746928",
"token_id": "0x4783",
"token_name": "Hashmasks",
"token_symbol": "HM",
"received": false
}
]
}
}
Allowance Change
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 |
AllowanceChange 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",
}
]
}
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"],
}
]
}