@collectorcrypt/vrf-client 0.1.0

package/dist/addresses.d.ts

@@ -0,0 +1,34 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Derive the compressed-PDA address of a VrfAuthority. This is the address
+ * the Light state Merkle tree indexes — NOT a Solana account address.
+ *
+ * Seeds: ["vrf_authority", owner_pubkey, label_bytes]
+ */
+export declare function deriveAuthorityAddress(owner: PublicKey, label: Uint8Array, programId: PublicKey): PublicKey;
+/**
+ * Derive the compressed-PDA address of a VrfProofCommit.
+ *
+ * Seeds: ["vrf_proof", authority_pubkey, memo_hash]
+ */
+export declare function deriveProofCommitAddress(authority: PublicKey, memoHash: Uint8Array, programId: PublicKey): PublicKey;
+/**
+ * Derive the compressed-PDA address of a VrfProofCommitWithBeta. Uses a
+ * same seed prefix as regular VrfProofCommit records. This makes registry
+ * mode and registry+beta mutually exclusive for a given (authority, memo).
+ *
+ * Seeds: ["vrf_proof", authority_pubkey, memo_hash]
+ */
+export declare function deriveProofCommitWithBetaAddress(authority: PublicKey, memoHash: Uint8Array, programId: PublicKey): PublicKey;
+/** Convenience: SHA-256 a UTF-8 memo string. */
+export declare function memoHash(memo: string | Uint8Array): Uint8Array;
+/** Convenience: SHA-256 the alpha bytes. */
+export declare function alphaHash(alpha: Uint8Array): Uint8Array;
+/** Convenience: SHA-256 the proof bytes. */
+export declare function proofHash(proof: Uint8Array): Uint8Array;
+/**
+ * Pad a short utf-8 label to 32 bytes (right-padded with zeroes). Useful for
+ * human-readable labels like "gacha" or "lottery".
+ */
+export declare function encodeLabel(label: string): Uint8Array;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../src/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,GACnB,SAAS,CAMX;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,SAAS,GACnB,SAAS,CAUX;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,SAAS,GACnB,SAAS,CAUX;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAI9D;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEvD;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQrD"}

