Reference → Airnode → v0.15 → PackagesAirnode 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 npm
# npm
npm install --save @api3/airnode-abiUsage
encode
Accepts an array of objects with the following required keys:
type- The full list of accepted types can be found in the Airnode ABI specifications doc.namevalue
It is important to note that numeric values (int256 and uint256) should be submitted as strings in order to preserve precision.
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.
import { decode } from '@api3/airnode-abi';
const encodedData = '0x...';
const decoded = decode(encodedData);
console.log(decoded);
// { from: 'ETH', amount: ethers.BigNumber.from('100000') }