Skip to content
On this page
Reference → Airnode → v0.11 → Packages
SearchHighlight.vue
FLEX_START_TAG

Airnode ABI

The airnode-abi➚ package is a unique way to encode and decode parameters for use with Airnode. Parameters are provided with encoding types, names and values. The types are shortened and grouped with a version as the "header". The name/value pairs are then grouped and encoded as the rest of the body.

An advantage of encoding parameters this way is that parameters can be decoded natively using the language(s) of the specific blockchain. In the case of EVM blockchains, this means that parameters can be encoded as well as decoded in Solidity (or Vyper), without any additional requirements.

You can find additional documentation in Airnode ABI Specifications doc.

Installation

You can install @api3/airnode-abi➚ with either npm➚ or Yarn➚

sh
# npm
npm install --save @api3/airnode-abi

# Yarn
yarn add @api3/airnode-abi

Usage

encode

Accepts an array of objects with the following required keys:

  1. type - The full list of accepted types can be found in the Airnode ABI specifications doc.

  2. name

  3. value

It is important to note that numeric values (int256 and uint256) should be submitted as strings in order to preserve precision.

ts
import { encode } from '@api3/airnode-abi';

const parameters = [
  { type: 'string32', name: 'from', value: 'ETH' },
  { type: 'uint256', name: 'amount', value: '100000' },
];
const encodedData = encode(parameters);

console.log(encodedData);
// '0x...'

decode

Returns an object where the keys are the "names" and the values are the "values" from the initial encoding.

It is important to note that int256 and uint256 will be decoded back to strings.

ts
import { decode } from '@api3/airnode-abi';

const encodedData = '0x...';
const decoded = decode(encodedData);

console.log(decoded);
// { from: 'ETH', amount: ethers.BigNumber.from('100000') }
FLEX_END_TAG

Released under the MIT License.