### 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](mailto:contact@yourorganization.org))
#### **Extended Specification Link**: [http://yourorganization.org/schemas/daoip-5-extended](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:
1. **Grant Systems**: Governance or administration entities for grants.
2. **Grant Pools**: Fundable objects (e.g., smart contracts or treasury accounts) used to distribute grants.
3. **Projects**: Persistent entities applying for grants.
4. **Applications**: Specific submissions by projects to grant pools.
#### **Component Extended**
This specification extends the **Grant Pools** component of DAOIP-5.
#### **New Fields**
1. **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.
2. **GrantPoolFunders**:
- **Type**: `array of strings`
- **Description**: A list of URIs identifying the funding entities (e.g., DAOs) contributing to the grant pool.
- **Examples**:
```json
[
"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:
```json
{
"@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**
1. **Field Validation**: Ensure `grantPoolSize` and `grantPoolFunders` adhere to their defined types and constraints.
2. **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:
```json
{
"@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:
```json
{
"@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](mailto:contact@yourorganization.org)
- **Website**: [https://yourorganization.org](https://yourorganization.org)
#### **Extended Schema Publication**
- **Link**: [http://yourorganization.org/schemas/daoip-5-extended](http://yourorganization.org/schemas/daoip-5-extended)
- **JSON-LD Validation**: Validated using [JSON-LD Playground](https://json-ld.org/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.