Skip to content

Feature: Implement Missing Frontend Integration Support#150

Merged
LaGodxy merged 1 commit intoMettaChain:mainfrom
Lansa-18:feature/frontend-support
Mar 29, 2026
Merged

Feature: Implement Missing Frontend Integration Support#150
LaGodxy merged 1 commit intoMettaChain:mainfrom
Lansa-18:feature/frontend-support

Conversation

@Lansa-18
Copy link
Copy Markdown
Contributor

Closes #111

Frontend SDK Implementation Summary

Problem

Frontend integration support was inadequate — no SDK, no TypeScript definitions, no example apps, and no integration testing, making dApp development difficult.


Changes

🆕 New: @propchain/sdk TypeScript package (sdk/frontend/)

  • 50+ type definitions mirroring all on-chain Rust types:
    • properties, escrow, oracle, badges, bridge, governance, tokens
  • 35+ event interfaces with type-safe PropChainEventMap for event subscriptions
  • 5 client classes:
    • PropChainClient
    • PropertyRegistryClient
    • PropertyTokenClient
    • EscrowClient
    • OracleClient
      → covering 100+ contract methods
  • 5 utility modules:
    • connection (with retry & network presets)
    • signer (extension + keyring)
    • formatters
    • error handling
    • event decoding
  • Placeholder ABI files for:
    • PropertyRegistry
    • PropertyToken contracts

🆕 New: Test suite (sdk/frontend/__tests__/)

  • 63 unit tests passing:
    • types, formatters, errors, events, connection
  • 13 integration tests scaffolded:
    • require live Substrate node

🆕 New: Example React app (sdk/frontend/examples/react-app/)

  • Built with Vite + React + TypeScript
  • Features:
    • wallet connection
    • property registration
    • escrow management
    • token operations (NFT, fractional, governance, marketplace)
  • Dark-themed UI with SDK code examples embedded in each view

🆕 New: docs/FRONTEND_SDK_GUIDE.md

  • Full API reference
  • React integration patterns (hooks, context)
  • Event & error handling guides
  • Testing guide
  • Troubleshooting section

✏️ Modified: README.md

  • Added Frontend SDK documentation links
  • Updated repository structure to include sdk/ tree
  • Marked Frontend SDK as completed in project status

@drips-wave
Copy link
Copy Markdown

drips-wave bot commented Mar 29, 2026

@Lansa-18 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@Lansa-18
Copy link
Copy Markdown
Contributor Author

@LaGodxy Kindly review

@LaGodxy LaGodxy merged commit 5f8e39b into MettaChain:main Mar 29, 2026
13 checks passed
@Lansa-18 Lansa-18 deleted the feature/frontend-support branch March 30, 2026 08:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing Frontend Integration Support

2 participants