@veritier/sdk 0.1.0

package/dist/AgentManager.d.ts

@@ -0,0 +1,32 @@
+import { ethers } from "ethers";
+import type { VeritierConfig, AgentInfo, RegisterAgentParams, SubmitFeedbackParams, UpgradeAgentTierParams } from "./types";
+export declare class AgentManager {
+    private provider;
+    private contract;
+    constructor(config: VeritierConfig, provider: ethers.JsonRpcProvider);
+    /**
+     * Register a new AI agent. Caller must be Tier 2+.
+     * Returns the new agent's token ID and transaction receipt.
+     */
+    registerAgent(params: RegisterAgentParams): Promise<{
+        agentId: bigint;
+        tx: ethers.TransactionReceipt;
+    }>;
+    /** Get the tier of an agent */
+    getAgentTier(agentId: bigint): Promise<number>;
+    /** Get full agent details */
+    getAgent(agentId: bigint): Promise<AgentInfo>;
+    /** Submit feedback for an agent (-100 to +100) */
+    submitFeedback(params: SubmitFeedbackParams): Promise<ethers.TransactionReceipt>;
+    /** Upgrade agent tier (requires reputation threshold + cooldown) */
+    upgradeAgentTier(params: UpgradeAgentTierParams): Promise<ethers.TransactionReceipt>;
+    /** Get reputation score for an agent */
+    getReputationScore(agentId: bigint): Promise<{
+        total: bigint;
+        count: bigint;
+        average: number;
+    }>;
+    /** Check if an agent meets a required tier */
+    isAgentTierValid(agentId: bigint, requiredTier: number): Promise<boolean>;
+}
+//# sourceMappingURL=AgentManager.d.ts.map

package/dist/AgentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAGjB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,eAAe;IASpE;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,CAAA;KAAE,CAAC;IAoB9D,+BAA+B;IACzB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD,6BAA6B;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBnD,kDAAkD;IAC5C,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAMtF,oEAAoE;IAC9D,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAM1F,wCAAwC;IAClC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQrG,8CAA8C;IACxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGhF"}

package/dist/AgentManager.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentManager = void 0;
+const ethers_1 = require("ethers");
+const AgentRegistry_json_1 = __importDefault(require("./abis/AgentRegistry.json"));
+class AgentManager {
+    provider;
+    contract;
+    constructor(config, provider) {
+        this.provider = provider;
+        this.contract = new ethers_1.ethers.Contract(config.contracts.agentRegistry, AgentRegistry_json_1.default, provider);
+    }
+    /**
+     * Register a new AI agent. Caller must be Tier 2+.
+     * Returns the new agent's token ID and transaction receipt.
+     */
+    async registerAgent(params) {
+        const contract = this.contract.connect(params.signer);
+        const tx = await contract.registerAgent(params.agentURI);
+        const receipt = await tx.wait();
+        // Extract agentId from AgentRegistered event
+        const event = receipt.logs
+            .map((log) => {
+            try {
+                return this.contract.interface.parseLog({ topics: [...log.topics], data: log.data });
+            }
+            catch {
+                return null;
+            }
+        })
+            .find((e) => e?.name === "AgentRegistered");
+        const agentId = event ? BigInt(event.args[0]) : 0n;
+        return { agentId, tx: receipt };
+    }
+    /** Get the tier of an agent */
+    async getAgentTier(agentId) {
+        return Number(await this.contract.getAgentTier(agentId));
+    }
+    /** Get full agent details */
+    async getAgent(agentId) {
+        const [owner, uri, tier, reputation] = await Promise.all([
+            this.contract.getAgentOwner(agentId),
+            this.contract.getAgentURI(agentId),
+            this.contract.getAgentTier(agentId).then((t) => Number(t)),
+            this.contract.getReputationScore(agentId),
+        ]);
+        const total = reputation[0];
+        const count = reputation[1];
+        const average = count > 0n ? Number(total) / Number(count) : 0;
+        return {
+            id: agentId,
+            owner,
+            uri,
+            tier,
+            reputation: { total, count, average },
+        };
+    }
+    /** Submit feedback for an agent (-100 to +100) */
+    async submitFeedback(params) {
+        const contract = this.contract.connect(params.signer);
+        const tx = await contract.submitFeedback(params.agentId, params.score, params.tag);
+        return await tx.wait();
+    }
+    /** Upgrade agent tier (requires reputation threshold + cooldown) */
+    async upgradeAgentTier(params) {
+        const contract = this.contract.connect(params.signer);
+        const tx = await contract.upgradeAgentTier(params.agentId, params.newTier, "0x");
+        return await tx.wait();
+    }
+    /** Get reputation score for an agent */
+    async getReputationScore(agentId) {
+        const result = await this.contract.getReputationScore(agentId);
+        const total = BigInt(result[0]);
+        const count = BigInt(result[1]);
+        const average = count > 0n ? Number(total) / Number(count) : 0;
+        return { total, count, average };
+    }
+    /** Check if an agent meets a required tier */
+    async isAgentTierValid(agentId, requiredTier) {
+        return await this.contract.isAgentTierValid(agentId, requiredTier);
+    }
+}
+exports.AgentManager = AgentManager;
+//# sourceMappingURL=AgentManager.js.map

