Python SDK quickstart

0. Prerequisites

This guide assumes the setup guide is complete and a Privy client instance named client is available.

1. Creating a wallet

First, create a wallet. The wallet’s id is used in future calls to sign messages and send transactions.

Ethereum
Solana

from privy import APIConnectionError, APIStatusError

try:
    wallet = client.wallets.create(chain_type="ethereum")
    wallet_id = wallet.id
except APIStatusError as error:
    # The API returned a non-success status code (4xx or 5xx).
    print(error.status_code, error.message)
    raise
except APIConnectionError as error:
    # The SDK could not connect to the Privy API.
    print(error.message)
    raise

from privy import APIConnectionError, APIStatusError

try:
    wallet = client.wallets.create(chain_type="solana")
    wallet_id = wallet.id
except APIStatusError as error:
    print(error.status_code, error.message)
    raise
except APIConnectionError as error:
    print(error.message)
    raise

Learn more about creating wallets.

Errors raised by the SDK inherit from PrivyAPIError. Catch APIStatusError for non-success API responses or a more specific subclass such as RateLimitError, BadRequestError, or NotFoundError. Catch APIConnectionError for network-level failures.

User wallets

Create a non-custodial user wallet by first creating a user, then provisioning a wallet for that user.

Ethereum
Solana

user = client.users.create(
    linked_accounts=[
        {"type": "email", "address": "[email protected]"},
    ]
)

wallet = client.wallets.create(
    chain_type="ethereum",
    owner={"user_id": user.id},
)

user = client.users.create(
    linked_accounts=[
        {"type": "email", "address": "[email protected]"},
    ]
)

wallet = client.wallets.create(
    chain_type="solana",
    owner={"user_id": user.id},
)

When creating a user wallet, specify the user ID as the owner of the wallet. Obtain a user ID by first creating a user.Alternatively, create a user and wallet at the same time by passing wallets to client.users.create.

2. Signing a message

Next, sign a plaintext message with the wallet using a chain-specific helper. Specify the wallet ID (not its address) from creation.

Ethereum
Solana

response = client.wallets.ethereum.sign_message(
    wallet_id,
    "Hello, Privy!",
)

# The Ethereum signature is hex-encoded.
signature = response.signature

response = client.wallets.solana.sign_message(
    wallet_id,
    b"Hello, Privy!",
)

# The Solana signature is base64-encoded.
signature = response.signature

Learn more about signing messages on Ethereum and Solana.

3. Sending transactions

The wallet must have funds to send a transaction. Use a testnet faucet to test transacting on a testnet (for example, Base Sepolia), or send funds to the wallet on the network of your choice.

Use a chain-specific transaction method to send a transaction. The SDK populates missing network-related values, signs the transaction, broadcasts it to the network, and returns the transaction hash. Specify the wallet id from wallet creation and the caip2 chain ID for the target network.

Ethereum
Solana

response = client.wallets.ethereum.send_transaction(
    wallet_id,
    caip2="eip155:11155111",  # Sepolia testnet
    params={
        "transaction": {
            "to": recipient_address,
            "value": "0x1",  # 1 wei
        }
    },
)

transaction_hash = response.hash

# A base64-encoded serialized transaction to sign and send.
transaction = "insert-base-64-encoded-serialized-transaction"

response = client.wallets.solana.sign_and_send_transaction(
    wallet_id,
    transaction,
    caip2="solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",  # Solana Devnet
)

transaction_hash = response.hash

Learn more about sending transactions on Ethereum and Solana.

For more control, prepare and broadcast the transaction independently, and use client.wallets.ethereum.sign_transaction for EVM or client.wallets.solana.sign_transaction for Solana.

4. Creating a user

To create a user independently of the user-wallet flow above, call create on the users service and pass the linked accounts to associate with the user.

user = client.users.create(
    linked_accounts=[
        {"type": "custom_auth", "custom_user_id": "your-subject-id"},
        {"type": "email", "address": "[email protected]"},
    ]
)

user_id = user.id

Learn more about creating users, and see the pregenerating wallets guide for linking wallets to users before they sign in.

Next steps

Authorization keys

Add an extra layer of security by signing requests with authorization keys.

Policies

Restrict what wallets can do with configurable policies.

Idempotency keys

Prevent duplicate transactions with idempotency key support.

Quorum approvals

Require multiple parties to approve before sending a transaction.

Get started

Client-side SDKs

Server-side SDKs

REST API

Changelogs

Troubleshooting and tips

Quickstart

0. Prerequisites

1. Creating a wallet

User wallets

2. Signing a message

3. Sending transactions

4. Creating a user

Next steps

Authorization keys

Policies

Idempotency keys

Quorum approvals

​0. Prerequisites

​1. Creating a wallet

​User wallets

​2. Signing a message

​3. Sending transactions

​4. Creating a user

​Next steps

Authorization keys

Policies

Idempotency keys

Quorum approvals

0. Prerequisites

1. Creating a wallet

User wallets

2. Signing a message

3. Sending transactions

4. Creating a user

Next steps