jmagan / cardano-js-sdk

:construction: Work in progress: JavaScript SDK for interacting with Cardano, providing various key management options, support for popular hardware wallets

Cardano JS SDK

---

Overview

A suite of TypeScript packages suitable for both Node.js and browser-based development.

• @cardano-sdk/core
• @cardano-sdk/input-selection
• @cardano-sdk/cip30
• @cardano-sdk/governance
• @cardano-sdk/key-management
• @cardano-sdk/web-extension
• @cardano-sdk/wallet
• @cardano-sdk/util-rxjs
• @cardano-sdk/util
• @cardano-sdk/util-dev
• @cardano-sdk/cardano-services
• @cardano-sdk/cardano-services-client

External Provider Implementations

• @cardano-sdk/blockfrost

Supported Environments

Packages are distributed as both CommonJS and ESM modules.

• Node.js >=14.15.0 <15.0.0
  • using with type="module" requires --experimental-specifier-resolution=node flag
• Browser via bundlers (see example webpack config)

Testing

• @cardano-sdk/golden-test-generator

Development

A Yarn Workspace maintaining a single version across all packages.

System Requirements

• nvm
• yarn

Clone

git clone \
  --recurse-submodules \
  https://github.com/input-output-hk/cardano-js-sdk.git \
  && cd cardano-js-sdk

Install and Build

nvm install && \
nvm use && \
yarn install && \
yarn build

Run Tests

yarn test

or

yarn test:debug

Lint

yarn lint
yarn lint --fix

Cleanup

yarn cleanup

Distribute

Pack

./scripts/pack.sh

Publish to npm.org

./scripts/publish.sh

Generate Docs

yarn docs

📖 Documentation