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, and removing one revokes only theirs, so 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.

Add a signer

addSigner grants signing access to a user, and returns an AddBusinessAccountSignerResponse with the new shareSetId. Identify the target with a TargetIdentity: a known userId, or an identifier plus identifierType (for example an email, in which case the user is created if they do not exist yet).

import DynamicSDKSwift

let sdk = DynamicSDK.instance()

guard let wallet = sdk.wallets.userWallets.first, let walletId = wallet.id else { return }

let response = try await sdk.businessAccounts.addSigner(
    accountAddress: wallet.address,
    chainName: wallet.chain,
    targetSignerIdentity: TargetIdentity(
        identifier: "teammate@acme.com",
        identifierType: .email
    ),
    businessAccountId: account.id,
    walletId: walletId,
    signerType: .endUser
)

print(response.shareSetId)

String

required

Address of the wallet the caller signs with, from wallet.address.

String

required

Chain of that wallet, from wallet.chain (for example EVM or SOL).

TargetIdentity

required

Who to add. Set userId for a known user, or identifier plus identifierType. For a phone number, also set smsCountryCode; for a social account, set socialProvider.

String?

The account that owns the wallet.

String?

The wallet to add the signer to.

BusinessAccountSignerType?

.endUser for a person, .server for a server signer.

String?

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

identifierType is a BusinessAccountSignerIdentifierType: .email, .phoneNumber, .externalUserId, .socialUsername, .socialAccountId, or .id.

Read the current signers

get returns the account with its signers, so you can show who can sign and get the signerId needed for removal.

let detail = try await sdk.businessAccounts.get(businessAccountId: account.id)

for signer in detail.signers where signer.walletId == walletId {
    print("\(signer.id), type: \(signer.type), user: \(signer.userId ?? "none")")
}

Remove a signer

removeSigner revokes a signer’s access to one wallet, and returns the removed BusinessAccountSigner.

let removed = try await sdk.businessAccounts.removeSigner(
    businessAccountId: account.id,
    walletId: walletId,
    signerId: signerId
)

You cannot remove the last active signer on a wallet, because nobody could then approve transactions. Add another signer, or remove the wallet, first.

Getting Started

Authentication

Wallets

Gasless

Business Accounts

Customizing Our UI

SDK Reference

Add a signer

Read the current signers

Remove a signer

Next steps

Members and roles

Sign transactions

​Add a signer

​Read the current signers

​Remove a signer

​Next steps

Members and roles

Sign transactions

Add a signer

Read the current signers

Remove a signer

Next steps