noah-clarity 0.3.1 → 0.3.3

package/dist/config.js

@@ -1,21 +1,16 @@
-"use strict";
 /**
  * Configuration loader for contract addresses
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TESTNET_CONTRACTS = void 0;
-exports.loadContractAddresses = loadContractAddresses;
-exports.createSDKConfig = createSDKConfig;
 /**
  * Default testnet contract addresses (deployed)
  */
-exports.TESTNET_CONTRACTS = {
+export const TESTNET_CONTRACTS = {
     network: 'testnet',
     deployer: 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS',
     contracts: {
         'attester-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.attester-registry',
         'attester-registry-trait': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.attester-registry-trait',
-        'kyc-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.kyc-registry',
+        'kyc-registry': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.kycs-registry',
         'revocation': 'STVAH96MR73TP2FZG2W4X220MEB4NEMJHPMVYQNS.revocation',
     },
     deployment_date: '2025-01-17',
@@ -26,14 +21,14 @@ exports.TESTNET_CONTRACTS = {
  * In browser environments, this can load from a static JSON file
  * In Node.js, can use fs to read the JSON file
  */
-function loadContractAddresses(network = 'testnet') {
+export function loadContractAddresses(network = 'testnet') {
     // For now, return hardcoded testnet addresses
     // In production, you might want to:
     // 1. Load from a JSON file
     // 2. Fetch from a registry/API
     // 3. Use environment variables
     if (network === 'testnet') {
-        return exports.TESTNET_CONTRACTS;
+        return TESTNET_CONTRACTS;
     }
     // TODO: Add mainnet addresses when deployed
     throw new Error(`Contract addresses for ${network} not yet configured`);
@@ -41,7 +36,7 @@ function loadContractAddresses(network = 'testnet') {
 /**
  * Create SDK config from contract addresses
  */
-function createSDKConfig(addresses, options) {
+export function createSDKConfig(addresses, options) {
     return {
         kycRegistryAddress: addresses.contracts['kyc-registry'],
         attesterRegistryAddress: addresses.contracts['attester-registry'],

package/dist/contract.js

@@ -1,12 +1,9 @@
-"use strict";
 /**
  * Clarity contract interaction helpers
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KYCContract = void 0;
-const transactions_1 = require("@stacks/transactions");
-const network_1 = require("@stacks/network");
-class KYCContract {
+import { makeContractCall, broadcastTransaction, AnchorMode, PostConditionMode, bufferCV, uintCV, principalCV, getAddressFromPrivateKey, cvToJSON, callReadOnlyFunction, } from '@stacks/transactions';
+import { StacksTestnet, StacksMainnet } from '@stacks/network';
+export class KYCContract {
     constructor(config) {
         this.config = config;
         this.network = this.getNetwork();
@@ -14,11 +11,11 @@ class KYCContract {
     getNetwork() {
         switch (this.config.network) {
             case 'mainnet':
-                return new network_1.StacksMainnet();
+                return new StacksMainnet();
             case 'testnet':
-                return new network_1.StacksTestnet();
+                return new StacksTestnet();
             default:
-                return new network_1.StacksTestnet();
+                return new StacksTestnet();
         }
     }
     /**
@@ -28,9 +25,11 @@ class KYCContract {
      * @returns Transaction ID
      */
     async registerKYC(params, privateKey) {
-        const senderAddress = (0, transactions_1.getAddressFromPrivateKey)(privateKey, this.network.version);
+        const senderAddress = getAddressFromPrivateKey(privateKey, this.network.version);
         // #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:50', 'message': 'registerKYC entry', 'data': { senderAddress, network: this.network.coreApiUrl, attesterId: params.attesterId, commitmentLength: params.commitment.length, signatureLength: params.signature.length }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'A' }) }).catch(() => { });
+        console.log('Transaction sender address (derived from private key):', senderAddress);
+        console.log('Network version:', this.network.version);
+        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:50', 'message': 'registerKYC entry', 'data': { senderAddress, network: this.network.coreApiUrl, networkVersion: this.network.version, attesterId: params.attesterId, commitmentLength: params.commitment.length, signatureLength: params.signature.length }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'A' }) }).catch(() => { });
         // #endregion agent log
         const { address, name } = this.parseContractAddress(this.config.kycRegistryAddress);
         // Ensure commitment is exactly 32 bytes (64 hex chars)
@@ -39,16 +38,16 @@ class KYCContract {
         if (commitmentBuffer.length !== 32) {
             throw new Error(`Invalid commitment length: expected 32 bytes, got ${commitmentBuffer.length}. Hex: ${commitmentHex.substring(0, 20)}...`);
         }
-        // Ensure signature is exactly 65 bytes (130 hex chars)
+        // Ensure signature is 64 or 65 bytes (128 or 130 hex chars)
         const signatureHex = params.signature.replace('0x', '');
         const signatureBuffer = Buffer.from(signatureHex, 'hex');
-        if (signatureBuffer.length !== 65) {
-            throw new Error(`Invalid signature length: expected 65 bytes, got ${signatureBuffer.length}. Hex: ${signatureHex.substring(0, 20)}...`);
+        if (signatureBuffer.length !== 64 && signatureBuffer.length !== 65) {
+            throw new Error(`Invalid signature length: expected 64 or 65 bytes, got ${signatureBuffer.length}. Hex: ${signatureHex.substring(0, 20)}...`);
         }
         const functionArgs = [
-            (0, transactions_1.bufferCV)(commitmentBuffer),
-            (0, transactions_1.bufferCV)(signatureBuffer),
-            (0, transactions_1.uintCV)(params.attesterId),
+            bufferCV(commitmentBuffer),
+            bufferCV(signatureBuffer),
+            uintCV(params.attesterId),
         ];
         const txOptions = {
             contractAddress: address,
@@ -58,27 +57,88 @@ class KYCContract {
             senderKey: privateKey,
             fee: 5000, // Increased from 1000 to 5000 microSTX (0.005 STX) for better reliability
             network: this.network,
-            anchorMode: transactions_1.AnchorMode.Any,
-            postConditionMode: transactions_1.PostConditionMode.Allow,
+            anchorMode: AnchorMode.Any,
+            postConditionMode: PostConditionMode.Allow,
         };
         // #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:74', 'message': 'Transaction options before makeContractCall', 'data': { contractAddress: address, contractName: name, functionName: 'register-kyc', fee: txOptions.fee, anchorMode: txOptions.anchorMode, postConditionMode: txOptions.postConditionMode, networkUrl: this.network.coreApiUrl }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'B' }) }).catch(() => { });
         // #endregion agent log
         try {
-            const transaction = await (0, transactions_1.makeContractCall)(txOptions);
+            const transaction = await makeContractCall(txOptions);
             // #region agent log
             const serializedTx = transaction.serialize();
+            const nonceValue = transaction.auth?.spendingCondition?.nonce;
             const txData = {
                 txId: transaction.txid(),
-                nonce: transaction.auth?.spendingCondition?.nonce,
+                nonce: typeof nonceValue === 'bigint' ? nonceValue.toString() : nonceValue,
                 serializedTxLength: serializedTx.byteLength,
             };
             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:87', 'message': 'Transaction created, before broadcast', 'data': txData, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'A' }) }).catch(() => { });
             // #endregion agent log
-            const broadcastResponse = await (0, transactions_1.broadcastTransaction)(transaction, this.network);
-            return broadcastResponse.txid;
+            // #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:108', 'message': 'About to call broadcastTransaction', 'data': {}, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'D' }) }).catch(() => { });
+            // #endregion agent log
+            try {
+                const broadcastResponse = await broadcastTransaction(transaction, this.network);
+                return broadcastResponse.txid;
+            }
+            catch (broadcastError) {
+                // Log the error immediately with console.error to ensure we see it
+                console.error('broadcastTransaction error:', broadcastError);
+                // Re-throw to be caught by outer catch block
+                throw broadcastError;
+            }
         }
         catch (error) {
+            // #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:110', 'message': 'Caught error in registerKYC', 'data': { errorType: error?.constructor?.name, hasMessage: !!error?.message, message: error?.message?.substring(0, 200) }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
+            // #endregion agent log
+            // Helper function to safely serialize data (handles BigInt)
+            const safeStringify = (obj) => {
+                try {
+                    return JSON.stringify(obj, (key, value) => {
+                        if (typeof value === 'bigint') {
+                            return value.toString();
+                        }
+                        return value;
+                    });
+                }
+                catch (e) {
+                    return String(obj);
+                }
+            };
+            // Helper function to safely extract error data (handles BigInt)
+            const safeExtract = (obj) => {
+                if (obj === null || obj === undefined)
+                    return obj;
+                if (typeof obj === 'string')
+                    return obj;
+                if (typeof obj === 'bigint')
+                    return obj.toString();
+                if (typeof obj !== 'object')
+                    return obj;
+                const result = {};
+                try {
+                    for (const key in obj) {
+                        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                            const value = obj[key];
+                            if (typeof value === 'bigint') {
+                                result[key] = value.toString();
+                            }
+                            else if (typeof value === 'object' && value !== null) {
+                                result[key] = safeExtract(value);
+                            }
+                            else {
+                                result[key] = value;
+                            }
+                        }
+                    }
+                }
+                catch (e) {
+                    return String(obj);
+                }
+                return result;
+            };
             // #region agent log
             const errorKeys = error ? Object.keys(error) : [];
             const errorStructure = {
@@ -93,8 +153,9 @@ class KYCContract {
                 errorType: error?.constructor?.name,
                 status: error?.status,
                 statusText: error?.statusText,
+                message: error?.message,
             };
-            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:91', 'message': 'Error object structure', 'data': errorStructure, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
+            fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: safeStringify({ location: 'contract.ts:135', 'message': 'Error object structure', 'data': errorStructure, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
             // #endregion agent log
             // Capture detailed error information
             let errorMessage = 'Transaction failed';
@@ -103,14 +164,14 @@ class KYCContract {
                 errorMessage = error.message;
                 errorDetails.message = error.message;
             }
-            // Try to extract API response details
+            // Try to extract API response details (safely handle BigInt)
             if (error?.error) {
-                errorDetails.apiError = error.error;
-                errorMessage = error.error;
+                errorDetails.apiError = typeof error.error === 'string' ? error.error : safeExtract(error.error);
+                errorMessage = typeof error.error === 'string' ? error.error : String(error.error);
             }
             if (error?.reason) {
-                errorDetails.reason = error.reason;
-                errorMessage = error.reason;
+                errorDetails.reason = typeof error.reason === 'string' ? error.reason : safeExtract(error.reason);
+                errorMessage = typeof error.reason === 'string' ? error.reason : String(error.reason);
             }
             if (error?.response) {
                 try {
@@ -118,7 +179,7 @@ class KYCContract {
                         errorDetails.response = error.response;
                     }
                     else {
-                        errorDetails.response = JSON.stringify(error.response);
+                        errorDetails.response = safeStringify(safeExtract(error.response));
                     }
                 }
                 catch (e) {
@@ -126,33 +187,49 @@ class KYCContract {
                 }
             }
             if (error?.data) {
-                errorDetails.data = typeof error.data === 'string' ? error.data : JSON.stringify(error.data);
+                errorDetails.data = typeof error.data === 'string' ? error.data : safeStringify(safeExtract(error.data));
             }
             if (error?.status)
                 errorDetails.status = error.status;
             if (error?.statusText)
                 errorDetails.statusText = error.statusText;
             // #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:120', 'message': 'Error details captured', 'data': errorDetails, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
+            fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: safeStringify({ location: 'contract.ts:120', 'message': 'Error details captured', 'data': errorDetails, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
             // #endregion agent log
             // Try to extract response body if it exists
             let responseBody = null;
             if (error?.response?.data) {
-                responseBody = error.response.data;
+                responseBody = typeof error.response.data === 'string' ? error.response.data : safeExtract(error.response.data);
             }
             else if (error?.data) {
-                responseBody = error.data;
+                responseBody = typeof error.data === 'string' ? error.data : safeExtract(error.data);
             }
             // #region agent log
             if (responseBody) {
-                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:135', 'message': 'API response body', 'data': { responseBody: typeof responseBody === 'string' ? responseBody : JSON.stringify(responseBody) }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
+                fetch('http://127.0.0.1:7249/ingest/b239a7fb-669e-478f-b888-bd46beaadedf', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: safeStringify({ location: 'contract.ts:135', 'message': 'API response body', 'data': { responseBody: typeof responseBody === 'string' ? responseBody : safeStringify(responseBody) }, timestamp: Date.now(), sessionId: 'debug-session', runId: 'run1', hypothesisId: 'C' }) }).catch(() => { });
             }
             // #endregion agent log
-            // Log the full error for debugging
-            console.error('Transaction broadcast error:', errorDetails);
+            // Extract error details from response body for user-friendly messages
+            let userFriendlyMessage = errorMessage;
+            if (responseBody && typeof responseBody === 'object') {
+                if (responseBody.reason === 'NotEnoughFunds') {
+                    const expected = responseBody.reason_data?.expected;
+                    const expectedStx = expected ? (parseInt(expected, 16) / 1000000).toFixed(6) : '0.005';
+                    userFriendlyMessage = `Insufficient STX balance. You need at least ${expectedStx} STX to pay for the transaction fee. Please fund your account with STX and try again.`;
+                }
+                else if (responseBody.reason) {
+                    userFriendlyMessage = `Transaction rejected: ${responseBody.reason}${responseBody.error ? ' - ' + responseBody.error : ''}`;
+                }
+                else if (responseBody.error) {
+                    userFriendlyMessage = responseBody.error;
+                }
+            }
+            // Log the full error for debugging (using safe extraction)
+            const safeErrorDetails = safeExtract(errorDetails);
+            console.error('Transaction broadcast error:', safeErrorDetails);
             // Provide detailed error message
-            const detailedMessage = responseBody || errorDetails.response || errorDetails.reason || errorDetails.apiError || errorDetails.data || errorMessage;
-            throw new Error(`Transaction failed: ${detailedMessage}`);
+            const detailedMessage = userFriendlyMessage || (typeof responseBody === 'string' ? responseBody : (errorDetails.response || errorDetails.reason || errorDetails.apiError || errorDetails.data || errorMessage));
+            throw new Error(detailedMessage);
         }
     }
     /**
@@ -163,15 +240,15 @@ class KYCContract {
     async hasKYC(userPrincipal) {
         const { address, name } = this.parseContractAddress(this.config.kycRegistryAddress);
         try {
-            const result = await (0, transactions_1.callReadOnlyFunction)({
+            const result = await callReadOnlyFunction({
                 contractAddress: address,
                 contractName: name,
                 functionName: 'has-kyc?',
-                functionArgs: [(0, transactions_1.principalCV)(userPrincipal)],
+                functionArgs: [principalCV(userPrincipal)],
                 network: this.network,
                 senderAddress: address, // Use contract address as sender for read-only calls
             });
-            const jsonResult = (0, transactions_1.cvToJSON)(result);
+            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;
@@ -204,15 +281,15 @@ class KYCContract {
     async getKYC(userPrincipal) {
         const { address, name } = this.parseContractAddress(this.config.kycRegistryAddress);
         try {
-            const result = await (0, transactions_1.callReadOnlyFunction)({
+            const result = await callReadOnlyFunction({
                 contractAddress: address,
                 contractName: name,
                 functionName: 'get-kyc',
-                functionArgs: [(0, transactions_1.principalCV)(userPrincipal)],
+                functionArgs: [principalCV(userPrincipal)],
                 network: this.network,
                 senderAddress: address,
             });
-            const jsonResult = (0, transactions_1.cvToJSON)(result);
+            const jsonResult = cvToJSON(result);
             // Result is (ok (some kyc-record)) or (ok none)
             if (jsonResult.type === 'responseOk' && jsonResult.value.type === 'optionalSome') {
                 const record = jsonResult.value.value.value;
@@ -246,4 +323,3 @@ class KYCContract {
         };
     }
 }
-exports.KYCContract = KYCContract;

package/dist/index.js

@@ -1,42 +1,22 @@
-"use strict";
 /**
  * Noah-v2 SDK
  * Main entry point for protocol integration
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NoahSDK = exports.WalletHelper = exports.ProofService = exports.KYCContract = void 0;
-var contract_1 = require("./contract");
-Object.defineProperty(exports, "KYCContract", { enumerable: true, get: function () { return contract_1.KYCContract; } });
-var proof_1 = require("./proof");
-Object.defineProperty(exports, "ProofService", { enumerable: true, get: function () { return proof_1.ProofService; } });
-var wallet_1 = require("./wallet");
-Object.defineProperty(exports, "WalletHelper", { enumerable: true, get: function () { return wallet_1.WalletHelper; } });
-__exportStar(require("./types"), exports);
-const contract_2 = require("./contract");
-const proof_2 = require("./proof");
-const wallet_2 = require("./wallet");
+export { KYCContract } from './contract';
+export { ProofService } from './proof';
+export { WalletHelper } from './wallet';
+export * from './types';
+import { KYCContract } from './contract';
+import { ProofService } from './proof';
+import { WalletHelper } from './wallet';
 /**
  * Main SDK class
  */
-class NoahSDK {
+export class NoahSDK {
     constructor(config, walletConfig) {
-        this.contract = new contract_2.KYCContract(config);
-        this.proof = new proof_2.ProofService(config);
-        this.wallet = new wallet_2.WalletHelper(walletConfig);
+        this.contract = new KYCContract(config);
+        this.proof = new ProofService(config);
+        this.wallet = new WalletHelper(walletConfig);
     }
     /**
      * Complete KYC registration flow
@@ -69,6 +49,5 @@ class NoahSDK {
         return txId;
     }
 }
-exports.NoahSDK = NoahSDK;
 // Default export
-exports.default = NoahSDK;
+export default NoahSDK;

package/dist/proof.js

@@ -1,10 +1,7 @@
-"use strict";
 /**
  * Proof generation and verification utilities
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProofService = void 0;
-class ProofService {
+export class ProofService {
     constructor(config) {
         this.proverServiceUrl = config.proverServiceUrl || 'http://localhost:8080';
         this.attesterServiceUrl = config.attesterServiceUrl || 'http://localhost:8081';
@@ -92,4 +89,3 @@ class ProofService {
         return await this.generateProof(proofRequest);
     }
 }
-exports.ProofService = ProofService;

package/dist/types.js

@@ -1,5 +1,4 @@
-"use strict";
 /**
  * Type definitions for Noah-v2 SDK
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/wallet.js

@@ -1,10 +1,7 @@
-"use strict";
 /**
  * Wallet integration helpers
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WalletHelper = void 0;
-class WalletHelper {
+export class WalletHelper {
     constructor(config) {
         this.config = config;
     }
@@ -31,4 +28,3 @@ class WalletHelper {
         return userData.profile.stxAddress.mainnet || userData.profile.stxAddress.testnet;
     }
 }
-exports.WalletHelper = WalletHelper;

package/package.json

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