# Why Karma A brief introduction to why we are building Karma and Grantee Accountability Protocol ## Problem Grant programs in the crypto ecosystem lack a standardized method for grantees to publish progress updates and milestones, leading to several issues: **Limited Accessibility**: Currently, it is challenging for grant managers and the community to easily access and track project progress and milestones, as information is scattered across forums and external links. **Reputation Portability**: Grantees who apply for grants from multiple organizations struggle to establish and carry their reputation consistently across the ecosystem. This is particularly difficult for individuals who are new to the ecosystem and need opportunities to showcase their work and build their reputation. **Inadequate Data Structure**: The absence of structured data that can be accessed in a permissionless manner hampers the development of applications and analytical tools for evaluating grant impact and builder reputation. ## Solution To address the aforementioned problems, we built [GAP](https://gap.karmahq.xyz) (Grantee Accountability Protocol) where grant teams can post information about the grant and grantees can post milestones and progress updates onchain. This solves a number of problems explained below **Onchain Reporting**: Grantees will utilize the protocol to self-report their progress and milestones directly on the blockchain through [EAS](https://attest.org) (Ethereum Attestation Service). Leveraging the existing support for EAS schemas, we defined schemas tailored to various reporting needs. **Universal data access**: By storing all grant-related data onchain, we eliminate the need for manual searching and external links. We built an interface for grantees and grant teams to interact with the protocol. Communities are not obligated to use this interface but are welcome to build their own interface to present this information in interesting ways. **Enhanced Reputation Building**: Our protocol enables the linking of team member profiles to specific projects. This feature empowers team members to build and showcase their reputation for their contributions. Additionally, this reputation can be carried over to other DAOs, opening opportunities for involvement in various areas of DAO governance or similar initiatives. **Grant Farming**: It is well known in the ecosystem that there are teams who simply try to get grants and either don’t fully execute or do it with no goal of making the project a success. Having better visibility can help community and grant admins evaluate teams before issuing grants. **Facilitating Novel Applications**: With comprehensive on-chain data available, the protocol encourages the development of innovative applications. Few applications we can think of that can be built on top of this protocol are: * Grantee reputation systems * Project impact analysis tools * Signaling for future grants * Auto monitor milestones and progress updates and alert the community * Endorsing teams and team members working on projects # How does it work? High level overview of Karma system

## Project Every team (or individual) has a project profile in Karma. This profile contains everything about your project. We recommend you add a clear description of your project, details about the problem you are solving, social links and any help you need for your project. {% hint style="info" %} Projects are created only once and are not to be confused with grants received from various communities. {% endhint %} ## Grant Grant is funding you receive from an ecosystem to support your work. Every grant you receive can be linked to your Project. Grant details will include the description of the work you will be carrying out, impact details, grant amount, proposal details. ## Milestone Every grant has 1 to many milestones. We recommend creating milestones for your grant work to clearly show different phases of your grant work and path to completion of the work. Each milestone should clearly say what you plan to accomplish and how an evaluator can verify your milestone upon completion. ## Milestone Update Upon completion of a milestone, post a milestone update under that milestone. Milestone update should clearly articulate the work you have completed and provide proof of your work. This proof will be reviewed by evaluators or community members (if your community has evaluators) to verify your milestone completion. ## Grant Update Grantees can also post regular updates in-between milestones to keep the grant manager or community updated on the their progress. ## Impact If you are a builder who has created impact through your project, you can create impact attestations on Karma. These impact attestations are a great way to show your impact and qualify for future retroactive funding. # Supported Networks Karma is currently deployed on [Optimism](https://www.optimism.io/), [Arbitrum](https://arbitrum.io/), [Celo](https://celo.org/), [Scroll](https://www.scroll.io/) and [Lisk](https://www.lisk.com) networks. Any community can utilize one or more networks for their programs. Reach out to us on [Telegram](https://t.me/karmahq) if you would like us to deploy Karma on any other network. # For Builders Build Your Reputation and Showcase Your Work with Karma Karma with Grantee Accountability Protocol is here to empower you as a grantee and streamline the grant reporting process. Here's how Karma can benefit you: * Build a Strong Reputation: Create a project profile highlighting your project, its goals, and how it tackles a problem. Link your grant funding to this profile, showcasing your accomplishments and the impact you're making. This builds trust and credibility within the crypto ecosystem, increasing your chances of securing future grants. * Transparent Reporting Made Easy: Say goodbye to scattered reports and endless searching. Karma allows you to report progress directly on the blockchain. This on-chain storage ensures easy access for grant managers and the community, keeping everyone informed of your project's development. * Effortless Milestone Tracking: Break down your grant work into clear, achievable milestones. Define what you aim to achieve in each phase and set verifiable criteria for completion. As you complete milestones, submit updates with proof of work, keeping everyone on the same page. * Stay Connected with Stakeholders: Regular communication is key. Utilize Karma's grant update feature to share progress updates with the community and grant managers in between milestones. This transparency fosters trust and keeps everyone engaged in your project's journey. * Unlock New Opportunities: Karma's on-chain data paves the way for innovative applications. Imagine grantee reputation systems or tools analyzing project impact – all fueled by the data you provide. This can open doors to future grants and exciting collaborations within the DAO landscape. # Create Project Create your Karma project profile Creating a project is the first big step and you have to do this only once. Follow the steps to create your project profile. {% hint style="info" %} Don't add your grant details here. This is to just tell the entire world how awesome your project is :) {% endhint %} {% hint style="info" %} We have partnered with many grant platforms such as Gitcoin and Octant to automatically sync your project to Karma. If your project is on one of these platforms, it is highly likely that your project already exists in Karma and you won't have to create it again. {% endhint %} ### Step 1: Login The first step is to login with your wallet account. Click the Login/Register button on top right corner of the navigation bar on [Karma](https://www.karmahq.xyz/) website. ### Step 2: My Projects Navigate to "My Projects" page to check if your project already exists in Karma.

