dkg 8.0.0a2__py3-none-any.whl → 8.0.1__py3-none-any.whl

dkg/modules/asset/async_asset.py

@@ -0,0 +1,751 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+
+#   http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+import asyncio
+from typing import Literal
+from pyld import jsonld
+from web3 import Web3
+from web3.constants import ADDRESS_ZERO
+from web3.types import TxReceipt
+from itertools import chain
+from eth_account.messages import encode_defunct
+from eth_account import Account
+from hexbytes import HexBytes
+
+from dkg.constants import (
+    PRIVATE_ASSERTION_PREDICATE,
+    PRIVATE_RESOURCE_PREDICATE,
+    PRIVATE_HASH_SUBJECT_PREFIX,
+    CHUNK_BYTE_SIZE,
+    MAX_FILE_SIZE,
+    DEFAULT_RDF_FORMAT,
+    Operations,
+    OutputTypes,
+)
+from dkg.managers.async_manager import AsyncRequestManager
+from dkg.method import Method
+from dkg.modules.async_module import AsyncModule
+from dkg.types import JSONLD, UAL, Address, HexStr
+from dkg.utils.blockchain_request import (
+    BlockchainRequest,
+)
+from dkg.utils.node_request import (
+    OperationStatus,
+)
+from dkg.utils.ual import format_ual, parse_ual
+import dkg.utils.knowledge_collection_tools as kc_tools
+import dkg.utils.knowledge_asset_tools as ka_tools
+from dkg.services.input_service import InputService
+from dkg.services.node_services.async_node_service import AsyncNodeService
+from dkg.services.blockchain_services.async_blockchain_service import (
+    AsyncBlockchainService,
+)
+from dkg.utils.node_request import get_operation_status_object
+
+
+class AsyncKnowledgeAsset(AsyncModule):
+    def __init__(
+        self,
+        manager: AsyncRequestManager,
+        input_service: InputService,
+        node_service: AsyncNodeService,
+        blockchain_service: AsyncBlockchainService,
+    ):
+        self.manager = manager
+        self.input_service = input_service
+        self.node_service = node_service
+        self.blockchain_service = blockchain_service
+
+    async def is_valid_ual(self, ual: UAL) -> bool:
+        if not ual or not isinstance(ual, str):
+            raise ValueError("UAL must be a non-empty string.")
+
+        parts = ual.split("/")
+        if len(parts) != 3:
+            raise ValueError("UAL format is incorrect.")
+
+        prefixes = parts[0].split(":")
+        prefixes_number = len(prefixes)
+        if prefixes_number != 3 and prefixes_number != 4:
+            raise ValueError("Prefix format in UAL is incorrect.")
+
+        if prefixes[0] != "did":
+            raise ValueError(
+                f"Invalid DID prefix. Expected: 'did'. Received: '{prefixes[0]}'."
+            )
+
+        if prefixes[1] != "dkg":
+            raise ValueError(
+                f"Invalid DKG prefix. Expected: 'dkg'. Received: '{prefixes[1]}'."
+            )
+
+        if prefixes[2] != (
+            blockchain_name := (
+                self.manager.blockchain_provider.blockchain_id.split(":")[0]
+            )
+        ):
+            raise ValueError(
+                "Invalid blockchain name in the UAL prefix. "
+                f"Expected: '{blockchain_name}'. Received: '${prefixes[2]}'."
+            )
+
+        if prefixes_number == 4:
+            chain_id = self.manager.blockchain_provider.blockchain_id.split(":")[1]
+
+            if int(prefixes[3]) != int(chain_id):
+                raise ValueError(
+                    "Chain ID in UAL does not match the blockchain. "
+                    f"Expected: '${chain_id}'. Received: '${prefixes[3]}'."
+                )
+
+        contract_address = self.manager.blockchain_provider.contracts[
+            "ContentAssetStorage"
+        ].address
+
+        if parts[1].lower() != contract_address.lower():
+            raise ValueError(
+                "Contract address in UAL does not match. "
+                f"Expected: '${contract_address.lower()}'. "
+                f"Received: '${parts[1].lower()}'."
+            )
+
+        try:
+            owner = await self.blockchain_service.get_owner(int(parts[2]))
+
+            if not owner or owner == ADDRESS_ZERO:
+                raise ValueError("Token does not exist or has no owner.")
+
+            return True
+        except Exception as err:
+            raise ValueError(f"Error fetching asset owner: {err}")
+
+    def process_content(self, content: str) -> list:
+        return [line.strip() for line in content.split("\n") if line.strip() != ""]
+
+    def insert_triple_sorted(self, triples_list: list, new_triple: str) -> int:
+        # Assuming triples_list is already sorted
+        left = 0
+        right = len(triples_list)
+
+        while left < right:
+            mid = (left + right) // 2
+            if triples_list[mid] < new_triple:
+                left = mid + 1
+            else:
+                right = mid
+
+        # Insert the new triple at the correct position
+        triples_list.insert(left, new_triple)
+        return left
+
+    def get_operation_status_dict(self, operation_result, operation_id):
+        # Check if data exists and has errorType
+        operation_data = (
+            {"status": operation_result.get("status"), **operation_result.get("data")}
+            if operation_result.get("data")
+            and operation_result.get("data", {}).get("errorType")
+            else {"status": operation_result.get("status")}
+        )
+
+        return {"operationId": operation_id, **operation_data}
+
+    def get_message_signer_address(self, dataset_root: str, signature: dict):
+        message = encode_defunct(HexBytes(dataset_root))
+        r, s, v = signature.get("r"), signature.get("s"), signature.get("v")
+        r = r[2:] if r.startswith("0x") else r
+        s = s[2:] if s.startswith("0x") else s
+
+        sig = "0x" + r + s + hex(v)[2:].zfill(2)
+
+        return Account.recover_message(message, signature=sig)
+
+    async def process_signatures(self, signatures, dataset_root):
+        async def process_signature(signature):
+            try:
+                signer_address = self.get_message_signer_address(
+                    dataset_root, signature
+                )
+
+                key_is_operational_wallet = (
+                    await self.blockchain_service.key_is_operational_wallet(
+                        signature.get("identityId"),
+                        Web3.solidity_keccak(["address"], [signer_address]),
+                        2,  # IdentityLib.OPERATIONAL_KEY
+                    )
+                )
+
+                if key_is_operational_wallet:
+                    return {
+                        "identityId": signature.get("identityId"),
+                        "r": signature.get("r"),
+                        "vs": signature.get("vs"),
+                    }
+
+            except Exception:
+                pass
+            return None
+
+        # Run all signature processing concurrently
+        results = await asyncio.gather(
+            *(process_signature(sig) for sig in signatures), return_exceptions=False
+        )
+
+        # Filter out None results and organize the data
+        valid_results = [r for r in results if r is not None]
+
+        return {
+            "identity_ids": [r["identityId"] for r in valid_results],
+            "r": [r["r"] for r in valid_results],
+            "vs": [r["vs"] for r in valid_results],
+        }
+
+    async def create(
+        self,
+        content: dict[Literal["public", "private"], JSONLD],
+        options: dict = None,
+    ) -> dict[str, UAL | HexStr | dict[str, dict[str, str] | TxReceipt]]:
+        if options is None:
+            options = {}
+
+        arguments = self.input_service.get_asset_create_arguments(options)
+
+        max_number_of_retries = arguments.get("max_number_of_retries")
+        frequency = arguments.get("frequency")
+        epochs_num = arguments.get("epochs_num")
+        hash_function_id = arguments.get("hash_function_id")
+        immutable = arguments.get("immutable")
+        token_amount = arguments.get("token_amount")
+        payer = arguments.get("payer")
+        minimum_number_of_finalization_confirmations = arguments.get(
+            "minimum_number_of_finalization_confirmations"
+        )
+        minimum_number_of_node_replications = arguments.get(
+            "minimum_number_of_node_replications"
+        )
+        blockchain_id = self.manager.blockchain_provider.blockchain_id
+
+        dataset = {}
+        public_content = dataset.get("public")
+        private_content = dataset.get("private")
+        if isinstance(content, str):
+            dataset["public"] = self.process_content(content)
+        elif isinstance(public_content, str) or (
+            not public_content and private_content and isinstance(private_content, str)
+        ):
+            if public_content:
+                dataset["public"] = self.process_content(public_content)
+            else:
+                dataset["public"] = []
+
+            if private_content and isinstance(private_content, str):
+                dataset["private"] = self.process_content(private_content)
+        else:
+            dataset = kc_tools.format_dataset(content)
+
+        public_triples_grouped = []
+
+        dataset["public"] = kc_tools.generate_missing_ids_for_blank_nodes(
+            dataset.get("public")
+        )
+
+        if dataset.get("private") and len(dataset.get("private")):
+            dataset["private"] = kc_tools.generate_missing_ids_for_blank_nodes(
+                dataset.get("private")
+            )
+
+            # Group private triples by subject and flatten
+            private_triples_grouped = kc_tools.group_nquads_by_subject(
+                dataset.get("private"), True
+            )
+
+            dataset["private"] = list(chain.from_iterable(private_triples_grouped))
+
+            # Compute private root and add to public
+            private_root = kc_tools.calculate_merkle_root(dataset.get("private"))
+            dataset["public"].append(
+                f'<{ka_tools.generate_named_node()}> <{PRIVATE_ASSERTION_PREDICATE}> "{private_root}" .'
+            )
+
+            # Compute private root and add to public
+            public_triples_grouped = kc_tools.group_nquads_by_subject(
+                dataset.get("public"), True
+            )
+
+            # Create a dictionary for public subject -> index for quick lookup
+            public_subject_dict = {}
+            for i in range(len(public_triples_grouped)):
+                public_subject = public_triples_grouped[i][0].split(" ")[0]
+                public_subject_dict[public_subject] = i
+
+            private_triple_subject_hashes_grouped_without_public_pair = []
+
+            # Integrate private subjects into public or store separately if no match to be appended later
+            for private_triples in private_triples_grouped:
+                private_subject = private_triples[0].split(" ")[
+                    0
+                ]  # Extract the private subject
+
+                private_subject_hash = kc_tools.solidity_packed_sha256(
+                    types=["string"],
+                    values=[private_subject[1:-1]],
+                )
+
+                if (
+                    private_subject in public_subject_dict
+                ):  # Check if there's a public pair
+                    # If there's a public pair, insert a representation in that group
+                    public_index = public_subject_dict.get(private_subject)
+                    self.insert_triple_sorted(
+                        public_triples_grouped[public_index],
+                        f"{private_subject} <{PRIVATE_RESOURCE_PREDICATE}> <{ka_tools.generate_named_node()}> .",
+                    )
+                else:
+                    # If no public pair, maintain separate list, inserting sorted by hash
+                    self.insert_triple_sorted(
+                        private_triple_subject_hashes_grouped_without_public_pair,
+                        f"<{PRIVATE_HASH_SUBJECT_PREFIX}{private_subject_hash}> <{PRIVATE_RESOURCE_PREDICATE}> <{ka_tools.generate_named_node()}> .",
+                    )
+
+            for triple in private_triple_subject_hashes_grouped_without_public_pair:
+                public_triples_grouped.append([triple])
+
+            dataset["public"] = list(chain.from_iterable(public_triples_grouped))
+        else:
+            # No private triples, just group and flatten public
+            public_triples_grouped = kc_tools.group_nquads_by_subject(
+                dataset.get("public"), True
+            )
+            dataset["public"] = list(chain.from_iterable(public_triples_grouped))
+
+        # Calculate the number of chunks
+        number_of_chunks = kc_tools.calculate_number_of_chunks(
+            dataset.get("public"), CHUNK_BYTE_SIZE
+        )
+        dataset_size = number_of_chunks * CHUNK_BYTE_SIZE
+
+        # Validate the assertion size in bytes
+        if dataset_size > MAX_FILE_SIZE:
+            raise ValueError(f"File size limit is {MAX_FILE_SIZE / (1024 * 1024)}MB.")
+
+        # Calculate the Merkle root
+        dataset_root = kc_tools.calculate_merkle_root(dataset.get("public"))
+
+        # Get the contract address for KnowledgeCollectionStorage
+        content_asset_storage_address = (
+            await self.blockchain_service.get_asset_storage_address(
+                "KnowledgeCollectionStorage"
+            )
+        )
+
+        result = await self.node_service.publish(
+            dataset_root,
+            dataset,
+            blockchain_id,
+            hash_function_id,
+            minimum_number_of_node_replications,
+        )
+        publish_operation_id = result.get("operationId")
+        publish_operation_result = await self.node_service.get_operation_result(
+            publish_operation_id,
+            Operations.PUBLISH.value,
+            max_number_of_retries,
+            frequency,
+        )
+
+        if publish_operation_result.get(
+            "status"
+        ) != OperationStatus.COMPLETED and not publish_operation_result.get(
+            "data", {}
+        ).get("minAcksReached"):
+            return {
+                "datasetRoot": dataset_root,
+                "operation": {
+                    "publish": self.get_operation_status_dict(
+                        publish_operation_result, publish_operation_id
+                    )
+                },
+            }
+
+        data = publish_operation_result.get("data", {})
+        signatures = data.get("signatures")
+
+        publisher_node_signature = data.get("publisherNodeSignature", {})
+        publisher_node_identity_id = publisher_node_signature.get("identityId")
+        publisher_node_r = publisher_node_signature.get("r")
+        publisher_node_vs = publisher_node_signature.get("vs")
+
+        results = await self.process_signatures(signatures, dataset_root)
+        identity_ids = results["identity_ids"]
+        r = results["r"]
+        vs = results["vs"]
+
+        if token_amount:
+            estimated_publishing_cost = token_amount
+        else:
+            time_until_next_epoch = (
+                await self.blockchain_service.time_until_next_epoch()
+            )
+            epoch_length = await self.blockchain_service.epoch_length()
+            stake_weighted_average_ask = (
+                await self.blockchain_service.get_stake_weighted_average_ask()
+            )
+
+            # Convert to integers and perform calculation
+            estimated_publishing_cost = (
+                (
+                    int(stake_weighted_average_ask)
+                    * (
+                        int(epochs_num) * int(1e18)
+                        + (int(time_until_next_epoch) * int(1e18)) // int(epoch_length)
+                    )
+                    * int(dataset_size)
+                )
+                // 1024
+                // int(1e18)
+            )
+
+        knowledge_collection_id = None
+        mint_knowledge_asset_receipt = None
+
+        knowledge_collection_result = (
+            await self.blockchain_service.create_knowledge_collection(
+                {
+                    "publishOperationId": publish_operation_id,
+                    "merkleRoot": dataset_root,
+                    "knowledgeAssetsAmount": kc_tools.count_distinct_subjects(
+                        dataset.get("public")
+                    ),
+                    "byteSize": dataset_size,
+                    "epochs": epochs_num,
+                    "tokenAmount": estimated_publishing_cost,
+                    "isImmutable": immutable,
+                    "paymaster": payer,
+                    "publisherNodeIdentityId": publisher_node_identity_id,
+                    "publisherNodeR": publisher_node_r,
+                    "publisherNodeVS": publisher_node_vs,
+                    "identityIds": identity_ids,
+                    "r": r,
+                    "vs": vs,
+                },
+                None,
+                None,
+            )
+        )
+        knowledge_collection_id = knowledge_collection_result.knowledge_collection_id
+        mint_knowledge_asset_receipt = knowledge_collection_result.receipt
+
+        ual = format_ual(
+            blockchain_id, content_asset_storage_address, knowledge_collection_id
+        )
+
+        finality_status_result = 0
+        if minimum_number_of_finalization_confirmations > 0:
+            finality_status_result = await self.node_service.finality_status(
+                ual,
+                minimum_number_of_finalization_confirmations,
+                max_number_of_retries,
+                frequency,
+            )
+
+        return json.loads(
+            Web3.to_json(
+                {
+                    "UAL": ual,
+                    "datasetRoot": dataset_root,
+                    "signatures": publish_operation_result.get("data", {}).get(
+                        "signatures"
+                    ),
+                    "operation": {
+                        "mintKnowledgeAsset": mint_knowledge_asset_receipt,
+                        "publish": get_operation_status_object(
+                            publish_operation_result, publish_operation_id
+                        ),
+                        "finality": {
+                            "status": "FINALIZED"
+                            if finality_status_result
+                            >= minimum_number_of_finalization_confirmations
+                            else "NOT FINALIZED"
+                        },
+                        "numberOfConfirmations": finality_status_result,
+                        "requiredConfirmations": minimum_number_of_finalization_confirmations,
+                    },
+                }
+            )
+        )
+
+    _submit_knowledge_asset = Method(BlockchainRequest.submit_knowledge_asset)
+
+    def submit_to_paranet(
+        self, ual: UAL, paranet_ual: UAL
+    ) -> dict[str, UAL | Address | TxReceipt]:
+        parsed_ual = parse_ual(ual)
+        knowledge_asset_storage, knowledge_asset_token_id = (
+            parsed_ual["contract_address"],
+            parsed_ual["token_id"],
+        )
+
+        parsed_paranet_ual = parse_ual(paranet_ual)
+        paranet_knowledge_asset_storage, paranet_knowledge_asset_token_id = (
+            parsed_paranet_ual["contract_address"],
+            parsed_paranet_ual["token_id"],
+        )
+
+        receipt: TxReceipt = self._submit_knowledge_asset(
+            paranet_knowledge_asset_storage,
+            paranet_knowledge_asset_token_id,
+            knowledge_asset_storage,
+            knowledge_asset_token_id,
+        )
+
+        return {
+            "UAL": ual,
+            "paranetUAL": paranet_ual,
+            "paranetId": Web3.to_hex(
+                Web3.solidity_keccak(
+                    ["address", "uint256"],
+                    [knowledge_asset_storage, knowledge_asset_token_id],
+                )
+            ),
+            "operation": json.loads(Web3.to_json(receipt)),
+        }
+
+    _transfer = Method(BlockchainRequest.transfer_asset)
+
+    def transfer(
+        self,
+        ual: UAL,
+        new_owner: Address,
+    ) -> dict[str, UAL | Address | TxReceipt]:
+        token_id = parse_ual(ual)["token_id"]
+
+        receipt: TxReceipt = self._transfer(
+            self.manager.blockchain_provider.account,
+            new_owner,
+            token_id,
+        )
+
+        return {
+            "UAL": ual,
+            "owner": new_owner,
+            "operation": json.loads(Web3.to_json(receipt)),
+        }
+
+    _burn_asset = Method(BlockchainRequest.burn_asset)
+
+    def burn(self, ual: UAL) -> dict[str, UAL | TxReceipt]:
+        token_id = parse_ual(ual)["token_id"]
+
+        receipt: TxReceipt = self._burn_asset(token_id)
+
+        return {"UAL": ual, "operation": json.loads(Web3.to_json(receipt))}
+
+    _get_latest_assertion_id = Method(BlockchainRequest.get_latest_assertion_id)
+
+    async def get(self, ual: UAL, options: dict = None) -> dict:
+        if options is None:
+            options = {}
+
+        arguments = self.input_service.get_asset_get_arguments(options)
+
+        max_number_of_retries = arguments.get("max_number_of_retries")
+        frequency = arguments.get("frequency")
+        state = arguments.get("state")
+        include_metadata = arguments.get("include_metadata")
+        content_type = arguments.get("content_type")
+        validate = arguments.get("validate")
+        output_format = arguments.get("output_format")
+        hash_function_id = arguments.get("hash_function_id")
+        paranet_ual = arguments.get("paranet_ual")
+        subject_ual = arguments.get("subject_ual")
+
+        ual_with_state = f"{ual}:{state}" if state else ual
+        result = await self.node_service.get(
+            ual_with_state,
+            content_type,
+            include_metadata,
+            hash_function_id,
+            paranet_ual,
+            subject_ual,
+        )
+        get_public_operation_id = result.get("operationId")
+        get_public_operation_result = await self.node_service.get_operation_result(
+            get_public_operation_id,
+            Operations.GET.value,
+            max_number_of_retries,
+            frequency,
+        )
+
+        if subject_ual:
+            if get_public_operation_result.get("data"):
+                return {
+                    "operation": {
+                        "get": get_operation_status_object(
+                            get_public_operation_result, get_public_operation_id
+                        ),
+                    },
+                    "subject_ual_pairs": get_public_operation_result.get("data"),
+                }
+            if get_public_operation_result.get("status") != "FAILED":
+                get_public_operation_result["data"] = {
+                    "errorType": "DKG_CLIENT_ERROR",
+                    "errorMessage": "Unable to find assertion on the network!",
+                }
+                get_public_operation_result["status"] = "FAILED"
+
+            return {
+                "operation": {
+                    "get": get_operation_status_object(
+                        get_public_operation_result, get_public_operation_id
+                    ),
+                },
+            }
+        metadata = get_public_operation_result.get("data")
+        assertion = get_public_operation_result.get("data", {}).get("assertion", None)
+
+        if not assertion:
+            if get_public_operation_result.get("status") != "FAILED":
+                get_public_operation_result["data"] = {
+                    "errorType": "DKG_CLIENT_ERROR",
+                    "errorMessage": "Unable to find assertion on the network!",
+                }
+                get_public_operation_result["status"] = "FAILED"
+
+            return {
+                "operation": {
+                    "get": get_operation_status_object(
+                        get_public_operation_result, get_public_operation_id
+                    ),
+                },
+            }
+
+        if validate:
+            is_valid = True  # #TODO: Implement assertion validation logic
+            if not is_valid:
+                get_public_operation_result["data"] = {
+                    "error_type": "DKG_CLIENT_ERROR",
+                    "error_message": "Calculated root hashes don't match!",
+                }
+
+        formatted_assertion = "\n".join(
+            assertion.get("public", [])
+            + (
+                assertion.get("private")
+                if isinstance(assertion.get("private"), list)
+                else []
+            )
+        )
+
+        formatted_metadata = None
+        if output_format == OutputTypes.JSONLD.value:
+            formatted_assertion = self.to_jsonld(formatted_assertion)
+
+            if include_metadata:
+                formatted_metadata = self.to_jsonld("\n".join(metadata))
+
+        if output_format == OutputTypes.NQUADS.value:
+            formatted_assertion = self.to_nquads(
+                formatted_assertion, DEFAULT_RDF_FORMAT
+            )
+            if include_metadata:
+                formatted_metadata = self.to_nquads(
+                    "\n".join(metadata), DEFAULT_RDF_FORMAT
+                )
+
+        result = {
+            "assertion": formatted_assertion,
+            "operation": {
+                "get": get_operation_status_object(
+                    get_public_operation_result, get_public_operation_id
+                ),
+            },
+        }
+
+        if include_metadata and metadata:
+            result["metadata"] = formatted_metadata
+
+        return result
+
+    # _extend_storing_period = Method(BlockchainRequest.extend_asset_storing_period)
+
+    # async def extend_storing_period(
+    #     self,
+    #     ual: UAL,
+    #     additional_epochs: int,
+    #     token_amount: Wei | None = None,
+    # ) -> dict[str, UAL | TxReceipt]:
+    #     parsed_ual = parse_ual(ual)
+    #     blockchain_id, content_asset_storage_address, token_id = (
+    #         parsed_ual["blockchain"],
+    #         parsed_ual["contract_address"],
+    #         parsed_ual["token_id"],
+    #     )
+
+    #     if token_amount is None:
+    #         latest_finalized_state = self._get_latest_assertion_id(token_id)
+    #         latest_finalized_state_size = self._get_assertion_size(
+    #             latest_finalized_state
+    #         )
+
+    #         token_amount = await self.node_service.get_bid_suggestion(
+    #             blockchain_id,
+    #             additional_epochs,
+    #             latest_finalized_state_size,
+    #             content_asset_storage_address,
+    #             latest_finalized_state,
+    #             DefaultParameters.HASH_FUNCTION_ID.value,
+    #             token_amount or BidSuggestionRange.LOW,
+    #         )
+
+    #     receipt: TxReceipt = self._extend_storing_period(
+    #         token_id, additional_epochs, token_amount
+    #     )
+
+    #     return {
+    #         "UAL": ual,
+    #         "operation": json.loads(Web3.to_json(receipt)),
+    #     }
+
+    _get_block = Method(BlockchainRequest.get_block)
+
+    _get_assertion_size = Method(BlockchainRequest.get_assertion_size)
+
+    def to_jsonld(self, nquads: str):
+        options = {
+            "algorithm": "URDNA2015",
+            "format": "application/n-quads",
+        }
+
+        return jsonld.from_rdf(nquads, options)
+
+    def to_nquads(self, content, input_format):
+        options = {
+            "algorithm": "URDNA2015",
+            "format": "application/n-quads",
+        }
+
+        if input_format:
+            options["inputFormat"] = input_format
+        try:
+            jsonld_data = jsonld.from_rdf(content, options)
+            canonized = jsonld.to_rdf(jsonld_data, options)
+
+            if isinstance(canonized, str):
+                return [line for line in canonized.split("\n") if line.strip()]
+
+        except Exception as e:
+            raise ValueError(f"Error processing content: {e}")