Catalog npm
Back to packageRELEASE DETAILS

6.14.0

npm

@0x/asset-swapper

Convenience package for discovering and buying assets on-chain and off-chain.

Published12 May 2021
Direct dependencies62
Transitive dependenciesNot calculated

README

Current package documentation

@0x/asset-swapper

Convenience package for swapping assets represented on the Ethereum blockchain using 0x. The package helps to perform all the off-chain computations to execute a marketBuy or marketSell function execution with 0x exchange contracts, or 0x extension contracts. Given some liquidity (0x signed orders), it helps estimate the cost of buying or selling a certain asset (giving a range) and then provide varying consumable outputs to execute the buy or sell.

Asset-swapper integrates with the Standard Relayer API(in the future Mesh as well) and takes care of sourcing liquidity, order-pruning, and order-validation. The final result is a library that tells you what assets are available, provides a quote based on specified assets, and provide varying consumable metadata that can be used both on-chain in smart contracts or off-chain through web3 to swap a desired amount of ERC20 for another ERC20 asset.

Installation

yarn add @0x/asset-swapper

Import

import { SwapQuoter } from '@0x/asset-swapper';

or

var SwapQuoter = require('@0x/asset-swapper').SwapQuoter;
var SwapQuoteConsumer = require('@0x/asset-swapper').SwapQuoteConsumer;

If your project is in TypeScript, add the following to your tsconfig.json:

"compilerOptions": {
    "typeRoots": ["node_modules/@0x/typescript-typings/types", "node_modules/@types"],
}

Contributing

We welcome improvements and fixes from the wider community! To report bugs within this package, please create an issue in this repository.

Please read our contribution guidelines before getting started.

Install dependencies

If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:

yarn config set workspaces-experimental true

Then install dependencies

yarn install

Build

To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:

PKG=@0x/asset-swapper yarn build

Or continuously rebuild on change:

PKG=@0x/asset-swapper yarn watch

Clean

yarn clean

Lint

yarn lint

Run Tests

yarn test

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 63