### Step 3: Check if your project exists If your project already exists, you will find it in /my-projects page. If not, before you create your project, lookup your project in the search box to see if your project exists in Karma. It is possible that the project is assigned to another wallet account you own. If it is assigned to another wallet, [reach out to us](https://t.me/karmahq) and we can transfer ownership of the project to any account address you prefer.

### Step 4: Create Project If you can't find your project, then proceed to create your project. Click on "New Project" button to create your project.

Fill in all the details and click "Create Project" button. Your project is stored onchain. You will be asked to execute an onchain transaction to complete project creation. # Add Grant to Project Once you've created your project, you can now add a grant you've received. You can add all the grants you have received from various ecosystems. This will help build your reputation. All the grants will be linked to your project Follow the steps below to add your grant ### Step 1: Add new grant Click on "Add a grant" button to start adding your grant.

View for adding first grant to a project

View for adding subsequent grants to a project

### Step 2: Add Grant Details Add your grant title and choose the community that issued a grant to you. ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2FmAmcAbNJExYOLDlLn9TM%2FScreen%20Shot%202024-05-10%20at%209.56.17%20AM.png?alt=media\&token=c137fe38-1fe2-4c03-b701-08c28da42fd4)
{% hint style="info" %} Karma supports multiple chains. We recommend choosing the community + network where your grant was issued. Example: We have Gitcoin community on both Arbitrum and Optimism. If you received a Gitcoin grant on Arbitrum network, choose "Gitcoin on Arbitrum" {% endhint %} Provide comprehensive answers to all questions regarding impact measurement. This is your opportunity to articulate to the community how your grant is making an impact. When grant managers or community members evaluate your grant, they will refer to your answers to gauge its effectiveness. # Add Milestone This is where you create milestones explaining everything you plan to accomplish through this grant. ### Step 1: Select grant to add milestone

Select your grant where you want to add your milestone and click on "Add a new milestone" ### Step 2: Add milestone details **Milestone Title**: Keep the milestone title concise, between 5 to 8 words. **Milestone Description**: Provide detailed information about the goals and objectives you aim to achieve in this milestone. Include verification criteria or guidelines to assist anyone in confirming milestone completion. **Milestone update**: If the milestone is already complete, offer details on the achievement and include verifiable proof of completion.
# Post Milestone update When you complete a milestone, you can post an update on that milestone! This is a great way to keep the community and program managers updated on your progress.

To post an update on milestone: 1. Select the grant 2. Select "Milestones and Updates" tab 3. Select "Pending" to view all pending milestones 4. Click "Post an update" to post update and mark milestone as complete. # Post grant update Occasionally, it's beneficial to keep the grant manager and community informed between milestones. There are also times when you don't have specific milestones but still wish to provide biweekly or monthly updates. The Grant Update feature is an excellent way to share your progress and maintain transparency with stakeholders.

To post a grant update: 1. Choose your grant 2. Navigate to "Milestones and Updates" 3. Click on "Post a grant update" to post updates. # Transfer Ownership **How to Manage Project Ownership in Karma** Projects in Karma are owned by an Ethereum wallet account. Sometimes when your project is automatically synced by our system, we might have made your multisig wallet the owner of the project or another cold wallet that you prefer not to use for posting updates. While Karma supports multisig login, making updates can be cumbersome. You can choose to transfer ownership of your Project to another account (EOA). Here are the options to manage or transfer project ownership effectively: 1. **Transfer Ownership to an EOA** * Log in with the multisig account. * Navigate to the project, then go to **Settings > Transfer Ownership**.![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2F7BJxr6WY3Hrf9u5yAF5O%2FKarma%20GAP%20-%20Transfer%20ownership.png?alt=media\&token=7de7c69e-1ba6-4434-ae90-9809cdac0c4a) * Follow the prompts to transfer ownership to your EOA (Externally Owned Account). 2. **Add an EOA as an Admin** * Log in with the multisig account. * Add the desired EOA as a project member. * Promote the EOA to admin by updating their role.

