circle-user-controlled-wallets 9.3.3

User-Controlled Wallets

circle-user-controlled-wallets

User-Controlled Wallets API documentation.

• API version: 1.0
• Package version: 9.3.3

Requirements.

Python 3.9+

Installation

pip install

pip install circle-user-controlled-wallets

Then import the package:

from circle.web3 import user_controlled_wallets

Usage

1. Generate an API key, if you haven't already, in the Web3 Services Console. This API key will be used for authentication and authorization when making requests to Circle's APIs. API key can be set by environment variable or function parameter

export CIRCLE_WEB3_API_KEY="Your API KEY"

2. Follow our User-Controlled QuickStart. This step ensures that you fully grasp the concept of Circle's User-Controlled Wallets.

3. Initiate API client

from circle.web3 import utils

client = utils.init_user_controlled_wallets_client(api_key="Your API KEY")

4. Interact with the client:

import uuid
from circle.web3 import user_controlled_wallets

# generate a user id
user_id = str(uuid.uuid4())

# create user
api_instance = user_controlled_wallets.UsersApi(client)
try:
    request = user_controlled_wallets.CreateUserRequest(user_id=user_id)
    api_instance.create_user(request)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling UsersApi->create_user: %s\n" % e)

# get user
try:
    response = api_instance.get_user(id=user_id)
    print(response.data)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling UsersApi->get_user: %s\n" % e)

# get user token
try:
    auth_api_instance = user_controlled_wallets.PINAuthenticationApi(client)
    request = user_controlled_wallets.UserTokenRequest.from_dict({"userId": user_id})
    response = auth_api_instance.get_user_token(request)
    print(response)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling PINAuthenticationApi->get_user_token: %s\n" % e)

We recommend reading through the official documentation and QuickStart guides mentioned above to ensure a smooth setup and usage experience.

Configuration

The client accept following configuration parameters:

Option	Required	Description
api_key	Yes	Api Key that is used to authenticate against Circle APIs. Must be provided by ether env variable or function parameter.
host	No	Optional base URL to override the default: https://api.circle.com/v1/w3s.
user_agent	No	Optional custom user agent request header. We will prepend it to default user agent header if provided.

Need help or have questions?

Here are some helpful links, if you encounter any issues or have questions about this SDK:

• 📖 Getting started: Check out our official User-Controlled Wallets QuickStart.
• 🎮 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. Happy coding!