diff --git a/ontology/schemas/credential-governance-declaration.md b/ontology/schemas/credential-governance-declaration.md new file mode 100644 index 00000000000..8eecc961881 --- /dev/null +++ b/ontology/schemas/credential-governance-declaration.md @@ -0,0 +1,91 @@ +--- +sidebar_position: 6 +--- +[//]: # (This file is auto-generated. Please do not modify it yourself.) + +# Governance declaration credential + +> **Name**: `credential-governance-declaration` +> +> **Namespace**: [https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/](https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/) + +## Namespaces + +Here are the namespaces used in this schema: + +- `rdf`: [http://www.w3.org/1999/02/22-rdf-syntax-ns#](http://www.w3.org/1999/02/22-rdf-syntax-ns#) +- `rdfs`: [http://www.w3.org/2000/01/rdf-schema#](http://www.w3.org/2000/01/rdf-schema#) +- `skos`: [http://www.w3.org/2004/02/skos/core#](http://www.w3.org/2004/02/skos/core#) +- `dcterms`: [http://purl.org/dc/terms/](http://purl.org/dc/terms/) +- `schema`: [http://schema.org/](http://schema.org/) +- `xsd`: [http://www.w3.org/2001/XMLSchema#](http://www.w3.org/2001/XMLSchema#) +- `credential-governance-declaration`: [https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/](https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/) + +## Verifiable Credential + +> **IRI**: [credential-governance-declaration:GovernanceDeclarationCredential](https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/GovernanceDeclarationCredential) + +### Description + +The Governance Declaration Credential represents a specialized subclass of Verifiable Credentials designed to define and formalize +the Governance framework applicable to a specific Resource. This credential is pivotal in decentralized systems and ensures explicit, +verifiable governance alignment across a variety of resource types. + +#### Scope and applicability + +- *Zone Governance*: Territorial in nature, this governance establishes a domain of sovereignty and jurisdiction where various + resources—such as datasets, services, and individuals—recognized by the governance framework can operate or coexist within its boundaries. It defines the legal and regulatory environment applicable to the governed entities. +- *Dataset or Service Governance*: Contractual in nature, this governance defines the terms and conditions for accessing and using the + resource. For example, it may specify that access to a dataset is restricted to services that present specific verifiable claims demonstrating + compliance with particular requirements, such as legal or operational standards. + +#### Self-determination and authority transfer + +The VC *must* be issued by the resource itself, adhering to the principle of self-determination. This ensures that the resource and the +credential issuer share a unified identity. Upon issuance, the credential executes a constitutional transfer of authority from the resource +to an autonomous, decentralized governance system directly associated with it. This governance system operates independently, utilizing +its own mechanisms to self-regulate and manage modifications or revisions of the governance framework in a decentralized and deterministic manner. + +#### Governance reference + +The governance declaration is characterized by a URI reference that uniquely identifies an immutable governance definition. These URIs are +required to be: + +- **Unique**: Each URI must represent a distinct governance definition. +- **Immutable**: The governance definition associated with the URI must remain unchanged over time. +- **Dereferenceable**: The governance content must be retrievable by resolving the URI, ensuring transparency and accessibility. + +### Properties + +#### Is governed by +> +> **IRI**: [credential-governance-declaration:isGovernedBy](https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/isGovernedBy) +> +> **Domain**: [credential-governance-declaration:GovernanceDeclarationCredential](https://w3id.org/axone/ontology/v4/schema/credential/governance/declaration/GovernanceDeclarationCredential) +> +> **Range**: [xsd:anyURI](http://www.w3.org/2001/XMLSchema#anyURI) + +The governance that a resource is governed by. + +This property links a resource to the governance that applies to it. Governance is represented by a URI that uniquely identifies the governance definition. +The URI must be dereferenceable, meaning it should allow retrieval of the governance definition when accessed. + +**Example**: + +```txt +# Reference to governance stored in the Law-Stone smart contract at a specific address +contract:law-stone:axone1hndfmswue3x47meah8sat4fpvj4rvfha4d7ugr849ay4rw7nnxlqcyxlhv +``` + +#### Constraints + +- Governance URIs must be: + - **Unique**: Each URI must uniquely identify a governance definition. + - **Immutable**: The governance definition it points to should not change over time. + - **Dereferenceable**: It must be possible to retrieve the governance data using the URI. +- Governances must originate from a Governance as Code approach, ensuring they are interpretable and executable deterministically by an existing smart contracts. + +#### Note + +In the Axone protocol, governances are defined using the Prolog language and hosted in dedicated smart contracts. However, a Verifiable Credential (VC) +can reference any governance definition, as long as it adheres to the above constraints. diff --git a/ontology/schemas/credential-governance-text.md b/ontology/schemas/credential-governance-text.md deleted file mode 100644 index c948493bef7..00000000000 --- a/ontology/schemas/credential-governance-text.md +++ /dev/null @@ -1,246 +0,0 @@ ---- -sidebar_position: 6 ---- -[//]: # (This file is auto-generated. Please do not modify it yourself.) - -# Governance description credential - -> **Name**: `credential-governance-text` -> -> **Namespace**: [https://w3id.org/axone/ontology/v4/schema/credential/governance/text/](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/) - -## Namespaces - -Here are the namespaces used in this schema: - -- `rdf`: [http://www.w3.org/1999/02/22-rdf-syntax-ns#](http://www.w3.org/1999/02/22-rdf-syntax-ns#) -- `rdfs`: [http://www.w3.org/2000/01/rdf-schema#](http://www.w3.org/2000/01/rdf-schema#) -- `skos`: [http://www.w3.org/2004/02/skos/core#](http://www.w3.org/2004/02/skos/core#) -- `dcterms`: [http://purl.org/dc/terms/](http://purl.org/dc/terms/) -- `schema`: [http://schema.org/](http://schema.org/) -- `xsd`: [http://www.w3.org/2001/XMLSchema#](http://www.w3.org/2001/XMLSchema#) -- `credential-governance-text`: [https://w3id.org/axone/ontology/v4/schema/credential/governance/text/](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/) - -## Verifiable Credential - -> **IRI**: [credential-governance-text:GovernanceTextCredential](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/GovernanceTextCredential) - -### Description - -Governance Text Credential is a type of Credential that attests to descriptive information about a governance text in a "human-readable format". - -The Governance Text Credential applies to all resources in the Dataverse for which rules must be followed. Such Governances are categorized into three main types as recognized by the [OKP4 protocol](https://okp4.network): - -- Zone Rules: Rules establish the boundaries of a specific area in the Dataverse, termed a Zone, within which governance is enforced. Each Zone is governed by its unique set of Rules tailored to its particular function or purpose. -- Resource Consent: Consents are agreements associated with the use of Resources within Zones. By resources, we mean Digital Resources (e.g. datasets) or Digital Services. It goes beyond simple approval and encompasses the permissions and restrictions on resource owners' access, usage, sharing, management and handling of their resources. It allows parties to define boundaries and establish terms for others to interact with their digital resources. It's a crucial aspect of governance, ensuring resources are used appropriately per the relevant parties' expressed will and intentions. -- Agreement: An agreement between parties involves creating shared understanding, consent, and alignment regarding future actions or outcomes. It signifies that the involved parties voluntarily accept and adhere to the rules, obligations, and conditions outlined in the agreement. By doing so, they demonstrate their commitment to collaboration and willingness to respect the rights and responsibilities defined in the contract until its completion. - -### Properties - -#### Is governed by -> -> **IRI**: [credential-governance-text:isGovernedBy](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/isGovernedBy) -> -> **Domain**: [credential-governance-text:GovernanceTextCredential](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/GovernanceTextCredential) -> -> **Range**: [credential-governance-text:GovernanceText](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/GovernanceText) - -The Governance Text that governs a Resource in the Dataverse. - -## Classes - -This schema defines 5 classes. - -### Article -> -> **IRI**: [credential-governance-text:Article](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Article) - -#### Description - -An article of a Governance Text, which states a specific (legal) rule or principle. Articles are the smallest unit of a governance text which represents a significant rule that can be enforced. - -#### Properties - -##### Has content -> -> **IRI**: [credential-governance-text:hasContent](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasContent) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The content of a Governance Text. - -##### Has ordinal number -> -> **IRI**: [credential-governance-text:hasOrdinalNumber](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasOrdinalNumber) -> -> **Range**: [xsd:integer](http://www.w3.org/2001/XMLSchema#integer) - -This property associates a governance component with its sequential number. - -It assigns an ordinal number as a value, starting from 1, ensuring sequential continuity within a specific domain instance. - -The format for this numbering may vary based on the domain, for instance, employing Roman numerals for section numbering. - -##### Has paragraph -> -> **IRI**: [credential-governance-text:hasParagraph](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasParagraph) -> -> **Range**: [credential-governance-text:Paragraph](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Paragraph) - -The paragraph of an article. - -##### Has title -> -> **IRI**: [credential-governance-text:hasTitle](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasTitle) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The title of a Governance Text. - -### Chapter -> -> **IRI**: [credential-governance-text:Chapter](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Chapter) - -#### Description - -A chapter of a Governance Text. - -#### Properties - -##### Has content -> -> **IRI**: [credential-governance-text:hasContent](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasContent) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The content of a Governance Text. - -##### Has ordinal number -> -> **IRI**: [credential-governance-text:hasOrdinalNumber](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasOrdinalNumber) -> -> **Range**: [xsd:integer](http://www.w3.org/2001/XMLSchema#integer) - -This property associates a governance component with its sequential number. - -It assigns an ordinal number as a value, starting from 1, ensuring sequential continuity within a specific domain instance. - -The format for this numbering may vary based on the domain, for instance, employing Roman numerals for section numbering. - -##### Has section -> -> **IRI**: [credential-governance-text:hasSection](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasSection) -> -> **Range**: [credential-governance-text:Section](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Section) - -The section of a Governance Text. - -##### Has title -> -> **IRI**: [credential-governance-text:hasTitle](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasTitle) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The title of a Governance Text. - -### Governance text -> -> **IRI**: [credential-governance-text:GovernanceText](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/GovernanceText) - -#### Description - -Governance Text provides descriptive information about a Governance text in a "human-readable format". It gives a description in a hierarchical manner, organized into chapters, sections, and articles. This hierarchy helps to structure the governance text and makes it easier to navigate and comprehend. - -Governance Text is mostly valuable in decentralized applications and web3 interfaces where governance texts are utilized to describe and represent the rules that applies to resources, like Zone or Digital Resources. This enables users to more readily engage with the governance text, allowing them to gain a better understanding of how the text operates and the rules governing the relationship between all resources in a Zone within the Dataverse. - -Governance Text is distinct from the Governance itself expressed using logic language (e.g. [Prolog](https://en.wikipedia.org/wiki/Prolog)), but helps to understand the Governance by providing important context. - -#### Properties - -##### From governance -> -> **IRI**: [credential-governance-text:fromGovernance](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/fromGovernance) -> -> **Range**: [xsd:anyURI](http://www.w3.org/2001/XMLSchema#anyURI) - -The Governance that a Governance Text is derived from. - -##### Has chapter -> -> **IRI**: [credential-governance-text:hasChapter](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasChapter) -> -> **Range**: [credential-governance-text:Chapter](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Chapter) - -The chapter of a governance text, which groups related sections together. - -### Paragraph -> -> **IRI**: [credential-governance-text:Paragraph](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Paragraph) - -#### Description - -A paragraph of an article, which expresses a sub-rule or sub-principle of the article. - -#### Properties - -##### Has content -> -> **IRI**: [credential-governance-text:hasContent](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasContent) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The content of a Governance Text. - -##### Has title -> -> **IRI**: [credential-governance-text:hasTitle](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasTitle) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The title of a Governance Text. - -### Section -> -> **IRI**: [credential-governance-text:Section](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Section) - -#### Description - -A section of a governance text, which groups related articles together. - -#### Properties - -##### Has article -> -> **IRI**: [credential-governance-text:hasArticle](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasArticle) -> -> **Range**: [credential-governance-text:Article](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/Article) - -The article of a Governance Text. - -##### Has content -> -> **IRI**: [credential-governance-text:hasContent](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasContent) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The content of a Governance Text. - -##### Has ordinal number -> -> **IRI**: [credential-governance-text:hasOrdinalNumber](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasOrdinalNumber) -> -> **Range**: [xsd:integer](http://www.w3.org/2001/XMLSchema#integer) - -This property associates a governance component with its sequential number. - -It assigns an ordinal number as a value, starting from 1, ensuring sequential continuity within a specific domain instance. - -The format for this numbering may vary based on the domain, for instance, employing Roman numerals for section numbering. - -##### Has title -> -> **IRI**: [credential-governance-text:hasTitle](https://w3id.org/axone/ontology/v4/schema/credential/governance/text/hasTitle) -> -> **Range**: [xsd:string](http://www.w3.org/2001/XMLSchema#string) - -The title of a Governance Text.