package network.forta

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc EvaluateAlert (EvaluateAlertRequest, EvaluateAlertResponse)

  agent.proto:14

• rpc EvaluateBlock (EvaluateBlockRequest, EvaluateBlockResponse)

  agent.proto:13

• rpc EvaluateTx (EvaluateTxRequest, EvaluateTxResponse)

  agent.proto:12

• rpc HealthCheck (HealthCheckRequest, HealthCheckResponse)

  agent.proto:15

  message HealthCheckRequest

  agent.proto:28

  (message has no fields)

  message HealthCheckResponse

  agent.proto:30

  • HealthCheckResponse.ResponseStatus status = 1

  • repeated Error errors = 2

• rpc Initialize (InitializeRequest, InitializeResponse)

  agent.proto:11

  message InitializeRequest

  agent.proto:41

  • string agentId = 1

  • string proxyHost = 2

  • int32 shardId = 3

  message InitializeResponse

  agent.proto:47

  • ResponseStatus status = 1

  • repeated Error errors = 2

  • repeated string addresses = 3

  • optional AlertConfig alertConfig = 4

• rpc Notify (NotifyRequest, NotifyResponse)

  publisher.proto:10

  message NotifyRequest

  publisher.proto:13

  • optional SignedAlert signedAlert = 1

  • optional EvaluateTxRequest evalTxRequest = 2

  • optional EvaluateTxResponse evalTxResponse = 3

  • optional EvaluateBlockRequest evalBlockRequest = 4

  • optional EvaluateBlockResponse evalBlockResponse = 5

  • optional AgentInfo agentInfo = 6

  • optional TrackingTimestamps timestamps = 7

  • optional EvaluateAlertRequest evalAlertRequest = 8

  • optional EvaluateAlertResponse evalAlertResponse = 9

  message NotifyResponse

  publisher.proto:25

  (message has no fields)

• rpc Get (GetRequest, GetResponse)

  storage.proto:62

  message GetRequest

  storage.proto:18

  • string contentId = 1

  • string contentPath = 2

  • bool download = 3

  message GetResponse

  storage.proto:24

  • bytes bytes = 1

• rpc List (ListRequest, ListResponse)

  storage.proto:63

  message ListRequest

  storage.proto:33

  • string user = 1

  • string kind = 2

  • SortDirection sort = 3

  • int64 offset = 4

  • int64 limit = 5

  message ListResponse

  storage.proto:46

  • repeated ContentInfo contents = 1

• rpc Provider (ProviderRequest, ProviderResponse)

  storage.proto:65

  message ProviderRequest

  storage.proto:50

  (message has no fields)

  message ProviderResponse

  storage.proto:56

  • optional Provider provider = 1

• rpc Put (PutRequest, PutResponse)

  storage.proto:61

  message PutRequest

  storage.proto:7

  • string user = 1

  • string kind = 2

  • bytes bytes = 3

  message PutResponse

  storage.proto:13

  • string contentId = 1

  • string contentPath = 2

• string id = 1

• AlertType type = 2

• optional Finding finding = 3

• optional APIAlert.APIAlertAgent agent = 4

• string timestamp = 5

• optional APIAlert.Source source = 6

Used in: APIAlert

• string id = 1

Used in: APIAlert

• string scanner = 1

Used in: Transaction

• string address = 1

• repeated string storageKeys = 2

Used in: AlertBatch, BlockResults, CombinationAlertResults, TransactionResults

• string agentManifest = 1

• repeated SignedAlert alerts = 2

Used in: Alert, BatchAgent, NotifyRequest

• string image = 1

• string imageHash = 2

• string id = 3

• bool isTest = 4

• string manifest = 5

Used in: AgentMetricList

• string agentId = 1

• string timestamp = 2

• string name = 3

• double value = 4

• string details = 5

• int32 shardId = 6

• int64 chainId = 7

• repeated AgentMetric Metrics = 1

Used in: AlertBatch

• string agentId = 1

• string timestamp = 2

• repeated MetricSummary metrics = 3

Used in: SignedAlert

• string id = 1

• AlertType type = 2

• optional Finding finding = 3

• string timestamp = 4

