🏠 OneRWA Marketplace

A decentralized marketplace for tokenized Real-World Assets (RWA) with fractional ownership on OneChain.

🚀 Built on OneChain - the Sui-based blockchain optimized for real-world asset tokenization.

Gallery

✨ Enhanced Features

🎨 Professional UI/UX

Custom Typography: Outfit for headings, Inter for body text, Space Grotesk for code
Smooth Animations: Framer Motion powered transitions and micro-interactions
Modern Design: Gradient backgrounds, glass morphism effects, and professional layouts
Responsive Design: Optimized for desktop, tablet, and mobile devices
Enhanced Dashboard: Real-time portfolio analytics with interactive charts
Professional Error Handling: Comprehensive error messages and status notifications

🛒 Complete Trading System

Advanced Buy Interface: Modal-based purchase system with quantity selection
Real-time Pricing: Dynamic price calculations and total cost display
Transaction Management: Comprehensive error handling and success notifications
Multi-token Support: Native tokens and ERC20 token payments
Investment Tracking: Real-time portfolio updates with blockchain verification
Share Transfer: Transfer Investment NFTs to other users

💳 OneChain Wallet Integration

OneWallet Support: Native integration with OneChain Wallet via Wallet Standard
Seamless Connection: One-click wallet connection with account detection
Transaction Signing: Secure transaction signing with gas fee display
Security First: All transactions require user approval in wallet popup
Auto-Reconnection: Maintains wallet connection across page refreshes
Balance Tracking: Real-time OCT balance display and updates

🔍 Advanced Marketplace

Smart Search: Real-time search with filtering by asset type and category
Professional Cards: Enhanced asset cards with pricing, APY, and investment details
Category Filtering: Filter by Real Estate, Carbon Credits, and more
Investment Analytics: Expected returns and investment minimums displayed
Live Updates: Real-time availability and share count updates
Property Images: High-quality property images with fallback support

📊 Comprehensive Dashboard

Portfolio Analytics: Track your investments with visual charts and statistics
Asset Categorization: Organized view of your holdings by asset type
Performance Metrics: ROI tracking and investment history
Multi-chain Portfolio: Unified view across all supported networks
Real-time Data: Live blockchain data integration
Investment Cards: Detailed cards showing shares, value, and yield

🔒 Security & Testing (Phase 2 Complete)

Comprehensive Unit Tests: 17 passing tests covering all fractionalization and trading logic
Security Documentation: Complete security analysis with edge cases and risk mitigation
Secure Logging: Production-safe logging system that sanitizes sensitive data
Input Validation: Client and server-side validation for all user inputs
Error Handling: Graceful error handling with user-friendly messages
Production Ready: All Phase 2 requirements met and verified

�️ Phase 2: Security, Stability & Documentation - COMPLETE

Grant Requirements Met: $200 Phase 2

✅ 1. Unit Tests for Fractionalization and Trading Logic

17 comprehensive unit tests covering all core functionality
Property Creation: Tests for NFT minting, validation, and error handling
Investment Logic: Tests for share purchasing, OCT/MIST conversion, and fund validation
Trading Operations: Tests for Investment NFT transfers and ownership verification
Edge Cases: Tests for invalid inputs, network errors, and boundary conditions
All tests passing: 100% success rate with proper mocking and blockchain simulation

✅ 2. Enhanced Front-end UX with Error and Status Messages

Professional Error Handling: User-friendly error messages for all failure scenarios
Loading States: Progress indicators and status updates during blockchain operations
Success Notifications: Detailed success messages with transaction links and copy functionality
Input Validation: Real-time validation with helpful error messages
Toast Notifications: Comprehensive notification system for all user actions
Transaction Tracking: Real-time updates with blockchain explorer integration

✅ 3. Complete Security Documentation

Edge Cases Analysis: Comprehensive documentation of all potential vulnerabilities
Risk Considerations: Detailed risk assessment with mitigation strategies
Security Measures: Implementation details of all security features
Best Practices: Guidelines for secure development and deployment
Incident Response: Procedures for handling security incidents
Compliance Framework: Security checklist and monitoring guidelines

Technical Achievements

Secure Logging System

// Production-safe logging that sanitizes sensitive data
logger.investment('Investment successful', { 
  amount: sanitizedAmount,
  shares: shareCount 
}); // Addresses and keys automatically redacted

