Skip to main content
This page provides gas consumption benchmarks for TON wallet contracts,
measured in both sandbox (local testing) and on-chain (testnet) environments.

Single transfers

Gas costs vary between sandbox and on-chain due to different VM configurations, but the relative comparison between wallet versions remains consistent.

Batch transfers

Total cost

Key insights:
  • V5 has higher gas overhead for single transfers (+65% vs V3) but becomes efficient with batch operations. Supports up to 255 messages per transaction.
  • Highload V3 is expensive for single transfers but becomes highly efficient at scale:
    • Gas cost doesn’t change with the number of messages in a batch
    • 100 messages: ~79 gas/msg
    • Designed for handling thousands of transactions

Methodology

Sandbox measurements:

Framework: Blueprint + @ton/sandbox
Wallets: implementations from @ton/ton (V3R2, V4, V5R1) and Highload V3 sources
Test scenario: Simple transfer of 0.01 TON with PAY_GAS_SEPARATELY mode

On-chain measurements:

Network: TON testnet
Wallets: Same implementations as sandbox
Measurement: Actual transaction gas consumption from explorer data

Use case recommendations

Based on cost-effectiveness: For retail users (1-10 transactions/day):
  • Use V3 or V4 — most cost-effective for single transfers (2,994 gas baseline)
  • V5 adds 65% gas overhead for single transfers but provides modern features
  • Total cost difference negligible for low volume; choose based on feature needs
For moderate volume (10-100 transactions/day):
  • Use V5 for batch operations — 6% savings vs V3 for 12-message batches
  • Single V5 batch (255 msgs) more efficient than multiple V3/V4 batches
  • V5 supports up to 255 messages per transaction vs V3/V4 limit of 4
For high volume (100+ transactions/day):
  • Highload V3 becomes efficient with large batches
  • Designed for exchanges and payment processors (different processing approach)
  • Gas cost remains constant regardless of batch size (unlike V3/V4/V5)
  • Note: Uses 2-transaction approach resulting in ~1.8x higher forward fees
Gas comparison for batching:
  • Highload V3: 7956 gas per batch (flat cost regardless of batch size)
  • V5: ~1,069 gas/message for 12 messages (scales down with larger batches)
  • V3/V4: ~1,230 gas/message (limited to 4 messages per batch)

Code examples

Check gas-research and tolk-bench projects for code examples. Key features of the gas-research testing suite:
  • Comprehensive gas and fee breakdown analysis
  • Automated benchmarking across all wallet versions
  • Fee calculation helpers for precise cost analysis