diff --git a/frontend/src/hooks/index.ts b/frontend/src/hooks/index.ts
index 9b0d4a54..9ccd8655 100644
--- a/frontend/src/hooks/index.ts
+++ b/frontend/src/hooks/index.ts
@@ -9,6 +9,7 @@ export { useRetry } from './useRetry';
export { useDebouncedSearch } from './useDebouncedSearch';
export { useStxPriceData } from './useStxPrice';
export { useWalletBalanceData } from './useWalletBalance';
+export { useTreasuryBalance } from './useTreasuryBalance';
// Blockchain state hooks
export { useCurrentBlockHeight } from './useCurrentBlockHeight';
export { useVote } from './useVote';
diff --git a/frontend/src/hooks/useTreasuryBalance.ts b/frontend/src/hooks/useTreasuryBalance.ts
new file mode 100644
index 00000000..eb2624c5
--- /dev/null
+++ b/frontend/src/hooks/useTreasuryBalance.ts
@@ -0,0 +1,54 @@
+import { useState, useEffect } from 'react';
+import { API_URL, CONTRACT_ADDRESS, CONTRACT_NAME, microToStx } from '../config';
+import { normalizeError } from '../lib/error-normalizer';
+
+interface TreasuryBalanceState {
+ balance: number | null;
+ balanceInStx: number | null;
+ loading: boolean;
+ error: string | null;
+ refetch: () => void;
+}
+
+export function useTreasuryBalance(): TreasuryBalanceState {
+ const [balance, setBalance] = useState
(null);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ const fetchTreasuryBalance = async () => {
+ setLoading(true);
+ setError(null);
+
+ try {
+ const contractAddress = `${CONTRACT_ADDRESS}.${CONTRACT_NAME}`;
+ const url = `${API_URL}/extended/v1/address/${contractAddress}/stx`;
+ const response = await fetch(url);
+
+ if (!response.ok) {
+ throw new Error(`Failed to fetch treasury balance: ${response.statusText}`);
+ }
+
+ const data = await response.json();
+ setBalance(Number(data.balance) || 0);
+ } catch (err) {
+ const normalized = normalizeError(err);
+ setError(normalized.message);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ useEffect(() => {
+ fetchTreasuryBalance();
+ const interval = setInterval(fetchTreasuryBalance, 60000);
+ return () => clearInterval(interval);
+ }, []);
+
+ return {
+ balance,
+ balanceInStx: balance !== null ? microToStx(balance) : null,
+ loading,
+ error,
+ refetch: fetchTreasuryBalance,
+ };
+}
diff --git a/frontend/src/lib/validation.test.ts b/frontend/src/lib/validation.test.ts
index 7b180953..edb45736 100644
--- a/frontend/src/lib/validation.test.ts
+++ b/frontend/src/lib/validation.test.ts
@@ -3,6 +3,7 @@ import {
validateTitle,
validateDescription,
validateAmount,
+ validateAmountAgainstTreasury,
validateDuration,
validateProposalForm,
isFormValid,
@@ -181,3 +182,34 @@ describe('isFormValid', () => {
expect(isFormValid({ title: 'Title is required' })).toBe(false);
});
});
+
+/* ────────────────────────────────────────────── */
+/* validateAmountAgainstTreasury */
+/* ────────────────────────────────────────────── */
+describe('validateAmountAgainstTreasury', () => {
+ it('returns basic validation error when amount is invalid', () => {
+ expect(validateAmountAgainstTreasury('', 100)).toBe('Amount is required');
+ expect(validateAmountAgainstTreasury('abc', 100)).toContain('valid number');
+ expect(validateAmountAgainstTreasury('0', 100)).toContain('at least');
+ });
+
+ it('returns null when amount is valid and within treasury balance', () => {
+ expect(validateAmountAgainstTreasury('50', 100)).toBeNull();
+ expect(validateAmountAgainstTreasury('100', 100)).toBeNull();
+ });
+
+ it('returns error when amount exceeds treasury balance', () => {
+ const error = validateAmountAgainstTreasury('150', 100);
+ expect(error).toContain('exceeds treasury balance');
+ expect(error).toContain('100.00 STX available');
+ });
+
+ it('handles null treasury balance gracefully', () => {
+ expect(validateAmountAgainstTreasury('50', null)).toBeNull();
+ });
+
+ it('validates against treasury balance with decimals', () => {
+ expect(validateAmountAgainstTreasury('50.5', 50.25)).toContain('exceeds treasury balance');
+ expect(validateAmountAgainstTreasury('50.25', 50.25)).toBeNull();
+ });
+});
diff --git a/frontend/src/lib/validation.ts b/frontend/src/lib/validation.ts
index dc608062..13aa87fb 100644
--- a/frontend/src/lib/validation.ts
+++ b/frontend/src/lib/validation.ts
@@ -96,6 +96,23 @@ export function validateAmount(value: string): string | null {
return null;
}
+export function validateAmountAgainstTreasury(
+ value: string,
+ treasuryBalance: number | null
+): string | null {
+ const basicError = validateAmount(value);
+ if (basicError) return basicError;
+
+ if (treasuryBalance !== null) {
+ const num = parseFloat(value);
+ if (num > treasuryBalance) {
+ return `Amount exceeds treasury balance (${treasuryBalance.toFixed(2)} STX available)`;
+ }
+ }
+
+ return null;
+}
+
export function validateDuration(value: string): string | null {
if (!value.trim()) return 'Duration is required';
const num = parseInt(value, 10);
diff --git a/frontend/src/spa-pages/CreateProposal.tsx b/frontend/src/spa-pages/CreateProposal.tsx
index 19fd6d10..3dee810c 100644
--- a/frontend/src/spa-pages/CreateProposal.tsx
+++ b/frontend/src/spa-pages/CreateProposal.tsx
@@ -9,7 +9,8 @@ import { useFormValidation } from '../hooks/useFormValidation';
import { useFocusOnMount } from '../hooks/useFocusOnMount';
import { useDocumentTitle } from '../hooks/useDocumentTitle';
import { useStxPriceData } from '../hooks/useStxPrice';
-import { isFormValid, validateProposalForm } from '../lib/validation';
+import { useTreasuryBalance } from '../hooks/useTreasuryBalance';
+import { isFormValid, validateProposalForm, validateAmountAgainstTreasury } from '../lib/validation';
import { sanitizeText, sanitizeMultilineText } from '../lib/sanitize';
import { formatUsd, stxToUsd } from '../lib/currency';
import { CharacterCounter } from '../components/CharacterCounter';
@@ -29,6 +30,7 @@ export function CreateProposalPage() {
const headingRef = useFocusOnMount();
useDocumentTitle('Create Proposal');
const { price: stxPrice } = useStxPriceData();
+ const { balanceInStx, loading: treasuryLoading, error: treasuryError } = useTreasuryBalance();
const [title, setTitle] = useState('');
const [description, setDescription] = useState('');
@@ -119,10 +121,35 @@ export function CreateProposalPage() {
return (
Create Proposal
-
+
Submit a funding request to the SprintFund DAO. Requires {MIN_STAKE_STX}+ STX staked.
+ {/* Treasury Balance Display */}
+
+
+
+
Treasury Available
+ {treasuryLoading ? (
+
Loading balance...
+ ) : treasuryError ? (
+
Failed to load treasury balance
+ ) : (
+
+ {balanceInStx !== null ? `${balanceInStx.toFixed(2)} STX` : '0.00 STX'}
+
+ )}
+
+ {!treasuryLoading && !treasuryError && balanceInStx !== null && (
+
Available for funding
+ )}
+
+
+