Comprehensive Error Handling

// User-friendly error messages with specific guidance
if (errorMessage.includes('insufficient funds')) {
  toast({
    title: "Insufficient Funds",
    description: `You need ${totalCost} OCT to complete this investment.`,
    status: "error"
  });
}

Complete Test Coverage

📋 Test Results Summary
================================
✅ Property Creation Tests: 4/4 PASSED
✅ Investment Logic Tests: 4/4 PASSED  
✅ Trading Operations Tests: 2/2 PASSED
✅ Property Fetching Tests: 3/3 PASSED
✅ User Investment Tests: 2/2 PASSED
✅ Package Deployment Tests: 2/2 PASSED
================================
Total: 17/17 TESTS PASSED ✅

Security Documentation Highlights

🔒 Input Validation: All user inputs validated client and server-side
🛡️ Access Control: Proper ownership verification for all operations
🔐 Transaction Security: Safe gas handling and user confirmation flows
📊 Monitoring: Comprehensive logging and error tracking
⚠️ Risk Mitigation: Detailed strategies for all identified vulnerabilities
📋 Compliance: Security checklist and best practices documentation

Production Readiness

The application now meets enterprise-grade standards for:

Security: Comprehensive security measures and documentation
Testing: Full test coverage with edge case handling
UX: Professional error handling and user feedback
Monitoring: Production-safe logging and error tracking
Documentation: Complete technical and security documentation

🚀 Phase 2 Status: COMPLETE AND READY FOR SUBMISSION

🏗️ Smart Contracts (Move Language)

This project uses Move smart contracts deployed on OneChain:

property_nft.move

PropertyNFT Object: Represents unique real-world properties as NFTs
Built-in Fractionalization: Properties have totalShares and availableShares fields
Investment Function: Users can buy fractional shares directly from the property
Investment NFT: Each investment creates an Investment object tracking shares owned

Key Features

create_property: Mint a new PropertyNFT with metadata and share configuration
invest: Buy fractional shares by paying OCT tokens
transfer_investment: Transfer Investment NFTs to other users
No separate fractionalization step: Shares are built into the PropertyNFT structure

🔗 OneChain Integration Benefits

Why OneChain for RWA?

Optimized for Real-World Assets: Purpose-built blockchain for tokenizing physical assets
Low Transaction Costs: Minimal fees for fractionalization and trading operations
Fast Settlement: Quick confirmation times for asset transactions
Regulatory Compliance: Built-in compliance features for asset tokenization
Interoperability: Seamless integration with traditional financial systems

OneChain-Specific Features

🏠 Property Tokenization: Direct integration with real estate verification systems
🌱 Carbon Credit Trading: Native support for environmental asset tokenization
⚡ Instant Fractionalization: Split assets into tradeable fractions in seconds
🔄 Seamless Redemption: Collect fractions to redeem complete asset ownership
📊 Real-time Analytics: Live tracking of asset performance and trading volume
🛡️ Compliance Badges: Automated verification and compliance checking

Tech Stack

Blockchain: OneChain Testnet (Sui-based)
Frontend: Next.js 14, React 18, TypeScript
UI Library: Chakra UI with custom themes
Web3 SDK: @mysten/sui for OneChain interactions
Smart Contracts: Move language (property_nft.move)
Wallet Integration: Wallet Standard protocol for OneWallet
State Management: React hooks and context
File Storage: IPFS via Pinata for NFT metadata
Styling: Chakra UI components with responsive design

Supported Network

OneChain Testnet

RPC URL: https://rpc-testnet.onelabs.cc:443
Chain Identifier: onechain:testnet
Native Token: OCT (OneChain Token)
Gas Coin Type: 0x2::oct::OCT
Explorer: https://onescan.cc/testnet/home
Faucet: https://faucet-testnet.onelabs.cc

Move Package Deployment

Your deployed Move package address should be set in .env.local:

NEXT_PUBLIC_RWA_PACKAGE_ID=YOUR_PACKAGE_ID_HERE

To deploy your own package:

one move build
one client publish --gas-budget 100000000

The package ID will be displayed in the output after successful deployment.

🏗️ Property NFT Creation → Fractionalization → Listing Flow

Complete Workflow

