noah-clarity 0.3.3 → 0.3.5

package/dist/config.d.ts

@@ -32,6 +32,7 @@ export declare function createSDKConfig(addresses: ContractAddresses, options?:
 }): {
     kycRegistryAddress: string;
     attesterRegistryAddress: string;
+    revocationRegistryAddress: string;
     network: "testnet" | "mainnet" | "devnet";
     proverServiceUrl: string;
     attesterServiceUrl: string;

package/dist/config.js

@@ -8,9 +8,9 @@ export const TESTNET_CONTRACTS = {
     network: 'testnet',
     deployer: 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS',
     contracts: {
-        'attester-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.attester-registry',
+        'attester-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.Attester-registry',
         'attester-registry-trait': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.attester-registry-trait',
-        'kyc-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.kycs-registry',
+        'kyc-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.KYc-registry',
         'revocation': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.revocation',
     },
     deployment_date: '2025-01-17',
@@ -40,6 +40,7 @@ export function createSDKConfig(addresses, options) {
     return {
         kycRegistryAddress: addresses.contracts['kyc-registry'],
         attesterRegistryAddress: addresses.contracts['attester-registry'],
+        revocationRegistryAddress: addresses.contracts['revocation'],
         network: addresses.network,
         proverServiceUrl: options?.proverServiceUrl || 'http://localhost:8080',
         attesterServiceUrl: options?.attesterServiceUrl || 'http://localhost:8081',

package/dist/contract.d.ts

@@ -20,11 +20,23 @@ export declare class KYCContract {
      * @returns KYC status
      */
     hasKYC(userPrincipal: string): Promise<KYCStatus>;
+    /**
+     * Get revocation root from the revocation registry contract
+     * @returns Revocation root (32-byte hex string) or null if contract not configured
+     */
+    getRevocationRoot(): Promise<string | null>;
+    /**
+     * Check if a commitment is revoked by checking the revocation root
+     * Note: This is a simplified check. For full verification, non-membership proofs are needed.
+     * @param commitment Commitment to check (hex string)
+     * @returns true if revoked, false if not revoked or if revocation checking is unavailable
+     */
+    isCommitmentRevoked(commitment: string): Promise<boolean>;
     /**
      * Check if KYC is valid
-     * Since KYC records don't expire, this is equivalent to hasKYC
+     * Now includes revocation checking
      * @param userPrincipal User's Stacks principal
-     * @returns true if KYC is valid
+     * @returns true if KYC is valid (exists and not revoked)
      */
     isKYCValid(userPrincipal: string): Promise<boolean>;
     /**

package/dist/contract.js

@@ -239,6 +239,9 @@ export class KYCContract {
      */
     async hasKYC(userPrincipal) {
         const { address, name } = this.parseContractAddress(this.config.kycRegistryAddress);
+        // #region agent log
+        fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'contract.ts:269', 'message': 'hasKYC called', 'data': { userPrincipal, contractAddress: this.config.kycRegistryAddress, parsedAddress: address, parsedName: name }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'A' }) }).catch(() => { });
+        // #endregion agent log
         try {
             const result = await callReadOnlyFunction({
                 contractAddress: address,
@@ -248,30 +251,117 @@ export class KYCContract {
                 network: this.network,
                 senderAddress: address, // Use contract address as sender for read-only calls
             });
+            // #region agent log
+            console.log('hasKYC callReadOnlyFunction result (before cvToJSON):', result);
+            console.log('hasKYC result type:', typeof result);
+            console.log('hasKYC result constructor:', result?.constructor?.name);
+            fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'contract.ts:277', 'message': 'hasKYC callReadOnlyFunction result', 'data': { userPrincipal, resultType: typeof result, resultConstructor: result?.constructor?.name, resultString: String(result) }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run2', hypothesisId: 'A' }) }).catch(() => { });
+            // #endregion agent log
             const jsonResult = cvToJSON(result);
-            // Result is (ok bool), so check if it's ok and the value is true
-            if (jsonResult.type === 'responseOk') {
-                const hasKYC = jsonResult.value.value === true;
+            // #region agent log
+            console.log('hasKYC raw result (after cvToJSON):', JSON.stringify(jsonResult, null, 2));
+            console.log('hasKYC jsonResult.type:', jsonResult.type);
+            console.log('hasKYC jsonResult.value:', jsonResult.value);
+            console.log('hasKYC jsonResult.value type:', typeof jsonResult.value);
+            console.log('hasKYC jsonResult.success:', jsonResult.success);
+            fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'contract.ts:290', 'message': 'hasKYC result after cvToJSON', 'data': { userPrincipal, resultType: jsonResult.type, resultValue: jsonResult.value, resultValueType: typeof jsonResult.value, resultSuccess: jsonResult.success, fullResult: JSON.stringify(jsonResult) }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run2', hypothesisId: 'B' }) }).catch(() => { });
+            // #endregion agent log
+            // Result is (ok bool), cvToJSON returns:
+            // { type: '(response bool UnknownType)', value: { type: 'bool', value: true }, success: true }
+            // Check success field or response type, then extract boolean from value.value
+            if (jsonResult.success === true || (jsonResult.type && jsonResult.type.includes('response'))) {
+                // Extract the boolean value from the nested structure
+                const boolValue = jsonResult.value?.value;
+                const hasKYC = boolValue === true;
+                console.log('hasKYC final result:', hasKYC, 'jsonResult.value.value:', boolValue, 'type:', typeof boolValue);
                 return { hasKYC };
             }
             else {
+                console.log('hasKYC: response not ok, type:', jsonResult.type, 'success:', jsonResult.success, 'full result:', JSON.stringify(jsonResult));
                 return { hasKYC: false };
             }
         }
         catch (error) {
+            // #region agent log
+            console.error('hasKYC exception:', error);
+            fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ location: 'contract.ts:294', 'message': 'hasKYC error', 'data': { userPrincipal, error: error instanceof Error ? error.message : String(error), errorStack: error instanceof Error ? error.stack : undefined }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'A' }) }).catch(() => { });
+            // #endregion agent log
             console.error('Error checking KYC status:', error);
             return { hasKYC: false };
         }
     }
