search

regen-network / regen-registry-standards

:seedling: RDF and SHACL schemas for Regen Registry
4 stars 1 forks source link

IRIs for on-chain entities #77

Open aaronc opened 10 months ago

aaronc commented 10 months ago

I've seen a few different ways we refer to on-chain entities, such as using the schema IRI (ex. https://schema.regen.network#C03-CreditClass) or the app URL (ex. https://app.regen.network/project/<id>). (As a separate question I'm wondering why we have SHACL specific to credit classes, but we can leave that for another discussion.)

We should have some canonical way to refer to on-chain entities. I suggest using the same regen: IRI scheme we use for data module entries. For example, regen:ecocredit/CreditClass/C03 which derives directly from the actual on-chain entities.

For off-chain projects, https://app.regen.network/project/<id> is fine because we don't have an on-chain ID yet. But when we have an on-chain ID we should use something like regen:ecocredit/Project/<id>.

clevinson commented 10 months ago

How do you suggest we disambiguate between regen: as the prefix used in JSON-LD as shorthand for https://schema.regen.network#, and regen: as you describe here, to use it as a specific scheme on its own?

If this is an issue, perhaps we could change our convention / shorthand in JSON-LD prefixes to rsd (short for "Regen Schema Definition", like how ssd is short for "XML Schema Definition"). Would something like this be more appropriate?

aaronc commented 10 months ago

See #76