DAO Voting Bot Guide

Welcome to the OK Family Fund DAO Voting System! This bot enables decentralized governance through snapshot-based, token-weighted voting directly in Discord.

How It Works

Our DAO voting system uses off-chain snapshot voting to enable fair, transparent governance:

Link Your Wallet → Connect your Solana wallet to your Discord account
Token Balance = Voting Power → Your OKFUND tokens determine your vote weight
Snapshot System → Balances are frozen when proposals are created
Vote on Proposals → Cast your vote using interactive buttons or commands
Quorum & Results → Proposals need minimum participation to pass

Available Commands

🔗 `/link`

Generate your personal wallet verification link. Click it, sign the message with your Solana wallet, and link it to your Discord account.

Example:

/link

`/linkstatus`

Check which wallet is currently linked to your Discord account and view your cached balance.

Example:

/linkstatus

`/balance`

View your OKFUND token balance (both live and cached). Balances automatically sync every 10 minutes.

Example:

/balance

`/propose`

Create a new governance proposal. Requires minimum token threshold (default: 100,000 OKFUND).

Parameters:

title - Short, clear title (max 140 characters)
description - Full details of your proposal
options - Comma-separated choices (e.g., "Yes,No,Abstain")
duration_hours - How long voting lasts (default: 72 hours)
quorum_pct - % of supply needed for quorum (default: 10%)
threshold_tokens - Min tokens to create proposal (default: 100,000)

Example:

/propose 
  title: Add new liquidity pool
  description: Propose adding 50,000 OKFUND to Raydium pool
  options: Yes,No,Abstain
  duration_hours: 72
  quorum_pct: 10

`/vote`

Vote on a proposal using its ID. You can also vote using the interactive buttons on proposal messages!

Parameters:

proposal_id - Short ID (e.g., "A1B2C3") or full UUID
choice - Option number (1, 2, 3, etc.)

Example:

/vote proposal_id: A1B2C3 choice: 1

`/status`

Check the current status and results of any proposal.

Example:

/status proposal_id: A1B2C3

`/proposals`

List all proposals with optional filtering by status.

Parameters:

filter - Show "All", "Active", or "Closed" proposals

Example:

/proposals filter: Active

`/close`

Close a proposal early (requires admin, server manager, or proposal author permissions).

Example:

/close proposal_id: A1B2C3

Wallet Linking Process

Step 1: Generate Your Link

Run /link to get your unique verification URL.

Step 2: Connect Your Wallet

Click the link and connect your Solana wallet (Phantom, Solflare, etc.).

Step 3: Sign the Message

Sign the verification message with your wallet. This proves ownership.

Step 4: Confirmation

Your wallet is now linked! You can verify with /linkstatus.

⚠️ Important:

One wallet per Discord account
You can relink to change wallets
Your wallet address is stored securely

How Snapshots Work

When a proposal is created, the system takes a snapshot of all token balances:

Freeze Point → All linked wallets' OKFUND balances are recorded
Immutable Record → This snapshot cannot be changed
Fair Voting → No one can buy tokens mid-vote to influence results
Your Power → Your vote weight = your balance at snapshot time

Example:

Alice has 10,000 OKFUND when proposal created → 10,000 voting power
Alice buys 5,000 more OKFUND after proposal → Still 10,000 voting power
Bob has 0 OKFUND at snapshot → Cannot vote on this proposal

Voting Power Explained

Your voting power is token-weighted:

1 OKFUND = 1 Vote

Example Scenario:

Alice has 10,000 OKFUND → votes "Yes" → Yes gets 10,000 votes
Bob has 50,000 OKFUND → votes "No" → No gets 50,000 votes
Charlie has 5,000 OKFUND → votes "Yes" → Yes gets 5,000 more votes

Final Tally:

Yes: 15,000 votes (23%)
No: 50,000 votes (77%)

Larger token holders have more influence, but anyone with tokens can participate!

Quorum Requirements

For a proposal to be valid, it must reach quorum - a minimum participation threshold:

Default Quorum: 10% of circulating supply

Example:

Circulating Supply: 1,000,000 OKFUND
Quorum Required: 100,000 OKFUND (10%)
Total Votes Cast: 150,000 OKFUND
✅ Quorum Met → Proposal is valid

If Quorum Not Met:

❌ Proposal fails regardless of vote distribution
Not enough community participation
Proposal can be recreated with adjusted parameters

Live Results & Updates

Proposal messages update automatically when votes are cast:

Real-Time Features:

📈 Vote tallies update instantly
📊 Visual progress bars for each option
👥 Unique voter count
✅ Live quorum progress
🥇 Leading option highlighted

You'll See:

📊 Current Results
🥇 Yes
███████████████ 75.0%
12,000 votes (75.0%)

▫️ No
█████░░░░░░░░░░ 25.0%
4,000 votes (25.0%)

📈 Participation: 8 voters | 16,000 total votes
Quorum: ✅ Met (16,000 / 10,000)

Changing Your Vote

You can update your vote anytime before voting ends:

