npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

cardano-addresses

v3.12.0

Published

- 📦 [NPM Package](https://www.npmjs.com/package/cardano-addresses) - 📗 [API Documentation](https://input-output-hk.github.io/cardano-addresses/typescript/) - 🎇 [Web Demo](https://input-output-hk.github.io/cardano-addresses/demo/) - λ [Haskell Library](

Downloads

432

Readme

cardano-addresses TypeScript binding

This is a Typescript (or Javascript) version of the cardano-addresses API.

For the time being, this module is experimental, and exposes only a subset of the functionality of the Haskell API. We would like to increase the TypeScript binding's coverage of the Haskell API in future, as needs arise.

How it works

This package comprises of four parts:

Development Info

NodeJS module: Building and testing

Start a nix-shell in this directory (not the top-level) and run:

$ cd jsapi
$ nix-shell
[nix-shell:~/iohk/cardano-addresses/jsapi]$ npm install && npm run build
...
[nix-shell:~/iohk/cardano-addresses/jsapi]$ npm run test

Behind the scenes, this will use Nix to make the ghcjs build of the cardano-addresses library. The path to this Javascript file is stored in the $CARDANO_ADDRESSES_JS environment variable.

Haskell module: Building and testing

To try it out run nix-shell from the repo top-level directory:

$ nix-shell
[nix-shell:~/iohk/cardano-addresses]$ js-unknown-ghcjs-cabal build cardano-addresses-jsapi:jsapi-test
[nix-shell:~/iohk/cardano-addresses]$ node dist-newstyle/build/js-ghcjs/ghcjs-8.10.4/cardano-addresses-jsapi-3.5.0/t/jsapi-test/build/jsapi-test/jsapi-test.jsexe/all.js

That test initializes the api from a JS function that is called from Main.hs. To build .js file that might be easier to use from a JS app run:

$ nix-build jsapi/default.nix -A cardano-addresses-js
/nix/store/dw0xwvjvwac68i2a4dkkpx4mw8yji9z8-cardano-addresses-js-3.5.0
$ tree ./result
./result
├── cardano-addresses-jsapi.cjs.js
└── cardano-addresses-jsapi.js

This replaces the regular runmain.js with jsapi/glue/runmain.js. That exposes a single function you can call and pass in a continuation.

To initialize, call the runCardanoAddressesApi with a continuation that like the one in jsapi/glue/test.js. You will be passed api and cleanup.

TODO

  • [ ] More API endpoints depending on user needs.
  • [ ] Used "typed" objects as parameters for the inspectAddress API, instead of strings which must be parsed.
  • [ ] Add a build step to optimise output file sizes (i.e. minification, tree shaking, etc).
  • [ ] Solve issue on nodejs where registered event handlers remain after API cleanup, preventing the nodejs runtime from exiting.
  • [ ] Add helper functions to the JSaddle API so that it can output code for ES6 Promises.
  • [ ] Bring back headless testing of JSaddle code.
  • [ ] Replace TSDX with a better build system.
  • [ ] Automatically update docs in CI.
  • [ ] Add release workflow to CI which builds the package and uploads to NPM.

More details

NodeJS package

For better or worse, this is based on the TSDX template. The TSDX standard documentation follows...

Commands

To run TSDX, use:

npm start # or yarn start

This builds to /dist and runs the project in watch mode so any edits you save inside src causes a rebuild to /dist.

To do a one-off build, use npm run build or yarn build.

To run tests, use npm test or yarn test.

Configuration

Code quality is set up for you with prettier, and lint-staged. Adjust the respective fields in package.json accordingly.

Jest

Jest tests are set up to run with npm test or yarn test.

Bundle Analysis

size-limit is set up to calculate the real cost of your library with npm run size and visualize the bundle with npm run analyze.

Rollup

TSDX uses Rollup as a bundler and generates multiple rollup configs for various module formats and build settings. See Optimizations for details.

TypeScript

tsconfig.json is set up to interpret dom and esnext types, as well as react for jsx. Adjust according to your needs.

Continuous Integration

GitHub Actions

Two actions are added by default:

  • tsdx-build which installs deps w/ cache, lints, tests, and builds on all pushes against a Node and OS matrix
  • tsdx-size which comments cost comparison of your library on every pull request using size-limit

Optimizations

Please see the main tsdx optimizations docs. In particular, know that you can take advantage of development-only optimizations:

// ./types/index.d.ts
declare var __DEV__: boolean;

// inside your code...
if (__DEV__) {
  console.log('foo');
}

You can also choose to install and use invariant and warning functions.

Module Formats

CJS, ESModules, and UMD module formats are supported.

The appropriate paths are configured in package.json and dist/index.js accordingly. Please report if any issues are found.

Publishing to NPM

TSDX recommend using np.