3. **Request Assistance** * If needed, message our team on [Telegram](https://t.me/karmahq) or [Discord](https://discord.com/invite/X4fwgzPReJ). We can assist in transferring ownership or adding an admin. # Merge projects Merge multiple projects into one unified project profile **Overview** When syncing projects from third-party grant systems, duplicate projects may be created due to slight variations in names, different wallet addresses, or other discrepancies. To streamline project management, Karma provides a **Project Merge** feature that allows project owners to consolidate duplicate projects into a single project profile. #### How It Works Project owners can merge projects by selecting a primary project (master project) and consolidating other duplicate projects into it. This ensures all project details, grants, updates, and histories are unified under a single project entry. #### Steps to Merge Projects 1. **Access Project Settings:** * Navigate to the **Project Settings** of the project you wish to merge (e.g., Project B or C). * Cick on the Merge option

2. **Select Master Project:** * Choose the target project (master project) into which the selected project should be merged (e.g., Project A).

3. **Confirm Merge:** * Click **Merge** to primary project to finalize the process. * ```

``` #### Example Scenario You have three projects: **Project A, Project B, and Project C**. If Project B and Project C are duplicates of Project A, follow these steps: 1. Navigate to **Project B** settings → Click **Merge** → Select **Project A** → Click **Merge**. 2. Navigate to **Project C** settings → Click **Merge** → Select **Project A** → Click **Merge**. After completion, **Project B and Project C** will be merged into **Project A**, consolidating all data under one unified profile. #### Benefits * Eliminates duplicate project entries. * Ensures accurate grant tracking and reporting. * Maintains a single source of truth for project updates and progress. This feature enhances project management efficiency by providing a seamless way to resolve duplication issues in Karma. # Add Team members Adding Team Members & Setting Admin Permissions This page explains how project owners can add team members to their Karma project and grant admin privileges that allow those members to manage the profile and post updates. #### Step 1: Generate an Invitation 1. Navigate to your project profile 2. Locate the "Team" section 3. Click the "Add Team Member" button to generate a unique invitation link![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2FBSMPbyDzRugZadbIdf35%2FKarma%20GAP%20-%20Add%20team%20member.png?alt=media\&token=4b849785-7dcf-4f0d-85bf-69984892f8f7) #### Step 2: Share the Invitation 1. Copy the unique URL that appears 2. Share this link with your team members via email or messaging

#### Step 3: Team Member Acceptance 1. Team members will see a confirmation page when clicking the link 2. They must accept the invitation to join your project team 3. Once accepted, they will appear in your project's team section #### Step 4: Assign Admin Privileges 1. In the team section, find the team member you want to make an admin 2. Look for the arrow icon next to their name 3. Click this arrow to grant them admin privileges 4. Admin status allows them to manage the project profile and post updates![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2F6DyXP15pFYMGsk1GhTks%2FKarma%20GAP%20-%20Make%20admin.png?alt=media\&token=8a5368c0-c28c-4c19-87a6-07b999db92de) *** *Note: Only the project owner and designated admins can manage team members and assign admin privileges.* # Login with Safe Karma supports logging in with Safe wallet. Follow the instructions in the video below to login with Safe. {% embed url="" %} # For Grant Managers What is the Grant Manager's role in Karma? * Review grant proposals: You can leverage the information grantees provide in their project profiles and grant details to assess the potential impact of their projects. * Evaluate milestone updates: Karma allows you to review milestone updates submitted by grantees, including any proof of work provided. This helps you track progress and ensure that grant funds are being used effectively. How can Karma benefit you? * Improved decision-making: By having access to a comprehensive record of a grantee's past performance and the impact of their projects, you can make more informed decisions about future grant allocations. * Increased transparency: Karma fosters transparency between grantors and grantees. You can easily track project progress and hold grantees accountable for delivering on their promises. # Verify grant update As grant manager, you can verify a milestone or grant update posted by grantee. Each verification is an onchain attestation. Follow the steps to verify an update. 1. Find the project and navigate to the grants tab.

2. Click on Milestones and Updates

3. Find the milestone you want to verify and add verification comment

![](https://lh7-us.googleusercontent.com/docsz/AD_4nXd_CbJUMsKge1vQdo-1Fy_KbZyuHaMXAagbNpnlDEG6-4ZcmFX9KKq5wlBbai_n8pQ5niAdjW18tzRhnNQ5Nn7XyNOPrVxIM7hsMgty-jhmAheFycSSGeyGfX6CV04oqPUziwhiWRPt9Dkt9BIaF5CcSQQG?key=aLB-ZcftKCNCHMjc_iNjUw)![](https://lh7-us.googleusercontent.com/docsz/AD_4nXev_DHUJASBfqz6doFLT_u5Lh1DpEMbLOTxvpDb7Obh4CvRiwKzN6OpE0IQa6afu8YUhwdheMdlYTHGEx54xFPRw64RAQRqPZufJ-URtlnHU7_45Mv0ig_WWQM4SP1jACiVMgIGjw8vU58EpYBvMKxUMIM?key=aLB-ZcftKCNCHMjc_iNjUw) 4. Anyone can view the verification comment next to the milestone

# Categorize grants Grant managers can categorize various grants issued in their community. Categorizing grants has two benefits: **Benefit 1** In the community page, anyone can view grants filtered by categories. This is useful for any community members who are interested in only certain types of projects (DeFi, NFT etc.)

**Benefit 2** Grant managers can configure questions for reviews/ratings specific to each grant category. Learn more about reviewing grants in the next section. ### Steps to categorize grants 1. Navigate to "Admin" section through the top navigation 2. Click on edit categories

3. Create category if one doesn't exist

4. All your grants will be displayed in the page. Simply select one or more categories and assign to each grant.

# Grant review Karma has the review feature that can be utilized by grant managers to review grants. Reviewing a grant involves configuring a series of questions the grantee, community members and grant operators can answer to better understand the impact of the grant. Before reviewing a grant, managers can configure the questions they would like answered. Questions can be assigned to each category of grants. To assign a question 1. Navigate to the "Assign questions" in the admin portal

2. Add a new question if required

3. Assign questions to each category and save.

# Impact Measurement Karma’s impact measurement system helps program operators define, collect, and analyze the outputs and outcomes of funded projects using standardized and custom indicators. Karma includes built-in impact measurement features that help **program operators** and **grantees** track, verify, and communicate the real-world impact of funded projects. The system is inspired by the **Common Impact Data Standard (**[**CIDS**](https://www.commonapproach.org/common-impact-data-standard)**)**, a widely used framework for structuring impact around **outputs**, **outcomes**, and **indicators**.\ Karma adapts these ideas into a **practical, onchain-native workflow** suitable for web3 programs. ### Core Concepts Before configuring impact measurement, it’s important to understand the core concepts used in Karma. #### Activities **Activities** describe what was *directly produced* by a project using the funding it received. Examples: * Code written * Features shipped * Research completed * Events organized Activities answer the question: > *“What did the grantee actually do?”* *** #### Outcomes **Outcomes** describe the *change or effect* that resulted from those outputs. Examples: * Increased network usage * Improved developer adoption * Economic growth * Environmental or social change Outcomes answer the question: > *“Why did those outputs matter?”* *** #### Indicators In Karma, the **metrics used to measure outputs and outcomes are called Indicators**. Indicators can be: * **Predefined** (automatically tracked by Karma) * **Custom** (manually reported by grantees) Indicators make impact measurable, comparable, and verifiable. *** ### Example: Activities, Outcomes, and Indicators Imagine you fund a project to build an onchain application. **Activity**\ Developer activity in your ecosystem **Activity Indicators** * GitHub commits * Pull requests merged **Outcome**\ Increased economic activity in the network **Outcome Indicators** * Number of transactions * Total Value Locked (TVL) This separation allows you to clearly see: * What work was done (outputs) * What change that work created (outcomes) ### Step-by-Step: Setting Up Impact Measurement #### Step 1: Categorize Funded Projects Programs often fund **many different types of projects**, and impact indicators are rarely one-size-fits-all.\ The first step is to categorize your projects. **How to do this** 1. Go to **Categories** in your admin dashboard

2. Click **Add Category and** add one or more categories (e.g. *Developer Tools*, *Infrastructure*, *Community*, *Research*) 3. Assign one or more categories to each funded project

> Categories determine which outputs, outcomes, and indicators are available later. #### Step 2: Define Activities, Outcomes, and Indicators Once categories are set up, you can define how impact is measured for each category. **How to do this** 1. Go to **Impact Measurement** page from admin dashboard 2. Select a **Category** 3. Add **Activities by clicking on Create Activity/Outcome button**

4. Choose a name and description (this will be displayed on impact dashboard on your community page)

5. Assign i**ndicators** from the dropdown by using the toggle**.**

6. If an indicator is not found, you can Add new custom indicator

7. Save the Activity 8. Repeat the same to add more activities or outcomes **Using Predefined Indicators** If you select a **predefined indicator**, Karma will automatically pull the data. Examples: * GitHub Commits, PRs merged * Onchain Txns **What grantees must do** * Link their GitHub repositories * Link relevant smart contracts Karma handles the data collection once links are provided. **Using Custom Indicators** If no predefined indicator fits your needs, you can create a **custom indicator**. Examples: * Number of workshops conducted * Partnerships formed * Users onboarded offchain **How it works** * Grantees manually input values * Data is submitted as part of project updates or milestone completion This gives you flexibility without losing structure. #### Step 3: View Impact at the Community Level Once impact measurement is configured and grantees begin reporting, you can view aggregated impact data. **How to do this** 1. Go to **Community Page** 2. Open the **Impact** tab Here you can see: * Activity metrics across projects * Outcomes generated by the program * Indicator values over time

*** ### How Grantees Report Impact When grantees: * Post project updates * Complete milestones They are prompted to: 1. Select relevant **Indicators** 2. Enter or confirm indicator values 3. Submit supporting context where required This ensures impact data is: * Collected continuously * Tied to real project activity * Comparable across projects and rounds *** ### Best Practices for Program Operators * **Keep indicators simple**: Fewer, high-signal metrics are better than many vague ones * **Separate outputs and outcomes clearly**: Avoid mixing activity with impact * **Reuse categories across programs/rounds**: This enables longitudinal analysis * **Default to predefined indicators where possible**: They reduce reporting burden and improve data quality ### Summary Karma’s impact measurement system allows you to: * Structure impact using industry-standard concepts * Automatically track onchain and offchain activity * Collect comparable, auditable data from grantees * Generate clear impact narratives for funders and stakeholders Impact measurement is not just reporting — it’s how programs learn, improve, and earn trust. # For Reviewers Karma funding platform supports two types of reviewers: * Application Reviewers * Milestone Reviewers # Application Review Guide Application reviewers are responsible for evaluating incoming grant applications and making approve/reject decisions. This guide walks you through the review process step by step. #### Getting Started **Step 1: Log In** Go to [www.karmahq.xyz](http://www.karmahq.xyz/) and click the **Login** button in the top right corner. **Step 2: Access Your Reviews** Click \[**Review]\(**[**https://www.karmahq.xyz/my-reviews**](https://www.karmahq.xyz/my-reviews)**)** in the header navigation. This displays all applications in the program for review. *Note: If you don't see the My Reviews link, contact your grant program administrator to ensure you've been added as a reviewer.*

#### Reviewing Applications **Step 3: Open an Application** Navigate to the program you are reviewing and click on any application to view its full details, including: * Applicant information and proposal * AI evaluation summary * Comment thread

**Step 4: Start Your Review** When you're ready to begin, click the **Start Review** button. This notifies the applicant via email that their application is under active review, helping set expectations and keep them informed.

**Step 5: Ask Questions (If Needed)** If you need clarification from the applicant, use the **Comments** section. Applicants receive email notifications when you post a comment, and you'll be notified when they respond.

#### Making a Decision **Step 6: Approve or Reject** Once you've reached a decision, click **Approve** or **Reject**. You'll be prompted to provide reasoning—we encourage you to be as detailed as possible, as this feedback is valuable to applicants regardless of the outcome. Also, confirm the final amount that is approved.

**Step 7: Applicant Notification** The applicant is automatically notified of your decision. If approved, they'll receive any post-approval instructions configured by the grant administrator. # For Community Members How can you participate in Karma? * Endorse projects: If you believe in a project and its potential impact, you can endorse it on Karma. This is a way to signal your support and help the project gain visibility. * Stay informed: Karma allows you to follow projects you're interested in and receive updates on their progress. Benefits of Karma for community members * Transparency: You gain greater insight into how grant funds are being used and the impact that projects are creating. * Discovery: Karma can help you discover new and innovative projects that align with your interests. # Endorse project Endorsing a project means publicly expressing your support for it. This is typically done because you believe the project is worthwhile and will have a positive impact. Here are some key points about endorsing a project: * **Credibility:** Your endorsement carries weight if you have relevant experience or expertise in the project's area. * **Publicity:** An endorsement can help raise awareness of the project and attract more supporters. * **Support:** It can also show the project team that you believe in them and are willing to help them succeed. Here are steps to endorse a project on the platform:

Step 1 - Navigate to the project page & choose the project

Step 3 - Add an optional message explaining why you endorsee the project.

Step 4 - Endorse - this executes an on-chain transaction and associates your endorsement with the project.

Note - You can see the endorsements on the screen here.

**Here are some other ways to spread the word:** * **Publicly announce your support.** You can do this through social media, a press release, or a speech. * **Volunteer your time or expertise.** This is a great way to show your support tangibly. * **Donate money.** If the project is fundraising, you can make a financial contribution. By endorsing a project, you can play a valuable role in helping it to succeed. # Verify grant update Community members can verify grant updates too. Follow the steps [here](/how-to-guides/for-grant-managers/verify-grant-update) to verify grant update. # Verify Impact Grantees have the ability to document the impact they have created by creating impact attestations onchain. Community members can verify that impact onchain as well. To verify impact, navigate to a project's impact tab and click verify impact button and add verification comment.

# Developers If you are a developer interested in integration of Karma into your application, you can find the APIs docs below: [API DOCS (v2)](https://gapapi.karmahq.xyz/v2/docs/static/index.html) [API DOCS (v1)](https://documenter.getpostman.com/view/36647319/2sAXxQdrkZ#48574153-51b9-46e4-b60e-aac035cb5804) - The v1 APIs are deprecated. We recommend using v2 APIs where possible. Contact our tech team on [Telegram](https://t.me/karmahq) if you have any questions. # FAQs 1. **What is the difference between a Project and a Grant in Karma?** **Project:** This is a profile for your overall work or initiative. It can encompass various grants you've received. Think of it as your permanent portfolio within Karma. **Grant:** This refers to specific funding you receive from a particular community or organization. Each grant is linked to your main project profile. 2. **I don't see my community listed on Karma. Can they still use it?** Yes! Communities can choose to implement Karma on various networks like Optimism, Arbitrum, and Celo. If your community isn't listed yet, you can encourage them to explore Karma for their grant management needs. 3. **Is my data secure on Karma?** Karma utilizes Ethereum Attestation Service (EAS) schemas for data storage. EAS leverages the security of the underlying blockchain, ensuring data integrity and immutability. Additionally, grant managers can control access permissions for specific data fields. 4. **Who can create projects on Karma?** Anyone with a compatible crypto wallet can create a project profile on Karma. This allows individuals, teams, or organizations to showcase their work and potentially attract future grant funding. 5. **How can I learn more about Karma and stay updated?** There are several ways to stay informed about Karma: * Visit the Karma [Website](https://www.karmahq.xyz/) for detailed information and resources. * Join the Karma community on [Telegram](https://t.me/karmahq) to connect with other users and get the latest updates. * Follow Karma on the [X platform](https://x.com/karmahq_) for announcements and project developments. # Partners Karma has been integrated into following platforms: * [Octant](/how-to-guides/partners/octant) - Milestones and updates posted by Octant grantees in Karma are displayed in Octant's platform. * [Gitcoin](https://grants.gitcoin.co/) - Milestones and updates posted on Karma by grantees funded by any communities who run their rounds on Gitcoin Grants Stack are displayed in Gitcoin's platform. * [Ecosystem.vision](https://ecosystem.vision/) - All the grants related data such as [Grant Programs](https://gap.karmahq.xyz/funding-map) and project grants on Karma are shown on Ecosystem's platform. # Filecoin # ProPGF Batch 1 Grantee Guide Filecoin ProPGF Grantee Guide ## Filecoin ProPGF Grantee Guide Welcome to Karma! Filecoin has partnered with Karma to manage ProPGF grants going forward. If you're a grantee from ProPGF Batch 1, this guide will walk you through everything you need to know to access your project, submit milestone updates, and stay on track with your grant. ### What's Changed? We've migrated all 14 projects and milestones from Questbook into Karma's platform. Your project information, milestones, and deliverables are already set up and waiting for you, no need to re-enter anything. You can view all Batch 1 projects here: ### Getting Started #### Step 1: Find Your Project 1. Go to 2. Browse the list to locate your project 3. Click on your project name to open your project page #### Step 2: Verify Your Admin Wallet Before logging in, confirm that we have the correct wallet address on file: 1. On your project page, you can see the wallets in the team section

2. Make sure this matches the wallet address you shared with the Filecoin team during your grant application > **Important:** Only the wallet listed as Admin can log in and submit updates for your project. If the wallet address doesn't match yours, please contact the Filecoin team to get it corrected. #### Step 3: Log In to Karma 1. Click the **Login** button (located in the top-right corner of the page). 2. Connect with the wallet account that matches your Admin address. 3. Sign the authentication message when prompted, this verifies you own the wallet. Once logged in, you'll have full access to manage your project and submit milestone updates. *** ### Submitting Milestone Updates After logging in, follow these steps to post a milestone completion update: #### Step 1: Navigate to the Funding Tab 1. From your project page, click on the **Funding** tab in the navigation menu and select Batch 1 grant. 2. This tab displays all your milestones, their current status, and funding details #### Step 2: Find Your Milestone 1. Review the list of milestones imported from Questbook 2. Locate the milestone you've completed or made progress on 3. Each milestone will show its title, description, and current status #### Step 3: Post Your Update 1. Click on the milestone you want to update 2. Select the option to **Post Milestone Completion Update** (or similar button) 3. Fill in the required information: * **Summary of work completed:** Describe what you accomplished * **Evidence of completion:** Include links to deliverables, demos, documentation, repositories, or any proof of work * **Any relevant notes:** Add context that reviewers should know 4. Review your submission for accuracy 5. Click **Submit** to post your update For a detailed visual walkthrough, refer to our [Milestone Completion Update Guide](https://docs.karmahq.xyz/). ### Tips for Successful Updates * **Be specific:** Clearly describe what was delivered and how it meets the milestone requirements * **Include proof:** Link to tangible outputs—GitHub repos, deployed applications, documentation, demos, or reports * **Update regularly:** Don't wait until the last minute; post updates as you make meaningful progress ### Troubleshooting #### The Admin wallet doesn't match mine Reach out to the Filecoin team with your correct wallet address. They'll work with Karma to update your project's admin settings. #### My milestones don't look right If any milestone information appears incorrect or incomplete after the migration, contact the Filecoin team to request corrections. ### Need Help? If you run into any issues or have questions not covered in this guide: * **For Karma platform questions:** Contact us on [Telegram](http://t.me/karmahq) or reach out via the Filecoin support channels * **For ProPGF grant questions:** Contact the Filecoin team through your usual communication channels We're excited to support your work on Filecoin. Good luck with your milestones! # ProPGF Grantee Guide Filecoin ProPGF Grantee Guide Filecoin ProPGF Grantee Guide Welcome! As a grantee, this guide will walk you through everything you need to know to access your project, submit milestone updates, and stay on track with your grant. ### Getting Started #### Step 1: Log In to FilPGF 1. Go to 2. Click the **Login** button (located in the top-right corner of the page) and enter your email address you used to submit the application. {% hint style="warning" %} If you don't find your application when you login, you will find a link to lookup your application by the reference ID (it looks like APP-XXXXXXXX-XXXXXX). If you're still unable to log in, contact the Karma team on Telegram or email {% endhint %} #### Step 2: Find Your Application 1. Once logged in, navigate to **Dashboard** 2. You'll see your approved grant application listed under My Applications section 3. Click on your application to open your project page {% hint style="info" %} Your project information and milestones have already been set up based on your approved application — no need to re-enter anything. {% endhint %} *** ### Submitting Milestone Updates After logging in and locating your application, follow these steps to post a milestone completion update: #### Step 1: Navigate to Your Milestones 1. From your project page, click on the **Milestones** section 2. This displays all your milestones, their current status, and funding details

#### Step 2: Find Your Milestone 1. Review the list of milestones defined in your approved application 2. Locate the milestone you've completed or made progress on 3. Each milestone will show its title, description, and current status #### Step 3: Post Your Update 1. Click on the milestone you want to update 2. Select the option to **Add Completion Update** 3. Fill in the required information: * **Summary of work completed:** Describe what you accomplished * **Evidence of completion:** Include links to deliverables, demos, documentation, repositories, or any proof of work * **Any relevant notes:** Add context that reviewers should know 4. Review your submission for accuracy 5. Click **Submit** to post your update #### Step 4: Submiting your invoice and payments 1. Once the milestone is completed, upload the invoice right in the dashboard 2. A reviewer will review the milestone and notify the admins 3. The admins release payment upon successful verification of milestone 4. You will receive email notification when payment is complete Have additional questions regarding the invoice or payment process? You can contact our team by email at . *** ### Tips for Successful Updates * **Be specific:** Clearly describe what was delivered and how it meets the milestone requirements * **Include proof:** Link to tangible outputs — GitHub repos, deployed applications, documentation, demos, or reports * **Update regularly:** Don't wait until the last minute; post updates as you make meaningful progress *** ### Troubleshooting #### I don't see my application After logging in, make sure you're on the **My Applications** tab. If your application doesn't appear, most likely you submitted your application with a different email address. You can lookup your application on the dashboard to find the email you used to login. If you still have trouble, reach out to the Karma on [Telegram](https://t.me/karmahq) or #### My milestones don't look right If any milestone information appears incorrect or incomplete, contact the Filecoin team to request corrections. *** ### Need Help? If you run into any issues or have questions not covered in this guide: * **For platform questions:** Contact us on [Telegram](http://t.me/karmahq) or reach out via the Filecoin support channels * **For ProPGF grant questions:** Contact the Filecoin team through your usual communication channels We're excited to support your work on Filecoin. Good luck with your milestones! # Milestone Reviewer Guide Milestone reviewers are responsible for verifying that grantees have completed the milestones defined in their approved grants. This guide walks you through the milestone review process step by step. ### Getting Started #### Step 1: Log In Go to [app.filpgf.io](https://app.filpgf.io/) and log in with email. You must be logged in with the same account that was assigned the milestone reviewer role.

#### Step 2: Access Your Reviews Click [**Dashboard**](https://app.filpgf.io/dashboard) in the header navigation to open your reviewer dashboard. You will see a list of communities and programs where you have been assigned as a reviewer. Look for the **View Milestones** button next to programs where you are a milestone reviewer. Click it to open the milestones report.

### Reviewing Milestones #### Step 3: Open a Project's Milestones From the milestones report, select a project to review. The milestone review page shows all milestones for that project, organized by status: * **Not Started** — The grantee has not yet submitted completion for this milestone. * **Pending Completion** — The grantee has submitted off-chain completion details, but onchain completion has not been recorded yet. * **Pending Verification** — The grantee has completed the milestone onchain and it is ready for your review. * **Verified** — The milestone has already been verified by a reviewer. Milestones that need your attention (Pending Verification) appear first, sorted by due date.

#### Step 4: Review Milestone Details For each milestone, you can see: * **Title and description** — What the grantee committed to deliver. * **Due date** — When the milestone was expected to be completed. * **Allocation amount** — The funding amount allocated to this milestone (if applicable). * **Completion details** — The grantee's description of what they accomplished, along with the submission date. This is labeled as either "On-chain" or "Off-chain" depending on how it was submitted. * **AI Evaluation** — Click the **AI Evaluation** button to view an AI-generated assessment of the milestone completion. The evaluation includes a rating (1–10) and detailed reasoning.

#### Step 5: Use Comments to Communicate The comments panel on the right side of the page lets you communicate with the grantee and other reviewers. Use comments to: * Ask the grantee for clarification or additional proof of work. * Discuss the milestone with other reviewers. * Leave notes about your assessment. You can **@mention** other reviewers to notify them directly. All comment participants receive email notifications.

### Verifying Milestones #### Step 6: Verify a Milestone When you are satisfied that a milestone has been completed, click the green **Verify Milestone** button. A verification form will appear where you can: 1. Add an optional **verification comment** explaining your assessment. 2. Click **Verify** to submit your verification.

# UNICEF The UNICEF Venture Fund provides funding to projects on a biannual basis. Funded projects are required to create a Karma project profile, add funding details, define milestones, and share progress updates regularly. Below you'll find step-by-step instructions for completing each of these tasks. ## Follow the step by step instructions ### Step 1: Create your project profile **Use your email address or google oauth to login to Karma. Your project information is stored on blockchain. Karma will pay the blockchain fees on your behalf.** Follow the instructions [here](/how-to-guides/for-builders/create-project) to create your onchain project profile. You only need to create this once and can reuse it for future funding rounds. This public profile allows supporters to learn about your project, follow your progress, endorse your work, and contact you. {% hint style="info" %} The title of your project should just be project name. It should not include the grant name because this is a profile you can use in the future for other funding opportunities. {% endhint %} ### Step 1.1: Add your contact info During project creation or when updating your project, you can add or edit your contact information. Please ensure this is complete, as it will be used for important communications.

### Step 2: Add your funding details Next, add details about the funding you received from UNICEF. 1. Navigate to the **Funding** tab in your project, click **Add Funding**, and select **I want to add a grant**

2. Select UNICEF Venture Fund community from dropdown and choose the appropriate program. 3. Add milestones describing what you plan to accomplish. You can add as many milestones as needed. ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2F1DMjWWh55xAZenNd9hUg%2FKarma%20GAP%20-%20Add%20milestones.png?alt=media\&token=9f96c83d-0dac-450d-b6a4-118f55c62121) 4. Click create and an onchain transaction will be executed. ### Step 3: Submit milestone updates As you complete your work, submit updates for each milestone and mark them as complete.

### Step 4: Final project submission At the end of the funding cycle, mark the grant as complete and submit a link to all assets (such as logos, screenshots, and other deliverables).

# Octant [**Octant**](https://octant.app/projects) **has integrated Karma into their application.** Project milestones added in Karma will now be automatically displayed on the corresponding project pages in Octant. For example, here is a project on [Karma](https://gap.karmahq.xyz/project/-buidlguidl/grants/0x674ed25e9616b5c4237c6295b87f32cca42e74e7cc087e071a9c80c4e279fe91/milestones-and-updates) with milestones that are also visible in [Octant](https://octant.app/project/5/0x00080706a7D99CBC163D52dcF435205B1aD940D1), ensuring seamless updates and visibility in both platforms.

**If you don't see your Epoch specific milestones in Octant, follow the steps below to link Karma grant to Octant's Epoch.** ## Step 1 Login to your Karma profile and navigate to your Octant Epoch grant and click on the "Link Octant Address" button.

## Step 2 Enter the wallet address you used to sign up for that specific Octant Epoch and save.

You should now be able to see your milestones in Octant application. **If you still don't see the milestones, contact us on** [**Telegram**](https://t.me/karmahq) **or** [**Discord**](https://discord.com/invite/X4fwgzPReJ) **and we will be glad to assist you.** # Gitcoin [Gitcoin](https://grants.gitcoin.co/) **has integrated Karma into their application.** Project milestones added in Karma will now be automatically displayed on the corresponding project pages in Gitcoin. For example, here is a project on[ Karma](https://gap.karmahq.xyz/project/karma---gap/grants/0xe7390a6f68ff70e0f7cda461079f92dad0150003e7ec541c7fb9e55e912211c0/milestones-and-updates) with milestones that are also visible in [Gitcoin](https://explorer.gitcoin.co/#/round/42161/608/117), ensuring seamless updates and visibility in both platforms.

# Celo - Proof of Ship Instructions for submitting your project for Celo - Proof of Ship program Proof-of-Ship is a monthly contest that rewards builders for actively building on Celo. The impact metrics in your Karma project profile are used to automtically calculate builder rewards, which you can claim each month [here](https://celo.builderscore.xyz/). Before creating a project profile, ensure you have: \- A wallet compatible with the Celo network, such as Rabby, Rainbow, MetaMask \- You need CELO tokens to pay for transactions. If you don't have any CELO tokens, Karma platform will sponsor your first 5 transactions. You will claim tokens in the project creation flow. ## Follow the steps below to Submit your project for Proof of Ship program ### Step 1: Add your project profile Add your project to Celo [Proof of Ship Program](https://gap.karmahq.xyz/community/celo) on [Karma](https://www.karmahq.xyz/). You can follow the instructions [here](/how-to-guides/for-builders/create-project). This is your onchain project profile you create one time and can use it to apply for future rounds. You can also point anyone to learn about your project, receive endorsements and donations. **If you participated in a previous season, you might already have a project profile. You can skip to Step 2. Contact our team if you have trouble accessing your profile here:** [**https://t.me/karmahq**](https://t.me/karmahq) {% hint style="info" %} The title of your project should just be project name. It should not include "Proof of Ship" because this is a profile you can use in the future for other funding opportunities. {% endhint %} ### Step 1.1: Add your contact info In the project creation flow and project update flow, you can update your contact info. Please make sure to add your contact info. This is how organizers will contact you for future communication regarding important updates.

### Step 1.2: Update your public profile Go to My Profile and update your profile. This is public profile info which is stored onchain. You can go to your profile from "My Profile" by clicking on your avatar in the header as shown below.

### Step 2: Submit your project for Proof of Ship To submit your project for proof of ship, follow the steps below 1. Navigate to grants tab in your project and click Add Funding and select "Join Funding Program".

2. Select Celo community from dropdown and choose Proof of Ship program you are applying to. Also, select the tracks you are interested in participating

### Step 3: Submit your github repo(s), contract addresses, payout address and divvi profile id Click on project settings and add your Github repos, contract addresses and divvi profile id. ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2FhNpKQUQ0jkGA9AWyLVSD%2FScreenshot%202025-06-11%20at%208.24.29%E2%80%AFAM.png?alt=media\&token=a7010467-dd7e-418c-a28e-e5df20fe0f6e) ### Step 4: Submit milestone updates As you complete your work, submit milestones and mark them as complete.

### Step 5: Final project submission 1. At the end of the month, mark the grant as complete and submit a link to all assets ex: logo, screenshots etc.:

2. Add a link to Video explaining your work (4 min max) and link to your Presentation (not more than 10 slides) in project profile.

# CeloPG - Proof of Impact Instructions for submitting your project for Celo - Proof of Ship program The Proof of Impact campaign, powered by CeloPG, rewards builders based on the gas fees their users generate on the Celo network. ## Follow the steps below to Submit your project for Proof of Impact program ### Step 1: Add your project profile Add your project to Celo [Proof of Impact Program](https://gap.karmahq.xyz/community/celopg?programId=918_42161) on [Karma](https://www.karmahq.xyz/). You can follow the instructions [here](/how-to-guides/for-builders/create-project). This is your onchain project profile you create one time and can use it to apply for future rounds. You can also point anyone to learn about your project, receive endorsements and donations. **If you participated in a previous season, you might already have a project profile. You can skip to Step 2. Contact our team if you have trouble accessing your profile here:** [**https://t.me/karmahq**](https://t.me/karmahq) {% hint style="info" %} The title of your project should just be project name. It should not include "Proof of Ship" because this is a profile you can use in the future for other funding opportunities. {% endhint %} ### Step 2: Submit your project for Proof of Impact To submit your project for proof of impact, follow the steps below 1. Navigate to Funding tab in your project and click Add Funding and select "Join Funding Program".

2. Select Celo PG community from dropdown and choose Proof of impact program you are applying to.

3. Add milestones explaining what you plan to accomplish. You can add as many milestones as you like. ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2F1DMjWWh55xAZenNd9hUg%2FKarma%20GAP%20-%20Add%20milestones.png?alt=media\&token=9f96c83d-0dac-450d-b6a4-118f55c62121) 4. Click create and an onchain transaction will be executed to submit your entry to Proof of Ship program. ### Step 3: Submit your github repo(s), contract addresses and divvi profile id Click on project settings and add your Github repos, contract addresses and divvi profile id.![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2FlqnLYsbzG6p48k09RbAm%2FScreenshot%202025-05-13%20at%204.18.48%E2%80%AFPM.png?alt=media\&token=e3717531-7f75-4d0d-b9ad-b0cd12a49390) ### Step 4: Submit milestone updates As you complete your work, submit milestones and mark them as complete.

