Skip to content

Assetra is a decentralised protocol that bridges real-world assets (RWAs) — such as real estate, commodities, and collectibles — into tokenised on-chain representations.

Notifications You must be signed in to change notification settings

LFGBanditLabs/Assetra

Repository files navigation

🪙 Assetra

Assetra is a decentralised protocol that bridges real-world assets (RWAs) — such as real estate, commodities, and collectibles — into tokenised, on-chain representations.
It enables verifiable ownership, fractional investment, and seamless transfer of tangible assets through blockchain-secured smart contracts.

Assetra is built for a future where the physical and digital economies merge, empowering anyone to own, trade, and earn from tokenised real-world value.


🌍 Key Features

  • Tokenisation Engine — Converts real-world asset metadata and proof documents into on-chain tokens.
  • Asset Vault — Decentralised custody verification for physical assets.
  • Compliance Layer — Built-in KYC/AML and proof-of-ownership verification.
  • Fractional Ownership — Enables investors to co-own and trade tokenised shares of assets.
  • Yield Integration — Optional DeFi layer for staking RWA-backed tokens and earning returns.

🧱 Architecture Overview

Frontend (React/Next.js) │ ├── Smart Contracts (Clarity / Solidity) │ ├── Asset Registry │ ├── Fractional Ownership Logic │ └── Governance & DAO Module │ ├── Oracle Layer (Off-chain verification) │ ├── Proof of Reserve │ └── Valuation Feed │ └── Storage (IPFS / Arweave) └── Encrypted metadata & asset documents

Core Modules

  • Smart Contracts Layer — Defines asset creation, verification, and transfer logic.
  • Oracle Layer — Connects off-chain verifiers, appraisers, and legal proofs.
  • Frontend dApp — Interactive dashboard for tokenisation, verification, and trading.
  • Storage Layer — Decentralised storage for asset documents and certificates.

🧰 Tech Stack

Layer Technologies
Smart Contracts Clarity / Solidity / Move
Frontend React + TypeScript + Tailwind
Backend Node.js + Express
Database PostgreSQL / MongoDB
Storage IPFS / Arweave
Blockchain Stacks / Sui / Ethereum / Morph

🚀 Getting Started

1. Clone the Repository

bash git clone https://github.com/yourusername/assetra.git cd assetra

2. Install Dependencies

bash npm install

3. Configure Environment Variables

Create a .env file using .env.example as reference and fill in your API keys and RPC endpoints.

New keys required for the end-to-end workflow:

Variable Purpose
WEB3_STORAGE_TOKEN Upload legal documents to IPFS / web3.storage
RESEND_API_KEY Send stage-by-stage email notifications
RESEND_FROM_EMAIL From address for notification emails
ADMIN_API_TOKEN Optional secret to read all documents via admin APIs
NEXT_PUBLIC_ADMIN_WALLET_ADDRESS Wallet recorded when admins trigger on-chain deployment

4. Run the Development Server

bash npm run dev

5. Deploy Smart Contracts

bash clarinet deploy

or bash npx hardhat run scripts/deploy.js


💡 Usage

  1. Tokenise an Asset

    • Upload asset metadata (e.g., title deed, certificate, valuation).
    • Verify ownership through Assetra's oracle layer.
    • Mint the tokenised representation (AssetToken).
  2. Verify Ownership

    • Each token is linked to verifiable documents stored on IPFS or Arweave.
  3. Fractionalise & Trade

    • Split ownership into smaller, tradable tokens.
    • Trade or transfer shares via decentralised exchanges or peer-to-peer.

End-to-End Workflow (UI)

  • Tokenisation Wizard (/tokenize) — Multi-step form to capture asset data, valuation, document uploads (IPFS), fractional configuration, compliance attestations, and submission review with live status tracking.
  • Owner Dashboard (/dashboard) — Portfolio analytics with valuation totals, fractional sales, document repository with version history, blockchain transaction monitor, and quick asset lifecycle actions.
  • Admin Review Console (/admin/review) — Compliance queue for pending submissions, document inspection, info requests, approval/rejection, and smart-contract deployment triggers (logs mint transactions for monitoring).

📜 Smart Contracts Overview

Contract Description
assetra-core.clar Registers assets and manages metadata and token minting.
assetra-fractional.clar Handles fractionalisation and ownership distribution.
assetra-governance.clar Enables DAO-based decision-making for verified assets.

Each contract is modular to ensure extensibility, upgradability, and security.


🔐 Security & Compliance

  • Oracle verification — Proof of existence and ownership validation through decentralised oracles.
  • Regulatory compliance — Optional modules for KYC/AML adherence.
  • Encrypted document storage — Sensitive files stored securely on IPFS/Arweave with access control.

🗺 Roadmap

GBOLAHAN Akande, [01/11/2025 01:26]

Phase Milestone Status
Phase 1 MVP: Tokenise single asset class (Real Estate) ✅ Completed
Phase 2 Add fractional ownership + secondary marketplace 🚧 In Progress
Phase 3 DAO Governance + Multi-chain Expansion 🔮 Planned

🤝 Contributing

Contributions are welcome! To contribute:

  1. Fork the repository
  2. Create a new feature branch
  3. Commit your changes
  4. Submit a pull request

Please ensure your code follows the established linting and testing standards.


📄 License

This project is licensed under the MIT License — see the LICENSE file for details.


👥 Team & Acknowledgements

Developed by the Assetra Team. Built with a shared vision of making real-world value accessible to everyone.

"Bridging the tangible and digital worlds, one asset at a time."


🔗 Connect

About

Assetra is a decentralised protocol that bridges real-world assets (RWAs) — such as real estate, commodities, and collectibles — into tokenised on-chain representations.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5