Skip to content

Fix Greenfield privateKey optional annotations#55

Open
mefai-dev wants to merge 24 commits intobnb-chain:mainfrom
mefai-dev:fix/greenfield-privatekey-optional
Open

Fix Greenfield privateKey optional annotations#55
mefai-dev wants to merge 24 commits intobnb-chain:mainfrom
mefai-dev:fix/greenfield-privatekey-optional

Conversation

@mefai-dev
Copy link

Summary

  • privateKey defaults to env but not indicated

Type of Change

  • Documentation fix

Changes Made

  • Added (optional, defaults to env PRIVATE_KEY) consistently

Testing

  • Verified against MCP source

mefai-dev and others added 24 commits March 9, 2026 00:12
- Professional README with architecture docs and API reference
- Self-contained FastAPI backend (api/)
- Vanilla JS frontend with 50 Web Components (frontend/)
- Contribution guide and code ownership
- Updated bnbchain-mcp-skill references

Built by Mefai for the BNB Chain community.
Skills:
- honeypot-check: Combined honeypot detection with bytecode analysis, buy/sell ratio, and owner concentration scoring
- contract-xray: Deep bytecode analysis with proxy detection, function scanning, and mint/pause/blacklist pattern recognition
- approval-scanner: Token approval checker across 9 major DEX routers with unlimited allowance detection
- risk-radar: Multi-signal risk scoring (0-100, A-F grade) combining on-chain and market data
- upgrade-monitor: EIP-1967 proxy contract detection with implementation and admin storage slot inspection
- contract-audit: Smart contract security analysis covering ownership, proxy patterns, and token standards compliance

All skills use live BSC JSON-RPC data and DexScreener market feeds.
Each includes full API documentation with example requests and response schemas.
Skills:
- sniper-detector: Detect bot sniping on any token by analyzing early block buyers, hold/dump tracking, and snipe score (0-100)
- copy-trade: Real-time alpha wallet activity monitor tracking known wallets for token interactions across recent blocks
- smart-money: Whale transaction tracker identifying large-value BNB transfers with wallet labeling and direction classification
- wallet-cluster: On-chain forensics tool discovering connected wallets via BNB transfer patterns and shared token holdings

All skills use live BSC JSON-RPC data with block scanning and receipt analysis.
Each includes full API documentation with example requests and response schemas.
Skills:
- dex-arb: Cross-DEX price discrepancy finder comparing prices across PancakeSwap, BiSwap, and other BSC DEXes with gas-adjusted profit estimates
- token-battle: Side-by-side comparison of up to 4 tokens showing price, volume, liquidity, burns, and 24h performance
- token-birth: Token genesis analysis with creator wallet profiling, supply distribution breakdown, and liquidity history tracking
- pair-analytics: Deep DEX pair analysis aggregating stats across multiple trading pairs for any BSC token
- pancakeswap-arena: PancakeSwap top pairs dashboard showing volume leaders, liquidity depth, and trending tokens

All skills use live DexScreener market data and BSC JSON-RPC.
Each includes full API documentation with example requests and response schemas.
Skills:
- tx-decoder: Decode any BSC transaction into human-readable function calls, event logs, and token transfers with gas breakdown
- block-autopsy: Block-level gas distribution analysis with transaction type breakdown and top gas consumer identification
- token-flow: Track real-time token transfer movements by scanning recent block receipts for Transfer events
- burn-tracker: Real-time BNB and token burn tracking with live USD valuations from DexScreener
- wallet-scanner: Complete wallet portfolio analysis showing BNB and top BSC token balances with current USD values
- portfolio-heatmap: Bloomberg-style portfolio heatmap with 24h performance coloring, health score, and concentration analysis

All skills use live BSC JSON-RPC data with block and receipt scanning.
Each includes full API documentation with example requests and response schemas.
Skills:
- validator-map: Live BSC validator monitoring tracking all 21 PoSA validators with gas utilization, block production stats, and MEV detection
- network-pulse: Network congestion gauge scoring pressure 0-100 with TPS measurement, block timing analysis, and gas optimization recommendations
- bsc-supremacy: BSC vs Ethereum head-to-head comparison using live data for block time, TPS, gas costs, and finality speed
- gas-calculator: Operation cost estimator computing gas costs for 10 common operations with BSC vs ETH savings comparison
- chain-vitals: Core network health dashboard showing block height, gas price, peer count, and sync status

