Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.biconomy.io/llms.txt

Use this file to discover all available pages before exploring further.

Runtime injection gives developers a powerful way to compose transactions when some values — like token amounts — aren’t known until execution time. This is a major evolution beyond traditional static batching, where all parameters must be known upfront. Instead of asking users to guess or estimate how much will arrive after a bridge or swap, AbstractJS lets you define placeholders — runtime values — that get resolved dynamically when the transaction is executed.

​
Why It Matters

Traditional transaction batching is rigid:
  • You must hardcode every parameter
  • You can’t adapt to bridges, swaps, or slippage
  • You often over- or under-estimate received amounts
With runtime injection, orchestration becomes adaptive:
  • Use actual token balances at the moment of execution
  • Protect users with constraints (e.g. slippage limits)
  • Compose flows across chains with fewer assumptions
This eliminates entire classes of user experience problems and makes your apps more reliable.

​
Basic Usage

import { runtimeERC20BalanceOf } from "@biconomy/abstractjs";
import { balanceNotZeroConstraint } from "../utils/balanceNotZero.util";

const swapInstruction = await oNexus.buildComposable({
  type: "default",
  data: {
    chainId: optimism.id,
    to: "0xProtocolAddress",
    abi: protocolAbi,
    functionName: "swap",
    args: [
      runtimeERC20BalanceOf({
        tokenAddress: "0xTokenAddress",
        targetAddress: nexusAddress,
        constraints: [balanceNotZeroConstraint]
      })
    ]
  }
});

​
Available Runtime Functions

FunctionDescriptionIntroduced in
runtimeERC20BalanceOfInject the ERC20 balance of a target address at runtimeMEE v1.0.0
runtimeNativeBalanceOfInject the native token balance of a target address at runtimeMEE v2.2.0
runtimeERC20AllowanceOfInject the ERC20 token allowanceMEE v1.0.0
runtimeParamViaCustomStaticCallInject any return data (up to 32 bytes in size) at runtimeMEE v2.2.0
⚠️ To access latest functions, please use according MEE Version as described here. Please refer to the Supported Chains page to learn where MEE 2.2.0 is currently supported.

​
runtimeERC20BalanceOf

Inject the token balance of an address — most often your orchestrator address — at the time of execution. 
import { balanceNotZeroConstraint } from "../utils/balanceNotZero.util";

const transferAll = await mcNexus.buildComposable({
  type: "default",
  data: {
    to: tokenContract,
    abi: erc20Abi,
    functionName: "transfer",
    args: [
      recipient,
      runtimeERC20BalanceOf({
        tokenAddress: tokenAddress,
        targetAddress: mcNexus.addressOn(chain.id),
        constraints: [balanceNotZeroConstraint]
      })
    ],
    chainId: chain.id
  }
});

​
runtimeNativeBalanceOf

Inject the native token balance of an address — most often your orchestrator address — at the time of execution. 
import { balanceNotZeroConstraint } from "../utils/balanceNotZero.util";

const transferAll = await mcNexus.buildComposable({
  type: "nativeTokenTransfer",
  data: {
    to: receiverAddress,
    value: runtimeNativeBalanceOf({
            targetAddress: orchestratorAddress
          }),
    chainId: chain.id
  }
});

​
runtimeERC20AllowanceOf

Inject the ERC20 token allowance between two addresses at the time of execution. This is useful when you need to check or use allowances dynamically. 
const transferAll = await mcNexus.buildComposable({
  type: "default",
  data: {
    to: tokenContract,
    abi: erc20Abi,
    functionName: "transferFrom",
    args: [
      owner,
      recipient,
      runtimeERC20AllowanceOf({
        owner,
        spender: orchestratorAddress,
        tokenAddress: tokenAddress,
        constraints: []
      })
    ],
    chainId: chain.id
  }
});

​
runtimeParamViaCustomStaticCall

Allows to execute an arbitrary READ (static) call on-chain, and use the return of this call as an input argument. Return data should be up to 32 bytes: address, bytes32, uintXXX Solidity types are expected. 
const runtimeReceiver = runtimeParamViaCustomStaticCall({
  targetContractAddress,
  functionAbi: targetAbi,
  functionName: "pauser",
  args: []
})

const transferInstruction = await mcNexus.buildComposable({
  type: "nativeTokenTransfer",
  data: {
    to: runtimeReceiver,
    value: amount,
    chainId: chain.id
  }
})

​
Constraints = Execution Control

Constraints ensure that runtime-injected values meet specific criteria. If constraints are not met, the instruction will not execute. But even more importantly — they determine when instructions will execute. This is key for cross-chain orchestration.

​
Transaction Ordering

When a runtime value is used, the orchestration system will wait until all constraints are satisfied before executing. This means constraints enforce dependency: 
await oNexus.buildComposable({
  chainId: optimism.id,
  args: [
    runtimeERC20BalanceOf({
      tokenAddress: usdcOnOptimism,
      targetAddress: nexusAddress,
      constraints: [balanceNotZeroConstraint]
    })
  ]
});
This instruction won’t execute until nexusAddress has a non-zero balance of USDC. In multi-chain orchestration, this is the mechanism that controls execution sequencing.

​
Handling Slippage

constraints: [
  greaterThanOrEqualTo((expectedAmount * 90n) / 100n)
]
Use constraints to ensure execution only proceeds under acceptable conditions.

​
Safety Nets

Constraints act like assert statements. If the value isn’t good — don’t execute.

​
Cross-Chain Example

import { balanceNotZeroConstraint } from "../utils/balanceNotZero.util";

// Step 1: Bridge
const bridgeInstruction = await oNexus.buildComposable({
  // bridging config
});

// Step 2: Wait for funds, then swap
const swapInstruction = await oNexus.buildComposable({
  type: "default",
  data: {
    chainId: optimism.id,
    to: "0xSwapProtocol",
    abi: swapAbi,
    functionName: "swapExactTokensForTokens",
    args: [
      runtimeERC20BalanceOf({
        tokenAddress: usdcOnOptimism,
        targetAddress: nexusAddress,
        constraints: [balanceNotZeroConstraint]
      })
    ]
  }
});
How this works:
  1. MEE simulates the swap instruction
  2. Simulation fails (no tokens yet)
  3. MEE waits and retries
  4. Bridge completes
  5. Constraints satisfied → transaction proceeds

​
Best Practices

Use runtime injection when values are unknown ahead of time
Always apply constraints to protect users and define execution rules
Use with transfer instructions to sweep remaining balances
Design for graceful failure if constraints aren’t met

​
How It Works

AbstractJS builds orchestration callData with placeholders. During execution:
  1. The smart account receives executeComposable()
  2. The fallback handler reads blockchain state
  3. Runtime values are injected into calldata
  4. The final transaction executes with those resolved parameters
This eliminates the need for custom smart contracts or multi-step user flows. Composable Fallback Handler

​
Summary

Runtime injection turns your orchestration flows into state-aware, auto-sequencing logic that adapts to bridge results, swap outputs, slippage conditions, and more. Use it when:
  • You’re building cross-chain workflows
  • You can’t predict output values
  • You want fewer failures and better UX