# chia-agent

> chia rpc/websocket client library

Latest version **20.0.0** (published 2026-06-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install chia-agent
pnpm add chia-agent
yarn add chia-agent
bun add chia-agent
```

Provides the command `chia-agent`.

## Health

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

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 20.0.0 |
| Published | 2026-06-14 |
| First published | 2021-05-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=20.0.0 |
| Dependencies | 3 |
| Unpacked size | 674.2 KB |
| Known vulnerabilities | 0 (+3 in 2 direct dependencies) |
| Install scripts | no |
| GitHub stars | 65 |
| Author | ChiaMineJP |
| Maintainers | chiamine |
| Keywords | chia, xch, crypto, rpc, websocket, pool, typescript |

## Links

- npm: https://www.npmjs.com/package/chia-agent
- Repository: https://github.com/Chia-Mine/chia-agent
- Homepage: https://github.com/Chia-Mine/chia-agent#readme
- Issues: https://github.com/Chia-Mine/chia-agent/issues
- npm.io page: https://npm.io/package/chia-agent

## Dependencies (3)

- [ws](https://npm.io/package/ws.md) 8.18.2
- [yaml](https://npm.io/package/yaml.md) 2.8.0
- [@chiamine/json-bigint](https://npm.io/package/@chiamine/json-bigint.md) 1.0.3

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 20.0.0 (latest) — 2026-06-14
- 16.1.5-beta.0 (beta) — 2026-01-16
- 14.3.7 (legacy) — 2025-07-16
- 19.2.0 — 2026-06-14
- 19.1.0 — 2026-06-14
- 19.0.0 — 2026-06-14
- 18.0.0 — 2026-06-14
- 17.0.0 — 2026-06-14
- 16.1.6 — 2026-06-14
- 16.1.5 — 2026-01-16
- 16.1.4 — 2026-01-16
- 16.1.3 — 2026-01-16
- 16.1.2 — 2025-11-26
- 16.1.1 — 2025-11-12
- 16.1.0 — 2025-09-28
- … 63 more at https://npm.io/package/chia-agent/versions

## README

# chia-agent
[![npm version](https://badge.fury.io/js/chia-agent.svg)](https://badge.fury.io/js/chia-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

chia rpc/websocket client library for NodeJS.  
Supports all RPC/Websocket API available at `2.7.1` of [`chia-blockchain`](https://github.com/Chia-Network/chia-blockchain/).  
\(If you need previous version, search for the corresponding release [here](https://github.com/Chia-Mine/chia-agent/releases)\)

you can develop your own nodejs script with `chia-agent` to:
- retrieve latest data from RPC servers like `farmer`, `harvester`, `full_node`, `wallet`, `pool`, `data_layer`, `crawler`, `solver`.
- send email when proof is found.
- trigger scripts when target event is observed.
- start/stop services.
- write program to schedule plotting with javascript.
- etc, etc, etc

## Install
```
npm install chia-agent
# or
yarn add chia-agent
```

## Compatibility
This code is compatible with:  
- [`560a4ab7a96b619bafd4efd5aa2f2e5c8cffea67`](https://github.com/Chia-Network/chia-blockchain/tree/560a4ab7a96b619bafd4efd5aa2f2e5c8cffea67) of [chia-blockchain 2.7.1](https://github.com/Chia-Network/chia-blockchain)  
  - [Diff to the main branch of chia-blockchain](https://github.com/Chia-Network/chia-blockchain/compare/560a4ab7a96b619bafd4efd5aa2f2e5c8cffea67...main)
- [`746c6888b685fec4827aacb942803022842ffe71`](https://github.com/Chia-Network/chia_rs/tree/746c6888b685fec4827aacb942803022842ffe71) of [chia_rs 0.42.1](https://github.com/Chia-Network/chia_rs)
  - [Diff to the main branch of chia_rs](https://github.com/Chia-Network/chia_rs/compare/746c6888b685fec4827aacb942803022842ffe71...main)
- [`ef49150171cc243b09c0e5d5cb27f2249ffa3793`](https://github.com/Chia-Network/pool-reference/tree/ef49150171cc243b09c0e5d5cb27f2249ffa3793) of [pool-reference](https://github.com/Chia-Network/pool-reference)  
  - [Diff to the main branch of pool-reference](https://github.com/Chia-Network/pool-reference/compare/ef49150171cc243b09c0e5d5cb27f2249ffa3793...main)

## API
There are 2 kinds of APIs in chia.  
`RPC API` and `Websocket API`.

### RPC API
RPC API is used to send message directly to chia services like `farmer`, `harvester`, `full_node`, `wallet`, `data_layer`, `crawler`, `solver`.

RPC API is just an async function in a traditional request/response style.

```js
const {RPCAgent, setLogLevel} = require("chia-agent");
const {get_plots} = require("chia-agent/api/rpc");
setLogLevel("debug");

const agent = new RPCAgent({
  service: "harvester",
});

const res = await get_plots(agent);
console.log(res.plots[0]);

/*
// sample output
{
  file_size: 108875876912,
  filename: 'M:\\plot-k32-yyyy-mm-dd-xx-xx-xxxxxxxxxxxxxxxxxxxxxxxxx.plot',
  plot_id: '...',
  plot_public_key: '0x934a93489...',
  pool_contract_puzzle_hash: null,
  pool_public_key: '0xb0aa9485c0d...',
  size: 32,
  time_modified: 1619540745
}
*/

// Or you can request RPC API via daemon websocket like this
const {getDaemon, setLogLevel} = require("chia-agent");
const {get_plots} = require("chia-agent/api/rpc");
const daemon = getDaemon();
await daemon.connect(); // connect to local daemon using config file.
const res = await get_plots(daemon);
```

### Websocket API
Websocket API is used to connect to chia `daemon`.

With websocket API, you can request chia daemon to start/stop plotting or other services,  
or capture various broadcast messages like:
- Plotting progress
- Farming info such as passed filter, proofs found, etc.

```js
const {getDaemon, setLogLevel} = require("chia-agent");
const {on_new_farming_info} = require("chia-agent/api/ws");

setLogLevel("debug");

const daemon = getDaemon();
await daemon.connect(); // connect to local daemon using config file.
const unsubscribe = await on_new_farming_info(daemon, (e) => {
  console.log(e.data);
})

setTimeout(async () => {
  unsubscribe(); // Stop capturing message
  daemon.close();
}, 30*1000); // Disconnect after 30s passed.

/*
// sample output
{
  farming_info: {
    challenge_hash: '0x07228cf04e8877797adc1e0605018007def282548f009564b00286886e23e88b',
    passed_filter: 0,
    proofs: 0,
    signage_point: '0xfe1272a8e6659c0a3875cac37f8b170f1f85d47fecfee36d825dfae0b2a73a31',
    timestamp: 1621255822,
    total_plots: 299
  },
  success: true
}
 */
```

## Logging
The logger system supports multiple log levels and formatters:

```js
const {setLogLevel, getLogger, setDefaultFormatter, simpleLogFormatter} = require("chia-agent");

// Set log level (case-insensitive)
setLogLevel("DEBUG"); // "error", "warning", "info", "debug", "trace", "none"

// Use built-in formatters
setDefaultFormatter(simpleLogFormatter); // Simple format without timestamp

// Custom formatter
const myFormatter = (context) => {
  return `[${context.level}] ${context.message}`;
};
setDefaultFormatter(myFormatter);

// Named loggers
const logger = getLogger("MyModule");
logger.info("Module initialized");

// Per-logger configuration
logger.setLogLevel("debug");
logger.setFormatter(myFormatter);
```

## API Reference
[See Documentation here](https://github.com/Chia-Mine/chia-agent/blob/main/src/api/README.md)

## Examples
[See documentation here](https://github.com/Chia-Mine/chia-agent/blob/main/example)

Here are some of those examples
- [Send email when proof is found](https://github.com/Chia-Mine/chia-agent/blob/main/example/send_email_when_proof_is_found)
- [RPC API code sample to show block record in certain height](https://github.com/Chia-Mine/chia-agent/blob/main/example/get_block_by_height)
- [Create multiple plots with javascript](https://github.com/Chia-Mine/chia-agent/blob/main/example/create_plots)

## Build from source
Once source files is build by `npm run build:prod`, files will be output to `/dist` directory.  
Then the files/directories are published to npm registry.  
Please note it does not upload files in project root to npm registry, but files inside '/dist'.

[Read details here](https://github.com/Chia-Mine/chia-agent/blob/main/BUILD.md)

## Donation
For continuous development, please support me with donation
`xch1wr8g2k7cn55xvepmg480dsu2xhf4rz5ezghwwapulj7jxqcz9ztqqclwdj`

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