io.github.Abstract36/stakechain

The single highest-APY pool on Base for one asset, with junk-farm filters applied (minimum TVL, APY ceiling, no impermanent-loss exposure). Use this for a direct 'where is the best rate for X' question when one answer is wanted rather than a list. Use something else when: you want to compare several options (`list_base_yields`); you intend to deposit (`list_lending_vaults` returns the address). Important: it ranks by rate alone. A high answer here is a starting point, not a verdict — follow it with `market_profile` for the curator's cut and whether the money can be withdrawn, and `yield_history` for whether the rate has held.

Turns a chosen market into signed-ready calldata: an ordered list of transactions to deposit into it or leave it, across Morpho vaults, Aave reserves, Moonwell markets and this project's staking pools — three different protocol interfaces behind one call. The approve step is included only when the current allowance does not already cover the amount, read on-chain at request time. Use this once a market has been chosen and the decision is made. Use something else when: still choosing (`list_lending_vaults`, `best_yield`); weighing whether to go ahead (`market_profile`, `yield_history`). Nothing is signed or sent — the caller holds the keys. Simulate before sending. `amount: "all"` on a withdrawal exits by share rather than by figure, so interest accruing between the call and the block is not left behind.

Survey staking and lending opportunities on Base: APY, TVL, project and asset for each. Use this for breadth — browsing the market, answering 'what is available', or filtering a wide set. It covers pools this server cannot deposit into as well as ones it can. Use something else when: you want one asset's single best option (`best_yield`); you intend to deposit and need a contract address (`list_lending_vaults`); you are judging one market rather than comparing many (`market_profile`). Every row says where its number came from: `source` is `onchain` (read from the protocol's contracts at `block`, so the figure can be re-derived), `morpho-api`, or `defillama` — a third-party snapshot that carries no Moonwell USDC market at all and understates Aave's Base reserve. Ranks by TVL unless sortByApy is set. Four-digit emission farms are filtered out by default. Returns market data, not a recommendation; any row's `pool` id can be passed to `yield_history`.

The Base lending shelf an agent can act on: Morpho ERC-4626 vaults, Aave V3 reserves, Moonwell markets and this project's own staking pools, each with the contract address to deposit into (`depositTo`), the asset's address and decimals, and a `risk` block (fee, age, concentration, utilisation, incentive share). Use this whenever a deposit might follow, or when you need a market id to pass to `market_profile` or `yield_history`. Use `list_base_yields` instead when surveying the wider market, including pools that cannot be deposited into here. Rates for Aave and Moonwell are read from their own contracts, so markets missing from aggregator snapshots appear here. Each row carries `source` and `block`: an `onchain` row can be re-read at that block and checked, a `morpho-api` row comes from Morpho's own GraphQL.

Risk profile for one market, for the moment before capital is committed. Use this when a specific market has been chosen and the question is whether to go ahead. It is the one tool that answers 'what else should I know besides the rate'. Use something else when: you are still choosing between markets (`list_base_yields`, `best_yield`); you only want to know whether the rate moved (`yield_history`); you need the deposit address (`list_lending_vaults`). Prerequisite: the market must be on this server's shelf — a vault, reserve or pool from `list_lending_vaults`. Arbitrary pool ids from `list_base_yields` will not resolve. Returns `score` (0-100) and `band` ('solid', 'fair', 'thin' or 'fragile'), plus a `signals` object holding the six inputs behind it: size (TVL), track_record (days running), stability (APY volatility from daily snapshots), yield_quality (share of the APY that is borrower interest rather than incentives that can stop), cost (the curator's percentage cut) and diversification (share sitting in the largest position). Each signal carries its raw value and its sub-score, and `method.weights` gives the weighting, so the score can be recomputed. A signal lacking data reports score null and is excluded from the weighting rather than guessed at. Pair with `yield_history` for an unusually high rate. Describes what has happened, not what will.

Daily APY and TVL history for one market, with min, median, max and volatility over the window. Use this for one question only: has this rate held, or did it appear yesterday? Call it before acting on any unusually high rate. Use something else when: you want the other risk factors — fee, size, utilisation, concentration — which are in `market_profile`; you are still choosing a market (`list_base_yields` or `best_yield`). Prerequisite: a market id from one of the list tools. Check `observations` before concluding anything — a market added recently has few snapshots, and a short series is not evidence of stability.