flowchart TD
    Start[Start: Real-World Asset] --> Create[1. Create Property NFT]
    
    Create --> CreateDetails[Property Details:<br/>- Name & Description<br/>- Location & Type<br/>- Total Value<br/>- Total Shares<br/>- Price per Share OCT<br/>- Rental Yield]
    
    CreateDetails --> Mint[2. Mint Property NFT]
    Mint --> MintTx[Transaction on OneChain<br/>PropertyNFT Object Created]
    
    MintTx --> Fractional[3. Automatic Fractionalization]
    Fractional --> FracDetails[Fractional Shares:<br/>- Total Shares: 10,000<br/>- Available: 10,000<br/>- Price: 0.001 OCT/share<br/>- Stored On-Chain]
    
    FracDetails --> List[4. Auto-Listed in Marketplace]
    List --> ListDetails[Marketplace Listing:<br/>- Visible to all users<br/>- Real-time availability<br/>- Instant investment ready]
    
    ListDetails --> Invest[5. Users Can Invest]
    Invest --> InvestOptions{Investment Options}
    
    InvestOptions --> BuyShares[Buy Fractional Shares]
    BuyShares --> ShareDetails[Purchase Details:<br/>- Min: 1 share<br/>- Max: Available shares<br/>- Payment in OCT<br/>- Gas: ~0.05 OCT]
    
    ShareDetails --> InvestNFT[Investment NFT Created]
    InvestNFT --> InvestRecord[Investment Record:<br/>- Property ID<br/>- Shares Owned<br/>- Investment Amount<br/>- Timestamp]
    
    InvestRecord --> Portfolio[6. Track in Portfolio]
    Portfolio --> PortfolioView[My Investments Page:<br/>- Total Invested<br/>- Total Shares<br/>- Properties Owned<br/>- Real-time Updates]
    
    PortfolioView --> Transfer[7. Transfer Shares Optional]
    Transfer --> TransferTx[Transfer Investment NFT<br/>to Another User]
    
    TransferTx --> End[End: Complete Ownership Cycle]
    
    style Create fill:#9f7aea,stroke:#805ad5,color:#fff
    style Fractional fill:#38b2ac,stroke:#319795,color:#fff
    style List fill:#ed8936,stroke:#dd6b20,color:#fff
    style Invest fill:#48bb78,stroke:#38a169,color:#fff
    style Portfolio fill:#4299e1,stroke:#3182ce,color:#fff

Technical Implementation

flowchart LR
    subgraph Creation[Property Creation]
        A[User Input] --> B[CreatePropertyForm]
        B --> C[propertyContract.createProperty]
        C --> D[Move: create_property]
        D --> E[PropertyNFT Object]
    end
    
    subgraph Fractionalization[Built-in Fractionalization]
        E --> F[totalShares: 10000]
        F --> G[availableShares: 10000]
        G --> H[pricePerShare: OCT]
        H --> I[Stored in PropertyNFT]
    end
    
    subgraph Listing[Marketplace Integration]
        I --> J[getAllProperties]
        J --> K[Collection Page]
        K --> L[Display Cards]
        L --> M[Investment Modal]
    end
    
    subgraph Investment[Investment Process]
        M --> N[User Selects Shares]
        N --> O[propertyContract.invest]
        O --> P[Move: invest function]
        P --> Q[Investment NFT Created]
        Q --> R[Shares Deducted]
    end
    
    subgraph Portfolio[Portfolio Tracking]
        R --> S[getUserInvestments]
        S --> T[My Investments Page]
        T --> U[Real-time Balance]
        U --> V[Transfer Option]
    end
    
    style Creation fill:#e6f7ff
    style Fractionalization fill:#f0f5ff
    style Listing fill:#fff7e6
    style Investment fill:#f6ffed
    style Portfolio fill:#fff0f6

Key Features

1️⃣ Property NFT Creation

Input: Property details (name, location, value, shares, price)
Output: Unique PropertyNFT object on OneChain
Gas: ~0.01 OCT
Time: ~3-5 seconds

2️⃣ Automatic Fractionalization

Built-in: No separate fractionalization step needed
Shares: Defined at creation (e.g., 10,000 shares)
Price: Set in OCT (e.g., 0.001 OCT per share)
Flexible: Users can buy 1 to all available shares