### Step 5: Final project submission 1. At the end of the month, mark the grant as complete and submit a link to all assets ex: logo, screenshots etc.:

2. Add a link to Video explaining your work (4 min max) and link to your Presentation (not more than 10 slides) in project profile.

# Global Stablecoin Hackathon Instructions for submitting your project for Global Stablecoin Hackathon Global Stablecoin Hackathon is a 3-week virtual hackathon from April 11 to May 2 with $25K prize pool! ## Follow the steps below to Submit your project for Global Stablecoin Hackathon ### Step 1: Add your project profile Add your project to [Global Stablecoin Hackathon](https://gap.karmahq.xyz/community/celo?programId=889_42161) on [Karma](https://www.karmahq.xyz/). You can follow the instructions [here](/how-to-guides/for-builders/create-project). This is your onchain project profile you create one time and can use it to apply for future rounds. You can also point anyone to learn about your project, receive endorsements and donations. **If you participated in any of the Celo's past funding programs, you might already have a project profile. You can skip to Step 2. Contact our team if you have trouble accessing your profile here:** [**https://t.me/karmahq**](https://t.me/karmahq) {% hint style="info" %} The title of your project should just be project name. It should not include "Global Stablecoin or Hackathon" because this is a profile you can use in the future for other funding opportunities. {% endhint %} ### Step 2: Submit your project for Global Stablecoin Hackathon To submit your project for the hackathon, follow the steps below 1. Navigate to Funding tab in your project and click Add Funding and select "Join Funding Program".

