Skip to content

Ma0xFly/memescan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ” MemeScan โ€” The Rug-Pull Radar

ๅŸบไบŽๅคšๆ™บ่ƒฝไฝ“๏ผˆMulti-Agent๏ผ‰ๅไฝœไธŽ Anvil ๅˆ†ๅ‰ไปฟ็œŸ็š„ๅฎžๆ—ถ Memecoin ๅฎ‰ๅ…จๅˆ†ๆž็ณป็ปŸใ€‚


๐Ÿ“– ้กน็›ฎๆฆ‚่ฟฐ

MemeScan ๆ˜ฏไธ€ๆฌพ้ขๅ‘ Web3 ๅฎ‰ๅ…จ้ข†ๅŸŸ็š„ๆ™บ่ƒฝๅˆ็บฆๅฎก่ฎกๅทฅๅ…ทใ€‚
ๅฎƒ่ƒฝๅคŸๅฎžๆ—ถ็›‘ๅฌ้“พไธŠๆ–ฐๅ‘่กŒ็š„ Meme ไปฃๅธ๏ผŒ้€š่ฟ‡ๅœจๆœฌๅœฐ Anvil ๆฒ™็›’ไธญ่ฟ›่กŒไนฐๅ–ไปฟ็œŸไบคๆ˜“ๆฅๆฃ€ๆต‹่œœ็ฝ๏ผˆHoneypot๏ผ‰ๅ’Œ้ซ˜็จŽ็އไปฃๅธ๏ผŒๅนถ่ฐƒ็”จๅคง่ฏญ่จ€ๆจกๅž‹๏ผˆLLM๏ผ‰ๅฏนๅผ€ๆบๅˆ็บฆไปฃ็ ่ฟ›่กŒๆทฑๅบฆๅฎก่ฎก๏ผŒๆœ€็ปˆ็”Ÿๆˆ็ป“ๆž„ๅŒ–็š„ๅฎ‰ๅ…จ่ฏ„ไผฐๆŠฅๅ‘Šใ€‚

๐Ÿง  ๆ ธๅฟƒ็†ๅฟต

"ไธๅชๆ˜ฏๅ‘Š่ฏ‰ไฝ ไปฃ็ ๆœ‰ๆผๆดž๏ผŒๆ›ดๅœจๆฒ™็›’ไธญ็›ดๆŽฅๅฎžๆ“็ป™ไฝ ็œ‹ใ€‚"

MemeScan ็‹ฌๅˆ›็š„ Rug-Pull ๆ”ป้˜ฒๆŽจๆผ”็ณป็ปŸ๏ผŒ่ƒฝๅคŸๅœจๆœฌๅœฐๅˆ†ๅ‰็ฝ‘็ปœไธญๆจกๆ‹Ÿ"ๆถๆ„้กน็›ฎๆ–น"่ง’่‰ฒ๏ผŒๅฐ่ฏ•ๆ‰ง่กŒๆ‹‰้ป‘ใ€ๆ”น็จŽ็އใ€ๆš‚ๅœไบคๆ˜“็ญ‰ๆถๆ„ๆ“ไฝœ๏ผŒ็”จ็‰ฉ็†็บง่ฏๆฎๅˆคๅฎšไธ€ไธชไปฃๅธๆ˜ฏๅฆไธบ่ต„้‡‘็›˜ใ€‚

๐ŸŽฏ ่งฃๅ†ณ็š„้—ฎ้ข˜

