Open source CLI for verifying agentsystems-notary logs against Arweave blockchain
npm install agentsystems-verifyOpen source CLI for verifying agentsystems-notary logs against Arweave blockchain.
Open source, independent verification. No API keys. No AgentSystems infrastructure required.
``bash`
npm install -g agentsystems-verify
Or run directly with npx:
`bash`
npx agentsystems-verify --ticket ticket.json --logs logs.zip
Three ways to run:
`bash1. Using a ticket file
agentsystems-verify --ticket ticket.json --logs logs.zip
$3
| Option | Short | Description |
|--------|-------|-------------|
|
--ticket | -t | Arweave verification ticket (JSON file) |
| --logs | -l | ZIP file containing log files to verify |
| --owner | -o | Arweave wallet address |
| --namespace | -n | Namespace identifier |
| --start | -s | Start date (YYYY-MM-DD) |
| --end | -e | End date (YYYY-MM-DD) |
| --help | -h | Show help message |
| --version | -v | Show version number |$3
`json
{
"type": "arweave",
"owner": "",
"namespace": "",
"date_start": "2026-01-01",
"date_end": "2026-01-31"
}
`The ticket is generated by the agentsystems-notary SDK. It contains:
-
owner - Arweave wallet address (derived from KMS public key)
- namespace - Your namespace identifier
- date_start / date_end - Date range to verifyHow It Works
1. Reads log files from your ZIP archive
2. Computes SHA-256 hashes (canonicalized JSON)
3. Queries Arweave blockchain for matching transactions
4. Reconciles: verified, unnotarized, missing
You can audit the code yourself.
Library Usage
`typescript
import { verify, validateTicket } from "agentsystems-verify";
import { readFileSync } from "fs";const ticket = validateTicket(JSON.parse(readFileSync("ticket.json", "utf-8")));
const zipBuffer = readFileSync("logs.zip");
const results = await verify(ticket, zipBuffer, {
onProgress: (msg) => console.log(msg),
});
console.log(
Verified: ${results.verified.length});
console.log(Unnotarized: ${results.unnotarized.length});
console.log(Missing: ${results.missing.length});
`Why This Exists
The agentsystems-notary SDK writes tamper-evident logs to Arweave. This CLI provides open source, independent verification - no need to trust AgentSystems' verify-ui or verify-api.
`
SDK (write) → Arweave blockchain → This CLI (verify)
↓ ↓
Open source Open source
No API required No API required
``Apache-2.0