A library for 1inch v4 DeFi aggregator API.
1inch-api-v4
Deprecated
Latest updated version of this package: link
Introduction
- Decentralised Exchange (DEX) 1inch has unveiled its ‘V4 router’ in a bid to make swaps and trades cheaper than competing platforms like Uniswap and SushiSwap on Ethereum.
- Version 4 of the 1inch router brings “several major improvements” to the DEX including cheaper swaps via lower gas costs, improved RFQ swaps and the introduction of ‘DAI-standard permits’.
- According to 1inch, this will make swaps with the 1inch Router v4 “on average 5.4% cheaper than the same swaps made directly on DEXes, such as Uniswap” – a much-needed improvement to the rising cost of gas fees on Ethereum.
Features
- Full API coverage.
- Typescript support.
- Fully covered with annotations and comments.
Installing
Using npm:npm i @normalizex/1inch-api-v4yarn add @normalizex/1inch-api-v4Documentation
- You can find full documentation in the folder docs/README.md
Usage:
NodeJS (ES6):import OneInchApi, { InchV4Chains } from '@normalizex/1inch-api-v4';
const Inch = new OneInchApi(InchV4Chains.Ethereum);const { InchV4Chains, OneInchApi } = require('@normalizex/1inch-api-v4');
const Inch = new OneInchApi(InchV4Chains.Ethereum);Example
import OneInchApi, { InchV4Chains } from "@normalizex/1inch-api-v4";
const Inch = new OneInchApi(InchV4Chains.Ethereum);
const BUSD = '0xe9e7cea3dedca5984780bafc599bd69add087d56'; const WETH = '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'; const WalletAddress = '0x35552CF3Ce8Cc8a0f7fdC8Aa88a89b92e9Ab5FdB';
// EXAMPLES inch.chain();// return 1 inch.swithChain(InchV4Chains.BinanceSmartChain); inch.chain();// return 56
Inch.allowance(BUSD, WalletAddress).then(data => { //return "0" });
Inch.approveSpender().then(data => { //0x1111111254fb6c44bac0bed2854e76f90643097d });
Inch.approveTransaction(BUSD).then(data => { /** { data: '0x095ea7b30000000000000000000000001111111254fb6c44bac0bed2854e76f90643097dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff', gasPrice: '15000000000', to: '0xe9e7cea3dedca5984780bafc599bd69add087d56', value: '0' } */ });
Inch.healtcheck().then(data => { // { status: 'OK' } });
Inch.liquiditySources().then(data => { /** [ { id: 'BSCBISWAP', title: 'biswap', img: 'https://cdn.1inch.io/liquidity-sources-logo/biswap.png', imgcolor: 'https://cdn.1inch.io/liquidity-sources-logo/biswapcolor.png' } ...AND MORE ITEMS... ] */ });
Inch.presets().then(data => { /** { MAX_RESULT: [ { complexityLevel: 2, mainRouteParts: 10, parts: 50, virtualParts: 50 } ], LOWEST_GAS: [ { complexityLevel: 0, mainRouteParts: 1, parts: 1, virtualParts: 1 }, { complexityLevel: 1, mainRouteParts: 1, parts: 1, virtualParts: 1 } ] } */ });
Inch.tokens().then(data => { /** [ { symbol: 'DOS', name: 'DOS Network Token BEP20', decimals: 18, address: '0xdc0f0a5719c39764b011edd02811bd228296887c', logoURI: 'https://tokens.1inch.io/0x0a913bead80f321e7ac35285ee10d9d922659cb7.png' }, ... 284 more items ] */ });
Inch.quote(BUSD, WETH, 50 * 1e18).then(data => { /** { fromToken: { symbol: 'BUSD', name: 'BUSD Token', decimals: 18, address: '0xe9e7cea3dedca5984780bafc599bd69add087d56', logoURI: 'https://tokens.1inch.io/0x4fabb145d64652a948d72533023f6e7a623c7c53.png' }, toToken: { symbol: 'BNB', name: 'BNB', decimals: 18, address: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', logoURI: 'https://tokens.1inch.io/0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c_1.png' }, toTokenAmount: '125276691940480656', fromTokenAmount: '50000000000000000000', protocols: [ [ [Array] ] ], estimatedGas: 252364 } */ });
Donate
Of course, the project was made not for any benefit, but for my personal convenience :)But I wanted to share this convenience with the Github community.
You can send me any amount of any coins in the ETH / BSC network as a donation to the address: 0x35552CF3Ce8Cc8a0f7fdC8Aa88a89b92e9Ab5FdB
