[FEATURE]: Add transaction and receipt lookup RPC methods

Open
#176 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@Thushara3005 is already working on this.

Since Nov 12, 2026.

  • #184 by @Thushara3005 — open

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
58/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python

Research direction

Start by locating the JSON-RPC server and the code that handles transaction submission, block queries, and account balances. Trace how transactions and receipts are stored and serialized, then add lookup methods that return the requested data or null. Done means tests cover existing transactions and receipts, unknown hashes, and continued operation of existing RPC methods.

Written by the indexing model from the issue text.

Description

enhancement
Description

I noticed that MiniChain's RPC server currently supports sending transactions and querying blocks and account balances. However, there are no RPC methods to look up a transaction or its receipt using a transaction hash.

This would be useful for developers building wallets, explorers, or applications on top of MiniChain, as they need a way to check transaction details and execution status.

Proposed Changes

Add two RPC methods:

  • mc_getTransactionByHash(txHash) – Returns the transaction details for the given hash, or null if it is not found.
  • mc_getTransactionReceipt(txHash) – Returns the corresponding receipt, including status, gas used, logs, and contract address, or null if no receipt is available.
Expected Outcome

Developers should be able to retrieve transaction details and execution results directly through MiniChain's JSON-RPC interface.

Testing
  • Test lookup of an existing transaction.
  • Test lookup of an existing transaction receipt.
  • Test unknown transaction hashes.
  • Ensure existing RPC methods continue to work.

I would like to work on this feature if the maintainers consider it useful.

Dominant language
Python
Stars
12
Forks
27
Avg merge
2m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from StabilityNexus/MiniChain

All issues in StabilityNexus/MiniChain

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.