@0x/0x-parser

0x-parser

Blockchain Support

Arbitrum	Avalanche	Base	BNB Chain	Celo	Ethereum	Fantom	Optimism	Polygon

Overview

This library is designed for 0x integrators, and it simplifies the complex task of parsing 0x transactions into a format that is both user-friendly and easy to understand. One of the challenges when swapping tokens is that the trade can experience slippage through Automated Market Makers (AMMs), making the final swap amounts difficult to predict prior to executing the trade. However, this library overcomes that challenge by parsing the transaction receipt and event logs to accurately identify the final swap amounts. Try the demo here.

Installation

npm install @0x/0x-parser

Usage

import { parseSwap } from "@0x/0x-parser";

async function main() {
  const response = await fetch(
    "https://raw.githubusercontent.com/0xProject/protocol/development/packages/contract-artifacts/artifacts/IZeroEx.json"
  );

  const IZeroEx = await response.json();

  const data = await parseSwap({
    rpcUrl: "https://eth.llamarpc.com",
    exchangeProxyAbi: IZeroEx.compilerOutput.abi,
    transactionHash: "0xd8637124d650268ae7680781809800e103a3a2bee9fec56083028fea6d98140b",
  });

  console.log(data);
}

main();

Examples

This repository includes examples you can execute locally. Navigate to the /examples directory for additional README information on how to run the demos locally. You can also explore a live demo of 0x-parser here.

Contributing

Contributions are always welcomed! Please read the contributing guidelines before submitting a pull request.

Changelog

0.6.0 (2023-08-31)

Features

• introduce viem + remove ethers (1432283)

Bug Fixes

• remove exchange proxy abi from bundle... (2b6e6f8)
• support multihop for sellToUniswap (5128e75)
• use native asset for parsers that need it (ae82504)