SDKs and Libraries

This page lists the libraries and tools for building on the Pixa chain, says which of them can sign which operations, and records the quirks of the current versions with a workaround for each. It ends with a test you can run on any library before you trust it with a key.

Which client to use

dpixa

@pixagram/dpixa is a fork of dhive, Hive's TypeScript client, with Pixa's chain ID, PIX key prefix and PIXA and PXS symbols as defaults. The Pixagram app uses it. Licence: BSD-3-Clause-No-Military-License.

Install and load

Shellnpm install @pixagram/dpixa@1.5.4

JavaScript// CommonJS. require("@pixagram/dpixa") fails in 1.5.4; load the bundle.
const { Client, PrivateKey, Asset } = require("@pixagram/dpixa/dist/dpixa.js");

// ES modules
import dpixa from "@pixagram/dpixa/dist/dpixa.js";

HTML<!-- Browser, no build step: defines the global `dpixa` -->
<script src="https://unpkg.com/@pixagram/dpixa@1.5.4/dist/dpixa.js"></script>

Configure

JavaScriptconst client = new Client(
  ["https://api.pixagram.com", "https://pixarex.net", "https://merlion.surf"],
  { timeout: 10000, failoverThreshold: 3, consoleOnFailover: true },
);

What it covers

Quirks in 1.5.4

Each was reproduced on 2026-10-05.

Hive libraries

Pixa's API is Hive's, so a Hive library can read from it. Signing is where the chains differ: the chain ID, the key prefix and, in the legacy wire format, the symbol bytes of amounts.

@hiveio/dhive 1.3.2, configured for Pixa:

JavaScriptconst { Client } = require("@hiveio/dhive");
const client = new Client(["https://api.pixagram.com"], {
  chainId: "706978616772616d" + "0".repeat(48),
  addressPrefix: "PIX",
});

Other Hive libraries (beem, hive-tx, hive-js and the rest) were not tested. Run the test below before you sign with one.

Test a library before you trust it

A library signs correctly only if it builds the same bytes the chain builds. The public nodes return the chain's serialization of any transaction through condenser_api.get_transaction_hex, which signs nothing and broadcasts nothing. The digest a signature must cover is SHA-256 of the chain ID followed by those bytes.

Save as expected-digest.js (Node 18 or newer):

JavaScript// expected-digest.js: print the digest the Pixa chain expects a signature over
// usage: node expected-digest.js tx.json
const fs = require("fs");
const crypto = require("crypto");

const CHAIN_ID = Buffer.from("706978616772616d" + "0".repeat(48), "hex");

async function main() {
  const tx = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
  const reply = await fetch("https://api.pixagram.com", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0", id: 1,
      method: "condenser_api.get_transaction_hex",
      params: [{ ...tx, signatures: [] }],
    }),
  }).then((r) => r.json());
  if (reply.error) throw new Error(reply.error.message);
  const bytes = Buffer.from(reply.result.slice(0, -2), "hex"); // drop the empty signature list
  console.log(crypto.createHash("sha256").update(Buffer.concat([CHAIN_ID, bytes])).digest("hex"));
}

main().catch((e) => { console.error(e.message); process.exit(1); });

Save a transaction with fixed header values as tx.json:

JSON{
  "ref_block_num": 1234,
  "ref_block_prefix": 1122334455,
  "expiration": "2026-10-05T18:00:00",
  "operations": [["transfer", {"from": "alice", "to": "bob", "amount": "1.000 PIXA", "memo": "hi"}]],
  "extensions": []
}

Shellnode expected-digest.js tx.json

Expected output:

4f7c6ec6c03d03f1f4fc4a3746cb9a01da44a02af29ce28e4382c6ffb00c3e0a

Then compute the digest of the same transaction with the library under test. With dpixa it is cryptoUtils.transactionDigest(tx, chainId).toString("hex"), which gives the same value. If your library prints anything else, signatures it makes for that operation will be rejected. Repeat the test for every operation type you use.

Other @pixagram packages

The Pixagram app is built from these packages, published under the @pixagram scope. Each can be used on its own.

Tools

Sources

• dpixa 1.5.4 on npm; source at commit fddb47d: options in src/client.ts:131-180; testnet in src/client.ts:288-300 and src/parameters.ts; amounts in src/chain/asset.ts:86-98; broadcast in src/helpers/broadcast.ts:312-363; witness properties in src/utils.ts:207-271.
• Package versions and licences: https://registry.npmjs.org/@pixagram/<name>/latest, read on 2026-10-05. Descriptions from the developer site, pixa.org.
• dhive 1.3.2, tested on 2026-10-05.
• witness-status at commit a376149: exit codes in its README.