Crafting Your First API Call - Introducing Wallet Sets

You're about to embark on one of the most crucial stages in your journey: crafting your very first API call to create a WalletSet with our Web3 Services. But before you roll up your sleeves, let's delve deeper into the essence of WalletSets.

What is a WalletSet

In our ecosystem, a WalletSet isn't just any collection. It's a unified set of wallets, all managed by a single cryptographic private key. With the HD wallet feature, WalletSets elevate your management experience across supported blockchains. Especially on EVM chains, it's possible to have wallets from different chains sharing the same address.

Understanding idempotency

Before we create your first WalletSet, let's understand an essential element of our APIs: the idempotency key.

At its core, idempotency is a principle ensuring that an operation will produce the same result if executed multiple times. In the realm of API requests, this principle becomes imperative to ensure that a request, even if sent multiple times, is only executed once.

Why is this important? Think of scenarios like network glitches, where the same request might be sent twice, or cases where a user unintentionally clicks a button multiple times. Without idempotency, these actions might lead to unwanted duplicates or repetitive transactions.

The idempotency key comes into play here. It's a unique key you attach to your request. If the server receives the same key within a stipulated time, it knows not to process the request again, ensuring that you don't end up with unintended consequences.

Crafting Your WalletSet

Now that we've got the concept of idempotency covered, let's look at creating your WalletSet.

Request parameters

Documentation
  • idempotencyKey

    Think of this as a safety net. By using a unique UUID for every transaction request, you ensure no transaction is mistakenly processed more than once. It's a measure against unintended duplicates.

  • entitySecretCiphertext

    Remember the encryption we discussed earlier? You'll need to provide this encrypted string for security and authorization.

  • name
    The name for your new WalletSet.

Let's create our first wallet set!

Create WalletSet

Try it out:Create a WalletSet

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.

Ensure that your idempotency key is unique for every distinct request. Our APIs require the idempotency key to be of type uuidv4. Remember, its primary role is to ensure that the same request isn't processed more than once.

Accessing API logs

Every interaction you carry out through Circle's Web3 APIs can be precisely tracked within the Web3 Services Console. This monitoring ability gives you clear insights into your application's interactions with Circle's APIs. It greatly assists in debugging issues, improving performance, and enhancing security by pinpointing any unusual activities. See API logs

As part of the Quickstart guide, the API log proves invaluable in understanding the individual calls and the objects created. It serves as our "notebook," enabling us to look up the IDs of objects we've created, particularly when they're required for successive API calls. This feature enhances learning, streamlines debugging, and aids in achieving a structured understanding of the API interactions. Therefore, the API log not only bolsters operational efficiency but also acts as a strategic repository for your developmental needs.

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.