import { SOLANA_ERROR__FAILED_TO_SEND_TRANSACTION, SOLANA_ERROR__FAILED_TO_SEND_TRANSACTIONS, SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTION, SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTIONS, SOLANA_ERROR__INSTRUCTION_PLANS__FAILED_TO_EXECUTE_TRANSACTION_PLAN, SolanaError } from '@solana/errors';
import { type CanceledSingleTransactionPlanResult, type FailedSingleTransactionPlanResult, type TransactionPlanResult, type TransactionPlanResultContext, type TransactionPlanResultContextWithSignature } from './transaction-plan-result';
/**
 * Creates a {@link SolanaError} with the {@link SOLANA_ERROR__FAILED_TO_SEND_TRANSACTION}
 * error code from a failed or canceled {@link SingleTransactionPlanResult}.
 *
 * This is a high-level error designed for user-facing transaction send failures.
 * It unwraps simulation errors (such as preflight failures) to expose the
 * underlying transaction error as the `cause`, and extracts preflight data
 * and logs into the error context for easy access.
 *
 * The error message includes an indicator showing whether the failure was a
 * preflight error or includes the on-chain transaction signature for easy
 * copy-pasting into block explorers.
 *
 * @typeParam TContext - The type of the context object attached to the result. Any context is
 * accepted; the signature is read from it only if one happens to be there.
 * @param result - A failed or canceled single transaction plan result.
 * @param abortReason - An optional abort reason if the transaction was canceled.
 * @return A {@link SolanaError} with the appropriate error code, context, and cause.
 *
 * @example
 * Creating an error from a failed transaction plan result.
 * ```ts
 * import { createFailedToSendTransactionError } from '@solana/instruction-plans';
 *
 * const error = createFailedToSendTransactionError(failedResult);
 * console.log(error.message);
 * // "Failed to send transaction (preflight): Insufficient funds for fee"
 * console.log(error.cause);
 * // The unwrapped transaction error
 * console.log(error.context.logs);
 * // Transaction logs from the preflight simulation
 * ```
 *
 * @see {@link createFailedToSendTransactionsError}
 * @see {@link createFailedToSignTransactionError}
 */
export declare function createFailedToSendTransactionError<TContext extends TransactionPlanResultContext = TransactionPlanResultContextWithSignature>(result: CanceledSingleTransactionPlanResult<TContext> | FailedSingleTransactionPlanResult<TContext>, abortReason?: unknown): SolanaError<typeof SOLANA_ERROR__FAILED_TO_SEND_TRANSACTION>;
/**
 * Creates a {@link SolanaError} with the {@link SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTION}
 * error code from a failed or canceled {@link SingleTransactionPlanResult}.
 *
 * This is the signing counterpart to {@link createFailedToSendTransactionError}, designed
 * for user-facing failures raised by executors that sign a transaction without submitting
 * it. It behaves identically — unwrapping simulation errors to expose the underlying
 * transaction error as the `cause`, and extracting preflight data and logs into the error
 * context — because signing executors typically estimate resource limits by simulating
 * before they sign.
 *
 * Unlike the sending variant, the message carries no indicator of where the failure
 * happened. That indicator locates a failure relative to network submission — `(preflight)`
 * before it, or the transaction signature after it — and signing never submits, so neither
 * applies. The `logs` and `preflightData` context properties are still populated whenever a
 * simulation was responsible, and those logs still appear in the message, so nothing is lost
 * beyond the prefix.
 *
 * @typeParam TContext - The type of the context object attached to the result. Any context is
 * accepted, since this helper never reads from it.
 * @param result - A failed or canceled single transaction plan result.
 * @param abortReason - An optional abort reason if the transaction was canceled.
 * @return A {@link SolanaError} with the appropriate error code, context, and cause.
 *
 * @example
 * Creating an error from a failed transaction plan result.
 * ```ts
 * import { createFailedToSignTransactionError } from '@solana/instruction-plans';
 *
 * const error = createFailedToSignTransactionError(failedResult);
 * console.log(error.message);
 * // "Failed to sign transaction: The user rejected the signing request"
 * console.log(error.cause);
 * // The unwrapped signing error
 * ```
 *
 * @see {@link createFailedToSignTransactionsError}
 * @see {@link createFailedToSendTransactionError}
 */
