Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 4.65 KB

README.md

File metadata and controls

127 lines (89 loc) · 4.65 KB
Raw

Lab 4 : Wait for Confirmation.

This lab is a learn about the behavior of the waitForConfirmation function.

// Utility function to wait on a transaction to be confirmed
// The timeout parameter indicates how many rounds do you wish to check pending transactions for

const waitForConfirmation = async function (algodClient, txId, timeout) {
    // Wait until the transaction is confirmed or rejected, or until 'timeout' number of rounds has passed.
    //
    // Args:
    //      txId(str): the transaction to wait for
    //      timeout(int): maximum number of rounds to wait
    //
    // Returns:
    //      pending transaction information, or throws an error if the transaction is not confirmed or rejected in the next timeout rounds

    if (algodClient == null || txId == null || timeout < 0) {
        throw new Error('Bad arguments.');
    }

    const status = await algodClient.status().do();

    if (status === undefined) throw new Error('Unable to get node status');

    const startround = status['last-round'] + 1;

    let currentround = startround;

    while (currentround < startround + timeout) {
        const pendingInfo = await algodClient.pendingTransactionInformation(txId).do();

        if (pendingInfo !== undefined) {
            if (pendingInfo['confirmed-round'] !== null && pendingInfo['confirmed-round'] > 0) {
                // Got the completed Transaction
                return pendingInfo;
            } else {
                if (pendingInfo['pool-error'] != null && pendingInfo['pool-error'].length > 0) {
                    // If there was a pool error, then the transaction has been rejected!
                    throw new Error('Transaction Rejected' + ' pool error' + pendingInfo['pool-error']);
                }
            }
        }

        await algodClient.statusAfterBlock(currentround).do();

        currentround++;
    }

    throw new Error('Transaction not confirmed after ' + timeout + ' rounds!');
};

NOTE :

Successfully submitting your transaction to the network does not necessarily mean the network confirmed it. Always check that the network confirmed your transaction within a block before proceeding.

On Algorand, transactions are final as soon as they are incorporated into a block and blocks are produced, on average, every 5 seconds. This means that transactions are confirmed, on average, in 5 seconds! Read more about the Algorand's Consensus Protocol and how it achieves such high confirmation speeds and immediate transaction finality.

Step 1 : Start Lab

cd algo.labs
./algo.sh lab4

OR

cd algo.labs/lab4.wait-for-confirmation
node index.js

Output

Bob address: KG6YZGHDYJI2UX4NQ5GY7FEYIYRNNCSGEXTOU64NGUWOPEFQJICWPSBTSE
Bob balance: 4935192 microAlgos

Aliza address: XTDP7Y4SISNMH3GZSUV4DOK2GN63I5UQKH7IO3CLOWBNASB27YYYQCEYIM
Aliza balance: 135002155 microAlgos

Bob signed a transaction with txID: 5MZC5J6D7UDYYFUIAGIXFHHTEHEB7YNYH3SYAVG5IX4XCO5WUSPA

Sent 1000000 microAlgos from account KG6YZGHDYJI2UX4NQ5GY7FEYIYRNNCSGEXTOU64NGUWOPEFQJICWPSBTSE to address XTDP7Y4SISNMH3GZSUV4DOK2GN63I5UQKH7IO3CLOWBNASB27YYYQCEYIM, transaction ID: 5MZC5J6D7UDYYFUIAGIXFHHTEHEB7YNYH3SYAVG5IX4XCO5WUSPA. Fee set to 1000 microAlgos

Wait to 5 - 10 sec. and try to check the balance of Bob and Aliza again.

Sending Completed!!

Bob address: KG6YZGHDYJI2UX4NQ5GY7FEYIYRNNCSGEXTOU64NGUWOPEFQJICWPSBTSE
Bob balance: 3934192 microAlgos

Aliza address: XTDP7Y4SISNMH3GZSUV4DOK2GN63I5UQKH7IO3CLOWBNASB27YYYQCEYIM
Aliza balance: 136002155 microAlgos

WARNING : ⚠️

When amount the microAlgos is not enough. Please use the Pump!! service.

cd algo.labs
./algo.sh account pump

OR

cd algo.labs/account
node pump.js

Output

Sent 10000000 MicroAlgos from account HJATUIYSNT2NI6WAOE6TRWBUJFBDM5RPYOGIRZPYXF3U2OPHFTV3NCVIKM to address AAONGYS2WSRAKEXB6W6NDXWOMY2VFRBOIBLAR6LZOHOFSOIIOEWGTCPT34, transaction ID: HOGOOLUIYFWRPIXNDQJK2YJ2426G6F3EDGPUATVRVMW3IB4SX5UA. Fee set to 1000
Transaction HOGOOLUIYFWRPIXNDQJK2YJ2426G6F3EDGPUATVRVMW3IB4SX5UA still pending as of round 548
Transaction HOGOOLUIYFWRPIXNDQJK2YJ2426G6F3EDGPUATVRVMW3IB4SX5UA committed in round 550

Sent 10000000 MicroAlgos from account HJATUIYSNT2NI6WAOE6TRWBUJFBDM5RPYOGIRZPYXF3U2OPHFTV3NCVIKM to address XR6WOS2HCPPEGCS4JKDTBMS7RDYJVS5UJAWPJXXRDFBBHLUVVPB46NOH6Y, transaction ID: UVMWBZPEAUQ4HKABQQBHP2H5GB5AUJBZW3OJOPYLPBMIOOHYKUNA. Fee set to 1000
Transaction UVMWBZPEAUQ4HKABQQBHP2H5GB5AUJBZW3OJOPYLPBMIOOHYKUNA still pending as of round 550
Transaction UVMWBZPEAUQ4HKABQQBHP2H5GB5AUJBZW3OJOPYLPBMIOOHYKUNA committed in round 552

Completed lab 4 🤓