้—ฎ้ข˜ MemeScan ๆ–นๆกˆ
ๆ–ฐๅ‘ไปฃๅธๆ— ๅฎก่ฎกๆŠฅๅ‘Š ๅฎžๆ—ถ็›‘ๆŽง + ่‡ชๅŠจๅฎก่ฎกๆตๆฐด็บฟ
่œœ็ฝ้ช—ๅฑ€้šพไปฅ่ฏ†ๅˆซ Anvil ๆฒ™็›’ไนฐๅ–ไปฟ็œŸ๏ผŒ็œŸๅฎžๆจกๆ‹Ÿไบคๆ˜“
้™ๆ€ๅฎก่ฎกๆ— ๆณ•ๅ‘็Žฐ้š่—ๅŽ้—จ ๆ”ป้˜ฒๆŽจๆผ”๏ผšๆๆƒ Owner ๅนถ้‡ๆ”พๆถๆ„่ฐƒ็”จ
ๅˆ็บฆไปฃ็ ้˜…่ฏป้—จๆง›้ซ˜ LLM ๅคงๆจกๅž‹่‡ชๅŠจๅˆ†ๆžๆบ็ ๏ผŒ่พ“ๅ‡บไบบ็ฑปๅฏ่ฏปๆŠฅๅ‘Š
ๅ•้“พๅฑ€้™ ๅŒๆ—ถๆ”ฏๆŒ Ethereum ๅ’Œ BSC ๅŒ้“พ

๐ŸŒŸ ไธป่ฆๅŠŸ่ƒฝ

1. ๐Ÿค– ๅคšๆ™บ่ƒฝไฝ“ๅไฝœๆžถๆž„

็ณป็ปŸ็”ฑ 5 ไธช Agent ๅไฝœๅฎŒๆˆๅฎก่ฎกไปปๅŠก๏ผŒๅ„ๅธๅ…ถ่Œ๏ผš

Agent ่Œ่ดฃ
CoordinatorAgent ็ผ–ๆŽ’่ฐƒๅบฆ๏ผŒ็ฎก็†ๅฎก่ฎกๆตๆฐด็บฟ๏ผŒๅ†ณ็ญ–ๆ˜ฏๅฆ่งฆๅ‘ๆทฑๅบฆๅˆ†ๆž
ScannerAgent ๅฎžๆ—ถ็›‘ๅฌ DEX ๆ–ฐไบคๆ˜“ๅฏน๏ผˆPairCreated ไบ‹ไปถ๏ผ‰
SandboxAgent ๅœจ Anvil ๅˆ†ๅ‰็ฝ‘็ปœไธญๆ‰ง่กŒไนฐๅ–ไปฟ็œŸๅ’Œๆ”ป้˜ฒๆŽจๆผ”
AuditorAgent ๅŸบไบŽ่ง„ๅˆ™ๅผ•ๆ“Ž + LLM ่ฟ›่กŒไปฃ็ ๅฎ‰ๅ…จ่ฏ„ไผฐ
ReporterAgent ็”Ÿๆˆ Markdown ๅฎก่ฎกๆŠฅๅ‘Š๏ผŒๆ”ฏๆŒ AI ้—ฎ็ญ”

2. ๐ŸŒ ๅŒ้“พๆ”ฏๆŒ

  • Ethereum ไธป็ฝ‘ โ€” Uniswap V2 ๆ–ฐไบคๆ˜“ๅฏน็›‘ๆŽง
  • BSC๏ผˆๅธๅฎ‰ๆ™บ่ƒฝ้“พ๏ผ‰ โ€” PancakeSwap V2 ๆ–ฐไบคๆ˜“ๅฏน็›‘ๆŽง

3. ๐Ÿงช Anvil ๆฒ™็›’ไปฟ็œŸ

  • ไฝฟ็”จ Foundry ็š„ Anvil ๅœจๆœฌๅœฐๆž้€Ÿๅˆ†ๅ‰ไธป็ฝ‘
  • ๆจกๆ‹Ÿ็œŸๅฎž็š„ไนฐๅ…ฅ/ๅ–ๅ‡บไบคๆ˜“๏ผŒ็ฒพ็กฎ่ฎก็ฎ—ไนฐๅ–็จŽ็އๅ’Œ Gas ๆถˆ่€—
  • ๅŠจๆ€็ซฏๅฃๅˆ†้…๏ผŒ้ฟๅ…ๅนถๅ‘ไปฟ็œŸๅ†ฒ็ช

