From my server

Privy enables your app to easily create server-side wallets on any EVM network or Solana.

If the wallet is for a user, use wallet pregeneration instead to associate the wallet with user’s login methods.

To create a wallet with the NodeJS SDK, use the create method from the Privy client’s walletApi class:

createWallet: (input: WalletApiCreateRequestType) => Promise<WalletApiCreateResponseType>

Usage

const {id, address, chainType} = await privy.walletApi.create({chainType: 'ethereum'});

Parameters

The create method accepts as a parameter an input object with the following fields:

chainType

'ethereum' | 'solana'

required

Chain type of the wallet to create.

policyIds

string[]

List of policy IDs for policies that should be enforced on the wallet. Currently, only one policy is supported per wallet.

idempotencyKey

string

Idempotency key to identify a unique request.

owner

{'publicKey': string}

The P-256 public key that will be the owner of the wallet. If you provide this, do not specify an owner_id as it will be generated automatically.

ownerId

string

The key quorum ID of the owner of the wallet. If you provide this, do not specify an owner.

additionalSigners

{'signerId': string}[]

List of key quorum IDs that should be allowed to approve transactions for the wallet.

Returns

string

Unique ID of the created wallet. This will be the primary identifier when using the wallet in the future.

address

string

Address of the created wallet.

chainType

'ethereum' | 'solana'

Chain type of the created wallet.

policyIds

string[]

List of policy IDs for policies that are enforced on the wallet.

ownerId

string | null

The key quorum ID of the owner of the wallet.

additionalSigners

{signerId: string}[]

The key quorum IDs of the additional signers for the wallet.

Your app can provision a smart account with the wallet as a signer by following this guide.

To create a wallet with the NodeJS SDK, use the create method from the Privy client’s walletApi class:

createWallet: (input: WalletApiCreateRequestType) => Promise<WalletApiCreateResponseType>

Usage

const {id, address, chainType} = await privy.walletApi.create({chainType: 'ethereum'});

Parameters

The create method accepts as a parameter an input object with the following fields:

chainType

'ethereum' | 'solana'

required

Chain type of the wallet to create.

policyIds

string[]

List of policy IDs for policies that should be enforced on the wallet. Currently, only one policy is supported per wallet.

idempotencyKey

string

Idempotency key to identify a unique request.

owner

{'publicKey': string}

The P-256 public key that will be the owner of the wallet. If you provide this, do not specify an owner_id as it will be generated automatically.

ownerId

string

The key quorum ID of the owner of the wallet. If you provide this, do not specify an owner.

additionalSigners

{'signerId': string}[]

List of key quorum IDs that should be allowed to approve transactions for the wallet.

Returns

string

Unique ID of the created wallet. This will be the primary identifier when using the wallet in the future.

address

string

Address of the created wallet.

chainType

'ethereum' | 'solana'

Chain type of the created wallet.

policyIds

string[]

List of policy IDs for policies that are enforced on the wallet.

ownerId

string | null

The key quorum ID of the owner of the wallet.

additionalSigners

{signerId: string}[]

The key quorum IDs of the additional signers for the wallet.

Your app can provision a smart account with the wallet as a signer by following this guide.

To create a new wallet, make a POST request to

https://api.privy.io/v1/wallets

Body

In the request body, include the following fields.

chain_type

'ethereum' | 'solana'

required

Chain type of the wallet to create.

policy_ids

string[]

List of policy IDs for policies that should be enforced on the wallet. Currently, only one policy is supported per wallet.

idempotency_key

string

Idempotency key to identify a unique request.

owner

{public_key: string} | null

The P-256 public key of the owner of the wallet. If you provide this, do not specify an owner_id as it will be generated automatically.

owner_id

string | null

The key quorum ID of the owner of the wallet. If you provide this, do not specify an owner.

additional_signers

{signer_id: string}[]

The key quorum IDs to add as additional signers for the wallet.

Response

In the response, Privy will send back the following if successful:

string

Unique ID of the created wallet. This will be the primary identifier when using the wallet in the future.

address

string

Address of the created wallet.

chain_type

'ethereum' | 'solana'

Chain type of the created wallet.

policy_ids

string[]

List of policy IDs for policies that are enforced on the wallet.

owner_id

string | null

The key quorum ID of the owner of the wallet.

additional_signers

{signer_id: string}[]

The key quorum IDs of the additional signers for the wallet.

created_at

number

The creation date of the wallet, in milliseconds since midnight, January 1, 1970 UTC.

Example

A sample request might look like the following:

curl --request POST https://api.privy.io/v1/wallets \
    -u "<your-privy-app-id>:<your-privy-app-secret>" \
    -H "privy-app-id: <your-privy-app-id>" \
    -H 'Content-Type: application/json' \
    -d '{
    "chain_type": "ethereum"
    }'

A successful response will look like the following:

{
    "id": "fmfdj6yqly31huorjqzq38zc",
    "address": "0xf9f284C7Eaf97b0f9B5542d83Af7F785D12E803a",
    "chain_type": "ethereum",
    "policy_ids": [],
    "owner_id": null,
    "additional_signers": [],
    "created_at": 1733923425155
}

Embedded wallets

Using embedded wallets

Funding

Gas and asset management

Server sessions

Global wallets

Advanced Topics

Usage

Parameters

Returns

Usage

Parameters

Returns

Body

Response

Example

Embedded wallets

Using embedded wallets

Funding

Gas and asset management

Server sessions

Global wallets

Advanced Topics

​Usage

​Parameters

​Returns

​Usage

​Parameters

​Returns

​Body

​Response

​Example

Usage

Parameters

Returns

Usage

Parameters

Returns

Body

Response

Example