NEOPIN Docs
  • NEOPIN Introduction
    • Vision
    • Permissioned DeFi Protocol
  • ✅GET STARTED
    • Download App
    • Create Wallet
    • Sign in (Import Wallet)
    • App settings
    • NEOPIN Wallet
  • 📈EARN WITH NEOPIN
    • Index
      • How it works
      • Backtest
      • RWA Project Index (RPI)
        • [RPI] Rebalancing History
          • [RPI] 28.08.2024 Rebalance
          • [RPI] 02.01.2025 Rebalance
          • [RPI] 27.03.2025 Rebalance
          • [RPI] 14.04.2025 Rebalance
      • Ethereum Family Index (EFI)
        • [EFI] Rebalancing History
          • [EFI] 09.09.2024 Rebalance
          • [EFI] 02.01.2025 Rebalance
          • [EFI] 27.03.2025 Rebalance
      • AI Titans Index (ATI)
        • [ATI] Rebalancing History
          • [ATI] 09.09.2024 Rebalance
          • [ATI] 02.01.2025 Rebalance
          • [ATI] 27.03.2025 Rebalance
      • [App] Index Guide
      • [Web] Index Guide
    • Derivatives
      • RWA
        • [App] NEOPIN BDLP Guide
        • [Web] NEOPIN BDLP Guide
      • Yield Aggregator
        • [App] NEOPIN SDLP Guide
        • [Web] NEOPIN SDLP Guide
    • Pool
      • [App] Pool Guide
      • [Web] Pool Guide
      • Impermanent Loss
    • Swap
      • [App] Swap Guide
      • [Web] Swap Guide
      • Automated Market Maker
    • Stake
      • [App] Stake Guide
      • [Web] Stake Guide
    • Liquid Stake
      • Why is my 1 npETH less than 1 ETH?
      • Unstake with npToken
      • [APP] Liquid Stake Guide
      • [WEB] Liquid Stake Guide
    • Bridge
      • [App] Bridge Guide
      • [Web] Bridge Guide
  • 🔷MEMBERSHIP
    • NEOPIN Club Membership: Current
      • How it works
      • Membership Points
      • Weighted Point Multiplier for Each Product
      • Participant Distribution Across Tiers
      • NEOPIN Club Membership Benefits
    • The First Season: 2023
      • Introduction
      • How It Works
      • How To Earn Points
        • Weighted Point Multiplier for Each Product
      • Leaderboard
      • Participant Distribution Across Tiers
      • Gift Box & Opening
      • Transition to NEOPIN Club Membership (S1 SBT)
  • 📣Referral
    • NEOPIN Referral Program
      • How it works
      • How To Earn Points
      • Leaderbord
  • 🗳️Governance Vote
    • Introduction
    • NEOPIN Governance Vote
    • Klaytn Governance Vote
    • [Deprecated] Finschia Governance Vote
    • [App] Governance Voting Guide
    • [Web] Governance Voting Guide
  • ↗️Kaia Migration
    • (EN) Klaytn x Finschia Merger to Kaia
      • Guide for FNSA holder
        • [Mobile] Guide to convert FNSA to KAIA
        • [Web] Guide to convert FNSA to KAIA
      • Guide for nFNSA holders
        • [App] Guide to convert nFNSA to KAIA
        • [Web] Guide to convert nFNSA to KAIA
      • Guide to Stake KAIA
  • 📊TOKENOMICS
    • NEOPIN Economy
      • NPT Tokenomics
      • Automated Reallocation Mechanism (AutoRM)
      • Issuance and Allocation
  • 🎉EVENT
    • [Closed] NEOPIN DeFi Carnival
  • 🗓️ROADMAP
    • #2023
    • #2024
  • 📃DLT Framework
    • NEOPIN Protocol DLT Framework
  • 💻DEVELOPERS
    • WalletConnect 2.0
      • Namespaces
      • Mobile Linking
      • Methods
        • EVM Methods
        • Cosmos Methods
    • Deprecated
      • (Deprecated) NEOPIN Connect 1.0
        • DApp
          • Android
            • Installation
            • Usage
            • Functions
            • SDK Components
            • Reference
            • Version History
          • iOS
            • Installation
            • Usage
            • Functions
            • SDK Components
            • Reference
            • Version History
          • Web
            • Installation
            • Usage
              • web3-react
              • Neopin Connect Modal
            • Reference
            • Related Package
            • Sample DApp Page
          • Unity
            • Installation
            • Usage
            • SDK Components
            • Reference
            • Version History
        • Wallets
          • Android
            • Installation
            • Usage
              • Connect
              • Approve
              • Transaction
          • iOS
            • Installation
        • JSON-RPC API Methods
        • Error Code
        • Technical Specification
  • 🔗LINKS
    • Website
    • NEOPIN Web
    • Android App Download
    • iOS App Download
    • Community Links
    • Contact us
Powered by GitBook
On this page
  • Introduction​
  • Core Architecture​
  1. DEVELOPERS
  2. Deprecated
  3. (Deprecated) NEOPIN Connect 1.0

Technical Specification

PreviousError CodeNextContact us

Last updated 1 year ago

The following information is deprecated and may limit its use. Please refer to the WalletConnect 2.0 tab for the latest version of NEOPIN wallet integration: WalletConnect 2.0

Introduction

WalletConnect is an open protocol for connecting Dapps to Wallets. The motivation behind it came from the lack of user-friendly Wallets available to the user - In particular solutions which don't require installing browser extensions. In order to solve this it was designed to not require any additional software or hardware to connect a Wallet to a Dapp. The design is mostly tailored to mobile wallets but it could definitely support desktop wallets as well. The protocol relies that both the Dapp and the Wallet use WalletConnect Client and connect to a Bridge server that will relay the communications. The communication is initiated with a standard URI format that contains the topic of the connection request, a symmetric key is then used to decrypt the payload and the bridge server url.

Core Architecture

The architecture consists essentially of a websocket server (Bridge) between two peers (Dapp and Wallet) that use the Client.

Requesting Connection

The initiator, is the first peer who requests connection (Dapp). Dapp posts an encrypted payload consisting of one-time topic (used for handshake only) and connection request details to the Bridge Server. Then, by using the NeopinConnect URI format Dapp assembles together the required parameters to establish the connection: (handshake) topic, bridge (url) and (symmetric) key.

nptwc:{topic...}@{version...}?bridge={url...}&key={key...}
Required parts
Notes

nptwc:

Neopin Connect protocol

topic

String

version

Number (eg. 1.9.0)

bridge

Bridge URL (URL Encoded)

key

Symmetric key hex string

Other query string parameters are all optional.

// Example URL
nptwc:8a5e5bdc-a0e4-4702-ba63-8f1a5655744f@1?bridge=https://bridge.walletconnect.org

Establishing Connection

The second peer (Wallet) will read the URI using either a QR Code or a deep link. After reading the URI the peer will immediately receive and decrypt the connection request payload.

The Wallet will then display to the user request details provided by the Dapp. The user will then approve or reject the connection. If rejected, the Dapp will disconnect from the Bridge Server immediately and throw an error message if provided by the Wallet. If approved, the Dapp will receive provided account and chainId from the Wallet.

Once the connection is established, the Dapp will be able to send any JSON-RPC call requests to be handled by the Wallet either to read data from its node or make signing requests for transactions or messages.

💻
​
​
​