createRecentSignatureConfirmationPromiseFactory

Call Signature

createRecentSignatureConfirmationPromiseFactory(config): GetRecentSignatureConfirmationPromiseFn

Creates a promise that resolves when a recently-landed transaction achieves the target confirmation commitment, and throws when the transaction fails with an error.

The status of recently-landed transactions is available in the network's status cache. This confirmation strategy will only yield a result if the signature is still in the status cache. To fetch the status of transactions older than those available in the status cache, use the GetSignatureStatusesApi.getSignatureStatuses method setting the searchTransactionHistory configuration param to true.

Parameters

Returns

GetRecentSignatureConfirmationPromiseFn

Example

import { createRecentSignatureConfirmationPromiseFactory } from '@solana/transaction-confirmation';
 
const getRecentSignatureConfirmationPromise = createRecentSignatureConfirmationPromiseFactory({
    rpc,
    rpcSubscriptions,
});
try {
    await getRecentSignatureConfirmationPromise({
        commitment,
        signature,
    });
    console.log(`The transaction with signature \`${signature}\` has achieved a commitment level of \`${commitment}\``);
} catch (e) {
    console.error(`The transaction with signature \`${signature}\` failed`, e.cause);
    throw e;
}

Call Signature

createRecentSignatureConfirmationPromiseFactory(config): GetRecentSignatureConfirmationPromiseFn

Creates a promise that resolves when a recently-landed transaction achieves the target confirmation commitment, and throws when the transaction fails with an error.

The status of recently-landed transactions is available in the network's status cache. This confirmation strategy will only yield a result if the signature is still in the status cache. To fetch the status of transactions older than those available in the status cache, use the GetSignatureStatusesApi.getSignatureStatuses method setting the searchTransactionHistory configuration param to true.

Parameters

Returns

GetRecentSignatureConfirmationPromiseFn

Example

import { createRecentSignatureConfirmationPromiseFactory } from '@solana/transaction-confirmation';
 
const getRecentSignatureConfirmationPromise = createRecentSignatureConfirmationPromiseFactory({
    rpc,
    rpcSubscriptions,
});
try {
    await getRecentSignatureConfirmationPromise({
        commitment,
        signature,
    });
    console.log(`The transaction with signature \`${signature}\` has achieved a commitment level of \`${commitment}\``);
} catch (e) {
    console.error(`The transaction with signature \`${signature}\` failed`, e.cause);
    throw e;
}

Call Signature

createRecentSignatureConfirmationPromiseFactory(config): GetRecentSignatureConfirmationPromiseFn

Creates a promise that resolves when a recently-landed transaction achieves the target confirmation commitment, and throws when the transaction fails with an error.

The status of recently-landed transactions is available in the network's status cache. This confirmation strategy will only yield a result if the signature is still in the status cache. To fetch the status of transactions older than those available in the status cache, use the GetSignatureStatusesApi.getSignatureStatuses method setting the searchTransactionHistory configuration param to true.

Parameters

Returns

GetRecentSignatureConfirmationPromiseFn

Example

import { createRecentSignatureConfirmationPromiseFactory } from '@solana/transaction-confirmation';
 
const getRecentSignatureConfirmationPromise = createRecentSignatureConfirmationPromiseFactory({
    rpc,
    rpcSubscriptions,
});
try {
    await getRecentSignatureConfirmationPromise({
        commitment,
        signature,
    });
    console.log(`The transaction with signature \`${signature}\` has achieved a commitment level of \`${commitment}\``);
} catch (e) {
    console.error(`The transaction with signature \`${signature}\` failed`, e.cause);
    throw e;
}