# Karma 找不到正确资助记录：核对项目、community、网络与 UID 引用

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

从本人已有项目和资助材料建立正确身份关联，排查同名、跨网络和旧SDK引用差异。

## 使用工具
- [Karma（GAP 资助记录）](https://lianxiaozhi.com/tools/karma-gap) · [官方入口](https://www.karmahq.org/)

## 前置条件
- 已有本人/授权非敏感项目与grant记录：项目身份/链接、社区和网络、grant标题、已有UID或数据库标识、记录时点；不登录或新查真实项目。
- 若有GAP/EAS导出保留chainID/schemaUID/refUID/UID及来源版本；固定SDK0.4.29只解释匹配的旧记录，不能替代当前.org接口。

## 1. 先确定当前产品与记录版本

当前官方品牌是Karma，官网提供更广的资金项目管理；GAP docs描述EAS资助记录，固定包@show-karma/karma-gap-sdk为0.4.29。把当前界面材料、旧GAP导出和固定SDK对象分列，不假定字段或菜单完全一致。

旧Create Project文档仍引用.xyz及2024截图。已有材料不含链上UID时，不根据“onchain”宣传自行生成或猜字段，也不把当前官网AI预评分当资助已获批。

核对结果：产品、来源版本、链上/数据库记录范围明确。
依据：[Karma 当前官网产品与付款 FAQ](https://www.karmahq.org/)
依据：[Karma GAP 当前文档架构与自报边界](https://docs.gap.karmahq.xyz/overview/why-karma.md)
依据：[Karma GAP SDK固定0.4.29版本](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/package.json)
依据：[Karma 项目查重与已有所有权](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/create-project.md)

## 2. 以 Project 身份查重，而非 Grant 标题

Project是总体工作档案，Grant是某社区的一次资助，项目可关联多份grant。先用已有项目ID/UID、owner资料和链接查对原档案，不把每次申请标题当新Project。

文档称Gitcoin/Octant可能已自动同步项目；My Projects没出现也可能属于另一自身钱包。只根据已有材料标“可能同项目/待确认”，不能为验证而再创建项目或变更所有权。

核对结果：Project与多份Grant分开，同名/不同钱包情况未自动合并。
依据：[Karma Project/Grant/Milestone/Update结构](https://docs.gap.karmahq.xyz/overview/how-does-it-work.md)
依据：[Karma 项目查重与已有所有权](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/create-project.md)

## 3. 同时核对 community 与网络

在已有grant记录抄下发放community和network。文档举Gitcoin在Arbitrum/Optimism均有community：Arbitrum上的grant应关联“Gitcoin on Arbitrum”，不能仅按Gitcoin名字合并到OP记录。

当前GAP Supported Networks列OP Mainnet、Arbitrum、Celo、Scroll、Lisk；它不证明当前.org所有付款渠道或该项目部署在全部链。网络未知时保留未知，不用项目所在生态代替记录链。

核对结果：community+network有实际材料，目录生态名没有冒充部署范围。
依据：[Karma Grant对应community和网络](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/add-grant-to-project.md)
依据：[Karma GAP 当前支持网络正文](https://docs.gap.karmahq.xyz/overview/supported-networks.md)

## 4. 按已有 UID/refUID 还原层级

仅对匹配GAP旧结构的已有导出，检查Grant.refUID→Project.uid、Grant.data.communityUID→Community.uid；Milestone和GrantUpdate分别refUID→Grant.uid。每条还需chainID/schemaUID/type与时点，不能把网页slug当链上UID。

固定gap-schema.yaml另有offchain_program_registry/milestone_evaluations等数据库实体；不是每个自定义类别、AI评价或当前付款字段都能套EAS关系。缺关系原记录时停止自动连接，不拿同名项目补引用。

核对结果：项目、社区、grant及子记录引用有对应版本支持。
依据：[Karma GAP 固定数据关系与旧Schema命名](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/gap-schema.yaml)
依据：[Karma GAP固定Grant身份与缺引用错误](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/core/class/entities/Grant.ts)
依据：[Karma Project/Grant/Milestone/Update结构](https://docs.gap.karmahq.xyz/overview/how-does-it-work.md)

## 5. 排查成员权限和缺引用错误

已有team记录分别列owner、已接受成员和admin权限；文档成员接受邀请才出现，赋admin是另一步。项目团队权限与资助方审核或Safe付款签名资格不同，不能互相推断。

若原错误确来自固定SDK assertPayload，INVALID_REFERENCE表示缺details或communityUID；它不是任意当前接口失败的统一解释。接口版本、错误正文或引用资料缺失就标未知，不靠新邀请/授权或运行SDK试错。

核对结果：角色和错误属于明确动作/版本，普通成员不自动当付款管理员。
依据：[Karma 项目成员和Admin权限](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/add-team-members.md)
依据：[Karma GAP固定Grant身份与缺引用错误](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/core/class/entities/Grant.ts)

## 6. 整理记录关联与独立资金证据

把Project身份→community/network→grant→milestone/update写成一条可复查关系，标每项原时点和字段缺口。Grant金额、proposal和impact回答是记录材料，不直接证明资助方认可其全部事实。

真实资助到账另需已有付款凭证；当前官网支持Safe执行或外部支付手动记录，grant profile存在或金额填写不能代替这些证据。结果只定位身份/引用问题，不承诺自动补登或支付。

核对结果：关联层级明确，资助档案和实际付款分开。
依据：[Karma Project/Grant/Milestone/Update结构](https://docs.gap.karmahq.xyz/overview/how-does-it-work.md)
依据：[Karma Grant对应community和网络](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/add-grant-to-project.md)
依据：[Karma 当前官网产品与付款 FAQ](https://www.karmahq.org/)

## 常见错误
- 旧SDK类型、网页slug和链上UID不同，不能只凭名称或字节长度合并。
- GAP支持链表只证明文档所述范围，不覆盖.org全部产品/支付。

## 完成检查
- 项目/社区/网络与grant关联可由已有材料复查。
- 缺字段、版本或付款证据明确未知；未创建项目/会话/证明或修改角色，全documentation。

## 相关知识
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [合约代码已验证，为什么仍不能直接判断安全？](https://lianxiaozhi.com/learn/verified-contract-boundaries)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)

## 官方依据
- [Karma 当前官网产品与付款 FAQ](https://www.karmahq.org/)
- [Karma GAP 当前文档架构与自报边界](https://docs.gap.karmahq.xyz/overview/why-karma.md)
- [Karma GAP SDK固定0.4.29版本](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/package.json)
- [Karma 项目查重与已有所有权](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/create-project.md)
- [Karma Project/Grant/Milestone/Update结构](https://docs.gap.karmahq.xyz/overview/how-does-it-work.md)
- [Karma Grant对应community和网络](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/add-grant-to-project.md)
- [Karma GAP 当前支持网络正文](https://docs.gap.karmahq.xyz/overview/supported-networks.md)
- [Karma GAP 固定数据关系与旧Schema命名](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/gap-schema.yaml)
- [Karma GAP固定Grant身份与缺引用错误](https://raw.githubusercontent.com/show-karma/karma-gap-sdk/00a202a0e9eb8904086d11b3353a18918f145b99/core/class/entities/Grant.ts)
- [Karma 项目成员和Admin权限](https://docs.gap.karmahq.xyz/how-to-guides/for-builders/add-team-members.md)