Batch Operations

Batch operations allow multiple transactions to be bundled and executed atomically in a single meta transaction, reducing gas costs and improving user experience.

Overview

Batch operations enable:

• Multiple actions in one transaction

• Atomic execution (all succeed or all fail)

• Significant gas savings

• Complex multi-step workflows

Supported Operations

Trading Operations

const batchTrade = [
  { action: 'swap', from: 'DI', to: 'DUSD', amount: '100' },
  { action: 'addLiquidity', tokenA: 'DUSD', tokenB: 'ETH', amountA: '50' },
  { action: 'stake', token: 'DI', amount: '200' }
]

Cross-Chain Operations

const crossChainBatch = [
  { action: 'bridge', from: 'ethereum', to: 'polygon', token: 'DI', amount: '500' },
  { action: 'swap', from: 'DI', to: 'MATIC', amount: '100' },
  { action: 'stake', token: 'MATIC', amount: '100' }
]

Batch Execution

Creating Batches

import { DIBatch } from '@di-network/sdk'

const batch = new DIBatch()
  .swap('DI', 'DUSD', '100')
  .addLiquidity('DUSD', 'ETH', '50', '0.1')
  .stake('DI', '200')

// Execute batch
const result = await batch.execute({ gasless: true })

Conditional Operations

const conditionalBatch = new DIBatch()
  .swap('DI', 'DUSD', '100')
  .if(result => result.outputAmount > '95') // Only if swap gets good rate
    .addLiquidity('DUSD', 'ETH', result.outputAmount, '0.1')
  .endif()

Gas Optimization

Batch Benefits

• Reduced Overhead: Single transaction setup cost

• Shared Context: Reuse of loaded contract state

• Optimized Routing: Smart order execution

Gas Savings Examples

Operation Type	Individual Gas	Batch Gas	Savings
3 Swaps	450,000	320,000	29%
Stake + Claim	180,000	140,000	22%
Bridge + Swap	280,000	220,000	21%

Advanced Features

Slippage Protection

const batch = new DIBatch()
  .swap('DI', 'DUSD', '100', { slippage: 0.5 })
  .swap('DUSD', 'ETH', 'all', { slippage: 1.0 })
  .setGlobalSlippage(2.0) // Fallback for entire batch

Deadline Management

const batch = new DIBatch()
  .setDeadline(Date.now() + 600000) // 10 minutes
  .swap('DI', 'DUSD', '100')
  .addLiquidity('DUSD', 'ETH', '50', '0.1')

Error Handling

try {
  const result = await batch.execute()
  console.log('Batch executed successfully:', result)
} catch (error) {
  if (error.type === 'BATCH_PARTIAL_FAILURE') {
    console.log('Some operations failed:', error.failures)
  }
}

Batch Types

Sequential Batches

Operations execute in order, with each depending on the previous:

const sequential = new DIBatch({ type: 'sequential' })
  .swap('DI', 'DUSD', '100')
  .useOutput(0) // Use output from first swap
  .addLiquidity('DUSD', 'ETH', 'previous', '0.1')

Parallel Batches

Independent operations that can execute simultaneously:

const parallel = new DIBatch({ type: 'parallel' })
  .swap('DI', 'DUSD', '50')
  .swap('DI', 'ETH', '50')
  .stake('DI', '100')

Integration Patterns

DeFi Strategies

// Yield farming strategy
const yieldBatch = new DIBatch()
  .swap('ETH', 'DI', '1.0')
  .stake('DI', 'all', { duration: '30d' })
  .claimRewards('DI_STAKING')
  .compound('rewards')

Portfolio Rebalancing

// Rebalance portfolio to target allocation
const rebalance = new DIBatch()
  .swap('DI', 'DUSD', '100') // Reduce DI exposure
  .swap('DUSD', 'ETH', '50')  // Increase ETH exposure
  .addLiquidity('DUSD', 'ETH', '25', '0.05') // LP remaining

Limitations

Size Limits

• Maximum 10 operations per batch

• Total gas limit: 8M gas units

• Maximum execution time: 5 minutes

Supported Contracts

Not all contracts support batch operations:

• Must implement IBatchable interface

• Require explicit batch operation support

• Some operations may be restricted

Failure Modes

• All-or-nothing: Entire batch fails if any operation fails

• Partial execution: Some operations may succeed before failure

• Gas estimation: May be inaccurate for complex batches

Best Practices

Batch Design

• Group related operations together

• Consider operation dependencies

• Test with small amounts first

• Monitor gas usage patterns

Error Prevention

• Validate inputs before batching

• Set appropriate slippage tolerances

• Use reasonable deadlines

• Handle partial failures gracefully