package/dist/AgentManager.js.map

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

package/dist/HSPSettlementGate.d.ts

@@ -0,0 +1,43 @@
+import type { Veritier } from "./Veritier";
+export interface SettlementCheckParams {
+    from: string;
+    to: string;
+    amount: number;
+}
+export interface SettlementResult {
+    allowed: boolean;
+    requiredTier: number;
+    senderTier: number;
+    receiverTier: number;
+    reason?: string;
+}
+/**
+ * HSPSettlementGate — HashKey Settlement Protocol compliance middleware
+ *
+ * Verifies both sender and receiver meet the required Veritier tier
+ * for the transaction amount before an HSP settlement is processed.
+ *
+ * Tier thresholds (mapped to Hong Kong SFC regulatory levels):
+ *   - ≤ $1,000   → Tier 1 (Basic)
+ *   - ≤ $50,000  → Tier 2 (Verified)
+ *   - Unlimited   → Tier 3 (Institutional)
+ */
+export declare class HSPSettlementGate {
+    private veritier;
+    private static readonly THRESHOLDS;
+    constructor(veritier: Veritier);
+    /**
+     * Check whether a settlement between two parties is allowed
+     * based on their Veritier tier and the transaction amount.
+     */
+    checkSettlement(params: SettlementCheckParams): Promise<SettlementResult>;
+    checkSettlement(from: string, to: string, amount: number): Promise<SettlementResult>;
+    /**
+     * Check a settlement using demo/mock tiers (no on-chain call).
+     * Used when no wallet is connected or in demo mode.
+     */
+    static checkSettlementDemo(amount: number, senderTier: number, receiverTier: number): SettlementResult;
+    /** Determine the minimum tier required for a given USD amount */
+    static getRequiredTier(amount: number): number;
+}
+//# sourceMappingURL=HSPSettlementGate.d.ts.map

package/dist/HSPSettlementGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HSPSettlementGate.d.ts","sourceRoot":"","sources":["../src/HSPSettlementGate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAIhC;gBAEU,QAAQ,EAAE,QAAQ;IAI9B;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqC1F;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,gBAAgB;IAsBnB,iEAAiE;IACjE,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAM/C"}

