@opaquecash/psr-core 0.1.0 → 0.2.0

package/dist/attestation.d.ts

@@ -0,0 +1,66 @@
+/**
+ * PSR V2 attestation codecs — chain-neutral (the attestation engine has the same encoding on
+ * Ethereum and Solana). Covers uid computation, attestation-data field encode/decode, and the
+ * `0xB2` announce-metadata marker that lets a recipient's scanner match a V2 attestation.
+ *
+ * Ported from `ethereum/frontend/src/lib/{attestationV2,psr}.ts` (UI-only zod schemas and display
+ * helpers intentionally dropped).
+ */
+import { type Address, type Hex } from "viem";
+import type { FieldDef } from "./schema.js";
+/** All-zero bytes32 (no reference uid). */
+export declare const ZERO_BYTES32: Hex;
+/** Minimal field descriptor accepted by the data codecs. */
+export type AttestationField = Pick<FieldDef, "name" | "type"> | {
+    name: string;
+    type: string;
+};
+/** A decoded V2 attestation record (chain-neutral view). */
+export interface AttestationV2 {
+    /** Stable id (== uid). */
+    address: string;
+    /** uid = sha256(schema_id || issuer || stealth_address_hash || block). */
+    uid: string;
+    /** schema id as 0x-hex. */
+    schemaId: string;
+    /** Issuer wallet/address. */
+    issuer: string;
+    /** Privacy-preserving stealth-address hash (bytes32 0x-hex). */
+    stealthAddressHash: string;
+    /** Encoded attestation data as 0x-hex. */
+    dataHex: string;
+    /** Block/slot when created. */
+    createdAt: number;
+    /** 0 = no expiry. */
+    expirationSlot: number;
+    /** 0 = not revoked. */
+    revocationSlot: number;
+    /** Reference uid (zeros = none). */
+    refUid: string;
+}
+/**
+ * `uid = sha256(abi.encodePacked(schemaId, issuer, stealthAddressHash, blockNumber))`,
+ * matching the attestation engine's `computeUid` on-chain.
+ */
+export declare function computeUid(schemaId: Hex, issuer: Address, stealthAddressHash: Hex, blockNumber: bigint): Hex;
+/** Encode field values: per field a 4-byte LE length prefix followed by UTF-8 bytes. */
+export declare function encodeAttestationData(fieldValues: Record<string, string>, fieldDefs: readonly AttestationField[]): Hex;
+/** Decode attestation data back into a field-value map. */
+export declare function decodeAttestationData(dataHex: Hex | string, fieldDefs: readonly AttestationField[]): Record<string, string>;
+/**
+ * Build the `announce` metadata for a V2 attestation:
+ * `viewTag(1) || 0xB2 || schemaId(32) || issuer(32) || uid(32) || nonce(32)` (130 bytes).
+ * The recipient's scanner matches it with their viewing key.
+ */
+export declare function encodeV2AttestationMetadata(args: {
+    viewTag: number;
+    schemaId: Hex;
+    issuer: Address;
+    uid: Hex;
+    nonce: Hex;
+}): Hex;
+/** A fresh 32-byte nonce as 0x-hex (uses Web Crypto, available in Node 18+ and browsers). */
+export declare function randomNonce(): Hex;
+/** True if a uid is all-zero (no reference). */
+export declare function isZeroUid(uid: string): boolean;
+//# sourceMappingURL=attestation.d.ts.map

package/dist/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAQL,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,2CAA2C;AAC3C,eAAO,MAAM,YAAY,EAA+B,GAAG,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,OAAO,EACf,kBAAkB,EAAE,GAAG,EACvB,WAAW,EAAE,MAAM,GAClB,GAAG,CAOL;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,GAAG,CAiBL;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,GAAG,MAAM,EACrB,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,GAAG,CAAC;CACZ,GAAG,GAAG,CASN;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,IAAI,GAAG,CAIjC;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/attestation.js

