@agent-receipts/crypto

Ed25519 signing and verification for the Action Receipt Protocol.

Install

npm install @agent-receipts/crypto

Usage

import {
  generateKeyPair,
  signReceipt,
  verifyReceipt,
  getSignablePayload,
  getPublicKeyFromPrivate,
} from '@agent-receipts/crypto'

// Generate a new Ed25519 key pair
const { privateKey, publicKey } = generateKeyPair()

// Sign a receipt
const signable = getSignablePayload(receipt)
const signature = signReceipt(signable, privateKey)

// Verify a receipt
const valid = verifyReceipt(signable, signature, publicKey)

// Derive public key from private
const pub = getPublicKeyFromPrivate(privateKey)

API

Function	Description
`generateKeyPair()`	Generate an Ed25519 key pair (returns `{ privateKey, publicKey }` as hex strings)
`signReceipt(payload, privateKey)`	Sign a canonical payload, returns hex signature
`verifyReceipt(payload, signature, publicKey)`	Verify a signature against a payload and public key
`getSignablePayload(receipt)`	Extract the deterministic signable fields from a receipt
`getPublicKeyFromPrivate(privateKey)`	Derive the public key from a private key
`canonicalize(obj)`	Deterministic JSON serialization for signing

Key Generation CLI

npx @agent-receipts/crypto generate-keys

Outputs RECEIPT_SIGNING_PRIVATE_KEY and RECEIPT_SIGNING_PUBLIC_KEY for your .env file.

License

MIT