# Realms 有代币却没有治理票权：核对 community、council、存款与插件

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/realms-governing-token-voter-weight-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从 V2 Settings 和已有治理账户记录定位投票人口、治理 mint、TokenOwnerRecord、委托与插件权重，避免把钱包余额当可投票数或误操作退回治理存款。

## 使用工具
- [Realms](https://lianxiaozhi.com/tools/realms) · [官方入口](https://v2.realms.today/)

## 前置条件
- 准备目标 DAO 的 Realm 地址、具体 Governance/Proposal 地址、自己的完整公开 Solana 地址及已有公开账户解码记录；仅需要公开标识。
- 打开官方 V2 对应 DAO 的 Settings；已有 My governance power 可作辅助展示。没有现成钱包连接时，使用公开记录或向 DAO 取得去敏解码，不为本排查连接、导入、签名或发送 Deposit/Withdraw。
- V2 界面帮助页与 SPL Governance 3.1.0 固定源码分开使用；实际治理程序不是匹配版本时，按其实现重新确认字段和条件。

## 1. 从 Settings 记录 Realm 与治理程序

进入 https://v2.realms.today/ 对应 DAO 的 Settings，记录 Realm Pubkey、Owner Governance Program、Community Mint 和 Council Mint；再记录这次提案所属 Governance。一个 Realm 可能有多个治理实例，不能拿其他 Treasury 的门槛解释当前提案。

Realm Authority 是管理配置的身份，不等于你的钱包或可投票代币。DAO 名称相同、地址不全或程序 owner 不一致时，先确认完整地址与程序；无法打开的页面不解释为 DAO 消失。

核对结果：Realm、程序、两种 mint 和具体 Governance 都来自同一 DAO 的配置。
依据：[Realms V2：界面、治理权与 DAO 钱包](https://docs.realms.today/realms-v2/v2-interface)
依据：[Realms V2：Settings 地址、代币类型与插件](https://docs.realms.today/realms-v2/dao-creation-wizard/configurations)
依据：[Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)

## 2. 确定提案使用哪一类治理代币

在已有 Proposal 解码中读取 governing_token_mint，逐字对照 Community/Council Mint。提案创建选了 vote by council，就不能用 community 的钱包余额回答本次票权；multisig DAO 还可能只启用 council。

代币名称、图标或钱包总估值不是 mint 身份。Liquid、Disabled、Membership 的配置也不同，Disabled 群体没有普通票权，Membership 可能由 DAO 撤销。记录真实配置，不把另一个 mint 的资产存进去试错。

核对结果：已识别本提案投票人口和完整 mint；另一人口的余额/权限分开保留。
依据：[Realms V2：界面、治理权与 DAO 钱包](https://docs.realms.today/realms-v2/v2-interface)
依据：[Realms V2：Settings 地址、代币类型与插件](https://docs.realms.today/realms-v2/dao-creation-wizard/configurations)
依据：[Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)

## 3. 对齐 owner、delegate 与默认存款记录

读取对应 TokenOwnerRecord 的 realm、governing_token_mint、governing_token_owner、deposit_amount、governance_delegate，确认前三项匹配。deposit_amount 是治理存款的原始整数；若展示人类可读数量，要先确认该 mint 的 decimals，不直接当 SOL。

默认无 voter weight 插件时，票权由治理存款决定，钱包尚未存入的币不自动计入。若当前操作身份是 delegate，核对记录中的具体地址；委托是投票/治理授权，不能据此宣称底层资产所有权或可由 delegate 任意取回。找不到记录时先区分未存入、错误 mint/owner 和解码版本不匹配。

核对结果：TokenOwnerRecord 对应正确 owner/mint/Realm，存款与钱包余额及委托身份没有混用。
依据：[Realms 官方固定 3.1.0：TokenOwnerRecord 与退回限制](https://raw.githubusercontent.com/Mythic-Project/solana-program-library/7b90ecfa9fbaa19eb18067a6a50587caa73ad3c6/governance/program/src/state/token_owner_record.rs)
依据：[Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)

## 4. 有插件时核对插件记录而非强制存币

在 Realm 的高级配置查看 voter weight/max voter weight addin；按启用插件核对 Registrar 的 Realm、治理程序和 mint，及已有 VoterWeightRecord 的所属插件、计算输入和有效范围。NFT 权重、VSR 锁仓等与默认 liquid deposit 不同，多插件链还要核对最后采用的插件。

requiresInputVoterWeight=false 可以让界面不要求 deposit，但不是忽略所有链上资格检查。若记录缺失、过期、对应其他行动/目标或插件程序不匹配，权重不能直接沿用。概念文档列 QV/Civic，而当前 V2 配置页注明 disabled；不要按旧介绍假定今天能从界面创建它们。

核对结果：默认存款或实际插件路径已确定；缺失/无效记录明确标为待查，未用概念列表代替启用配置。
依据：[Realms V2：Settings 地址、代币类型与插件](https://docs.realms.today/realms-v2/dao-creation-wizard/configurations)
依据：[Realms：Voter Weight 插件记录与输入边界](https://docs.realms.today/developer-resources/plugins-v1/voter-weight-plugin)
依据：[Realms 官方固定 3.1.0：TokenOwnerRecord 与退回限制](https://raw.githubusercontent.com/Mythic-Project/solana-program-library/7b90ecfa9fbaa19eb18067a6a50587caa73ad3c6/governance/program/src/state/token_owner_record.rs)

## 5. 把资格缺口与投票阶段分别记录

查看提案实际状态与已有签署/投票记录：Draft/SigningOff 尚不是普通 Voting；SignOff 是使提案进入投票的流程，不等于支持票。进入 Voting 后，还要按当前 Governance 的投票时间、门槛和可能的 cool-off 限制判断可选动作。

有存款或插件票权也不能覆盖错误阶段、已委托给另一身份或已有投票的限制。将结论具体写成“council 提案但只有 community 存款”“对应插件记录缺失”或“尚在 SigningOff”；未读目标状态时保留未知，不承诺按钮可点击。

核对结果：票权来源、操作身份、提案阶段及当前配置分别说明，有明确缺口而非笼统零余额。
依据：[Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)
依据：[Realms 官方固定 3.1.0：TokenOwnerRecord 与退回限制](https://raw.githubusercontent.com/Mythic-Project/solana-program-library/7b90ecfa9fbaa19eb18067a6a50587caa73ad3c6/governance/program/src/state/token_owner_record.rs)
依据：[Realms V2：界面、治理权与 DAO 钱包](https://docs.realms.today/realms-v2/v2-interface)

## 6. 检查退回限制和后续交易成本

若排查涉及“存入的币怎么取回”，先读记录中的 unrelinquished_votes_count 和 outstanding_proposal_count。固定 3.1.0 要求两者为零；投票结束并不自动清掉所有记录，Membership 等配置还需相应规则，不能凭等待时间保证 Withdraw 可用。

如需实际 Deposit、投票、委托或 Withdraw，应先确认应用请求、对应人口/账户和当前 SOL 交易费。把治理代币存款、可能的提案存款和 SOL 网络费分开；此核对流程不以发送一笔试错交易作为完成条件。

核对结果：形成票权与退回条件清单；未知费率不填固定费用，缺少现场记录不宣称可投或已取回。
依据：[Realms 官方固定 3.1.0：TokenOwnerRecord 与退回限制](https://raw.githubusercontent.com/Mythic-Project/solana-program-library/7b90ecfa9fbaa19eb18067a6a50587caa73ad3c6/governance/program/src/state/token_owner_record.rs)
依据：[Realms V2：Settings 地址、代币类型与插件](https://docs.realms.today/realms-v2/dao-creation-wizard/configurations)
依据：[Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)
依据：[Solana：交易基础费、优先费和 SOL](https://solana.com/docs/core/fees)

## 常见错误
- 把 Council Mint 与 Community Mint 的资产相加作为同一提案票权。
- 所有 DAO 都先 Deposit；插件配置可能采用不同输入及权重计算。
- 投票结束就认为存款能取回，或认为 delegate 就是资产持有人。

## 完成检查
- 保存 Realm/程序/Governance、提案 mint、TokenOwnerRecord、delegate 和实际插件记录的对应关系，能说明已证实的资格缺口。
- 本教程依据官方正文与固定 3.1.0 源码，未连接钱包、存入/退回资产或取得实时投票资格验收。缺少记录和部署差异保留未知。

## 相关知识
- [治理提案通过就是生效了吗？从投票追到执行交易](https://lianxiaozhi.com/learn/governance-proposal-status)

## 官方依据
- [Realms V2：界面、治理权与 DAO 钱包](https://docs.realms.today/realms-v2/v2-interface)
- [Realms V2：Settings 地址、代币类型与插件](https://docs.realms.today/realms-v2/dao-creation-wizard/configurations)
- [Realms：SPL Governance 3.1.0 生命周期与账户](https://docs.realms.today/developer-resources/spl-governance)
- [Realms：Voter Weight 插件记录与输入边界](https://docs.realms.today/developer-resources/plugins-v1/voter-weight-plugin)
- [Realms 官方固定 3.1.0：TokenOwnerRecord 与退回限制](https://raw.githubusercontent.com/Mythic-Project/solana-program-library/7b90ecfa9fbaa19eb18067a6a50587caa73ad3c6/governance/program/src/state/token_owner_record.rs)
- [Solana：交易基础费、优先费和 SOL](https://solana.com/docs/core/fees)
