app

package module
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 7, 2021 License: Apache-2.0 Imports: 22 Imported by: 0

README

Distributed Compliance Ledger

If you are interested in how to build and run the project locally, please look at README-DEV

Please note, that the only officially supported platform now is Linux. It's recommended to develop and deploy the App on Ubuntu 18.04 or Ubuntu 20.04.

Overview

DC Ledger is a public permissioned Ledger which can be used for two main use cases:

  • ZB compliance certification of device models
  • Public key infrastructure (PKI)

More information about use cases can be found in DC Ledger Overview and Use Case Diagrams.

DC Ledger is based on Tendermint and Cosmos SDK.

Main Components

The ledger consists of

  • A network of Tendermint-based validator nodes maintaining the ledger. Every validator node runs DC Ledger application code (based on Cosmos SDK) implementing the use cases.
  • The client to be used for interactions with the network of nodes (sending write and read requests). The following clients are supported:
    • CLI to communicate with the network of nodes (as a light client). The CLI is based on the Cosmos SDK. See CLI Usage section for details.
    • REST API which can be deployed as a server. The server can communicate with the nodes (as a light client). The REST API is based on the Cosmos SDK. See REST Usage section for details.
    • Tendermint's Light Client can be used for a direct communication on API level. There are currently no DC Ledger specific API libraries for various platforms and languages, but they may be provided in future. These libraries can be based on the following Light Client implementations:
  • Public UI
    • https://dcl.dev.dsr-corporation.com
    • based on the REST API
    • can be used to browse the ledger
      • please note that it doesn't show all the accounts on the ledger
      • it shows only the default (demo) accounts created on the UI server
    • for demo purposes only: can be used for sending write requests from the default (demo) accounts
    • source code and documentation are located in dcl-ui directory
Public Permissioned Ledger

DC Ledger is a public permissioned ledger in the following sense:

  • Anyone can read from the ledger (that's why it's public). See How to read from the Ledger.
  • Writes to the ledger are permissioned. See How to write to the Ledger for details. In order to send write transactions to the ledger you need:
    • Have a private/public key pair
    • Have an Account created on the ledger via ACCOUNT transaction (see Use Case Txn Auth).
      • The Account stores the public part of the key
      • The Account has an associated role. The role is used for authorization policies.
    • Sign every transaction by the private key.
  • PoA (proof of authority) approach is used for adding new validator nodes to the network (see Add New Node Use Case) and Running Node Instructions.

How To

CLI Usage

A full list of all CLI commands can be found there: cli-help.md.

Please configure the CLI before using (see how-to.md).

If write requests to the Ledger needs to be sent, please make sure that you have an Account created on the Ledger with an appropriate role (see how-to.md).

Sending read requests to the Ledger doesn't require an Account (Ledger is public for reads).

REST Usage

A REST API server is a CLI run in a REST mode: dclcli rest-server --chain-id <chain_id>.

Please configure the CLI before using (see how-to.md).

A list of all REST API calls can be found in transactions.md.

Details on how a REST API can be used for write and read requests can be found in How to write to the Ledger and How to read from the Ledger.

If write requests to the Ledger needs to be sent, please make sure that you have an Account created on the Ledger with an appropriate role (see how-to.md).

Sending read requests to the Ledger doesn't require an Account (Ledger is public for reads).

Instructions

After the CLI or REST API is configured and Account with an appropriate role is created, the following instructions from how-to.md can be used for every role (see Use Case Diagrams):

  • Trustee
    • propose new accounts
    • approve new accounts
    • propose revocation of accounts
    • approve revocation of accounts
    • propose X509 root certificates
    • approve X509 root certificates
    • propose revocation of X509 root certificates
    • approve revocation of X509 root certificates
    • publish X509 certificates
    • revoke X509 certificates
  • CA
    • propose X509 root certificates
    • publish X509 certificates
    • revoke X509 certificates
  • Vendor
    • publish device model info
    • publish X509 certificates
    • revoke X509 certificates
  • Test House
    • publish compliance test results
    • publish X509 certificates
    • revoke X509 root certificates
  • ZB Certification Center
    • certify or revoke certification of device models
    • publish X509 certificates
    • revoke X509 certificates
  • Node Admin
    • add a new Validator node
    • publish X509 certificates
    • revoke X509 certificates