4. โš”๏ธ Rug-Pull ๆ”ป้˜ฒๆŽจๆผ”

  • ๆƒ้™ๅŠซๆŒ๏ผš้€š่ฟ‡ anvil_impersonateAccount ๆŽฅ็ฎกๅˆ็บฆ Owner
  • ่‡ชๅŠจๅŒ–ๆ”ปๅ‡ป๏ผšๅฐ่ฏ• setBlacklistใ€setTaxFeePercent(99)ใ€pauseTrading ็ญ‰ๆถๆ„่ฐƒ็”จ
  • ็Šถๆ€้ชŒ่ฏ๏ผšๆ”ปๅ‡ปๅŽๅ†ๆฌกไปฟ็œŸไนฐๅ–๏ผŒ็กฎ่ฎค็”จๆˆทๆ˜ฏๅฆๆ— ๆณ•ๅ‡บๅ”ฎ
  • ๅฎž้”คๅˆคๅฎš๏ผš่‡ชๅŠจๆ ‡่ฎฐ่œœ็ฝๅนถ้™„ๅธฆๆ”ปๅ‡ป่ฏๆฎ

5. ๐Ÿง  LLM ๆ™บ่ƒฝๅฎก่ฎก

  • ้€š่ฟ‡ Etherscan/BscScan V2 API ่Žทๅ–ๅˆ็บฆๅผ€ๆบไปฃ็ 
  • ่ฐƒ็”จ GLM ๅคง่ฏญ่จ€ๆจกๅž‹่ฟ›่กŒๆทฑๅบฆไปฃ็ ๅˆ†ๆž
  • ่‡ชๅŠจ่ฏ†ๅˆซ้š่—ๅขžๅ‘ใ€้ป‘ๅๅ•ใ€ๆƒ้™ๅŽ้—จ็ญ‰้ซ˜ๅฑๆผๆดž

6. ๐Ÿ’ฌ Chat with Contract

  • ๅฏนๆœ€ๆ–ฐๅฎก่ฎกๆŠฅๅ‘Šๆ้—ฎ๏ผŒLLM ๅŸบไบŽๆบ็ ๆ•ฐๆฎๅฎžๆ—ถๅ›ž็ญ”
  • ็คบไพ‹๏ผš"่ฟ™ไธชไปฃๅธไธบไป€ไนˆๆœ‰ HONEYPOT ๆ ‡็ญพ๏ผŸ"

7. ๐Ÿ“ก ๅฎžๆ—ถๅ‰็ซฏไปช่กจ็›˜

  • Streamlit ๆž„ๅปบ็š„ Web UI๏ผŒๆ”ฏๆŒๆ— ๆ„Ÿ่‡ชๅŠจๅˆทๆ–ฐ
  • ๅฎžๆ—ถๆ—ฅๅฟ—ๆต๏ผšๅŽๅฐๆ‰ซๆ่ฟ›ๅบฆๅŒๆญฅๆ˜พ็คบๅœจๅ‰็ซฏ
  • ๅŒ Tab ๆŠฅๅ‘Šๅฑ•็คบ๏ผšๅฎžๆ—ถๆŠฅๅ‘Š + ๅކๅฒๆŠฅๅ‘Šๅฝ’ๆกฃ

๐Ÿ—๏ธ ๆŠ€ๆœฏๆ ˆ

็ฑปๅˆซ ๆŠ€ๆœฏ
็ผ–็จ‹่ฏญ่จ€ Python 3.10+
Web3 ไบคไบ’ web3.py (AsyncWeb3, AsyncHTTPProvider)
ๅˆ†ๅ‰ไปฟ็œŸ Foundry (Anvil + Cast)
ๅ‰็ซฏ Streamlit + st_autorefresh
ๆ•ฐๆฎๆจกๅž‹ Pydantic V2 + pydantic-settings
ๆ•ฐๆฎๅบ“ SQLAlchemy 2.0 + aiosqlite (SQLite)
HTTP ๅฎขๆˆท็ซฏ httpx (Etherscan API), aiohttp (Web3)
LLM ้›†ๆˆ OpenAI SDK (ๅ…ผๅฎน GLM / DeepSeek / GPT)
ๆ—ฅๅฟ—็ณป็ปŸ Loguru
ๅผ‚ๆญฅๆก†ๆžถ asyncio + threading (ๅŽๅฐๅพช็Žฏ)
ๅŒบๅ—้“พๆต่งˆๅ™จ Etherscan V2 API / BscScan V2 API

