evan.network Developer Documentation

Business Centers

Introduction

Business Centers are communities for working together on specific topics. They group together accounts and contracts and set a context for the work on the contracts. These contexts may be companies, projects or common interests.

Depending on the setup of the business center users may

  • Join on their own, when the Business Center is Public
  • Receive an invitation to join, when the Business Center is Private
  • Request to join, if the Business Center is Restricted

Users may join as many Business Centers they like and they all are independent working spaces with their own scope and data.

Their ÐAPPs are similar to dashboards and members can start working on contracts in the current business center or create new contracts in it.

Accounts can create a Business Center scoped profile, which is similar to a business card for that context. In it users may provide data for other members to find them and start working together or share their qualifications or certificates with the Business Center community.

Details

In a Business Center, users can execute transactions and exchange data with each other, with other organizations or with the Digital Twins of real machines. Hence, the evan.network provides the basis for company-wide, efficient and secure Industry 4.0 business models.

For the interaction between users, processes and machines, evan.network offers predefined services (Smart Contracts), which can be adapted to specific needs. The interaction with Smart Contracts takes place via ÐApps in web or mobile browsers or via API from existing IT systems, IT tools and/ or machines.

For this purpose, Smart Agents communicate with the Smart Contracts. The Smart Contracts represent the professional framework of the respective service and are developed according to the specific needs.

For example, a Smart Contract that represents a Digital Twin can include the entire life cycle of the asset and its business processes. In tangible terms, this means that the Smart Contract itself provides a kind of management shell for the various data types and manages access to the data via an encryption management and a rights-and-role model.

In the case of master data such as product properties, the actual data is stored as a JSON object encrypted with the Digital Twin keys in the storage service.

The address where the data was stored in the storage is saved in the Smart Contract. Other data are handled in a similar way, e.g. service reports.

If the service technician creates a report and wants to attach for example an image of the machine, this image is loaded into the storage in encrypted form and the corresponding address is inserted into the corresponding data area of the Digital Twin. The complete control of who may insert or read data is controlled by the owner of the Digital Twin Smart Contract, who has complete data sovereignty.

Mobile Apps Web Apps Ethereum Blockchain User Profiles Peter Lustig Hanna Hempel Fritz Kunz Keys Contacts Bookmarks ... Company Profiles Construction Carl Software Services GmbH Rental Equipment KG Keys Contacts Bookmarks ... Business Centers Agriculture IT Berlin Construction Saxony Members Bidding Calls Offers ... Factories DigitalTwinFactory ServiceFactory TaskFactory creates contracts initializes entries initializes roles Contracts DigitalTwin Service Task Contract Parameters Access Rights ... Smart Agents Edge Server Machine Agent Sensor Agent WebService Agent Connects to 3rd APIs and Blockchain

Business Center

In Business Centers, organizations, users and machines are interconnected with each other in order to interact as partners in a concrete business environment.

Network partners who join a Business Center expand their profile with specific information and features for this business environment. In addition to extended descriptive information, the profile may also contain certificates, competencies and general skills.

The Business Center is an Ethereum-based development framework and provides specific Smart Contracts for initiating, entering into and implementing business relationships. The entire cooperation between network partners via Smart Contracts within a Business Center takes place directly, i.e. without a central intermediary, and is encrypted, i.e. secure against access by unauthorized third parties.

Depending on the requirements for business relationships, Business Centers are either public, closed, or restricted.

Public Business Centers are publicly available and can be found by all users. Any user can join a public Business Center.

Private Business Centers, on the other hand, are hidden. Only on explicit invitation of a Business Center administrator, users can join.

Restricted Business Centers are publicly listed. Users can submit a request to participate, but this must be approved by an administrator of the Business Center.

Users of evan.network are not obliged to use the Business Center structure of evan.network. You can create and run your own Ethereum-based Smart Contract developments on evan.network, but using the Business Center structure makes it much easier.

To map different business relationships, evan.network offers different Smart Contract templates, which are enriched in a Business Center with the specific logic required there. Creating concrete Smart Contracts for a business relationship and initializing them with the digital identities of the users involved is a complex process. This is greatly simplified by the use of a Smart Contract factory. The factory manages all Business Center-specific Smart Contract templates, creates a configured instance of the Smart Contract and initializes this with the network partners authorized to the contract. From this point on, a direct business relationship is established between the network partners involved, which is only visible and executable for them.

Smart Contracts were developed with the goal of easy use and expansion. Each Smart Contract can be called directly from a Web3 browser using for example a name server entry.

Initially, only the manifest file (DBCP) is referenced and loaded. This file contains a standardized structure with descriptive information to make the service human and machine readable.

It also contains references to the actual Smart Contract in the blockchain and the Distributed App (ÐApp), which enables direct user interaction with the service.

In order to ensure interoperability of services, the manifest file corresponds to a standardized structure that is currently provided as an open source component (DBCP) as part of a project sponsored by the Thuringian Ministry of Economics, Science and Digital Society. This makes it possible to start an interaction with the services even without the evan.network framework.

This architecture enables the integration of any third-party Smart Contracts into an evan.network environment. Referenced via the manifest file existing Smart Contracts of other providers can be combined with evan.network-ÐApps and thus integrated into a homogeneous user experience.

Based on this architectural principle, the entire network was created. Thus, all applications the user communicates with in the evan.network, processes Smart Contracts with and makes transactions with are implemented as ÐApp.

Interaction with Smart Contracts and Business Centers

The interaction capabilities in a Business Center should enable simple interaction between end users, IT systems and machines. Starting from today’s mostly manual forms of communication, an automation of cross-company cooperation can be implemented step by step.

To interact as user or machine in evan.network, a network account is required. An account can be created directly via onboarding (self-service) or via an invitation. An invitation is sent by an existing user or Smart Contract on the network.

In the invitation, you can control whether a user is invited directly to a Business Center or to a specific Smart Contract. In addition, EVEs can be sent directly to the invited user as part of the invitation process, so that the new user is immediately ready to work in the network.

The invitation is sent either as a technical invitation via an API or by an user using an e-mail address. The invitation email contains an invitation text and a link to the onboarding ÐApp. This ÐApp guides the new user through the registration process, where he or she has to confirm e.g. terms and conditions and data protection and gets an own account with private key and Mnemonic.

After successful registration, the user has an evan.network identity with which he or she can now participate in the Business Center and Smart Contract.

Every interaction with Business Centers and Smart Contracts takes place via ÐApps. Users interact with the respective ÐApp via web or mobile browsers. ÐApps are HTML applications loaded from the blockchain and make it easy for the user to work with Smart Contracts and evan.network interactively.

To communicate with Smart Contracts from your own applications and ÐApps, evan.network provides APIs in form of a JavaScript library and developer documentation. Thus, own applications can be implemented and operated on evan.network.

For an automation of the business relations, evan.network offers APIs to all Smart Contracts. Hence, the evan.network can be connected to own systems and a direct integration of business processes can be carried out.

Furthermore, it is possible to add logic and workflow addons in the evan.network with the help of Smart Agents. They are operated by the respective Smart Agent provider and can enable workflow-supported communication of the evan.network with existing IT systems and machines.

Smart Agents can be invited into a Smart Contract, just like users, and thus receive access to its contents. The Smart Agent constantly checks the contract for changes and can automatically initiate new processes according to predefined rules as soon as it finds one.

If the user has the rights, he or she can also add content to the Smart Contract. Via Smart Agents, the invitation via email or the mobile push notifications are solved in the evan.network. They combine the “blockchain world” with other technologies.