export declare function createFailedToSignTransactionError<TContext extends TransactionPlanResultContext = TransactionPlanResultContext>(result: CanceledSingleTransactionPlanResult<TContext> | FailedSingleTransactionPlanResult<TContext>, abortReason?: unknown): SolanaError<typeof SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTION>;
/**
 * Creates a {@link SolanaError} with the {@link SOLANA_ERROR__FAILED_TO_SEND_TRANSACTIONS}
 * error code from a {@link TransactionPlanResult}.
 *
 * This is a high-level error designed for user-facing transaction send failures
 * involving multiple transactions. It walks the result tree, unwraps simulation
 * errors from each failure, and builds a `failedTransactions` array pairing each
 * failure with its unwrapped error, logs, and preflight data.
 *
 * The error message lists each failure with its position in the plan and an
 * indicator showing whether it was a preflight error or includes the transaction
 * signature. When all transactions were canceled, the message is a single line.
 *
 * @typeParam TContext - The type of the context object attached to the results. Any context is
 * accepted; each signature is read from it only if one happens to be there.
 * @param result - The full transaction plan result tree.
 * @param abortReason - An optional abort reason if the plan was aborted.
 * @return A {@link SolanaError} with the appropriate error code, context, and cause.
 *
 * @example
 * Creating an error from a failed transaction plan result.
 * ```ts
 * import { createFailedToSendTransactionsError } from '@solana/instruction-plans';
 *
 * const error = createFailedToSendTransactionsError(planResult);
 * console.log(error.message);
 * // "Failed to send transactions.
 * // [Tx #1 (preflight)] Insufficient funds for fee
 * // [Tx #3 (5abc...)] Custom program error: 0x1"
 * console.log(error.context.failedTransactions);
 * // [{ index: 0, error: ..., logs: [...], preflightData: {...} }, ...]
 * ```
 *
 * @see {@link createFailedToSendTransactionError}
 * @see {@link createFailedToSignTransactionsError}
 */
export declare function createFailedToSendTransactionsError<TContext extends TransactionPlanResultContext = TransactionPlanResultContextWithSignature>(result: TransactionPlanResult<TContext>, abortReason?: unknown): SolanaError<typeof SOLANA_ERROR__FAILED_TO_SEND_TRANSACTIONS>;
/**
 * Creates a {@link SolanaError} with the {@link SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTIONS}
 * error code from a {@link TransactionPlanResult}.
 *
 * This is the signing counterpart to {@link createFailedToSendTransactionsError}, designed
 * for user-facing failures raised by executors that sign several transactions without
 * submitting them. It walks the result tree, unwraps simulation errors from each failure,
 * and builds the same `failedTransactions` array pairing each failure with its unwrapped
 * error, logs, and preflight data.
 *
 * As with {@link createFailedToSignTransactionError}, each line names only the position of
 * the failure in the plan. Nothing was submitted, so there is no preflight to flag and no
 * transaction signature worth quoting.
 *
 * @typeParam TContext - The type of the context object attached to the results. Any context is
 * accepted, since this helper never reads from it.
 * @param result - The full transaction plan result tree.
 * @param abortReason - An optional abort reason if the plan was aborted.
 * @return A {@link SolanaError} with the appropriate error code, context, and cause.
 *
 * @example
 * Creating an error from a failed transaction plan result.
 * ```ts
 * import { createFailedToSignTransactionsError } from '@solana/instruction-plans';
 *
 * const error = createFailedToSignTransactionsError(planResult);
 * console.log(error.message);
 * // "Failed to sign transactions.
 * // [Tx #1] Insufficient funds for fee
 * // [Tx #3] The user rejected the signing request"
 * console.log(error.context.failedTransactions);
 * // [{ index: 0, error: ..., logs: [...], preflightData: {...} }, ...]
 * ```
 *
 * @see {@link createFailedToSignTransactionError}
 * @see {@link createFailedToSendTransactionsError}
 */
export declare function createFailedToSignTransactionsError<TContext extends TransactionPlanResultContext = TransactionPlanResultContext>(result: TransactionPlanResult<TContext>, abortReason?: unknown): SolanaError<typeof SOLANA_ERROR__FAILED_TO_SIGN_TRANSACTIONS>;
/**
 * Creates a {@link SolanaError} with the
 * {@link SOLANA_ERROR__INSTRUCTION_PLANS__FAILED_TO_EXECUTE_TRANSACTION_PLAN}
 * error code from a {@link TransactionPlanResult}.
 *
 * This is a low-level error intended for custom transaction plan executor
 * authors. It attaches the full `transactionPlanResult` as a non-enumerable
 * property so that callers can inspect execution details without the result
 * being serialized with the error.
 *
 * @typeParam TContext - The type of the context object attached to the results. Any context is
 * accepted, since this helper never reads from it.
 * @param result - The full transaction plan result tree.
 * @param abortReason - An optional abort reason if the plan was aborted.
 * @return A {@link SolanaError} with the appropriate error code and context.
 *
 * @example
 * Throwing a failed-to-execute error from a custom executor.
 * ```ts
 * import { createFailedToExecuteTransactionPlanError } from '@solana/instruction-plans';
 *
 * throw createFailedToExecuteTransactionPlanError(transactionPlanResult, abortSignal?.reason);
 * ```
 *
 * @see {@link createFailedToSendTransactionError}
 * @see {@link createFailedToSendTransactionsError}
 */
export declare function createFailedToExecuteTransactionPlanError<TContext extends TransactionPlanResultContext = TransactionPlanResultContextWithSignature>(result: TransactionPlanResult<TContext>, abortReason?: unknown): SolanaError<typeof SOLANA_ERROR__INSTRUCTION_PLANS__FAILED_TO_EXECUTE_TRANSACTION_PLAN>;
//# sourceMappingURL=transaction-plan-errors.d.ts.map