Create Grant

Add a grant (funding record) to an existing project. This creates two on-chain attestations: Grant + GrantDetails.

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

Field	Required	Description
`chainId`	Yes	Chain where the project lives
`projectUID`	Yes	The project's attestation UID
`communityUID`	Yes	The community/program UID (bytes32) that funded the project
`title`	Yes	Grant title (1-200 chars)
`description`	No	Grant description (max 5000 chars)
`amount`	No	Funding amount as string (e.g., "50000")
`proposalURL`	No	Link to the grant proposal
`programId`	No	Program identifier (see below)

Finding the programId

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

# 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 request params.

Finding UIDs

Project UID — search by name:

curl -s "${BASE_URL}/v2/projects?q=PROJECT_NAME&limit=5&page=1" | python3 -c "
import sys, json
data = json.load(sys.stdin)
for p in data.get('payload', []):
    d = p.get('details', {})
    print(f'Title: {d.get(\"title\", \"N/A\")} | Chain: {p[\"chainID\"]} | UID: {p[\"uid\"]}')
"

Community UID — browse communities or get by slug:

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
"add a grant from the Offchain Super Chain program to project X"	Look up project UID, community UID, and programId from programs list
"add a grant to project X"	Look up project UID, ask for community and grant details
"project X received $50K from Optimism"	Look up project + community UIDs, ask if it's a specific program or generic grant
"add funding from program Y to project X"	Look up community UID + programId for program Y, then create grant
"create a grant for 0xabc... from 0xdef..."	Use UIDs directly

Important: When the user mentions a specific program name, always look up the programId via the programs API and include it. Without programId, the grant won't appear under that program on the website.

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": "createGrant",
    "params": {
      "chainId": 10,
      "projectUID": "0xproject...",
      "communityUID": "0xcommunity...",
      "title": "Optimism Builder Grant",
      "description": "Funding for protocol development",
      "amount": "50000",
      "proposalURL": "https://gov.optimism.io/proposal/123"
    }
  }'

After Success

Display the result using the standard output format. The grant will be automatically indexed by the system.

Edge Cases

Scenario	Response
Project or community name given instead of UID	Look up UIDs via the APIs
Community not found	"Could not find that community/program. Provide the community UID directly."
Amount with currency symbol	Strip the symbol and convert (e.g., "$50K" → "50000")
Missing community UID	This is required — ask the user which program/community funded the project

create-grant