Manage Signers

Business Accounts are in early access. See the overview for the model.

A signer can approve transactions and messages with a specific wallet. Signing access is separate from membership roles. Adding a signer grants them access; removing one only revokes theirs — the wallet and other signers stay intact.

Only an owner or admin can add signers, and the caller must already be an active signer on that wallet. This operation requires step-up authentication.

Add a signer

addBusinessAccountSigner grants signing access to a user and returns a shareSetId. Identify them by a known userId, or by an identifier + identifierType (for example an email — the user is created if they don’t exist yet).

JavaScript
React

import { addBusinessAccountSigner } from '@dynamic-labs-sdk/client/waas';

const { shareSetId } = await addBusinessAccountSigner({
  businessAccountId: account.id,
  walletAccount,                 // a WalletAccount the caller can sign with
  signerType: 'endUser',
  targetIdentity: { identifier: 'teammate@acme.com', identifierType: 'email' },
});

import { useAddBusinessAccountSigner } from '@dynamic-labs-sdk/react-hooks';

const AddSigner = ({ walletAccount, businessAccountId }) => {
  const { mutate, isPending } = useAddBusinessAccountSigner();
  return (
    <button
      disabled={isPending}
      onClick={() =>
        mutate({
          businessAccountId,
          walletAccount,
          signerType: 'endUser',
          targetIdentity: { userId: 'user-123' },
        })
      }
    >
      Add signer
    </button>
  );
};

WalletAccount

required

The wallet to add a signer to, from the caller’s getWalletAccounts().

{ userId } | { identifier, identifierType }

required

Who to add — a known userId, or an identifier (e.g. email) plus its identifierType.

'endUser' | 'server'

Whether the new signer is an end user or a server signer.

string

Passphrase for the target’s key share, when your environment encrypts shares.

Remove a signer

removeBusinessAccountSigner revokes a signer’s access to a wallet. The wallet and every other signer are untouched.

JavaScript
React

import { removeBusinessAccountSigner } from '@dynamic-labs-sdk/client/waas';

await removeBusinessAccountSigner({
  businessAccountId: account.id,
  walletId,
  signerId,
});

import { useRemoveBusinessAccountSigner } from '@dynamic-labs-sdk/react-hooks';

const { mutate } = useRemoveBusinessAccountSigner();
mutate({ businessAccountId, walletId, signerId });

You can’t remove the last active signer on a wallet — otherwise no one could approve transactions. Add another signer, or remove the wallet, first.

Installation & Configuration

Chains & Networks

Authenticate

User & Session Management

Business Accounts

Wallets

Flow

Swaps

Funding & Onramp

Events

Building UI

Migrating from React

Extension Development

Add a signer

Remove a signer

Next steps

Members & roles

Sign transactions

​Add a signer

​Remove a signer

​Next steps

Members & roles

Sign transactions

Add a signer

Remove a signer

Next steps