Skip to content

Instantly share code, notes, and snippets.

@Aboudjem

Aboudjem/02-wrapper.md

Last active March 30, 2026 08:07
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Aboudjem/5cc41e598941736edbb3a8dd10ee3df1 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Aboudjem/5cc41e598941736edbb3a8dd10ee3df1 to your computer and use it in GitHub Desktop.
Download ZIP
Integra Testnet PRD-02: Wrapper
Raw
02-wrapper.md

Wrapper

Owner: Nawar + Kalki | Ship: Week 1-2 | Est: 2-3 days | Chain: integra-testnet-1 (EVM 26218) URL: wrapper.integralayer.com

Overview

The Wrapper transforms a static Asset Passport into a composable IRWA (Integra Real World Asset) token. This is the second step in the core user flow and the heart of Integra's value proposition -- taking a raw on-chain asset representation and wrapping it into an AI-enhanced token that supports multiple token standards, compliance simulation, and cross-ecosystem usability. Once wrapped, the token can be traded on the GOB, used as collateral in the Lending App, and managed by AI agents.

Features

  • Multi-Standard Wrapping -- wrap into ERC-20 (fungible), ERC-721 (unique), ERC-3643 (regulated/compliant), or ERC-1404 (restricted transfer)
  • Step-by-Step Wizard -- guided wrapping flow with clear progress indicators at each stage
  • Passport Locking -- original passport is locked when wrapped, preventing double-wrapping (1:1 relationship)
  • AI Wrapping Visualization -- animated visual showing the AI agent analyzing, classifying, and enhancing the asset during the wrap process
  • Compliance Metadata -- ERC-3643 wraps include simulated identity registry and compliance module data
  • Transfer Restriction Simulation -- ERC-1404 wraps demonstrate restriction codes and transfer validation
  • Cross-Ecosystem Usability -- wrapped tokens are recognized by GOB, Lending App, Agent Arena, and all micro-apps
  • Standard Comparison -- side-by-side explanation of each token standard before user selects
  • Wrapped Token Detail Page -- shows original passport reference, wrapping standard, wrap date, and compliance status
  • Explorer Integration -- wrapped IRWA token linked on Integra Explorer with standard badge
  • Agent Wrapping -- agents can wrap assets autonomously via AgentAuth and smart wallet
  • Liquid Asset Focus -- optimized for gold, silver, treasury bonds, and stocks (high-velocity wrapping)
  • XP on Wrap -- XP awarded on successful wrapping completion

Functions

  • wrapPassport -- accept an Asset Passport token ID and mint a wrapped IRWA token in the selected standard
  • getWrappedMetadata -- return original passport reference, standard, wrap date, and compliance data
  • getWrapStatus -- check if a passport is wrapped and return the IRWA token address/ID
  • lockPassport -- lock the original passport so it cannot be transferred or re-wrapped
  • unlockPassport -- release the passport lock (admin/future unwrap flow)
  • setComplianceData -- attach simulated compliance metadata for ERC-3643/ERC-1404 wraps
  • getComplianceStatus -- return compliance flags and restriction codes for a wrapped token
  • getSupportedStandards -- list available wrapping standards for a given asset type
  • emitXPAction -- emit XP event on successful wrap

User Flow

  1. User navigates to wrapper.integralayer.com and connects wallet via Web3Auth
  2. User selects an unwrapped Asset Passport from their wallet
  3. Wizard presents the 4 token standard options with plain-language explanations
  4. User selects a target standard (ERC-20, ERC-721, ERC-3643, or ERC-1404)
  5. AI wrapping visualization plays -- showing the agent analyzing the asset and applying the standard
  6. For ERC-3643/ERC-1404: simulated compliance checks run (identity verification, transfer restrictions)
  7. User confirms the wrap transaction
  8. Wrapped IRWA token appears in wallet; original passport is locked
  9. Detail page shows the wrapped token with Explorer link and next steps (trade on GOB, use as collateral)

Deliverables

  • IRWA smart contract deployed and verified on Integra Explorer
  • Frontend accessible at wrapper.integralayer.com
  • Step-by-step wrapping wizard with standard selection
  • AI wrapping visualization (animated)
  • ERC-3643 compliance simulation (mock identity registry + compliance module)
  • ERC-1404 transfer restriction simulation
  • XP integration (wrap action emits points)
  • Integra Explorer deep links for wrapped tokens with standard badge
  • Ecosystem Hub listing
  • Agent wrapping via AgentAuth operational

Integration Points

  • Depends on: Asset Passport contract (Nawar), Smart Wallet (Nawar), AI agent wrapping service (Kalki), XP System listener (Milind + Kalki), App Domain Router (Adam)
  • Used by: GOB (accepts wrapped tokens for trading), Lending App (accepts wrapped tokens as collateral), Agent Arena (wrapping agents), Tokenization Playground (references wrapping logic)
  • Explorer: Wrapped IRWA tokens on Integra Explorer (github.com/Integra-layer/integra-explorer) with standard badge (ERC-20/721/3643/1404)

XP Rewards

Action Points
First wrap 150
Additional wrap 50
ERC-3643 compliance wrap 75 (bonus)
ERC-1404 restricted wrap 75 (bonus)
Agent-assisted wrap 50

Success Metrics

Metric Target
Assets wrapped during testnet 3,000+
Wrap completion rate (started wizard to finished) > 80%
Average wrap time < 1 minute
Wrapped tokens subsequently traded on GOB > 50% of wraps
All 4 standards used at least once 100%
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment