@collectorcrypt/vrf-client 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -10,8 +10,8 @@ export { CC_VRF_PROGRAM_ID, SUITE_EDWARDS25519_SHA512_TAI } from "./constants";
 export { deriveAuthorityAddress, deriveProofCommitAddress, deriveProofCommitWithBetaAddress, memoHash, alphaHash, proofHash, encodeLabel, } from "./addresses";
 export { forceLightV2, buildCreateContext, buildCommitProofContext, buildReadOnlyAuthorityContext, buildMutateContext, } from "./light";
 export { getProgram } from "./program";
-export { buildInitAuthorityIx, buildFreezeAuthorityIx, buildRevokeAuthorityIx, buildCommitProofIx, buildCommitProofEventIx, buildCommitProofWithBetaIx, fetchAuthority, fetchProofCommit, fetchProofCommitWithBeta, fetchProofCommitEvents, decodeAuthority, decodeProofCommit, decodeProofCommitWithBeta, asTx, } from "./operations";
-export type { InitAuthorityInput, FreezeAuthorityInput, CommitProofInput, ProofCommitEvent, } from "./operations";
+export { buildInitAuthorityIx, buildFreezeAuthorityIx, buildRevokeAuthorityIx, buildCommitProofIx, buildCommitProofEventIx, buildCommitProofWithBetaIx, fetchAuthority, fetchProofCommit, fetchProofCommitWithBeta, fetchProofCommitEvents, findProofCommitEvents, decodeAuthority, decodeProofCommit, decodeProofCommitWithBeta, asTx, } from "./operations";
+export type { InitAuthorityInput, FreezeAuthorityInput, CommitProofInput, ProofCommitEvent, ProofCommitEventQuery, ProofCommitEventResult, } from "./operations";
 export { verifyEndToEnd, verifyAuthorityCommitEndToEnd, pickCanonicalCommit, } from "./verifyEndToEnd";
 export type { OnChainAuthority, OnChainCommit, VerifyAuthorityCommitEndToEndInput, VerifyAuthorityCommitEndToEndResult, VerifyEndToEndInput, VerifyEndToEndResult, PickCanonicalResult, } from "./verifyEndToEnd";
 //# 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;AAGH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kCAAkC,EAClC,mCAAmC,EACnC,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kCAAkC,EAClC,mCAAmC,EACnC,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@
  * consumers can publish, commit, and verify VRF proofs with one import.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickCanonicalCommit = exports.verifyAuthorityCommitEndToEnd = exports.verifyEndToEnd = exports.asTx = exports.decodeProofCommitWithBeta = exports.decodeProofCommit = exports.decodeAuthority = exports.fetchProofCommitEvents = exports.fetchProofCommitWithBeta = exports.fetchProofCommit = exports.fetchAuthority = exports.buildCommitProofWithBetaIx = exports.buildCommitProofEventIx = exports.buildCommitProofIx = exports.buildRevokeAuthorityIx = exports.buildFreezeAuthorityIx = exports.buildInitAuthorityIx = exports.getProgram = exports.buildMutateContext = exports.buildReadOnlyAuthorityContext = exports.buildCommitProofContext = exports.buildCreateContext = exports.forceLightV2 = exports.encodeLabel = exports.proofHash = exports.alphaHash = exports.memoHash = exports.deriveProofCommitWithBetaAddress = exports.deriveProofCommitAddress = exports.deriveAuthorityAddress = exports.SUITE_EDWARDS25519_SHA512_TAI = exports.CC_VRF_PROGRAM_ID = exports.hexToBytes = exports.bytesToHex = exports.vrfProofToHash = exports.verifyVRF = exports.proveVRF = exports.publicKeyFromSeed = exports.generateKeyPair = void 0;
