Transaction Lifecycle

​

Lifecycle Overview

Complete transaction lifecycle showing all stages from initiation to completion

​

Stage Progression

​

TON-Side Stages

​

Sequencer Processing Stages

​

EVM Execution Stages

​

Return Path Stages (If Applicable)

​

Operation Types

​

Timing and Performance

​

Typical Timeframes

​

Factors Affecting Speed

• Epoch Duration: The length of sequencer processing windows directly affects how quickly transactions progress through consensus stages.
• Network Participation: Higher sequencer participation generally leads to faster consensus formation and execution.
• Target Chain Congestion: Busy periods on either TON or TAC EVM can slow execution stages.
• Operation Complexity: Simple operations process faster than complex multi-token or multi-contract interactions.

​

Status Tracking

​

Simplified Status Tracking

const tracker = new OperationTracker(Network.TESTNET);
const status = await tracker.getSimplifiedOperationStatus(transactionLinker);

switch (status) {
  case "PENDING":
    // Transaction is progressing through stages
    break;
  case "SUCCESSFUL":
    // Operation completed successfully
    break;
  case "FAILED":
    // Operation failed and assets were rolled back
    break;
  case "OPERATION_ID_NOT_FOUND":
    // Transaction not yet detected by sequencers
    break;
}

​

Detailed Stage Tracking

const operationId = await tracker.getOperationId(transactionLinker);
const detailedStatus = await tracker.getOperationStatus(operationId);

console.log(`Current stage: ${detailedStatus.stage}`);
console.log(`Success status: ${detailedStatus.success}`);
console.log(`Stage timestamp: ${new Date(detailedStatus.timestamp * 1000)}`);

​

Performance Profiling

const stageProfile = await tracker.getStageProfiling(operationId);

// Shows timing for each completed stage
Object.keys(stageProfile).forEach((stageName) => {
  if (stageName === "operationType") return;

  const stage = stageProfile[stageName];
  if (stage.exists) {
    console.log(`${stageName}: ${stage.stageData.timestamp}`);
  }
});

​

Error Handling Throughout the Lifecycle

​

Pre-Execution Validation

​

Execution-Time Errors

• EVM Execution Failures: If target contract calls fail on TAC EVM, the system automatically initiates rollback procedures.
• Timeout Handling: Operations that don’t complete within expected timeframes trigger timeout procedures.
• Network Issues: Temporary network problems are handled through retry mechanisms and status preservation.

​

Comprehensive Rollback System

​

Rollback Merkle Tree Creation

​

Automatic Asset Recovery

• Locked assets on TON blockchain automatically released to original owners
• No manual intervention required from users or developers
• Asset amounts precisely match original transaction parameters
• Recovery transactions include original transaction references for auditability

• Users always have clear outcome: successful execution OR safe asset return
• Eliminates fund loss risk from transaction failures
• Maintains user confidence in cross-chain interactions
• Transparent failure communication with detailed error reporting

​

Monitoring and Debugging

​

Real-Time Monitoring

async function monitorTransaction(transactionLinker) {
  const tracker = new OperationTracker(Network.TESTNET);

  // Poll for operation ID
  let operationId = null;
  while (!operationId) {
    operationId = await tracker.getOperationId(transactionLinker);
    if (!operationId) {
      await new Promise((resolve) => setTimeout(resolve, 5000));
    }
  }

  // Monitor until completion
  let completed = false;
  while (!completed) {
    const status = await tracker.getOperationStatus(operationId);

    // Update UI with current status
    updateUserInterface(status);

    // Check for completion
    if (status.stage === "EXECUTED_IN_TON" || !status.success) {
      completed = true;
    } else {
      await new Promise((resolve) => setTimeout(resolve, 10000));
    }
  }
}

​

Debugging Failed Transactions

• Status Analysis: Detailed status information helps identify where transactions failed and why.
• Stage Timing: Performance profiling can reveal if transactions are stuck at particular stages.
• Error Messages: When available, error messages provide specific information about failure causes.
• Asset Tracking: Applications can verify that rollback procedures properly returned user assets.

​

Best Practices for Developers

​

User Experience Design

​

Integration Patterns

• Status Webhooks: For applications that need server-side monitoring, implement webhook endpoints for status updates.
• Background Processing: Handle long-running transaction monitoring in background processes rather than blocking user interfaces.
• Retry Logic: Implement appropriate retry logic for temporary network issues while avoiding excessive API usage.

​

What’s Next?