package/dist/HSPSettlementGate.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HSPSettlementGate = void 0;
+/**
+ * HSPSettlementGate — HashKey Settlement Protocol compliance middleware
+ *
+ * Verifies both sender and receiver meet the required Veritier tier
+ * for the transaction amount before an HSP settlement is processed.
+ *
+ * Tier thresholds (mapped to Hong Kong SFC regulatory levels):
+ *   - ≤ $1,000   → Tier 1 (Basic)
+ *   - ≤ $50,000  → Tier 2 (Verified)
+ *   - Unlimited   → Tier 3 (Institutional)
+ */
+class HSPSettlementGate {
+    veritier;
+    static THRESHOLDS = [
+        { maxAmount: 1_000, tier: 1 },
+        { maxAmount: 50_000, tier: 2 },
+        { maxAmount: Infinity, tier: 3 },
+    ];
+    constructor(veritier) {
+        this.veritier = veritier;
+    }
+    async checkSettlement(fromOrParams, to, amount) {
+        const params = typeof fromOrParams === "string"
+            ? { from: fromOrParams, to: to, amount: amount }
+            : fromOrParams;
+        const requiredTier = HSPSettlementGate.getRequiredTier(params.amount);
+        const [senderTier, receiverTier] = await Promise.all([
+            this.veritier.getTier(params.from),
+            this.veritier.getTier(params.to),
+        ]);
+        const senderOk = senderTier >= requiredTier;
+        const receiverOk = receiverTier >= requiredTier;
+        if (senderOk && receiverOk) {
+            return { allowed: true, requiredTier, senderTier, receiverTier };
+        }
+        const reasons = [];
+        if (!senderOk)
+            reasons.push(`Sender needs Tier ${requiredTier}, has Tier ${senderTier}`);
+        if (!receiverOk)
+            reasons.push(`Receiver needs Tier ${requiredTier}, has Tier ${receiverTier}`);
+        return {
+            allowed: false,
+            requiredTier,
+            senderTier,
+            receiverTier,
+            reason: reasons.join(". "),
+        };
+    }
+    /**
+     * Check a settlement using demo/mock tiers (no on-chain call).
+     * Used when no wallet is connected or in demo mode.
+     */
+    static checkSettlementDemo(amount, senderTier, receiverTier) {
+        const requiredTier = HSPSettlementGate.getRequiredTier(amount);
+        const senderOk = senderTier >= requiredTier;
+        const receiverOk = receiverTier >= requiredTier;
+        if (senderOk && receiverOk) {
+            return { allowed: true, requiredTier, senderTier, receiverTier };
+        }
+        const reasons = [];
+        if (!senderOk)
+            reasons.push(`Sender needs Tier ${requiredTier}, has Tier ${senderTier}`);
+        if (!receiverOk)
+            reasons.push(`Receiver needs Tier ${requiredTier}, has Tier ${receiverTier}`);
+        return {
+            allowed: false,
+            requiredTier,
+            senderTier,
+            receiverTier,
+            reason: reasons.join(". "),
+        };
+    }
+    /** Determine the minimum tier required for a given USD amount */
+    static getRequiredTier(amount) {
+        for (const t of HSPSettlementGate.THRESHOLDS) {
+            if (amount <= t.maxAmount)
+                return t.tier;
+        }
+        return 3;
+    }
+}
+exports.HSPSettlementGate = HSPSettlementGate;
+//# sourceMappingURL=HSPSettlementGate.js.map

package/dist/HSPSettlementGate.js.map

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

package/dist/IdentityManager.d.ts

@@ -0,0 +1,30 @@
+import { ethers } from "ethers";
+import type { VeritierConfig, VerifyAndRegisterParams } from "./types";
+export declare class IdentityManager {
+    private provider;
+    private contract;
+    private config;
+    constructor(config: VeritierConfig, provider: ethers.JsonRpcProvider);
+    /** Get the current tier of an address (returns 0 if expired) */
+    getTier(address: string): Promise<number>;
+    /** Check if an address is verified (tier > 0 and not expired) */
+    isVerified(address: string): Promise<boolean>;
+    /** Check if an address meets a required tier */
+    isTierValid(address: string, requiredTier: number): Promise<boolean>;
+    /** Get the identity Merkle root */
+    getIdentityRoot(): Promise<string>;
+    /** Check if a nullifier has been used */
+    isNullifierUsed(nullifier: string): Promise<boolean>;
+    /** Check if an address is a trusted issuer */
+    isTrustedIssuer(address: string): Promise<boolean>;
+    /**
+     * Verify a ZK proof and register at a tier.
+     * Converts the snarkjs proof format to Solidity calldata and submits on-chain.
+     */
+    verifyAndRegister(params: VerifyAndRegisterParams): Promise<ethers.TransactionReceipt>;
+    /**
+     * Upgrade to a higher tier with a new proof.
+     */
+    upgradeTier(params: VerifyAndRegisterParams): Promise<ethers.TransactionReceipt>;
+}
+//# sourceMappingURL=IdentityManager.d.ts.map

