Energy Web Documentation
  • Energy Web Ecosystem
  • Launchpad by Energy Web
  • EWC Validator Documentation
  • Community Ressources
  • Legacy documentation
  • Welcome to Energy Web
  • Glossary
  • Solutions 2023
    • ↔️Data Exchange
      • Data Exchange Overview
      • Data Exchange Architecture
      • Use Cases and Refrence Implementations
        • Digital Spine for Electricity Markets
          • Digital Spine Integration Client Deployment Guide - from Azure marketplace
        • E-Mobility Management
    • 🔌Open Charging Network
      • Create and Manage an OCN Identity
      • Connect an OCPI/OCN Party to a Node
        • 1. Make your backend service OCN-ready
        • 2. Select an OCN Node and register in OCN Registry
        • 3. Manage your Whitelist and Blacklist
        • 4. Connect your service to an OCN Node
      • Run an OCN Node
      • Use the OCN Service Interface
        • Offer an OCN Service
        • Sign up for an OCN Service
      • Develop on the Test Network
      • Develop on the Production Network
      • Open Source Development
        • Maturity Model, Feature Roadmap and Releases
        • Developer Community Calls
      • E-Mobility Dashboard v0.1
  • EW-DOS Technology Components 2023
    • EW-DOS Overview
    • Worker Nodes
      • Worker Node Process Diagrams
      • Worker Node Architecture
      • Worker Node Guides
        • Deploy Worker Nodes
        • Customize Worker Logic
    • Identity and Access Management (IAM)
      • IAM Guides
        • Implement an SSI Hub instance
        • Verifiable Credential API
        • Sign-In with Ethereum
        • Using Switchboard
          • Switchboard Transaction Cost Estimates
      • IAM Patterns
        • Assets as Ownable Smart Contracts
        • Credential Lifecycle
        • Credential Metadata
        • SSI Credential Governance using ENS Domains
      • IAM Libraries
      • SSI Hub
      • Switchboard Application
    • Decentralized Data Hub (DDHub)
      • DDHub Message Broker
      • DDHub Client Gateway
      • DDHub Patterns
        • Channels and Topics
      • DDHub Guides
    • Green Proofs Contracts
    • Energy Web X
    • The Energy Web Chain
      • EWC Overview
      • System Architecture
        • Proof-of-Authority Consensus Mechanism
        • System Contracts
          • Name Registry
          • Holding Contract
          • Block Reward Contract
          • Validator-Set Contracts
        • Validator Node Architecture
      • Energy Web Block Explorer
      • Validator Node Installation Specifications
        • Volta Test Network: Validator Node Installation
      • Energy Web Chain Governance
      • EWC Guides and Tutorials
        • Getting started with Energy Web Chain
        • Developing on the Volta Test Network and Main Network (Energy Web Chain)
        • Run a Local RPC Node
          • Run RPC Node using Nethermind client
        • Deploy a Smart Contract on Volta with Remix
        • Interacting with Smart Contracts in EW-DOS
        • Set up MetaMask to interact with Energy Web Chain
        • Using the Ethereum Name Service
        • Using Oracles
      • Energy Web Token (EWT)
  • 🧠Foundational Concepts
    • Open-Source Software
    • Scaling Access to Grid Flexibility
    • Facilitating Clean Energy Purchases
    • Ethereum
      • Transactions and Transaction Costs
    • Self-Sovereign-Identity
      • Self-Sovereign Use Case Interaction
    • Cryptocurrency Wallets
      • Software cryptocurrency wallets
        • Metamask
        • Mycrypto wallet
      • Hardware cryptocurrency wallets
      • Hierarchical Deterministic (HD) Wallets
Powered by GitBook
On this page
  • Overview
  • OCN Use Cases
  • Implementing the Open Charge Point Interface Protocol
  • OCPI Hub Concept
  • The OCN as a Decentralized Solution
  • OCN Nodes
  • The OCN Registry
  • Benefits of a Decentralized Network
  • Getting Started
  • Create an OCN Identity
  • Connect your service to a node
  • Run your own OCN node
  • Offer a third-party service via the OCN Service Interface
  • OCN Technical Components
  • OCN Node
  • OCN Bridge
  • OCN Registry
  • OCN Notary
  • OCN Tools
Export as PDF
  1. Solutions 2023

Open Charging Network

An open and decentralized communication network for digital eMobility services.

