git404hub

what is mantlefi fr?

rien-open/mantlefi — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 3/5Setup · easy

tl;dr

MantleFi checks Mantle DeFi yields by reading blockchain data directly, showing whether a return is real or inflated by token rewards.

vibe map

mindmap
  root((MantleFi))
    What it does
      Verifies DeFi yields
      Reads Mantle chain
      Flags fake numbers
    Tech stack
      Python stdlib
      Groq API
      NVIDIA NIM
    Use cases
      Check yield sources
      Verify token identity
      Daily pool monitor
    Audience
      DeFi researchers
      On chain analysts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Check whether a DeFi pool's advertised yield is real or propped up by token rewards

VIBE 2

Find the true on-chain contract address for a token before trusting a dashboard listing

VIBE 3

Ask a chat agent plain language questions about Mantle yields and see its sourced reasoning

VIBE 4

Run a daily scan that classifies every yield pool on Mantle into risk categories

what's the stack?

PythonGroq APINVIDIA NIM

how it stacks up fr

rien-open/mantlefi0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Core scan and judge commands need no key, the chat agent needs a free Groq or NVIDIA NIM API key.

in plain english

MantleFi is a research tool built to check whether the yields shown on Mantle DeFi dashboards are real or misleading. Instead of trusting the percentages that DeFi sites display, it reads data directly from the Mantle blockchain to verify where a yield actually comes from. It separates the interest or fees that make up a real return from the token rewards that inflate the number and can disappear at any time. The project works in two ways. There is a command line engine, written in plain Python with no extra installs needed, that scans every yield pool on Mantle and sorts them into categories such as real yield, reward dependent, price illusion, or wash trading. There is also a chat agent that answers plain language questions like "what is the real yield on Mantle right now" by deciding which checks to run and showing each step. The chat agent uses a free language model from Groq or NVIDIA NIM, but the numbers it reports always come from the on-chain engine rather than the model itself. Any number in a response that cannot be traced back to a source is flagged, and the raw data behind the answer is always shown alongside the summary. The tool also includes a token finder that searches for a given ticker symbol across multiple sources, keeps only matches on the Mantle chain, and prints the contract address so a user can confirm it is the real token rather than an imitation with a similar name. MantleFi does not give buy or sell advice. It only shows what the on-chain data says, leaving the decision to the user. It is free to run, reads only public data, and works only with the Mantle network. A hosted demo is available online, and the project can also be run locally with a short setup process described in its documentation. It was built as an entry for a Mantle research challenge.

prompts (copy fr)

prompt 1
Run python3 research.py scan and explain what each yield classification means
prompt 2
Use python3 research.py judge ondo-yield-assets USDY and summarize the verdict
prompt 3
Help me set up a .env file with a free Groq API key so I can use MantleFi's chat agent
prompt 4
Ask MantleFi's agent whether a specific Mantle pool's yield is reward dependent or real

Frequently asked questions

what is mantlefi fr?

MantleFi checks Mantle DeFi yields by reading blockchain data directly, showing whether a return is real or inflated by token rewards.

What language is mantlefi written in?

Mainly Python. The stack also includes Python, Groq API, NVIDIA NIM.

How hard is mantlefi to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mantlefi for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.