Template: Technical Specification for the Extended DAOIP-5 Metadata Schema

Template Technical Specification for the Extended DAOIP-5 Metadata Schema

Title: DAOIP-5: Grants Management - Extended Metadata for Grant Pools

Status: Draft

Version: 1.1

Date: YYYY-MM-DD

Authors: [Your Organization Name] (Contact Email)

Extended Specification Link: http://yourorganization.org/schemas/daoip-5-extended

Simple Summary

This document extends the Grant Pools component of DAOIP-5 to include additional metadata fields that provide better financial transparency and governance visibility for grant pools. These fields are designed to enhance interoperability and provide more granular data for grants management.

Abstract

DAOIP-5 defines standards for managing grants, organizing them into four main components: Grant Systems, Grant Pools, Projects, and Applications. This extension modifies the Grant Pools component by introducing two additional fields:

GrantPoolSize: Captures the total size of the grant pool in USD or token denomination.
GrantPoolFunders: Lists the funding entities (DAO URIs or similar identifiers) for the grant pool.

The extension preserves backward compatibility with the existing DAOIP-5 specification and ensures seamless integration with existing implementations.

Motivation

As grants programs grow in scale and complexity, additional metadata is required to:

Improve financial transparency by documenting the total grant pool size.
Enhance governance accountability by identifying the funding entities contributing to a grant pool.

These fields address gaps in the current specification, making it more robust for analyzing and managing grants data at scale.

Specification

Components of DAOIP-5

The DAOIP-5 specification is organized into four main components:

Grant Systems: Governance or administration entities for grants.
Grant Pools: Fundable objects (e.g., smart contracts or treasury accounts) used to distribute grants.
Projects: Persistent entities applying for grants.
Applications: Specific submissions by projects to grant pools.

Component Extended

This specification extends the Grant Pools component of DAOIP-5.

New Fields

GrantPoolSize:
- Type: string
- Description: Represents the total size of the grant pool in a specified denomination (e.g., USD or a token such as ETH or USDC).
- Examples:
  - "1000000 USDC"
  - "500 ETH"
- Validation: Must be a valid string combining a numerical value and denomination.
GrantPoolFunders:
- Type: array of strings
- Description: A list of URIs identifying the funding entities (e.g., DAOs) contributing to the grant pool.
- Examples:
```
[
  "https://daostar.org/dao/optimism",
  "https://daostar.org/dao/gitcoin"
]
```
- Validation: Each entry must be a valid URI.

Schema Updates

Extended Grant Pool JSON-LD Schema

Below is the extended schema, incorporating the new fields:

{
  "@context": [
    "http://www.daostar.org/schemas",
    "http://yourorganization.org/schemas/daoip-5-extended"
  ],
  "type": "GrantPool",
  "id": "eip155:1:0x2345bcde",
  "name": "Innovation Grants",
  "description": "Grants supporting open-source projects.",
  "grantPoolSize": "1000000 USDC",
  "grantPoolFunders": [
    "https://daostar.org/dao/optimism",
    "https://daostar.org/dao/gitcoin"
  ],
  "applicationsURI": "https://yourorganization.org/grant-applications",
    "isOpen": <OPTIONAL: A Boolean true/false indicating whether the grant pool is open to or seeking new applications.>,
    "closeDate": "<OPTIONAL: The ISO DateTime at which point the grant pool will stop taking new applications.>",
    "applicationsURI": "<A URI pointing to current and past applications received by the grant pool, following the DAOIP-5 Applications JSON-LD Schema.>",
    "governanceURI": "<A URI pointing to additional information about the governance, requirements, and criteria for the grant, which SHOULD be a .md file.>",
    "attestationIssuersURI": "<RECOMMENDED: A URI pointing to a JSON of trusted issuers of attestations and credentials about the grant pool, following the DAOIP-3 Attestation Issuers JSON-LD Schema.>",
    "requiredCredentials": ["<RECOMMENDED: An array of attestation types, following DAOIP-3 Attestations for DAOs.>"],
    "email": "<OPTIONAL: A working email address through which the grant pool can respond to inquiries and requests.>",
    "image": "<RECOMMENDED: A URI pointing to a resource with mime type image/*, typically a square logo.>",
    "coverImage": "<RECOMMENDED: A URI pointing to a resource with mime type image/*, typically a large, rectangular background image.>"
}

Field Mapping

Field Name	Type	Description	Required
`grantPoolSize`	String	Total size of the grant pool in a specified denomination (e.g., USD or ETH).	Yes
`grantPoolFunders`	Array of Strings	List of URIs identifying the entities funding the grant pool.	Yes

Integration

Backward Compatibility

The extension preserves compatibility with existing DAOIP-5 implementations. Systems not utilizing the new fields will continue to function correctly.

Validation

Field Validation: Ensure grantPoolSize and grantPoolFunders adhere to their defined types and constraints.
Schema Validation: Use JSON-LD validation tools to confirm compliance with the extended schema.

Examples

Example 1: Grant Pool for an open-source funding round:

{
  "@context": [
    "http://www.daostar.org/schemas",
    "http://yourorganization.org/schemas/daoip-5-extended"
  ],
  "type": "GrantPool",
  "id": "eip155:1:0x4567efgh",
  "name": "Open Source Grants",
  "grantPoolSize": "75000 USDC",
  "grantPoolFunders": [
    "https://daostar.org/dao/aave",
    "https://daostar.org/dao/aragon"
  ]
}

Example 2: Grant Pool funded by multiple DAOs:

{
  "@context": [
    "http://www.daostar.org/schemas",
    "http://yourorganization.org/schemas/daoip-5-extended"
  ],
  "type": "GrantPool",
  "id": "eip155:1:0x7890ijkl",
  "name": "Research Grants",
  "grantPoolSize": "500 ETH",
  "grantPoolFunders": [
    "https://daostar.org/dao/gnosis",
    "https://daostar.org/dao/gitcoin"
  ]
}

Publishing Details

Publishing Organization

Name: [Your Organization Name]
Contact: Contact Email
Website: https://yourorganization.org

Extended Schema Publication

Link: http://yourorganization.org/schemas/daoip-5-extended
JSON-LD Validation: Validated using JSON-LD Playground.

Future Work

Explore adding metadata for grant fund allocation history.
Enhance funder transparency with additional attestation mechanisms.
Monitor community adoption and gather feedback for iterative updates.

Acknowledgments

Special thanks to the DAOIP community and contributors for the collaborative development of DAOIP-5 and its extensions.