ack-receipts
v0.1.0
Published
On-chain delivery acknowledgment receipts for Solana.
Maintainers
Readme
ack?
Two parties. One shared record. On-chain delivery receipts for Solana.

A client creates a receipt. A provider signs a delivery claim with a response hash. The client signs an acknowledgment. A small Anchor program enforces that order and stores the record in a PDA.
Records signed claims, not proof of delivery or correctness. No response content is stored on-chain. Public hashes can still reveal guessable content.
Run with npm
Requires Node.js 22.18+.
npx ack-receipts --helpThe npm package includes the CLI and read-only dashboard. Use npx ack-receipts dashboard --network devnet --program-id PROGRAM_PUBLIC_KEY to view your own deployment. Building or deploying the Rust program requires the source checkout below.
Run locally
Install Node.js 22.18+, Anchor 1.2.1 and Solana CLI 4.1.2, including the local validator and SBF tools.
git clone https://github.com/royalpinto007/ack.git
cd ack
npm install
npm run program:build
npm run demoThe demo starts a local validator, signs real transactions with disposable local keys, and serves the read-only dashboard at http://127.0.0.1:4440. It uses local test SOL for account rent. No wallet extension, database or hosted service.
Explore
- Program:
create_receipt,mark_delivered,acknowledge. - CLI: create, sign and inspect receipts as JSON.
- Dashboard: filter receipts, follow signed transitions and copy public values.
- Tests: authorization, PDAs, state transitions and browser behavior.
Read the guide, architecture and optional Devnet setup. The dashboard includes the guide and architecture pages too.
Check
Stop the demo first. Program and browser tests each start their own local validator.
npm run check
npm run test:program
npm run test:e2eSee contributing for the test prerequisites. Report a bug or share feedback.
