encodeAbi #

Generates ABI encoded data using the ABI specification, given a set of ABI parameters (inputs/outputs) and their corresponding values.

The encodeAbi function is used by the other contract encoding utilities (ie. encodeFunctionData, encodeEventTopics, etc).

Import #

import { encodeAbi } from 'viem/contract'

Usage #

The encodeAbi function accepts:

• a set of parameters (params), in the shape of the inputs or outputs attribute of an ABI event/function.
• a set of values (values) that correspond to the given params.

import { encodeAbi } from 'viem/contract'

const encodedData = encodeAbi({
  params: [{ name: 'x', type: 'uint32' }],
  values: [69420]
})
// 0x0000000000000000000000000000000000000000000000000000000000010f2c

Returns #

Hex

The ABI encoded data.

Parameters #

params #

• Type: AbiParameter[]

The set of ABI parameters to encode, in the shape of the inputs or outputs attribute of an ABI event/function.

These parameters must include valid ABI types.

encodeAbi({
  params: [{ name: 'x', type: 'uint32' }], 
  values: [69420]
})

values #

• Type: AbiParametersToPrimitiveTypes<AbiParameter[]>

The set of primitive values that correspond to the ABI types defined in params.

encodeAbi({
  params: [{ name: 'x', type: 'uint32' }],
  values: [69420] 
})

More Examples #

Simple struct #

import { abi } from './abi'

const encodedData = encodeAbi({
  params: abi[0].inputs,
  values: [{
    x: 420n,
    y: true,
    z: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
  }],
})
// 0x00000000000000000000000000000000000000000000000000000000000001a40000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac

export const abi = [
  {
    name: 'staticStruct',
    inputs: [
      {
        components: [
          {
            name: 'x',
            type: 'uint256',
          },
          {
            name: 'y',
            type: 'bool',
          },
          {
            name: 'z',
            type: 'address',
          },
        ],
        name: 'foo',
        type: 'tuple',
      },
    ],
  }
] as const

contract Example {
  struct Foo {
    uint256 x;
    bool y;
    address z;
  }

  function staticStruct(Foo calldata foo) { ... }
}