Welcome to the new Provenance Blockchain developer documentation portal!
logo

Overview

The Provenance blockchain provides three core modules that work together to create a comprehensive digital asset management and financial tracking system:
  1. x/asset - Digital asset creation and management
  1. x/ledger - Financial tracking and accounting for assets
  1. x/registry - Role-based access control and permissions
These modules form the foundation for creating, managing, and tracking digital assets with full financial transparency and controlled access.

Scenario

A borrower wants to take out a loan using their commercial real estate as collateral. The loan will be tracked on the blockchain with full transparency and automated payment processing.

Step-by-Step Process

The complete loan workflow involves the following steps:
  1. Asset Creation (x/asset) - Create asset class and property asset
  1. Registry Setup (x/registry) - Register property with appropriate roles
  1. Ledger Creation (x/ledger) - Create ledger for loan tracking
  1. Loan Disbursement - Record initial loan amount
  1. Monthly Payment Processing - Record regular payments
  1. Interest Accrual - Track interest charges
A complete demo script with all CLI commands is available in demo_loan_workflow.sh. This script demonstrates the entire workflow with proper error handling, colored output, and configuration options.
To run the demo:
bash
# Make the script executable chmod +x demo_loan_workflow.sh # Run the demo (commands are commented out by default) ./demo_loan_workflow.sh # To run actual commands, uncomment the 'eval' line in the script # and replace demo addresses with real addresses

Benefits of This System

  1. Transparency: All loan activities are recorded on-chain and publicly verifiable
  1. Automation: Payments and accruals can be automated through smart contracts
  1. Auditability: Complete audit trail of all financial transactions
  1. Access Control: Role-based permissions ensure only authorized parties can perform actions
  1. Compliance: Regulatory requirements can be built into the asset classes and ledger configurations
  1. Liquidity: Assets can be tokenized or securitized for secondary market trading

Integration Benefits

  • Asset Module: Provides the underlying asset representation and management
  • Ledger Module: Tracks all financial activities and maintains balances
  • Marker Module: Enables creation of fungible tokens for asset-backed securities
This integrated system provides a complete solution for digital asset management, financial tracking, and regulatory compliance in the blockchain ecosystem.