microscopexyz / chainmetareader

The open source blockchain metadata protocol
https://microscopeprotocol.xyz/
Apache License 2.0
12 stars 2 forks source link

Unified Entity List #42

Closed zhanwu closed 1 year ago

zhanwu commented 1 year ago

Looking at sample data, common structure are:

Category is being discussed via https://github.com/openchainmeta/chainmetareader/issues

Entity list also needs to merged and maintained

daerae commented 1 year ago

we also need to consider data sources like ground truth, heuristics, machine learning, or external third party verified

beingzy commented 1 year ago

@zhanwu I still have a hard time understanding what info we should put in "name" component, particularly using it jointly with "entity" and "categories". Could you mind list some examples to show-case when we need put info in "name"? :-)

dongyi1991 commented 1 year ago

o we should put in "name" component, particularly using it jointly with "entity" and "categories". Could you mind list some e

agree

zhanwu commented 1 year ago

Consider the following example

submitted_by    address chain   entity_name name    categories  attributes  tagged_on
Chaintool   0x4d77a1144dc74f26838b69391a6d3b1e403d0990  ETH huobi   Huobi 32    Exchange        2022-12-01

it represents 3 piece of information:

  1. 0x4d77a1144dc74f26838b69391a6d3b1e403d0990, entitty_name: huobi
  2. 0x4d77a1144dc74f26838b69391a6d3b1e403d0990, name: Huobi 32
  3. 0x4d77a1144dc74f26838b69391a6d3b1e403d0990, attribute: Exchange

entity (or entity_name in this example) is referring to a pre-defined company or known organization, e.g. huobi, uniswap, coinbase etc.

name is an addition piece of information, which add more description to the address, Huobi 32, or Uniswap ETH <> BTC, etc. name is complementary to entity.

zhanwu commented 1 year ago

Another difference between entity and name, I think, is entity is something we need to reach consensus on. An contract address can only belongs to one company, you say coinbase and I say binance then at least one of us is wrong. On the other hand, I think name is more like a extra note and strict consensus is not necessary.

dongyi1991 commented 1 year ago

we also need to consider data sources like ground truth, heuristics, machine learning, or external third party verified

I updated the sample data and added a new field called source in the PR#47. I intended to modify the ChainmetaItem class directly, but I am concerned about the impact on the database. Can @zhanwu help me modify it?

dongyi1991 commented 1 year ago

Here is the entity list compiled by Chaintool, which is incomplete and still being organized.

entity

