glyphdocs
Start

Getting started with Glyph Connect

Build a Qubic mainnet connection with @glyph-oss/connect 4.0.1.

This path takes you from installation to a deployed connection using the supported matrix:

  • @glyph-oss/connect@4.0.1
  • @qubic.org/crypto@1.0.0 for dApp-side Qubic callback verification
  • glyph://v2/request?d=<base64url-envelope> requests
  • Relay v2 prepared sessions
  • an explicit qubic:mainnet network binding
  • Glyph Wallet v0.16.5

The starter-dapp repository is the canonical runnable example. Use it when you want a complete connector, UI feedback, and Qubic signature verification in one project.

The request flow

  1. Build a typed request with a nonce and expiry.
  2. Prepare a Relay v2 session before the user asks to connect.
  3. Create an envelope with the Relay callback URL and qubic:mainnet.
  4. Subscribe through the Relay read capability, then launch the request from the user's direct action.
  5. Accept only a strictly verified, signed callback result.

The SDK computes a request_hash over the envelope. Keep the request, envelope, and expected callback values together so the result can be checked against the exact action the user approved.

Continue

On this page