package/dist/addresses.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveAuthorityAddress = deriveAuthorityAddress;
+exports.deriveProofCommitAddress = deriveProofCommitAddress;
+exports.deriveProofCommitWithBetaAddress = deriveProofCommitWithBetaAddress;
+exports.memoHash = memoHash;
+exports.alphaHash = alphaHash;
+exports.proofHash = proofHash;
+exports.encodeLabel = encodeLabel;
+const web3_js_1 = require("@solana/web3.js");
+const stateless_js_1 = require("@lightprotocol/stateless.js");
+const sha2_js_1 = require("@noble/hashes/sha2.js");
+const constants_1 = require("./constants");
+/**
+ * Derive the compressed-PDA address of a VrfAuthority. This is the address
+ * the Light state Merkle tree indexes — NOT a Solana account address.
+ *
+ * Seeds: ["vrf_authority", owner_pubkey, label_bytes]
+ */
+function deriveAuthorityAddress(owner, label, programId) {
+    if (label.length !== 32) {
+        throw new Error("label must be exactly 32 bytes");
+    }
+    const seed = (0, stateless_js_1.deriveAddressSeedV2)([constants_1.AUTHORITY_SEED, owner.toBytes(), label]);
+    return (0, stateless_js_1.deriveAddressV2)(seed, new web3_js_1.PublicKey(stateless_js_1.batchAddressTree), programId);
+}
+/**
+ * Derive the compressed-PDA address of a VrfProofCommit.
+ *
+ * Seeds: ["vrf_proof", authority_pubkey, memo_hash]
+ */
+function deriveProofCommitAddress(authority, memoHash, programId) {
+    if (memoHash.length !== 32) {
+        throw new Error("memoHash must be exactly 32 bytes");
+    }
+    const seed = (0, stateless_js_1.deriveAddressSeedV2)([
+        constants_1.PROOF_COMMIT_SEED,
+        authority.toBytes(),
+        memoHash,
+    ]);
+    return (0, stateless_js_1.deriveAddressV2)(seed, new web3_js_1.PublicKey(stateless_js_1.batchAddressTree), programId);
+}
+/**
+ * Derive the compressed-PDA address of a VrfProofCommitWithBeta. Uses a
+ * same seed prefix as regular VrfProofCommit records. This makes registry
+ * mode and registry+beta mutually exclusive for a given (authority, memo).
+ *
+ * Seeds: ["vrf_proof", authority_pubkey, memo_hash]
+ */
+function deriveProofCommitWithBetaAddress(authority, memoHash, programId) {
+    if (memoHash.length !== 32) {
+        throw new Error("memoHash must be exactly 32 bytes");
+    }
+    const seed = (0, stateless_js_1.deriveAddressSeedV2)([
+        constants_1.PROOF_COMMIT_WITH_BETA_SEED,
+        authority.toBytes(),
+        memoHash,
+    ]);
+    return (0, stateless_js_1.deriveAddressV2)(seed, new web3_js_1.PublicKey(stateless_js_1.batchAddressTree), programId);
+}
+/** Convenience: SHA-256 a UTF-8 memo string. */
+function memoHash(memo) {
+    const input = typeof memo === "string" ? new TextEncoder().encode(memo) : memo;
+    return (0, sha2_js_1.sha256)(input);
+}
+/** Convenience: SHA-256 the alpha bytes. */
+function alphaHash(alpha) {
+    return (0, sha2_js_1.sha256)(alpha);
+}
+/** Convenience: SHA-256 the proof bytes. */
+function proofHash(proof) {
+    return (0, sha2_js_1.sha256)(proof);
+}
+/**
+ * Pad a short utf-8 label to 32 bytes (right-padded with zeroes). Useful for
+ * human-readable labels like "gacha" or "lottery".
+ */
+function encodeLabel(label) {
+    const bytes = new TextEncoder().encode(label);
+    if (bytes.length > 32) {
+        throw new Error(`label "${label}" exceeds 32 bytes encoded`);
+    }
+    const padded = new Uint8Array(32);
+    padded.set(bytes, 0);
+    return padded;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../src/addresses.ts"],"names":[],"mappings":";;AAmBA,wDAUC;AAOD,4DAcC;AASD,4EAcC;AAGD,4BAIC;AAGD,8BAEC;AAGD,8BAEC;AAMD,kCAQC;AAxGD,6CAA4C;AAC5C,8DAIqC;AACrC,mDAA+C;AAC/C,2CAIqB;AAErB;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,KAAgB,EAChB,KAAiB,EACjB,SAAoB;IAEpB,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,GAAG,IAAA,kCAAmB,EAAC,CAAC,0BAAc,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAA,8BAAe,EAAC,IAAI,EAAE,IAAI,mBAAS,CAAC,+BAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CACtC,SAAoB,EACpB,QAAoB,EACpB,SAAoB;IAEpB,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,IAAA,kCAAmB,EAAC;QAC/B,6BAAiB;QACjB,SAAS,CAAC,OAAO,EAAE;QACnB,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,IAAA,8BAAe,EAAC,IAAI,EAAE,IAAI,mBAAS,CAAC,+BAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gCAAgC,CAC9C,SAAoB,EACpB,QAAoB,EACpB,SAAoB;IAEpB,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,IAAA,kCAAmB,EAAC;QAC/B,uCAA2B;QAC3B,SAAS,CAAC,OAAO,EAAE;QACnB,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,IAAA,8BAAe,EAAC,IAAI,EAAE,IAAI,mBAAS,CAAC,+BAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,gDAAgD;AAChD,SAAgB,QAAQ,CAAC,IAAyB;IAChD,MAAM,KAAK,GACT,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,4CAA4C;AAC5C,SAAgB,SAAS,CAAC,KAAiB;IACzC,OAAO,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,4CAA4C;AAC5C,SAAgB,SAAS,CAAC,KAAiB;IACzC,OAAO,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,4BAA4B,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,12 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Default mainnet program ID (renounced upgrade authority post-deploy).
+ * Override via `new VrfClient({ programId })` for devnet/local testing.
+ */
+export declare const CC_VRF_PROGRAM_ID: PublicKey;
+export declare const AUTHORITY_SEED: NodeJS.NonSharedUint8Array;
+export declare const PROOF_COMMIT_SEED: NodeJS.NonSharedUint8Array;
+export declare const PROOF_COMMIT_WITH_BETA_SEED: NodeJS.NonSharedUint8Array;
+/** RFC 9381 §7.5 IANA suite identifier. */
+export declare const SUITE_EDWARDS25519_SHA512_TAI = 3;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAE7B,CAAC;AAEF,eAAO,MAAM,cAAc,4BAA4C,CAAC;AACxE,eAAO,MAAM,iBAAiB,4BAAwC,CAAC;AACvE,eAAO,MAAM,2BAA2B,4BAAoB,CAAC;AAE7D,2CAA2C;AAC3C,eAAO,MAAM,6BAA6B,IAAO,CAAC"}

package/dist/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUITE_EDWARDS25519_SHA512_TAI = exports.PROOF_COMMIT_WITH_BETA_SEED = exports.PROOF_COMMIT_SEED = exports.AUTHORITY_SEED = exports.CC_VRF_PROGRAM_ID = void 0;
+const web3_js_1 = require("@solana/web3.js");
+/**
+ * Default mainnet program ID (renounced upgrade authority post-deploy).
+ * Override via `new VrfClient({ programId })` for devnet/local testing.
+ */
+exports.CC_VRF_PROGRAM_ID = new web3_js_1.PublicKey("ccvrfu3fSpbnPLiUqdWAt85Zn9nq96ekwGTbHqGtdgQ");
+exports.AUTHORITY_SEED = new TextEncoder().encode("vrf_authority");
+exports.PROOF_COMMIT_SEED = new TextEncoder().encode("vrf_proof");
+exports.PROOF_COMMIT_WITH_BETA_SEED = exports.PROOF_COMMIT_SEED;
+/** RFC 9381 §7.5 IANA suite identifier. */
+exports.SUITE_EDWARDS25519_SHA512_TAI = 0x03;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAE5C;;;GAGG;AACU,QAAA,iBAAiB,GAAG,IAAI,mBAAS,CAC5C,6CAA6C,CAC9C,CAAC;AAEW,QAAA,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAC3D,QAAA,iBAAiB,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC1D,QAAA,2BAA2B,GAAG,yBAAiB,CAAC;AAE7D,2CAA2C;AAC9B,QAAA,6BAA6B,GAAG,IAAI,CAAC"}