package/dist/IdentityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityManager.d.ts","sourceRoot":"","sources":["../src/IdentityManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIvE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,eAAe;IAUpE,gEAAgE;IAC1D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/C,iEAAiE;IAC3D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,gDAAgD;IAC1C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,mCAAmC;IAC7B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxC,yCAAyC;IACnC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,8CAA8C;IACxC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAe5F;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;CAcvF"}

package/dist/IdentityManager.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityManager = void 0;
+const ethers_1 = require("ethers");
+const ProofGenerator_1 = require("./ProofGenerator");
+const IdentityRegistry_json_1 = __importDefault(require("./abis/IdentityRegistry.json"));
+class IdentityManager {
+    provider;
+    contract;
+    config;
+    constructor(config, provider) {
+        this.config = config;
+        this.provider = provider;
+        this.contract = new ethers_1.ethers.Contract(config.contracts.identityRegistry, IdentityRegistry_json_1.default, provider);
+    }
+    /** Get the current tier of an address (returns 0 if expired) */
+    async getTier(address) {
+        return Number(await this.contract.getTier(address));
+    }
+    /** Check if an address is verified (tier > 0 and not expired) */
+    async isVerified(address) {
+        return await this.contract.isVerified(address);
+    }
+    /** Check if an address meets a required tier */
+    async isTierValid(address, requiredTier) {
+        return await this.contract.isTierValid(address, requiredTier);
+    }
+    /** Get the identity Merkle root */
+    async getIdentityRoot() {
+        return await this.contract.getIdentityRoot();
+    }
+    /** Check if a nullifier has been used */
+    async isNullifierUsed(nullifier) {
+        return await this.contract.isNullifierUsed(nullifier);
+    }
+    /** Check if an address is a trusted issuer */
+    async isTrustedIssuer(address) {
+        return await this.contract.isTrustedIssuer(address);
+    }
+    /**
+     * Verify a ZK proof and register at a tier.
+     * Converts the snarkjs proof format to Solidity calldata and submits on-chain.
+     */
+    async verifyAndRegister(params) {
+        const { proof, publicSignals, targetTier, signer } = params;
+        const calldata = ProofGenerator_1.ProofGenerator.proofToSolidityCalldata(proof);
+        const contract = this.contract.connect(signer);
+        const tx = await contract.verifyAndRegister(calldata.pA, calldata.pB, calldata.pC, publicSignals.map((s) => BigInt(s)), targetTier);
+        return await tx.wait();
+    }
+    /**
+     * Upgrade to a higher tier with a new proof.
+     */
+    async upgradeTier(params) {
+        const { proof, publicSignals, targetTier: newTier, signer } = params;
+        const calldata = ProofGenerator_1.ProofGenerator.proofToSolidityCalldata(proof);
+        const contract = this.contract.connect(signer);
+        const tx = await contract.upgradeTier(calldata.pA, calldata.pB, calldata.pC, publicSignals.map((s) => BigInt(s)), newTier);
+        return await tx.wait();
+    }
+}
+exports.IdentityManager = IdentityManager;
+//# sourceMappingURL=IdentityManager.js.map

package/dist/IdentityManager.js.map

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

package/dist/ProofGenerator.d.ts

@@ -0,0 +1,27 @@
+import type { CircuitArtifact, Groth16Proof, SolidityCalldata, ProofResult, AgeProofParams, JurisdictionProofParams, TierProofParams } from "./types";
+export declare class ProofGenerator {
+    private artifacts;
+    constructor(artifacts: Record<string, CircuitArtifact>);
+    /**
+     * Generate a Groth16 proof for a given circuit
+     */
+    generateProof(circuitName: string, inputs: Record<string, string | string[]>): Promise<ProofResult>;
+    /**
+     * Generate an AgeProof — proves user is at least ageThreshold years old
+     */
+    generateAgeProof(params: AgeProofParams): Promise<ProofResult>;
+    /**
+     * Generate a JurisdictionProof — proves user's country is in allowed whitelist
+     */
+    generateJurisdictionProof(params: JurisdictionProofParams): Promise<ProofResult>;
+    /**
+     * Generate a TierProof — proves user holds a specific tier or higher
+     */
+    generateTierProof(params: TierProofParams): Promise<ProofResult>;
+    /**
+     * Convert snarkjs proof to Solidity calldata format.
+     * Note: pi_b coordinates are swapped (x1,x0 → x0,x1) for the BN128 pairing check.
+     */
+    static proofToSolidityCalldata(proof: Groth16Proof): SolidityCalldata;
+}
+//# sourceMappingURL=ProofGenerator.d.ts.map