Native requirements
62 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
axios
Environment
{
  "local_name": "axios",
  "alias": false,
  "peer_metadata": null
}
^0.21.1runtime
lodash
Environment
{
  "local_name": "lodash",
  "alias": false,
  "peer_metadata": null
}
^4.17.11runtime
graphql
Environment
{
  "local_name": "graphql",
  "alias": false,
  "peer_metadata": null
}
^15.4.0runtime
fast-abi
Environment
{
  "local_name": "fast-abi",
  "alias": false,
  "peer_metadata": null
}
^0.0.2runtime
@0x/types
Environment
{
  "local_name": "@0x/types",
  "alias": false,
  "peer_metadata": null
}
^3.3.3runtime
@0x/utils
Environment
{
  "local_name": "@0x/utils",
  "alias": false,
  "peer_metadata": null
}
^6.4.3runtime
cream-sor
Environment
{
  "local_name": "cream-sor",
  "alias": false,
  "peer_metadata": null
}
^0.3.3runtime
@0x/assert
Environment
{
  "local_name": "@0x/assert",
  "alias": false,
  "peer_metadata": null
}
^3.0.27runtime
decimal.js
Environment
{
  "local_name": "decimal.js",
  "alias": false,
  "peer_metadata": null
}
^10.2.0runtime
heartbeats
Environment
{
  "local_name": "heartbeats",
  "alias": false,
  "peer_metadata": null
}
^5.0.1runtime
@bancor/sdk
Environment
{
  "local_name": "@bancor/sdk",
  "alias": false,
  "peer_metadata": null
}
0.2.9runtime
@0x/dev-utils
Environment
{
  "local_name": "@0x/dev-utils",
  "alias": false,
  "peer_metadata": null
}
^4.2.7runtime
ethereum-types
Environment
{
  "local_name": "ethereum-types",
  "alias": false,
  "peer_metadata": null
}
^3.5.0runtime
ethereumjs-util
Environment
{
  "local_name": "ethereumjs-util",
  "alias": false,
  "peer_metadata": null
}
^7.0.10runtime
graphql-request
Environment
{
  "local_name": "graphql-request",
  "alias": false,
  "peer_metadata": null
}
^3.4.0runtime
@0x/json-schemas
Environment
{
  "local_name": "@0x/json-schemas",
  "alias": false,
  "peer_metadata": null
}
^6.1.3runtime
@0x/quote-server
Environment
{
  "local_name": "@0x/quote-server",
  "alias": false,
  "peer_metadata": null
}
^6.0.2runtime
@0x/web3-wrapper
Environment
{
  "local_name": "@0x/web3-wrapper",
  "alias": false,
  "peer_metadata": null
}
^7.5.3runtime
@0x/base-contract
Environment
{
  "local_name": "@0x/base-contract",
  "alias": false,
  "peer_metadata": null
}
^6.4.0runtime
@0x/protocol-utils
Environment
{
  "local_name": "@0x/protocol-utils",
  "alias": false,
  "peer_metadata": null
}
^1.6.0runtime
@balancer-labs/sor
Environment
{
  "local_name": "@balancer-labs/sor",
  "alias": false,
  "peer_metadata": null
}
0.3.2runtime
@ethersproject/abi
Environment
{
  "local_name": "@ethersproject/abi",
  "alias": false,
  "peer_metadata": null
}
^5.0.1runtime
axios-mock-adapter
Environment
{
  "local_name": "axios-mock-adapter",
  "alias": false,
  "peer_metadata": null
}
^1.19.0runtime
@0x/contracts-erc20
Environment
{
  "local_name": "@0x/contracts-erc20",
  "alias": false,
  "peer_metadata": null
}
^3.3.8runtime
@0x/contract-wrappers
Environment
{
  "local_name": "@0x/contract-wrappers",
  "alias": false,
  "peer_metadata": null
}
^13.16.1runtime
@0x/contracts-zero-ex
Environment
{
  "local_name": "@0x/contracts-zero-ex",
  "alias": false,
  "peer_metadata": null
}
^0.23.0runtime
@0x/contract-addresses
Environment
{
  "local_name": "@0x/contract-addresses",
  "alias": false,
  "peer_metadata": null
}
^6.1.0runtime
@0x/typescript-typings
Environment
{
  "local_name": "@0x/typescript-typings",
  "alias": false,
  "peer_metadata": null
}
^5.2.0runtime
@ethersproject/address
Environment
{
  "local_name": "@ethersproject/address",
  "alias": false,
  "peer_metadata": null
}
^5.0.1runtime
@ethersproject/strings
Environment
{
  "local_name": "@ethersproject/strings",
  "alias": false,
  "peer_metadata": null
}
^5.0.10runtime
@ethersproject/contracts
Environment
{
  "local_name": "@ethersproject/contracts",
  "alias": false,
  "peer_metadata": null
}
^5.0.1runtime
@ethersproject/providers
Environment
{
  "local_name": "@ethersproject/providers",
  "alias": false,
  "peer_metadata": null
}
^5.0.4runtime
nyc
Environment
{
  "local_name": "nyc",
  "alias": false,
  "peer_metadata": null
}
^11.0.1development
shx
Environment
{
  "local_name": "shx",
  "alias": false,
  "peer_metadata": null
}
^0.2.2development
chai
Environment
{
  "local_name": "chai",
  "alias": false,
  "peer_metadata": null
}
^4.0.1development
mocha
Environment
{
  "local_name": "mocha",
  "alias": false,
  "peer_metadata": null
}
^6.2.0development
gitpkg
Environment
{
  "local_name": "gitpkg",
  "alias": false,
  "peer_metadata": null
}
git+https://github.com/0xProject/gitpkg.gitdevelopment
tslint
Environment
{
  "local_name": "tslint",
  "alias": false,
  "peer_metadata": null
}
5.11.0development
typedoc
Environment
{
  "local_name": "typedoc",
  "alias": false,
  "peer_metadata": null
}
~0.16.11development
typemoq
Environment
{
  "local_name": "typemoq",
  "alias": false,
  "peer_metadata": null
}
^2.1.0development
@0x/types
Environment
{
  "local_name": "@0x/types",
  "alias": false,
  "peer_metadata": null
}
^3.3.3development
dirty-chai
Environment
{
  "local_name": "dirty-chai",
  "alias": false,
  "peer_metadata": null
}
^2.0.1development
typescript
Environment
{
  "local_name": "typescript",
  "alias": false,
  "peer_metadata": null
}
4.2.2development
@0x/abi-gen
Environment
{
  "local_name": "@0x/abi-gen",
  "alias": false,
  "peer_metadata": null
}
^5.6.0development
@types/node
Environment
{
  "local_name": "@types/node",
  "alias": false,
  "peer_metadata": null
}
12.12.54development
npm-run-all
Environment
{
  "local_name": "npm-run-all",
  "alias": false,
  "peer_metadata": null
}
^4.1.2development
@types/mocha
Environment
{
  "local_name": "@types/mocha",
  "alias": false,
  "peer_metadata": null
}
^5.2.7development
@types/lodash
Environment
{
  "local_name": "@types/lodash",
  "alias": false,
  "peer_metadata": null
}
4.14.104development
@0x/migrations
Environment
{
  "local_name": "@0x/migrations",
  "alias": false,
  "peer_metadata": null
}
^8.0.6development
@0x/ts-doc-gen
Environment
{
  "local_name": "@0x/ts-doc-gen",
  "alias": false,
  "peer_metadata": null
}
^0.0.28development
chai-bignumber
Environment
{
  "local_name": "chai-bignumber",
  "alias": false,
  "peer_metadata": null
}
^3.0.0development
@0x/sol-compiler
Environment
{
  "local_name": "@0x/sol-compiler",
  "alias": false,
  "peer_metadata": null
}
^4.7.3development
@0x/subproviders
Environment
{
  "local_name": "@0x/subproviders",
  "alias": false,
  "peer_metadata": null
}
^6.5.3development
chai-as-promised
Environment
{
  "local_name": "chai-as-promised",
  "alias": false,
  "peer_metadata": null
}
^7.1.0development
@0x/contracts-gen
Environment
{
  "local_name": "@0x/contracts-gen",
  "alias": false,
  "peer_metadata": null
}
^2.0.38development
@0x/tslint-config
Environment
{
  "local_name": "@0x/tslint-config",
  "alias": false,
  "peer_metadata": null
}
^4.1.4development
make-promises-safe
Environment
{
  "local_name": "make-promises-safe",
  "alias": false,
  "peer_metadata": null
}
^1.1.0development
@0x/contracts-utils
Environment
{
  "local_name": "@0x/contracts-utils",
  "alias": false,
  "peer_metadata": null
}
^4.7.8development
@0x/mesh-rpc-client
Environment
{
  "local_name": "@0x/mesh-rpc-client",
  "alias": false,
  "peer_metadata": null
}
^9.4.2development
@0x/contracts-exchange
Environment
{
  "local_name": "@0x/contracts-exchange",
  "alias": false,
  "peer_metadata": null
}
^3.2.30development
@0x/contracts-test-utils
Environment
{
  "local_name": "@0x/contracts-test-utils",
  "alias": false,
  "peer_metadata": null
}
^5.4.0development
@0x/contracts-asset-proxy
Environment
{
  "local_name": "@0x/contracts-asset-proxy",
  "alias": false,
  "peer_metadata": null
}
^3.7.11development
@0x/contracts-exchange-libs
Environment
{
  "local_name": "@0x/contracts-exchange-libs",
  "alias": false,
  "peer_metadata": null
}
^4.3.29development

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "8aa4aa33b5341cc799794f0c26092a5495de9ee7",
  "tarball": "https://registry.npmjs.org/@0x/asset-swapper/-/asset-swapper-6.14.0.tgz",
  "fileCount": 238,
  "integrity": "sha512-q50qmBVGFZsXWWWxL+P+D207QMom5CYbpmVJK+HF1CQRvB6mKeBdBUUDV0BA0QbRkv0tCMcvnhSby/ZvIhr7TQ==",
  "signatures": [
    {
      "sig": "MEQCIAyWA0Ljo+VFNjud1mqK85IuBgRuqzi0QvfUclXE8jEnAiBeFkmMly8SVogBVrGKP+voVN32okhEvvb7vyC+0zFAOw==",
      "keyid": "SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"
    }
  ],
  "unpackedSize": 2801296,
  "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgm5w/CRA9TVsSAnZWagAAR+4QAJX9LhnOuf7CCv/5FVkX\ns+N56oFFA3a+UXDLefULdaEddbs5i3OJNJda8Qq82rERE5xSxtchchlDLhwR\nW1XRqU1sCueB2jK7FDP+fAZCOPNBa32dwjXOckR6/f6yho0nPrxqgTqGe9oq\nvAPQ+11NWKNmofoqLsprCYvPGPZEbjirH/kiEiVD1Vqd9wBybz6HHvJJH8E5\nvfYHGEDkMg8tK7lwvym+nsisze3O+Lh2VcZUecjKWlCrmCi8BoS1n0gI6aL9\ntTnLPPG9Mxlzbge7gA3vZLFCz0odTadVmov0TkMANWwLMPvkcNwB5sl3mykZ\njVI7w9LvBbrUeMJ658J630BW8NBgczOAkTcH1piSOniPO/04SKZsv22zDRjr\nYWCY3lE9eOP40+NGNr0XRL2Ps0AzEqveEmPRXMWeMmHKesl31K8QR4HmOpbr\nF2ISLBHQRdkmpwcRv5kuqB33YKkxYkUy4HLS1Ie+LH3J/Z+avzyCUY6du1s+\nYaup9+6vuFBMDSNVsuT5j8XorK4lOQorfaD7YLESBD+YE4z+sArz1f6J47m1\n/vhfOGyyy0vYNWAjRuXviIjGMNG5jRvx8O4hg7jlsS9S0hlQtn46OIyziUev\nbyCzVQ2uD3kIkTshlK/ViZd38L0fbaUE1i0Lm2VKmRY8EiDSGkPLdgaXoh/Y\nOo1o\r\n=Hwno\r\n-----END PGP SIGNATURE-----\r\n"
}

Repository

PENDING
0xproject/protocol

Shared repository data · GitHub

License detected in repository
Not collected

Repository

PENDING
0xproject/0x-monorepo

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 22:21 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:491a88b65b38da5cd03cb5df5e65daaa7c0a67aecdae725d1b1fa36dbf34fc51

Other collected versions

16.66.422 Aug16.66.310 Aug16.66.29 Aug16.66.18 Aug16.66.06 Aug16.65.01 AugView all collected versions →