@uzproof/verify

Proof-of-Use verification SDK for Solana. Verify real on-chain usage — swaps, staking, token holds, NFTs, and more.

UZPROOF is the first Proof-of-Use Attestor on the Solana Attestation Service (SAS).

Install

npm install @uzproof/verify

Quick Start

import { UzproofClient } from '@uzproof/verify';

const client = new UzproofClient();

// Verify a swap on Jupiter
const result = await client.verify({
  wallet: '7H4RVLZfGLBvY6k1DdmGSUcCKCw6nJG28emTztkyyrLZ',
  action: 'defi_swap',
  config: { min_amount_usd: 5 }
});

console.log(result.verified); // true
console.log(result.result.matchingTxCount); // 3

API

verify(request) — Verify on-chain action

const result = await client.verify({
  wallet: 'WALLET_ADDRESS',
  action: 'defi_swap',        // 24 auto-verified action types
  config: {
    program_id: 'JUP6Lk...',  // Optional: specific program
    min_amount_usd: 10,        // Optional: minimum value
    token_mint: 'So11...',     // Optional: specific token
  }
});

detectContract(programId) — Auto-detect protocol

const info = await client.detectContract('JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4');
// info.program.name = "Jupiter Aggregator v6"
// info.program.supportedActions = ["defi_swap", "defi_swap_buy", "defi_swap_sell"]

getTokenInfo(mint) — Fetch token metadata + price

const token = await client.getTokenInfo('JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN');
// token.symbol = "JUP"
// token.priceUsd = 0.143

getAttestation(wallet) — Check on-chain SAS attestation

const status = await client.getAttestation('7H4RVL...');
// status.hasAttestation = true
// status.explorer = "https://explorer.solana.com/address/..."

Supported Actions (24 auto-verified)

| Category | Actions | |----------|---------| | DeFi | defi_swap, defi_swap_buy, defi_swap_sell, defi_swap_volume, defi_hold_token, defi_hold_stablecoin, defi_stake_sol, defi_hold_staked, defi_lend, defi_borrow, defi_vote, defi_repay, defi_claim | | On-Chain | nft_hold, nft_check, token_balance, tx_verify, gaming_play |

Supported Protocols (14)

Jupiter, Marinade, Sanctum, Orca, Raydium, Drift, Kamino, MarginFi, Meteora, Jito, Tensor, Magic Eden, Metaplex, SPL Token.

On-Chain (SAS)

UZPROOF attestations are stored on Solana mainnet via the Solana Attestation Service:

• SAS Program: 22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG
• Credential: 2chgBfvkwhnHQVVAyXKDK6CBjbCRMQ8aLWrysL5UQyyF
• Schema (v2): 8yW2BboQuhp2MMmrQLFz35V6VSqC48MF7wZ5bmzcTeTF

Links

• Website: https://uzproof.com
• Docs: https://uzproof.com/docs
• Twitter: https://x.com/uzproof
• Telegram: https://t.me/uz_proof

License

MIT