Get the Promise of an Ethereum transaction receipt when it is finally mined

getTransactionReceiptMined.js

const Promise = require("bluebird");
const sequentialPromise = require("./sequentialPromise.js");

/**
 * @param {!string | !Array.<!string>} txHash, a transaction hash or an array of transaction hashes.
 * @param {Number} interval, in seconds.
 * @returns {!Promise.<!object> | !Promise.<!Array.<!object>>} the receipt or an array of receipts.
 */
module.exports = function getTransactionReceiptMined(txHash, interval) {
    const self = this;
    const transactionReceiptRetry = () => self.getTransactionReceipt(txHash)
        .then(receipt => receipt != null
            ? receipt
            : Promise.delay(interval ? interval : 500).then(transactionReceiptRetry));
    if (Array.isArray(txHash)) {
        return sequentialPromise(txHash.map(
            oneTxHash => () => self.getTransactionReceiptMined(oneTxHash, interval)));
    } else if (typeof txHash === "string") {
        return transactionReceiptRetry();
    } else {
        throw new Error("Invalid Type: " + txHash);
    }
};

I'm curious why this begins with web3.eth.getTransactionReceiptMined. getTransactionReceiptMined as far as I know is not a web3 method. Can you explain this?

It does not exist. That's why we add it to web3.eth. The purpose of this gist is to add this function under this name.

Tests for the curious https://github.com/b9lab/promise-extensions/blob/master/test/getTransactionReceiptMined.js

Hey thanks very much for publishing this, I want to use it in my project but would you please add a default license statement to your profile? Under copyright law we're legally not allowed to use your code without one! A license can be put anywhere public here's an example https://gist.github.com/rwaldron/1056460

Thank you very much for this. Planning to use this as a work around for faulty truffle event watching behavior. Ok to use this in my code correct? Just wanted to make sure! :)

Maybe this is a stupid question that doesn't apply to Ethereum but with this code how would one check that the TX hadn't been orphaned or something like that? Wouldn't it be better to have a minimum confirmation that needs to be satisfied for a TX to be confirmed, after which the promise resolves. Is this detail already handled by the wallet?

Hello. Great function! I have implemented a minor improvement to use block limit while searching. Have a look, please.
https://gist.github.com/VanijaDev/94481514a8f677ad7e27bb0edb8f0895

Hello. Great idea, but I got the following problem:

Unhandled Promise rejection: Invalid JSON RPC response: {"id":358,"jsonrpc":"2.0","error":{"code":-32603}} ; Zone: ; Task: Promise.then ; Value: Error: Invalid JSON RPC response: {"id":358,"jsonrpc":"2.0","error":{"code":-32603}}
at Object.InvalidResponse

If I do:

await web3.eth.getTransaction( txn_id );

It will wait till it is mined - correct?

@prographo, No, it will not wait till it is mined. If it is not mined yet, some of the fields (such as 'blockNumber') of the resolved transaction object would be null. See the document here: https://web3js.readthedocs.io/en/1.0/web3-eth.html#gettransaction