@vercora-protocol/sdk 0.2.2 → 0.2.4

package/dist/resolverDecode.d.ts

@@ -0,0 +1,70 @@
+import type { Program } from '@coral-xyz/anchor';
+import BN from 'bn.js';
+import { PublicKey } from '@solana/web3.js';
+/** Accepts any Anchor `Program` shape (e.g. `Program<Vercora>`) without fighting IDL generics. */
+type AnyProgram = Program<any>;
+/**
+ * Anchor `accounts[].discriminator` for `Resolver` from the loaded IDL.
+ * Used to tell "wrong account type at this PDA" from "layout decode failed".
+ */
+export declare function resolverDiscriminatorFromIdl(program: AnyProgram): Buffer | null;
+/**
+ * Read `resolver_pubkey` from raw account bytes.
+ *
+ * Matches on-chain layout (`programs/vercora/src/state/resolver.rs`):
+ * PDA seeds `[market, b"resolver", resolver_index]` (see `initialize_market_resolver`).
+ *
+ * Decode strategy (in order):
+ * 1) Try `coder.accounts.decode('Resolver', buf)` (handles padding / future fields).
+ * 2) If discriminator matches IDL `Resolver`, read pubkey at bytes `[8, 40)` (legacy / tolerant).
+ * 3) If `trustOwner === true` (caller has already checked `info.owner === programId`) AND
+ *    the buffer is long enough, read pubkey at bytes `[8, 40)` even if discriminator doesn't
+ *    match the current IDL. This recovers cases where the deployed program predates the
+ *    current IDL (e.g. after a `declare_id!` update + redeploy on a fresh cluster, where the
+ *    browser IDL cache lags the on-chain binary). The PDA seed + owner check is sufficient
+ *    safety: only `initialize_market_resolver` can create a program-owned account at this PDA.
+ */
+export declare function decodeResolverPubkeyFromAccountData(program: AnyProgram, data: Buffer | Uint8Array, options?: {
+    trustOwner?: boolean;
+}): PublicKey | null;
+/**
+ * Anchor `accounts[].discriminator` for `ResolutionVote` from the loaded IDL.
+ * Mirrors {@link resolverDiscriminatorFromIdl} so `fetchResolutionVote` can
+ * distinguish "wrong account type" from "layout decode failed".
+ */
+export declare function resolutionVoteDiscriminatorFromIdl(program: AnyProgram): Buffer | null;
+/** Shape returned by {@link decodeResolutionVoteFromAccountData}. */
+export interface DecodedResolutionVote {
+    hasVoted: boolean;
+    outcomeIndex: number;
+    stakeAmount: BN;
+    claimed: boolean;
+}
+/**
+ * Read a `ResolutionVote` record from raw account bytes.
+ *
+ * Matches on-chain layout (`programs/vercora/src/state/resolution_vote.rs`):
+ * PDA seeds `[market, b"vote", resolver_index]` (see `vote_resolution`).
+ *
+ * Fixed offsets after the 8-byte Anchor discriminator:
+ *   - `has_voted`     : u8  @  8    (bool)
+ *   - `outcome_index` : u8  @  9
+ *   - `stake_amount`  : u64 @ [10, 18) (little-endian)
+ *   - `claimed`       : u8  @ 18   (bool)
+ *
+ * Decode strategy (in order):
+ * 1) Try `coder.accounts.decode('ResolutionVote', buf)` (handles padding /
+ *    future fields when the IDL layout matches the deployed program).
+ * 2) If discriminator matches IDL `ResolutionVote`, read the fixed offsets
+ *    above (legacy / tolerant).
+ * 3) If `trustOwner === true` (caller has already checked
+ *    `info.owner === programId`), read the fixed offsets even if the
+ *    discriminator does not match the current IDL. The PDA seed + owner
+ *    check is sufficient safety: only `vote_resolution` /
+ *    `revoke_resolution_vote` can create a program-owned account at this PDA.
+ */
+export declare function decodeResolutionVoteFromAccountData(program: AnyProgram, data: Buffer | Uint8Array, options?: {
+    trustOwner?: boolean;
+}): DecodedResolutionVote | null;
+export {};
+//# sourceMappingURL=resolverDecode.d.ts.map

