Backend Wallets

Import private key (E2E encrypted).

Changed on

Import private key with E2E encryption via backend wallet.

Imports a private key into the backend wallet system. The private key must be encrypted using RSA-4096 OAEP SHA-256 with the server's static import public key (obtain out-of-band from SDK or documentation).

post/v2/accounts/backend/import

Request

  • Base URL: https://api.openfort.io
  • URL: https://api.openfort.io/v2/accounts/backend/import
  • Auth: HTTP bearer

Request body

encryptedPrivateKeystring required

The private key encrypted with RSA-OAEP SHA-256 using the server's static import public key. Obtain the server's import public key out-of-band (e.g., from SDK or documentation).

chainType'EVM' | 'SVM'

The chain type for the imported wallet.

walletstring

The wallet ID to associate with this wallet (starts with pla_).

Example request

{
  "encryptedPrivateKey": "base64_encrypted_data...",
  "chainType": "EVM",
  "wallet": "pla_e0b84653-1741-4a3d-9e91-2b0fd2942f60"
}

Response

Successful response.

object'account' required

The type of object.

idstring required

The created account ID (starts with acc_).

addressstring required

The wallet address derived from the imported private key.

walletIdstring required

The wallet ID

chainType'EVM' | 'SVM'

The chain type the wallet is associated with.

createdAtinteger required

Creation timestamp (Unix epoch seconds).

Example response

{
  "id": "acc_e0b84653-1741-4a3d-9e91-2b0fd2942f60",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "walletId": "pla_6f6c9067-89fa-4fc8-ac72-c242a268c584",
  "chainType": "EVM"
}

Changes