Skip to content

Latest commit

 

History

History
98 lines (61 loc) · 11.4 KB

README.md

File metadata and controls

98 lines (61 loc) · 11.4 KB
Raw

GitHub Actions Workflow Status codecov GitHub Release Substrate version License
Twitter URL Telegram

Centrifuge

Centrifuge Chain

The layer-1 blockchain for real-world assets, built on Substrate.
Read the documentation »

About Centrifuge

Centrifuge is the infrastructure that facilitates the decentralized financing of real-world assets natively on-chain, creating a fully transparent market which allows borrowers and lenders to transact without unnecessary intermediaries. Asset pools are fully collateralized, liquidity providers have legal recourse, and the protocol is asset-class agnostic with pools for assets spanning mortgages, invoices, microlending and consumer finance. Ultimately, the protocol aims to lower the cost of borrowing for businesses around the world, while providing DeFi users with a stable source of collateralized yield that is uncorrelated to the volatile crypto markets. By bringing the entire structured credit market on-chain across securitization, tokenization, privacy, governance, and liquidity integrations, Centrifuge is building a more transparent, affordable, and limitless financial system.

Building blocks

On top of the Substrate FRAME framework, Centrifuge Chain is composed of custom pallets which can be found inside the pallets folder. The following list gives a brief overview, and links to the corresponding documentation:

  • anchors (docs): Storing hashes of documents on-chain. The documents are stored in the Private Off-chain Data (POD) node network.

  • anchors-v2 (docs): Second version of the pallet used to store document hashes on-chain.

  • block-rewards (docs): Provides means of configuring and distributing block rewards to collators as well as the annual treasury inflation.

  • bridge (docs): Connecting ChainBridge to transfer tokens to and from Ethereum.

  • collator-allowlist (docs): Tracking active collators, and allows the root account to manage this list.

  • ethereum-transaction (docs): Wrapper around the Ethereum pallet which allows other pallets to execute EVM calls.

  • fees (docs): Taking fees from accounts and sending this to the treasury, to the author, or burning them.

  • foreign-investments (docs): Enables investing, redeeming and collecting in foreign and non-foreign currencies. Can be regarded as an extension of pallet-investments which provides the same toolset for pool (non-foreign) currencies.

  • interest-accrual (docs): Keeping account of the outstanding debt through interest accrual calculations.

  • investments (docs): Provides orders for assets and allows user to collect these orders.

  • keystore (docs): Linking public keys to accounts. Supporting the operations of the offchain document consensus layer through the Centrifuge POD (Private Offchain Data) Node.

  • liquidity-pools (docs): Provides the toolset to enable foreign investments on foreign domains.

  • liquidity-pools-gateway (docs): The main handler of incoming and outgoing Liquidity Pools messages.

  • liquidity-pools-gateway-queue (docs): The queue used by the Liquidity Pools Gateway for processing inbound/outbound messages.

  • liquidity-pools-gateway-routers (docs): This crate contains the DomainRouters used by the Liquidity Pools Gateway pallet.

  • axelar-gateway-precompile (docs): Pallet that serves as an EVM precompile for incoming Liquidity Pools messages from the Axelar network.

  • liquidity-rewards (docs): Epoch based reward system.

  • loans (docs): Locking a collateral NFT into a pool allowing to borrow from the pool. The loans pallet is also used for bookkeeping loan values and outstanding debt.

  • oracle-collection (docs): Pallet used to collect and aggregate oracle values.

  • oracle-feed (docs): Pallet used to feed oracle values.

  • order-book (docs): Allows orders for currency swaps to be placed and fulfilled.

  • permissions (docs): Linking roles to accounts. It is adding and removing relationships between roles and accounts on chain.

  • pool-fees (docs): Stores all the fees related to a pool and allows for these fees to be charged.

  • pool-registry (docs): Used for creating, updating, and setting the metadata of pools.

  • pool-system (docs): Creating and managing investment pools. It is bundling loans, slicing pools into tranches, and controlling investment epochs.

  • restricted-tokens (docs): Transferring tokens and setting balances. It is wrapping orml-tokens with the addition of checking for permissions.

  • restricted-xtokens (docs): Wrapper pallet over orml-xtokens which allows the runtime to create arbitrary filters for transfers of x-chain-transfers.

  • rewards (docs): Implement a scalable reward distribution mechanism that can be used for other pallets to create different rewards systems.

  • swaps (docs): Enables applying swaps independently of previous swaps in the same or opposite directions.

  • token-mux (docs): Enables proxying variants of the same foreign assets to a local asset representation.

  • transfer-allowlist (docs): This pallet checks whether an account should be allowed to make a transfer to a receiving location with a specific currency.

Developing

Instructions for building, testing, and developing Centrifuge Chain can be found in docs/DEVELOPING.md.

License

This codebase is licensed under GNU Lesser General Public License v3.0.