+    /**
+     * Get revocation root from the revocation registry contract
+     * @returns Revocation root (32-byte hex string) or null if contract not configured
+     */
+    async getRevocationRoot() {
+        if (!this.config.revocationRegistryAddress) {
+            return null;
+        }
+        const { address, name } = this.parseContractAddress(this.config.revocationRegistryAddress);
+        try {
+            const result = await callReadOnlyFunction({
+                contractAddress: address,
+                contractName: name,
+                functionName: 'get-revocation-root',
+                functionArgs: [],
+                network: this.network,
+                senderAddress: address,
+            });
+            const jsonResult = cvToJSON(result);
+            // Result is (ok (buff 32))
+            if (jsonResult.success === true || (jsonResult.type && jsonResult.type.includes('response'))) {
+                const rootValue = jsonResult.value?.value;
+                if (rootValue) {
+                    // Convert buffer to hex string
+                    return rootValue.startsWith('0x') ? rootValue : `0x${rootValue}`;
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            console.error('Error fetching revocation root:', error);
+            return null;
+        }
+    }
+    /**
+     * Check if a commitment is revoked by checking the revocation root
+     * Note: This is a simplified check. For full verification, non-membership proofs are needed.
+     * @param commitment Commitment to check (hex string)
+     * @returns true if revoked, false if not revoked or if revocation checking is unavailable
+     */
+    async isCommitmentRevoked(commitment) {
+        const root = await this.getRevocationRoot();
+        // If no revocation registry configured or root is zero (empty tree), nothing is revoked
+        if (!root || root === '0x0000000000000000000000000000000000000000000000000000000000000000') {
+            return false;
+        }
+        // TODO: Full revocation checking requires non-membership proof verification
+        // For now, we return false (not revoked) when root exists but we can't verify without proof
+        // In production, you should:
+        // 1. Request a non-membership proof from the attester service
+        // 2. Verify the proof using Merkle tree verification
+        // 3. Return true if proof verification fails or if commitment is in revocation tree
+        return false;
+    }
     /**
      * Check if KYC is valid
-     * Since KYC records don't expire, this is equivalent to hasKYC
+     * Now includes revocation checking
      * @param userPrincipal User's Stacks principal
-     * @returns true if KYC is valid
+     * @returns true if KYC is valid (exists and not revoked)
      */
     async isKYCValid(userPrincipal) {
-        const status = await this.hasKYC(userPrincipal);
-        return status.hasKYC;
+        // First check if user has KYC record
+        const kycDetails = await this.getKYC(userPrincipal);
+        if (!kycDetails || !kycDetails.hasKYC || !kycDetails.commitment) {
+            return false;
+        }
+        // Check revocation status
+        const isRevoked = await this.isCommitmentRevoked(kycDetails.commitment);
+        if (isRevoked) {
+            return false;
+        }
+        return true;
     }
     /**
      * Get KYC details for a user
@@ -293,12 +383,20 @@ export class KYCContract {
             // Result is (ok (some kyc-record)) or (ok none)
             if (jsonResult.type === 'responseOk' && jsonResult.value.type === 'optionalSome') {
                 const record = jsonResult.value.value.value;
-                return {
+                const result = {
                     hasKYC: true,
                     commitment: record.commitment?.value,
                     attesterId: record['attester-id']?.value,
                     registeredAt: record['registered-at']?.value,
                 };
+                // Add history fields if present
+                if (record['previous-commitment']?.value) {
+                    result.previousCommitment = record['previous-commitment'].value;
+                }
+                if (record['previous-registered-at']?.value !== undefined) {
+                    result.previousRegisteredAt = record['previous-registered-at'].value;
+                }
+                return result;
             }
             else {
                 return null;

package/dist/types.d.ts

@@ -6,6 +6,8 @@ export interface KYCStatus {
     commitment?: string;
     attesterId?: number;
     registeredAt?: number;
+    previousCommitment?: string;
+    previousRegisteredAt?: number;
 }
 export interface RegisterKYCParams {
     commitment: string;
@@ -46,6 +48,7 @@ export interface AttestationResponse {
 export interface SDKConfig {
     kycRegistryAddress: string;
     attesterRegistryAddress: string;
+    revocationRegistryAddress?: string;
     proverServiceUrl?: string;
     attesterServiceUrl?: string;
     network?: 'mainnet' | 'testnet' | 'devnet';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noah-clarity",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "TypeScript SDK for Noah-v2 KYC system on Stacks",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",