2. Select Celo community from dropdown and choose Global Stablecoin Hackathon program you are applying to. Also, select the tracks you are interested in participating.

3. For Start Date, choose today's date (the date you are applying) and add optional description 4. Add milestones explaining what you plan to accomplish. You can add as many milestones as you like. ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2F1DMjWWh55xAZenNd9hUg%2FKarma%20GAP%20-%20Add%20milestones.png?alt=media\&token=9f96c83d-0dac-450d-b6a4-118f55c62121) 5. Click create and an onchain transaction will be executed to submit your entry to the hackathon. ### Step 3: Update your personal profile On project profile page, click edit your profile and add all your profile details. {% hint style="info" %} This is a mandatory step for this hackathon {% endhint %} ![](https://2439776882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgbP24tpFK3mCnbIq4rF%2Fuploads%2FRKRW6sksjQDco5ugvGcn%2FScreenshot%202025-03-27%20at%2011.34.34%E2%80%AFAM.png?alt=media\&token=6705ec25-cee2-4a19-9d4e-a599eb2f0950) ### Step 4: Submit your github repo(s) and contract addresses Click on project settings and add your Github repos, contract addresses and optionally OpenSourceObserver profiles if you have a profile on OSO.

### Step 5: Submit milestone updates As you complete your work, submit milestones and mark them as complete.

### Step 6: Final project submission 1. At the end of the month, mark the grant as complete and submit a link to all assets ex: logo, screenshots etc.:

2. Add a link to Video explaining your work (4 min max) and link to your Presentation (not more than 10 slides) in project profile.