Embedded wallets

Start with Wallet setup and authentication to see the provider configuration. An embedded wallet renders in your product while its credentials and signing runtime stay on a dedicated HTTPS origin.

Use an embedded wallet when your application needs a persistent wallet for each user. Examples include marketplace balances, trading accounts, game inventories, payout accounts, stablecoin accounts, rewards, and automated onchain authority. A store collecting a one-time payment from an existing wallet usually does not need to provision another wallet for that shopper.

Read platform wallets for the customer fit and product boundary.

Configure the boundary

• Deploy the wallet service and SDK assets at the wallet origin.
• Allow the application origin.
• Use a matching relying party ID (RP ID).
• Set the project environment, publishable key, and network identity together.
• Configure a relayer or Router endpoint for each selected flow.
• Keep iframeWallet.walletOrigin, walletServicePath, and sdkBasePath aligned with the deployed assets.

The application must not mirror wallet service or SDK assets under its own origin.

Check before launch

• Registration asks the user to authenticate inside the wallet origin.
• Signing preserves the exact wallet identity through the session and account or chain reference.
• Reject unexpected message origins and stale iframe sessions.
• Review hosted integration and security boundaries before launch.