@telika/sdk 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# @telika/sdk
+
+TypeScript SDK for the Telika blockchain-anchored verification system on Polygon.
+
+## Installation
+
+```bash
+npm install @telika/sdk
+```
+
+## Quick Start
+
+```typescript
+import { ProofGenerator, BlockchainClient } from '@telika/sdk';
+
+// Generate a proof for an identity verification event
+const proof = ProofGenerator.createIdentityProof({
+  telikaId: 'TLK-001',
+  verificationMethod: 'document-check',
+  verifiedAt: Date.now(),
+  verifierAddress: '0x...',
+});
+
+// Anchor it on Polygon
+const client = new BlockchainClient({
+  contractAddress: '0x...',
+  rpcUrl: 'https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY',
+  privateKey: '0x...',
+});
+
+const tx = await client.anchorProof(
+  proof.hash,
+  0, // EventType.IdentityVerification
+  'TLK-001',
+  JSON.stringify(proof.metadata)
+);
+```
+
+## Event Types
+
+| Type | Value | Description |
+|------|-------|-------------|
+| `IdentityVerification` | `0` | Founder identity verified |
+| `FundingDisbursement` | `1` | Funding sent to founder |
+| `MilestoneConfirmation` | `2` | Milestone achieved |
+| `ScoreUpdate` | `3` | Telika score recalculated |
+
+## API
+
+### ProofGenerator
+
+- `generateProofHash(eventData)` — Generate a keccak256 proof hash
+- `createIdentityProof(data)` — Create an identity verification proof
+- `createFundingProof(data)` — Create a funding disbursement proof
+- `createMilestoneProof(data)` — Create a milestone confirmation proof
+- `createScoreProof(data)` — Create a score update proof
+- `generateMetadata(eventType, options)` — Generate proof metadata
+
+### BlockchainClient
+
+- `anchorProof(hash, eventType, telikaId, metadata)` — Anchor a proof on-chain
+- `verifyProof(proofHash)` — Verify a proof exists on-chain
+- `getProofsByTelikaId(telikaId)` — Get all proofs for a Telika ID
+- `listenForProofs(callback)` — Listen for new proof events
+
+## License
+
+MIT — [Telika Africa](https://telika.ai)

package/dist/abi.d.ts

@@ -0,0 +1,214 @@
+/**
+ * TelikaVerification Contract ABI
+ *
+ * Minimal ABI containing only the functions and events needed by the SDK.
+ * This avoids requiring the full contract artifacts as a dependency.
+ */
+export declare const TELIKA_VERIFICATION_ABI: readonly [{
+    readonly name: "anchorProof";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "proofHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "eventType";
+        readonly type: "uint8";
+    }, {
+        readonly name: "telikaId";
+        readonly type: "string";
+    }, {
+        readonly name: "metadata";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "verifyProof";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "proofHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "exists";
+        readonly type: "bool";
+    }, {
+        readonly name: "record";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "proofHash";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "eventType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "telikaId";
+            readonly type: "string";
+        }, {
+            readonly name: "timestamp";
+            readonly type: "uint256";
+        }, {
+            readonly name: "metadata";
+            readonly type: "string";
+        }, {
+            readonly name: "anchoredBy";
+            readonly type: "address";
+        }];
+    }];
+}, {
+    readonly name: "getProofsByTelikaId";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "telikaId";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "proofHashes";
+        readonly type: "bytes32[]";
+    }];
+}, {
+    readonly name: "getProofCount";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "telikaId";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "count";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getProof";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "proofHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "record";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "proofHash";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "eventType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "telikaId";
+            readonly type: "string";
+        }, {
+            readonly name: "timestamp";
+            readonly type: "uint256";
+        }, {
+            readonly name: "metadata";
+            readonly type: "string";
+        }, {
+            readonly name: "anchoredBy";
+            readonly type: "address";
+        }];
+    }];
+}, {
+    readonly name: "getProofsByTelikaIdPaginated";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "telikaId";
+        readonly type: "string";
+    }, {
+        readonly name: "offset";
+        readonly type: "uint256";
+    }, {
+        readonly name: "limit";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "proofHashes";
+        readonly type: "bytes32[]";
+    }];
+}, {
+    readonly name: "totalProofs";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "ANCHOR_ROLE";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly name: "hasRole";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "grantRole";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "revokeRole";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "ProofAnchored";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "proofHash";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "eventType";
+        readonly type: "uint8";
+        readonly indexed: true;
+    }, {
+        readonly name: "telikaId";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "timestamp";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "anchoredBy";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}];
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqJ1B,CAAC"}