package/dist/ProofGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProofGenerator.d.ts","sourceRoot":"","sources":["../src/ProofGenerator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAkC;gBAEvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAItD;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,OAAO,CAAC,WAAW,CAAC;IAavB;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAapE;;OAEG;IACG,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAetF;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAYtE;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB;CAUtE"}

package/dist/ProofGenerator.js

@@ -0,0 +1,115 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProofGenerator = void 0;
+const snarkjs = __importStar(require("snarkjs"));
+class ProofGenerator {
+    artifacts;
+    constructor(artifacts) {
+        this.artifacts = artifacts;
+    }
+    /**
+     * Generate a Groth16 proof for a given circuit
+     */
+    async generateProof(circuitName, inputs) {
+        const artifact = this.artifacts[circuitName];
+        if (!artifact)
+            throw new Error(`Unknown circuit: ${circuitName}`);
+        const { proof, publicSignals } = await snarkjs.groth16.fullProve(inputs, artifact.wasm, artifact.zkey);
+        return { proof: proof, publicSignals };
+    }
+    /**
+     * Generate an AgeProof — proves user is at least ageThreshold years old
+     */
+    async generateAgeProof(params) {
+        return this.generateProof("ageProof", {
+            birthDate: params.birthDate.toString(),
+            issuerPubKey: [params.issuerPubKey[0].toString(), params.issuerPubKey[1].toString()],
+            signatureR8: [params.signatureR8[0].toString(), params.signatureR8[1].toString()],
+            signatureS: params.signatureS.toString(),
+            ageThreshold: params.ageThreshold.toString(),
+            currentDate: params.currentDate.toString(),
+            issuerPubKeyHash: params.issuerPubKeyHash.toString(),
+            nullifier: params.nullifier.toString(),
+        });
+    }
+    /**
+     * Generate a JurisdictionProof — proves user's country is in allowed whitelist
+     */
+    async generateJurisdictionProof(params) {
+        return this.generateProof("jurisdictionProof", {
+            countryCode: params.countryCode.toString(),
+            issuerPubKey: [params.issuerPubKey[0].toString(), params.issuerPubKey[1].toString()],
+            signatureR8: [params.signatureR8[0].toString(), params.signatureR8[1].toString()],
+            signatureS: params.signatureS.toString(),
+            pathElements: params.pathElements.map((e) => e.toString()),
+            pathIndices: params.pathIndices.map((i) => i.toString()),
+            allowedCountriesRoot: params.allowedCountriesRoot.toString(),
+            issuerPubKeyHash: params.issuerPubKeyHash.toString(),
+            nullifier: params.nullifier.toString(),
+            jurisdictionBucket: params.jurisdictionBucket.toString(),
+        });
+    }
+    /**
+     * Generate a TierProof — proves user holds a specific tier or higher
+     */
+    async generateTierProof(params) {
+        return this.generateProof("tierProof", {
+            userTier: params.userTier.toString(),
+            secret: params.secret.toString(),
+            pathElements: params.pathElements.map((e) => e.toString()),
+            pathIndices: params.pathIndices.map((i) => i.toString()),
+            requiredTier: params.requiredTier.toString(),
+            identityRoot: params.identityRoot.toString(),
+            userAddress: params.userAddress.toString(),
+        });
+    }
+    /**
+     * Convert snarkjs proof to Solidity calldata format.
+     * Note: pi_b coordinates are swapped (x1,x0 → x0,x1) for the BN128 pairing check.
+     */
+    static proofToSolidityCalldata(proof) {
+        return {
+            pA: [BigInt(proof.pi_a[0]), BigInt(proof.pi_a[1])],
+            pB: [
+                [BigInt(proof.pi_b[0][1]), BigInt(proof.pi_b[0][0])],
+                [BigInt(proof.pi_b[1][1]), BigInt(proof.pi_b[1][0])],
+            ],
+            pC: [BigInt(proof.pi_c[0]), BigInt(proof.pi_c[1])],
+        };
+    }
+}
+exports.ProofGenerator = ProofGenerator;
+//# sourceMappingURL=ProofGenerator.js.map