package/dist/resolverDecode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolverDecode.d.ts","sourceRoot":"","sources":["../src/resolverDecode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,kGAAkG;AAElG,KAAK,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAK/E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,SAAS,GAAG,IAAI,CA+BlB;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,UAAU,GAClB,MAAM,GAAG,IAAI,CAKf;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,qBAAqB,GAAG,IAAI,CA8D9B"}

package/dist/resolverDecode.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolverDiscriminatorFromIdl = resolverDiscriminatorFromIdl;
+exports.decodeResolverPubkeyFromAccountData = decodeResolverPubkeyFromAccountData;
+exports.resolutionVoteDiscriminatorFromIdl = resolutionVoteDiscriminatorFromIdl;
+exports.decodeResolutionVoteFromAccountData = decodeResolutionVoteFromAccountData;
+const bn_js_1 = __importDefault(require("bn.js"));
+const web3_js_1 = require("@solana/web3.js");
+/**
+ * Anchor `accounts[].discriminator` for `Resolver` from the loaded IDL.
+ * Used to tell "wrong account type at this PDA" from "layout decode failed".
+ */
+function resolverDiscriminatorFromIdl(program) {
+    const idl = program.idl;
+    const row = idl?.accounts?.find((a) => a.name === 'Resolver');
+    if (!row?.discriminator?.length)
+        return null;
+    return Buffer.from(row.discriminator);
+}
+/**
+ * Read `resolver_pubkey` from raw account bytes.
+ *
+ * Matches on-chain layout (`programs/vercora/src/state/resolver.rs`):
+ * PDA seeds `[market, b"resolver", resolver_index]` (see `initialize_market_resolver`).
+ *
+ * Decode strategy (in order):
+ * 1) Try `coder.accounts.decode('Resolver', buf)` (handles padding / future fields).
+ * 2) If discriminator matches IDL `Resolver`, read pubkey at bytes `[8, 40)` (legacy / tolerant).
+ * 3) If `trustOwner === true` (caller has already checked `info.owner === programId`) AND
+ *    the buffer is long enough, read pubkey at bytes `[8, 40)` even if discriminator doesn't
+ *    match the current IDL. This recovers cases where the deployed program predates the
+ *    current IDL (e.g. after a `declare_id!` update + redeploy on a fresh cluster, where the
+ *    browser IDL cache lags the on-chain binary). The PDA seed + owner check is sufficient
+ *    safety: only `initialize_market_resolver` can create a program-owned account at this PDA.
+ */
+function decodeResolverPubkeyFromAccountData(program, data, options) {
+    const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
+    if (buf.length < 8 + 32)
+        return null;
+    const expected = resolverDiscriminatorFromIdl(program);
+    const actual = buf.subarray(0, 8);
+    const discriminatorMatches = !!(expected &&
+        expected.length === 8 &&
+        actual.equals(expected));
+    if (discriminatorMatches) {
+        try {
+            const acc = program.coder.accounts.decode('Resolver', buf);
+            const pk = (acc.resolverPubkey ?? acc.resolver_pubkey);
+            if (pk instanceof web3_js_1.PublicKey)
+                return pk;
+        }
+        catch {
+            /* fall through to byte-range read */
+        }
+    }
+    if (!discriminatorMatches && options?.trustOwner !== true) {
+        return null;
+    }
+    try {
+        return new web3_js_1.PublicKey(buf.subarray(8, 40));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Anchor `accounts[].discriminator` for `ResolutionVote` from the loaded IDL.
+ * Mirrors {@link resolverDiscriminatorFromIdl} so `fetchResolutionVote` can
+ * distinguish "wrong account type" from "layout decode failed".
+ */
+function resolutionVoteDiscriminatorFromIdl(program) {
+    const idl = program.idl;
+    const row = idl?.accounts?.find((a) => a.name === 'ResolutionVote');
+    if (!row?.discriminator?.length)
+        return null;
+    return Buffer.from(row.discriminator);
+}
+/**
+ * Read a `ResolutionVote` record from raw account bytes.
+ *
+ * Matches on-chain layout (`programs/vercora/src/state/resolution_vote.rs`):
+ * PDA seeds `[market, b"vote", resolver_index]` (see `vote_resolution`).
+ *
+ * Fixed offsets after the 8-byte Anchor discriminator:
+ *   - `has_voted`     : u8  @  8    (bool)
+ *   - `outcome_index` : u8  @  9
+ *   - `stake_amount`  : u64 @ [10, 18) (little-endian)
+ *   - `claimed`       : u8  @ 18   (bool)
+ *
+ * Decode strategy (in order):
+ * 1) Try `coder.accounts.decode('ResolutionVote', buf)` (handles padding /
+ *    future fields when the IDL layout matches the deployed program).
+ * 2) If discriminator matches IDL `ResolutionVote`, read the fixed offsets
+ *    above (legacy / tolerant).
+ * 3) If `trustOwner === true` (caller has already checked
+ *    `info.owner === programId`), read the fixed offsets even if the
+ *    discriminator does not match the current IDL. The PDA seed + owner
+ *    check is sufficient safety: only `vote_resolution` /
+ *    `revoke_resolution_vote` can create a program-owned account at this PDA.
+ */
+function decodeResolutionVoteFromAccountData(program, data, options) {
+    const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
+    // 8 disc + 1 has_voted + 1 outcome_index + 8 stake_amount + 1 claimed = 19.
+    if (buf.length < 19)
+        return null;
+    const expected = resolutionVoteDiscriminatorFromIdl(program);
+    const actual = buf.subarray(0, 8);
+    const discriminatorMatches = !!(expected &&
+        expected.length === 8 &&
+        actual.equals(expected));
+    if (discriminatorMatches) {
+        try {
+            const acc = program.coder.accounts.decode('ResolutionVote', buf);
+            const stakeRaw = (acc.stakeAmount ?? acc.stake_amount);
+            const hasVoted = (acc.hasVoted ?? acc.has_voted);
+            const outcomeIndex = (acc.outcomeIndex ?? acc.outcome_index);
+            const claimed = acc.claimed;
+            return {
+                hasVoted: Boolean(hasVoted),
+                outcomeIndex: typeof outcomeIndex === 'number'
+                    ? outcomeIndex
+                    : Number(outcomeIndex ?? 0),
+                stakeAmount: stakeRaw instanceof bn_js_1.default
+                    ? stakeRaw
+                    : stakeRaw != null
+                        ? new bn_js_1.default(stakeRaw.toString())
+                        : new bn_js_1.default(0),
+                claimed: Boolean(claimed),
+            };
+        }
+        catch {
+            /* fall through to byte-range read */
+        }
+    }
+    if (!discriminatorMatches && options?.trustOwner !== true) {
+        return null;
+    }
+    try {
+        const hasVoted = buf.readUInt8(8) === 1;
+        const outcomeIndex = buf.readUInt8(9);
+        // `readBigUInt64LE` requires Node ≥ 12 / modern browsers; do it manually
+        // via a hex round-trip to stay portable and avoid BigInt leakage into the
+        // public API (`stakeAmount` is typed as `BN`).
+        const stakeAmount = new bn_js_1.default(buf.subarray(10, 18).toString('hex'), 16, 'le');
+        const claimed = buf.readUInt8(18) === 1;
+        return { hasVoted, outcomeIndex, stakeAmount, claimed };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=resolverDecode.js.map

package/dist/resolverDecode.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercora-protocol/sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "TypeScript SDK for the Vercora protocol on Solana",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",