๐Ÿ› ๏ธ ๅฎ‰่ฃ…ไธŽ่ฟ่กŒ

1. ็Žฏๅขƒ่ฆๆฑ‚

  • Python 3.10+
  • Foundry๏ผˆๅŒ…ๅซ Anvil ๅ’Œ Cast๏ผ‰๏ผšๅฎ‰่ฃ… Foundry
    curl -L https://foundry.paradigm.xyz | bash
    foundryup
  • RPC ่Š‚็‚น๏ผšAlchemy / Infura / QuickNode ็ญ‰๏ผˆๅ…่ดน็‰ˆๅณๅฏ๏ผ‰
  • LLM API Key๏ผšไธƒ็‰›ไบ‘ / ๆ™บ่ฐฑ GLM / OpenAI ็ญ‰ๅ…ผๅฎน OpenAI ๆ ผๅผ็š„ API

2. ๅ…‹้š†ไธŽๅฎ‰่ฃ…ไพ่ต–

git clone https://github.com/Ma0xFly/memescan.git
cd MemeScan
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. ้…็ฝฎ็Žฏๅขƒๅ˜้‡

ๅคๅˆถ้…็ฝฎๆจกๆฟๅนถ็ผ–่พ‘๏ผš

cp .env.example .env

ๆ‰“ๅผ€ .env ๆ–‡ไปถ๏ผŒๅกซๅ…ฅไปฅไธ‹ๅฟ…ๅกซ้…็ฝฎ๏ผš

# โ”€โ”€ RPC ่Š‚็‚น (ๅฟ…ๅกซ) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_KEY
BSC_RPC_URL=https://bsc-dataseed.binance.org/

# โ”€โ”€ ๅŒบๅ—้“พๆต่งˆๅ™จ API Key (ๆŽจ่ๅกซๅ†™๏ผŒ็”จไบŽ่Žทๅ–ๅˆ็บฆๆบ็ ) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
ETHERSCAN_API_KEY=ไฝ ็š„_Etherscan_API_Key
BSCSCAN_API_KEY=ไฝ ็š„_BscScan_API_Key

# โ”€โ”€ LLM ๅคงๆจกๅž‹ (ๅฟ…ๅกซ๏ผŒ็”จไบŽๆ™บ่ƒฝๅฎก่ฎกๅ’Œ Chat) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
LLM_API_KEY=ไฝ ็š„_LLM_API_Key
LLM_BASE_URL=https://api.qnaigc.com/v1          # ไธƒ็‰›ไบ‘็ซฏ็‚น
LLM_MODEL=glm-4.5-air                           # ๆจกๅž‹ๅ็งฐ

ๅ…่ดน API Key ่Žทๅ–ๆ–นๅผ๏ผš

  • Alchemy RPC๏ผšalchemy.com ๆณจๅ†Œๅณ่Žทๅ…่ดน Key
  • Etherscan API๏ผšetherscan.io/myapikey ๆณจๅ†Œๅณ่Žทๅ…่ดน Key
  • BscScan API๏ผšbscscan.com/myapikey ๆณจๅ†Œๅณ่Žทๅ…่ดน Key

4. ๅฏๅŠจๅบ”็”จ

streamlit run app.py

ๅฏๅŠจๅŽ๏ผŒๆ‰“ๅผ€ๆต่งˆๅ™จ่ฎฟ้—ฎ http://localhost:8501 ๅณๅฏไฝฟ็”จใ€‚


