Skip to content

Instantly share code, notes, and snippets.

@Aboudjem

Aboudjem/01-asset-passport.md

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

  • Select an option

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

Select an option

Learn more about clone URLs
Save Aboudjem/6d23c7c9d709a70d6aeae88965cde11b to your computer and use it in GitHub Desktop.
Download ZIP
Integra Testnet PRD-01: Asset Passport
Raw
01-asset-passport.md

Asset Passport

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

Overview

Asset Passport is the entry point to the Integra ecosystem. Every user's first action is minting a token that represents a real-world asset (property, gold, silver, treasury bonds, or stocks) into their wallet. This token becomes the canonical on-chain identity for that asset, usable across the entire ecosystem -- wrapping, trading, lending, and agent management all start here. Passports are transferable (not soulbound) to enable secondary market trading on the GOB.

Features

  • Asset Type Selection -- choose from 5 types: property, gold, silver, treasury bonds, stocks
  • One-Click Mint -- connect wallet and mint a passport in under 30 seconds
  • Mock Valuations -- pre-configured value ranges per type (Property 100K-5M, Gold 1K-100K, Silver 500-50K, Bonds 10K-1M, Stocks 100-500K IRL)
  • On-Chain Metadata -- asset type, mint timestamp, description, and mock valuation stored with the token
  • Passport Detail Page -- view asset type, mint date, token ID, owner, and transfer history
  • Token Standard Visibility -- detail page shows current standard (ERC-721) and available wrap targets (ERC-20, ERC-721, ERC-3643, ERC-1404)
  • Post-Wrap Cross-Reference -- after wrapping, passport page links to the wrapped IRWA token
  • Explorer Deep Links -- every minted passport links to its token page on Integra Explorer with real-time tx status
  • Transferable Passports -- passports can be transferred between wallets, enabling GOB trading
  • Web3Auth Login -- shared @integra/web3auth-provider for seamless wallet connection
  • Agent Minting -- agents can mint passports on behalf of users via AgentAuth contract
  • Testnet Faucet Integration -- users receive IRL tokens to cover mint gas
  • XP on Mint -- XP awarded immediately on successful passport mint

Functions

  • mintPassport -- mint a new Asset Passport with selected asset type and metadata
  • getPassportMetadata -- retrieve asset type, valuation, description, and mint timestamp for a token ID
  • transferPassport -- transfer passport ownership to another wallet address
  • getPassportsByOwner -- list all passports owned by a given wallet address
  • getWrappedToken -- return the linked IRWA token address/ID if the passport has been wrapped
  • isWrapped -- check whether a passport has been wrapped
  • emitXPAction -- emit XP event on successful mint (consumed by XP system listener)

User Flow

  1. User arrives at passport.integralayer.com and connects wallet via Web3Auth
  2. User selects an asset type from the 5 available categories
  3. User enters or accepts default metadata (description, mock valuation)
  4. User confirms the mint transaction (gas paid in testnet IRL from faucet)
  5. Passport token appears in wallet within 1 block confirmation
  6. User lands on passport detail page showing metadata, token standard, and Explorer link
  7. User sees available next steps: wrap this passport into an IRWA token, or mint another

Deliverables

  • Smart contract deployed and verified on Integra Explorer
  • Frontend accessible at passport.integralayer.com
  • XP integration (mint action emits points)
  • Integra Explorer deep links for every minted token and transaction
  • Ecosystem Hub listing
  • Faucet integration for testnet IRL distribution
  • Agent minting via AgentAuth operational
  • Token standard visibility on passport detail page

Integration Points

  • Depends on: Testnet chain (active), Faucet (Nawar), Smart Wallet (Nawar), App Domain Router (Adam), XP System listener (Milind + Kalki)
  • Used by: Wrapper (accepts passports as input), GOB (passports tradeable directly), Agent Arena (minting agents), Lending App (wrapped passports as collateral)
  • Explorer: Token pages, tx hashes, owner history on Integra Explorer (github.com/Integra-layer/integra-explorer, branch: feature/INT-424-sync-passport-api-rwa-metadata)

XP Rewards

Action Points
First passport mint 100
Additional passport mint 25
Agent-assisted mint 50
Transfer a passport 10

Success Metrics

Metric Target
Passports minted during testnet 5,000+
Average time to mint (UX) < 30 seconds
Mint-to-wrapper conversion rate > 60%
Zero failed mints from contract bugs 100% uptime
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment