certify_research

Overview

L’outil certify_research scanne votre vault Obsidian et/ou votre base Notion pour certifier vos notes de recherche sur la blockchain. Chaque note est hashee en SHA-512 et attestee via EAS sur Base L2.

Parameters

project string requis

ID du projet a certifier. Doit correspondre au champ project dans le frontmatter (Obsidian) ou a la propriete Title (Notion). Le projet doit avoir vault_path et/ou notion_database_id configure.

since string défaut: 7 days ago

ISO date string. Only certify notes modified after this date.

dry_run boolean défaut: false

If true, preview what would be certified without creating attestations.

asset_types string[] défaut: ["programme_rnd"]

Types d’actifs IP. Defaut : ["programme_rnd"] pour les notes de recherche.

Autres valeurs possibles : savoir_faire, logiciel, base_donnees.

Obsidian Note Format

Notes must have YAML frontmatter with these required fields:

---
project: my-project      # Must match the project parameter
date: 2026-01-16         # Research date
hours: 2.5               # Effort in hours
class: S                 # S=Strategic, A=Advanced, C=Common
status: reviewed         # Must NOT be "draft"
---

# Research Content

Your research notes here...

Class Levels

Class	Description	Tax Credit Multiplier
S	Strategic - Novel research, breakthrough	Highest
A	Advanced - Complex problem solving	Medium
C	Common - Standard development	Base

Response

{
  "project": "my-project",
  "certified": 5,
  "skipped": 2,
  "total_hours": 12.5,
  "notes": [
    {
      "file": "research/2026-01-16-feature-analysis.md",
      "fingerprint": "sha512:abc123...",
      "hours": 2.5,
      "class": "S",
      "eas_uid": "0x1234...",
      "tx_hash": "0xabcd..."
    }
  ],
  "skipped_notes": [
    {
      "file": "research/draft-idea.md",
      "reason": "status is draft"
    }
  ]
}

Workflow

Preview with dry_run
```
Certify research for project "my-project" with dry_run enabled
```
Review the list of notes that will be certified.
Check Hours

Verify total_hours is reasonable. Flag if > 40h/week.
Certify
```
Certify research for project "my-project"
```
Remove dry_run to create actual attestations.
Verify

Check the returned eas_uid values on base.easscan.org

Examples

Certify research notes for project "seshat" since 2026-01-01 with dry_run enabled

{
  "project": "seshat",
  "certified": 0,
  "would_certify": 8,
  "total_hours": 24.5,
  "dry_run": true,
  "notes": [
    {
      "file": "research/mcp-architecture.md",
      "hours": 4,
      "class": "S",
      "status": "would_certify"
    }
  ]
}

Actual Certification

MCP Prompt
Response

Certify research notes for project "seshat"

{
  "project": "seshat",
  "certified": 8,
  "total_hours": 24.5,
  "notes": [
    {
      "file": "research/mcp-architecture.md",
      "fingerprint": "sha512:e3b0c44298fc1c149afbf4c8...",
      "eas_uid": "0x1234567890abcdef...",
      "tx_hash": "0xabcdef1234567890..."
    }
  ]
}

Warnings

Format base Notion

Si vous utilisez Notion comme source de recherche, votre base doit avoir ces proprietes :

Propriete	Type Notion	Requis	Equivalent frontmatter
`project`	Title	Oui	`project`
`date`	Date	Oui	`date`
`hours`	Number	Oui	`hours`
`class`	Select	Non	`class` (S/A/C)
`status`	Select	Non	`status` (draft/reviewed/certified)
`objective`	Rich text	Non	`objective`
`tags`	Multi-select	Non	Tags

Best Practices

Certify weekly to maintain a continuous proof chain
Use meaningful class levels - S for breakthroughs, C for routine work
Keep detailed notes - they’re part of your legal evidence
Review before certifying - dry_run is your friend
Combinez les sources - Obsidian pour les notes locales, Notion pour la recherche collaborative