@telika/sdk 0.1.0

package/dist/blockchain-client.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * Telika Blockchain Client
+ *
+ * Provides a high-level API for interacting with the TelikaVerification smart contract
+ * on the Polygon network. Handles transaction signing, gas estimation, event monitoring,
+ * and read/write operations.
+ *
+ * Usage:
+ *   // Read-only client (no private key needed)
+ *   const reader = new TelikaBlockchainClient({
+ *     rpcUrl: "https://polygon-amoy.g.alchemy.com/v2/KEY",
+ *     contractAddress: "0x...",
+ *   });
+ *
+ *   // Read-write client (private key required for anchoring)
+ *   const writer = new TelikaBlockchainClient({
+ *     rpcUrl: "https://polygon-amoy.g.alchemy.com/v2/KEY",
+ *     contractAddress: "0x...",
+ *     privateKey: "0x...",
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelikaBlockchainClient = void 0;
+const ethers_1 = require("ethers");
+const abi_1 = require("./abi");
+// =========================================================================
+// Client Class
+// =========================================================================
+class TelikaBlockchainClient {
+    provider;
+    contract;
+    signer;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.provider = new ethers_1.JsonRpcProvider(config.rpcUrl);
+        if (config.privateKey) {
+            this.signer = new ethers_1.Wallet(config.privateKey, this.provider);
+            this.contract = new ethers_1.Contract(config.contractAddress, abi_1.TELIKA_VERIFICATION_ABI, this.signer);
+        }
+        else {
+            this.contract = new ethers_1.Contract(config.contractAddress, abi_1.TELIKA_VERIFICATION_ABI, this.provider);
+        }
+    }
+    // =========================================================================
+    // Write Operations (require signer)
+    // =========================================================================
+    /**
+     * Anchor a cryptographic proof on-chain.
+     *
+     * @param proofHash - The keccak256 hash of the verification event data (from proof-generator)
+     * @param eventType - The type of verification event
+     * @param telikaId - The unique Telika identifier
+     * @param metadata - Non-sensitive metadata to store alongside the proof
+     * @returns Transaction response with hash and wait() method
+     * @throws Error if no signer is configured
+     */
+    async anchorProof(proofHash, eventType, telikaId, metadata) {
+        this.requireSigner();
+        const metadataStr = typeof metadata === "string" ? metadata : JSON.stringify(metadata);
+        const tx = await this.contract.anchorProof(proofHash, eventType, telikaId, metadataStr);
+        return tx;
+    }
+    /**
+     * Anchor a proof and wait for transaction confirmation.
+     * Convenience wrapper around anchorProof() that waits for the receipt.
+     *
+     * @param proofHash - The keccak256 proof hash
+     * @param eventType - The event type
+     * @param telikaId - The Telika ID
+     * @param metadata - Proof metadata
+     * @param confirmations - Number of confirmations to wait for (default: 1)
+     * @returns Object with transaction hash and block number
+     */
+    async anchorProofAndWait(proofHash, eventType, telikaId, metadata, confirmations = 1) {
+        const tx = await this.anchorProof(proofHash, eventType, telikaId, metadata);
+        const receipt = await tx.wait(confirmations);
+        if (!receipt) {
+            throw new Error("Transaction receipt is null — transaction may have been dropped");
+        }
+        return {
+            txHash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+        };
+    }
+    // =========================================================================
+    // Read Operations (no signer needed)
+    // =========================================================================
+    /**
+     * Verify whether a proof exists on-chain and retrieve its record.
+     *
+     * @param proofHash - The proof hash to verify
+     * @returns Verification result with existence flag and proof record
+     */
+    async verifyProof(proofHash) {
+        const [exists, rawRecord] = await this.contract.verifyProof(proofHash);
+        if (!exists) {
+            return { exists: false };
+        }
+        return {
+            exists: true,
+            record: this.parseProofRecord(rawRecord),
+        };
+    }
+    /**
+     * Get all proof hashes associated with a Telika ID.
+     *
+     * @param telikaId - The unique Telika identifier
+     * @returns Array of proof hash strings
+     */
+    async getProofsByTelikaId(telikaId) {
+        const hashes = await this.contract.getProofsByTelikaId(telikaId);
+        return Array.from(hashes);
+    }
+    /**
+     * Get all proof records for a Telika ID (fetches each proof's full record).
+     *
+     * @param telikaId - The unique Telika identifier
+     * @returns Array of full proof records
+     */
+    async getFullProofsByTelikaId(telikaId) {
+        const hashes = await this.getProofsByTelikaId(telikaId);
+        const records = await Promise.all(hashes.map(async (hash) => {
+            const rawRecord = await this.contract.getProof(hash);
+            return this.parseProofRecord(rawRecord);
+        }));
+        return records;
+    }
+    /**
+     * Get the count of proofs for a Telika ID.
+     *
+     * @param telikaId - The unique Telika identifier
+     * @returns Number of proofs anchored for this ID
+     */
+    async getProofCount(telikaId) {
+        const count = await this.contract.getProofCount(telikaId);
+        return Number(count);
+    }
+    /**
+     * Get the total number of proofs anchored across all Telika IDs.
+     */
+    async getTotalProofs() {
+        const total = await this.contract.totalProofs();
+        return Number(total);
+    }
+    /**
+     * Get paginated proof hashes for a Telika ID.
+     *
+     * @param telikaId - The Telika ID to query
+     * @param offset - Starting index
+     * @param limit - Maximum number of results
+     * @returns Array of proof hashes
+     */
+    async getProofsPaginated(telikaId, offset, limit) {
+        const hashes = await this.contract.getProofsByTelikaIdPaginated(telikaId, offset, limit);
+        return Array.from(hashes);
+    }
+    // =========================================================================
+    // Event Monitoring
+    // =========================================================================
+    /**
+     * Listen for new ProofAnchored events.
+     *
+     * @param callback - Function called when a new proof is anchored
+     * @returns Cleanup function to stop listening
+     */
+    onProofAnchored(callback) {
+        const listener = (proofHash, eventType, telikaId, timestamp, anchoredBy) => {
+            callback({
+                proofHash,
+                eventType: Number(eventType),
+                telikaId,
+                timestamp: Number(timestamp),
+                anchoredBy,
+            });
+        };
+        this.contract.on("ProofAnchored", listener);
+        return () => {
+            this.contract.off("ProofAnchored", listener);
+        };
+    }
+    /**
+     * Query historical ProofAnchored events.
+     *
+     * @param fromBlock - Starting block number (default: last 10000 blocks)
+     * @param toBlock - Ending block number (default: latest)
+     * @returns Array of proof anchored events
+     */
+    async queryProofEvents(fromBlock, toBlock) {
+        const currentBlock = await this.provider.getBlockNumber();
+        const from = fromBlock ?? Math.max(0, currentBlock - 10000);
+        const to = toBlock ?? currentBlock;
+        const filter = this.contract.filters.ProofAnchored();
+        const events = await this.contract.queryFilter(filter, from, to);
+        return events
+            .filter((e) => e instanceof ethers_1.EventLog)
+            .map((event) => ({
+            proofHash: event.args[0],
+            eventType: Number(event.args[1]),
+            telikaId: event.args[2],
+            timestamp: Number(event.args[3]),
+            anchoredBy: event.args[4],
+            blockNumber: event.blockNumber,
+            transactionHash: event.transactionHash,
+        }));
+    }
+    // =========================================================================
+    // Access Control
+    // =========================================================================
+    /**
+     * Check if an address has the ANCHOR_ROLE.
+     *
+     * @param address - The address to check
+     * @returns Whether the address can anchor proofs
+     */
+    async hasAnchorRole(address) {
+        const role = await this.contract.ANCHOR_ROLE();
+        return this.contract.hasRole(role, address);
+    }
+    /**
+     * Grant ANCHOR_ROLE to an address (requires admin role).
+     *
+     * @param address - The address to grant the role to
+     * @returns Transaction response
+     */
+    async grantAnchorRole(address) {
+        this.requireSigner();
+        const role = await this.contract.ANCHOR_ROLE();
+        return this.contract.grantRole(role, address);
+    }
+    /**
+     * Revoke ANCHOR_ROLE from an address (requires admin role).
+     *
+     * @param address - The address to revoke the role from
+     * @returns Transaction response
+     */
+    async revokeAnchorRole(address) {
+        this.requireSigner();
+        const role = await this.contract.ANCHOR_ROLE();
+        return this.contract.revokeRole(role, address);
+    }
+    // =========================================================================
+    // Utility
+    // =========================================================================
+    /**
+     * Get the contract address.
+     */
+    getContractAddress() {
+        return this.config.contractAddress;
+    }
+    /**
+     * Get the current signer address (if configured).
+     */
+    async getSignerAddress() {
+        return this.signer?.getAddress();
+    }
+    /**
+     * Get the current block number.
+     */
+    async getBlockNumber() {
+        return this.provider.getBlockNumber();
+    }
+    /**
+     * Get the balance of the signer (in MATIC/ETH).
+     */
+    async getSignerBalance() {
+        this.requireSigner();
+        const balance = await this.provider.getBalance(this.signer.address);
+        return (0, ethers_1.formatUnits)(balance, 18);
+    }
+    // =========================================================================
+    // Private Helpers
+    // =========================================================================
+    requireSigner() {
+        if (!this.signer) {
+            throw new Error("This operation requires a signer. Initialize TelikaBlockchainClient with a privateKey.");
+        }
+    }
+    parseProofRecord(raw) {
+        return {
+            proofHash: raw.proofHash ?? raw[0],
+            eventType: Number(raw.eventType ?? raw[1]),
+            telikaId: raw.telikaId ?? raw[2],
+            timestamp: Number(raw.timestamp ?? raw[3]),
+            metadata: raw.metadata ?? raw[4],
+            anchoredBy: raw.anchoredBy ?? raw[5],
+        };
+    }
+}
+exports.TelikaBlockchainClient = TelikaBlockchainClient;
+//# sourceMappingURL=blockchain-client.js.map

package/dist/blockchain-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockchain-client.js","sourceRoot":"","sources":["../src/blockchain-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,mCAOgB;AAChB,+BAAgD;AAShD,4EAA4E;AAC5E,eAAe;AACf,4EAA4E;AAE5E,MAAa,sBAAsB;IACzB,QAAQ,CAAkB;IAC1B,QAAQ,CAAW;IACnB,MAAM,CAAU;IAChB,MAAM,CAAqB;IAEnC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEnD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAQ,CAC1B,MAAM,CAAC,eAAe,EACtB,6BAAuB,EACvB,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAQ,CAC1B,MAAM,CAAC,eAAe,EACtB,6BAAuB,EACvB,IAAI,CAAC,QAAQ,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,oCAAoC;IACpC,4EAA4E;IAE5E;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,SAAoB,EACpB,QAAgB,EAChB,QAAgC;QAEhC,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAErE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CACxC,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,CACZ,CAAC;QAEF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB,CACtB,SAAiB,EACjB,SAAoB,EACpB,QAAgB,EAChB,QAAgC,EAChC,gBAAwB,CAAC;QAEzB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,IAAI;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,qCAAqC;IACrC,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;SACzC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAa,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,uBAAuB,CAAC,QAAgB;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC,CAAC,CACH,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,kBAAkB,CACtB,QAAgB,EAChB,MAAc,EACd,KAAa;QAEb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAC7D,QAAQ,EACR,MAAM,EACN,KAAK,CACN,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAa,CAAC;IACxC,CAAC;IAED,4EAA4E;IAC5E,mBAAmB;IACnB,4EAA4E;IAE5E;;;;;OAKG;IACH,eAAe,CACb,QAMU;QAEV,MAAM,QAAQ,GAAG,CACf,SAAiB,EACjB,SAAiB,EACjB,QAAgB,EAChB,SAAiB,EACjB,UAAkB,EAClB,EAAE;YACF,QAAQ,CAAC;gBACP,SAAS;gBACT,SAAS,EAAE,MAAM,CAAC,SAAS,CAAc;gBACzC,QAAQ;gBACR,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC5B,UAAU;aACX,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAE5C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CACpB,SAAkB,EAClB,OAAgB;QAYhB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,OAAO,IAAI,YAAY,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAEjE,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC,YAAY,iBAAQ,CAAC;aACnD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAW;YAClC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAc;YAC7C,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAW;YACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAW;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAE5E;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAO,CAAC,OAAO,CAAC,CAAC;QACrE,OAAO,IAAA,oBAAW,EAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAEpE,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,GAA4B;QACnD,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,SAAmB,IAAI,GAAG,CAAC,CAAC,CAAW;YACtD,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,CAAc;YACvD,QAAQ,EAAE,GAAG,CAAC,QAAkB,IAAI,GAAG,CAAC,CAAC,CAAW;YACpD,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1C,QAAQ,EAAE,GAAG,CAAC,QAAkB,IAAI,GAAG,CAAC,CAAC,CAAW;YACpD,UAAU,EAAE,GAAG,CAAC,UAAoB,IAAI,GAAG,CAAC,CAAC,CAAW;SACzD,CAAC;IACJ,CAAC;CACF;AAzWD,wDAyWC"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Telika SDK
+ *
+ * Public API for the Telika verification system.
+ * Provides proof generation and blockchain interaction capabilities.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   generateProofHash,
+ *   createIdentityProof,
+ *   TelikaBlockchainClient,
+ *   EventType,
+ * } from "@telika/sdk";
+ *
+ * // Generate a proof hash
+ * const proofHash = createIdentityProof({
+ *   type: EventType.IdentityVerification,
+ *   telikaId: "TLK-001",
+ *   timestamp: new Date().toISOString(),
+ *   documentType: "National ID",
+ *   issuingCountry: "KE",
+ *   verified: true,
+ *   verifiedBy: "Telika Platform",
+ * });
+ *
+ * // Anchor it on-chain
+ * const client = new TelikaBlockchainClient({
+ *   rpcUrl: "https://polygon-amoy.g.alchemy.com/v2/KEY",
+ *   contractAddress: "0x...",
+ *   privateKey: "0x...",
+ * });
+ *
+ * await client.anchorProofAndWait(
+ *   proofHash,
+ *   EventType.IdentityVerification,
+ *   "TLK-001",
+ *   { eventDescription: "Identity verified", generatedBy: "Telika", proofVersion: "1.0.0" }
+ * );
+ * ```
+ */
+export { EventType, EventTypeLabels, type BaseEvent, type IdentityEvent, type FundingEvent, type MilestoneEvent, type ScoreUpdateEvent, type VerificationEvent, type ProofRecord, type VerificationResult, type TelikaClientConfig, type ProofMetadata, } from "./types";
+export { generateProofHash, createIdentityProof, createFundingProof, createMilestoneProof, createScoreProof, generateMetadata, generateAbiEncodedHash, } from "./proof-generator";
+export { TelikaBlockchainClient } from "./blockchain-client";
+export { TELIKA_VERIFICATION_ABI } from "./abi";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Telika SDK
+ *
+ * Public API for the Telika verification system.
+ * Provides proof generation and blockchain interaction capabilities.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   generateProofHash,
+ *   createIdentityProof,
+ *   TelikaBlockchainClient,
+ *   EventType,
+ * } from "@telika/sdk";
+ *
+ * // Generate a proof hash
+ * const proofHash = createIdentityProof({
+ *   type: EventType.IdentityVerification,
+ *   telikaId: "TLK-001",
+ *   timestamp: new Date().toISOString(),
+ *   documentType: "National ID",
+ *   issuingCountry: "KE",
+ *   verified: true,
+ *   verifiedBy: "Telika Platform",
+ * });
+ *
+ * // Anchor it on-chain
+ * const client = new TelikaBlockchainClient({
+ *   rpcUrl: "https://polygon-amoy.g.alchemy.com/v2/KEY",
+ *   contractAddress: "0x...",
+ *   privateKey: "0x...",
+ * });
+ *
+ * await client.anchorProofAndWait(
+ *   proofHash,
+ *   EventType.IdentityVerification,
+ *   "TLK-001",
+ *   { eventDescription: "Identity verified", generatedBy: "Telika", proofVersion: "1.0.0" }
+ * );
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELIKA_VERIFICATION_ABI = exports.TelikaBlockchainClient = exports.generateAbiEncodedHash = exports.generateMetadata = exports.createScoreProof = exports.createMilestoneProof = exports.createFundingProof = exports.createIdentityProof = exports.generateProofHash = exports.EventTypeLabels = exports.EventType = void 0;
+// Types
+var types_1 = require("./types");
+Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return types_1.EventType; } });
+Object.defineProperty(exports, "EventTypeLabels", { enumerable: true, get: function () { return types_1.EventTypeLabels; } });
+// Proof Generation
+var proof_generator_1 = require("./proof-generator");
+Object.defineProperty(exports, "generateProofHash", { enumerable: true, get: function () { return proof_generator_1.generateProofHash; } });
+Object.defineProperty(exports, "createIdentityProof", { enumerable: true, get: function () { return proof_generator_1.createIdentityProof; } });
+Object.defineProperty(exports, "createFundingProof", { enumerable: true, get: function () { return proof_generator_1.createFundingProof; } });
+Object.defineProperty(exports, "createMilestoneProof", { enumerable: true, get: function () { return proof_generator_1.createMilestoneProof; } });
+Object.defineProperty(exports, "createScoreProof", { enumerable: true, get: function () { return proof_generator_1.createScoreProof; } });
+Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: function () { return proof_generator_1.generateMetadata; } });
+Object.defineProperty(exports, "generateAbiEncodedHash", { enumerable: true, get: function () { return proof_generator_1.generateAbiEncodedHash; } });
+// Blockchain Client
+var blockchain_client_1 = require("./blockchain-client");
+Object.defineProperty(exports, "TelikaBlockchainClient", { enumerable: true, get: function () { return blockchain_client_1.TelikaBlockchainClient; } });
+// Contract ABI
+var abi_1 = require("./abi");
+Object.defineProperty(exports, "TELIKA_VERIFICATION_ABI", { enumerable: true, get: function () { return abi_1.TELIKA_VERIFICATION_ABI; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;AAEH,QAAQ;AACR,iCAaiB;AAZf,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AAajB,mBAAmB;AACnB,qDAQ2B;AAPzB,oHAAA,iBAAiB,OAAA;AACjB,sHAAA,mBAAmB,OAAA;AACnB,qHAAA,kBAAkB,OAAA;AAClB,uHAAA,oBAAoB,OAAA;AACpB,mHAAA,gBAAgB,OAAA;AAChB,mHAAA,gBAAgB,OAAA;AAChB,yHAAA,sBAAsB,OAAA;AAGxB,oBAAoB;AACpB,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA;AAE/B,eAAe;AACf,6BAAgD;AAAvC,8GAAA,uBAAuB,OAAA"}

package/dist/proof-generator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Telika Proof Generator
+ *
+ * Generates cryptographic proof hashes (keccak256) from verification event data.
+ * The proof generator ensures that:
+ * 1. Sensitive fields are STRIPPED before hashing (e.g., bank details, personal documents)
+ * 2. Proof hashes are deterministic (same input always produces the same hash)
+ * 3. Only non-sensitive, non-identifying data is included in the proof
+ */
+import { VerificationEvent, IdentityEvent, FundingEvent, MilestoneEvent, ScoreUpdateEvent, ProofMetadata } from "./types";
+/**
+ * Generate a keccak256 proof hash from any verification event.
+ * Automatically routes to the appropriate event-specific generator
+ * and strips sensitive data before hashing.
+ *
+ * @param event - The verification event data
+ * @returns The keccak256 hash of the sanitized event data (0x-prefixed)
+ */
+export declare function generateProofHash(event: VerificationEvent): string;
+/**
+ * Create a proof hash specifically for an identity verification event.
+ *
+ * Included in proof: telikaId, timestamp, documentType, issuingCountry, verified, verifiedBy
+ * Excluded (sensitive): actual document numbers, personal details, photos
+ *
+ * @param event - Identity verification event data
+ * @returns The keccak256 proof hash
+ */
+export declare function createIdentityProof(event: IdentityEvent): string;
+/**
+ * Create a proof hash specifically for a funding disbursement event.
+ *
+ * Included in proof: telikaId, timestamp, amount, currency, funderId, funderName, fundingPurpose
+ * Excluded (sensitive): bank account numbers, routing numbers, transaction IDs
+ *
+ * @param event - Funding disbursement event data
+ * @returns The keccak256 proof hash
+ */
+export declare function createFundingProof(event: FundingEvent): string;
+/**
+ * Create a proof hash specifically for a milestone confirmation event.
+ *
+ * Included in proof: telikaId, timestamp, milestoneName, description, evidenceType, confirmed, confirmedBy
+ * Excluded (sensitive): detailed financial reports, user data
+ *
+ * @param event - Milestone confirmation event data
+ * @returns The keccak256 proof hash
+ */
+export declare function createMilestoneProof(event: MilestoneEvent): string;
+/**
+ * Create a proof hash specifically for a score update event.
+ *
+ * Included in proof: telikaId, timestamp, previousScore, newScore, reason, categoriesChanged
+ * Excluded (sensitive): detailed scoring breakdown, proprietary AI model outputs
+ *
+ * @param event - Score update event data
+ * @returns The keccak256 proof hash
+ */
+export declare function createScoreProof(event: ScoreUpdateEvent): string;
+/**
+ * Generate non-sensitive metadata JSON for an event.
+ * This metadata is stored on-chain alongside the proof hash.
+ *
+ * @param event - The verification event
+ * @param generatedBy - Who/what generated this proof
+ * @returns ProofMetadata object
+ */
+export declare function generateMetadata(event: VerificationEvent, generatedBy?: string): ProofMetadata;
+/**
+ * Generate a proof hash from raw ABI-encoded data.
+ * Useful for verifying proofs against the smart contract directly.
+ *
+ * @param types - Solidity ABI types
+ * @param values - Values corresponding to the types
+ * @returns keccak256 hash of ABI-encoded data
+ */
+export declare function generateAbiEncodedHash(types: string[], values: unknown[]): string;
+//# sourceMappingURL=proof-generator.d.ts.map

package/dist/proof-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-generator.d.ts","sourceRoot":"","sources":["../src/proof-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACd,MAAM,SAAS,CAAC;AAMjB;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAIlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEhE;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EACxB,WAAW,GAAE,MAA0B,GACtC,aAAa,CAaf;AA8ED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAIjF"}