Remove a Signer from a Wallet

Remove a signer from an existing Crossmint wallet.

Use removeSigner() to remove a signer from an existing wallet. This revokes the signer’s ability to perform day-to-day operations on behalf of the wallet. The wallet’s recovery signer must approve the operation — the SDK handles this automatically.

For an overview of available signer types, see Wallet Signers.

Prerequisites

• An existing wallet with at least one signer registered
• API key with wallets:signatures.create and wallets:transactions.create scopes

Remove a Signer

React

import { useWallet } from "@crossmint/client-sdk-react-ui";

const { wallet } = useWallet();

const result = await wallet.removeSigner({
    type: "external-wallet",
    address: "0x1234...abcd",
});

console.log("Signer removed:", result);

Node.js

import {
    createCrossmint,
    CrossmintWallets,
} from "@crossmint/wallets-sdk";

const crossmint = createCrossmint({
    apiKey: "YOUR_SERVER_API_KEY",
});
const crossmintWallets = CrossmintWallets.from(crossmint);

const wallet = await crossmintWallets.getWallet(
    "<wallet-address>",
    {
        chain: "base-sepolia",
        signer: {
            type: "server",
            secret: process.env.CROSSMINT_SIGNER_SECRET,
        },
    }
);

const result = await wallet.removeSigner({
    type: "external-wallet",
    address: "0x1234...abcd",
});

console.log("Signer removed:", result);

Flutter

import 'package:crossmint_flutter/crossmint_flutter_ui.dart';

final controller = CrossmintWalletContext.of(context).requireWalletController;
// Returns a runtime handle to the wallet already loaded by the controller —
// no server-side create happens here.
final wallet = controller.createEvmWallet();

await wallet.removeSigner('external-wallet:0x1234...abcd');

removeSigner takes the signer locator string directly. The SDK approves the removal via the wallet’s recovery signer.

REST

When using the REST API, removing signers must be approved by the wallet’s recovery signer. You must approve the transaction to complete the removal.

1. Remove the signer

   Call the remove signer endpoint.

   cURL

   curl --request DELETE \
       --url 'https://staging.crossmint.com/api/2025-06-09/wallets/email:[e-mail]:evm/signers/external-wallet:0x1234567890123456789012345678901234567890?chain=base-sepolia' \
       --header 'X-API-KEY: <x-api-key>'
   

   See the API reference for more details.

2. Sign the approval returned in the response

   Sign the approval message field returned in the response inside transaction.approvals using the recovery signer (admin signer).

3. Approve the transaction to complete the removal

   Call the approve transaction endpoint using the signature from the previous step and the transaction id returned in the call from Step 1.

   cURL

   curl --request POST \
       --url https://staging.crossmint.com/api/2025-06-09/wallets/email:[e-mail]:evm/transactions/b984491a-5785-43c0-8811-45d46fe6e520/approvals \
       --header 'Content-Type: application/json' \
       --header 'X-API-KEY: <x-api-key>' \
       --data '{
           "approvals": [{
               "signer": "email:[e-mail]",
               "signature": "0x1234567890abcdef..."
           }]
       }'
   

   See the API reference for more details.

Next Steps

List Signers

View all signers registered on your wallet

Configure Recovery

Set up recovery signers for your wallets

Transfer Tokens

Send tokens from your wallet