PreviousE-Mobility ManagementNextCreate and Manage an OCN Identity

Last updated 2 years ago

Overview

The Open Charging Network (OCN) is a decentralized eRoaming hub.

Using the , the OCN provides the network for communication between , , and other industry players involved in EV charging services.

The primary purpose of the OCN is to make technical connection between these EV charging industry players as simple and secure as possible, without creating technical and commercial lock-in effects.

The two primary actors are eMobility Service Provider (eMSP) and Charge Point Operator.

  • eMobility Service Providers (eMSPs) provide EV drivers with network access to electric vehicle charge points, typically through software applications and platforms. Their primary end-user is the EV driver.

  • Charge Point Operators (CPOs) install and manage the physical charge point operation infrastructure and the network operations that allow for EV-charging. Their primary end-users are e-MSPs, who in turn make these charge points available to EV drivers through their products and services.

You can see a full list of roles in the .

The OCN is made up of a distributed network of server nodes running the . These nodes share a registry that stores network participant data, which exists as a that is deployed on the .

Below you will find an overview of OCN functionality and technical components, as well as how to using the OCN.

Access the full OCN technical documentation or download the PDF below:

OCN Use Cases

  • Authorization

  • Reservation

  • Tariff Information

  • Billing Stating Charge Point Information

  • Real-time charge point status information

  • Real-time charge session information

  • Charge Detail Record (CDR) information

  • Remote start/stop

  • Smart charging

  • Calibration law (eichrect) support

  • Platform monitoring

Implementing the Open Charge Point Interface Protocol

These actors implement the OCPI on their back-end IT infrastructure.

OCPI Hub Concept

This allows end-users to, for example, locate and use EV chargers that are managed by one CPO, even if they are using an application created by a different CPO or eMSP. It provides a broader network of access to services and charge points that are critical for eRoaming.

The OCPI is broken down into modules that provide the protocol's core functionality, which includes:

  1. Bilateral (peer-to-peer) and multilateral communication

  2. Real-time information about charge point locations, availability and pricing

  3. Exchange of data related to charging services (i.e. Charging Data Records)

  4. Mobile access to Charge Points

The OCN as a Decentralized Solution

The OCN performs the role of communication hub as described by the OCPI 2.2, meaning OCN nodes handle the communication and message routing between relevant parties (CPOs, eMSPs, service providers).

The primary difference between the OCN and traditional hub networks is that the OCN is an open and decentralized network:

  1. There is no centralized server that participants must connect to in order to use the network. The OCN is comprised of a distributed network of server nodes, and anyone is able to run or connect their service to a node. Nodes are responsible for brokering messages between parties.

OCN Nodes

A node consists of a message broker, blockchain wallet, and connection to an Energy Web Chain node. The network of nodes together constructs the Open Charging Network.

Anyone can run a node if they choose, or connect to a node remotely.

The OCN Registry

A participant is identified in the Registry by their public key, which is mapped to the public url of the OCN node that they are registered with:

// address => domain name/url
mapping(address => string) private nodeOf;

Users can interact with the Registry smart contract to fetch, set or update their registered node or their party information.

Benefits of a Decentralized Network

Most implementations of OCPI are centralized applications, where a third-party platform provides the 'hub' network connection between multiple eMSPs and CPOs that enable actors to send and receive information.

This approach brings certain advantages and convenience, but also creates commercial and technical limitations:

  • Participant identities are siloed within a network, creating a lock-in effect to that specific network

  • Network service providers can choose to not provide particular services on a proprietary platform, creating commercial restraints for the network's users

  • Centralized networks are typically less resilient and scalable than decentralized networks

  • Participation can be restrictive due to cost or commercial agreements

A decentralized, open source architecture provides a solution for some of these challenges:

  • Network participant identities are accessible to anyone on the network through a public, shared registry, reducing network and user silos.

Getting Started

OCN Technical Components

OCN Node

Provides an entry point to the network, which enables communication with other eRoaming parties using the Open Charge Point Interface 2.2.

OCN Bridge

A pluggable OCPI API interface for eRoaming parties with no OCPI API.

OCN Registry

The shared address, identity and permissions system of the OCN.

Utilities to securely verify and sign OCN messages using public/private cryptographic key-pairs.

Currently targeting JavaScript and JVM only.

OCN Tools

Common tools for aiding development of applications built on top of the OCN.