Deploy a network of validator nodes

One can either deploy its own network of validator nodes or join one of the persistent DC Ledger Networks.

  • If you want to deploy your own network for debug purposes, you can use the provided Ansible Playbook: ansible/readme.md.
  • If you want to join an existing network (either a custom or persistent) as a validator node, please follow the Running a Validator Node instructions.
  • If you want to deploy your own persistent network, you will need to create a genesis node and a genesis file first as described in Running a Genesis Validator Node. After this more nodes can be added by following the Running a Validator Node instructions. Please note, that Running a Genesis Validator Node describes the case when the genesis block consist of a single node only. This is done just for simplicity, and nothing prevents you from adding more nodes to the genesis file by adapting the instructions accordingly.
  • If you want to join an existing network as an observer node, please follow the Running an Observer Node instructions.

A recommended way for deployment and client connection: diagram

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	// default home directories for the application CLI.
	DefaultCLIHome = os.ExpandEnv("$HOME/.dclcli")

	// DefaultNodeHome sets the folder where the applcation data and configuration will be stored.
	DefaultNodeHome = os.ExpandEnv("$HOME/.dcld")
)
View Source 
var ModuleBasics = module.NewBasicManager(
	auth.AppModuleBasic{},
	validator.AppModuleBasic{},
	genutil.AppModuleBasic{},
	model.AppModuleBasic{},
	compliance.AppModuleBasic{},
	compliancetest.AppModuleBasic{},
	pki.AppModuleBasic{},
	vendorinfo.AppModuleBasic{},
)

ModuleBasics is in charge of setting up basic module elemnets.

Functions

func InitKeepers 

func InitKeepers(app *dcLedgerApp, keys map[string]*sdk.KVStoreKey)

func InitModuleManager 

func InitModuleManager(app *dcLedgerApp)

func MakeAuthKeeper 

func MakeAuthKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) auth.Keeper

func MakeCodec 

func MakeCodec() *codec.Codec

MakeCodec generates the necessary codecs for Amino.

func MakeComplianceKeeper 

func MakeComplianceKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) compliance.Keeper

func MakeCompliancetestKeeper 

func MakeCompliancetestKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) compliancetest.Keeper

func MakeModelKeeper 

func MakeModelKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) model.Keeper

func MakePkiKeeper 

func MakePkiKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) pki.Keeper

func MakeValidatorKeeper 

func MakeValidatorKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) validator.Keeper

func MakeVendorInfoKeeper 

func MakeVendorInfoKeeper(keys map[string]*sdk.KVStoreKey, app *dcLedgerApp) vendorinfo.Keeper

func NewDcLedgerApp 

func NewDcLedgerApp(logger log.Logger, db dbm.DB, baseAppOptions ...func(*bam.BaseApp)) *dcLedgerApp

NewDcLedgerApp is a constructor function for dcLedgerApp.

Types

type GenesisState 

type GenesisState map[string]json.RawMessage

GenesisState represents chain state at the start of the chain. Any initial state (account balances) are stored here.

func NewDefaultGenesisState 

func NewDefaultGenesisState() GenesisState

Source Files

View all Source files

Directories

Path Synopsis
cmd
dclcli command
dcld command
settings
integration_tests
constants
utils
restext
key/rest
proxy/rest
tx/rest
utils
cli
conversions
functions
pagination
rest
validator
x
auth
auth/client/cli
auth/client/rest
auth/internal/keeper
auth/internal/types
compliance
compliance/client/cli
compliance/client/rest
compliance/internal/keeper
compliance/internal/types
compliancetest
compliancetest/client/cli
compliancetest/client/rest
compliancetest/internal/keeper
compliancetest/internal/types
genutil
genutil/client/cli
genutil/types
model
model/client/cli
model/client/rest
model/internal/keeper
model/internal/types
pki
pki/client/cli
pki/client/rest
pki/internal/keeper
pki/internal/types
pki/internal/x509
validator
validator/client/cli
validator/client/rest
validator/internal/keeper
validator/internal/types
vendorinfo
vendorinfo/client/cli
vendorinfo/client/rest
vendorinfo/internal/keeper
vendorinfo/internal/types

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.