Note
An identity authorized to manage other identities can always create identities with write access to the ledger.
Xooa Ledger Database (XLDB) is comprised of two databases: A mutable, document datastore called the State Database (or World State), and an immutable database called the transaction database or simply Ledger. The Ledger is append only, and is cryptographically protected against modifications using blockchain technology.
World State provides:
The transactions tab allows to browse activity in the ledger. You can:
The key used to save the data in the ledger.
The value saved in the ledger.
Denotes if the transaction was to delete the value from the ledger.
The time at which the transaction was made.
A unique transaction ID of the current transaction.
Endpoint for calling functions in the smart contract.
URL for testing API endpoints. You can also test smart contract function calls.
Test the API endpoints for XLDB upon authorizing using identity API token
The history of API calls that have been made to the app filtered by the date range specified.
The time at which API call was made.
Request method for the API call.
The endpoint called.
The time taken to get the response for the API call.
The response code received by the user for the API call.
The IP address from where the API call was generated.
Identity used to make the API call.
Provides a history of activity related to the app. Activities include things like redeploying the app, identity-related actions, and upgrades.
An identity is someone with an API token and a given set of permissions to access the APIs for the app. From the Identities tab, you can perform actions such as:
A unique identifier of the identity. This is not the API token of the identity.
A descriptive name for the identity. Notice that the name does not need to be unique.
Determines if an identity with the API token can only read the ledger or also write to it.
Determines if the API token for this identity authorizes them to create other identities. Typically, such an identity represents an administrator.
An identity authorized to manage other identities can always create identities with write access to the ledger.
Local date and time for when a token was last generated for the identity.
Perform actions on the identity such as:
The asset management provides the APIs to maintain the assets and their ownership. An asset comprises of mutable and immutable components which are asset details and asset properties respectively.
World State provides:
The transactions tab allows to browse activity in the ledger. You can:
The key can be owner or asset id.
The value contains the detail about the asset and the owner.
The time at which the transaction was made.
A unique transaction ID of the current transaction.
Endpoint for calling functions in the smart contract for managing assets.
URL for testing API endpoints. You can also test smart contract function calls.
Test the API endpoints for managing assets upon authorizing using identity API token
The history of API calls that have been made to the app filtered by the date range specified.
The time at which API call was made.
Request method for the API call.
The endpoint called.
The time taken to get the response for the API call.
The response code received by the user for the API call.
The IP address from where the API call was generated.
Identity used to make the API call.
Provides a history of activity related to the app. Activities include things like redeploying the app, identity-related actions, and upgrades.
An identity is someone with an API token and a given set of permissions to access the APIs for the app. From the Identities tab, you can perform actions such as:
A unique identifier of the identity. This is not the API token of the identity.
A descriptive name for the identity. Notice that the name does not need to be unique.
Determines if an identity with the API token can only read the ledger or also write to it.
Determines if the API token for this identity authorizes them to create other identities. Typically, such an identity represents an administrator.
An identity authorized to manage other identities can always create identities with write access to the ledger.
Local date and time for when a token was last generated for the identity.
Perform actions on the identity such as:
The Details tab provides information about your app. Some of the information is descriptive and some of it needed to identify the API endpoint for executing functions in the smart contract.
Unique ID for this app.
The display name of your app. The default value is in the Xooa.yaml file, but can be overridden .
Optional description. The default value is in the Xooa.yaml file, but can be overridden.
Optional. The default value is in the Xooa.yaml file, but can be overridden.
The GitHub branch from which the smart contract has been deployed.
A counter registering each upgrade of the app.
Blockchain technology used to deploy your smart contract.
Programming language of the smart contract. The default value is in the Xooa.yaml file, but can be overridden.
World State provides:
The transactions tab allows to browse activity in the ledger. You can:
The key used to save the data in the ledger.
The value saved in the ledger.
Denotes if the transaction was to delete the value from the ledger.
The time at which the transaction was made.
A unique transaction ID of the current transaction.
Endpoint for calling functions in the smart contract.
URL for testing API endpoints. You can also test smart contract function calls.
Test the API endpoints for the custom smart contract upon authorizing using identity API token
The history of API calls that have been made to the app filtered by the date range specified.
The time at which API call was made..
Request method for the API call.
The endpoint called.
The time taken to get the response for the API call.
The response code received by the user for the API call.
The IP address from where the API call was generated.
Identity used to make the API call.
Provides a history of activity related to the app. Activities include things like redeploying the app, identity-related actions, and upgrades.
An identity is someone with an API token and a given set of permissions to access the APIs for the app. From the Identities tab, you can perform actions such as:
A unique identifier of the identity. This is not the API token of the identity.
A descriptive name for the identity. Notice that the name does not need to be unique.
Determines if an identity with the API token can only read the ledger or also write to it.
Determines if the API token for this identity authorizes them to create other identities. Typically, such an identity represents an administrator.
An identity authorized to manage other identities can always create identities with write access to the ledger.
Local date and time for when a token was last generated for the identity.
Perform actions on the identity such as:
View smart contract logs from the last 10 minutes. What events are logged depends on how you have coded your smart contract. Click here for details on Hyperledger Fabric’s logging.
Delete your app from xooa or update your app from GitHub.
Refresh the app with the smart contract code currently in the GitHub repository used for creating this app.
Deleting the app will remove the end point and related chaincode from Xooa. This operation is irreversible and you will never be able to access the app data again on Xooa. If you need to download the data, use an External Peer. External peers are not affected by this operation.
Blockchain data may be exported outside Xooa by deploying an External Peer. Once syncing is complete all your data will be available on the External Peer. You will have to create a new blockchain network because we do not export crypto material beyond what is is provided to download on the console for bootstrapping an External Peers to connect to Xooa network and sync your blockchain.
You can also download external peer for the ledger that has been shared with you. The peer will keep in sync with all the shared ledgers as well.
We provide a Docker Compose file. This file runs peer container in your local machine.
The downloaded peer is coupled with the External Ledger. It can be used to view transactions by visiting http://<peer ip>:8080/
Deleting a peer will revoke the access of external peer. It will no longer sync with Xooa. Access to already synced data will remain available with the external peer.
The Ledger tab allows you to browse activity for your Xooa’s ledger, custom contract ledger and shared ledgers.
You can:
Overview of current and recent activity on the ledger.
Details about blocks generated in the ledger.
Details of transactions.
Sharing allows you to provide access to the blockchain ledger explorer to other Xooa users. Enter the email address associated with the account with which they log in to Xooa and they will get an email inviting them to share your ledger.
Ledgers that are shared with you will appear in your ledger explorer and you can select between your ledger and shared ledgers:
You can revoke access to your ledger explorer by clicking Share, and then clicking Revoke next to the email you want to stop sharing with.
A deployment API token holds a set of permissions to access the deployment APIs. From the Deployment Token tab, you can perform actions such as:
A descriptive label for the token. Notice that the label needs to be unique.
Local date and time for when a token was generated.