createWalletNode.js,latest
Go to NPMGenerates a challenge for creating a new user-controlled wallet.
Parameters
input
object
Required
Represents the input parameters for creating multiple wallets.
option 1:
userId
string
Required
Unique system-generated identifier for the user.
accountType
string
An account can be a Smart Contract Account (SCA) or an Externally Owned Account (EOA). To learn more, see the account types guide. If an account type is not specified during the creation of a wallet, it defaults to EOA (Externally Owned Account). Note that Solana doesn't support Smart Contract Account (SCA).
Allowed valuesEOASCA
blockchains
array of strings
Required
The blockchains for which to create wallets.
Allowed valuesARBARB-SEPOLIAAVAXAVAX-FUJIBASEBASE-SEPOLIAETHETH-SEPOLIAEVMEVM-TESTNETMATICMATIC-AMOYNEARNEAR-TESTNETOPOP-SEPOLIASOLSOL-DEVNETUNIUNI-SEPOLIA
metadata
array of objects
Optional list of metadata fields to associate with the corresponding wallet. If count is specified, the amount of items in the array should match the count field.
name
string
Name or description associated with the wallet or walletSet.
refId
string
Reference or description used to identify the object.
idempotencyKey
string
The optional idempotency key. An idempotency key is a unique identifier used to identify and handle duplicate requests in order to ensure idempotent behavior, where multiple identical requests have the same effect as a single request.
We will generate one if you do not provide it.
option 2:
userToken
string
Required
The JSON Web Token (JWT) representing the user.
accountType
string
An account can be a Smart Contract Account (SCA) or an Externally Owned Account (EOA). To learn more, see the account types guide. If an account type is not specified during the creation of a wallet, it defaults to EOA (Externally Owned Account). Note that Solana doesn't support Smart Contract Account (SCA).
Allowed valuesEOASCA
blockchains
array of strings
Required
The blockchains for which to create wallets.
Allowed valuesARBARB-SEPOLIAAVAXAVAX-FUJIBASEBASE-SEPOLIAETHETH-SEPOLIAEVMEVM-TESTNETMATICMATIC-AMOYNEARNEAR-TESTNETOPOP-SEPOLIASOLSOL-DEVNETUNIUNI-SEPOLIA
metadata
array of objects
Optional list of metadata fields to associate with the corresponding wallet. If count is specified, the amount of items in the array should match the count field.
name
string
Name or description associated with the wallet or walletSet.
refId
string
Reference or description used to identify the object.
idempotencyKey
string
The optional idempotency key. An idempotency key is a unique identifier used to identify and handle duplicate requests in order to ensure idempotent behavior, where multiple identical requests have the same effect as a single request.
We will generate one if you do not provide it.
Responses
Example
1const response = await client.createWallet({
2 userToken: 'dummy-user-token',
3 blockchains: ['ETH'],
4})
5console.log(response.data?.challengeId)ResponseChoose an example
1{
2 "data": {
3 "challengeId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5"
4 }
5}Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.