@@ -0,0 +1,82 @@
+/**
+ * PSR V2 attestation codecs — chain-neutral (the attestation engine has the same encoding on
+ * Ethereum and Solana). Covers uid computation, attestation-data field encode/decode, and the
+ * `0xB2` announce-metadata marker that lets a recipient's scanner match a V2 attestation.
+ *
+ * Ported from `ethereum/frontend/src/lib/{attestationV2,psr}.ts` (UI-only zod schemas and display
+ * helpers intentionally dropped).
+ */
+import { bytesToHex, concatHex, encodePacked, hexToBytes, numberToHex, pad, sha256, } from "viem";
+/** All-zero bytes32 (no reference uid). */
+export const ZERO_BYTES32 = ("0x" + "00".repeat(32));
+/**
+ * `uid = sha256(abi.encodePacked(schemaId, issuer, stealthAddressHash, blockNumber))`,
+ * matching the attestation engine's `computeUid` on-chain.
+ */
+export function computeUid(schemaId, issuer, stealthAddressHash, blockNumber) {
+    return sha256(encodePacked(["bytes32", "address", "bytes32", "uint256"], [schemaId, issuer, stealthAddressHash, blockNumber]));
+}
+/** Encode field values: per field a 4-byte LE length prefix followed by UTF-8 bytes. */
+export function encodeAttestationData(fieldValues, fieldDefs) {
+    const enc = new TextEncoder();
+    const parts = [];
+    for (const field of fieldDefs) {
+        const encoded = enc.encode(fieldValues[field.name] ?? "");
+        const lenBuf = new Uint8Array(4);
+        new DataView(lenBuf.buffer).setUint32(0, encoded.length, true);
+        parts.push(lenBuf, encoded);
+    }
+    const total = parts.reduce((acc, p) => acc + p.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return bytesToHex(out);
+}
+/** Decode attestation data back into a field-value map. */
+export function decodeAttestationData(dataHex, fieldDefs) {
+    const hx = (dataHex.startsWith("0x") ? dataHex : `0x${dataHex}`);
+    const bytes = hexToBytes(hx);
+    const dec = new TextDecoder();
+    const result = {};
+    let offset = 0;
+    for (const field of fieldDefs) {
+        if (offset + 4 > bytes.length)
+            break;
+        const len = new DataView(bytes.buffer, bytes.byteOffset + offset, 4).getUint32(0, true);
+        offset += 4;
+        if (offset + len > bytes.length)
+            break;
+        result[field.name] = dec.decode(bytes.slice(offset, offset + len));
+        offset += len;
+    }
+    return result;
+}
+/**
+ * Build the `announce` metadata for a V2 attestation:
+ * `viewTag(1) || 0xB2 || schemaId(32) || issuer(32) || uid(32) || nonce(32)` (130 bytes).
+ * The recipient's scanner matches it with their viewing key.
+ */
+export function encodeV2AttestationMetadata(args) {
+    return concatHex([
+        numberToHex(args.viewTag & 0xff, { size: 1 }),
+        "0xb2",
+        args.schemaId,
+        pad(args.issuer, { size: 32 }),
+        args.uid,
+        args.nonce,
+    ]);
+}
+/** A fresh 32-byte nonce as 0x-hex (uses Web Crypto, available in Node 18+ and browsers). */
+export function randomNonce() {
+    const b = new Uint8Array(32);
+    crypto.getRandomValues(b);
+    return bytesToHex(b);
+}
+/** True if a uid is all-zero (no reference). */
+export function isZeroUid(uid) {
+    return uid.replace(/^0x/, "").replace(/0/g, "") === "";
+}
+//# sourceMappingURL=attestation.js.map

package/dist/attestation.js.map

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

package/dist/index.d.ts

@@ -10,4 +10,6 @@ export { buildActionScope, externalNullifierFromScope } from "./scope.js";
 export type { Attestation, DiscoveredTrait, MerkleRootMeta, ProofData, } from "./types.js";
 export { PsrError, ProofError, RootExpiredError, NullifierUsedError, } from "./errors.js";
 export { attestationsToDiscoveredTraits } from "./traits.js";
+export { type FieldType, type FieldDef, type SchemaV2, SCHEMA_VERSION, ZERO_ADDRESS, parseFieldDefs, fieldDefsToString, computeSchemaId, packSchemaIdToField, } from "./schema.js";
+export { type AttestationField, type AttestationV2, ZERO_BYTES32, computeUid, encodeAttestationData, decodeAttestationData, encodeV2AttestationMetadata, randomNonce, isZeroUid, } from "./attestation.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE1E,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE1E,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EACL,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,WAAW,EACX,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -9,4 +9,7 @@ export { PSR_CIRCUIT_VERSION } from "./scope.js";
 export { buildActionScope, externalNullifierFromScope } from "./scope.js";
 export { PsrError, ProofError, RootExpiredError, NullifierUsedError, } from "./errors.js";
 export { attestationsToDiscoveredTraits } from "./traits.js";
+// PSR V2 schema + attestation codecs (chain-neutral).
+export { SCHEMA_VERSION, ZERO_ADDRESS, parseFieldDefs, fieldDefsToString, computeSchemaId, packSchemaIdToField, } from "./schema.js";
+export { ZERO_BYTES32, computeUid, encodeAttestationData, decodeAttestationData, encodeV2AttestationMetadata, randomNonce, isZeroUid, } from "./attestation.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAS1E,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAS1E,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAE7D,sDAAsD;AACtD,OAAO,EAIL,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,WAAW,EACX,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PSR V2 schema codecs — chain-neutral. A schema defines an attestation class and controls who
+ * may issue it. Ported from `ethereum/frontend/src/lib/schema.ts` (zod schemas dropped).
+ */
+import { type Address, type Hex } from "viem";
+export type FieldType = "bool" | "u8" | "u16" | "u32" | "u64" | "string" | "pubkey";
+export interface FieldDef {
+    id: string;
+    name: string;
+    type: FieldType;
+}
+/** A decoded V2 schema record (chain-neutral view). */
+export interface SchemaV2 {
+    /** Stable id (== schemaId). */
+    address: string;
+    /** schemaId = sha256(authority || name || version) as 0x-hex (bytes32). */
+    schemaId: string;
+    /** Wallet that created the schema. */
+    authority: string;
+    /** Optional resolver (zero address = none). */
+    resolver: string;
+    /** Whether attestations can be revoked. */
+    revocable: boolean;
+    /** Display name. */
+    name: string;
+    /** ABI-style field definitions, e.g. "bool passed, u64 score". */
+    fieldDefinitions: string;
+    /** Schema version (always 1 currently). */
+    version: number;
+    /** Authorized delegate addresses. */
+    delegates: string[];
+    /** Block/slot when registered. */
+    createdAt: number;
+    /** 0 = no expiry. */
+    schemaExpirySlot: number;
+    /** Whether the schema has been deprecated. */
+    deprecated: boolean;
+}
+export declare const SCHEMA_VERSION = 1;
+export declare const ZERO_ADDRESS: Address;
+/** Parse a `fieldDefinitions` string ("bool passed, u64 score") into {@link FieldDef}s. */
+export declare function parseFieldDefs(fieldDefs: string): FieldDef[];
+/** Convert {@link FieldDef}s back to the canonical ABI string. */
+export declare function fieldDefsToString(fields: readonly FieldDef[]): string;
+/**
+ * `schemaId = sha256(abi.encodePacked(authority, bytes(name), version))`, byte-for-byte matching
+ * the schema registry's `computeSchemaId` on-chain.
+ */
+export declare function computeSchemaId(authority: Address, name: string, version?: number): Hex;
+/** Normalize a schemaId hex to the `0x`-prefixed field input the V2 circuit expects. */
+export declare function packSchemaIdToField(schemaId: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,YAAY,EAAmD,OAAO,CAAC;AAEpF,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAS5D;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAKrE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAuB,GAC/B,GAAG,CAEL;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/schema.js

@@ -0,0 +1,38 @@
+/**
+ * PSR V2 schema codecs — chain-neutral. A schema defines an attestation class and controls who
+ * may issue it. Ported from `ethereum/frontend/src/lib/schema.ts` (zod schemas dropped).
+ */
+import { encodePacked, sha256 } from "viem";
+export const SCHEMA_VERSION = 1;
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** Parse a `fieldDefinitions` string ("bool passed, u64 score") into {@link FieldDef}s. */
+export function parseFieldDefs(fieldDefs) {
+    if (!fieldDefs.trim())
+        return [];
+    return fieldDefs.split(",").map((part, i) => {
+        const trimmed = part.trim();
+        const spaceIdx = trimmed.indexOf(" ");
+        const type = (spaceIdx === -1 ? "string" : trimmed.slice(0, spaceIdx));
+        const name = spaceIdx === -1 ? trimmed : trimmed.slice(spaceIdx + 1);
+        return { id: String(i), name: name.trim(), type: type.trim() };
+    });
+}
+/** Convert {@link FieldDef}s back to the canonical ABI string. */
+export function fieldDefsToString(fields) {
+    return fields
+        .filter((f) => f.name.trim())
+        .map((f) => `${f.type} ${f.name.trim()}`)
+        .join(", ");
+}
+/**
+ * `schemaId = sha256(abi.encodePacked(authority, bytes(name), version))`, byte-for-byte matching
+ * the schema registry's `computeSchemaId` on-chain.
+ */
+export function computeSchemaId(authority, name, version = SCHEMA_VERSION) {
+    return sha256(encodePacked(["address", "string", "uint8"], [authority, name, version]));
+}
+/** Normalize a schemaId hex to the `0x`-prefixed field input the V2 circuit expects. */
+export function packSchemaIdToField(schemaId) {
+    return schemaId.startsWith("0x") ? schemaId : "0x" + schemaId;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,EAA0B,MAAM,MAAM,CAAC;AAsCpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,4CAAuD,CAAC;AAEpF,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAc,CAAC;QACpF,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAe,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;SACxC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAkB,EAClB,IAAY,EACZ,UAAkB,cAAc;IAEhC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC;AAChE,CAAC"}

package/dist/types.d.ts

@@ -44,6 +44,8 @@ export interface MerkleRootMeta {
 }
 /**
  * Groth16 proof bundle compatible with {@link submitVerifyReputation} in `@opaquecash/psr-chain`.
+ *
+ * V2 public signals: `[merkle_root, attestation_id, external_nullifier, nullifier_hash]`.
  */
 export interface ProofData {
     proof: {
@@ -52,6 +54,7 @@ export interface ProofData {
         pi_c: string[];
     };
     publicSignals: string[];
+    /** V2 `nullifier_hash` (`publicSignals[3]` = `Poseidon(stealth_pk, external_nullifier)`). */
     nullifier: string;
     attestationId: number;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,GAAG,CAAC;IACV,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,GAAG,CAAC;IACV,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opaquecash/psr-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Programmable Stealth Reputation types, scoping, and error taxonomy",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,5 +21,15 @@
   "dependencies": {
     "viem": "^2.21.0"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opaquecash/sdk.git",
+    "directory": "packages/psr-core"
+  },
+  "homepage": "https://docs.opaque.cash",
+  "publishConfig": {
+    "access": "public"
+  }
 }