FuelLabs
diff --git a/‎.changeset/empty-pandas-invent.md‎
Lines changed: 4 additions & 0 deletions b/‎.changeset/empty-pandas-invent.md‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎apps/docs/.vitepress/config.ts‎
Lines changed: 4 additions & 0 deletions b/‎apps/docs/.vitepress/config.ts‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎apps/docs/spell-check-custom-words.txt‎
Lines changed: 4 additions & 0 deletions b/‎apps/docs/spell-check-custom-words.txt‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎apps/docs/src/guide/transactions/pre-confirmations.md‎
Lines changed: 61 additions & 0 deletions b/‎apps/docs/src/guide/transactions/pre-confirmations.md‎
Lines changed: 61 additions & 0 deletions
diff --git a/‎apps/docs/src/guide/transactions/snippets/pre-confirmation/contract-call.ts‎
Lines changed: 61 additions & 0 deletions b/‎apps/docs/src/guide/transactions/snippets/pre-confirmation/contract-call.ts‎
Lines changed: 61 additions & 0 deletions
diff --git a/‎apps/docs/src/guide/transactions/snippets/pre-confirmation/send-transaction.ts‎
Lines changed: 73 additions & 0 deletions b/‎apps/docs/src/guide/transactions/snippets/pre-confirmation/send-transaction.ts‎
Lines changed: 73 additions & 0 deletions
diff --git a/‎packages/account/src/account.test.ts‎
Lines changed: 3 additions & 0 deletions b/‎packages/account/src/account.test.ts‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎packages/account/src/providers/operations.graphql‎
Lines changed: 109 additions & 4 deletions b/‎packages/account/src/providers/operations.graphql‎
Lines changed: 109 additions & 4 deletions
@@ -0,0 +1,4 @@
+---
+---
+
+feat: add support for pre-confirmations
@@ -381,6 +381,10 @@ export default defineConfig({
                 text: 'Optimizing Frontend Apps',
                 link: '/guide/transactions/optimizing-frontend-apps',
               },
+              {
+                text: 'Pre-Confirmations',
+                link: '/guide/transactions/pre-confirmations',
+              },
             ],
           },
           {
 
@@ -356,3 +356,7 @@ io
 asm
 github
 vm
+PreconfirmationSuccessStatus
+PreconfirmationFailureStatus
+OutputChange
+OutputVariable
@@ -0,0 +1,61 @@
+# Pre-Confirmations
+
+## What is a Pre-Confirmation?
+
+A **pre-confirmation** is an intermediate transaction status that occurs after a transaction has been **submitted** and **accepted** by the blockchain, but **before** it is fully **processed and included** in a new block.
+
+At this stage, the transaction is pre-executed and assigned one of two possible statuses:
+
+- `PreconfirmationSuccessStatus`: The transaction is expected to be successfully included in a future block.
+
+- `PreconfirmationFailureStatus`: The transaction will **not** be included in any future block.
+
+## Why are Pre-Confirmations important?
+
+Pre-confirmations allow applications to **react earlier** by providing immediate feedback about a transaction's expected outcome without waiting for full block finalization.
+
+Additionally, pre-confirmations expose **processed outputs** (such as `OutputChange` and `OutputVariable`) that can be **immediately reused** in new transactions.
+
+## Available Outputs for Pre-Confirmations
+
+When a transaction reaches the **pre-confirmation** stage, certain `resolvedOutputs` become available:
+
+- `OutputChange`: Represents the change UTXO generated from unspent inputs, grouped by `assetId` (one per asset).
+
+- `OutputVariable`: Similar to `OutputCoin`, but only created if the transaction succeeds.
+
+These outputs can be:
+
+- Extracted directly from the pre-confirmation response.
+- **Used immediately** to fund new transactions, without waiting for block confirmation.
+
+This significantly improves the ability to build transaction sequences or reactive transaction flows.
+
+This is the `ResolvedOutput` interface structure:
+
+<<< @/../../../packages/account/src/providers/transaction-summary/types.ts#resolved-output-type{ts:line-numbers}
+
+## Example Workflow
+
+Suppose you send a transaction that will send funds to another wallet.
+
+As soon as you receive a `PreconfirmationSuccessStatus`, you can:
+
+- Use the `OutputChange` in a new transaction.
+- Submit the next transaction **without waiting** for block finalization.
+
+This reduces wait times and accelerates transaction chaining.
+
+## Code Examples
+
+### Using Pre-Confirmations when Submitting a Transfer
+
+The following example sends a transfer, waits for the pre-confirmation success, and then submits another transfer using the resolved outputs from the first:
+
+<<< @./snippets/pre-confirmation/send-transaction.ts#pre-confirmation-send-transaction-1{ts:line-numbers}
+
+### Using Pre-Confirmations with a Contract Call
+
+This example performs a contract call, waits for pre-confirmation success, and then uses the resolved output to execute another contract call:
+
+<<< @./snippets/pre-confirmation/contract-call.ts#pre-confirmation-contract-call-1{ts:line-numbers}
@@ -0,0 +1,61 @@
+import { Address, bn, OutputType, Provider, Wallet } from 'fuels';
+
+import { LOCAL_NETWORK_URL, WALLET_PVT_KEY } from '../../../../env';
+import { CounterFactory } from '../../../../typegend';
+
+const provider = new Provider(LOCAL_NETWORK_URL);
+
+const wallet = Wallet.fromPrivateKey(WALLET_PVT_KEY, provider);
+const baseAssetId = await provider.getBaseAssetId();
+const { waitForResult } = await new CounterFactory(wallet).deploy();
+const { contract } = await waitForResult();
+
+// #region pre-confirmation-contract-call-1
+// Send a contract call and retrieve the pre-confirmation callback
+const { waitForPreConfirmation } = await contract.functions
+  .increment_count(1)
+  .call();
+
+const {
+  transactionResult: { resolvedOutputs, isStatusPreConfirmationSuccess },
+} = await waitForPreConfirmation();
+
+// Check if the pre-confirmation status indicates success
+if (isStatusPreConfirmationSuccess) {
+  // Find the change output associated with the base asset ID
+  const resolvedChangeOutput = resolvedOutputs?.find(
+    (resolved) =>
+      resolved.output.type === OutputType.Change &&
+      resolved.output.assetId === baseAssetId
+  );
+
+  // If we find the change output, we can use it to create a new transaction
+  if (resolvedChangeOutput) {
+    const { output, utxoId } = resolvedChangeOutput;
+
+    // Create a new transaction request for a new contract call
+    const request = await contract.functions
+      .increment_count(1)
+      .txParams({
+        maxFee: 100_000,
+        gasLimit: 100_000,
+      })
+      .getTransactionRequest();
+
+    // Add the change output as an input resource for the new transaction
+    request.addResource({
+      id: utxoId,
+      assetId: output.assetId,
+      amount: output.amount,
+      owner: new Address(output.to),
+      blockCreated: bn(0),
+      txCreatedIdx: bn(0),
+    });
+
+    // Send the new transaction
+    await wallet.sendTransaction(request);
+  }
+}
+// #endregion pre-confirmation-contract-call-1
+
+console.log('isPreConfirmationStatusSuccess', isStatusPreConfirmationSuccess);
@@ -0,0 +1,73 @@
+import {
+  Address,
+  bn,
+  OutputType,
+  Provider,
+  ScriptTransactionRequest,
+  Wallet,
+} from 'fuels';
+
+import {
+  LOCAL_NETWORK_URL,
+  WALLET_PVT_KEY,
+  WALLET_PVT_KEY_2,
+  WALLET_PVT_KEY_3,
+} from '../../../../env';
+
+// #region pre-confirmation-send-transaction-1
+const provider = new Provider(LOCAL_NETWORK_URL);
+
+const wallet = Wallet.fromPrivateKey(WALLET_PVT_KEY, provider);
+const recipient1 = Wallet.fromPrivateKey(WALLET_PVT_KEY_2, provider);
+const recipient2 = Wallet.fromPrivateKey(WALLET_PVT_KEY_3, provider);
+const baseAssetId = await provider.getBaseAssetId();
+
+// Send a transfer and retrieve the pre-confirmation callback
+const { waitForPreConfirmation } = await wallet.transfer(
+  recipient1.address,
+  1000
+);
+
+// Wait for the transaction to reach a pre-confirmation status
+const { resolvedOutputs, isStatusPreConfirmationSuccess } =
+  await waitForPreConfirmation();
+
+// Check if the pre-confirmation status indicates success
+if (isStatusPreConfirmationSuccess) {
+  // Find the change output associated with the base asset ID
+  const resolvedChangeOutput = resolvedOutputs?.find(
+    (resolved) =>
+      resolved.output.type === OutputType.Change &&
+      resolved.output.assetId === baseAssetId
+  );
+
+  // If we find the change output, we can use it to create a new transaction
+  if (resolvedChangeOutput) {
+    const { output, utxoId } = resolvedChangeOutput;
+
+    // Create a new transaction request
+    const newTransaction = new ScriptTransactionRequest({
+      maxFee: 1000,
+      gasLimit: 1000,
+    });
+
+    // Add the change output as an input resource for the new transaction
+    newTransaction.addResource({
+      id: utxoId,
+      assetId: output.assetId,
+      amount: output.amount,
+      owner: new Address(output.to),
+      blockCreated: bn(0),
+      txCreatedIdx: bn(0),
+    });
+
+    // Define the transfer recipient of the new transaction
+    newTransaction.addCoinOutput(recipient2.address, 1000, baseAssetId);
+
+    // Send the new transaction
+    await wallet.sendTransaction(newTransaction);
+  }
+}
+// #endregion pre-confirmation-send-transaction-1
+
+console.log('isPreConfirmationStatusSuccess', isStatusPreConfirmationSuccess);
@@ -340,6 +340,9 @@ describe('Account', () => {
 
     expect(sendTransaction.mock.calls.length).toEqual(1);
     expect(sendTransaction.mock.calls[0][0]).toEqual(transactionRequest);
+    expect(sendTransaction.mock.calls[0][1], 'Should have default parameters').toEqual({
+      estimateTxDependencies: false,
+    });
   });
 
   it('should execute simulateTransaction just fine', async () => {
 
@@ -122,6 +122,85 @@ fragment SqueezedOutStatusFragment on SqueezedOutStatus {
   reason
 }
 
+fragment PreconfirmationSuccessStatusFragment on PreconfirmationSuccessStatus {
+  type: __typename
+  totalGas
+  totalFee
+  resolvedOutputs {
+    utxoId
+    output {
+      type: __typename
+      ... on CoinOutput {
+        to
+        amount
+        assetId
+      }
+      ... on ContractOutput {
+        inputIndex
+        balanceRoot
+        stateRoot
+      }
+      ... on ChangeOutput {
+        to
+        amount
+        assetId
+      }
+      ... on VariableOutput {
+        to
+        amount
+        assetId
+      }
+      ... on ContractCreated {
+        contract
+        stateRoot
+      }
+    }
+  }
+  preconfirmationReceipts: receipts {
+    ...receiptFragment
+  }
+}
+
+fragment PreconfirmationFailureStatusFragment on PreconfirmationFailureStatus {
+  type: __typename
+  reason
+  totalGas
+  totalFee
+  resolvedOutputs {
+    utxoId
+    output {
+      type: __typename
+      ... on CoinOutput {
+        to
+        amount
+        assetId
+      }
+      ... on ContractOutput {
+        inputIndex
+        balanceRoot
+        stateRoot
+      }
+      ... on ChangeOutput {
+        to
+        amount
+        assetId
+      }
+      ... on VariableOutput {
+        to
+        amount
+        assetId
+      }
+      ... on ContractCreated {
+        contract
+        stateRoot
+      }
+    }
+  }
+  preconfirmationReceipts: receipts {
+    ...receiptFragment
+  }
+}
+
 fragment transactionStatusFragment on TransactionStatus {
   ... on SubmittedStatus {
     ...SubmittedStatusFragment
@@ -196,6 +275,12 @@ fragment transactionStatusSubscriptionFragment on TransactionStatus {
   ... on SqueezedOutStatus {
     ...SqueezedOutStatusFragment
   }
+  ... on PreconfirmationSuccessStatus {
+    ...PreconfirmationSuccessStatusFragment
+  }
+  ... on PreconfirmationFailureStatus {
+    ...PreconfirmationFailureStatusFragment
+  }
 }
 
 fragment transactionFragment on Transaction {
@@ -592,6 +677,12 @@ query getTransactionWithReceipts($transactionId: TransactionId!) {
       ... on SqueezedOutStatus {
         ...SqueezedOutStatusFragment
       }
+      ... on PreconfirmationSuccessStatus {
+        ...PreconfirmationSuccessStatusFragment
+      }
+      ... on PreconfirmationFailureStatus {
+        ...PreconfirmationFailureStatusFragment
+      }
     }
   }
 }
@@ -1042,14 +1133,28 @@ query getConsensusParametersVersion {
   }
 }
 
-subscription submitAndAwaitStatus($encodedTransaction: HexString!) {
-  submitAndAwaitStatus(tx: $encodedTransaction) {
+subscription submitAndAwaitStatus(
+  $encodedTransaction: HexString!
+  $estimatePredicates: Boolean
+  $includePreConfirmation: Boolean
+) {
+  submitAndAwaitStatus(
+    tx: $encodedTransaction
+    estimatePredicates: $estimatePredicates
+    includePreconfirmation: $includePreConfirmation
+  ) {
     ...transactionStatusSubscriptionFragment
   }
 }
 
-subscription statusChange($transactionId: TransactionId!) {
-  statusChange(id: $transactionId) {
+subscription statusChange(
+  $transactionId: TransactionId!
+  $includePreConfirmation: Boolean
+) {
+  statusChange(
+    id: $transactionId
+    includePreconfirmation: $includePreConfirmation
+  ) {
     ...transactionStatusSubscriptionFragment
   }
 }
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +---
 +---
++
 +feat: add support for pre-confirmations