+exports.pickCanonicalCommit = exports.verifyAuthorityCommitEndToEnd = exports.verifyEndToEnd = exports.asTx = exports.decodeProofCommitWithBeta = exports.decodeProofCommit = exports.decodeAuthority = exports.findProofCommitEvents = exports.fetchProofCommitEvents = exports.fetchProofCommitWithBeta = exports.fetchProofCommit = exports.fetchAuthority = exports.buildCommitProofWithBetaIx = exports.buildCommitProofEventIx = exports.buildCommitProofIx = exports.buildRevokeAuthorityIx = exports.buildFreezeAuthorityIx = exports.buildInitAuthorityIx = exports.getProgram = exports.buildMutateContext = exports.buildReadOnlyAuthorityContext = exports.buildCommitProofContext = exports.buildCreateContext = exports.forceLightV2 = exports.encodeLabel = exports.proofHash = exports.alphaHash = exports.memoHash = exports.deriveProofCommitWithBetaAddress = exports.deriveProofCommitAddress = exports.deriveAuthorityAddress = exports.SUITE_EDWARDS25519_SHA512_TAI = exports.CC_VRF_PROGRAM_ID = exports.hexToBytes = exports.bytesToHex = exports.vrfProofToHash = exports.verifyVRF = exports.proveVRF = exports.publicKeyFromSeed = exports.generateKeyPair = void 0;
 // Re-export the ECVRF primitives so consumers don't need a second import.
 var ecvrf_1 = require("@collectorcrypt/ecvrf");
 Object.defineProperty(exports, "generateKeyPair", { enumerable: true, get: function () { return ecvrf_1.generateKeyPair; } });
