encodeFunctionResult
Encodes structured return data into ABI encoded data. It is the opposite of decodeFunctionResult.
Install
ts
import { encodeFunctionResult } from 'viem';import { encodeFunctionResult } from 'viem';Usage
Given an ABI (abi) and a function (functionName), pass through the values (values) to encode:
ts
import { encodeFunctionResult } from 'viem';
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});
// '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'import { encodeFunctionResult } from 'viem';
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});
// '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'ts
export const wagmiAbi = [
...
{
inputs: [{ name: 'tokenId', type: 'uint256' }],
name: 'ownerOf',
outputs: [{ name: '', type: 'address' }],
stateMutability: 'view',
type: 'function',
},
...
] as const;export const wagmiAbi = [
...
{
inputs: [{ name: 'tokenId', type: 'uint256' }],
name: 'ownerOf',
outputs: [{ name: '', type: 'address' }],
stateMutability: 'view',
type: 'function',
},
...
] as const;ts
import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
export const publicClient = createPublicClient({
chain: mainnet,
transport: http(),
});import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
export const publicClient = createPublicClient({
chain: mainnet,
transport: http(),
});A more complex example
ts
import { decodeFunctionResult } from 'viem'
const data = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'getInfo',
value: [
{
foo: {
sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
x: 69420n,
y: true
},
sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
z: 69
}
]
})
// 0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000010f2c0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000000045import { decodeFunctionResult } from 'viem'
const data = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'getInfo',
value: [
{
foo: {
sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
x: 69420n,
y: true
},
sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
z: 69
}
]
})
// 0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000010f2c0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000000045ts
export const wagmiAbi = [
...
{
inputs: [],
name: 'getInfo',
outputs: [
{
components: [
{
components: [
{
name: 'sender',
type: 'address',
},
{
name: 'x',
type: 'uint256',
},
{
name: 'y',
type: 'bool',
},
],
name: 'foo',
type: 'tuple',
},
{
name: 'sender',
type: 'address',
},
{
name: 'z',
type: 'uint32',
},
],
name: 'res',
type: 'tuple',
},
],
stateMutability: 'pure',
type: 'function',
},
...
] as const;export const wagmiAbi = [
...
{
inputs: [],
name: 'getInfo',
outputs: [
{
components: [
{
components: [
{
name: 'sender',
type: 'address',
},
{
name: 'x',
type: 'uint256',
},
{
name: 'y',
type: 'bool',
},
],
name: 'foo',
type: 'tuple',
},
{
name: 'sender',
type: 'address',
},
{
name: 'z',
type: 'uint32',
},
],
name: 'res',
type: 'tuple',
},
],
stateMutability: 'pure',
type: 'function',
},
...
] as const;ts
import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
export const publicClient = createPublicClient({
chain: mainnet,
transport: http(),
});import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
export const publicClient = createPublicClient({
chain: mainnet,
transport: http(),
});Without functionName
If your abi contains only one ABI item, you can omit the functionName (it becomes optional):
ts
import { encodeFunctionResult } from 'viem';
const abiItem = {
inputs: [{ name: 'owner', type: 'address' }],
name: 'balanceOf',
outputs: [{ name: '', type: 'uint256' }],
stateMutability: 'view',
type: 'function',
}
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});
// '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'import { encodeFunctionResult } from 'viem';
const abiItem = {
inputs: [{ name: 'owner', type: 'address' }],
name: 'balanceOf',
outputs: [{ name: '', type: 'uint256' }],
stateMutability: 'view',
type: 'function',
}
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});
// '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'Return Value
The decoded data. Type is inferred from the ABI.
Parameters
abi
- Type:
Abi
The contract's ABI.
ts
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});functionName
- Type:
string
The function to encode from the ABI.
ts
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});values
- Type:
Hex
Return values to encode.
ts
const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});const data = encodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
value: ['0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'],
});