daemon

Daemon Websocket API

Usage

You need to create Websocket connection before subscribing websocket messages.
Unlike other websocket APIs, daemon websocket API is based on request/response style rather than subscribe/listen.
Note: subscribe/listen style WebSocket API for daemon was introduced at [email protected]. See detail here

const {getDaemon} = require("chia-agent");
const {start_plotting, is_running} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response1 = await start_plotting(daemon, {...});
const response2 = await is_running(daemon, {...});
await daemon.close();

/*
 * You can connect to other than localhost when you specify websocket server url.
 */
await daemon.connect("wss://host.name:1234");
...

---

ping(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {ping} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await ping(daemon);

response:

{
  success: bool;
  value: str; // "pong"
}

---

start_service(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {start_service} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await start_service(daemon, {service: "..."});

params:

{
  service: TService;
  testing?: bool;
}

where TService is one of

"chia"|"chia_wallet"|"chia_full_node"|"chia_harvester"|"chia_farmer"
  |"chia_introducer"|"chia_timelord"|"chia_timelord_launcher"|"chia_full_node_simulator";

response:

{
  success: bool;
  service: str;
  error: Optional<str>;
}

---

start_plotting(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {start_plotting} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await start_plotting(daemon, params);

params:

{
  service: "chia_plotter";
  delay?: int; // delay in seconds. Default: 0
  parallel?: bool; // parallel or serialize. Default: False
  k: int; // size. 32, 33, ...
  t: str; // tmp dir
  d: str; // final dir
  x?: bool; // exclude final dir. Skips adding [final dir] to harvester for farming. Default: False
  n?: int; // count of creating plot. Default: 1
  queue?: str; // queue name. Default: "default"
  r: int; // number of threads
  f?: str; // farmer public key.
  p?: str; // pool public key.
  c?: str; // pool contract address.
} & (chiapos_params | bladebit_ramplot_params | bladebit_diskplot_params | bladebit_cudaplot_params | madmax_params)

chiapos_params:

{
  plotter: "chiapos";
  t2?: str; // tmp dir 2
  b: int; // memory buffer size in MiB
  u: int; // number of buckets
  a?: int; // wallet private key fingerprint
  e: bool; // disable bitfield plotting
  overrideK: bool; // Set true only if you want to use k < 32
}

bladebit_ramplot_params:

{
  plotter: "bladebit";
  plot_type: "ramplot";
  w?: bool; // Warm start. Default: False
  m?: bool; // Disable NUMA. Default: False
  no_cpu_affinity?: bool; // Default: False
  compress?: int;
}

bladebit_diskplot_params:

{
  plotter: "bladebit";
  plot_type: "diskplot";
  w?: bool; // Warm start. Default: False
  m?: bool; // Disable NUMA. Default: False
  no_cpu_affinity?: bool; // Default: False
  compress?: int;
  t1: str; // Temp directory
  t2?: str; // Temp2 directory
  u?: int; // Buckets
  cache?: str;
  f1_threads?: int;
  fp_threads?: int;
  c_threads?: int;
  p2_threads?: int;
  p3_threads?: int;
  alternate?: bool; // Default: False
  no_t1_direct?: bool; // Default: False
  no_t2_direct?: bool; // Default: False
}

bladebit_cudaplot_params:

{
  plotter: "bladebit";
  plot_type: "cudaplot";
  w?: bool; // Warm start. Default: False
  m?: bool; // Disable NUMA. Default: False
  no_cpu_affinity?: bool; // Default: False
  compress?: int;
  device?: int;
  t?: str; // Temp directory
  t2?: str; // Temp2 directory
  disk_128? : bool;
  disk_16? : bool;
}

madmax_params:

{
  plotter: "madmax";
  t2: str; // tmp dir 2
  b: int; // memory buffer size in MiB
  u: int; // number of buckets
  v: int; // number of buckets for phase 3 & 4
  K?: int; // Thread multiplier for phase 2. Default: 1
  G?: bool; // Alternate tmpdir/tmp2dir. Default: False
}

response:

{
  success: bool;
  ids: str[];
  service_name: str; // should be 'chia_plotter'
}

---

stop_plotting(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {stop_plotting} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await stop_plotting(daemon, {id: "..."});

params:

{
  id: str;
}

response:

{
  success: bool;
}

---

stop_service(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {stop_service} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await stop_service(daemon, {service: "..."});

params:

{
  service: str; // "chia_farmer", "chia_full_node", "chia_harvester", "chia_wallet"
}

response:

{
  success: bool;
}

---

running_services(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {running_services} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await running_services(daemon);

response:

{
  success: bool;
  running_services: str[];
}

---

is_running(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {is_running} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await is_running(daemon, {service: "chia_farmer"});

params:

{
  service: str; // "chia_farmer", "chia_full_node", "chia_harvester", "chia_wallet"
}

response:

{
  success: bool;
  service_name: str;
  is_running: bool;
}

---

add_private_key(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {add_private_key} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await add_private_key(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
  mnemonic?: str;
  label?: str;
}

response:

{
  success: True;
  fingerprint: G1Element;
} | {
  success: False;
  error: str;
  error_details?: {message: str};
}

---

add_key(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {add_key} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await add_key(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
  mnemonic?: str;
  label?: str;
}

response:

{
  success: True;
  fingerprint: G1Element;
} | {
  success: False;
  error: str;
  error_details?: {message: str};
}

---

check_keys(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {check_keys} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await check_keys(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
  root_path: str;
}

response:

{
  success: bool;
  error?: str;
  error_details?: {message: str};
}

---

delete_all_keys(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {delete_all_keys} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await delete_all_keys(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: bool;
  error?: str;
  error_details?: {message: str};
}

---

delete_key_by_fingerprint(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {delete_key_by_fingerprint} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await delete_key_by_fingerprint(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
  fingerprint: int;
}

response:

{
  success: bool;
  error?: str;
  error_details?: {message: str};
}

---

get_all_private_keys(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_all_private_keys} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_all_private_keys(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: bool;
  error?: str;
  private_keys: Array<{pk: str; entropy: str}>;
}

---

get_first_private_key(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_first_private_key} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_first_private_key(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: bool;
  error?: str;
  private_key: {pk: str; entropy: str};
}

---

get_key_for_fingerprint(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_key_for_fingerprint} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_key_for_fingerprint(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
  private?: bool;
  fingerprint?: int;
}

response:

{
  success: False;
  error: str;
} | {
  success: True;
  pk: str;
  entropy: str;
}

---

get_key(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_key} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_key(daemon, params);

params:

{
  fingerprint: uint32;
  include_secrets?: bool;
  kc_user? : str;
  kc_service? : str;
}

response:

{
  success: True;
  key: KeyData;
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

For content of KeyData,
see https://github.com/Chia-Mine/chia-agent/blob/main/src/api/chia/util/keychain.ts

---

get_keys(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_keys} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_keys(daemon, params);

params:

{
  include_secrets?: bool;
  kc_user? : str;
  kc_service? : str;
}

response:

{
  success: True;
  keys: KeyData[];
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

For content of KeyData,
see https://github.com/Chia-Mine/chia-agent/blob/main/src/api/chia/util/keychain.ts

---

get_public_key(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_public_key} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_public_key(daemon, params);

params:

{
  fingerprint: uint32;
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: True;
  key: Omit<KeyData, "secrets">;
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

For content of KeyData,
see https://github.com/Chia-Mine/chia-agent/blob/main/src/api/chia/util/keychain.ts

---

get_public_keys(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_public_keys} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_public_keys(daemon, params);

params:

{
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: True;
  keys: Array<Omit<KeyData, "secrets">>;
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

For content of KeyData,
see https://github.com/Chia-Mine/chia-agent/blob/main/src/api/chia/util/keychain.ts

---

set_label(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {set_label} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await set_label(daemon, params);

params:

{
  fingerprint: uint32;
  label: str;
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: True;
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

---

delete_label(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {delete_label} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await delete_label(daemon, params);

params:

{
  fingerprint: uint32;
  kc_user?: str;
  kc_service?: str;
}

response:

{
  success: True;
} | {
  success: False;
  error: "keyring is locked" | "key not found" | "malformed request";
  error_details?: {message: str} | {fingerprint: int};
}

---

is_keyring_locked(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {is_keyring_locked} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await is_keyring_locked(daemon);

response:

{
  success: bool;
  is_keyring_locked: bool;
}

---

keyring_status(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {keyring_status} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await keyring_status(daemon);

response:

{
  success: bool;
  is_keyring_locked: bool;
  passphrase_support_enabled: bool;
  can_save_passphrase: bool;
  user_passphrase_is_set: bool;
  can_set_passphrase_hint: bool;
  passphrase_hint: str;
  passphrase_requirements: {} | {
    is_optional: True;
    min_length: int;
  };
}

---

unlock_keyring(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {unlock_keyring} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await unlock_keyring(daemon, params);

params:

{
  key: string;
}

response:

{
  success: bool;
  error: string|None;
}

---

validate_keyring_passphrase(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {validate_keyring_passphrase} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await validate_keyring_passphrase(daemon, params);

params:

{
  key: string;
}

response:

{
  success: bool;
  error: string|None;
}

---

set_keyring_passphrase(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {set_keyring_passphrase} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await set_keyring_passphrase(daemon, params);

params:

{
  current_passphrase: string;
  new_passphrase: string;
  passphrase_hint?: str;
  save_passphrase?: bool;
}

response:

{
  success: bool;
  error: string;
}

---

remove_keyring_passphrase(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {remove_keyring_passphrase} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await remove_keyring_passphrase(daemon, params);

params:

{
  current_passphrase: str;
}

response:

{
  success: bool;
  error: string;
}

---

exit(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {exit} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await exit(daemon);

response:

{
  success: bool;
}

---

register_service(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {register_service} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await register_service(daemon, {service: "wallet_ui"});

params:

{
  service: str; // typically "wallet_ui" or "chia_plotter"
}

response:

{
  success: bool;
} | {
  success: bool;
  service: str;
  queue: Array<{
    id: str;
    queue: str;
    size: int;
    parallel: bool;
    delay: int;
    state: str;
    error: Optional<str>;
    deleted: bool;
    log_new: str;
    log?: str;
  }>;
}

---

get_status(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {get_status} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_status(daemon);

response:

{
  success: bool;
  genesis_initialized: True;
}

---

get_version(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {get_version} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_version(daemon);

response:

{
  success: bool;
  version: string;
}

---

get_plotters(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {get_plotters} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_plotters(daemon);

response:

{
  success: bool;
  plotters: {
    chiapos?: chiapos_install_info;
    bladebit?: bladebit_install_info;
    madmax?: madmax_install_info;
  }
}

For content of chiapos_install_info, bladebit_install_info, madmax_install_info,
see https://github.com/Chia-Mine/chia-agent/blob/main/src/api/chia/plotters/

---

get_routes(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {get_routes} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_routes(daemon);

response:

{
  success: bool;
  routes: str[];
}

---

get_wallet_addresses(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_wallet_addresses} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_wallet_addresses(daemon, params);

params:

{
  fingerprints?: uint32[];
  index?: int;
  count?: int;
  non_observer_derivation?: bool;
}

response:

{
  success: False;
  error: str;
} | {
  success: True;
  wallet_addresses: Record<str, Array<{ address: str; hd_path: str }>>;
}

---

get_keys_for_plotting(daemon, params)

Usage

const {getDaemon} = require("chia-agent");
const {get_keys_for_plotting} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_keys_for_plotting(daemon, params);

params:

{
  fingerprints?: uint32[];
}

response:

{
  success: False;
  error: str;
} | {
  success: True;
  keys: Record<str, { farmer_public_key: str; pool_public_key: str }>;
}

---

get_network_info(daemon)

Usage

const {getDaemon} = require("chia-agent");
const {get_network_info} = require("chia-agent/api/ws");
const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.
const response = await get_network_info(daemon);

response:

{
  success: True;
  network_name: str;
  network_prefix: str;
}

---

Usage(Subscription)

Starting from [email protected], subscribe/listen style WebSocket API was introduced to daemon service.
Here's an example.

const {getDaemon} = require("chia-agent");
const {on_keyring_status_changed} = require("chia-agent/api/ws");

const daemon = getDaemon(); // This is the websocket connection handler
await daemon.connect(); // connect to local daemon using config file.

const unsubscribe = await on_keyring_status_changed(daemon, (event) => {
  console.log(e.data);
  
  // Close connection if you don't need it anymore.
  if(...){
    unsubscribe(); // stop listening to this ws message.
  }
});
...

---

on_keyring_status_changed

Capture broadcast message of command on_keyring_status_changed from daemon service.

Usage

const {getDaemon} = require("chia-agent");
const {on_keyring_status_changed} = require("chia-agent/api/ws");

const daemon = getDaemon();
await daemon.connect();
const unsubscribe = await on_keyring_status_changed(daemon, (event) => {
  // Format of `event` object is described below.
  ...
});
...
unsubscribe(); // Stop subscribing messages

event:

{
  origin: "daemon";
  command: "keyring_status_changed";
  ack: boolean;
  data: /*See below*/;
  request_id: string;
  destination: "wallet_ui";
}

data:

{
  success: bool;
  is_keyring_locked: bool;
  passphrase_support_enabled: bool;
  user_passphrase_is_set: bool;
  needs_migration: bool;
  passphrase_requirements: {} | {
    is_optional: True;
    min_length: int;
  };
}