• map<string, string> metadata = 5

• optional AgentInfo agent = 6

• map<string, string> tags = 7

• optional ScannerInfo scanner = 8

• optional TrackingTimestamps timestamps = 9

• bool truncated = 10

• optional BloomFilter addressBloomFilter = 11

a scanner encodes this into a SignedPayload of type BATCH

• uint64 chainId = 1

• uint64 blockStart = 2

• uint64 blockEnd = 3

• uint32 alertCount = 4

• Finding.Severity maxSeverity = 5

• repeated BlockResults results = 6

• repeated BatchAgent agents = 7

• repeated AgentMetrics metrics = 8

• optional ScannerVersion scannerVersion = 9

• string parent = 10

• repeated AgentAlerts privateAlerts = 11

• uint64 latestBlockInput = 12

• optional InspectionResults inspectionResults = 13

• repeated CombinationAlertResults combinationAlerts = 14

• optional Provider provider = 15

• optional Estimation estimation = 16

Used in: InitializeResponse

• repeated CombinerBotSubscription subscriptions = 1

Used in: CombinationAlertResults, EvaluateAlertRequest

• optional AlertEvent.Alert alert = 1

• optional TrackingTimestamps timestamps = 2

Used in: AlertEvent

• string alertId = 1

  Unique string to identify this class of finding, primarily used to group similar findings for the end user

• repeated string addresses = 2

  List of addresses involved in the alert

• repeated Alert.Contract contracts = 3

  List of contracts related to the alert

• string createdAt = 4

  Timestamp when the alert was published

• string description = 5

• string hash = 6

• map<string, string> metadata = 7

• string name = 8

• repeated Alert.Project projects = 9

• int32 scanNodeCount = 10

• string severity = 11

• optional Alert.Source source = 12

• string findingType = 13

• repeated string relatedAlerts = 14

• uint64 chainId = 15

• repeated Alert.Label labels = 16

• bool truncated = 17

• optional BloomFilter addressBloomFilter = 18

Used in: Source

• uint64 number = 1

• string hash = 2

• string timestamp = 3

• uint64 chainId = 4

Used in: Source

• repeated string chainIds = 1

• string createdAt = 2

• string description = 3

• string developer = 4

• string DocReference = 5

• bool enabled = 6

• string id = 7

• string image = 8

• string name = 9

• string reference = 10

• string repository = 11

• repeated string projects = 12

• repeated string scanNodes = 13

• string version = 14

Used in: Alert

• string name = 1

• string projectId = 2

Used in: Alert

• string label = 1

• float confidence = 2

• string entity = 3

• string entityType = 4

• bool remove = 5

• repeated string metadata = 6

• string uniqueKey = 7

• repeated float embedding = 8

Used in: Alert

• string id = 1

Used in: Alert

• string transactionHash = 1

• optional Bot bot = 2

• optional Block block = 3

• optional SourceAlertEvent sourceAlert = 4

Used in: Source

• string botId = 1

• string hash = 2

• string timestamp = 3

• uint64 chainId = 4

• repeated SignedAlert alerts = 1

• string nextPageToken = 2

Used in: APIAlert, Alert

• UNKNOWN_ALERT_TYPE = 0

• TRANSACTION = 1

• BLOCK = 2

• PRIVATE = 3

• COMBINATION = 4

• API = 5

Used in: AlertBatch

• optional AgentInfo info = 1

• repeated uint64 blocks = 2

• repeated string transactions = 3

• repeated string combinations = 4

an analyzer endpoint encodes this into a SignedPayload of type BATCH_RECEIPT

• optional SignedPayload batchSummary = 1

• string timestamp = 2

a scanner encodes this into a SignedPayload of type BATCH_SUMMARY

• string batch = 1

• uint64 chainId = 2

• uint64 blockStart = 3

• uint64 blockEnd = 4

• uint32 alertCount = 5

• optional ScannerVersion scannerVersion = 6

• string previousReceipt = 7

• uint64 latestBlockInput = 8

• string timestamp = 9

• optional InspectionResults inspectionResults = 13

• optional Provider provider = 14

Used in: BlockResults

• string blockHash = 1