package/dist/abi.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * TelikaVerification Contract ABI
+ *
+ * Minimal ABI containing only the functions and events needed by the SDK.
+ * This avoids requiring the full contract artifacts as a dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELIKA_VERIFICATION_ABI = void 0;
+exports.TELIKA_VERIFICATION_ABI = [
+    // =========================================================================
+    // Write Functions
+    // =========================================================================
+    {
+        name: "anchorProof",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "proofHash", type: "bytes32" },
+            { name: "eventType", type: "uint8" },
+            { name: "telikaId", type: "string" },
+            { name: "metadata", type: "string" },
+        ],
+        outputs: [],
+    },
+    // =========================================================================
+    // Read Functions
+    // =========================================================================
+    {
+        name: "verifyProof",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "proofHash", type: "bytes32" }],
+        outputs: [
+            { name: "exists", type: "bool" },
+            {
+                name: "record",
+                type: "tuple",
+                components: [
+                    { name: "proofHash", type: "bytes32" },
+                    { name: "eventType", type: "uint8" },
+                    { name: "telikaId", type: "string" },
+                    { name: "timestamp", type: "uint256" },
+                    { name: "metadata", type: "string" },
+                    { name: "anchoredBy", type: "address" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "getProofsByTelikaId",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "telikaId", type: "string" }],
+        outputs: [{ name: "proofHashes", type: "bytes32[]" }],
+    },
+    {
+        name: "getProofCount",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "telikaId", type: "string" }],
+        outputs: [{ name: "count", type: "uint256" }],
+    },
+    {
+        name: "getProof",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "proofHash", type: "bytes32" }],
+        outputs: [
+            {
+                name: "record",
+                type: "tuple",
+                components: [
+                    { name: "proofHash", type: "bytes32" },
+                    { name: "eventType", type: "uint8" },
+                    { name: "telikaId", type: "string" },
+                    { name: "timestamp", type: "uint256" },
+                    { name: "metadata", type: "string" },
+                    { name: "anchoredBy", type: "address" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "getProofsByTelikaIdPaginated",
+        type: "function",
+        stateMutability: "view",
+        inputs: [
+            { name: "telikaId", type: "string" },
+            { name: "offset", type: "uint256" },
+            { name: "limit", type: "uint256" },
+        ],
+        outputs: [{ name: "proofHashes", type: "bytes32[]" }],
+    },
+    {
+        name: "totalProofs",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    // =========================================================================
+    // Access Control
+    // =========================================================================
+    {
+        name: "ANCHOR_ROLE",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "bytes32" }],
+    },
+    {
+        name: "hasRole",
+        type: "function",
+        stateMutability: "view",
+        inputs: [
+            { name: "role", type: "bytes32" },
+            { name: "account", type: "address" },
+        ],
+        outputs: [{ name: "", type: "bool" }],
+    },
+    {
+        name: "grantRole",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "role", type: "bytes32" },
+            { name: "account", type: "address" },
+        ],
+        outputs: [],
+    },
+    {
+        name: "revokeRole",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "role", type: "bytes32" },
+            { name: "account", type: "address" },
+        ],
+        outputs: [],
+    },
+    // =========================================================================
+    // Events
+    // =========================================================================
+    {
+        name: "ProofAnchored",
+        type: "event",
+        inputs: [
+            { name: "proofHash", type: "bytes32", indexed: true },
+            { name: "eventType", type: "uint8", indexed: true },
+            { name: "telikaId", type: "string", indexed: false },
+            { name: "timestamp", type: "uint256", indexed: false },
+            { name: "anchoredBy", type: "address", indexed: false },
+        ],
+    },
+];
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,uBAAuB,GAAG;IACrC,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAC5E;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;SACrC;QACD,OAAO,EAAE,EAAE;KACZ;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAC5E;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;YAChC;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;oBACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACpC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;iBACxC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACtD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9C;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;oBACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACpC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;iBACxC;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACnC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACtD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAC5E;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACtC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;QACD,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;QACD,OAAO,EAAE,EAAE;KACZ;IAED,4EAA4E;IAC5E,SAAS;IACT,4EAA4E;IAC5E;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACrD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;YACpD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACtD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;SACxD;KACF;CACO,CAAC"}

