decodeFunctionResult
Decodes the result of a function call on a contract.
Install
ts
import { decodeFunctionResult } from 'viem'import { decodeFunctionResult } from 'viem'Usage
Given an ABI (abi) and a function (functionName), pass through the encoded calldata (data) to retrieve the decoded value:
ts
import { decodeFunctionResult } from 'viem'
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})
// '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'import { decodeFunctionResult } from 'viem'
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})
// '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'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()
})Without functionName
If your abi contains only one ABI item, you can omit the functionName (it becomes optional):
ts
import { decodeFunctionResult } from 'viem'
const abiItem = {
inputs: [{ name: 'tokenId', type: 'uint256' }],
name: 'ownerOf',
outputs: [{ name: '', type: 'address' }],
stateMutability: 'view',
type: 'function',
}
const value = decodeFunctionResult({
abi: [abiItem],
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})
// '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'import { decodeFunctionResult } from 'viem'
const abiItem = {
inputs: [{ name: 'tokenId', type: 'uint256' }],
name: 'ownerOf',
outputs: [{ name: '', type: 'address' }],
stateMutability: 'view',
type: 'function',
}
const value = decodeFunctionResult({
abi: [abiItem],
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})
// '0xa5cc3c03994db5b0d9a5eedd10cabab0813678ac'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 value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'getInfo',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000010f2c0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000000045'
})
/**
* {
* foo: {
* sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
* x: 69420n,
* y: true
* },
* sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
* z: 69
* }import { decodeFunctionResult } from 'viem'
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'getInfo',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000010f2c0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac0000000000000000000000000000000000000000000000000000000000000045'
})
/**
* {
* foo: {
* sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
* x: 69420n,
* y: true
* },
* sender: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
* z: 69
* }ts
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()
})Return Value
The decoded data. Type is inferred from the ABI.
Parameters
abi
- Type:
Abi
The contract's ABI.
ts
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})functionName
- Type:
string
The function to encode from the ABI.
ts
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})data
- Type:
Hex
The calldata.
ts
const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})const value = decodeFunctionResult({
abi: wagmiAbi,
functionName: 'ownerOf',
data: '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac'
})