Sign in

v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Create Delegated Signer

Create a delegated signer for a smart wallet with optional restrictions around permissions and expiry date.

API scope required: wallets.create

post/2025-06-09/wallets/{walletLocator}/signers

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>

Headers

X-API-KEYstring required

API key required for authentication

Request body

OR
OR

Example request

{
  "signer": {
    "type": "passkey",
    "id": "cWtP7gmZbd98HbKUuGXx5Q",
    "name": "hgranger",
    "publicKey": {
      "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
      "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
    }
  },
  "scopes": [
    {
      "type": "transfer",
      "tokenLocator": "stellar:usdc",
      "recipients": [
        "GDUCX62IF76FFIYRNI25LJDS2V43QEZDY4YNF2DJWVIASN5LKX76Q4TW"
      ],
      "spendingLimit": {
        "amount": "100",
        "interval": 86400
      }
    }
  ]
}

Response

The delegated signer has been successfully created.

OR
OR

Example response

{
  "type": "passkey",
  "id": "cWtP7gmZbd98HbKUuGXx5Q",
  "name": "hgranger",
  "publicKey": {
    "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
    "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
  },
  "validatorContractVersion": "0.2.0",
  "locator": "passkey:cWtP7gmZbd98HbKUuGXx5Q"
}