Performance

Evolution SDK provides several configuration options to optimize transaction building for different use cases.

Coin Selection Algorithms

Algorithm	Strategy	Status
`"largest-first"`	Select largest UTxOs first, fewer inputs	Available
`"random-improve"`	Random selection with improvement	Planned
Custom function	Your own selection logic	Available

The default algorithm is "largest-first". You can also provide a custom coin selection function:

import { , , ,  } from "@evolution-sdk/evolution"

const  = .()
  .({
    : "https://cardano-preprod.blockfrost.io/api/v0",
    : ..!
  })
  .({ : ..!, : 0 })

const  = await 
  .()
  .({
    : .(
      "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae"
    ),
    : .(2_000_000n)
  })
  .({ : "largest-first" })

UTxO Optimization (Unfrack)

The unfrack option optimizes your wallet's UTxO structure during transaction building:

import { , , ,  } from "@evolution-sdk/evolution"

const  = .()
  .({
    : "https://cardano-preprod.blockfrost.io/api/v0",
    : ..!
  })
  .({ : ..!, : 0 })

const  = await 
  .()
  .({
    : .("addr_test1vrm9x2dgvdau8vckj4duc89m638t8djmluqw5pdrFollw8qd9k63"),
    : .(2_000_000n)
  })
  .({
    : {
      : {
        /* token bundling options */
      },
      : {
        /* ADA consolidation/subdivision options */
      }
    }
  })

Debug Mode

Enable debug logging to inspect the build process:

.build({ debug: true })

This logs progress and state at each build phase, helping diagnose issues with coin selection, balancing, and script evaluation.

Next Steps

Architecture — Build phases and pipeline
Custom Providers — Provider implementation

Performance

Performance

Coin Selection Algorithms

UTxO Optimization (Unfrack)

Debug Mode

Next Steps

On this page