0x 0xGames 7Tron 888Bet AAX ABCC ACE AEX Aave Abracadabra Acorn Finance Across Protocol AirSwap Alchemist Coin AltCoinTrader Amber Group Anonymous Mixer Any.Cash ApeSwap Apeswap Arcx Arina Land Tycoon Arken Finance Armor AscendEX Atom Solutions Atomex Augmented Finance Aura Finance Authereum Axie Infinity BKEX BTC Blender BTSE Baby Doge Swap Badbit Games Balancer Bancor Bancor Network Barbooth.Bet BeGlobal Bear Escape Belt Finance Bestmixer BetSwirl Bettown Bgogo Bibox BigONE Binance Bingbon Bingo Cash Finance BitBase BitDAO BitFlyer BitForex BitKan BitKeep BitMEX BitMart BitMix Bitcoin Blender Bitcoin Laundry Bitcoin Mixer BitcoinMix Bitfinex Bitget Bithumb Bitkub BitoPro Bitpie Bitrue Bitso Bitstamp Bittrex Bitverk Bitzlato BlinkPay Blockchain Cuties Blockfolio_FTX Bogged Finance Bounce Bovada Brave Frontier Heroes Bspin BtcTurk Bull vs Bear Bunicorn Bybit CEX.IO COBINHOOD COSS Cache Gold Candle Genie Cashierest Celsius Celsius Network ChangeNOW ChimpySwap CoW Swap Cobo Cofix CoinCola CoinDCX CoinEx CoinJoin CoinTiger CoinW Coinbase Coinbase Commerce Coincheck Coinhako Coinmetro Coinmixer.me Coinomize Coinone Compound Convex Finance Crazy Dogs Live Cream Finance Crex24 Crypto Tycoons 2 Crypto.com CryptoMixer CryptoSpells Cryptonator Cryptopay Crystal Currency.com Curve.fi DDDX DODO DeFi Saver Decentral Games Decentraland Deri Protocol BSC Deribit Derive Finance Deversifi DigiFinex Dopple Double Protocol Dragon 7 Dragon Castle DragonBall Finance Dragonereum ERC1155-ERC20 Bridge EXMO Egg Dex Enme Enzyme Finance Ethbattle Ethereum Mixer Ethermon Ethex.Bet Ethorse FTX FairGrounds FalconX Fei Protocol FinNexus Finnexus Firebird Finance Firi Fishing Master Flash Liquidity Flipsies ForTube FoxMixer Freewallet GOPAX GameX Swap Garantex Gate.io Gearbox Protocol Gemini Gitcoin Grantee Gitcoin Grants Gods Unchained Grand Casino Heist Hit4digits HitBTC Hotbit Huobi HyperPay INDODAX Iconbet Idle Finance Instadapp Inverse Finance Juicebox JustMoney JustMoney Exchange JustSwap KakiDex Keep2r KingSwap Kraken Kryptono KuCoin Kuna.io Kyber Network KyberSwap LBank Last Pixel Latoken LatteSwap Leonicorn Swap Lido LinkSwap Liquid Liquity Livepeer LooksRare Loopring Luaswap Luminous Luno MAX MDEX MEDIKEY MEV Builder MakerDAO Mantra MaskEx Matrixport Maxbet MetaMask Metis Mirror Protocol Mixer Ethers Mixer.money Mixero Mixin Mixtum Mixtura.money Multichain Mxc My Crypto Heroes MyCryptoMixer NBX Nest Protocol Nexus Mutual Nomad Nuo OCDapp OKEX OKX Old contract OlympusDAO OpenSea Opium Team Oracle DAO P4rty PLUSQO PRDT Paribu Parity bug Paxful Pionex Pirate Dice Pixel Farm Play Royal PlayToWin Plenty PlotX Poker Dice PokerWin Polkastarter Poloni DEX Poloniex PolyDEX Polyflip Polyroll PoolTogether Pop Game Prediction WTF PredictionDEX Premia ProBit Proxima Pundi X Puppyswaps QuantumTECH Quipuswap Rari Capital Rarible RedChillies Redacted Cartel Reflexer Finance Remitano Ren Revest Finance Ribbon Finance RimauSwap Ripio Rocket Pool RollBit Roobet Royal Online Vegas SCGames SPOKpark Saddle Finance Safe SakeSwap Set Protocol Shakepay ShapeShift Shell ShibaNovaDEX SiberianSwap Sinbad.io Snapshot SoloLink Solv Protocol SpicySwap Spinwin SportX-2 Stake StormGain Streamity SushiSwap Swerve Finance SwipeSwap Switchain Switcheo Sybil.org Synthetix TAGZ TRON UP TT Prize TTSwap ThunderBridge Tidex TimeX TofuDeFi TokenPocket Tokenlon Tomowin Totle Trade.io TradeOgre Trafi TreasureKey Trich Tron Emerald Tron Heist Tron Hi-Lo Tron Lounge TronBlock TronChip TronOY TronOscar TronReign TronSolo TronTrade TronWoW Tronace Trondice1 Trongame Tronjack Tronlot Tronsuperstars Trontopia Trontu Tronvegas Tronwin TrustToken Turingmachine-network Twindex Tyche Lottery Tycoons Typhoon Cash UniJoin Unibright Unicrypt Uniswap Unit Protocol Unydex Upbit Upbit hack Uphold Uranium Finance VALR Value DeFi Vdice Vesper Finance WASHCOIN WBTC WebMixer WhiteBIT Wormhole Wowswap XT.com XY Finance Xapo Bank Yearn Finance Yo!Mix YoBit.Net Yoloswap YouSwap ZB.COM Zapper.fi Zerion Zethyr Zethyr Swap hoo imToken itBit mStable

zhanwu commented 1 year ago

The entity list is now codified under https://github.com/openchainmeta/chainmetareader/blob/main/chainmeta_reader/config/entities.json