๐Ÿš€ ไฝฟ็”จๆŒ‡ๅ—

ๅฎžๆ—ถ็›‘ๆŽงๆจกๅผ

  1. ๅœจๅทฆไพง่พนๆ  "๐Ÿ”Ž ๅฎžๆ—ถ็›‘ๆŽง" ไธ‹ๆ‹‰้€‰ๆ‹ฉ็›ฎๆ ‡้“พ๏ผˆEthereum / BSC๏ผ‰
  2. ็‚นๅ‡ป โ–ถ๏ธ ๅฏๅŠจ็›‘ๆŽง
  3. ็ณป็ปŸไผš่‡ชๅŠจ็›‘ๅฌ้“พไธŠๆ–ฐไบคๆ˜“ๅฏน๏ผŒๅ‘็Žฐๆ–ฐไปฃๅธๅŽ่‡ชๅŠจๆ‰ง่กŒๅฎŒๆ•ดๅฎก่ฎกๆต็จ‹
  4. ็ป“ๆžœไผšๅฎžๆ—ถๆ˜พ็คบๅœจๅณไพง ๐Ÿ“ก ๅฎžๆ—ถๆŠฅๅ‘Š ๆ ‡็ญพ้กตไธญ

ๆ‰‹ๅŠจๆ‰ซๆๆจกๅผ

  1. ๅœจๅทฆไพง่พนๆ  "๐ŸŽฏ ๆ‰‹ๅŠจๆ‰ซๆ" ๅŒบๅŸŸ้€‰ๆ‹ฉ็›ฎๆ ‡้“พ
  2. ๅœจ่พ“ๅ…ฅๆก†ไธญ็ฒ˜่ดดไปฃๅธๅˆ็บฆๅœฐๅ€
  3. ็‚นๅ‡ป ๐Ÿ”ฌ ๆ‰ซๆไปฃๅธ
  4. ็Šถๆ€ๆก†ไธญไผšๅฎžๆ—ถๆปšๅŠจๆ˜พ็คบๆ‰ซๆ่ฟ›ๅบฆ

๏ฟฝ ๆต‹่ฏ•็”จไปฃๅธๅœฐๅ€

ไปฅไธ‹ไปฃๅธๅ‡ๅทฒๅœจ้“พไธŠๅผ€ๆบ้ชŒ่ฏ๏ผŒ้€‚ๅˆ็”จๆฅๆต‹่ฏ•็ณป็ปŸๅŠŸ่ƒฝ๏ผš

Ethereum ไธป็ฝ‘๏ผš

ไปฃๅธ ๅˆ็บฆๅœฐๅ€ ็‰น็‚น
SHIB 0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce ๆ ‡ๅ‡† ERC20๏ผŒ็ปๅ…ธ Meme ๅธ
PEPE 0x6982508145454Ce325dDbE47a25d4ec3d2311933 ๅทฒๆ”พๅผƒๆ‰€ๆœ‰ๆƒ (Renounced)
FLOKI 0xcf0C122c6b73ff809C693CE761CAA2fd6A5A0D51 ๅซๆœ‰ๅˆ†็บขๅ’Œ็จŽ็އๆœบๅˆถ
WBTC 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599 ๅฏ่ƒฝ่งฆๅ‘้š่—ๅขžๅ‘ๆ ‡็ญพ

BSC ้“พ๏ผš

ไปฃๅธ ๅˆ็บฆๅœฐๅ€ ็‰น็‚น
BabyDoge 0xc748673057861a797275CD8A068AbB95A902e8de ้€š็ผฉๆœบๅˆถ + ่‡ชๅŠจๅˆ†็บข
DOGE (Peg) 0xbA2aE424d960c26247Dd6c32edC70B295c744C43 Binance ้”šๅฎš็‰ˆ DOGE

๐Ÿ“ ้กน็›ฎ็ป“ๆž„