• uint64 blockNumber = 2

• string blockTimestamp = 3

Used in: BlocksData

• uint64 chainID = 1

• optional BlockWithTransactions block = 2

• repeated LogEntry logs = 3

• repeated Trace traces = 4

Used in: EvaluateBlockRequest

• BlockEvent.EventType type = 1

• string blockHash = 2

• string blockNumber = 3

• optional BlockEvent.Network network = 4

• optional BlockEvent.EthBlock block = 5

• optional TrackingTimestamps timestamps = 6

Used in: BlockEvent

• string difficulty = 1

• string extraData = 2

• string gasLimit = 3

• string gasUsed = 4

• string hash = 5

• string logsBloom = 6

• string miner = 7

• string mixHash = 8

• string nonce = 9

• string number = 10

• string parentHash = 11

• string receiptsRoot = 12

• string sha3Uncles = 13

• string size = 14

• string stateRoot = 15

• string timestamp = 16

• string totalDifficulty = 17

• repeated string transactions = 18

• string transactionsRoot = 19

• repeated string uncles = 20

• string baseFeePerGas = 21

• string blobGasUsed = 22

Used in: BlockEvent

• BLOCK = 0

• REORG = 1

Used in: BlockEvent

• string chainId = 1

Used in: AlertBatch

• optional Block block = 1

• repeated AgentAlerts results = 2

• repeated TransactionResults transactions = 3

Used in: BlockData

• string baseFeePerGas = 1

• string difficulty = 2

• string extraData = 3

• string gasLimit = 4

• string gasUsed = 5

• string hash = 6

• string logsBloom = 7

• string miner = 8

• string mixHash = 9

• string nonce = 10

• string number = 11

• string parentHash = 12

• string receiptsRoot = 13

• string sha3Uncles = 14

• string size = 15

• string stateRoot = 16

• string timestamp = 17

• string totalDifficulty = 18

• repeated Transaction transactions = 19

• string transactionsRoot = 20

• repeated string uncles = 21

• string blobGasUsed = 22

• string parentBeaconBlockRoot = 23

• string excessBlobGas = 24

• repeated Withdrawal withdrawals = 25

• string withdrawalsRoot = 26

• repeated BlockData blocks = 1

Used in: Alert, AlertEvent.Alert

• string k = 1

• string m = 2

• string bitset = 3

• uint32 itemCount = 4

Used in: AlertBatch

• optional AlertEvent alertEvent = 1

• repeated AgentAlerts results = 2

Used in: AlertConfig

• string botId = 1

• string alertId = 2

• repeated string alertIds = 3

• uint64 chainId = 4

Used in: ListResponse

• string contentPath = 1

• string contentId = 2

Used in: EvaluateAlertResponse, EvaluateBlockResponse, EvaluateTxResponse, HealthCheckResponse, InitializeResponse

• string message = 1

Used in: AlertBatch

• double blockScore = 1

Used as request type in: Agent.EvaluateAlert

Used as field type in: NotifyRequest

• string requestId = 1

• optional AlertEvent event = 2

• string targetBotId = 3

• int32 shardId = 4

Used as response type in: Agent.EvaluateAlert

Used as field type in: NotifyRequest

• ResponseStatus status = 1

• repeated Error errors = 2

• repeated Finding findings = 3

• map<string, string> metadata = 4

• string timestamp = 5

• uint32 latencyMs = 6

• bool private = 7

Used as request type in: Agent.EvaluateBlock

Used as field type in: NotifyRequest

• string requestId = 1

• optional BlockEvent event = 2

• int32 shardId = 3

Used as response type in: Agent.EvaluateBlock

Used as field type in: NotifyRequest

• ResponseStatus status = 1

• repeated Error errors = 2

• repeated Finding findings = 3

• map<string, string> metadata = 4

• string timestamp = 5

• uint32 latencyMs = 6

• bool private = 7

Used as request type in: Agent.EvaluateTx

Used as field type in: NotifyRequest

• string requestId = 1

• optional TransactionEvent event = 2

• int32 shardId = 3

Used as response type in: Agent.EvaluateTx

Used as field type in: NotifyRequest

