Create Node Wallet
Provisions a new custody wallet for an account node or for the platform node, on the chain you select. The platform node can only be targeted with an access token issued on the platform node itself. A node may hold several wallets, including several on the same chain, so this never replaces an existing one. Sub-account nodes cannot hold a wallet (10027).
This call is asynchronous: it answers 202 Accepted with no body and the custody provider creates the wallet afterwards. Meanwhile the node reports status 3 (Creating). The wallet appears on List Node Wallets once it is created; poll that list.
A custody provider must be active on the platform, otherwise the request is refused with 10028 instead of being accepted and failing later.
Required permission: node:create
Request
POST /v2/admin/nodes/{node_id}/wallets
Parameters
| Name | Type | In | Description |
|---|---|---|---|
node_id | string | path | Required. The node to create the wallet for |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Content-Type | Required. application/json |
Body
| Field | Type | Required | Description |
|---|---|---|---|
chain_id | string | Yes | The chain to create the wallet on. The wallet is created on the chain's default network |
label | string | No | A name for the wallet. Can be changed later with Rename Wallet |
Example
curl --request POST \
--url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/wallets' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"chain_id": "6740e0a10000000000000101",
"label": "Safe-Main-Wallet"
}'
Response
202 Accepted with an empty body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | Validation failed (missing chain_id), the chain was not found, or the chain has no default network — see message / details |
| 400 | 10016 | node_id or chain_id is not a valid id |
| 400 | 10001 | Node not found (node domain 2) |
| 400 | 10027 | The node is a sub-account; only account nodes and the platform node hold wallets (node domain 2) |
| 400 | 10028 | No custody provider is active on the platform (node domain 2) |
| 403 | 10005 | The node is outside your part of the hierarchy (node domain 2) |
See Errors for the error format and common codes.