@uzproof/verify 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @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)](https://github.com/solana-foundation/solana-attestation-service).
+
+## Install
+
+```bash
+npm install @uzproof/verify
+```
+
+## Quick Start
+
+```typescript
+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
+
+```typescript
+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
+
+```typescript
+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
+
+```typescript
+const token = await client.getTokenInfo('JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN');
+// token.symbol = "JUP"
+// token.priceUsd = 0.143
+```
+
+### `getAttestation(wallet)` — Check on-chain SAS attestation
+
+```typescript
+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:** `9FQiiMtroSHP2Ewqfh3D94GPKnDjmeLT2ftqJ3E7QyWc`
+
+## Links
+
+- Website: https://uzproof.com
+- Docs: https://uzproof.com/docs
+- Twitter: https://x.com/uzproof
+- Telegram: https://t.me/uz_proof
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @uzproof/verify — Proof-of-Use verification SDK for Solana
+ *
+ * Verify real on-chain usage: swaps, staking, token holds, NFTs, and more.
+ * First Proof-of-Use attestor on Solana Attestation Service (SAS).
+ *
+ * @example
+ * ```typescript
+ * import { UzproofClient } from '@uzproof/verify';
+ *
+ * const client = new UzproofClient({ apiKey: 'your-key' });
+ *
+ * const result = await client.verify({
+ *   wallet: '7H4RVL...',
+ *   action: 'defi_swap',
+ *   config: { program_id: 'JUP6Lk...' }
+ * });
+ *
+ * console.log(result.verified); // true
+ * ```
+ */
+export interface UzproofConfig {
+    /** API key for authenticated requests */
+    apiKey?: string;
+    /** Base URL (default: https://uzproof.com) */
+    baseUrl?: string;
+}
+export type ActionType = "defi_swap" | "defi_swap_buy" | "defi_swap_sell" | "defi_swap_volume" | "defi_hold_token" | "defi_hold_stablecoin" | "defi_hold_staked" | "defi_hold_token_duration" | "defi_hold_lp" | "defi_stake_sol" | "defi_add_liquidity" | "defi_bridge" | "defi_lend" | "defi_borrow" | "defi_vote" | "defi_repay" | "defi_claim" | "defi_create_lst" | "nft_hold" | "nft_mint" | "nft_check" | "token_balance" | "tx_verify" | "gaming_play";
+export interface VerifyRequest {
+    /** Solana wallet address to verify */
+    wallet: string;
+    /** Type of on-chain action to verify */
+    action: ActionType;
+    /** Action-specific configuration */
+    config?: {
+        /** Solana program ID to verify against */
+        program_id?: string;
+        /** SPL token mint address */
+        token_mint?: string;
+        /** Minimum amount in USD */
+        min_amount_usd?: number;
+        /** Minimum token amount */
+        min_amount?: number;
+        /** Minimum SOL amount */
+        min_amount_sol?: number;
+        /** NFT collection address */
+        collection_address?: string;
+        /** Specific NFT mint address */
+        nft_mint?: string;
+        /** Minimum trading volume in USD */
+        min_volume_usd?: number;
+    };
+}
+export interface VerifyResult {
+    /** Whether the action was verified */
+    verified: boolean;
+    /** Type of action verified */
+    taskType: string;
+    /** Detailed verification data */
+    result: {
+        /** Number of matching transactions found */
+        matchingTxCount?: number;
+        /** Transaction signatures */
+        matchingSignatures?: string[];
+        /** Estimated volume in USD */
+        totalVolumeEstimate?: number;
+        /** Token balance */
+        balance?: number;
+        /** Staked amount in SOL */
+        stakedSol?: number;
+        /** NFT count */
+        nftCount?: number;
+        /** Transaction signature */
+        signature?: string;
+        /** Whether the check passed */
+        verified?: boolean;
+        /** Error message if failed */
+        error?: string;
+    };
+}
+export interface ContractDetectResult {
+    /** Whether the program was recognized */
+    detected: boolean;
+    /** Program information */
+    program?: {
+        name: string;
+        category: string;
+        supportedActions: string[];
+    };
+    /** Suggested quest template */
+    questTemplate?: {
+        suggestedTitle: string;
+        suggestedDescription: string;
+        suggestedTasks: Array<{
+            type: string;
+            config: Record<string, unknown>;
+        }>;
+    };
+}
+export interface TokenInfo {
+    mint: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    supply: number;
+    priceUsd: number | null;
+}
+export interface AttestationStatus {
+    /** Whether wallet has on-chain SAS attestation */
+    hasAttestation: boolean;
+    /** Attestation PDA address on Solana */
+    attestation: string | null;
+    /** Solana Explorer link */
+    explorer?: string;
+}
+export declare class UzproofClient {
+    private baseUrl;
+    private apiKey?;
+    constructor(config?: UzproofConfig);
+    private request;
+    /**
+     * Verify that a wallet performed a specific on-chain action.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.verify({
+     *   wallet: '7H4RVL...',
+     *   action: 'defi_swap',
+     *   config: { min_amount_usd: 5 }
+     * });
+     * ```
+     */
+    verify(req: VerifyRequest): Promise<VerifyResult>;
+    /**
+     * Auto-detect a Solana program and get suggested quest types.
+     * Supports 14 protocols: Jupiter, Marinade, Orca, Raydium, etc.
+     *
+     * @example
+     * ```typescript
+     * const info = await client.detectContract('JUP6Lk...');
+     * // info.program.name = "Jupiter Aggregator v6"
+     * ```
+     */
+    detectContract(programId: string): Promise<ContractDetectResult>;
+    /**
+     * Fetch SPL token metadata and live price by mint address.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.getTokenInfo('JUPyiwr...');
+     * // token.symbol = "JUP", token.priceUsd = 0.143
+     * ```
+     */
+    getTokenInfo(mint: string): Promise<TokenInfo>;
+    /**
+     * Check if a wallet has an on-chain Proof-of-Use attestation
+     * on the Solana Attestation Service (SAS).
+     *
+     * @example
+     * ```typescript
+     * const status = await client.getAttestation('7H4RVL...');
+     * // status.hasAttestation = true
+     * // status.explorer = "https://explorer.solana.com/address/..."
+     * ```
+     */
+    getAttestation(wallet: string): Promise<AttestationStatus>;
+}
+/** Solana Attestation Service program ID */
+export declare const SAS_PROGRAM_ID = "22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG";
+/** UZPROOF credential PDA on SAS */
+export declare const UZPROOF_CREDENTIAL = "2chgBfvkwhnHQVVAyXKDK6CBjbCRMQ8aLWrysL5UQyyF";
+/** Proof-of-Use schema PDA on SAS */
+export declare const POU_SCHEMA = "9FQiiMtroSHP2Ewqfh3D94GPKnDjmeLT2ftqJ3E7QyWc";
+/** All supported action types */
+export declare const ACTION_TYPES: ActionType[];
+/** Supported protocols for contract detection */
+export declare const SUPPORTED_PROTOCOLS: readonly ["Jupiter", "Marinade", "Sanctum", "Orca", "Raydium", "Drift", "Kamino", "MarginFi", "Meteora", "Jito", "Tensor", "Magic Eden", "Metaplex", "SPL Token"];

package/dist/index.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * @uzproof/verify — Proof-of-Use verification SDK for Solana
+ *
+ * Verify real on-chain usage: swaps, staking, token holds, NFTs, and more.
+ * First Proof-of-Use attestor on Solana Attestation Service (SAS).
+ *
+ * @example
+ * ```typescript
+ * import { UzproofClient } from '@uzproof/verify';
+ *
+ * const client = new UzproofClient({ apiKey: 'your-key' });
+ *
+ * const result = await client.verify({
+ *   wallet: '7H4RVL...',
+ *   action: 'defi_swap',
+ *   config: { program_id: 'JUP6Lk...' }
+ * });
+ *
+ * console.log(result.verified); // true
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_PROTOCOLS = exports.ACTION_TYPES = exports.POU_SCHEMA = exports.UZPROOF_CREDENTIAL = exports.SAS_PROGRAM_ID = exports.UzproofClient = void 0;
+/* ------------------------------------------------------------------ */
+/*  Client                                                             */
+/* ------------------------------------------------------------------ */
+class UzproofClient {
+    constructor(config = {}) {
+        this.baseUrl = (config.baseUrl || "https://uzproof.com").replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+    }
+    async request(method, path, body) {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            throw new Error(`UZPROOF API error: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    /* ---- Verification ---- */
+    /**
+     * Verify that a wallet performed a specific on-chain action.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.verify({
+     *   wallet: '7H4RVL...',
+     *   action: 'defi_swap',
+     *   config: { min_amount_usd: 5 }
+     * });
+     * ```
+     */
+    async verify(req) {
+        const data = await this.request("POST", "/api/verify", {
+            wallet: req.wallet,
+            taskType: req.action,
+            config: req.config || {},
+        });
+        return {
+            verified: data.verified,
+            taskType: data.taskType,
+            result: data.result,
+        };
+    }
+    /* ---- Contract Detection ---- */
+    /**
+     * Auto-detect a Solana program and get suggested quest types.
+     * Supports 14 protocols: Jupiter, Marinade, Orca, Raydium, etc.
+     *
+     * @example
+     * ```typescript
+     * const info = await client.detectContract('JUP6Lk...');
+     * // info.program.name = "Jupiter Aggregator v6"
+     * ```
+     */
+    async detectContract(programId) {
+        return this.request("POST", "/api/contracts/detect", {
+            programId,
+        });
+    }
+    /* ---- Token Info ---- */
+    /**
+     * Fetch SPL token metadata and live price by mint address.
+     *
+     * @example
+     * ```typescript
+     * const token = await client.getTokenInfo('JUPyiwr...');
+     * // token.symbol = "JUP", token.priceUsd = 0.143
+     * ```
+     */
+    async getTokenInfo(mint) {
+        const data = await this.request("GET", `/api/tokens/info?mint=${encodeURIComponent(mint)}`);
+        return data.data;
+    }
+    /* ---- SAS Attestation ---- */
+    /**
+     * Check if a wallet has an on-chain Proof-of-Use attestation
+     * on the Solana Attestation Service (SAS).
+     *
+     * @example
+     * ```typescript
+     * const status = await client.getAttestation('7H4RVL...');
+     * // status.hasAttestation = true
+     * // status.explorer = "https://explorer.solana.com/address/..."
+     * ```
+     */
+    async getAttestation(wallet) {
+        const data = await this.request("GET", `/api/sas/status?wallet=${encodeURIComponent(wallet)}`);
+        return {
+            hasAttestation: data.hasAttestation,
+            attestation: data.attestation,
+            explorer: data.explorer,
+        };
+    }
+}
+exports.UzproofClient = UzproofClient;
+/* ------------------------------------------------------------------ */
+/*  Constants                                                          */
+/* ------------------------------------------------------------------ */
+/** Solana Attestation Service program ID */
+exports.SAS_PROGRAM_ID = "22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG";
+/** UZPROOF credential PDA on SAS */
+exports.UZPROOF_CREDENTIAL = "2chgBfvkwhnHQVVAyXKDK6CBjbCRMQ8aLWrysL5UQyyF";
+/** Proof-of-Use schema PDA on SAS */
+exports.POU_SCHEMA = "9FQiiMtroSHP2Ewqfh3D94GPKnDjmeLT2ftqJ3E7QyWc";
+/** All supported action types */
+exports.ACTION_TYPES = [
+    "defi_swap", "defi_swap_buy", "defi_swap_sell", "defi_swap_volume",
+    "defi_hold_token", "defi_hold_stablecoin", "defi_hold_staked",
+    "defi_hold_token_duration", "defi_hold_lp",
+    "defi_stake_sol", "defi_add_liquidity", "defi_bridge",
+    "defi_lend", "defi_borrow", "defi_vote", "defi_repay",
+    "defi_claim", "defi_create_lst",
+    "nft_hold", "nft_mint", "nft_check",
+    "token_balance", "tx_verify", "gaming_play",
+];
+/** Supported protocols for contract detection */
+exports.SUPPORTED_PROTOCOLS = [
+    "Jupiter", "Marinade", "Sanctum", "Orca", "Raydium",
+    "Drift", "Kamino", "MarginFi", "Meteora", "Jito",
+    "Tensor", "Magic Eden", "Metaplex", "SPL Token",
+];

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@uzproof/verify",
+  "version": "1.0.0",
+  "description": "Proof-of-Use verification SDK for Solana. Verify real on-chain usage — swaps, staking, token holds, NFTs, and more.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["solana", "verification", "proof-of-use", "defi", "nft", "attestation", "sas", "uzproof"],
+  "author": "UZPROOF <hello@uzproof.com>",
+  "license": "MIT",
+  "homepage": "https://uzproof.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uzproof/uzproof"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}