Abi.decodeData

import { Abi } from '@tevm/voltaire/Abi';
import { Hex } from '@tevm/voltaire/Hex';

const abi = Abi([
  {
    type: 'function',
    name: 'transfer',
    stateMutability: 'nonpayable',
    inputs: [
      { type: 'address', name: 'to' },
      { type: 'uint256', name: 'amount' }
    ],
    outputs: [{ type: 'bool' }]
  }
] as const);

const calldata = Hex.toBytes(
  '0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b844bc9e7595f51e3e' +
  '00000000000000000000000000000000000000000000000000000000000003e8'
);

const decoded = abi.decodeData(calldata);
// { functionName: 'transfer', args: ['0x742d35...', 1000n] }

import { Abi, AbiItemNotFoundError, AbiInvalidSelectorError } from '@tevm/voltaire/Abi';

try {
  abi.decodeData(calldata);
} catch (error) {
  if (error instanceof AbiInvalidSelectorError) {
    console.error('Calldata too short to contain a selector');
  }
  if (error instanceof AbiItemNotFoundError) {
    console.error('Unknown function selector');
  }
}

const transferFn = abi.getFunction('transfer');
const args = Abi.Function.decodeParams(transferFn, calldata);
// or
const params = Abi.decodeParameters(transferFn.inputs, calldata.slice(4));