Developer-Controlled Wallets
Project description
circle-developer-controlled-wallets
This SDK provides convenient access to Circle's Developer Controlled Wallets APIs for applications written in Python. For the API reference, see the Circle Web3 API docs.
- Package version: 3.0.0
Requirements.
Python 3.7+
Installation
pip install
pip install circle-developer-controlled-wallets
Then import the package:
from circle.web3 import developer_controlled_wallets
Usage
-
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.
export CIRCLE_WEB3_API_KEY="Your API KEY"
-
Generate a new entity secret by using the helper function in the SDK. This will print a new entity secret which will be used in step 3 to register it.
from circle.web3 import utils utils.generate_entity_secret()
[!IMPORTANT]
Protect your Entity Secret as you would protect your house key. Losing it or sharing it with others can have serious consequences. As the name suggests, the Entity Secret is sensitive information. Store it securely and treat it with the highest level of confidentiality to prevent unauthorized access or use. -
Register the entity secret either by using the SDK or by following Circle's Developer-Controlled QuickStart. This step ensures that your account is correctly set up to interact with Circle's APIs.
from circle.web3 import utils result = utils.register_entity_secret_ciphertext(api_key='your_api_key', entity_secret='new_entity_secret') print(result)
[!IMPORTANT] The
register_entity_secret_ciphertext
function downloads a recovery file namedrecovery_file_<timestamp>.dat
. This file should be stored securely, similar to the entity secret. Additionally, the function returns the content of the recovery file as a JSON response. -
In your code, use the
init_developer_controlled_wallets_client
function from the utils and initialize the client using your API key and entity secret:from circle.web3 import utils client = utils.init_developer_controlled_wallets_client(api_key="Your API KEY", entity_secret="Your entity secret")
-
Interact with the client:
from circle.web3 import utils
from circle.web3 import developer_controlled_wallets
client = utils.init_developer_controlled_wallets_client(api_key="Your API KEY", entity_secret="Your entity secret")
api_instance = developer_controlled_wallets.WalletSetsApi(client)
# create wallet sets
try:
request = developer_controlled_wallets.CreateWalletSetRequest.from_dict({
"name": "my_wallet_set"
})
response = api_instance.create_wallet_set(request)
print(response)
except developer_controlled_wallets.ApiException as e:
print("Exception when calling WalletSetsApi->create_wallet_set: %s\n" % e)
# list wallet sets
try:
response = api_instance.get_wallet_sets()
for wallet_set in response.data.wallet_sets:
print(wallet_set.actual_instance.id)
except developer_controlled_wallets.ApiException as e:
print("Exception when calling WalletSetsApi->get_wallet_sets: %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 |
entity_secret | Yes | Your configured entity secret. 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 Developer-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!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file circle_developer_controlled_wallets-3.0.0.tar.gz
.
File metadata
- Download URL: circle_developer_controlled_wallets-3.0.0.tar.gz
- Upload date:
- Size: 77.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | aa52814176feda4979a8716257abb82d6383e70a3327aaa96e7ee3f003f14193 |
|
MD5 | f2ecb5037bd8df08e0daf0c6faa4cbd6 |
|
BLAKE2b-256 | 6f8619279ee23b1eaf72d35fe031c8cccbb4ffd28c87b8c3c3aab244f4fd5f8c |
File details
Details for the file circle_developer_controlled_wallets-3.0.0-py3-none-any.whl
.
File metadata
- Download URL: circle_developer_controlled_wallets-3.0.0-py3-none-any.whl
- Upload date:
- Size: 160.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8361c7a4648f0739a923b2c060d5daaca194227722e325db78476245e990fe71 |
|
MD5 | 5b6e8effd04496522cf586571c7a58e0 |
|
BLAKE2b-256 | b76084f463a30e18d2872c9b69f6feeb7723e100ef3d3cb5a50e669cdbb5a0e2 |