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