Clients Introduction
Clients are the end users who initiate and complete payments through the xPlug ecosystem. They can be individuals, wallets, or applications interacting with a merchant that integrates xPlug SDK or xPlug Pay.
In a typical flow, a client interacts indirectly with the x402 network all transactions are relayed, verified, and finalized through an xPlug Facilitator, ensuring that the client experience remains instant, secure, and gasless.
The Client’s Role
Clients act as the payment originators in the x402 protocol. When a client makes a payment through xPlug Pay or a merchant-integrated SDK, they:
Authorize a payment request.
Sign the transaction using their Solana wallet (e.g., Phantom, Solflare).
Submit the signed request which is automatically handled by an xPlug Facilitator.
From this point forward, the Facilitator takes over, verifying the transaction and ensuring it’s correctly routed through x402 for settlement.
The client never needs to manually broadcast or pay gas; all operational details are handled under the hood.
Gasless Transactions
A core feature of xPlug is gasless client transactions. When a client initiates a payment:
The Facilitator covers the Solana transaction fees.
The user only transfers the exact payment amount (no hidden cost).
The transaction is still verified and finalized on-chain, ensuring full transparency.
This makes xPlug Pay ideal for mass adoption, removing the friction of managing SOL balances or network fees clients can simply plug, pay, and confirm.
Client Transaction Lifecycle
Payment Request Creation The merchant (via SDK or Pay link) creates a payment request that defines:
Recipient wallet
Token and amount
Optional metadata (invoice ID, description, etc.)
Client Authorization The client reviews and signs the payment request using their connected wallet.
Facilitator Relay The Facilitator node receives the signed request, validates it, and relays it to the x402 verification layer.
On-chain Settlement The x402 protocol confirms payment and releases the verified transaction record.
Completion & Receipt The client receives a confirmation response with an on-chain transaction hash, proving the payment is finalized and verifiable.
Verification & Trust
Verification & Trust
Every client transaction includes:
Digital signature validation (ensuring the request came from the authorized wallet)
Token authenticity checks (supported SPL tokens only)
Facilitator verification logs (timestamp, node ID, transaction reference)
This ensures clients are protected against:
Replay attacks
Double spending
Fake confirmations
xPlug’s Facilitator layer acts as a trustless middle-ground that ensures security without requiring users to run or interact with any backend systems.
Seamless Experience for Users
xPlug is designed to abstract away all blockchain complexity. For clients:
No RPC setup
No gas handling
No network switching
No failed or pending transactions
Every transaction is instant, validated, and verifiable, thanks to the high-speed Solana environment and xPlug’s Facilitator reliability.
Last updated