> ## Documentation Index > Fetch the complete documentation index at: https://crossmint-wallets-docs-2-5.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Register Delegated Signer > Register a delegated key for a smart wallet with optional restrictions around permissions and expiry date. **API scope required**: `wallets.create` ## OpenAPI ````yaml post /2022-06-09/wallets/{walletLocator}/signers openapi: 3.0.0 info: title: Crossmint Wallets API description: Crossmint Wallets API version: 1.0.0 contact: name: Crossmint Support url: https://www.crossmint.com email: support@crossmint.com servers: - url: https://staging.crossmint.com/api description: Staging environment (testnets) - url: https://www.crossmint.com/api description: Production environment (mainnets) security: [] tags: [] paths: /2022-06-09/wallets/{walletLocator}/signers: post: summary: Register Delegated Signer description: >- Register a delegated key for a smart wallet with optional restrictions around permissions and expiry date. **API scope required**: `wallets.create` operationId: WalletsV1Controller-createDelegatedSigner-4 parameters: - name: X-API-KEY in: header description: API key required for authentication required: true schema: type: string - name: walletLocator required: true in: path description: |- A wallet locator can be of the format: - `` - `email::` - `userId::` - `userId::` (white label user example) - `phoneNumber::` - `twitter::` - `x::` example: - '0x1234567890123456789012345678901234567890' - email:user@example.com:evm-smart-wallet - userId:507f1f77bcf86cd799439011:solana-mpc-wallet - userId:did:example:cm4lr5piw0h6t1bjho0onryql:evm-smart-wallet - phoneNumber:+12125551234:evm-smart-wallet - twitter:johndoe:evm-smart-wallet - x:@johndoe:evm-smart-wallet schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateSignerInputDto' responses: '201': description: The delegated signer has been successfully added to the wallet. content: application/json: schema: $ref: '#/components/schemas/DelegatedSignerDto' '400': description: >- Returns an error if a delegated signer with specified configuration already exists content: application/json: schema: $ref: '#/components/schemas/WalletV1Alpha2ErrorDTO' '404': description: Returns an error if a wallet with the specified locator not found content: application/json: schema: $ref: '#/components/schemas/WalletV1Alpha2ErrorDTO' components: schemas: CreateSignerInputDto: oneOf: - type: object properties: signer: oneOf: - type: string - type: object properties: type: type: string enum: - evm-passkey description: Identifier for the Passkey signer type id: type: string description: Credential ID from the WebAuthn registration response name: type: string description: Human-readable name for the passkey publicKey: type: object properties: x: type: string description: X coordinate of the public key as a decimal string 'y': type: string description: Y coordinate of the public key as a decimal string required: - x - 'y' description: The public key coordinates from the WebAuthn credential required: - type - id - name - publicKey description: >- Configuration for a WebAuthn/Passkey signer that uses public key credentials for authentication title: Passkey example: type: evm-passkey id: cWtP7gmZbd98HbKUuGXx5Q name: hgranger publicKey: x: >- 38035223810536273945556366218149112558607829411547667975304293530457502824247 'y': >- 91117823763706733837104303008228095481082989039135234750508288790583476078729 description: The locator of the delegated signer chain: enum: - base - polygon - optimism - arbitrum - mode - story - bsc - shape - ethereum-sepolia - base-sepolia - polygon-amoy - optimism-sepolia - arbitrum-sepolia - mode-sepolia - story-testnet description: The chain where the signer will be registered expiresAt: type: number description: The expiry date of the signer in milliseconds since UNIX epoch permissions: type: array items: discriminator: propertyName: type oneOf: - type: object properties: type: type: string enum: - native-token-transfer data: type: object properties: allowance: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' required: - allowance required: - type - data title: Native Token Transfer description: Permission to transfer native tokens (e.g. ETH) example: type: native-token-transfer data: allowance: '0x1234' - type: object properties: type: type: string enum: - erc20-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with allowance: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' required: - address - allowance required: - type - data title: ERC20 Transfer description: Permission to transfer specific ERC20 tokens example: type: erc20-token-transfer data: address: '0x1234567890123456789012345678901234567890' allowance: '100' - type: object properties: type: type: string enum: - erc721-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with tokenIds: type: array items: type: string description: The token IDs that can be transferred required: - address - tokenIds required: - type - data title: ERC721 Transfer description: Permission to transfer specific ERC721 tokens (NFTs) example: type: erc721-token-transfer data: address: '0x1234567890123456789012345678901234567890' tokenIds: - '0x1' - '0x2' - type: object properties: type: type: string enum: - erc1155-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with allowances: type: object additionalProperties: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' description: >- The token IDs and allowances that can be transferred required: - address - allowances required: - type - data title: ERC1155 Transfer description: >- Permission to transfer specific ERC1155 tokens (Multi-tokens) example: type: erc1155-token-transfer data: address: '0x1234567890123456789012345678901234567890' allowances: '1': '0x5' '2': '0xa' - type: object properties: type: type: string enum: - gas-limit data: type: object properties: limit: type: string enforcePaymaster: type: boolean allowedPaymaster: type: string required: - limit required: - type - data title: Gas Limit description: >- Permission to use a limited amount of gas across all operations example: type: gas-limit data: limit: '0x1234' enforcePaymaster: true allowedPaymaster: '0x1234567890123456789012345678901234567890' - type: object properties: type: type: string enum: - call-limit data: type: object properties: count: type: integer minimum: 1 required: - count required: - type - data title: Transaction Count Limit description: >- Permission to make a limited number of transaction calls in total example: type: call-limit data: count: 5 - type: object properties: type: type: string enum: - rate-limit data: type: object properties: count: type: integer minimum: 1 interval: type: integer minimum: 1 description: Time window in seconds required: - count - interval required: - type - data title: Rate Limit description: >- Permission to make calls at a limited rate within time intervals example: type: rate-limit data: count: 5 interval: 3600 description: The permissions of the signer following ERC-7715 required: - signer - chain description: Parameters for creating a EVM delegated signer title: EVM example: signer: '0x1234567890123456789012345678901234567890' chain: base - type: object properties: signer: type: string title: Signer Locator description: >- A signer locator that can be either a of format '' for keypair type signers or ':' example: - evm-keypair:0x1234567890123456789012345678901234567890 - evm-passkey:credential-id-123 - >- evm-fireblocks-custodial:0x1234567890123456789012345678901234567890 - solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ - >- solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ required: - signer description: Parameters for creating a Solana delegated signer title: Solana example: signer: GbA2NZfpAnRVM2G2BG29qooqsYbdV5c2WVFymJ8MMir7 DelegatedSignerDto: oneOf: - type: object properties: type: type: string enum: - evm-keypair - evm-fireblocks-custodial - evm-passkey description: >- Specifies the type of EVM signer being used, describing the method of key management and transaction signing. `evm-keypair` indicates a signer using a locally managed keypair, suitable for non-custodial wallets. `evm-fireblocks-custodial` refers to a signer managed by Fireblocks, a custodial service provider. locator: type: string title: Signer Locator description: The locator of the signer example: - evm-keypair:0x1234567890123456789012345678901234567890 - evm-passkey:credential-id-123 - >- evm-fireblocks-custodial:0x1234567890123456789012345678901234567890 - solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ - >- solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ expiresAt: type: number description: The expiry date of the signer in ISO 8601 format example: '2024-01-01T00:00:00.000Z' permissions: type: array items: discriminator: propertyName: type oneOf: - type: object properties: type: type: string enum: - native-token-transfer data: type: object properties: allowance: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' required: - allowance required: - type - data title: Native Token Transfer description: Permission to transfer native tokens (e.g. ETH) example: type: native-token-transfer data: allowance: '0x1234' - type: object properties: type: type: string enum: - erc20-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with allowance: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' required: - address - allowance required: - type - data title: ERC20 Transfer description: Permission to transfer specific ERC20 tokens example: type: erc20-token-transfer data: address: '0x1234567890123456789012345678901234567890' allowance: '100' - type: object properties: type: type: string enum: - erc721-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with tokenIds: type: array items: type: string description: The token IDs that can be transferred required: - address - tokenIds required: - type - data title: ERC721 Transfer description: Permission to transfer specific ERC721 tokens (NFTs) example: type: erc721-token-transfer data: address: '0x1234567890123456789012345678901234567890' tokenIds: - '0x1' - '0x2' - type: object properties: type: type: string enum: - erc1155-token-transfer data: type: object properties: address: type: string description: >- The address of the smart contract that can be interacted with allowances: type: object additionalProperties: oneOf: - type: string title: Hex String description: The allowance for the permission. e.g. '0x1' - type: string pattern: ^\d+$ title: Decimal String description: The allowance for the permission. e.g. '1' description: >- The token IDs and allowances that can be transferred required: - address - allowances required: - type - data title: ERC1155 Transfer description: >- Permission to transfer specific ERC1155 tokens (Multi-tokens) example: type: erc1155-token-transfer data: address: '0x1234567890123456789012345678901234567890' allowances: '1': '0x5' '2': '0xa' - type: object properties: type: type: string enum: - gas-limit data: type: object properties: limit: type: string enforcePaymaster: type: boolean allowedPaymaster: type: string required: - limit required: - type - data title: Gas Limit description: >- Permission to use a limited amount of gas across all operations example: type: gas-limit data: limit: '0x1234' enforcePaymaster: true allowedPaymaster: '0x1234567890123456789012345678901234567890' - type: object properties: type: type: string enum: - call-limit data: type: object properties: count: type: integer minimum: 1 required: - count required: - type - data title: Transaction Count Limit description: >- Permission to make a limited number of transaction calls in total example: type: call-limit data: count: 5 - type: object properties: type: type: string enum: - rate-limit data: type: object properties: count: type: integer minimum: 1 interval: type: integer minimum: 1 description: Time window in seconds required: - count - interval required: - type - data title: Rate Limit description: >- Permission to make calls at a limited rate within time intervals example: type: rate-limit data: count: 5 interval: 3600 description: The permissions of the signer following ERC-7715 chains: type: object additionalProperties: oneOf: - type: object properties: status: type: string enum: - success required: - status title: Delegated Signer Approved description: Delegated signer that has been approved for this chain - type: object properties: status: type: string enum: - pending - awaiting-approval - failed id: type: string description: Unique identifier for the signature approvals: type: object properties: pending: type: array items: type: object properties: signer: type: string description: >- The locator of the signer that's pending approval message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: type: number description: When the signature was submitted example: '2024-01-01T00:00:00.000Z' signer: type: string title: Signer Locator description: >- The locator of the signer who submitted this signature example: - >- evm-keypair:0x1234567890123456789012345678901234567890 - evm-passkey:credential-id-123 - >- evm-fireblocks-custodial:0x1234567890123456789012345678901234567890 - >- solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ - >- solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ message: type: string description: The message that was signed metadata: type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string description: >- Additional metadata about the signature submission required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: type: number description: Number of required approvals for the transaction required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures required: - status - id title: Delegated Signer Awaiting Approval description: Delegated signer that is awaiting approval for this chain description: >- Authorization status for each chain where the chain name is the key and the signature request is the value required: - type - locator title: Delegated Signer Response description: >- Complete delegated signer response including the signer and authorizations for each chain example: type: evm-keypair locator: evm-keypair:0x1234567890123456789012345678901234567890 chains: polygon: status: active base: id: b984491a-5785-43c0-8811-45d46fe6e520 status: awaiting-approval approvals: pending: [] submitted: - signer: evm-keypair:0x1234567890123456789012345678901234567890 message: >- 0x1234567890123456789012345678901234567890123456789012345678901234 signature: >- 0x1234567890123456789012345678901234567890123456789012345678901234 submittedAt: '2024-01-01T00:00:00.000Z' - type: object properties: type: type: string enum: - solana-keypair - solana-fireblocks-custodial description: >- Specifies the type of Solana signer being used, describing the method of key management and transaction signing. locator: type: string title: Signer Locator description: The locator of the signer example: - evm-keypair:0x1234567890123456789012345678901234567890 - evm-passkey:credential-id-123 - >- evm-fireblocks-custodial:0x1234567890123456789012345678901234567890 - solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ - >- solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ transaction: type: object properties: onChain: type: object properties: transaction: type: string lastValidBlockHeight: type: number txId: type: string required: - transaction description: >- Solana smart wallet transaction data including input parameters and chain specific details id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: type: string description: The locator of the signer that's pending approval message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: type: number description: When the signature was submitted example: '2024-01-01T00:00:00.000Z' signer: type: string title: Signer Locator description: >- The locator of the signer who submitted this signature example: - >- evm-keypair:0x1234567890123456789012345678901234567890 - evm-passkey:credential-id-123 - >- evm-fireblocks-custodial:0x1234567890123456789012345678901234567890 - >- solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ - >- solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ message: type: string description: The message that was signed metadata: type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string description: Additional metadata about the signature submission required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: type: number description: Number of required approvals for the transaction required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: type: number description: ISO timestamp when the transaction was created example: '2024-01-01T00:00:00.000Z' completedAt: type: number description: ISO timestamp when the transaction reached finality example: '2024-01-01T00:00:00.000Z' error: oneOf: - type: object properties: reason: type: string enum: - build_failed - failed_to_land_on_chain - unknown - sanctioned_wallet_address message: type: string required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revert: type: object properties: type: type: string enum: - contract_call - wallet_authorization - wallet_deployment reason: type: string reasonData: type: string explorerLink: type: string simulationLink: type: string required: - type - reason required: - reason - message description: Error message if the transaction fails after submission sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: type: string description: The amount of the token to send recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params required: - onChain - id - status - createdAt description: The transaction for the signer required: - type - locator - transaction title: Delegated Signer Response description: >- Complete delegated signer response including the signer and authorization transaction example: type: solana-keypair locator: solana-keypair:DzaYNi6XtWt9DNwFV61bzWEiaSxfTgWbFDgFmurJzwdo transaction: onChain: transaction: >- 4B9yzZoEV45cngasy9dP2MVxhZ2iro72eqdKitTj62pqFYHk4wVoR4NCc3xkEamWbFGXLjVotyPrDqEn11WUYHoq98b5aKCSDUrLWaQDZgb3xLxF1EvaY82Vui7Ntbv682tYnu5Ngnv4Eun1wrDJ6r4aRsUSQ3XF3jvNq8bRMn4HavBjPyErQSgXX9ytCDKntCEQcY3wfMHYbRFg5zgFU1QCqhuoLa5oBpZLCUYT8DCYu3Ado7W4xzP5aCAAwVd2tj8iAnwJEujQvBnr7wWkf2mCS1cNoCTbCFAvNVaVaau6vXBWKZqS7sDNmUD3KLQVqLwxhLLNeRuvUTkD5VQ5D21VcDiYWQWQTuYYAcQ3RUhn4Vt4ymijgRGbUXZHoeN26UHoGSBFJJ7gjqCruAtFXQZxHRDKSWN9jhYXugPYVVXSpGFA5BYWBuztUtEMF4u96tk6YTgPGdkTgrQybkNxRwbVCbpsKRG1kAbjQgBxDLAX89eMCZVbzWXnAgGA6aDBQPLAyQru8awZBDasrirnxCSQq9cWwMLePQGhY5gJZykswFKtyYF4CHeto lastValidBlockHeight: 343486121 id: 30ef7527-eb5a-4862-92de-aa96947ee705 status: pending approvals: required: 1 pending: - signer: >- solana-keypair:GsMTPi8utYnuWakS8uvPah3UKd13dWcAshirnNmXDr3d message: >- 2kwN1iuY6Y6Br2i5D1QphaS28H7vDdAiwtABgtRdYqjx7s85rRwqF9y6iVBdv9dDZ8F1JAZo8iQdFBAx2Eg9tL3P4sbAznPZgkZcGrbUSCe5jTZ7ULZrcSd377SGEjsZcwx7h7ozrUKB6FnjHB7wGaCqEeeUXE2CfCjC1SjEc8ZzZeyNmeEv5hJSkGsK62syoAE4V5ScZs7idhxXWzpeJiRt3wfWJRevr1pJY7BBd8HaEYurXtXqwCox1uzQnnuZTiUNu7cUWUajYXBWUae4NJGJxmtFJvqnPAa5HXB4nZWXMDdcBis4tQkLCfFT6GXMauQTFCaKmcMgLRh218n51nTNopR7gTaY66ysRH536wmxt9dLqkS9okG3HF5GEXufXPLX6iT7e7 submitted: [] createdAt: '2025-01-20T13:49:08.910Z' WalletV1Alpha2ErrorDTO: type: object properties: error: type: boolean enum: - true message: type: string description: Error message example: required: - error - message description: Wallet error ````