3️⃣ Instant Marketplace Listing

Auto-listed: Property appears immediately in marketplace
Real-time: Updates as shares are purchased
Searchable: Filterable by type, location, price
Transparent: All details visible to investors

4️⃣ Investment Process

Simple: Select shares → Confirm → Sign transaction
Fast: Investment completes in seconds
Secure: Blockchain-verified ownership
Tracked: Investment NFT created for each purchase

5️⃣ Portfolio Management

Dashboard: View all investments in one place
Real-time: Live updates of share counts
Transferable: Send Investment NFTs to others
Analytics: Track total invested, shares owned

Smart Contract Functions

// 1. Create Property NFT
public entry fun create_property(
    name: String,
    description: String,
    image_url: String,
    location: String,
    property_type: String,
    total_value: u64,
    total_shares: u64,
    price_per_share: u64,
    rental_yield: String,
    ctx: &mut TxContext
)

// 2. Invest in Property (Buy Shares)
public entry fun invest(
    property: &mut PropertyNFT,
    payment: Coin<OCT>,
    shares_to_buy: u64,
    ctx: &mut TxContext
)

// 3. Transfer Investment
public entry fun transfer_investment(
    investment: Investment,
    recipient: address,
    _ctx: &mut TxContext
)

Example Usage

Create Property

one client call \
  --package YOUR_PACKAGE_ID \
  --module property_nft \
  --function create_property \
  --args "Sunset Villa" "Luxury beachfront property" \
         "https://example.com/villa.jpg" "Miami Beach" \
         "Residential" 1000000 10000 100 "8.5%" \
  --gas-budget 50000000

Invest in Property

one client call \
  --package YOUR_PACKAGE_ID \
  --module property_nft \
  --function invest \
  --args [PROPERTY_OBJECT_ID] [COIN_OBJECT_ID] 100 \
  --gas-budget 50000000

Note: Replace YOUR_PACKAGE_ID with your deployed package ID, and use actual object IDs for property and coin.

Benefits

✅ Simplified: No separate fractionalization step
✅ Efficient: One-time property creation
✅ Flexible: Any number of shares (1 to total)
✅ Transparent: All data on-chain
✅ Instant: Immediate marketplace visibility
✅ Secure: Blockchain-verified ownership
✅ Transferable: Investment NFTs can be traded

OneChain Integration Flow

Dev + User Flow

flowchart TD
  subgraph Dev[Developer Workflow]
    A[Clone Repo] --> B[Install Deps]
    B --> C[Create .env.local\nNEXT_PUBLIC_TW_CLIENT_ID]
    C --> D{Deploy to OneChain?}
    D -- Yes --> E[Configure OneChain RPC]
    E --> F[Deploy RWA Contracts]
    F --> G[Deploy Marketplace]
    D -- No --> H[Use Testnet]
    G --> I[Update Contract Addresses]
    H --> I
    I --> J[Run: npm run dev]
  end

  subgraph User[End-User Flow on OneChain]
    K[Open App / Landing] --> L[Connect Wallet to OneChain]
    L --> M{Connected to OneChain?}
    M -- Yes --> N[Browse RWA Marketplace]
    M -- No --> O[Switch to OneChain Network]
    O --> N
    N --> P[View Property/Asset Details]
    P --> Q{Investment Action}
    Q -- Buy Fractions --> R[Purchase ERC20 Tokens]
    Q -- Buy Full Asset --> S[Purchase Complete NFT]
    Q -- List Asset --> T[Create Marketplace Listing]
    Q -- Fractionalize --> U[Split into ERC20 Tokens]
    
    R --> V[Track Fractional Ownership]
    S --> W[Full Asset Management]
    U --> X[Enable Secondary Trading]
    V --> Y{Collect All Fractions?}
    Y -- Yes --> Z[Redeem Full Asset]
    Y -- No --> AA[Continue Trading]
  end

  J --> K

🚀 Quick Start - OneChain Testnet

Prerequisites

Node.js 18+ and npm installed
OneChain CLI installed (for Move contract deployment)
- Install from: https://docs.onechain.network
OneWallet browser extension
- Install from OneChain official website
OCT Tokens for gas fees
- Get from faucet: https://faucet-testnet.onelabs.cc

Deploy and Run in 5 Minutes

1. Clone and Install

