Initiating Developer-Controlled Wallet Creation

We have reached an exciting milestone: setting up your initial developer-controlled wallet within the web3 realm. Armed with your API key and Entity Secret Ciphertext, we're positioned to begin the creation process. Let's proceed with the details.

The Developer-Controlled Wallet Explained

In the context of web3, a wallet extends beyond a mere repository for digital assets such as tokens or NFTs. It represents the core conduit for interacting on the blockchain network. Essentially, a wallet is defined by a distinct address with associated metadata recorded on the blockchain.

For your developer-controlled wallets:


An address functions as a distinct identifier within a blockchain ecosystem. It's important to note that while an address is unique, it can be consistent across various EVM-compatible blockchains, allowing multiple wallets to share the same address.

Custody Type

This aspect indicates the entity responsible for the management of private keys—either the end user or the developer. In our context, we're examining developer-controlled wallets, which offer enhanced manageability and can be customized to align with the particular demands of your application.

With that foundational knowledge, let's get to the hands-on part.

Crafting your wallet

To create a wallet you will need the following parameters:

Request parameters

  • idempotencyKey

    Ensures that a request is only executed once, even if it's received multiple times.

  • entitySecretCiphertext

    The encrypted form of your Entity Secret, ensuring robust security for your API requests.

  • walletSetId

    The id of the wallet set that you've created in the last step.

  • blockchains

    Specifies on which blockchains the wallet should be manifested.

  • count

    The number of wallets you aim to create. Note: The parameter should not exceed 20.

Create Wallets

We have simplified the wallet creation process within the "Try it out" component provided below. This component will enable you to create wallets on the Ethereum and Polygon testnet seamlessly, setting the stage for the subsequent steps of this Quickstart.

We will automatically fund the newly created wallets with testnet tokens, so you can start right away. The ETH wallet will receive 10 USDC. This will be enough for this Quickstart.

Try it out:Create required wallets

Note: The input parameters of this component differ from those of the actual endpoint. For instance, we automatically generate the Entity Secret Ciphertext to simplify the process and ensure a better experience for you.

And there you have it! By the end of this step, you'll have fully functional developer-controlled wallets, ready to shape web3 experiences.

Need help or have questions?

Here are some helpful links:

🎮Join our Discord Community: Engage, learn, and collaborate.
🛎Visit our Help-Desk Page: Dive into curated FAQs and guides.
📧Direct Email: We're always a message away.
📖Read docs: Check out our developer documentation.
© 2023 Circle Technology Services, LLC. All rights reserved.