poorSKeme

OSINT - Визуализация данных - Блокчейн - Информирование - Мошенничество

Установка

Перейдите на этот сайт и нажмите кнопку загрузки. Или перейдите в раздел релизов. Скачайте ZIP-файл с именем poorSKeme.zip

Распакуйте его, установите зависимости и запустите.

unzip poorSKeme.zip
cd poorSKeme
pip install -r requirements.txt
python3 poorSKeme --help

$$$$$$$\                                       $$$$$$\  $$\   $$\
$$  __$$\                                     $$  __$$\ $$ | $$  |
$$ |  $$ | $$$$$$\   $$$$$$\   $$$$$$\        $$ /  \__|$$ |$$  / $$$$$$\  $$$$$$\$$$$\   $$$$$$\
$$$$$$$  |$$  __$$\ $$  __$$\ $$  __$$\       \$$$$$$\  $$$$$  / $$  __$$\ $$  _$$  _$$\ $$  __$$\
$$  ____/ $$ /  $$ |$$ /  $$ |$$ |  \__|       \____$$\ $$  $$<  $$$$$$$$ |$$ / $$ / $$ |$$$$$$$$ |
$$ |      $$ |  $$ |$$ |  $$ |$$ |            $$\   $$ |$$ |\$$\ $$   ____|$$ | $$ | $$ |$$   ____|
$$ |      \$$$$$$  |\$$$$$$  |$$ |            \$$$$$$  |$$ | \$$\\$$$$$$$\ $$ | $$ | $$ |\$$$$$$$\
\__|       \______/  \______/ \__|             \______/ \__|  \__|\_______|\__| \__| \__| \_______|

usage: poorSKeme.py [-h] [-bc {bsc,eth}] [-ct CONTRACT] [-bf BLOCK_FROM] [-bt BLOCK_TO] [-c CHUNK] [-f FILE] [-w]

Contract analyzer

optional arguments:
  -h, --help            show this help message and exit

Get and process data:
  -bc {bsc,eth}, --blockchain {bsc,eth}
                        Select Blockchain (bsc, eth)
  -ct CONTRACT, --contract CONTRACT
                        address of contract
  -bf BLOCK_FROM, --block-from BLOCK_FROM
                        Block start
  -bt BLOCK_TO, --block-to BLOCK_TO
                        Block end
  -c CHUNK, --chunk CHUNK
                        Chunks of blocks

Process data from JSON file:
  -f FILE, --file FILE  JSON file of recolected data

Start WebServer visualization data:
  -w, --web             WEB for data visaulization

            Examples
            --------

            # Extract TRXs of contract from block to block (Ethereum Network)
            python3 poorSKeme.py -bc eth -ct 0xb547027A4CCD46EC98199Fa88AAEDF5aA981Db26 -bt 6496413        # To collect

            # Extract TRXs of contract from block to block (Binance Smart Chain)
            python3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bt 15552901       # To collect

            # Data Visualization of processed contract information (Binance Smart Chain)
            python3 poorSKeme.py -bc bsc -f contract-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.db -w  # To visualice data

При использовании параметра web порт будет 4200. Полный URL: http://127.0.0.1:4200.

API

Получите бесплатный API с https://etherscan.io/apis (Ethereum) и с https://bscscan.com/apis (Binance Smart Chain) Загрузите их в файл API.yaml, заменив XXX на соответствующий APIKey.

Пример

Получение данных

Для сбора данных о контракте 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 (Ethereum — блокчейн по умолчанию)

python3 poorSKeme.py -ct 0xb547027A4CCD46EC98199Fa88AAEDF5aA981Db26

Но это может занять много времени, поэтому можно указать параметры начального и конечного блоков.

python3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bf 14040726 -bt 15552901

Или только конечный блок.

python3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bt 15552901

Обратите внимание на параметр -bc, который указывает сеть блокчейна (в данном случае Binance Smart Chain).

В результате будет создан файл с именем contract-bsc-[КОНТРАКТ].json; для нашего примера он будет называться contract-bsc-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.json

Обработка данных и визуализация

После получения файла данных можно обработать информацию и визуализировать её, выполнив

python3 poorSKeme.py -f ./contract-bsc-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.db -w

Приведённая выше команда запустит два сервиса: внутренний API на порту 5000 и визуализацию веб-интерфейса на порту 4200. Просто откройте браузер и введите адрес http://127.0.0.1:4200.

Resume Detail Code Diagram

Отказ от ответственности

Этот проект молодой, начат в середине марта 2022 года, поэтому может содержать ошибки. Со временем и с учётом обратной связи проект будет расти, а ошибки будут исправляться, но это личный проект, и время, уделяемое ему, не определено.

Отказ от ответственности

Я разместил отказ от ответственности трижды, возможно, вы прочтёте его хотя бы один раз.

Простая дорожная карта

Поддержка Binance Blockchain
Поддержка Ethereum Blockchain
Сбор данных
Визуализация
Раннее обнаружение мошенничества
Автоматическое обнаружение аномалий

...

[?] Отслеживаемость
Идентификация кошельков

Последние два пункта дорожной карты требуют серьёзных исследований, но нет ничего невозможного.

poorskeme

Популярное