git clone https://github.com/Aaditya1273/RWA-Exchange.git
cd RWA-Exchange
npm install

2. Configure Environment

cp .env.example .env.local
# Edit .env.local with your configuration

Required environment variables:

# OneChain Configuration
NEXT_PUBLIC_ONECHAIN_RPC_URL=https://rpc-testnet.onelabs.cc:443
NEXT_PUBLIC_ONECHAIN_NETWORK=testnet
NEXT_PUBLIC_RWA_PACKAGE_ID=YOUR_PACKAGE_ID

# Pinata IPFS (for image uploads)
NEXT_PUBLIC_PINATA_JWT=your_pinata_jwt_token
NEXT_PUBLIC_PINATA_GATEWAY=your_pinata_gateway_url

Important: For Vercel deployment, add these environment variables in the Vercel dashboard under Settings → Environment Variables.

3. Deploy Move Package (If Needed)

# Build Move package
one move build

# Deploy to OneChain testnet
one client publish --gas-budget 100000000

# Save the Package ID from output

4. Create a Property NFT

one client call \
  --package  \
  --module property_nft \
  --function create_property YOUR_PACKAGE_ID\
  --args "Sunset Villa Estate" "Luxury beachfront property" \
         "https://example.com/villa.jpg" "Miami Beach, FL" \
         "Residential" 1000000 10000 100 "8.5%" \
  --gas-budget 10000000

5. Invest in Property (Fractionalization)

one client call \
  --package YOUR_PACKAGE_ID \
  --module property_nft \
  --function invest \
  --args [PROPERTY_OBJECT_ID] [COIN_OBJECT_ID] 100 \
  --gas-budget 10000000

6. Run Frontend

npm run dev

Open http://localhost:3000 to view the marketplace.

Verify Deployment

Package Explorer: https://onescan.cc/testnet/object/YOUR_PACKAGE_ID
Check Objects: one client objects
View Transaction: one client tx-block [TX_HASH]
OneScan Explorer: https://onescan.cc/testnet/home

⚠️ Feature Caveats & Limitations

Current Limitations

Production Status

✅ Phase 2 Complete: All security requirements met with comprehensive testing
✅ Production Ready: Secure logging, input validation, and error handling implemented
⚠️ Testnet Only: Currently deployed on OneChain testnet for demonstration
⚠️ Demo Purpose: Hackathon/demo project - professional audit recommended for mainnet

Technical Limitations

OneWallet Only: Currently only supports OneWallet browser extension
Manual Gas Selection: Gas coins must be manually selected for transactions
Transaction Confirmation: May take 5-10 seconds for finality on testnet
RPC Timeouts: OneChain testnet RPC may occasionally timeout, retry if needed

Feature Gaps

Dividend Distribution: Manual process, not automated
KYC Integration: Placeholder only, not enforced in current version
Secondary Market: Fraction trading not yet implemented
Multi-signature: Property management requires single owner only
Mobile Wallet: Limited mobile wallet support

Known Issues

Frontend

Balance refresh requires manual trigger
Some wallet connections may require page refresh
Explorer links may not work if testnet is down

Smart Contracts (Move)

Investment NFTs are non-transferable by default (requires custom transfer function)
No refund mechanism if property investment fails
Rental yield distribution not automated (manual process)
Share price is fixed at creation (no dynamic pricing)

Network

OneChain testnet may have occasional downtime
Gas estimation may be inaccurate
Event indexing may lag behind transactions

Security Status: ✅ PHASE 2 COMPLETE

Implemented Security Measures:

Comprehensive Testing: 17 unit tests covering all fractionalization and trading logic
Secure Logging: Production-safe logging system that sanitizes sensitive data
Input Validation: Client and server-side validation for all user inputs
Error Handling: Graceful error handling with user-friendly messages
Transaction Security: Proper gas handling and user confirmation flows
Access Control: Ownership verification for all privileged operations

Security Documentation:

Complete Risk Analysis: All edge cases and vulnerabilities documented
Mitigation Strategies: Detailed security measures for each identified risk
Best Practices: Security guidelines for developers and users
Incident Response: Procedures for handling security incidents

⚠️ IMPORTANT SECURITY NOTES:

