Skip to content

Track your farming and pool performance on the Binance Smart Chain - https://farm.army - nodejs backend

License

Notifications You must be signed in to change notification settings

thomasd3/farm-army-backend

 
 

Repository files navigation

farm.army - Backend

Track your farming and pool performance on the Binance Chain

Platforms

Platform Auto Fetch Done Notes
acryptos ✔️
alpaca ✔️ ✔️
alpha
apeswap ✔️
autofarm ✔️ ✔️
bakery farm config inconsistent for non so called "supportedPools"
bdollar staking missing
bearn staking missing
beefy ✔️ boost vaults missing
blizzard ✔️
goose pools
hyperjump ✔️
jetfuel staking missing
jul
slime ✔️
kebab pools
mdex
pancake ✔️
pancakebunny ✔️
saltswap ✔️
slime ✔️
space
valuedefi ✔️ staking missing
wault
  • Auto Fetch

    • ✔️ New vaults are directly added when new are added New vaults are directly added when new are added
    • ✅ Vaults can be internal generate eg via external Github repo
    • ❌ Vaults need to be extraced from the page; mainly dump a javascript variable via chrome
  • Done All supported "vault types" (pools, farms, staking, ...) are implemented

Tech Stack

  • node.js
  • sqlite

Business Values

  • blockchain data MUST be called aggregated eg with "multicall" or "rpc wrapper" there should not be any direct single contract reading calls
  • blockchain endpoints are slow, so runs should be in parallel with splitting http call to different URLs

Technical Debt

  • Price discovery of a single token; multiple implementations
  • Reduce platform duplicate codes
  • Normalize platform "configuration format" of farms
  • Reduce manually task to generate farm.json for some platforms; basically set the breakpoint in foreign platform javascript files (chrome) and dump the JSON configs (mostly all have the same pattern)
  • Make generation farm.json via submodules and typescript call redundant
  • Avoid global state; use dependency injection
  • Use a persistent cache to reduce warmup time
  • ...

Call Stack

Platforms

Platforms need to provide following implementations

  • getFarms All farm, vaults, pools should be cached for all calls; should no be cached for background calls this are the data "refreshers"
  • getAddressFarms(address) Get possible farms for an address, should be cached longer and should call needed contract values (also its normally the same as the following endpoint)
  • getYields(address) Get all address farms with balances, rewards, ... cache can be lower, request should to take too long, else user need to wait long for the overview page
  • getDetails(address, farm) Detail information for an address farm; request can to more stuff

Install

npm install
sqlite3 db.db < db.sql

Optional: to generate new farms / vault of some provide we need the public repo from them.

git submodule update --init --recursive

Optional: create a config file with custom configuration

config.json => config.json.local

Start

node src/index.js

Endpoints

  /farms
  /yield/:address?p=autofarm,pancake
  /wallet/:address
  /all/yield/:address

Generate Farm

node src/command/farm_fetcher.js <masterChefAddress>
node src/command/farm_fetcher.js 0x76FCeffFcf5325c6156cA89639b17464ea833ECd

Farm / Pool Contract

Every farm contract should be converted / provided in a common format. Still feature early definition

  {
    "id": "pancake_farm_foobar", // required and should be somehow unique and should not change (so no index) 
    "name": "Syrup-BNB", // required
    "token": "syrup-bnb", // optional (fallback on "name" if not given, eg for icon)
    "platform": "pancake", // required
    "earns": ["bake"], // optional
    "link": "https:\/\/pancakeswap.finance\/farms", // required
    "has_details": true, // optional provide a detail link in frontend
    "notes": ['note_1', 'note_1'] // optional note of the farm; will be join in frontend
    "extra": {
      "lpAddress": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82", // to given hint about liquity split calculation
      "transactionToken": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82", // "in" and "out" transaction token
      "transactionAddress": "0x73feaa1eE314F8c655E354234017bE2193C9E24E" // "from" and "to" transaction
      "pricePerFullShare": 1.0408062780129632, // auto vault yield pools normally just wrap the "lpAddress" with a token which price is increasing; so just the multiplier
      "pricePerFullShareToken": "0xA9936272065e6DDAc9D2453C9a2712B581e9aE1B" // if given the value of "pricePerFullShare" is writting into database for historical data 
    },
    "tvl": {
      "amount": 212497359.08927876, // optional and not used
      "usd": 2832998380.971941 // optional
    },
    "yield": { // yearly values in percent eg 12.12%. apy or apr can be given (TODO: normalize to one)
      "apy": 553.9292024968477,
      "apr": 12.9292024968477,
    }
  },

About

Track your farming and pool performance on the Binance Smart Chain - https://farm.army - nodejs backend

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 73.9%
  • TypeScript 26.1%