Help Center

API Key Not Working

Ensure your API key is correctly formatted and included in the request headers:

Authorization: Bearer prov_live_your_key_here

Signature Verification Failing

Common causes:

• Text has been modified after signing
• Whitespace changes (trailing spaces, line endings)
• Manifest doesn't match the signed text
• Signature format is incorrect

Rate Limit Exceeded

You've hit your monthly quota. Options:

• Upgrade your plan
• Wait for quota reset (1st of each month)
• Contact sales for temporary quota increase

CORS Errors

The Provenix API requires proper CORS headers. If calling from the browser:

• Make requests from your registered domain
• Contact support to whitelist additional domains
• Or call the API from your backend instead

SDK Installation

Install via npm or yarn:

npm install @provenix/sdk
# or
yarn add @provenix/sdk

Basic Integration Example

import { ProvenixClient } from '@provenix/sdk'

const client = new ProvenixClient({
  apiKey: process.env.PROVENIX_API_KEY
})

const result = await client.sign('Your text here')
console.log(result.verificationUrl)

Environment Variables

Store your API key securely in environment variables. Never commit keys to version control.

# .env
PROVENIX_API_KEY=prov_live_your_key_here

Why is Verification Failing?

Verification fails when the text or manifest has been tampered with. Here's the verification process:

1. Compute SHA-256 hash of submitted text
2. Compare hash against manifest.hash
3. Verify Ed25519 signature against manifest
4. All three must match for verification to succeed

Even a single character change will cause verification to fail. This is intentional cryptographic behavior.

Contact Support

Still stuck? We're here to help.