Import a wallet with APIs

Assumption that user is signed in with Wallaby. For more information about signing in, check out

API Reference

The returned message will be used for sign up and sign in signature

post

Authorizations

Body

clientAuthPubKeystringRequired

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v1/auth/signature-message HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "clientAuthPubKey": "text"
}

200

Message retrieved successfully

{
  "message": "text"
}

Import an existing wallet seed phrase into wallaby system directly

post

Authorizations

api-key-authjwt-access-token

Body

messagestringRequired

Message retrieved from the backend

Example: 717ea458b62a430cb37ced7c22ebec97

clientAuthPubKeystringRequiredExample: e3421d7f9d6888ea83bef6b28ce0a2ab6eb6fe8a8fbfa3743240992590816b08f9a62edcc63296d056c552054d583fec36d23ef11dffb24c95aaf4a47d50dccc

signaturestringRequired

Signature generated after signing the provided data field

Example: 0xb44e88ff3c67de6e6548a6caf006bf6e1cb841119d0b9ea1b7e9b2d36a5e0ed42fd9f5e543243d1d73dc4b7800cc2026f74961f4edc769699678a316abb34e661c

encryptedSeedall ofRequired

Seed encrypted asymmetrically by current user corresponding wallaby auth public key, to be decrypted inside the secure code execution environment

Example: {"iv":"b7b643ebccf35c262aa2d5c2729c5f3d","ephemPublicKey":"040cff71ed16f1105c45c2214c9e72d3eabde48efe3759c6f150352b19aa8054c302dc1fd8b4f3927bd7d74ae0186854b3a13de7673be4f8424a6ba3702c239729","ciphertext":"736bc1881a02fa08df4a3f1e35d426660e3c35471facba2866e960f8a19b783bac30d037b07dc9e6406e258d09a4a7e4a7cf58d20cf7b8b7201db0f80849a48d20389039e3fc196f42796fe6d501f47afb030f9946ecbc148d8da1e46c3793a4","mac":"b6cbbdbbc3a311d919340fc3ec9ee1911d9ead6d989efa73e0ac3303c51a353e"}

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v1/wallets/import-seed-phrase HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 850

{
  "message": "717ea458b62a430cb37ced7c22ebec97",
  "clientAuthPubKey": "e3421d7f9d6888ea83bef6b28ce0a2ab6eb6fe8a8fbfa3743240992590816b08f9a62edcc63296d056c552054d583fec36d23ef11dffb24c95aaf4a47d50dccc",
  "signature": "0xb44e88ff3c67de6e6548a6caf006bf6e1cb841119d0b9ea1b7e9b2d36a5e0ed42fd9f5e543243d1d73dc4b7800cc2026f74961f4edc769699678a316abb34e661c",
  "encryptedSeed": "{\"iv\":\"b7b643ebccf35c262aa2d5c2729c5f3d\",\"ephemPublicKey\":\"040cff71ed16f1105c45c2214c9e72d3eabde48efe3759c6f150352b19aa8054c302dc1fd8b4f3927bd7d74ae0186854b3a13de7673be4f8424a6ba3702c239729\",\"ciphertext\":\"736bc1881a02fa08df4a3f1e35d426660e3c35471facba2866e960f8a19b783bac30d037b07dc9e6406e258d09a4a7e4a7cf58d20cf7b8b7201db0f80849a48d20389039e3fc196f42796fe6d501f47afb030f9946ecbc148d8da1e46c3793a4\",\"mac\":\"b6cbbdbbc3a311d919340fc3ec9ee1911d9ead6d989efa73e0ac3303c51a353e\"}"
}

200

The mnemonic seed phrase has been imported and wallet created successfully

{
  "wallabyAuthPubKey": "0xb3a4611225c37c6f1cb5414532c87be388f512c00cbcec6cfc5a4c283742796d",
  "assets": [
    {
      "userId": "text",
      "merchantId": "text",
      "chainId": "text",
      "userAssetAddress": "text",
      "walletId": "text",
      "configId": "text",
      "assetName": "text",
      "assetSymbol": "text",
      "balance": "text",
      "balanceUpdatedAt": {},
      "defaultAddress": "text",
      "isVisible": true,
      "source": "merchant",
      "addresses": [
        "text"
      ],
      "ownershipType": "text",
      "config": {
        "chainId": "text",
        "merchantId": "text",
        "chainName": "text",
        "name": "ALGORAND",
        "symbol": "ALGO",
        "verified": true,
        "isOffChain": true,
        "type": "COIN",
        "tokenStandard": "ERC_20",
        "assetIndex": 1,
        "description": "text",
        "ownershipType": "text",
        "multisigVersion": 1,
        "multisigSignerThreshold": 1,
        "status": "active",
        "createdByUserId": "text",
        "createdByMerchantId": "text",
        "chain": {
          "id": "6e464058-67c1-4273-a6a4-8aae522e34be",
          "name": "ALGORAND",
          "derivationPath": "m/84'/0'/0'/0/0",
          "addressRegex": "/^0x[a-fA-F0-9]{40}$/",
          "slip44": 1,
          "status": "UP",
          "indexUrl": "text",
          "chainId": 1
        },
        "createdByMerchant": {
          "name": "Republic",
          "nameSlugify": "republic",
          "verified": true,
          "contactEmail": "[email protected]",
          "contactPhoneNumber": "text",
          "usersCount": 1,
          "assetsCount": 1,
          "tokensCount": 1,
          "coinsCount": 1,
          "walletsCount": 1,
          "status": "active",
          "createdAt": "2025-04-24T06:39:50.566Z",
          "updatedAt": "2025-04-24T06:39:50.566Z",
          "createdAssets": [
            []
          ]
        },
        "createdByUser": {
          "id": "text",
          "externalUserId": "6e464058-67c1-4273-a6a4-8aae522e34be",
          "merchantId": "6e464058-67c1-4273-a6a4-8aae522e34be",
          "role": "republic_admin",
          "firstName": "Bryan",
          "walletsCount": 2,
          "latestWallabyAuthPubKey": "4ecb720b1392468c75803d6252ac987c113206955070b96df1208c1c480338168e1407cec4b5af2f91d12af9b725cbd85af994b29c6364971a7ef8d955be83dc",
          "latestWallabyAuthPubKeyVersion": "1",
          "hasFullPermissions": true
        }
      }
    }
  ],
  "encryptedSeed": "{\"iv\":\"b7b643ebccf35c262aa2d5c2729c5f3d\",\"ephemPublicKey\":\"040cff71ed16f1105c45c2214c9e72d3eabde48efe3759c6f150352b19aa8054c302dc1fd8b4f3927bd7d74ae0186854b3a13de7673be4f8424a6ba3702c239729\",\"ciphertext\":\"736bc1881a02fa08df4a3f1e35d426660e3c35471facba2866e960f8a19b783bac30d037b07dc9e6406e258d09a4a7e4a7cf58d20cf7b8b7201db0f80849a48d20389039e3fc196f42796fe6d501f47afb030f9946ecbc148d8da1e46c3793a4\",\"mac\":\"b6cbbdbbc3a311d919340fc3ec9ee1911d9ead6d989efa73e0ac3303c51a353e\"}",
  "wallet": {
    "id": "73d642c9-6762-421b-8f7b-5393cb220791",
    "userId": "a4dedb83-4d59-41ca-84b5-4b24a98878d8",
    "revisionName": "v1"
  }
}