The OCN supports all use-cases described in the , including:

The OCN implements the . This protocol provides a common communication infrastructure for , and other market participants involved in supplying and delivering electric vehicle charging services.

The OCPI protocol can be used for peer-to-peer (bilateral) communication, but is more widely used as a communication that connects multiple CPOs with multiple eMSPs.

Access the full OCPI technical documentation or download the PDF below:

There is no centralized database for storing participant user information. This data is stored in a on the , which is a public, decentralized blockchain. Anyone is able to register with this contract, provided they have required information. The OCN provides a to manage messaging preferences.

In the context of the OCN, a 'node' is a server running an instance of. Each node of the OCN forwards OCPI and OCN messages between parties based on a routing system and a shared registry that is anchored on the Energy Web Chain in a smart contract. As mentioned above, these parties are typically Charge Point Operators or eMobility Service Providers.

TO DO: GET PERMISSION FOR THIS PHOTO

Read more about how to run a node . Read more about how to connect to a node

OCN parties (those who are using the network - eMSPs, CPOs, third party service providers) are identified in the that is deployed on the Energy Web Chain. Every node on the OCN has access to this smart contract.

Parties are required to sign messages that they send through the OCN with their private key as a means for security and verification. Learn more about how to create a public/private key pair and register as an OCN party .

Anyone can register and use the network for free. (Read more about how to create an OCN identity )

Anyone can run a node. This makes the network scalable, resilient, and reduces potential points of failure. Read more about how to run a node

The OCN is open-source. Anyone can build applications and provide services on top of the network for all to use. Read more about the OCN Service interface

To get started with the OCN, you first need to create your own OCN Identity. Follow the steps outlined here:.

To connect your EV charging service to an OCN Node (as a Charge Point Operator or an eMobility Service Provider), follow the steps outlined here: .

To operate your own OCN Node, follow the steps outlined here: .

To provide a service like settlement, payment, smart charging, etc. (OCN Service) to OCN Parties (Charge Point Operators, eMobility Service Providers, etc.), follow the steps outlined here:

Repository:

The OCN bridge can be used by CPO/eMSP backends to implement the OCPI protocol, which is a , however it is not required to use the OCN Bridge to do so. Manages the OCPI interfaces, connection to an OCN client and registration with the OCN registry. JavaScript implementation only.

Repository:

The OCN Registry is a on the that contains important identifying information about registered OCN Nodes, Parties and Services. It acts as the shared address, identity and permissions system of the OCN.

Repository:

OCN Notary

Note that the already implements the OCN Notary. If you are connecting a party to an OCN node, and you are not implementing the , you will need to implement the OCN Notary in your backend setup.

Repository:

You can run a mock E-Mobility Service Provider (MSP) or Charge Point Operator (CPO) with these tools, which can be helpful for local development. Uses the as a dependency.

Repository:

🔌
OCPI 2.2 protocol
hub
here
smart contract
Energy Web Chain
whitelisting/blacklisting permissioning system
the OCN node software
here
here.
registry smart contract
source code
here
here
here
here
Create an OCN Identity
Create and manage an OCN Identity
Connect your service to a node
Connecting an OCPI/OCN Party to a Node
Run your own OCN node
Run an OCN node
Offer a third-party service via the OCN Service Interface
Use the OCN Service Interface.
https://github.com/energywebfoundation/ocn-node
required step in connecting a backend to an OCN node
https://github.com/energywebfoundation/ocn-bridge
smart contract
Energy Web Chain
https://github.com/energywebfoundation/ocn-registry
https://github.com/energywebfoundation/ocn-notary
https://github.com/energywebfoundation/ocn-tools
OCN Bridge
OCN Bridge
OCN Bridge
Open Charge Point Interface 2.2
OCPI 2.2 documentation 2.3. EV Charging Market Roles
OCN Node software
smart contract
Energy Web Chain
here
get started
Use Cases
Implementing the Open Charge Point Interface Protocol
The OCN as a decentralized solution
Get started using the OCN
OCN technical components
Open Charge Point Interface (OCPI) 2.2 protocol
Charge Point Operators (CPOs)
eMobility Service Providers (eMSPs)
e-mobility service providers
Charge Point Operators
1MB
OCN-Documentation-v1.1.pdf
pdf
OCN Technical Documentation
1MB
OCPI-2.2-d2.pdf
pdf
OCPI Technical Documentation