• ResponseStatus status = 1

• repeated Error errors = 2

• repeated Finding findings = 3

• map<string, string> metadata = 4

• string timestamp = 5

• uint32 latencyMs = 6

• bool private = 7

Used in: APIAlert, Alert, EvaluateAlertResponse, EvaluateBlockResponse, EvaluateTxResponse

• string protocol = 1

• Finding.Severity severity = 2

• map<string, string> metadata = 3

• Finding.FindingType type = 4

• string alertId = 5

• string name = 6

• string description = 7

• bool private = 9

• repeated string addresses = 10

• map<string, double> indicators = 11

• repeated Label labels = 12

• repeated string relatedAlerts = 13

• string uniqueKey = 14

• optional Source source = 15

• string timestamp = 16

Used in: Finding

• UNKNOWN_TYPE = 0

• EXPLOIT = 1

• SUSPICIOUS = 2

• DEGRADED = 3

• INFORMATION = 4

• SCAM = 5

Used in: AlertBatch, Finding

• UNKNOWN = 0

• INFO = 1

• LOW = 2

• MEDIUM = 3

• HIGH = 4

• CRITICAL = 5

Used in: HealthCheckResponse

• UNKNOWN = 0

• ERROR = 1

• SUCCESS = 2

Used in: InspectionResults

• uint64 blockNumber = 1

• string scanApiHost = 2

• string proxyApiHost = 3

• string traceApiHost = 4

• bool checkTrace = 5

• string registryApiHost = 6

• string ensContractAddress = 7

• string scannerAddress = 8

Used in: AlertBatch, BatchSummary

• optional InspectionInputs inputs = 1

• map<string, string> metadata = 2

• map<string, double> indicators = 3

Used in: Finding

• Label.EntityType entityType = 1

• string entity = 2

• float confidence = 4

• bool remove = 6

• string label = 7

• repeated string metadata = 8

• string uniqueKey = 9

• repeated float embedding = 10

Used in: Label

• UNKNOWN_ENTITY_TYPE = 0

• ADDRESS = 1

• TRANSACTION = 2

• BLOCK = 3

• URL = 4

Used in: BlockData

• string address = 1

• string blockHash = 2

• string blockNumber = 3

• string data = 4

• string logIndex = 5

• bool removed = 6

• repeated string topics = 7

• string transactionHash = 8

• string transactionIndex = 9

Used in: AgentMetrics

• string name = 1

• uint32 count = 2

• double max = 3

• double average = 4

• double sum = 5

• double p95 = 6

• string details = 7

• int32 shardId = 8

• int64 chainId = 9

Used in: AlertBatch, BatchSummary, ProviderResponse

• string id = 1

Used in: EvaluateAlertResponse, EvaluateBlockResponse, EvaluateTxResponse, InitializeResponse

• UNKNOWN = 0

• ERROR = 1

• SUCCESS = 2

Used in: Alert

• string address = 1

Used in: AlertBatch, BatchSummary

• string commit = 1

• string ipfs = 2

• string version = 3

• bool autoUpdates = 4

Used in: SignedAlert, SignedPayload

• string signature = 1

• string algorithm = 2

• string signer = 3

Used in: AgentAlerts, AlertResponse, NotifyRequest

• optional Alert alert = 1

• optional Signature signature = 2

• string chainId = 3

• string blockNumber = 4

• string publishedWithTx = 5

Used in: BatchReceipt

• SignedPayload.PayloadType type = 1

• optional Signature signature = 2

• string encoded = 3

defaults to batch because previous batch schema didn't have the type property

Used in: SignedPayload

• BATCH = 0

• BATCH_SUMMARY = 1

• BATCH_RECEIPT = 2

Used in: ListRequest

• DESC = 0

• ASC = 1

Used in: Finding

• repeated Source.TransactionSource transactions = 1

• repeated Source.BlockSource blocks = 2

• repeated Source.URLSource urls = 3

• repeated Source.ChainSource chains = 4

• repeated Source.AlertSource alerts = 5

• repeated Source.CustomSource customSources = 6

Used in: Source

• string id = 1

Used in: Source

• uint64 chainId = 1

• string hash = 2