All skills use live BSC JSON-RPC data with multi-block analysis.
Each includes full API documentation with example requests and response schemas.
Skills:
- yield-finder: APY estimation engine analyzing trading fee revenue across BSC DEX pairs to identify the highest yield opportunities
- defi-leaderboard: Top DeFi protocols ranked by total value locked, trading volume, and active user metrics
- liquidity-pulse: Real-time liquidity depth analysis across major BSC trading pairs with concentration and movement tracking

All skills use live DexScreener market data and BSC JSON-RPC.
Each includes full API documentation with example requests and response schemas.
feat: Add 6 BSC Security Analysis Skills
feat: Add 4 BSC Alpha Intelligence Skills
feat: Add 5 BSC Market Analysis Skills
feat: Add 6 BSC On-Chain Analytics Skills
feat: Add 5 BSC Network and Infrastructure Skills
feat: Add 3 BSC DeFi Analysis Skills
Portfolio snapshot via on-chain RPC — BNB balance plus top 15 BSC token
holdings with live prices and wallet activity classification.
Cross-chain capital flow analysis via bridge contract balances on BSC.
Monitors 6 major bridges: Stargate, Celer, Multichain, LayerZero,
Wormhole, and Axelar.
Real fee revenue vs TVL ranking for BSC DeFi protocols. Sources data
from DefiLlama to rank protocols by daily fees, revenue, and
capital efficiency ratio.
Composite BSC dominance score vs other L1/L2 chains. Weighs TVL (40%),
DEX volume (30%), fees (20%), and cost efficiency (10%) using DefiLlama
and BSC RPC data.
BNB staking ecosystem analysis — total staked BNB, liquid staking
protocol comparison (slisBNB, ankrBNB, BNBx, stkBNB, rBNB), and
APY benchmarks via on-chain data.
feat: add Bridge Flow Monitor skill (#70)
feat: add Protocol Revenue Leaderboard skill (#71)
feat: add Wallet PnL Tracker skill (#69)
feat: add Chain Dominance Index skill (#72)
feat: add Staking Intelligence skill (#73)
## Summary
- Several Greenfield tools showed privateKey without indicating it defaults to env PRIVATE_KEY
- Developers didn't know the parameter is optional when the env var is set

## Type of Change
- [x] Documentation fix

## Changes Made
- gnfd_get_bucket_full_info: added "(optional, defaults to env PRIVATE_KEY)"
- gnfd_download_object: same annotation
- gnfd_get_payment_accounts: clarified privateKey requirement

## Testing
- [x] Verified against MCP source privateKeyParam2 definitions
@hashdit-bot
Copy link

hashdit-bot bot commented Mar 14, 2026

Pull Request Review

This PR is much larger than the title suggests: besides minor doc wording updates about Greenfield privateKey being optional and defaulting to PRIVATE_KEY from env, it introduces a broad project scaffold including new backend/frontend files, CODEOWNERS, contribution guidelines, and extensive skill documentation. The README was heavily rewritten to position the project as a production analytics platform with 28 tools and self-hosting instructions. It also adds a FastAPI app with permissive CORS and a custom stale-while-revalidate caching layer.

Sensitive Content

Blockchain Address:

  • 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 (BSC/EVM token address) in multiple files (e.g., README.md, many skills/**/SKILL.md) — used as example token address
  • 0x10ED43C718714eb63d5aA57B78B54917c3e6fE49 (BSC/EVM contract address) in skills/analytics/block-autopsy/SKILL.md, skills/security/approval-scanner/SKILL.md, skills/analytics/tx-decoder/SKILL.md — example PancakeSwap router/contract
  • Multiple additional EVM addresses added across docs under skills/**/SKILL.md as sample contracts/wallets/bridges/validators

Social Account:

  • @mefai-dev (GitHub handle) in .github/CODEOWNERS — repository code owner

Security Issues

No serious security issues detected.


Generated by Hashdit Bot. This tool can absolutely NOT replace manual audits.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant