@parad0x_labs/liquefy-receipts

@dna-x402/liquefy-receipts

Columnar compression + bilateral netting + AES-256-GCM encryption for x402 AI agent payment receipt batches.

1,000 receipts → 1 on-chain Solana tx. 62× compression. Private amounts.

Part of the DNA x402 stack — the x402 payment rail for AI agents on Solana.

Install

npm install @dna-x402/liquefy-receipts

Quick start

import {
  compressReceipts,
  decompressReceipts,
  netReceipts,
  buildReceiptRoot,
  verifyReceiptInBatch,
  buildAnchorIxData,
  generateKey,
  encryptBlob,
} from "@dna-x402/liquefy-receipts";

// Net bilateral flows (1000 receipts → a handful of settlements)
const nets = netReceipts(receipts);

// Compress 62× (columnar, based on Liquefy Columnar Gun v1)
const compressed = compressReceipts(receipts);

// Encrypt (AES-256-GCM — only parties see amounts)
const key  = await generateKey();
const blob = await encryptBlob(compressed, key);

// Build Merkle root (streaming, O(log N) memory — any batch → 32 bytes).
// Pass a 32-byte per-batch secret to get SALTED leaves so the public on-chain
// root can't be brute-forced from low-entropy receipt fields. Keep the secret
// with the encrypted blob (e.g. archiveReceipts() stores it inside the ciphertext).
import { randomBytes } from "node:crypto";
const batchSecret = randomBytes(32);
const root = buildReceiptRoot(receipts, batchSecret);   // omit batchSecret for the legacy unsalted root

// Verify any receipt is in the batch (a salted tree's proofs carry their per-leaf salt)
const proof    = new MerkleTree(receipts, batchSecret).proof(42);
const verified = verifyReceiptInBatch(receipts[42], proof);

// Anchor instruction for receipt_anchor program (live on Solana mainnet)
const ixData = buildAnchorIxData({
  batchBytes: compressed,
  receiptCount: receipts.length,
  epochId: Math.floor(Date.now() / 86_400_000),
  encrypted: false,
});

What it does

Compression algorithm

Based on Liquefy Columnar Gun v1:

• Transpose array-of-receipts into columns
• Delta encode numerics (amounts, timestamps)
• Dictionary encode low-cardinality strings (receivers, program IDs)
• Deflate each column independently
• Same receiver 1000× → stored once

On-chain programs (Solana mainnet)

License

MIT — Parad0x Labs