MemeScan/
โ”œโ”€โ”€ app.py                     # ๏ฟฝ๏ธ Streamlit ๅ‰็ซฏๅ…ฅๅฃ
โ”‚
โ”œโ”€โ”€ agents/                    # ๐Ÿค– Multi-Agent ๅฑ‚
โ”‚   โ”œโ”€โ”€ base.py               # Agent ๅŸบ็ฑป (run / decide / log)
โ”‚   โ”œโ”€โ”€ coordinator.py        # ็ผ–ๆŽ’่ฐƒๅบฆ Agent
โ”‚   โ”œโ”€โ”€ scanner.py            # ้“พไธŠ็›‘ๅฌ Agent
โ”‚   โ”œโ”€โ”€ sandbox.py            # Anvil ไปฟ็œŸ + ๆ”ป้˜ฒๆŽจๆผ” Agent
โ”‚   โ”œโ”€โ”€ auditor.py            # ่ง„ๅˆ™ๅผ•ๆ“Ž + LLM ๅฎก่ฎก Agent
โ”‚   โ””โ”€โ”€ reporter.py           # ๆŠฅๅ‘Š็”Ÿๆˆ + Chat Agent
โ”‚
โ”œโ”€โ”€ services/                  # ๐Ÿ”ง ๅบ•ๅฑ‚ๆœๅŠกๅฑ‚
โ”‚   โ”œโ”€โ”€ monitor.py            # Web3 PairCreated ไบ‹ไปถ่ฝฎ่ฏข
โ”‚   โ”œโ”€โ”€ simulator.py          # Anvil/Cast ไปฟ็œŸๅผ•ๆ“Ž
โ”‚   โ”œโ”€โ”€ analyzer.py           # ่ง„ๅˆ™ๅผ•ๆ“Žๅˆ†ๆžๅ™จ
โ”‚   โ”œโ”€โ”€ etherscan.py          # Etherscan/BscScan V2 API ๅฎขๆˆท็ซฏ
โ”‚   โ””โ”€โ”€ token_info.py         # ไปฃๅธๅ…ƒๆ•ฐๆฎๆŸฅ่ฏข
โ”‚
โ”œโ”€โ”€ core/                      # โš™๏ธ ๅŸบ็ก€่ฎพๆ–ฝๅฑ‚
โ”‚   โ”œโ”€โ”€ config.py             # pydantic-settings ้…็ฝฎๅ•ไพ‹
โ”‚   โ”œโ”€โ”€ web3_provider.py      # AsyncWeb3 Provider ๅทฅๅŽ‚
โ”‚   โ”œโ”€โ”€ logging.py            # Loguru ๆ—ฅๅฟ—้…็ฝฎ
โ”‚   โ””โ”€โ”€ db.py                 # SQLAlchemy ๅผ‚ๆญฅๆ•ฐๆฎๅบ“ๅผ•ๆ“Ž
โ”‚
โ”œโ”€โ”€ domain/                    # ๐Ÿ“ฆ ้ข†ๅŸŸๆจกๅž‹ๅฑ‚
โ”‚   โ””โ”€โ”€ models.py             # Token, SimulationResult, AuditReport
โ”‚
โ”œโ”€โ”€ reports/                   # ๐Ÿ“„ ๅฎก่ฎกๆŠฅๅ‘Šๅญ˜ๅ‚จ (Markdown)
โ”œโ”€โ”€ .env.example               # ็Žฏๅขƒๅ˜้‡้…็ฝฎๆจกๆฟ
โ”œโ”€โ”€ requirements.txt           # Python ไพ่ต–ๅˆ—่กจ
โ””โ”€โ”€ README.md                  # ๆœฌๆ–‡ๆกฃ