@@ -47,6 +47,7 @@ Object.defineProperty(exports, "fetchAuthority", { enumerable: true, get: functi
 Object.defineProperty(exports, "fetchProofCommit", { enumerable: true, get: function () { return operations_1.fetchProofCommit; } });
 Object.defineProperty(exports, "fetchProofCommitWithBeta", { enumerable: true, get: function () { return operations_1.fetchProofCommitWithBeta; } });
 Object.defineProperty(exports, "fetchProofCommitEvents", { enumerable: true, get: function () { return operations_1.fetchProofCommitEvents; } });
+Object.defineProperty(exports, "findProofCommitEvents", { enumerable: true, get: function () { return operations_1.findProofCommitEvents; } });
 Object.defineProperty(exports, "decodeAuthority", { enumerable: true, get: function () { return operations_1.decodeAuthority; } });
 Object.defineProperty(exports, "decodeProofCommit", { enumerable: true, get: function () { return operations_1.decodeProofCommit; } });
 Object.defineProperty(exports, "decodeProofCommitWithBeta", { enumerable: true, get: function () { return operations_1.decodeProofCommitWithBeta; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,0EAA0E;AAC1E,+CAQ+B;AAP7B,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AACjB,iGAAA,QAAQ,OAAA;AACR,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AAGZ,yCAA+E;AAAtE,8GAAA,iBAAiB,OAAA;AAAE,0HAAA,6BAA6B,OAAA;AAEzD,yCAQqB;AAPnB,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,6HAAA,gCAAgC,OAAA;AAChC,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AAGb,iCAMiB;AALf,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,gHAAA,uBAAuB,OAAA;AACvB,sHAAA,6BAA6B,OAAA;AAC7B,2GAAA,kBAAkB,OAAA;AAGpB,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,2CAesB;AAdpB,kHAAA,oBAAoB,OAAA;AACpB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,gHAAA,kBAAkB,OAAA;AAClB,qHAAA,uBAAuB,OAAA;AACvB,wHAAA,0BAA0B,OAAA;AAC1B,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,oHAAA,sBAAsB,OAAA;AACtB,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,uHAAA,yBAAyB,OAAA;AACzB,kGAAA,IAAI,OAAA;AAUN,mDAI0B;AAHxB,gHAAA,cAAc,OAAA;AACd,+HAAA,6BAA6B,OAAA;AAC7B,qHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,0EAA0E;AAC1E,+CAQ+B;AAP7B,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AACjB,iGAAA,QAAQ,OAAA;AACR,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AAGZ,yCAA+E;AAAtE,8GAAA,iBAAiB,OAAA;AAAE,0HAAA,6BAA6B,OAAA;AAEzD,yCAQqB;AAPnB,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,6HAAA,gCAAgC,OAAA;AAChC,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AAGb,iCAMiB;AALf,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,gHAAA,uBAAuB,OAAA;AACvB,sHAAA,6BAA6B,OAAA;AAC7B,2GAAA,kBAAkB,OAAA;AAGpB,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,2CAgBsB;AAfpB,kHAAA,oBAAoB,OAAA;AACpB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,gHAAA,kBAAkB,OAAA;AAClB,qHAAA,uBAAuB,OAAA;AACvB,wHAAA,0BAA0B,OAAA;AAC1B,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,oHAAA,sBAAsB,OAAA;AACtB,mHAAA,qBAAqB,OAAA;AACrB,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,uHAAA,yBAAyB,OAAA;AACzB,kGAAA,IAAI,OAAA;AAYN,mDAI0B;AAHxB,gHAAA,cAAc,OAAA;AACd,+HAAA,6BAA6B,OAAA;AAC7B,qHAAA,mBAAmB,OAAA"}

package/dist/operations.d.ts

@@ -113,33 +113,94 @@ export interface ProofCommitEvent {
     onChainCommit: OnChainCommit;
 }
 /**
- * Fetch all `VrfProofCommitted` events emitted for a given `(owner, label,
- * memo)` tuple, ordered oldest → newest. Returns an empty array if none
- * exist.
+ * Options for {@link findProofCommitEvents} and {@link fetchProofCommitEvents}.
+ */
+export interface ProofCommitEventQuery {
+    /**
+     * Look up exactly this transaction signature instead of scanning the owner's
+     * wallet history. This is the ROBUST path: a committer already knows the
+     * signature it submitted, so it sidesteps the history-scan failure mode
+     * entirely (see {@link ProofCommitEventResult.truncated}). When set, `limit`
+     * is ignored.
+     */
+    signature?: string;
+    /**
+     * Max number of recent signatures to scan when walking the owner's wallet
+     * history (default 1000). Only used when `signature` is not provided.
+     *
+     * NOTE: this counts ALL of the owner's transactions, not just VRF commits —
+     * on a busy mainnet wallet the target commit can fall outside the window, in
+     * which case the result is flagged `truncated` rather than silently returning
+     * an empty list.
+     */
+    limit?: number;
+}
+/**
+ * Result of {@link findProofCommitEvents}. Unlike a bare event array, this lets
+ * a caller distinguish "this memo was never committed" from "I could not
+ * confirm it within the scanned window / some transactions were unfetchable".
+ */
+export interface ProofCommitEventResult {
+    /** Matching events, ordered oldest → newest. */
+    events: ProofCommitEvent[];
+    /**
+     * True if the wallet-history scan hit `limit` before reaching the end of the
+     * owner's history. When true, an empty or short `events` list is NOT
+     * conclusive — the commit may simply be older than the scanned window.
+     * Re-query with a larger `limit`, or (preferably) pass the known `signature`.
+     * Always false when `signature` was provided.
+     */
+    truncated: boolean;
+    /**
+     * Signatures whose transaction could not be fetched (RPC retention gap or
+     * throttling — `getTransaction` returned null or threw). A genuine event may
+     * be hiding in one of these, so an empty `events` list is likewise
+     * inconclusive when this is non-empty.
+     */
+    unfetchedSignatures: string[];
+}
+/**
+ * Find `VrfProofCommitted` events for a `(owner, label, memo)` tuple, returning
+ * a structured result that surfaces scan completeness.
+ *
+ * Two modes:
+ *   - Pass `query.signature` to fetch ONE known transaction directly. This is
+ *     the recommended path for any caller that submitted the commit (it already
+ *     has the signature) and is immune to the history-scan limit below.
+ *   - Otherwise the owner's wallet history is paginated (newest → oldest) up to
+ *     `query.limit` signatures (default 1000). Because this counts every
+ *     transaction the owner signed — not just VRF commits — a busy mainnet
+ *     wallet can push the target commit past the window; that case is reported
+ *     via `truncated: true` instead of an indistinguishable empty array.
  *
- * IMPORTANT: this can return MORE than one row. The on-chain program does
- * not enforce uniqueness in event mode. A safe verifier:
+ * IMPORTANT: this can return MORE than one event. The on-chain program does not
+ * enforce uniqueness in event mode. A safe verifier:
  *
  *   1. Collects all matches for the requested memo.
  *   2. Runs `verifyAuthorityCommitEndToEnd` against each candidate proof.
  *   3. Accepts the unique row where the ECVRF math passes.
  *
- * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most
- * one of the candidates can have a valid `proof_hash`. The presence of extra
- * events is detectable noise, not a successful forgery — but a naive verifier
- * that picks "the latest event" without running ECVRF can be misled, which is
- * the only soundness gap relative to the PDA path.
+ * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most one
+ * candidate can have a valid `proof_hash`. The presence of extra events is
+ * detectable noise, not a successful forgery — but a naive verifier that picks
+ * "the latest event" without running ECVRF can be misled (see
+ * `pickCanonicalCommit`).
  *
  * `connection` and `programId` are passed in explicitly so log scanning works
- * against a plain Solana RPC. Fetching compressed authority state still needs
- * a Photon-capable RPC unless the verifier already has that state.
+ * against a plain Solana RPC. Fetching compressed authority state still needs a
+ * Photon-capable RPC unless the verifier already has that state.
+ */
+export declare function findProofCommitEvents(program: Program, connection: Connection, owner: PublicKey, label: string | Uint8Array, memo: string | Uint8Array, query?: ProofCommitEventQuery): Promise<ProofCommitEventResult>;
+/**
+ * Backward-compatible wrapper around {@link findProofCommitEvents} that returns
+ * just the events (oldest → newest).
  *
- * `limit` caps how many recent signatures to scan (default 1000); pagination
- * happens automatically via `getSignaturesForAddress`'s `before` cursor.
+ * Prefer {@link findProofCommitEvents} when you need to tell "not committed"
+ * apart from "scan was truncated / some transactions were unfetchable" — on a
+ * busy mainnet wallet a bare empty array is ambiguous. Pass `options.signature`
+ * to look up a known commit directly and skip the history scan entirely.
  */
-export declare function fetchProofCommitEvents(program: Program, connection: Connection, owner: PublicKey, label: string | Uint8Array, memo: string | Uint8Array, options?: {
-    limit?: number;
-}): Promise<ProofCommitEvent[]>;
+export declare function fetchProofCommitEvents(program: Program, connection: Connection, owner: PublicKey, label: string | Uint8Array, memo: string | Uint8Array, options?: ProofCommitEventQuery): Promise<ProofCommitEvent[]>;
 /**
  * Build the commit_proof_with_beta instruction (PDA mode + on-chain beta).
  * Like buildCommitProofIx, but additionally stores the 64-byte ECVRF beta

package/dist/operations.d.ts.map

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

package/dist/operations.js

@@ -43,6 +43,7 @@ exports.buildFreezeAuthorityIx = buildFreezeAuthorityIx;
 exports.buildRevokeAuthorityIx = buildRevokeAuthorityIx;
 exports.buildCommitProofIx = buildCommitProofIx;
 exports.buildCommitProofEventIx = buildCommitProofEventIx;
+exports.findProofCommitEvents = findProofCommitEvents;
 exports.fetchProofCommitEvents = fetchProofCommitEvents;
 exports.buildCommitProofWithBetaIx = buildCommitProofWithBetaIx;
 exports.fetchProofCommitWithBeta = fetchProofCommitWithBeta;
@@ -252,91 +253,145 @@ async function buildCommitProofEventIx(program, rpc, input) {
     return ix;
 }
 /**
- * Fetch all `VrfProofCommitted` events emitted for a given `(owner, label,
- * memo)` tuple, ordered oldest → newest. Returns an empty array if none
- * exist.
+ * Find `VrfProofCommitted` events for a `(owner, label, memo)` tuple, returning
+ * a structured result that surfaces scan completeness.
  *
- * IMPORTANT: this can return MORE than one row. The on-chain program does
- * not enforce uniqueness in event mode. A safe verifier:
+ * Two modes:
+ *   - Pass `query.signature` to fetch ONE known transaction directly. This is
+ *     the recommended path for any caller that submitted the commit (it already
+ *     has the signature) and is immune to the history-scan limit below.
+ *   - Otherwise the owner's wallet history is paginated (newest → oldest) up to
+ *     `query.limit` signatures (default 1000). Because this counts every
+ *     transaction the owner signed — not just VRF commits — a busy mainnet
+ *     wallet can push the target commit past the window; that case is reported
+ *     via `truncated: true` instead of an indistinguishable empty array.
+ *
+ * IMPORTANT: this can return MORE than one event. The on-chain program does not
+ * enforce uniqueness in event mode. A safe verifier:
  *
  *   1. Collects all matches for the requested memo.
  *   2. Runs `verifyAuthorityCommitEndToEnd` against each candidate proof.
  *   3. Accepts the unique row where the ECVRF math passes.
  *
- * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most
- * one of the candidates can have a valid `proof_hash`. The presence of extra
- * events is detectable noise, not a successful forgery — but a naive verifier
- * that picks "the latest event" without running ECVRF can be misled, which is
- * the only soundness gap relative to the PDA path.
+ * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most one
+ * candidate can have a valid `proof_hash`. The presence of extra events is
+ * detectable noise, not a successful forgery — but a naive verifier that picks
+ * "the latest event" without running ECVRF can be misled (see
+ * `pickCanonicalCommit`).
  *
  * `connection` and `programId` are passed in explicitly so log scanning works
- * against a plain Solana RPC. Fetching compressed authority state still needs
- * a Photon-capable RPC unless the verifier already has that state.
- *
- * `limit` caps how many recent signatures to scan (default 1000); pagination
- * happens automatically via `getSignaturesForAddress`'s `before` cursor.
+ * against a plain Solana RPC. Fetching compressed authority state still needs a
+ * Photon-capable RPC unless the verifier already has that state.
  */
-async function fetchProofCommitEvents(program, connection, owner, label, memo, options = {}) {
+async function findProofCommitEvents(program, connection, owner, label, memo, query = {}) {
     const labelBytes = typeof label === "string" ? (0, addresses_1.encodeLabel)(label) : label;
     const targetMemoHash = (0, addresses_1.memoHash)(memo);
     const parser = new anchor_1.EventParser(program.programId, new anchor_1.BorshCoder(program.idl));
     const out = [];
-    const limit = options.limit ?? 1000;
+    const unfetchedSignatures = [];
+    // Fetch a single tx, treating RPC failure (retention gap / throttling returns
+    // null or throws) as a recoverable miss rather than crashing the scan.
+    const tryGetTx = async (signature) => {
+        try {
+            return await connection.getTransaction(signature, {
+                commitment: "confirmed",
+                maxSupportedTransactionVersion: 0,
+            });
+        }
+        catch {
+            return null;
+        }
+    };
+    // Extract any matching VrfProofCommitted events from one fetched tx.
+    const collectFromTx = (signature, tx) => {
+        if (!tx?.meta?.logMessages)
+            return;
+        for (const ev of parser.parseLogs(tx.meta.logMessages, false)) {
+            if (ev.name !== "VrfProofCommitted" && ev.name !== "vrfProofCommitted")
+                continue;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = ev.data;
+            const eventOwner = data.owner;
+            const eventLabel = Uint8Array.from(data.label);
+            const eventMemoHash = Uint8Array.from(data.memoHash);
+            if (!eventOwner.equals(owner))
+                continue;
+            if (!bytesEqual(eventLabel, labelBytes))
+                continue;
+            if (!bytesEqual(eventMemoHash, targetMemoHash))
+                continue;
+            const authority = (0, addresses_1.deriveAuthorityAddress)(eventOwner, eventLabel, program.programId);
+            out.push({
+                owner: eventOwner,
+                label: eventLabel,
+                txSignature: signature,
+                slot: tx.slot,
+                onChainCommit: {
+                    authority,
+                    memoHash: eventMemoHash,
+                    proofHash: Uint8Array.from(data.proofHash),
+                    alphaHash: Uint8Array.from(data.alphaHash),
+                    committedSlot: BigInt(data.committedSlot.toString()),
+                },
+            });
+        }
+    };
+    // Direct-by-signature mode: robust, no history scan, never truncated.
+    if (query.signature) {
+        const tx = await tryGetTx(query.signature);
+        if (!tx)
+            unfetchedSignatures.push(query.signature);
+        else
+            collectFromTx(query.signature, tx);
+        out.reverse();
+        return { events: out, truncated: false, unfetchedSignatures };
+    }
+    // History-scan mode.
+    const limit = query.limit ?? 1000;
     let before;
     let scanned = 0;
+    let reachedEnd = false;
     while (scanned < limit) {
         const pageLimit = Math.min(1000, limit - scanned);
         const sigInfos = await connection.getSignaturesForAddress(owner, {
             limit: pageLimit,
             before,
         });
-        if (sigInfos.length === 0)
+        if (sigInfos.length === 0) {
+            reachedEnd = true;
             break;
+        }
         scanned += sigInfos.length;
         before = sigInfos[sigInfos.length - 1].signature;
         for (const sigInfo of sigInfos) {
             if (sigInfo.err)
                 continue;
-            const tx = await connection.getTransaction(sigInfo.signature, {
-                commitment: "confirmed",
-                maxSupportedTransactionVersion: 0,
-            });
-            if (!tx?.meta?.logMessages)
+            const tx = await tryGetTx(sigInfo.signature);
+            if (!tx) {
+                unfetchedSignatures.push(sigInfo.signature);
                 continue;
-            for (const ev of parser.parseLogs(tx.meta.logMessages, false)) {
-                if (ev.name !== "VrfProofCommitted" && ev.name !== "vrfProofCommitted")
-                    continue;
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const data = ev.data;
-                const eventOwner = data.owner;
-                const eventLabel = Uint8Array.from(data.label);
-                const eventMemoHash = Uint8Array.from(data.memoHash);
-                if (!eventOwner.equals(owner))
-                    continue;
-                if (!bytesEqual(eventLabel, labelBytes))
-                    continue;
-                if (!bytesEqual(eventMemoHash, targetMemoHash))
-                    continue;
-                const authority = (0, addresses_1.deriveAuthorityAddress)(eventOwner, eventLabel, program.programId);
-                out.push({
-                    owner: eventOwner,
-                    label: eventLabel,
-                    txSignature: sigInfo.signature,
-                    slot: tx.slot,
-                    onChainCommit: {
-                        authority,
-                        memoHash: eventMemoHash,
-                        proofHash: Uint8Array.from(data.proofHash),
-                        alphaHash: Uint8Array.from(data.alphaHash),
-                        committedSlot: BigInt(data.committedSlot.toString()),
-                    },
-                });
             }
+            collectFromTx(sigInfo.signature, tx);
         }
     }
     // RPC returns newest first — reverse so oldest comes first.
     out.reverse();
-    return out;
+    // If we exited because the cap was hit (not because history ran out), the
+    // result is incomplete: a missing event here is inconclusive, not "absent".
+    return { events: out, truncated: !reachedEnd, unfetchedSignatures };
+}
+/**
+ * Backward-compatible wrapper around {@link findProofCommitEvents} that returns
+ * just the events (oldest → newest).
+ *
+ * Prefer {@link findProofCommitEvents} when you need to tell "not committed"
+ * apart from "scan was truncated / some transactions were unfetchable" — on a
+ * busy mainnet wallet a bare empty array is ambiguous. Pass `options.signature`
+ * to look up a known commit directly and skip the history scan entirely.
+ */
+async function fetchProofCommitEvents(program, connection, owner, label, memo, options = {}) {
+    const { events } = await findProofCommitEvents(program, connection, owner, label, memo, options);
+    return events;
 }
 function bytesEqual(a, b) {
     if (a.length !== b.length)

package/dist/operations.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@collectorcrypt/vrf-client",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "TypeScript SDK for the cc-vrf on-chain VRF program (Solana + Light Protocol)",
   "license": "MIT",
   "main": "dist/index.js",

package/src/index.ts

@@ -50,6 +50,7 @@ export {
   fetchProofCommit,
   fetchProofCommitWithBeta,
   fetchProofCommitEvents,
+  findProofCommitEvents,
   decodeAuthority,
   decodeProofCommit,
   decodeProofCommitWithBeta,
@@ -61,6 +62,8 @@ export type {
   FreezeAuthorityInput,
   CommitProofInput,
   ProofCommitEvent,
+  ProofCommitEventQuery,
+  ProofCommitEventResult,
 } from "./operations";
 
 export {

package/src/operations.ts

@@ -427,38 +427,93 @@ export interface ProofCommitEvent {
 }
 
 /**
- * Fetch all `VrfProofCommitted` events emitted for a given `(owner, label,
- * memo)` tuple, ordered oldest → newest. Returns an empty array if none
- * exist.
+ * Options for {@link findProofCommitEvents} and {@link fetchProofCommitEvents}.
+ */
+export interface ProofCommitEventQuery {
+  /**
+   * Look up exactly this transaction signature instead of scanning the owner's
+   * wallet history. This is the ROBUST path: a committer already knows the
+   * signature it submitted, so it sidesteps the history-scan failure mode
+   * entirely (see {@link ProofCommitEventResult.truncated}). When set, `limit`
+   * is ignored.
+   */
+  signature?: string;
+  /**
+   * Max number of recent signatures to scan when walking the owner's wallet
+   * history (default 1000). Only used when `signature` is not provided.
+   *
+   * NOTE: this counts ALL of the owner's transactions, not just VRF commits —
+   * on a busy mainnet wallet the target commit can fall outside the window, in
+   * which case the result is flagged `truncated` rather than silently returning
+   * an empty list.
+   */
+  limit?: number;
+}
+
+/**
+ * Result of {@link findProofCommitEvents}. Unlike a bare event array, this lets
+ * a caller distinguish "this memo was never committed" from "I could not
+ * confirm it within the scanned window / some transactions were unfetchable".
+ */
+export interface ProofCommitEventResult {
+  /** Matching events, ordered oldest → newest. */
+  events: ProofCommitEvent[];
+  /**
+   * True if the wallet-history scan hit `limit` before reaching the end of the
+   * owner's history. When true, an empty or short `events` list is NOT
+   * conclusive — the commit may simply be older than the scanned window.
+   * Re-query with a larger `limit`, or (preferably) pass the known `signature`.
+   * Always false when `signature` was provided.
+   */
+  truncated: boolean;
+  /**
+   * Signatures whose transaction could not be fetched (RPC retention gap or
+   * throttling — `getTransaction` returned null or threw). A genuine event may
+   * be hiding in one of these, so an empty `events` list is likewise
+   * inconclusive when this is non-empty.
+   */
+  unfetchedSignatures: string[];
+}
+
+/**
+ * Find `VrfProofCommitted` events for a `(owner, label, memo)` tuple, returning
+ * a structured result that surfaces scan completeness.
+ *
+ * Two modes:
+ *   - Pass `query.signature` to fetch ONE known transaction directly. This is
+ *     the recommended path for any caller that submitted the commit (it already
+ *     has the signature) and is immune to the history-scan limit below.
+ *   - Otherwise the owner's wallet history is paginated (newest → oldest) up to
+ *     `query.limit` signatures (default 1000). Because this counts every
+ *     transaction the owner signed — not just VRF commits — a busy mainnet
+ *     wallet can push the target commit past the window; that case is reported
+ *     via `truncated: true` instead of an indistinguishable empty array.
  *
- * IMPORTANT: this can return MORE than one row. The on-chain program does
- * not enforce uniqueness in event mode. A safe verifier:
+ * IMPORTANT: this can return MORE than one event. The on-chain program does not
+ * enforce uniqueness in event mode. A safe verifier:
  *
  *   1. Collects all matches for the requested memo.
  *   2. Runs `verifyAuthorityCommitEndToEnd` against each candidate proof.
  *   3. Accepts the unique row where the ECVRF math passes.
  *
- * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most
- * one of the candidates can have a valid `proof_hash`. The presence of extra
- * events is detectable noise, not a successful forgery — but a naive verifier
- * that picks "the latest event" without running ECVRF can be misled, which is
- * the only soundness gap relative to the PDA path.
+ * Because ECVRF proofs are deterministic for a fixed (pk, alpha), at most one
+ * candidate can have a valid `proof_hash`. The presence of extra events is
+ * detectable noise, not a successful forgery — but a naive verifier that picks
+ * "the latest event" without running ECVRF can be misled (see
+ * `pickCanonicalCommit`).
  *
  * `connection` and `programId` are passed in explicitly so log scanning works
- * against a plain Solana RPC. Fetching compressed authority state still needs
- * a Photon-capable RPC unless the verifier already has that state.
- *
- * `limit` caps how many recent signatures to scan (default 1000); pagination
- * happens automatically via `getSignaturesForAddress`'s `before` cursor.
+ * against a plain Solana RPC. Fetching compressed authority state still needs a
+ * Photon-capable RPC unless the verifier already has that state.
  */
-export async function fetchProofCommitEvents(
+export async function findProofCommitEvents(
   program: Program,
   connection: Connection,
   owner: PublicKey,
   label: string | Uint8Array,
   memo: string | Uint8Array,
-  options: { limit?: number } = {},
-): Promise<ProofCommitEvent[]> {
+  query: ProofCommitEventQuery = {},
+): Promise<ProofCommitEventResult> {
   const labelBytes = typeof label === "string" ? encodeLabel(label) : label;
   const targetMemoHash = memoHashFn(memo);
 
@@ -467,66 +522,132 @@ export async function fetchProofCommitEvents(
     new BorshCoder(program.idl),
   );
   const out: ProofCommitEvent[] = [];
+  const unfetchedSignatures: string[] = [];
+
+  // Fetch a single tx, treating RPC failure (retention gap / throttling returns
+  // null or throws) as a recoverable miss rather than crashing the scan.
+  const tryGetTx = async (signature: string) => {
+    try {
+      return await connection.getTransaction(signature, {
+        commitment: "confirmed",
+        maxSupportedTransactionVersion: 0,
+      });
+    } catch {
+      return null;
+    }
+  };
+
+  // Extract any matching VrfProofCommitted events from one fetched tx.
+  const collectFromTx = (
+    signature: string,
+    tx: Awaited<ReturnType<typeof tryGetTx>>,
+  ) => {
+    if (!tx?.meta?.logMessages) return;
+    for (const ev of parser.parseLogs(tx.meta.logMessages, false)) {
+      if (ev.name !== "VrfProofCommitted" && ev.name !== "vrfProofCommitted")
+        continue;
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const data = ev.data as any;
+      const eventOwner: PublicKey = data.owner;
+      const eventLabel: Uint8Array = Uint8Array.from(data.label);
+      const eventMemoHash: Uint8Array = Uint8Array.from(data.memoHash);
+
+      if (!eventOwner.equals(owner)) continue;
+      if (!bytesEqual(eventLabel, labelBytes)) continue;
+      if (!bytesEqual(eventMemoHash, targetMemoHash)) continue;
+
+      const authority = deriveAuthorityAddress(
+        eventOwner,
+        eventLabel,
+        program.programId,
+      );
+      out.push({
+        owner: eventOwner,
+        label: eventLabel,
+        txSignature: signature,
+        slot: tx.slot,
+        onChainCommit: {
+          authority,
+          memoHash: eventMemoHash,
+          proofHash: Uint8Array.from(data.proofHash),
+          alphaHash: Uint8Array.from(data.alphaHash),
+          committedSlot: BigInt(data.committedSlot.toString()),
+        },
+      });
+    }
+  };
 
-  const limit = options.limit ?? 1000;
+  // Direct-by-signature mode: robust, no history scan, never truncated.
+  if (query.signature) {
+    const tx = await tryGetTx(query.signature);
+    if (!tx) unfetchedSignatures.push(query.signature);
+    else collectFromTx(query.signature, tx);
+    out.reverse();
+    return { events: out, truncated: false, unfetchedSignatures };
+  }
+
+  // History-scan mode.
+  const limit = query.limit ?? 1000;
   let before: string | undefined;
   let scanned = 0;
+  let reachedEnd = false;
   while (scanned < limit) {
     const pageLimit = Math.min(1000, limit - scanned);
     const sigInfos = await connection.getSignaturesForAddress(owner, {
       limit: pageLimit,
       before,
     });
-    if (sigInfos.length === 0) break;
+    if (sigInfos.length === 0) {
+      reachedEnd = true;
+      break;
+    }
     scanned += sigInfos.length;
     before = sigInfos[sigInfos.length - 1].signature;
 
     for (const sigInfo of sigInfos) {
       if (sigInfo.err) continue;
-      const tx = await connection.getTransaction(sigInfo.signature, {
-        commitment: "confirmed",
-        maxSupportedTransactionVersion: 0,
-      });
-      if (!tx?.meta?.logMessages) continue;
-
-      for (const ev of parser.parseLogs(tx.meta.logMessages, false)) {
-        if (ev.name !== "VrfProofCommitted" && ev.name !== "vrfProofCommitted")
-          continue;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const data = ev.data as any;
-        const eventOwner: PublicKey = data.owner;
-        const eventLabel: Uint8Array = Uint8Array.from(data.label);
-        const eventMemoHash: Uint8Array = Uint8Array.from(data.memoHash);
-
-        if (!eventOwner.equals(owner)) continue;
-        if (!bytesEqual(eventLabel, labelBytes)) continue;
-        if (!bytesEqual(eventMemoHash, targetMemoHash)) continue;
-
-        const authority = deriveAuthorityAddress(
-          eventOwner,
-          eventLabel,
-          program.programId,
-        );
-        out.push({
-          owner: eventOwner,
-          label: eventLabel,
-          txSignature: sigInfo.signature,
-          slot: tx.slot,
-          onChainCommit: {
-            authority,
-            memoHash: eventMemoHash,
-            proofHash: Uint8Array.from(data.proofHash),
-            alphaHash: Uint8Array.from(data.alphaHash),
-            committedSlot: BigInt(data.committedSlot.toString()),
-          },
-        });
+      const tx = await tryGetTx(sigInfo.signature);
+      if (!tx) {
+        unfetchedSignatures.push(sigInfo.signature);
+        continue;
       }
+      collectFromTx(sigInfo.signature, tx);
     }
   }
 
   // RPC returns newest first — reverse so oldest comes first.
   out.reverse();
-  return out;
+  // If we exited because the cap was hit (not because history ran out), the
+  // result is incomplete: a missing event here is inconclusive, not "absent".
+  return { events: out, truncated: !reachedEnd, unfetchedSignatures };
+}
+
+/**
+ * Backward-compatible wrapper around {@link findProofCommitEvents} that returns
+ * just the events (oldest → newest).
+ *
+ * Prefer {@link findProofCommitEvents} when you need to tell "not committed"
+ * apart from "scan was truncated / some transactions were unfetchable" — on a
+ * busy mainnet wallet a bare empty array is ambiguous. Pass `options.signature`
+ * to look up a known commit directly and skip the history scan entirely.
+ */
+export async function fetchProofCommitEvents(
+  program: Program,
+  connection: Connection,
+  owner: PublicKey,
+  label: string | Uint8Array,
+  memo: string | Uint8Array,
+  options: ProofCommitEventQuery = {},
+): Promise<ProofCommitEvent[]> {
+  const { events } = await findProofCommitEvents(
+    program,
+    connection,
+    owner,
+    label,
+    memo,
+    options,
+  );
+  return events;
 }
 
 function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {