Wallet Connector

Overview

Connectors can support injected browser wallets, mobile wallets, QR-based sessions, hardware devices, custodial APIs, or embedded wallets. They translate discovery, account access, network changes, signing requests, and events into an application-facing interface.

A connector may add dependencies and security assumptions. Compromised packages can alter requests or collect metadata, while inconsistent wallet behavior can produce stale accounts, duplicate events, or unsupported methods. Connection success does not mean the requested transaction is valid or finally settled.

Developers should use maintained connectors, pin and review dependencies, validate origin and wallet capabilities, and handle disconnects, rejection, network changes, timeouts, and duplicate messages safely. Applications should display exact signing intent and verify returned signatures. Broadcast, confirmation, and application state must be tracked separately and reconciled after the connector completes its role.

The Wallet Connector workflow operates through several distinct states: request creation, user or policy approval, signature generation, network submission, execution, confirmation, balance recognition, and accounting. For Wallet Connector, a wallet interface or provider response can report progress, but it cannot replace verified transaction and ledger evidence.

Material risks for Wallet Connector include credential compromise, malicious destinations, unsupported assets, wrong-network transfers, stale balances, compromised software, provider outage, privacy leakage, and inaccessible recovery material. For Wallet Connector, controls should reflect value, automation, reversibility, and whether the organization or a third party controls signing.

Wallet Connector should be distinguished from the asset balance and from the application that displays it. For example, a customer-facing success message does not prove that the intended transaction executed on the correct network; operations should verify execution and reconcile the result before irreversible fulfillment.