Documentation - Notus API

This endpoint registers a new smart wallet for a user, linking this wallet with your project. You can check if the wallet was already registered by checking the _registeredAt_ value from the _Check Smart Wallet_ endpoint.

Authorization

x-api-key

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

externallyOwnedAccount*string

Public address of the Externally Owned Account (EOA) that will sign the transactions, the owner of the account abstraction wallet.

factory*string

The address of the factory contract that creates the account abstraction wallet contract.

See Factory Compatibility for the supported factory values and their EIP-7702 support.

salt?string

The salt number used to generate this wallet. If none is given the default is zero. Each salt generates a new smart wallet for the same user. The salt can be used for the following purposes:

Generating multiple smart wallets for the same user
You can use this to have different portfolios in different wallets or any other reason
Getting a specific address for the smart wallet
You can create a script that will test multiple salt values until a certain sequence of numbers show up in the smart wallet contract address. This way you can use the salt to make all smart wallet addresses you generate start with the initials of your company. Though you are limited to Hexadecimal digits, so you'll have to use Hexspeak.

eip7702?boolean

Whether you want to deploy using the EIP7702 standard, that lets the EOA set a contract as its own contract code. The default value is False. See Factory Compatibility to check which factories support EIP7702. Salt has no effect and having it is disallowed.

metadata?

Custom metadata for the entity. Key-value pairs with string values. Max 1KB size.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/wallets/register" \  -H "Content-Type: application/json" \  -d '{    "externallyOwnedAccount": "0x133700000000000000000000000000000000c0de",    "factory": "0x0000000000400cdfef5e2714e63d8040b700bc24"  }'

{  "wallet": {    "metadata": {      "key": "value"    },    "walletAddress": "0x6e397ddf51d9f15dbe0414538e7529f51f2e5464",    "externallyOwnedAccount": "0x133700000000000000000000000000000000c0de",    "factory": "0x0000000000400cdfef5e2714e63d8040b700bc24",    "implementation": "0x8e8e658e22b12ada97b402ff0b044d6a325013c7",    "eip7702": false,    "deployed": [      {        "chain": {          "id": 137,          "name": "POLYGON",          "logo": "https://logopolygon.com"        },        "deployed": true      }    ],    "salt": 12345,    "registeredAt": "2025-08-06T16:57:09.249Z",    "lastTransactionAt": "2025-08-06T16:57:09.249Z"  }}

Register Smart Wallet

Authorization

Request Body

Response Body

200application/json

400application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`