๐Ÿ”ฎ ็ณป็ปŸๆžถๆž„

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                    Streamlit Frontend                     โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
โ”‚  โ”‚ ็Šถๆ€้ขๆฟ  โ”‚  โ”‚ ๅฎžๆ—ถๆŠฅๅ‘Š  โ”‚  โ”‚ ๅކๅฒๆŠฅๅ‘Š   โ”‚  โ”‚ AI Chatโ”‚  โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                       โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              CoordinatorAgent (็ผ–ๆŽ’่ฐƒๅบฆ)                   โ”‚
โ”‚         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                      โ”‚
โ”‚         โ–ผ            โ–ผ            โ–ผ                      โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                โ”‚
โ”‚  โ”‚ Sandbox โ”‚  โ”‚ Auditor  โ”‚  โ”‚ Reporter โ”‚                โ”‚
โ”‚  โ”‚  Agent  โ”‚  โ”‚  Agent   โ”‚  โ”‚  Agent   โ”‚                โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                โ”‚
โ”‚       โ”‚            โ”‚                                     โ”‚
โ”‚       โ–ผ            โ–ผ                                     โ”‚
โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                 โ”‚
โ”‚ โ”‚Simulator โ”‚ โ”‚ Analyzer  โ”‚ โ”‚Etherscan โ”‚                  โ”‚
โ”‚ โ”‚ Service  โ”‚ โ”‚  Service  โ”‚ โ”‚ Service  โ”‚                  โ”‚
โ”‚ โ”‚(Anvil)   โ”‚ โ”‚(Rules)    โ”‚ โ”‚(V2 API)  โ”‚                  โ”‚
โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ” ๅฎ‰ๅ…จไธŽ้š็ง

  • ๅ‰็ซฏๆ—ฅๅฟ—่‡ชๅŠจ่„ฑๆ•๏ผŒไธไผšๆณ„้œฒ RPC Key ๅ’Œๆœฌๅœฐ่ทฏๅพ„
  • ๆ‰€ๆœ‰ไปฟ็œŸไบคๆ˜“ๅ‡ๅœจๆœฌๅœฐ Anvil ๅˆ†ๅ‰็ฝ‘็ปœไธญๆ‰ง่กŒ๏ผŒไธไผšๅ‘้€ไปปไฝ•็œŸๅฎž้“พไธŠไบคๆ˜“
  • ๆ•ๆ„Ÿ้…็ฝฎ้€š่ฟ‡ .env ๆ–‡ไปถ็ฎก็†๏ผŒๅทฒๅŠ ๅ…ฅ .gitignore

๐Ÿ“Š ้ƒจ็ฝฒ่ฏดๆ˜Ž

ๆœฌๅœฐๅผ€ๅ‘้ƒจ็ฝฒ

# 1. ๅฎ‰่ฃ…ไพ่ต–
pip install -r requirements.txt

# 2. ๅฎ‰่ฃ… Foundry
curl -L https://foundry.paradigm.xyz | bash && foundryup

# 3. ้…็ฝฎ .env
cp .env.example .env   # ็ผ–่พ‘ๅกซๅ…ฅไฝ ็š„ API Key

# 4. ๅฏๅŠจ
python3 -m streamlit run app.py

็”Ÿไบง้ƒจ็ฝฒๅปบ่ฎฎ

  • ไฝฟ็”จ systemd ๆˆ– Docker ไฟๆŒๆœๅŠกๅธธ้ฉป
  • ้…็ฝฎ Nginx ๅๅ‘ไปฃ็† Streamlit ็š„ 8501 ็ซฏๅฃ
  • ๆŽจ่ไฝฟ็”จไป˜่ดน RPC ่Š‚็‚นไปฅ่Žทๅพ—ๆ›ด้ซ˜้ข‘็އ็š„่ฝฎ่ฏขๆ”ฏๆŒ
  • ๅฎšๆœŸๆธ…็† reports/ ็›ฎๅฝ•ไธญ็š„ๅކๅฒๆŠฅๅ‘Šๆ–‡ไปถ

๐Ÿ“œ ่ฎธๅฏ่ฏ

ๆœฌ้กน็›ฎ้‡‡็”จ MIT License ๅผ€ๆบ่ฎธๅฏ่ฏใ€‚

MIT License

Copyright (c) 2026 MemeScan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages