📝Chapter Outlines

Part I: Foundation and Preparation

Chapter 1: Introduction to Methodology Digitization

Purpose: Establish the foundation for understanding methodology digitization on Guardian platform.

Key Topics:

  • What is methodology digitization and why it matters

  • Guardian platform's role in environmental asset tokenization

  • Overview of the digitization process from PDF to working policy

  • VM0033 as our reference case study - why it was chosen

  • Benefits of digitization: transparency, efficiency, automation

  • Common challenges and how this handbook addresses them

  • Setting up your development environment

VM0033 Context: Introduction to VM0033's significance in blue carbon markets and its complexity as a comprehensive tidal wetland restoration methodology.

Chapter 2: Understanding VM0033 Methodology

Purpose: Provide deep domain knowledge of VM0033 before beginning technical implementation.

Key Topics:

  • VM0033 scope and applicability conditions

  • Baseline scenario determination for tidal wetlands

  • Project activities and intervention types

  • Key stakeholders and their roles in wetland restoration

  • Emission sources and carbon pools covered

  • Monitoring requirements and verification processes

  • Relationship to other VCS methodologies and CDM tools

VM0033 Context: Complete walkthrough of the methodology document structure, highlighting sections that will be digitized and their interdependencies.

Chapter 3: Guardian Platform Overview for Methodology Developers

Purpose: Provide methodology developers with Guardian-specific knowledge needed for digitization.

Key Topics:

  • Guardian architecture: services, APIs, and data flow

  • Policy Workflow Engine (PWE) fundamentals

  • Schema system and Verifiable Credentials

  • Hedera Hashgraph integration and immutable records

  • User roles and permissions model

  • IPFS integration for document storage

  • Guardian UI components and user experience

VM0033 Context: How VM0033's complexity maps to Guardian's capabilities and architectural patterns.

Part II: Analysis and Planning

Chapter 4: Methodology Analysis and Decomposition

Purpose: Teach systematic approach to analyzing methodology documents for digitization.

Key Topics:

  • Structured reading techniques for methodology PDFs

  • Identifying workflow stages and decision points

  • Mapping stakeholder interactions and document flows

  • Extracting data requirements and validation rules

  • Understanding temporal boundaries and crediting periods

  • Identifying calculation dependencies and parameter relationships

VM0033 Context: Step-by-step analysis of VM0033 document, breaking down its 117 pages into digestible components and identifying digitization priorities.

Chapter 5: Equation Mapping and Parameter Identification

Purpose: Master the process of extracting and organizing all mathematical components of a methodology.

Key Topics:

  • Recursive equation analysis starting from final emission reduction formula

  • Parameter classification: monitored vs. non-monitored vs. user-input

  • Building parameter dependency trees

  • Identifying default values and lookup tables

  • Handling conditional calculations and alternative methods

  • Creating calculation flowcharts and documentation

VM0033 Context: Complete mapping of VM0033's emission reduction equations, including baseline emissions, project emissions, and leakage calculations with all parameter dependencies.

Chapter 6: Tools and Modules Integration

Purpose: Handle external tools and modules that methodologies reference.

Key Topics:

  • Understanding CDM tools and VCS modules

  • Integrating AR-Tool14 for biomass calculations

  • Incorporating VMD modules for specific calculations

  • Handling tool versioning and updates

  • Creating unified calculation frameworks

  • Managing tool dependencies and conflicts

VM0033 Context: Integration of all tools referenced in VM0033, including AR-Tool02, AR-Tool03, AR-Tool14, and various VMD modules.

Chapter 7: Test Artifact Development

Purpose: Create comprehensive test cases that validate the digitized methodology.

Key Topics:

  • Designing test scenarios covering all methodology pathways

  • Creating input parameter datasets for testing

  • Establishing expected output benchmarks

  • Building validation spreadsheets with all calculations

  • Documenting test cases and acceptance criteria

  • Version control for test artifacts

VM0033 Context: Development of complete VM0033 test spreadsheet with multiple project scenarios, covering different wetland types, restoration activities, and calculation methods.

Part III: Schema Design and Development

Chapter 8: Schema Architecture and Design Principles

Purpose: Establish best practices for schema design in Guardian.

Key Topics:

  • Schema tree architecture and hierarchy design

  • Sub-schema patterns and reusability

  • Field types and their appropriate usage

  • Validation rules and constraints

  • User experience considerations in schema design

  • Performance implications of schema structure

  • Versioning and evolution strategies

VM0033 Context: Design principles applied to VM0033's complex data requirements, including multiple calculation methods and conditional logic.

Chapter 9: Project Design Document (PDD) Schema Development

Purpose: Create comprehensive PDD schemas that capture all project information.

Key Topics:

  • Project information and metadata schemas

  • Baseline scenario documentation

  • Project activity descriptions and justifications

  • Stakeholder consultation schemas

  • Environmental impact assessments

  • Emission reduction estimation schemas

  • Supporting document attachments

VM0033 Context: Complete PDD schema for VM0033 tidal wetland projects, including all required sections and conditional fields based on project type.

Chapter 10: Monitoring Report Schema Development

Purpose: Design schemas for ongoing monitoring and verification.

Key Topics:

  • Monitoring parameter schemas and data collection

  • Temporal data handling and time series

  • Quality assurance and quality control fields

  • Evidence and documentation requirements

  • Calculation update mechanisms

  • Verification and validation workflows

VM0033 Context: VM0033 monitoring report schema covering all required monitoring parameters, including water table depth, vegetation coverage, and emission measurements.

Chapter 11: Advanced Schema Techniques

Purpose: Master advanced schema features for complex methodologies.

Key Topics:

  • Conditional field visibility and dynamic forms

  • Enum types and controlled vocabularies

  • Auto-calculation fields and formula integration

  • Cross-schema references and relationships

  • File upload and document management

  • Multi-language support and localization

VM0033 Context: Implementation of VM0033's complex conditional logic, including different calculation methods based on wetland type and restoration activity.

Chapter 12: Schema Testing and Validation

Purpose: Ensure schema quality and functionality before policy integration.

Key Topics:

  • Schema validation techniques and tools

  • User acceptance testing for schemas

  • Data integrity and constraint testing

  • Performance testing with large datasets

  • Cross-browser and device compatibility

  • Accessibility and usability testing

VM0033 Context: Comprehensive testing approach for VM0033 schemas, including validation of complex calculation logic and conditional field behavior.

Part IV: Policy Workflow Design

Chapter 13: Stakeholder Analysis and Role Definition

Purpose: Design appropriate roles and permissions for methodology stakeholders.

Key Topics:

  • Stakeholder mapping and responsibility analysis

  • Guardian role system and permission models

  • Role-based access control implementation

  • Workflow permissions and document visibility

  • Multi-organization coordination

  • Conflict resolution and escalation procedures

VM0033 Context: VM0033 stakeholder ecosystem including Verra as registry, VVBs, project developers, and community stakeholders.

Chapter 14: Carbon Credit Certification Workflow Design

Purpose: Design the complete certification process from registration to credit issuance.

Key Topics:

  • Project registration and listing workflows

  • Validation process design and VVB assignment

  • Verification workflows and evidence collection

  • Registry review and approval processes

  • Credit issuance and token minting

  • Appeals and dispute resolution mechanisms

VM0033 Context: Complete VM0033 certification workflow following Verra's VCS program requirements and procedures.

Chapter 15: Policy Workflow Block Configuration

Purpose: Master the configuration of Guardian's policy workflow blocks.

Key Topics:

  • Request blocks for data collection

  • Send blocks for data storage and transmission

  • Interface container blocks for user experience

  • Role blocks and permission management

  • Calculate blocks for data processing

  • Mint blocks for token issuance

VM0033 Context: Detailed configuration of all blocks needed for VM0033 workflow, with specific examples and parameter settings.

Chapter 16: Document Flow and State Management

Purpose: Manage complex document states and transitions throughout the workflow.

Key Topics:

  • Document state modeling and transitions

  • Status tracking and progress indicators

  • Approval workflows and multi-party sign-offs

  • Document versioning and change management

  • Audit trails and immutable records

  • Error handling and recovery procedures

VM0033 Context: VM0033 document flow from PDD submission through credit issuance, including all intermediate states and approval gates.

Part V: Calculation Logic Implementation

Chapter 17: Custom Logic Block Development

Purpose: Implement complex calculation logic using JavaScript in Guardian.

Key Topics:

  • JavaScript/Python development environment setup

  • Guardian calculation block architecture

  • Input/output document handling

  • Mathematical operations and precision handling

  • Error handling and validation

  • Performance optimization techniques

  • Debugging and testing strategies

VM0033 Context: Complete implementation of VM0033 emission reduction calculations, including baseline emissions, project emissions, and net emission reductions.

Chapter 18: Formula Linked Definitions (FLDs)

Purpose: Implement complex parameter relationships and dependencies.

Key Topics:

  • FLD concept and architecture

  • Parameter linking and dependency management

  • Dynamic calculation updates

  • Circular dependency detection and resolution

  • Performance implications of complex FLDs

  • Documentation and maintenance strategies

VM0033 Context: Implementation of VM0033's complex parameter relationships, including soil organic carbon calculations and biomass estimations.

Chapter 19: Data Validation and Error Handling

Purpose: Ensure data quality and system reliability through robust validation.

Key Topics:

  • Input validation strategies and techniques

  • Business rule validation implementation

  • Error message design and user feedback

  • Data sanitization and security considerations

  • Graceful error recovery mechanisms

  • Logging and monitoring for validation issues

VM0033 Context: Comprehensive validation rules for VM0033 data inputs, including range checks, consistency validations, and methodology-specific business rules.

Chapter 20: Calculation Testing and Verification

Purpose: Validate calculation accuracy against test artifacts and methodology requirements.

Key Topics:

  • Unit testing for calculation functions

  • Integration testing with complete workflows

  • Test data generation and management

  • Performance testing for large datasets

  • Regression testing for methodology updates

VM0033 Context: Complete testing suite for VM0033 calculations, comparing results against manually calculated test cases and methodology examples.

Part VI: Integration and Testing

Chapter 21: End-to-End Policy Testing

Purpose: Validate complete policy functionality across all user roles and scenarios.

Key Topics:

  • Test scenario design and coverage analysis

  • Multi-role testing strategies

  • Workflow testing and state validation

  • Data integrity testing across the complete flow

  • User acceptance testing coordination

  • Performance and load testing

VM0033 Context: Comprehensive end-to-end testing of VM0033 policy, including multiple project types and restoration scenarios.

Chapter 22: API Integration and Automation

Purpose: Leverage Guardian APIs for testing, integration, and automation.

Key Topics:

  • Guardian API architecture and authentication

  • Automated data submission and workflow execution

  • Integration with external monitoring systems

  • Bulk data processing and batch operations

  • API testing and validation strategies

  • Error handling and retry mechanisms

VM0033 Context: API-based automation for VM0033 data submission, including PDD registration and monitoring report submission.

Part VII: Deployment and Maintenance

Chapter 23: User Management and Role Assignment

Purpose: Set up and manage users, roles, and permissions for deployed methodologies.

Key Topics:

  • User onboarding and account management

  • Role assignment and permission configuration

  • Organization management and multi-tenancy

  • Access control and security policies

  • User training and support procedures

  • Audit and compliance reporting

VM0033 Context: User management for VM0033 implementation, including VVB accreditation, project developer registration, and Verra administrator roles.

Chapter 24: Monitoring and Analytics - Guardian Indexer

Purpose: Monitoring and analytics for deployed methodologies and data submitted via Indexer

Key Topics:

  • Usage analytics and reporting

  • Data export and reporting capabilities

  • Compliance monitoring and audit trails

VM0033 Context: Viewing all data on Indexer, tracking project registrations, credit issuances

Chapter 25: Maintenance and Updates

Purpose: Maintain and evolve deployed methodologies over time.

Key Topics:

  • Maintenance procedures and schedules

  • Bug fixing and issue resolution

  • Methodology updates and regulatory changes

  • User feedback integration and feature requests

  • Long-term support and lifecycle planning

VM0033 Context: Maintenance strategy for VM0033 implementation, including handling Verra methodology updates and regulatory changes.

Part VIII: Advanced Topics and Best Practices

Chapter 26: Integration with External Systems

Purpose: Connect Guardian-based methodologies with external systems and services.

Key Topics:

  • External system integration patterns

  • Data transformation via blocks

  • Data synchronization and consistency

  • Real-time data feeds and streaming (Metered Policy Example)

VM0033 Context: Integration of VM0033 with external monitoring systems, satellite data feeds, and Verra's registry systems.

Chapter 27: Troubleshooting and Common Issues

Purpose: Provide solutions for common problems encountered during methodology digitization.

Key Topics:

  • Common digitization pitfalls and solutions

  • Debugging techniques and tools

  • Data quality issues and resolution

  • User experience problems and fixes

  • Integration and compatibility issues

VM0033 Context: Some specific troubleshooting scenarios encountered during VM0033 implementation and their solutions.


Implementation Notes

Each chapter will include:

  • Practical Examples: Real code, configurations, and screenshots from VM0033 implementation

  • Best Practices: Lessons learned and recommended approaches

  • Common Pitfalls: What to avoid and how to prevent issues

  • Testing Strategies: How to validate each component

  • Performance Considerations: Optimization tips and scalability guidance

  • Maintenance Notes: Long-term considerations and update strategies

The handbook is designed to be both a learning resource and a reference guide, with clear navigation between conceptual understanding and practical implementation.

Last updated

Was this helpful?