Click a different button, or use /vote again
Your previous vote is replaced (not added)
Your voting power stays the same (from snapshot)
Only your latest vote counts

Example:

You vote "Yes" with 5,000 OKFUND
You change to "No"
"Yes" loses 5,000 votes, "No" gains 5,000 votes
Final: You have 1 vote for "No" worth 5,000 OKFUND

Proposal Lifecycle

1️⃣ Creation

Author must have threshold tokens (default: 100,000 OKFUND)
Snapshot taken immediately
Voting starts instantly

2️⃣ Active Voting

Members can vote using buttons or commands
Results update in real-time
Votes can be changed anytime

3️⃣ Voting Ends

After duration expires (default: 72 hours)
Or proposal is manually closed by admin/author
No new votes accepted

4️⃣ Results

Final tallies displayed
Quorum status shown (✅ Met or ❌ Not Met)
Winning option highlighted

Quick Start Guide

For Voters:

1. Run /link and connect your wallet
2. Wait for a proposal to be posted
3. Click a button to vote, or use /vote
4. Watch live results update!

For Proposal Creators:

1. Run /link and connect your wallet
2. Ensure you have 100,000+ OKFUND tokens
3. Run /propose with your idea
4. Share the proposal ID with the community
5. Monitor results with /status

Tips & Best Practices

For Voters:

✅ Link your wallet before voting starts
✅ Check /balance to verify your voting power
✅ Read proposals carefully before voting
✅ You can change your vote anytime before it ends
✅ Vote buttons are faster than commands

For Proposal Creators:

✅ Write clear, concise titles
✅ Include detailed descriptions
✅ Set realistic durations (72h recommended)
✅ Consider 10% quorum for most proposals
✅ Engage with voters in discussion threads
✅ Use 2-3 options for simple decisions, more for complex ones

For Everyone:

✅ Balances sync every 10 minutes automatically
✅ Proposals auto-close when time expires
✅ One wallet per Discord account
✅ Your voting power is locked at snapshot time
✅ Check /proposals to see all active votes

Security & Privacy

Wallet Security:

Your private keys never leave your wallet
You only sign verification messages (no transactions)
No approval or spending permissions required

Data Storage:

Wallet addresses stored securely
Vote records are permanent (blockchain-style)
Snapshots are immutable once created

Bot Permissions:

Bot cannot access your wallet
Bot cannot move your tokens
Bot only reads balances (public data)

Common Questions

Q: Can I vote without linking a wallet? A: No, you must link a wallet to prove token ownership.

Q: What if I buy tokens after a proposal is created? A: Those tokens won't count for that proposal (snapshot already taken), but will count for future proposals.

Q: Can I vote on multiple proposals? A: Yes! Each proposal has its own snapshot and voting period.

Q: What happens if I transfer tokens after voting? A: Your vote stays the same. Voting power is locked at snapshot time.

Q: Can I delete my vote? A: No, but you can change it to a different option.

Q: Who can create proposals? A: Anyone with the threshold amount (default: 100,000 OKFUND).

Q: Who can close proposals? A: Admins, server managers, or the proposal author. Proposals also auto-close when time expires.

Q: What if quorum isn't reached? A: The proposal is considered failed, regardless of vote distribution.

Q: Can I link multiple wallets? A: No, one wallet per Discord account. Relink to change wallets.

Q: Are votes public? A: Your vote choice is private, but your participation (that you voted) is visible to admins.

Need Help?

Commands Not Working?

Make sure you've linked your wallet with /link
Check if you have sufficient balance
Verify the proposal is still active

Bot Not Responding?

Check bot status in server
Try again in a few moments
Contact server administrators

Wallet Issues?

Ensure your wallet is connected
Try signing the message again
Use /linkstatus to verify linking

Let's Govern Together!

The OK Family Fund DAO is powered by you - our token holders. Every vote matters, every voice counts.

Get Started:

Run /link to connect your wallet
Check /proposals for active votes
Make your voice heard!

Together, we build the future of OK Family Fund! 🌟

Bot Version: 2.0 | Powered by Solana | Built for the Community

PreviousGovernance Ruleset NextDAO Governance Ledger

Last updated 2 months ago

How It Works

Available Commands

🔗 /link

/linkstatus

/balance

/propose

/vote

/status

/proposals

/close

Wallet Linking Process

Step 1: Generate Your Link

Step 2: Connect Your Wallet

Step 3: Sign the Message

Step 4: Confirmation

How Snapshots Work

Voting Power Explained

Quorum Requirements

Live Results & Updates

Changing Your Vote

Proposal Lifecycle

1️⃣ Creation

2️⃣ Active Voting

3️⃣ Voting Ends

4️⃣ Results

Quick Start Guide

Tips & Best Practices

For Voters:

For Proposal Creators:

For Everyone:

Security & Privacy

Common Questions

Need Help?

Let's Govern Together!

🔗 `/link`

`/linkstatus`

`/balance`

`/propose`

`/vote`

`/status`

`/proposals`

`/close`