package/dist/ProofGenerator.js.map

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

package/dist/TierChecker.d.ts

@@ -0,0 +1,13 @@
+import { ethers } from "ethers";
+import type { VeritierConfig, TierDistribution } from "./types";
+export declare class TierChecker {
+    private provider;
+    private aggregator;
+    private identityAddress;
+    constructor(config: VeritierConfig, provider: ethers.JsonRpcProvider);
+    /** Get aggregate tier distribution from ComplianceAggregator */
+    getTierDistribution(): Promise<TierDistribution>;
+    /** Get jurisdiction distribution (bucket → count) */
+    getJurisdictionDistribution(): Promise<Record<number, bigint>>;
+}
+//# sourceMappingURL=TierChecker.d.ts.map

package/dist/TierChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TierChecker.d.ts","sourceRoot":"","sources":["../src/TierChecker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhE,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,eAAe;IAUpE,gEAAgE;IAC1D,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAatD,qDAAqD;IAC/C,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAYrE"}

package/dist/TierChecker.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TierChecker = void 0;
+const ethers_1 = require("ethers");
+const ComplianceAggregator_json_1 = __importDefault(require("./abis/ComplianceAggregator.json"));
+class TierChecker {
+    provider;
+    aggregator;
+    identityAddress;
+    constructor(config, provider) {
+        this.provider = provider;
+        this.identityAddress = config.contracts.identityRegistry;
+        this.aggregator = new ethers_1.ethers.Contract(config.contracts.complianceAggregator, ComplianceAggregator_json_1.default, provider);
+    }
+    /** Get aggregate tier distribution from ComplianceAggregator */
+    async getTierDistribution() {
+        const [tier0, tier1, tier2, tier3, totalHumans, totalAgents] = await Promise.all([
+            this.aggregator.tierCounts(0).then((v) => BigInt(v)),
+            this.aggregator.tierCounts(1).then((v) => BigInt(v)),
+            this.aggregator.tierCounts(2).then((v) => BigInt(v)),
+            this.aggregator.tierCounts(3).then((v) => BigInt(v)),
+            this.aggregator.totalHumans().then((v) => BigInt(v)),
+            this.aggregator.totalAgents().then((v) => BigInt(v)),
+        ]);
+        return { tier0, tier1, tier2, tier3, totalHumans, totalAgents };
+    }
+    /** Get jurisdiction distribution (bucket → count) */
+    async getJurisdictionDistribution() {
+        const buckets = {};
+        const results = await Promise.all([0, 1, 2, 3, 4, 5].map((b) => this.aggregator.jurisdictionCounts(b).then((v) => BigInt(v))));
+        for (let i = 0; i < 6; i++) {
+            buckets[i] = results[i];
+        }
+        return buckets;
+    }
+}
+exports.TierChecker = TierChecker;
+//# sourceMappingURL=TierChecker.js.map

package/dist/TierChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TierChecker.js","sourceRoot":"","sources":["../src/TierChecker.ts"],"names":[],"mappings":";;;;;;AAAA,mCAAgC;AAEhC,iGAAuE;AAEvE,MAAa,WAAW;IACd,QAAQ,CAAyB;IACjC,UAAU,CAAkB;IAC5B,eAAe,CAAS;IAEhC,YAAY,MAAsB,EAAE,QAAgC;QAClE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC;QACzD,IAAI,CAAC,UAAU,GAAG,IAAI,eAAM,CAAC,QAAQ,CACnC,MAAM,CAAC,SAAS,CAAC,oBAAoB,EACrC,mCAAuB,EACvB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,mBAAmB;QACvB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC7D,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IAClE,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,2BAA2B;QAC/B,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACrE,CACF,CAAC;QACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA1CD,kCA0CC"}