Integration Guide

QBridge offers multiple integration pathways depending on your role in the RWA ecosystem. Whether you're an issuer, DeFi protocol, or custodian, onboarding takes minutes — with institutional-grade too

🏛 For RWA Issuers

Goal: Bridge your existing tokenized assets across chains without rebuilding issuance logic.

🔧 Integration Highlights:

• ✅ Wrap existing SPL / ERC-20 tokens using the QBridge SDK

• ✅ Define transfer policies (whitelists, regions, risk caps)

• ✅ Monitor compliance via real-time dashboards

📦 Code Snippet:

tsCopyEditimport { wrapToken } from "@qbridge/sdk";

await wrapToken({
  tokenAddress: "0xTokenOnEthereum",
  metadata: {
    jurisdiction: "SG",
    assetType: "bond",
    restrictedTo: ["accredited", "non-US"]
  }
});

📊 Issuer Dashboard Includes:

• Chain-specific compliance status

• Token flow logs

• Audit-ready policy snapshots

• Expiry and renewal alerts

---

💸 For DeFi Protocols

Goal: Accept bridged RWA tokens as collateral or staking assets — safely.

🔧 Integration Highlights:

• ✅ Use oracles to fetch legal + pricing metadata

• ✅ Validate token provenance and zkLedger trail

• ✅ Optional: Restrict lending pools to compliant users

🔍 Metadata API:

tsCopyEditGET /api/token/{tokenId}/compliance

// Response
{
  valid: true,
  jurisdiction: "UK",
  credit_rating: "AA-",
  usage: "collateral"
}

🔐 Benefits:

• Better risk models

• Attract institutional liquidity

• Zero-maintenance compliance enforcement

---

🧾 For Custodians & Auditors

Goal: Monitor or participate in QBridge transport events with full audit transparency.

🔧 Integration Highlights:

• ✅ zkLedger Explorer to view token transfer trail

• ✅ Optional bridge validator node role

• ✅ Off-chain snapshot & PDF export for compliance archiving

📊 zkLedger Explorer Example:

jsonCopyEdit{
  "event": "bridgeMint",
  "token": "RWA-BOND-43",
  "amount": 100000,
  "timestamp": "2025-10-19T15:22Z",
  "jurisdiction": "SG",
  "auditable": true
}

🔁 Optional Role:

• Run a validator node with partial policy enforcement responsibility

• Receive $QB incentives for uptime and checkpoint finalization

---

🧠 Visual Suggestion: Integration Matrix Table

Role	Tools Provided	Onboarding Time	Access Level
RWA Issuer	Wrap SDK, Policy Config	~15 minutes	Write + Monitor
DeFi App	Metadata APIs, Oracle Hook	~10 minutes	Read + Filter
Custodian	zkLedger Viewer, Exporter	~10 minutes	Read + Validate