Wallet Management

The SDK includes essential wallet features, such as wallet creation, balance checks, and support for Single Sign-On (SSO) wallets. These functionalities simplify dApp development and blockchain interactions.

With just a few lines of code, developers can integrate wallet management capabilities into their AI agents, which makes it easier to build decentralized applications with enhanced blockchain interaction.

To learn more about the underlying Developer Platform functionalities, please visit Developer Platform Client SDK Wallet Module.

1.1 Create wallet

Create a new blockchain wallet. It retrieves the wallet's address and private key using the Crypto.com developer platform.

Query

• Example Query

  "Create a wallet"

Response

• Returns

  str: A formatted string containing the wallet's address and private key.

• Example Response

  A new wallet has been created successfully. Here are the details:
  - Wallet Address: <example-address>
  - Private Key: <example-private-key>
  Please ensure to store the private key securely, as it is essential for accessing your wallet.

Example Code

from crypto_com_agent_client import Agent

agent = Agent.init(
    llm_config={
        "provider": "OpenAI",
        "model": "gpt-4o-mini",
        "temperature": 1,
        "provider-api-key": "sk-proj-example-key",
        "temperature": "float-controlling-output-randomness",
    },
    blockchain_config={
        "api-key": "your-crypto.com-developer-platform-api-key",
        "private-key": "your-private-key",
        "sso-wallet-url": "your-sso-wallet-url",
        "timeout": "timeout-in-seconds-for-API-calls-default-20s")
    },
)

response = agent.interact("Create a wallet")
print(response)

1.2 Get Wallet Balance

Retrieve the balance of a specified wallet address.

Query

• Arguments

  address (str): The address to get the balance for (e.g., "xyz.cro").

• Example Query

  "Get wallet balance of <example-wallet-address>"

Response

• Returns

  str: A formatted string containing the wallet balance.

• Example Response

  The wallet balance for address <example-wallet-address> is <example-balance>.

Example Code

from crypto_com_agent_client import Agent
agent = Agent.init(
    llm_config={
        "provider": "OpenAI",
        "model": "gpt-4o-mini",
        "provider-api-key": "sk-proj-example-key",
        "temperature": 1,
    },
    blockchain_config={
        "api-key": "your-crypto.com-developer-platform-api-key",
        "private-key": "your-private-key",
        "sso-wallet-url": "your-sso-wallet-url",
        "timeout": "timeout-in-seconds-for-API-calls-default-20s")
    },
)

response = agent.interact("Get wallet balance of <example-wallet-address>")
print(response)

1.3 Send via SSO Wallet

Generate a URL that can be used to initiate a token transfer through the SSO wallet interface. If "null" is specified as the receiver, it will use the null address (0x0000000000000000000000000000000000000000).

Query

• Arguments

  receiver (str): The recipient's blockchain address or "null" for null address.
  amount (int): The amount of tokens to transfer in Wei.
  data (str, optional): Additional data for the transfer. Defaults to "0x"

• Example Query

  "Send <example-amount> Wei to <example-recipient> with data <example-data> through sso wallet"

Response

• Returns

  str: A formatted URL for the SSO wallet transfer.

• Example Response

  The token transfer has been initiated. 
  You can use the following URL to complete the transaction through the SSO wallet:
  [Transfer Token](None/transfer-token?recipient=<example-recipient>&amount=<example-amount>&data=<example-data>)
  Please follow the link to proceed with the transfer.

Example Code

from crypto_com_agent_client import Agent

agent = Agent.init(
    llm_config={
        "provider": "OpenAI",
        "model": "gpt-4o-mini",
        "provider-api-key": "sk-proj-example-key",
        "temperature": 1,
    },
    blockchain_config={
        "api-key": "your-crypto.com-developer-platform-api-key",
        "private-key": "your-private-key",
        "sso-wallet-url": "your-sso-wallet-url",
        "timeout": "timeout-in-seconds-for-API-calls-default-20s")
    },
)

response = agent.interact("Send <example-amount> Wei to <example-recipient> with data <example-data> through sso wallet")
print(response)