Shardeum Interoperability Hub

🧭 Introduction

The Shardeum Protocol Interaction Server acts as a critical middleware, exposing a universally accepted RPC interface for interacting with the Shardeum ledger system. This system is engineered to allow decentralized applications (dApps), artificial intelligence constructs, and other service consumers to fetch chain data and execute necessary operations.

🌟 Primary Capabilities

• Full RPC Specification Compliance
• Adherence to standard Ethereum communication protocols
• Inclusion of network-specific Shardeum extensions
• Versatile Data Retrieval
• Seamless Integration with AI Agents
• Ledger Connectivity Assured
• Advanced Fault Reporting

⚙️ Supported Procedures

Ethereum Compatible Endpoints

• Block Details Retrieval

• eth_blockNumber

• eth_getBlockByHash
• eth_getBlockByNumber

• eth_getBlockReceipts

• Transaction Management

• eth_getTransactionCount

• eth_getTransactionByHash
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex

• eth_getTransactionReceipt

• Account Operations

• eth_getBalance
• eth_estimateGas
• eth_chainId

Shardeum Specific Extensions

• shardeum_getNodeList
• shardeum_getNetworkAccount
• shardeum_getCycleInfo

📋 Requirements

• Runtime Environment: Node.js version 18 or newer
• Prerequisite Knowledge: Familiarity with distributed ledger concepts

Integration Steps via Cursor IDE

1. Obtain the source code repository and execute dependency installation via npm.
2. Launch the Cursor integrated development environment.
3. Navigate to the application configuration settings.
4. Locate the section designated for MCP servers.
5. Select the option to incorporate a new MCP service instance.
6. Supply the following configuration payload:

{
  "mcpServers": {
    "shm-gateway": {
      "command": "node",
      "args": [
        "path_to\shardeum-mcp-server\index.js"
      ]
    }
  }
}

❓ Usage Examples

Inspecting Wallet Value

Prompt Cursor with queries such as:

• "Determine the current asset holdings for address 0x1234... on the Shardeum chain?"
• "What is the associated ETH balance for this specific account?"

Analyzing Transaction Flows

• "Display comprehensive details pertaining to transaction hash 0x5678..."
• "Perform an analysis of the most recent Shardeum ledger block."

🤝 Community Contribution

1. Fork the official repository to your workspace.
2. Establish a dedicated feature branch for your modifications.
3. Commit your introduced changes.
4. Push the new branch to your remote origin.
5. Initiate a Pull Request against the primary branch.

📄 Parameterization

To utilize an alternative node endpoint, modify the designated constant variable rpcUrl to the desired URL.

🛑 Troubleshooting Common Issues

• Confirm correct installation of Node.js version 18 or greater.
• Verify stable network connection status.
• Validate the operational status of the configured RPC endpoint.
• Upgrade the installed software package to the latest release.

🚀 Future Development Plan

• [ ] Implement support for supplementary decentralized networks.
• [ ] Integrate functionality for initiating outgoing transactions.
• [ ] Refine and strengthen exception handling mechanisms.
• [ ] Optimize overall system latency and throughput.
• [ ] Broaden the suite of accessible operational tools.

🌐 Supported Environments

• Shardeum Test Network Configuration
• Additional environment definitions forthcoming!