package/dist/blockchain-client.d.ts

@@ -0,0 +1,166 @@
+/**
+ * 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...",
+ *   });
+ */
+import { ContractTransactionResponse } from "ethers";
+import { TelikaClientConfig, EventType, ProofRecord, VerificationResult, ProofMetadata } from "./types";
+export declare class TelikaBlockchainClient {
+    private provider;
+    private contract;
+    private signer?;
+    private config;
+    constructor(config: TelikaClientConfig);
+    /**
+     * 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
+     */
+    anchorProof(proofHash: string, eventType: EventType, telikaId: string, metadata: ProofMetadata | string): Promise<ContractTransactionResponse>;
+    /**
+     * 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
+     */
+    anchorProofAndWait(proofHash: string, eventType: EventType, telikaId: string, metadata: ProofMetadata | string, confirmations?: number): Promise<{
+        txHash: string;
+        blockNumber: number;
+    }>;
+    /**
+     * 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
+     */
+    verifyProof(proofHash: string): Promise<VerificationResult>;
+    /**
+     * Get all proof hashes associated with a Telika ID.
+     *
+     * @param telikaId - The unique Telika identifier
+     * @returns Array of proof hash strings
+     */
+    getProofsByTelikaId(telikaId: string): Promise<string[]>;
+    /**
+     * 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
+     */
+    getFullProofsByTelikaId(telikaId: string): Promise<ProofRecord[]>;
+    /**
+     * Get the count of proofs for a Telika ID.
+     *
+     * @param telikaId - The unique Telika identifier
+     * @returns Number of proofs anchored for this ID
+     */
+    getProofCount(telikaId: string): Promise<number>;
+    /**
+     * Get the total number of proofs anchored across all Telika IDs.
+     */
+    getTotalProofs(): Promise<number>;
+    /**
+     * 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
+     */
+    getProofsPaginated(telikaId: string, offset: number, limit: number): Promise<string[]>;
+    /**
+     * Listen for new ProofAnchored events.
+     *
+     * @param callback - Function called when a new proof is anchored
+     * @returns Cleanup function to stop listening
+     */
+    onProofAnchored(callback: (event: {
+        proofHash: string;
+        eventType: EventType;
+        telikaId: string;
+        timestamp: number;
+        anchoredBy: string;
+    }) => void): () => void;
+    /**
+     * 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
+     */
+    queryProofEvents(fromBlock?: number, toBlock?: number): Promise<Array<{
+        proofHash: string;
+        eventType: EventType;
+        telikaId: string;
+        timestamp: number;
+        anchoredBy: string;
+        blockNumber: number;
+        transactionHash: string;
+    }>>;
+    /**
+     * Check if an address has the ANCHOR_ROLE.
+     *
+     * @param address - The address to check
+     * @returns Whether the address can anchor proofs
+     */
+    hasAnchorRole(address: string): Promise<boolean>;
+    /**
+     * Grant ANCHOR_ROLE to an address (requires admin role).
+     *
+     * @param address - The address to grant the role to
+     * @returns Transaction response
+     */
+    grantAnchorRole(address: string): Promise<ContractTransactionResponse>;
+    /**
+     * Revoke ANCHOR_ROLE from an address (requires admin role).
+     *
+     * @param address - The address to revoke the role from
+     * @returns Transaction response
+     */
+    revokeAnchorRole(address: string): Promise<ContractTransactionResponse>;
+    /**
+     * Get the contract address.
+     */
+    getContractAddress(): string;
+    /**
+     * Get the current signer address (if configured).
+     */
+    getSignerAddress(): Promise<string | undefined>;
+    /**
+     * Get the current block number.
+     */
+    getBlockNumber(): Promise<number>;
+    /**
+     * Get the balance of the signer (in MATIC/ETH).
+     */
+    getSignerBalance(): Promise<string>;
+    private requireSigner;
+    private parseProofRecord;
+}
+//# sourceMappingURL=blockchain-client.d.ts.map

package/dist/blockchain-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockchain-client.d.ts","sourceRoot":"","sources":["../src/blockchain-client.ts"],"names":[],"mappings":"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"}