Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Consent

description

This class contains the implementation of the consent contract which is used to discover consent requests in the FOLIO dApp.

Use this class whenever you are interpreting an operation of consent for your dApp. Also, an instance of this class is created using Factory.createFromJSON given a contract signature that matches: /:consent$/ (ends with).

Parameters

Following inputs apply to the Consent contract class:

Input Type Required? Description
dappIdentifier string Required The dApp identifier, e.g. "folio".
level string Required The access level that must be granted upon accepting this consent request, i.e. must contain on of: view, edit or delete
scope string Required Contains the transaction hash of the confirmed transaction which links to metadata about the shared document.
purpose string Required Contains an encrypted message from the consent requester which should describe the purpose of getting access to the shared document.



example

Using the Consent contract class

// creating a reward contract
const contract: Consent = new Consent({
  dappIdentifier: "folio",
  level: "read",
  scope: "...",
  purpose: "..."
});



Other links

ConsentParameters | Contract | Factory

since

v1.0.0

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • Construct a consent contract. Note that some of the inputs are required.

    The consent contract requires inputs including the dappIdentifier, the level of access requested, the scopeof access and an encrypted purpose that can be decrypted only by the recipient. Refer to the above parameters description for more details.

    access

    public

    Parameters

    • inputs: ConsentParameters

      The inputs that are used during execution ("arguments").

    • version: number = 1

      (Optional) The contract version number (defaults to 1).

    • parameters: NetworkParameters = ...

      (Optional) The network parameters ("connection").

    Returns Consent

Properties

inputs

inputs: ConsentParameters

parameters

parameters: NetworkParameters = ...

Readonly version

version: number = 1

Accessors

body

  • This method should return an ObjectLiteral that consists of the body of the contract, e.g. in the Consent contract the body contains a date, a scope and a purpose.

    In the consent contract, we always include the level, scope and purpose fields.

    Note that by modifying the required fields of a contract's body, you must also update the version of the contract to prevent inconsistencies in operations.

    access

    public

    abstract

    Returns ObjectLiteral

    An object that consists of custom fields related to the scope of the contract.

Private dApp

  • get dApp(): string

  • This getter method transforms the provided dappIdentifier input into a slug. The characters set for valid slugs includes: lowercase alpha-numerical characters, underscores and hyphens. Additionally, multiple hyphens in a series are replaced for single hyphens.

    This method is used internally to determine a dapp identifier that is compliant to a strict characters set.

    access

    private

    Returns string

    A slugified dApp identifier as present on-chain.

header

  • This getter method prepares the contract header. The header consists of the contract signature and version of the contract.

    The contract header is always attached to contracts using the toJSON method.

    access

    public

    Returns ObjectLiteral

    An object that consists of the contract signature and version.

identifier

  • get identifier(): string

  • This method should return a string that is used as the identifier of the contract being executed.

    This identifier will be concatenated with the dApp identifier to form the contract signature.

    This method should return an identifier that is unique across one dApp, i.e. it is OK to re-define an consent contract in a different dApp than FOLIO.

    access

    public

    abstract

    Returns string

    A contract identifier as present on-chain in the contract signature.

payload

  • This getter method returns the contract payload as it is attached inside transfer transaction messages.

    This method is used internally to determine a contract payload that is used to produce JSON in toJSON.

    access

    public

    Returns ObjectLiteral

    A full contract payload (with "contract" and "version").

signature

  • get signature(): string

  • This getter method returns the contract signature as it is attached inside contracts' JSON payloads.

    This method is used internally to determine a contract signature that is included in the contract header.

    access

    public

    Returns string

    A contract signature, e.g. "elevate:auth".

Methods

Protected getMosaics

  • getMosaics(): Mosaic[]

  • This method should return an array of Mosaic instances as defined in @dhealth/sdk. The transaction assets consists of a set of assets that are attached to a transaction on dHealth Network.

    Note that the Consent contract does not attach any mosaics to the transfer transaction.

    access

    protected

    Returns Mosaic[]

    An array of assets and amounts thereof that are attached to a transfer transaction.

Protected getRecipientAddress

  • Helper method that creates an Address instance out of transaction parameters. Parameters may include a recipientPublicKey or a recipientAddress. If both are provided, the recipientAddress takes precedence.

    Note that in the case of providing a `recipientPublicKey, this method uses the internal Contract.parameters to determine the network identifier.

    Parameters

    • parameters: TransactionParameters

      A configuration object that is passed to the creation process of the dHealth Network Transaction.

    Returns Address

    A dHealth Network Account Address from @dhealth/sdk.

toJSON

  • toJSON(): string

  • This method creates a JSON payload using the contract header and the custom body fields, as defined in child classes.

    Note that the resulting string is attached as is to the transfer transaction on dHealth Network.

    access

    public

    Returns string

    A JSON payload that can be attached to transfer transactions.

toTransaction

  • This method should return a prepared Transaction object from @dhealth/sdk. This transaction will not be broadcast or signed yet and this method can be called without requiring an internet connection ("off-line").

    Note that by modifying the transaction that is created when executing a contract, you must also update the version of the contract to prevent inconsistencies in operations.

    access

    public

    abstract

    Parameters

    • parameters: TransactionParameters

      A configuration object that is passed to the creation process of the dHealth Network Transaction.

    Returns TransferTransaction

    A prepared (but unsigned) dHealth Network Transaction.

Static fromTransaction

  • This method uses a Transaction child class from which it reads the contract JSON payload.

    Invalid JSON errors will trigger the InvalidContractError exception to be thrown.

    This method is used internally to transform a Transaction object into an ObjectLiteral by making sure that the JSON payload uses valid JSON formatting rules and lives inside either of: the transfer transaction message or the aggregate bundle's first transfer transaction's message.

    access

    protected

    throws

    {InvalidContractError} Given no contract JSON payload is found or given a contract JSON payload that contains invalid JSON and could not get parsed into a contract.

    Parameters

    • transaction: Transaction

      A transaction object that contains the full definition of the executed contract.

    Returns ObjectLiteral

    A parsed contract consists of an object of type ObjectLiteral.

Generated using TypeDoc