Creating Your Developer-Controlled Wallets

Ah, the most exhilarating phase: shaping your very first developer-controlled wallet in the vastness of web3. With your prepped API key and Entity Secret Ciphertext, we're only a few steps away from crafting a masterpiece. Let's dive right in!

Understanding the Developer-Controlled Wallet

In web3, a wallet isn't just a storage mechanism for digital tokens or NFTs but the very essence of user interactions on the blockchain. Essentially, it's a blend of a unique address and accompanying metadata stored on the blockchain.

For developer-controlled wallets:


A unique identifier on a blockchain. Notably, while an address remains distinct, multiple wallets can have the same address across different EVM blockchains.

Custody Type

This signifies who controls the private key invocation — either the user or the developer. For our purpose, we're focusing on developer-controlled wallets, which are inherently more manageable and tailored for specific app requirements.

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.

Creating Wallets

To ensure the best possible experience, we will automatically create and fund two wallets with testnet tokens. Each wallet will be set up on the Polygon network and funded with 10 USDC, allowing you to dive right into the Quickstart without delay. Rest assured, this amount will be sufficient for you to initiate your first transaction.

Try it out:Create your first 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:

🎥Watch and learn: Watch our step-by-step walkthrough of the guide
🎮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.