⛓️ BSC Utility Suite – EVM Interoperability & Protocol Engine

A robust toolkit engineered for interaction with the BNB Smart Chain (BSC) ecosystem, including BEP-20 assets, custom contract deployment, and DEX operations, maintaining compatibility with other Ethereum Virtual Machine (EVM) infrastructures.

---

Core Technological Foundation

• Underlying Ledger: BNB Smart Chain (BSC)
• Web3 Abstraction Layer: Viem version 2.23.11, PancakeSwap SDK release 5.8.8
• Execution Environment: Node.js (ESM modules), TypeScript compiler
• Orchestration Standard: Model Context Protocol (MCP) SDK specification 1.4.0
• Security Posture: Private key preservation via AES encryption underpinned by bcrypt hashing for access control
• Asset Safeguarding: Integration with GoPlus SDK for proactive token hazard assessments
• Off-Chain Data Sourcing: Moralis SDK, version 2.27.2, for comprehensive chain state retrieval

---

Supported Network Endpoints

• Primary Network: BNB Smart Chain Mainnet (Chain Identifier: 56)
• Default Access Point: https://bsc-dataseed.binance.org
• Alternative RPC endpoints are configurable via environmental variables

---

Essential Contract Locators

Contract Role	Address Hash	Primary Functionality Detail
Four.Meme Acquisition Gateway	0xF251F83e40a78868FcfA3FA4599Dad6494E46034	Facilitates purchasing of the Four.Meme asset
Four.Meme Price Regulator (AMAP)	0x5c952063c7fc8610FFDB798152D69F0B9550762b	Dynamic pricing mechanism for meme token trading
Four.Meme Token Foundry	0x5c952063c7fc8610FFDB798152D69F0B9550762b	Contract for minting new Four.Meme tokens
DEX Swap Handler	Integrated via SDK	Core router for decentralized exchange liquidity provisioning
V3 Liquidity Pools	Accessed via SDK	Management interfaces for PancakeSwap tier-3 liquidity pools

---

Operational Capabilities

• Cost-Optimized Transfers: Efficient BNB and BEP-20 token movements leveraging BSC's minimal fee structure
• Automated DEX Operations: Full support for PancakeSwap V2/V3 swaps, automated liquidity provision, and yield position tracking
• Meme Asset Lifecycle: End-to-end management for Four.Meme assets: creation, acquisition, and divestment
• Key Management Rigor: Utilizing AES-256 encryption overlaid with strong bcrypt password verification for key storage
• Pre-Execution Vetting: Integrated GoPlus analysis services for upfront token risk profiling
• Gas Optimization: Intelligent routing algorithms to minimize transaction fuel expenditure on the BSC network
• AI Interfacing Layer: Native adherence to the Model Context Protocol (MCP) for seamless integration with advanced agents (e.g., Claude Desktop)
• Portfolio Surveillance: Continuous monitoring of token balances and active staked positions across the managed wallet(s)

---

🛠️ Setup and Deployment Instructions

1. Installation Command

bash npm install -g bsc-utility-toolkit

2. Initialization via CLI

bash bsc-utility-toolkit --setup-wizard

The setup sequence will request mandatory inputs:

• ✅ BSC Private Key Data (Essential)
• ✅ Wallet Access Passphrase (Mandatory, minimum length 6 characters)
• ✅ Custom RPC Endpoint (Optional; defaults to: https://bsc-dataseed.binance.org *)

---

🧠 Agent Integration (Claude Desktop)

Upon successful execution of the command-line setup, this tool is designed to self-register within the Claude Desktop environment.

📍 Configuration Manifest Target:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude agents will automatically recognize and leverage this MCP server based on your specified configurations.

---

🔨 Exposed MCP Functions

Function Signature	Operational Summary
sendNativeAsset	Transmit BNB to a specified destination address
moveBep20Asset	Dispatch BEP-20 tokens using ticker symbol or contract address
executePancakeSwap	Facilitate token exchange via PancakeSwap liquidity pools
deployMemeAssetFactory	Instantiate a new meme token utilizing the Four.Meme system
deployBep20Standard	Initiate deployment script for a generic BEP-20 contract
fetchAssetHoldings	Retrieve current native and token balance records for an address
interactContract	Execute arbitrary function calls on any deployed contract via ABI definition
queryWalletSnapshot	Obtain summary metadata for a given wallet identifier
scanTokenSafety	Perform comprehensive security analysis on specified BSC assets
provisionLiquidity	Deposit assets to a PancakeSwap pair to enable trading
examineLiquidityPools	Report on the user's existing liquidity provisions
withdrawLiquidityShare	Extract staked assets from PancakeSwap positions
liquidateMemeAsset	Execute a sale of meme tokens via the Four.Meme platform
...Further capabilities planned for future releases 🔧

---

🧪 Development Lifecycle

TypeScript Compilation:

bash npm run compile-assets

Launching the MCP Server:

bash npm run serve

Alternative execution path:

node dist/main.js

Re-running Configuration Utility:

bash bsc-utility-toolkit --setup-wizard

---

📘 Model Context Protocol Adherence (MCP)

This suite is architected entirely around the Model Context Protocol—the industry standard enabling structured, reliable interaction between AI models and external programmatic APIs.

Key MCP Advantages Provided: - ✅ Standardized, strongly-typed request/response schemas - ✅ Compatibility validation across Claude and OpenAI tooling specifications - ✅ Secure, high-availability architecture suitable for serverless deployment environments

---

✅ Development Milestones Achieved

• [x] CLI Configuration Utility Release
• [x] Seamless Desktop Agent Integration
• [x] Token Deployment and Transfer Functionality
• [ ] Integration with Market Data Aggregators (e.g., DEXTools, CoinGecko)
• [ ] Autonomous Telegram Trading Bot Module
• [ ] Advanced AI Agent with On-Chain BSC Intelligence

---

🤝 Community Contribution

We encourage community engagement via pull requests, feature suggestions, or bug reports. We are actively developing AI-native, tool-centric infrastructure for the forthcoming era of decentralized agents. Join the development effort!

---

🛡️ Licensing Statement

Licensed under the MIT Agreement — Free to use, open for collaborative enhancements.