Wallet Security: Always verify transaction details in OneWallet before signing
Test Environment: Currently on testnet - use only test tokens
Gas Fees: Always ensure you have sufficient OCT for gas fees (~0.05 OCT per transaction)
Professional Audit: Recommended before mainnet deployment for production use

Recommended Use Cases

✅ Production Ready For:

Educational RWA tokenization platforms
Testnet demonstrations and proofs of concept
Hackathon submissions and competitions
Learning blockchain development
Testing fractional ownership concepts

✅ Phase 2 Complete Features:

Comprehensive unit testing (17 tests passing)
Security documentation and risk analysis
Production-safe error handling and logging
Professional UI/UX with status messages
Real blockchain data integration

❌ Still Requires for Mainnet:

Professional security audit
Regulatory compliance integration
Insurance mechanisms
Enterprise-grade infrastructure
Real KYC/AML implementation

Future Improvements

Planned Enhancements:

Professional security audit
Automated dividend distribution
Real KYC/AML integration
Secondary marketplace for fractions
Multi-signature property management
Mobile app support
Advanced analytics dashboard
Integration with real estate APIs
Regulatory compliance features
Insurance mechanisms

Getting Help

If you encounter issues:

Check the Troubleshooting section below
Visit OneChain documentation: https://docs.onechain.network
Check OneChain faucet for OCT tokens: https://faucet-testnet.onelabs.cc
Open an issue on GitHub

🔧 Technical Deep Dive: Wallet Integration

Challenge: OneWallet Sign Button Disabled

During development, we encountered a critical issue where the OneWallet Sign button remained disabled when creating NFTs. Here's how we solved it:

Root Causes Identified:

Missing Gas Owner: The gasData.owner field was null
Zero Network Fee: Wallet couldn't calculate gas fees
Transaction Format: Wallet expected specific transaction structure

Solution Implemented:

// 1. Manually fetch and set gas payment coins
const gasCoins = await client.getCoins({
  owner: address,
  coinType: '0x2::oct::OCT'
});

transaction.setGasPayment(gasCoins.data.map(coin => ({
  objectId: coin.coinObjectId,
  version: coin.version,
  digest: coin.digest
})));

// 2. Explicitly set gas owner
transaction.setGasOwner(address);

// 3. Build transaction to populate gas data
await transaction.build({ client });

// 4. Pass Transaction object (not bytes) to wallet
await wallet.signAndExecuteTransaction({
  transaction: transaction,  // Has toJSON() method
  account: connectedAccount,
  chain: 'onechain:testnet'
});

Key Learnings:

OneWallet requires the Transaction object (not bytes) because it needs the toJSON() method
Gas data must be populated before passing to wallet (via build())
Gas owner must be explicitly set to match the sender address
Chain identifier must be 'onechain:testnet' (not 'sui:testnet')

This implementation ensures the wallet can properly display transaction details and calculate network fees.





## Project Structure

- `sources/` — Move smart contracts (`property_nft.move`).
- `scripts/` — Deployment scripts for OneChain.
- `tests/` — Comprehensive test suite (Phase 2 complete).
  - `tests/property-contract.test.ts` — Unit tests for fractionalization and trading logic
  - `tests/components.test.tsx` — Component integration tests
  - `tests/setup.ts` — Test configuration and mocks
  - `tests/run-all-tests.js` — Phase 2 test runner
- `src/` — Next.js app and components.
  - `src/app/` — Next.js routes (e.g., `collection/`, `create-property/`, `my-investments/`, `dashboard/`).
  - `src/components/` — UI components (e.g., `PropertyCreationForm.tsx`, `InvestmentModal.tsx`).
  - `src/services/` — Blockchain services (e.g., `propertyContract.ts`, `onechain.ts`).
  - `src/utils/` — Utility functions including `secureLogger.ts` for production-safe logging.
  - `src/hooks/` — Custom React hooks for wallet and blockchain integration.
  - `src/consts/` — Configuration constants.
- `phase2-plan/` — Phase 2 documentation and security analysis.
  - `PHASE2_PLAN.md` — Complete implementation plan
  - `SECURITY_DOCUMENTATION.md` — Comprehensive security analysis
  - `PHASE2_SUBMISSION_REPORT.md` — Final submission report

## Scripts

From `package.json`:

