Skip to main content
POST
Server — import a private key to create a WAAS wallet

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-dyn-server-signing-proof
string

Request proof: a compact ES256 JWS, signed with the server's registered key, binding this request to a single-use nonce from GET /nonces. The JWS header is ServerSignerProofHeader and its payload is ServerSignerProofPayload. Required when the request carries a DYN API token and no JWT, and a server signer with a registered key controls the resource. A proof that is present is always verified.

Maximum string length: 4096
Pattern: ^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$

Path Parameters

environmentId
string
required

ID of the environment

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Import Private Key Request

chain
enum<string>
required
Available options:
EVM,
MIDNIGHT,
SVM,
SUI,
BTC,
TON,
STELLAR,
TEMPO,
ALEO,
TRON
clientKeygenIds
string[]
required

List of client-side key generation identifiers

A base58 string with a max length of 100 characters

Maximum string length: 100
Pattern: ^[1-9A-HJ-NP-Za-km-z]+$
thresholdSignatureScheme
enum<string>
required
Available options:
TWO_OF_TWO,
TWO_OF_THREE,
THREE_OF_FIVE
legacyWalletId
string<uuid>

Optional wallet ID of an existing legacy wallet being migrated

variant
enum<string>

Protocol variant for the wallet. ed25519Standard = non-exportable Ed25519, used for raw-scalar import where the 32-byte input is the signing scalar itself (not an RFC-8032 seed). Omitted/ed25519Exportable = the default seed-based Ed25519. Only meaningful for ed25519 chains (e.g. Solana).

Available options:
ed25519Exportable,
ed25519Standard

Response

Successfully created a room for wallet private key import ceremony. The response is text/event-stream (NOT JSON): clients consume it via EventSource.

The response is of type string.