axiomax-esg-verify

Reference verifier for AXIOMAX ESG Carbon Shield cryptographic carbon attestation tokens.

Patent Pending USPTO Application 64/081,419 (filed June 3, 2026). Operated by AXIOMAX LLC, Salinas, Puerto Rico.

Install

npm install axiomax-esg-verify

Works in Node.js (>= 18) and modern browsers (Web Crypto API ed25519).

Usage

import { verifyToken } from 'axiomax-esg-verify';

const token = JSON.parse(fs.readFileSync('token.json', 'utf-8'));
const publicKeyPem = fs.readFileSync('client_public.pem', 'utf-8');

const result = await verifyToken(token, publicKeyPem);

if (result.valid) {
  console.log(`✓ VALID · ${result.n_inferences} inferences certified · ${result.total_wh_saved} Wh saved`);
} else {
  console.error(`✗ INVALID · ${result.reason}`);
}

How it works

Every AXIOMAX ESG attestation token is signed with ed25519 against a per-client public key. This package implements the canonical verification algorithm:

1. Remove the signature_ed25519 field from the token
2. Canonicalize the remaining JSON (sorted keys, minimal separators)
3. Verify the ed25519 signature over those bytes using the client's public key

If any field in the token has been tampered with, the signature check fails.

Client public keys

Master and per-client public keys are published at https://github.com/axiomaxllc/esg-carbon-shield/tree/main/public_keys

License

MIT License for this package. The AXIOMAX ESG Carbon Shield system architecture, calibration coefficients, and brand are proprietary to AXIOMAX LLC (Patent Pending).

Links

• Main: https://axiomaxllc.com
• Hosted verifier: https://verify.axiomaxllc.com
• Browser-side mirror: https://axiomaxllc.github.io/esg-carbon-shield
• Specification: https://github.com/axiomaxllc/esg-carbon-shield