Create Project with Grant

Create a new project and attach a grant in a single on-chain transaction. This creates 4 attestations: Project + ProjectDetails + Grant + GrantDetails.

Use this instead of separate create-project + create-grant when the user wants to set up a project with its funding in one step.

See Agent API Reference for auth, base URL, and error handling.

Prerequisite

If KARMA_API_KEY is not set in the environment, invoke the /setup-agent skill first, then continue with this skill.

Required Information

Project fields:

Field	Required	Description
chainId	Yes	Which blockchain
title	Yes	Project name (1-200 chars)
description	Yes	Project description (1-5000 chars)
imageURL	No	Project logo/image URL
links	No	Array of { type, url }
tags	No	Array of tag strings (max 20)
communityUID	Yes	The community/program UID that funded the project

Grant fields (nested under grant):

Field	Required	Description
grant.title	Yes	Grant title (1-200 chars)
grant.description	No	Grant description (max 5000 chars)
grant.amount	No	Funding amount as string
grant.proposalURL	No	Link to proposal
grant.programId	No	Program identifier (see below)

Finding the programId

If the user provides a program/track name but not a programId, look it up after finding the community UID:

# Accepts community slug (e.g., "optimism") or UID (0x...)
curl -s "${BASE_URL}/communities/${COMMUNITY_SLUG_OR_UID}/programs" | python3 -c "
import sys, json
data = json.load(sys.stdin)
programs = data if isinstance(data, list) else data.get('payload', data.get('data', []))
for p in programs:
    print(f'Name: {p.get(\"metadata\", {}).get(\"title\", \"N/A\")} | ID: {p[\"programId\"]}')
"

Use the matching programId value in the grant params.

Finding the Community UID

curl -s "${BASE_URL}/v2/communities/?limit=10&page=1" | python3 -c "
import sys, json
data = json.load(sys.stdin)
for c in data if isinstance(data, list) else data.get('payload', data.get('data', [])):
    d = c.get('details', {})
    name = d.get('name', 'N/A') if isinstance(d, dict) else 'N/A'
    print(f'Name: {name} | Chain: {c.get(\"chainID\", \"?\")} | UID: {c[\"uid\"]}')
"

Natural Language Mapping

User says	Action
"create a project with a grant from the Offchain Super Chain program"	Look up community UID + programId, ask for project/grant details
"create a project with a grant from Optimism"	Look up community UID, ask if it's a specific program or generic grant
"new project X funded by Y for $50K"	title: X, community: Y, amount: "50000"
"create project and grant together"	Ask for all details
"set up project X with Arbitrum grant"	Look up community, ask for remaining details

Making the Request

BASE_URL="${KARMA_API_URL:-https://gapapi.karmahq.xyz}"

curl -s -X POST "${BASE_URL}/v2/agent/execute" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ${KARMA_API_KEY}" \
  -d '{
    "action": "createProjectWithGrant",
    "params": {
      "chainId": 10,
      "title": "DeFi Protocol",
      "description": "A decentralized lending protocol",
      "links": [{ "type": "github", "url": "https://github.com/defi-protocol" }],
      "tags": ["defi", "lending"],
      "communityUID": "0xcommunity...uid",
      "grant": {
        "title": "Optimism Builder Grant",
        "description": "Funding for protocol development",
        "amount": "50000",
        "proposalURL": "https://gov.optimism.io/proposal/123"
      }
    }
  }'

After Success

Display the result. Note this created 4 attestations in one tx:

Project + Grant created successfully!

Transaction: 0x...
Chain: Optimism (10)
Smart Account: 0x...
Attestations: Project, ProjectDetails, Grant, GrantDetails (4 in 1 tx)

The project and grant will be automatically indexed by the system.

Edge Cases

Scenario	Response
Community name given instead of UID	Look up the UID via communities API
Community not found	"Could not find that community. Provide the UID directly."
User wants separate creation	Suggest using create-project then create-grant instead
Amount with currency symbol	Strip symbol and convert ("$50K" → "50000")