Centrifuge Gateway
is a user interface that showcases the go-centrifuge node API. It's main purpose is to act as a testing and rapid prototyping tool for simple integrations with Centrifuge OS.
Centrifuge Gateway
allows you to:
- Create and manage different users
- Create, anchor and exchange customised financial documents
- Mint and transfer non-fungible tokens (NFTs) based on these documents
- Request and accept funding based on these documents
Getting help: Head over to our developer documentation at developer.centrifuge.io to learn more about Centrifuge OS and the Centrifuge Node. If you have any questions, feel free to join our slack channel.
DISCLAIMER: The code released here presents a very early alpha version that should not be used in production and has not been audited. Use this at your own risk.
Gateway requires a Centrifuge Node to run. See here, how to set-up and configure a Centrifuge Node and interact with it.
Make sure you configure the node's webhooks to call your future Gateway instance.
By default this will be localhost:3001/webhooks
.
After the node is up and running open packaes/server/src/config/ts
update the centrifugeUrl
,ethNetwork
and the account
for the admin user to match your node.
const config = {
// URI for centrifuge node
centrifugeUrl: env.CENTRIFUGE_URL || 'http://127.0.0.1:8082',
// Port on which the application will run
applicationPort: env.APPLICATION_PORT || '3001',
sessionSecret: env.SESSION_SECRET || 'centrifuge',
//We use replace to create a new database without changing the deployment config
dbPath: env.DB_PATH ? env.DB_PATH.replace('db', 'db1') : './db',
// Default admin user that will be created
admin: {
name: env.CENTRIFUGE_ADMIN_USER || 'admin',
email: env.CENTRIFUGE_ADMIN_EMAIL || 'test@test.org',
password: env.CENTRIFUGE_ADMIN_PASSWORD || 'admin',
// Centrifuge Identity Address
account: env.CENTRIFUGE_ADMIN_ACCOUNT || '0xBeaB9D94D23Ff609b92b8C739f4EE13bCe918F8c',
permissions: [PERMISSIONS.CAN_MANAGE_USERS, PERMISSIONS.CAN_MANAGE_SCHEMAS, PERMISSIONS.CAN_MANAGE_DOCUMENTS],
},
inviteOnly: Boolean(env.INVITE_ONLY || true),
ethNetwork: env.ETH_NETWORK || 'mainnet',
ethProvider: env.ETH_PROVIDER || 'https://mainnet.infura.io/v3/55b957b5c6be42c49e6d48cbb102bdd5',
};
npx lerna bootstrap
npm run start
Gateway is designed to use a multi tenancy Centrifuge Node. This means that all accounts created with gateway will have a on chain Identity where the node wallet is configured as a MANAGEMENT KEY. Gateway users do not need a wallet to interact with ETH and all ETH transaction use the wallet configured on the node
A user can have the following permission
export enum PERMISSIONS {
// can create and manage user accounts
CAN_MANAGE_USERS = 'can_manage_users',
// can create and manage schemas
CAN_MANAGE_SCHEMAS = 'can_manage_schemas',
// can create and manage FlexDocs. When a user has this permission document schemas
// can be assigned to this account and he will be able to create documents
CAN_MANAGE_DOCUMENTS = 'can_manage_documents',
// Can view received FlexDocs. He does need to have schemas assigned
CAN_VIEW_DOCUMENTS = 'can_view_documents'
}
By default a newly created account is in invite mode. This means that the invited user needs to register first with his given user name / email and define a password. Then he can use these credentials to log-in. Note, that Gateway will not send emails or notifications to invited users. Also note, that there is no "forgotten password" option.
Gateway allows you to define customizable financial document schemas that can be assigned to a user with a CAN_MANAGE_DOCUMENTS
permission. This enables a user to create specific documents or do actions with those documents(Ex: Minting an NFT).
You can read and understand how Gateway schemas work here.
Every user has a simple contact list that stores Centrifuge Identities of other users. Gateway interaction with another Centrifuge Identity(Ex: Sending a document to some else) require the Centrifuge Identity to be included in the contact list. These interactions will perform a lookup in the contact list.
Centrifuge Gateway, Centrifuge Protocol and all its components are in an early stage of their development. They have a limited feature set compared to the end-vision. Not all features are implemented yet, and tradeoffs between security, speed, end-user features, and protocol flexibility are made continuously. This might and will lead to substantial changes in the future, re-architecture, addition and removal of features, as well as unexpected behavior. Use at your own risk.
Required Node Version: 12.16.1
npm install
npm run test
npm run build