@sage-protocol/sdk 0.2.4 → 0.2.5

package/dist/browser/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.2.4",
+      version: "0.2.5",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",

package/dist/index.cjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.2.4",
+      version: "0.2.5",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -5022,9 +5022,127 @@ var require_governance = __commonJS({
         description: desc.description
       };
     }
+    async function getProposalVotingStatus({ provider, governor, proposalId }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      if (!proposalId) throw new SageSDKError(CODES.INVALID_ARGS, "proposalId required");
+      const addr = normaliseGovernor(governor);
+      const g = new Contract(addr, ABI.Governor, provider);
+      const pid = typeof proposalId === "bigint" ? proposalId : BigInt(String(proposalId));
+      const [
+        stateNum,
+        snapshot,
+        deadline,
+        votes,
+        votingDelay,
+        votingPeriod,
+        proposalThreshold,
+        govName
+      ] = await Promise.all([
+        g.state(pid).catch(() => null),
+        g.proposalSnapshot(pid).catch(() => null),
+        g.proposalDeadline(pid).catch(() => null),
+        g.proposalVotes(pid).catch(() => null),
+        g.votingDelay().catch(() => null),
+        g.votingPeriod().catch(() => null),
+        g.proposalThreshold().catch(() => null),
+        g.name().catch(() => null)
+      ]);
+      let quorum = null;
+      if (snapshot != null) {
+        try {
+          quorum = await g.quorum(snapshot);
+          quorum = BigInt(quorum.toString());
+        } catch {
+          try {
+            const qv = await g.quorumVotes();
+            quorum = BigInt(qv.toString());
+          } catch {
+          }
+        }
+      }
+      let forVotes = 0n;
+      let againstVotes = 0n;
+      let abstainVotes = 0n;
+      if (Array.isArray(votes)) {
+        againstVotes = BigInt(votes[0]);
+        forVotes = BigInt(votes[1]);
+        abstainVotes = BigInt(votes[2]);
+      } else if (votes && typeof votes === "object") {
+        if (votes.againstVotes != null) againstVotes = BigInt(votes.againstVotes);
+        if (votes.forVotes != null) forVotes = BigInt(votes.forVotes);
+        if (votes.abstainVotes != null) abstainVotes = BigInt(votes.abstainVotes);
+      }
+      const totalVotes = forVotes + againstVotes + abstainVotes;
+      const participatingVotes = forVotes + againstVotes;
+      const quorumMet = quorum != null ? forVotes >= quorum : null;
+      const quorumProgress = quorum != null && quorum > 0n ? Number(forVotes * 10000n / quorum) / 100 : null;
+      const stateMap = ["PENDING", "ACTIVE", "CANCELED", "DEFEATED", "SUCCEEDED", "QUEUED", "EXPIRED", "EXECUTED"];
+      const state = typeof stateNum === "number" && stateNum >= 0 && stateNum < stateMap.length ? stateMap[stateNum] : null;
+      const BLOCK_TIME_SECONDS = 2;
+      const votingDelaySeconds = votingDelay != null ? Number(votingDelay) * BLOCK_TIME_SECONDS : null;
+      const votingPeriodSeconds = votingPeriod != null ? Number(votingPeriod) * BLOCK_TIME_SECONDS : null;
+      const formatSXXX = (val) => {
+        if (val == null) return null;
+        const num = Number(val) / 1e18;
+        if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+        if (num >= 1e3) return `${(num / 1e3).toFixed(1)}K`;
+        return num.toFixed(2);
+      };
+      const formatDuration = (seconds) => {
+        if (seconds == null) return null;
+        if (seconds < 60) return `${seconds} seconds`;
+        if (seconds < 3600) return `${Math.round(seconds / 60)} minutes`;
+        if (seconds < 86400) return `${(seconds / 3600).toFixed(1)} hours`;
+        return `${(seconds / 86400).toFixed(1)} days`;
+      };
+      return {
+        governor: addr,
+        governorName: govName,
+        proposalId: pid.toString(),
+        state,
+        stateNum: typeof stateNum === "number" ? stateNum : null,
+        // Raw values (bigint as string for JSON serialization)
+        votes: {
+          for: forVotes.toString(),
+          against: againstVotes.toString(),
+          abstain: abstainVotes.toString(),
+          total: totalVotes.toString()
+        },
+        quorum: quorum?.toString() || null,
+        proposalThreshold: proposalThreshold?.toString() || null,
+        snapshot: snapshot?.toString() || null,
+        deadline: deadline?.toString() || null,
+        votingDelay: votingDelay?.toString() || null,
+        votingPeriod: votingPeriod?.toString() || null,
+        // Computed status
+        quorumMet,
+        quorumProgress,
+        // percentage (0-100+)
+        passing: forVotes > againstVotes,
+        // Formatted for display
+        formatted: {
+          forVotes: formatSXXX(forVotes),
+          againstVotes: formatSXXX(againstVotes),
+          abstainVotes: formatSXXX(abstainVotes),
+          totalVotes: formatSXXX(totalVotes),
+          quorum: formatSXXX(quorum),
+          proposalThreshold: formatSXXX(proposalThreshold),
+          votingDelay: formatDuration(votingDelaySeconds),
+          votingPeriod: formatDuration(votingPeriodSeconds)
+        },
+        // Plain language summary
+        summary: {
+          quorumStatus: quorum != null ? quorumMet ? `Quorum reached (${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX required)` : `${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX needed for quorum (${quorumProgress?.toFixed(1)}%)` : "Quorum information unavailable",
+          voteStatus: `${formatSXXX(forVotes)} SXXX for, ${formatSXXX(againstVotes)} SXXX against`,
+          outcome: forVotes > againstVotes ? "Currently passing" : forVotes < againstVotes ? "Currently failing" : "Tied",
+          votingPeriod: votingPeriodSeconds ? `Voting period: ${formatDuration(votingPeriodSeconds)}` : null
+        }
+      };
+    }
     module2.exports = {
       getGovernorInfo,
       getProposal,
+      getProposalVotingStatus,
       listProposals,
       getProposalMetadata,
       hashDescription,

package/dist/index.mjs

@@ -20,7 +20,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.2.4",
+      version: "0.2.5",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -5028,9 +5028,127 @@ var require_governance = __commonJS({
         description: desc.description
       };
     }
+    async function getProposalVotingStatus({ provider, governor, proposalId }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      if (!proposalId) throw new SageSDKError(CODES.INVALID_ARGS, "proposalId required");
+      const addr = normaliseGovernor(governor);
+      const g = new Contract(addr, ABI.Governor, provider);
+      const pid = typeof proposalId === "bigint" ? proposalId : BigInt(String(proposalId));
+      const [
+        stateNum,
+        snapshot,
+        deadline,
+        votes,
+        votingDelay,
+        votingPeriod,
+        proposalThreshold,
+        govName
+      ] = await Promise.all([
+        g.state(pid).catch(() => null),
+        g.proposalSnapshot(pid).catch(() => null),
+        g.proposalDeadline(pid).catch(() => null),
+        g.proposalVotes(pid).catch(() => null),
+        g.votingDelay().catch(() => null),
+        g.votingPeriod().catch(() => null),
+        g.proposalThreshold().catch(() => null),
+        g.name().catch(() => null)
+      ]);
+      let quorum = null;
+      if (snapshot != null) {
+        try {
+          quorum = await g.quorum(snapshot);
+          quorum = BigInt(quorum.toString());
+        } catch {
+          try {
+            const qv = await g.quorumVotes();
+            quorum = BigInt(qv.toString());
+          } catch {
+          }
+        }
+      }
+      let forVotes = 0n;
+      let againstVotes = 0n;
+      let abstainVotes = 0n;
+      if (Array.isArray(votes)) {
+        againstVotes = BigInt(votes[0]);
+        forVotes = BigInt(votes[1]);
+        abstainVotes = BigInt(votes[2]);
+      } else if (votes && typeof votes === "object") {
+        if (votes.againstVotes != null) againstVotes = BigInt(votes.againstVotes);
+        if (votes.forVotes != null) forVotes = BigInt(votes.forVotes);
+        if (votes.abstainVotes != null) abstainVotes = BigInt(votes.abstainVotes);
+      }
+      const totalVotes = forVotes + againstVotes + abstainVotes;
+      const participatingVotes = forVotes + againstVotes;
+      const quorumMet = quorum != null ? forVotes >= quorum : null;
+      const quorumProgress = quorum != null && quorum > 0n ? Number(forVotes * 10000n / quorum) / 100 : null;
+      const stateMap = ["PENDING", "ACTIVE", "CANCELED", "DEFEATED", "SUCCEEDED", "QUEUED", "EXPIRED", "EXECUTED"];
+      const state = typeof stateNum === "number" && stateNum >= 0 && stateNum < stateMap.length ? stateMap[stateNum] : null;
+      const BLOCK_TIME_SECONDS = 2;
+      const votingDelaySeconds = votingDelay != null ? Number(votingDelay) * BLOCK_TIME_SECONDS : null;
+      const votingPeriodSeconds = votingPeriod != null ? Number(votingPeriod) * BLOCK_TIME_SECONDS : null;
+      const formatSXXX = (val) => {
+        if (val == null) return null;
+        const num = Number(val) / 1e18;
+        if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+        if (num >= 1e3) return `${(num / 1e3).toFixed(1)}K`;
+        return num.toFixed(2);
+      };
+      const formatDuration = (seconds) => {
+        if (seconds == null) return null;
+        if (seconds < 60) return `${seconds} seconds`;
+        if (seconds < 3600) return `${Math.round(seconds / 60)} minutes`;
+        if (seconds < 86400) return `${(seconds / 3600).toFixed(1)} hours`;
+        return `${(seconds / 86400).toFixed(1)} days`;
+      };
+      return {
+        governor: addr,
+        governorName: govName,
+        proposalId: pid.toString(),
+        state,
+        stateNum: typeof stateNum === "number" ? stateNum : null,
+        // Raw values (bigint as string for JSON serialization)
+        votes: {
+          for: forVotes.toString(),
+          against: againstVotes.toString(),
+          abstain: abstainVotes.toString(),
+          total: totalVotes.toString()
+        },
+        quorum: quorum?.toString() || null,
+        proposalThreshold: proposalThreshold?.toString() || null,
+        snapshot: snapshot?.toString() || null,
+        deadline: deadline?.toString() || null,
+        votingDelay: votingDelay?.toString() || null,
+        votingPeriod: votingPeriod?.toString() || null,
+        // Computed status
+        quorumMet,
+        quorumProgress,
+        // percentage (0-100+)
+        passing: forVotes > againstVotes,
+        // Formatted for display
+        formatted: {
+          forVotes: formatSXXX(forVotes),
+          againstVotes: formatSXXX(againstVotes),
+          abstainVotes: formatSXXX(abstainVotes),
+          totalVotes: formatSXXX(totalVotes),
+          quorum: formatSXXX(quorum),
+          proposalThreshold: formatSXXX(proposalThreshold),
+          votingDelay: formatDuration(votingDelaySeconds),
+          votingPeriod: formatDuration(votingPeriodSeconds)
+        },
+        // Plain language summary
+        summary: {
+          quorumStatus: quorum != null ? quorumMet ? `Quorum reached (${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX required)` : `${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX needed for quorum (${quorumProgress?.toFixed(1)}%)` : "Quorum information unavailable",
+          voteStatus: `${formatSXXX(forVotes)} SXXX for, ${formatSXXX(againstVotes)} SXXX against`,
+          outcome: forVotes > againstVotes ? "Currently passing" : forVotes < againstVotes ? "Currently failing" : "Tied",
+          votingPeriod: votingPeriodSeconds ? `Voting period: ${formatDuration(votingPeriodSeconds)}` : null
+        }
+      };
+    }
     module2.exports = {
       getGovernorInfo,
       getProposal,
+      getProposalVotingStatus,
       listProposals,
       getProposalMetadata,
       hashDescription,

package/dist/node/index.cjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.2.4",
+      version: "0.2.5",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -5022,9 +5022,127 @@ var require_governance = __commonJS({
         description: desc.description
       };
     }
+    async function getProposalVotingStatus({ provider, governor, proposalId }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      if (!proposalId) throw new SageSDKError(CODES.INVALID_ARGS, "proposalId required");
+      const addr = normaliseGovernor(governor);
+      const g = new Contract(addr, ABI.Governor, provider);
+      const pid = typeof proposalId === "bigint" ? proposalId : BigInt(String(proposalId));
+      const [
+        stateNum,
+        snapshot,
+        deadline,
+        votes,
+        votingDelay,
+        votingPeriod,
+        proposalThreshold,
+        govName
+      ] = await Promise.all([
+        g.state(pid).catch(() => null),
+        g.proposalSnapshot(pid).catch(() => null),
+        g.proposalDeadline(pid).catch(() => null),
+        g.proposalVotes(pid).catch(() => null),
+        g.votingDelay().catch(() => null),
+        g.votingPeriod().catch(() => null),
+        g.proposalThreshold().catch(() => null),
+        g.name().catch(() => null)
+      ]);
+      let quorum = null;
+      if (snapshot != null) {
+        try {
+          quorum = await g.quorum(snapshot);
+          quorum = BigInt(quorum.toString());
+        } catch {
+          try {
+            const qv = await g.quorumVotes();
+            quorum = BigInt(qv.toString());
+          } catch {
+          }
+        }
+      }
+      let forVotes = 0n;
+      let againstVotes = 0n;
+      let abstainVotes = 0n;
+      if (Array.isArray(votes)) {
+        againstVotes = BigInt(votes[0]);
+        forVotes = BigInt(votes[1]);
+        abstainVotes = BigInt(votes[2]);
+      } else if (votes && typeof votes === "object") {
+        if (votes.againstVotes != null) againstVotes = BigInt(votes.againstVotes);
+        if (votes.forVotes != null) forVotes = BigInt(votes.forVotes);
+        if (votes.abstainVotes != null) abstainVotes = BigInt(votes.abstainVotes);
+      }
+      const totalVotes = forVotes + againstVotes + abstainVotes;
+      const participatingVotes = forVotes + againstVotes;
+      const quorumMet = quorum != null ? forVotes >= quorum : null;
+      const quorumProgress = quorum != null && quorum > 0n ? Number(forVotes * 10000n / quorum) / 100 : null;
+      const stateMap = ["PENDING", "ACTIVE", "CANCELED", "DEFEATED", "SUCCEEDED", "QUEUED", "EXPIRED", "EXECUTED"];
+      const state = typeof stateNum === "number" && stateNum >= 0 && stateNum < stateMap.length ? stateMap[stateNum] : null;
+      const BLOCK_TIME_SECONDS = 2;
+      const votingDelaySeconds = votingDelay != null ? Number(votingDelay) * BLOCK_TIME_SECONDS : null;
+      const votingPeriodSeconds = votingPeriod != null ? Number(votingPeriod) * BLOCK_TIME_SECONDS : null;
+      const formatSXXX = (val) => {
+        if (val == null) return null;
+        const num = Number(val) / 1e18;
+        if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+        if (num >= 1e3) return `${(num / 1e3).toFixed(1)}K`;
+        return num.toFixed(2);
+      };
+      const formatDuration = (seconds) => {
+        if (seconds == null) return null;
+        if (seconds < 60) return `${seconds} seconds`;
+        if (seconds < 3600) return `${Math.round(seconds / 60)} minutes`;
+        if (seconds < 86400) return `${(seconds / 3600).toFixed(1)} hours`;
+        return `${(seconds / 86400).toFixed(1)} days`;
+      };
+      return {
+        governor: addr,
+        governorName: govName,
+        proposalId: pid.toString(),
+        state,
+        stateNum: typeof stateNum === "number" ? stateNum : null,
+        // Raw values (bigint as string for JSON serialization)
+        votes: {
+          for: forVotes.toString(),
+          against: againstVotes.toString(),
+          abstain: abstainVotes.toString(),
+          total: totalVotes.toString()
+        },
+        quorum: quorum?.toString() || null,
+        proposalThreshold: proposalThreshold?.toString() || null,
+        snapshot: snapshot?.toString() || null,
+        deadline: deadline?.toString() || null,
+        votingDelay: votingDelay?.toString() || null,
+        votingPeriod: votingPeriod?.toString() || null,
+        // Computed status
+        quorumMet,
+        quorumProgress,
+        // percentage (0-100+)
+        passing: forVotes > againstVotes,
+        // Formatted for display
+        formatted: {
+          forVotes: formatSXXX(forVotes),
+          againstVotes: formatSXXX(againstVotes),
+          abstainVotes: formatSXXX(abstainVotes),
+          totalVotes: formatSXXX(totalVotes),
+          quorum: formatSXXX(quorum),
+          proposalThreshold: formatSXXX(proposalThreshold),
+          votingDelay: formatDuration(votingDelaySeconds),
+          votingPeriod: formatDuration(votingPeriodSeconds)
+        },
+        // Plain language summary
+        summary: {
+          quorumStatus: quorum != null ? quorumMet ? `Quorum reached (${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX required)` : `${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX needed for quorum (${quorumProgress?.toFixed(1)}%)` : "Quorum information unavailable",
+          voteStatus: `${formatSXXX(forVotes)} SXXX for, ${formatSXXX(againstVotes)} SXXX against`,
+          outcome: forVotes > againstVotes ? "Currently passing" : forVotes < againstVotes ? "Currently failing" : "Tied",
+          votingPeriod: votingPeriodSeconds ? `Voting period: ${formatDuration(votingPeriodSeconds)}` : null
+        }
+      };
+    }
     module2.exports = {
       getGovernorInfo,
       getProposal,
+      getProposalVotingStatus,
       listProposals,
       getProposalMetadata,
       hashDescription,

package/dist/node/index.mjs

@@ -20,7 +20,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.2.4",
+      version: "0.2.5",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -5028,9 +5028,127 @@ var require_governance = __commonJS({
         description: desc.description
       };
     }
+    async function getProposalVotingStatus({ provider, governor, proposalId }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      if (!proposalId) throw new SageSDKError(CODES.INVALID_ARGS, "proposalId required");
+      const addr = normaliseGovernor(governor);
+      const g = new Contract(addr, ABI.Governor, provider);
+      const pid = typeof proposalId === "bigint" ? proposalId : BigInt(String(proposalId));
+      const [
+        stateNum,
+        snapshot,
+        deadline,
+        votes,
+        votingDelay,
+        votingPeriod,
+        proposalThreshold,
+        govName
+      ] = await Promise.all([
+        g.state(pid).catch(() => null),
+        g.proposalSnapshot(pid).catch(() => null),
+        g.proposalDeadline(pid).catch(() => null),
+        g.proposalVotes(pid).catch(() => null),
+        g.votingDelay().catch(() => null),
+        g.votingPeriod().catch(() => null),
+        g.proposalThreshold().catch(() => null),
+        g.name().catch(() => null)
+      ]);
+      let quorum = null;
+      if (snapshot != null) {
+        try {
+          quorum = await g.quorum(snapshot);
+          quorum = BigInt(quorum.toString());
+        } catch {
+          try {
+            const qv = await g.quorumVotes();
+            quorum = BigInt(qv.toString());
+          } catch {
+          }
+        }
+      }
+      let forVotes = 0n;
+      let againstVotes = 0n;
+      let abstainVotes = 0n;
+      if (Array.isArray(votes)) {
+        againstVotes = BigInt(votes[0]);
+        forVotes = BigInt(votes[1]);
+        abstainVotes = BigInt(votes[2]);
+      } else if (votes && typeof votes === "object") {
+        if (votes.againstVotes != null) againstVotes = BigInt(votes.againstVotes);
+        if (votes.forVotes != null) forVotes = BigInt(votes.forVotes);
+        if (votes.abstainVotes != null) abstainVotes = BigInt(votes.abstainVotes);
+      }
+      const totalVotes = forVotes + againstVotes + abstainVotes;
+      const participatingVotes = forVotes + againstVotes;
+      const quorumMet = quorum != null ? forVotes >= quorum : null;
+      const quorumProgress = quorum != null && quorum > 0n ? Number(forVotes * 10000n / quorum) / 100 : null;
+      const stateMap = ["PENDING", "ACTIVE", "CANCELED", "DEFEATED", "SUCCEEDED", "QUEUED", "EXPIRED", "EXECUTED"];
+      const state = typeof stateNum === "number" && stateNum >= 0 && stateNum < stateMap.length ? stateMap[stateNum] : null;
+      const BLOCK_TIME_SECONDS = 2;
+      const votingDelaySeconds = votingDelay != null ? Number(votingDelay) * BLOCK_TIME_SECONDS : null;
+      const votingPeriodSeconds = votingPeriod != null ? Number(votingPeriod) * BLOCK_TIME_SECONDS : null;
+      const formatSXXX = (val) => {
+        if (val == null) return null;
+        const num = Number(val) / 1e18;
+        if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+        if (num >= 1e3) return `${(num / 1e3).toFixed(1)}K`;
+        return num.toFixed(2);
+      };
+      const formatDuration = (seconds) => {
+        if (seconds == null) return null;
+        if (seconds < 60) return `${seconds} seconds`;
+        if (seconds < 3600) return `${Math.round(seconds / 60)} minutes`;
+        if (seconds < 86400) return `${(seconds / 3600).toFixed(1)} hours`;
+        return `${(seconds / 86400).toFixed(1)} days`;
+      };
+      return {
+        governor: addr,
+        governorName: govName,
+        proposalId: pid.toString(),
+        state,
+        stateNum: typeof stateNum === "number" ? stateNum : null,
+        // Raw values (bigint as string for JSON serialization)
+        votes: {
+          for: forVotes.toString(),
+          against: againstVotes.toString(),
+          abstain: abstainVotes.toString(),
+          total: totalVotes.toString()
+        },
+        quorum: quorum?.toString() || null,
+        proposalThreshold: proposalThreshold?.toString() || null,
+        snapshot: snapshot?.toString() || null,
+        deadline: deadline?.toString() || null,
+        votingDelay: votingDelay?.toString() || null,
+        votingPeriod: votingPeriod?.toString() || null,
+        // Computed status
+        quorumMet,
+        quorumProgress,
+        // percentage (0-100+)
+        passing: forVotes > againstVotes,
+        // Formatted for display
+        formatted: {
+          forVotes: formatSXXX(forVotes),
+          againstVotes: formatSXXX(againstVotes),
+          abstainVotes: formatSXXX(abstainVotes),
+          totalVotes: formatSXXX(totalVotes),
+          quorum: formatSXXX(quorum),
+          proposalThreshold: formatSXXX(proposalThreshold),
+          votingDelay: formatDuration(votingDelaySeconds),
+          votingPeriod: formatDuration(votingPeriodSeconds)
+        },
+        // Plain language summary
+        summary: {
+          quorumStatus: quorum != null ? quorumMet ? `Quorum reached (${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX required)` : `${formatSXXX(forVotes)} of ${formatSXXX(quorum)} SXXX needed for quorum (${quorumProgress?.toFixed(1)}%)` : "Quorum information unavailable",
+          voteStatus: `${formatSXXX(forVotes)} SXXX for, ${formatSXXX(againstVotes)} SXXX against`,
+          outcome: forVotes > againstVotes ? "Currently passing" : forVotes < againstVotes ? "Currently failing" : "Tied",
+          votingPeriod: votingPeriodSeconds ? `Voting period: ${formatDuration(votingPeriodSeconds)}` : null
+        }
+      };
+    }
     module2.exports = {
       getGovernorInfo,
       getProposal,
+      getProposalVotingStatus,
       listProposals,
       getProposalMetadata,
       hashDescription,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-protocol/sdk",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",