# @xchainjs/xchain-cardano

> Cardano client for XChainJS

Latest version **1.2.4** (published 2026-08-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install @xchainjs/xchain-cardano
pnpm add @xchainjs/xchain-cardano
yarn add @xchainjs/xchain-cardano
bun add @xchainjs/xchain-cardano
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.2.4 |
| Published | 2026-08-06 |
| First published | 2024-12-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 133 |
| Author | THORChain |
| Maintainers | xchainjsadmin, thorchain_org, _stu, veado, thatstrangeguy, junkai121, sarawut11, thorswap, hodrthemediocre, polaris_9r, thorianite |
| Keywords | Cardano, XChain |

## Links

- npm: https://www.npmjs.com/package/@xchainjs/xchain-cardano
- Repository: https://github.com/xchainjs/xchainjs-lib
- Issues: https://github.com/xchainjs/xchainjs-lib/issues
- npm.io page: https://npm.io/package/@xchainjs/xchain-cardano

## Recent versions

- 1.2.4 (latest) — 2026-08-06
- 1.2.3 — 2026-07-20
- 1.2.2 — 2026-06-25
- 1.2.1 — 2026-06-03
- 1.2.0 — 2026-05-14
- 1.1.11 — 2026-04-15
- 1.1.10 — 2026-03-12
- 1.1.9 — 2026-02-10
- 1.1.8 — 2025-09-19
- 1.1.7 — 2025-07-28
- 1.1.6 — 2025-07-23
- 1.1.5 — 2025-07-23
- 1.1.4 — 2025-07-23
- 1.1.3 — 2025-07-15
- 1.1.2 — 2025-06-30
- … 8 more at https://npm.io/package/@xchainjs/xchain-cardano/versions

## README

<div align="center">
  <h1 align="center">Cardano client</h1>
  <p align="center">
    <a href='https://www.npmjs.com/package/@xchainjs/xchain-cardano' target='_blank'>
      <img alt="NPM Version" src="https://img.shields.io/npm/v/%40xchainjs%2Fxchain-cardano" />
    </a>
      <a href='https://www.npmjs.com/package/@xchainjs/xchain-cardano' target='_blank'>
      <img alt="NPM Downloads" src="https://img.shields.io/npm/d18m/%40xchainjs%2Fxchain-cardano" />
    </a>
  </p>
</div>

<br />


## Installation

```sh
yarn add @xchainjs/xchain-cardano
```

or 

```sh
npm install @xchainjs/xchain-cardano
```

## Initialization

Using the Cardano client you can initialize the main class of the module in consultation mode if you do not provide any parameters, this means you could retrieve information from the blockchain and prepare transactions to sign, but you will not be able to sign transactions, or generate addresses.

```ts
import { Client } from '@xchainjs/xchain-cardano'

const client = new Client()

// Make read operations with your client
```

Otherwise, if you want to sign transactions and get the addresses you own, you will need to initialize the main class of the protocol as follows

```ts
import { Client, defaultCardanoParams } from '@xchainjs/xchain-cardano'

const client = new Client({
  phrase: 'your secret phrase',
  ...defaultCardanoParams
})

// Make read or write operations with your client
```

##  Features

Thanks to the Cardano client you will be able to:
- Get the Cardano and tokens balances that an address owns
- Generate addresses given a secret phrase
- Transfer Cardano and tokens to another address
- Get details of a transaction
- Get address transaction history



## Examples

You can find examples using the Cardano package in the [Cardano](https://github.com/xchainjs/xchainjs-lib/tree/master/examples/cardano) examples folder.


## Documentation

More information about how to use the Cardano client can be found on [documentation](https://xchainjs.gitbook.io/xchainjs/clients/xchain-cardano)

---
_Source: https://npm.io/package/@xchainjs/xchain-cardano · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._