Wallets

Modular Wallets Console Setup

This guide demonstrates how to create a client key and configure passkey settings on the Circle Console.. This is needed to enable the basic functionality provided by Modular Wallets. Once these steps are completed, proceed to the Modular Wallets Quickstart.

Perform the steps below to create your client key.

  1. Login to the Circle Console, navigate to the API & Client Keys section, and click on Create a key.
  1. Select the Client Key option and type your client Key Name.

Each client key is bound to your application for identification and authorization. Therefore, depending on your application setup, you may be able to customize the following fields:

  • Web Allowed Domain; for example, your.website.com, or localhost
  • iOS Bundle ID; for example, com.yourcompany.yourapp
  • Android
    • Package Name; for example, com.yourcompany.yourapp
    • Signature (SHA256); for example, XX:XX:…:XX (where X: [0-9A-F])
  1. Verify that the Client Key was created.

Once the information provided in the previous steps is validated, the system generates a client key. Please store it in a safe place, as it won't be displayed on the Console again.

Perform the steps below to configure the Domain Name for your Passkey.

Enter the domain name of your application where users will be onboarded. Each passkey created will be associated with this domain.

Configuration is required to enable Passkeys on mobile-native applications:

  • iOS: A JSON file is required at the domain root:
    /.well-known /apple-app-site-association. Refer to this resource for more details.
  • Android: A JSON file is required at the domain root:
    /.well-known/assetlinks.json. Refer to this resource for more details.

Visit the Configurator page to retrieve the Client URL, or copy from here: https://modular-sdk.circle.com/v1/rpc/w3s/buidl. This URL is required for the following Modular Wallets SDK methods:

  • toPasskeyTransport()
  • toModularTransport(): When using this method, you must specify the blockchain network. For more details, refer to the Modular Wallets Quickstart.
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.