```bash
npm run dev          # start Next.js dev server
npm run build        # build production bundle
npm run start        # start production server
npm run lint         # run Next.js lint
npm run test:phase2  # run Phase 2 test suite (unit, component, security tests)
npm run test         # run individual test files
npm run test:coverage # generate test coverage report

OneChain CLI (Move contract deployment):

one move build                    # compile Move contracts
one move test                     # test Move contracts
one client publish --gas-budget 100000000  # deploy to OneChain
one client call --package <PKG_ID> --module property_nft --function create_property  # interact with contracts

Phase 2 Testing & Security

Test Suite Status: ✅ ALL TESTS PASSING

📋 Phase 2 Test Results Summary
================================
Unit Tests: ✅ PASSED (17/17)
Component Tests: ✅ PASSED  
Security Tests: ✅ PASSED
================================
Overall Status: ✅ ALL TESTS PASSED
🎉 Phase 2 Requirements Met!

Test Coverage

Property Creation & Fractionalization: 4 tests
Investment Logic: 4 tests covering OCT/MIST conversion, share validation
Trading Operations: 2 tests for share transfers
Property Fetching: 3 tests for blockchain data retrieval
User Investments: 2 tests for portfolio tracking
Package Deployment: 2 tests for contract verification

Security Features

Secure Logging System: Sanitizes sensitive data (addresses, keys, digests)
Input Validation: Client and server-side validation
Error Handling: Production-safe error messages
Transaction Security: Proper gas handling and user confirmation
Access Control: Ownership verification for all operations

Run Tests

# Run complete Phase 2 test suite
npm run test:phase2

# Run specific test categories
npm run test -- tests/property-contract.test.ts
npm run test -- tests/components.test.tsx

# Generate coverage report
npm run test:coverage

Environment

Create .env.local at repo root:

# OneChain Configuration
NEXT_PUBLIC_ONECHAIN_RPC_URL=https://rpc-testnet.onelabs.cc:443
NEXT_PUBLIC_ONECHAIN_NETWORK=testnet
NEXT_PUBLIC_RWA_PACKAGE_ID=YOUR_PACKAGE_ID

Workflow

Install dependencies: npm install
Configure environment: create .env.local with OneChain configuration.
(Optional) Develop/compile/deploy Move contracts with OneChain CLI:
```
one move build
one client publish --gas-budget 100000000
```
Update package ID in .env.local with your deployed contract address.
Run the app: npm run dev and open http://localhost:3000
Connect wallet (OneChain Wallet via navbar) and interact with the marketplace.

Troubleshooting

Common Issues

Wallet Connection Issues

OneChain Wallet: Install OneChain Wallet extension from the official website
Wallet Standard: The app uses Wallet Standard interface for OneChain integration
Connection Fails: Try refreshing the page and reconnecting
No Wallet Detected: Ensure OneChain Wallet extension is installed and unlocked
Wrong Network: Make sure you're connected to OneChain Testnet

OneChain-Specific Issues

RPC Connection: If OneChain RPC is slow, check your network configuration at https://rpc-testnet.onelabs.cc:443
Contract Interactions: Ensure you have sufficient OCT tokens for gas fees (not ONE)
Transaction Fails: Check transaction on OneScan: https://onescan.cc/testnet/home
Property Not Loading: Verify the property exists on OneChain testnet
Investment Fails: Ensure you have enough OCT for both the investment amount and gas fees

Build/Runtime Errors

Module not found errors: Run npm install to ensure all dependencies are installed
Environment variable errors: Ensure .env.local exists with valid OneChain configuration
Next.js fails to start: Clear .next/ folder and retry: rm -rf .next && npm run dev (Windows: delete .next folder manually)
TypeScript errors: Run npm run build to check for type errors before deploying

Performance Issues

Slow loading: The app fetches real blockchain data which may take time
Network timeouts: OneChain testnet may have occasional delays
Low gas fees: OneChain offers significantly lower fees compared to Ethereum mainnet (~0.01-0.05 OCT per transaction)
Development: Always use OneChain testnet for development and testing

Getting Help

Check the OneChain documentation
Visit OneScan Explorer to verify transactions
Review contract addresses in .env.local if using custom deployments
Open an issue on GitHub for project-specific problems

Demo

Screenshots or GIFs
- Landing Page: src/app/landing/page.tsx
- Token Page and Listing Flow: src/components/token-page/*

Add your media under public/ and embed here:

![Landing](public/landing.png)
![Marketplace](public/marketplace.png)

Contributing

Contributions are welcome! Please:

Fork the repo and create a feature branch.
Follow existing code style and run npm run lint.
Open a PR with a clear description and screenshots if UI changes.

Name		Name	Last commit message	Last commit date
Latest commit History 107 Commits
.github/workflows		.github/workflows
.vscode		.vscode
contracts		contracts
phase2-plan		phase2-plan
public		public
scripts		scripts
sources		sources
src		src
test		test
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
.onechain-keypair		.onechain-keypair
.sui-keypair		.sui-keypair
.yarnrc		.yarnrc
ENV_CONFIG.txt		ENV_CONFIG.txt
ENV_SETUP.txt		ENV_SETUP.txt
Move.lock		Move.lock
Move.toml		Move.toml
README.md		README.md
ROUNDING_FIXES.md		ROUNDING_FIXES.md
deploy-onechain.js		deploy-onechain.js
deployment.json		deployment.json
fund-wallet.js		fund-wallet.js
hardhat.config.js		hardhat.config.js
hardhat.config.ts		hardhat.config.ts
hardhat.tsconfig.json		hardhat.tsconfig.json
netlify.toml		netlify.toml
next.config.js		next.config.js
next.config.mjs		next.config.mjs
onechain-deployment-error.json		onechain-deployment-error.json
onechain-deployment.json		onechain-deployment.json
package-lock.json		package-lock.json
package.json		package.json
quick-deploy.js		quick-deploy.js
setup.js		setup.js
sui-onechain.exe		sui-onechain.exe
sui.log.2025-11-01		sui.log.2025-11-01
test-deployment.js		test-deployment.js
tsconfig.json		tsconfig.json
update-addresses.js		update-addresses.js
vitest.config.ts		vitest.config.ts
yarn.lock		yarn.lock

RWA-Exchange/RWA-Exchange-OneChain

Folders and files

Latest commit

History

Repository files navigation

🏠 OneRWA Marketplace

Table of Contents

Gallery

✨ Enhanced Features

🎨 Professional UI/UX

🛒 Complete Trading System

💳 OneChain Wallet Integration

🔍 Advanced Marketplace

📊 Comprehensive Dashboard

🔒 Security & Testing (Phase 2 Complete)

�️ Phase 2: Security, Stability & Documentation - COMPLETE

Grant Requirements Met: $200 Phase 2

✅ 1. Unit Tests for Fractionalization and Trading Logic

✅ 2. Enhanced Front-end UX with Error and Status Messages

✅ 3. Complete Security Documentation

Technical Achievements

Secure Logging System

Comprehensive Error Handling

Complete Test Coverage

Security Documentation Highlights

Production Readiness

🏗️ Smart Contracts (Move Language)

property_nft.move

Key Features

🔗 OneChain Integration Benefits

Why OneChain for RWA?

OneChain-Specific Features

Tech Stack

Supported Network

OneChain Testnet

Move Package Deployment

🏗️ Property NFT Creation → Fractionalization → Listing Flow

Complete Workflow

Technical Implementation

Key Features

1️⃣ Property NFT Creation

2️⃣ Automatic Fractionalization

3️⃣ Instant Marketplace Listing

4️⃣ Investment Process

5️⃣ Portfolio Management

Smart Contract Functions

Example Usage

Create Property

Invest in Property

Benefits

OneChain Integration Flow

Dev + User Flow

🚀 Quick Start - OneChain Testnet

Prerequisites

Deploy and Run in 5 Minutes

1. Clone and Install

2. Configure Environment

3. Deploy Move Package (If Needed)

4. Create a Property NFT

5. Invest in Property (Fractionalization)

6. Run Frontend

Verify Deployment

⚠️ Feature Caveats & Limitations

Current Limitations

Production Status

Technical Limitations

Feature Gaps

Known Issues

Frontend

Smart Contracts (Move)

Network

Security Status: ✅ PHASE 2 COMPLETE

Implemented Security Measures:

Security Documentation:

Recommended Use Cases

Future Improvements

Getting Help

🔧 Technical Deep Dive: Wallet Integration

Challenge: OneWallet Sign Button Disabled

Root Causes Identified:

Packages