# @ton/core

> Core TypeScript library that implements low level primitives for TON blockchain.

Latest version **0.63.1** (published 2026-02-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ton/core
pnpm add @ton/core
yarn add @ton/core
bun add @ton/core
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.63.1 |
| Published | 2026-02-11 |
| First published | 2023-06-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 652.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 78 |
| Author | Whales Corp. |
| Maintainers | tsivarev, klpx, ton-ci, it-tonstudio-io |

## Links

- npm: https://www.npmjs.com/package/@ton/core
- Repository: https://github.com/ton-org/ton-core
- Homepage: https://github.com/ton-org/ton-core#readme
- Issues: https://github.com/ton-org/ton-core/issues
- npm.io page: https://npm.io/package/@ton/core

## Recent versions

- 0.63.1 (latest) — 2026-02-11
- 0.63.0 — 2026-01-20
- 0.62.1 — 2026-01-12
- 0.62.0 — 2025-10-01
- 0.61.0 — 2025-06-10
- 0.60.1 — 2025-02-20
- 0.60.0 — 2025-01-31
- 0.59.1 — 2024-12-20
- 0.59.0 — 2024-10-09
- 0.58.1 — 2024-09-13
- 0.58.0 — 2024-09-13
- 0.57.0 — 2024-08-16
- 0.56.3 — 2024-03-25
- 0.56.2 — 2024-03-19
- 0.56.1 — 2024-02-27
- … 10 more at https://npm.io/package/@ton/core/versions

## README

# 💎 @ton/core

Core TypeScript library that implements low level primitives for TON blockchain.

## How to install

```bash
yarn add @ton/core
```
```bash
npm install @ton/core
```

⚠️ Beware that having two versions of `@ton/core` concurrently in the same project is not supported. Use the package manager's functionality ([npm](https://docs.npmjs.com/cli/v8/commands/npm-find-dupes), [yarn](https://yarnpkg.com/cli/dedupe)) in CI to avoid this.

## Formatting

We use `biome` as our formatter. It's compatible to `prettier`, just significantly faster.

IDE Setup: [VSCode](https://marketplace.visualstudio.com/items?itemName=biomejs.biome), [Zed](https://biomejs.dev/reference/zed/)

```sh
yarn run format
```

## Testing

### Debugging in tests

By default tests are running using multiple worker threads. It's faster, but 
undesirable during debugging. `SINGLETHREADED` env variable covers this case

```sh
SINGLETHREADED=1 yarn run test
```

### Coverage report

We use test coverage to eliminate blind spots in our tests.

#### How to?

The goal is to run every function at least once.

1. Build a coverage report 

```sh
yarn run coverage
```

2. Coverage report is written to the `/coverage` directory

3. Open `/coverage/index.html` to check the report

## Contributing

See [CONTRIBUTING](./CONTRIBUTING.md).

## Acknowledgements

This library has been created and maintained by the [Whales Corp.](https://tonwhales.com/) and [Dan Volkov](https://github.com/dvlkv). The current maintainer is [TON Studio](https://github.com/ton-studio/).

# License

MIT

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