• uint64 number = 3

Used in: Source

• uint64 chainId = 1

Used in: Source

• string name = 1

• string value = 2

Used in: Source

• uint64 chainId = 1

• string hash = 2

Used in: Source

• string url = 1

Used in: BlockData

• optional TraceAction action = 1

• optional TraceResult result = 2

• int32 subtraces = 3

• repeated int64 traceAddress = 4

• string transactionHash = 5

• int64 transactionPosition = 6

• string type = 7

• string error = 8

Used in: Trace

• string callType = 1

• string to = 2

• string input = 3

• string from = 4

• string gas = 5

• string value = 6

• string init = 7

• string address = 8

• string balance = 9

• string refundAddress = 10

Used in: Trace

• string output = 1

• string gasUsed = 2

• string address = 3

• string code = 4

Used in: Alert, AlertEvent, BlockEvent, NotifyRequest, TransactionEvent

• string block = 1

• string feed = 2

• string botRequest = 3

• string botResponse = 4

• string sourceAlert = 5

Used in: BlockWithTransactions

• string from = 3

• string gas = 4

• string gasPrice = 5

• string hash = 6

• string input = 7

• string nonce = 8

• string to = 9

• string transactionIndex = 10

• string value = 11

• string v = 12

• string r = 13

• string s = 14

• string maxFeePerGas = 15

• string maxPriorityFeePerGas = 16

• string type = 17

• repeated AccessList accessList = 18

• string yParity = 19

Used in: EvaluateTxRequest, TransactionResults

• TransactionEvent.EventType type = 1

• optional TransactionEvent.EthTransaction transaction = 2

• optional TransactionEvent.EthReceipt receipt = 3

• optional TransactionEvent.Network network = 4

• repeated TransactionEvent.Trace traces = 5

• map<string, bool> addresses = 6

• optional TransactionEvent.EthBlock block = 7

• repeated TransactionEvent.Log logs = 8

• bool isContractDeployment = 9

• string contractAddress = 10

• optional TrackingTimestamps timestamps = 11

• map<string, bool> txAddresses = 12

Used in: TransactionEvent

• string blockHash = 1

• string blockNumber = 2

• string blockTimestamp = 3

• string baseFeePerGas = 4

Used in: TransactionEvent

• string root = 1

• string status = 2

• string cumulativeGasUsed = 3

• string logsBloom = 4

• repeated Log logs = 5

• string transactionHash = 6

• string contractAddress = 7

• string gasUsed = 8

• string blockHash = 9

• string blockNumber = 10

• string transactionIndex = 11

Used in: TransactionEvent

• string type = 1

• string nonce = 2

• string gasPrice = 3

• string gas = 4

• string value = 5

• string input = 6

• string v = 7

• string r = 8

• string s = 9

• string to = 10

• string hash = 11

• string from = 12

• string maxFeePerGas = 13

• string maxPriorityFeePerGas = 14

Used in: TransactionEvent

• BLOCK = 0

• REORG = 1

Used in: TransactionEvent, EthReceipt

• string address = 1

• repeated string topics = 2

• string data = 3

• string blockNumber = 4

• string transactionHash = 5

• string transactionIndex = 6

• string blockHash = 7

• string logIndex = 8

• bool removed = 9

Used in: TransactionEvent

• string chainId = 1

Used in: TransactionEvent

• optional TraceAction action = 1

• string blockHash = 2

• int64 blockNumber = 3

• optional TraceResult result = 4

• int64 subtraces = 5

• repeated int64 traceAddress = 6

• string transactionHash = 7

• int64 transactionPosition = 8

• string type = 9

• string error = 10

Used in: Trace

• string callType = 1

• string to = 2

• string input = 3

• string from = 4

• string value = 5

• string init = 6

• string address = 7

• string balance = 8

• string refundAddress = 9

Used in: Trace

• string gasUsed = 1

• string address = 2

• string code = 3

• string output = 4

Used in: BlockResults

• optional TransactionEvent transaction = 1

• repeated AgentAlerts results = 2

Used in: BlockWithTransactions

• string index = 1

• string validatorIndex = 2

• string address = 3

• string amount = 4