Skip to main content

yevm_lens/
lib.rs

1mod analyse;
2
3pub use analyse::analyse;
4
5use serde::{Deserialize, Serialize};
6use yevm_base::{Acc, Int};
7
8#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
9#[serde(rename_all = "camelCase")]
10pub struct EthChange {
11    pub acc: Acc,
12    pub before: Int,
13    pub after: Int,
14}
15
16#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
17#[serde(rename_all = "camelCase")]
18pub struct Erc20Transfer {
19    pub token: Acc,
20    pub from: Acc,
21    pub to: Acc,
22    pub amount: Option<Int>,
23}
24
25#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
26#[serde(rename_all = "camelCase")]
27pub struct Erc20Approval {
28    pub token: Acc,
29    pub owner: Acc,
30    pub spender: Acc,
31    pub allowance: Option<Int>,
32}
33
34#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
35#[serde(rename_all = "camelCase")]
36pub struct Erc721Transfer {
37    pub token: Acc,
38    pub from: Acc,
39    pub to: Acc,
40    pub token_id: Option<Int>,
41}
42
43#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
44#[serde(rename_all = "camelCase")]
45pub struct ProxySwap {
46    pub proxy: Acc,
47    pub slot: Int,
48    pub old_impl: Acc,
49    pub new_impl: Acc,
50}
51
52#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
53#[serde(rename_all = "camelCase")]
54pub struct ForgedTransfer {
55    pub token: Acc,
56    pub from: Acc,
57    pub to: Acc,
58}
59
60#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
61#[serde(rename_all = "camelCase")]
62pub struct FeeInfo {
63    pub sender: Acc,
64    pub coinbase: Acc,
65    pub gas_used: u64,
66}
67
68#[derive(Clone, Debug, Default, Serialize, Deserialize)]
69#[serde(rename_all = "camelCase")]
70pub struct Alerts {
71    pub proxy_swaps: Vec<ProxySwap>,
72    pub eth_changes: Vec<EthChange>,
73    pub erc20_transfers: Vec<Erc20Transfer>,
74    pub erc20_approvals: Vec<Erc20Approval>,
75    pub erc721_transfers: Vec<Erc721Transfer>,
76    pub forged_transfers: Vec<ForgedTransfer>,
77    pub fee: Option<FeeInfo>,
78}
79
80/*
81
82Use Case: Anomaly Detection and Transaction Verification
83
84Re-execute all previous transactions for the given address, collect results (state, value).
85Re-execute target transaction, collect results (state, value) and compare to previous results.
86If significant deviation is detected, flag and report it.
87
88[This could have prevented "ByBit hack" of Feb'25 $1.5B worth of ETH being stolen].
89https://www.chainalysis.com/blog/bybit-exchange-hack-february-2025-crypto-security-dprk/
90https://www.cremit.io/blog/bybit-hacking-incident-analysis-how-to-strengthen-cryptocurrency-exchange-security
91
92*/