🔗 EtherealBridge-5: Direct Ethereum Conduit

Your dedicated intermediary for seamless dialogue between Claude and decentralized ledger infrastructure.

✨ Core Functionality Overview

EtherealBridge-5 establishes an unmediated conduit to Ethereum nodes for the AI agent, offering:

• Asset Tracking: Instantaneous retrieval of fungible token balances and delegation statuses for any ERC-20 asset.
• Contract Inspection: Deep dives into the metadata and properties of on-chain smart contracts.
• Bypassed Throttling: Direct, unrestricted querying capability against your chosen node instance.
• Confidentiality: Ensured private execution of all blockchain interactions.

🛠️ Deployment Guide

bash

Obtain the source repository

git clone https://github.com/5ajaki/veri5ight.git

Resolve dependencies

npm install

Compile assets for execution

npm run build

⚙️ Setup and Environment Configuration

1. Duplicate the example configuration file:

bash cp .env.example .env

1. Define the endpoint for your Ethereum node within the .env file (Update the placeholder with your actual RPC address and port):

env ETH_NODE_URL="http://localhost:8545" # Substitute with your operational node endpoint

1. Configure the Claude Desktop integration by modifying the configuration file:

{ "mcpServers": { "EtherealBridge-5": { "command": "node", "args": ["/absolute/path/to/veri5ight/dist/index.js"] // Ensure this points to the compiled executable } } }

Crucially, step 3 requires the exact path to the index.js file produced in your local dist folder following the build process.

Operational Modes

EtherealBridge-5 is configured for automatic initialization alongside the Claude Desktop application. To switch to manual initiation:

1. Eliminate the postbuild script entry in package.json that manages auto-launching.
2. Execute the tool manually when necessary:

bash node dist/index.js

🛠️ Available Tooling Functions

ethereum_getTokenBalance

Retrieves the current holdings of any ERC20 token, identifiable via its contract address or registered ENS name.

Query Example:

Agent, ascertain the UNI token balance held by vitalik.eth.

ethereum_getTokenDelegation

Examines the delegation status and recipient for specified blockchain governance tokens.

Query Example:

Agent, identify the delegatee for nick.eth's staked tokens.

ethereum_getContractInfo

Fetches comprehensive attribute data pertaining to a designated smart contract address.

Query Example:

Agent, provide a detailed breakdown of the contract associated with nick.eth.

ethereum_getRecentTransactions

Scans the ten most recently mined blocks to list transactions involving a specified account address.

Query Example:

Agent, display recent transaction history for vitalik.eth.

The function returns up to the requested quantity of transactions (defaulting to 3) discovered within the recent block window. If no relevant transactions are found, an empty result set will be returned.

🐛 Troubleshooting

Consult the client application logs for resolution of any operational anomalies:

bash tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

💡 Rationale for Direct Node Interfacing

• Speed: Minimal latency due to elimination of intermediary API layers.
• Scalability: Unlimited query throughput against one's dedicated infrastructure.
• Data Sovereignty: All node communications remain strictly local to your environment.
• Completeness: Full exposure to the underlying JSON-RPC specification.
• Immediacy: Access to the most current, finalized state of the ledger.

👨‍💻 Development Workflow

bash

Continuous compilation mode (for active iteration)

npm run dev

Final build process

npm run build

🤝 Community Contribution

Suggestions, enhancements, or bug reports are highly encouraged! Follow the standard procedure:

1. Create a personal fork.
2. Establish a feature branch.
3. Implement your modifications.
4. Submit a Pull Request.

📜 Licensing

This project is released under the MIT License. Consult the [LICENSE] file for full particulars.

🙏 Acknowledgements

• Developed with dedication by the EtherealBridge-5 contributors.
• Leverages the advanced reasoning capabilities of the Claude model.
• Built upon the foundational protocols of the Ethereum ecosystem.

🆘 Support Channels

• Bugs: Initiate an Issue ticket.
• Inquiries: Commence a Discussion thread.
• Feature Proposals: Share your concepts!

Remember: EtherealBridge-5 is your comprehensive utility belt for Ethereum data access—use it wisely! 🛠️