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).

using System.Linq;
using DynamicSDK.Models.BusinessAccounts;
using UnityEngine;

var wallet = DynamicSDK.Instance.Wallets.UserWallets.FirstOrDefault();
if (wallet == null) return;

var response = await DynamicSDK.Instance.BusinessAccounts.AddSigner(
    accountAddress: wallet.Address,
    chainName: wallet.Chain,
    targetSignerIdentity: new TargetIdentity
    {
        Identifier = "teammate@acme.com",
        IdentifierType = BusinessAccountSignerIdentifierType.Email
    },
    businessAccountId: account.Id,
    walletId: wallet.Id,
    signerType: BusinessAccountSignerType.EndUser);

Debug.Log(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 signer ID needed for removal.

var detail = await DynamicSDK.Instance.BusinessAccounts.Get(account.Id);

foreach (var signer in detail.Signers.Where(s => s.WalletId == wallet.Id))
{
    Debug.Log($"{signer.Id}, type: {signer.Type}, user: {signer.UserId}");
}

Remove a signer

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

var removed = await DynamicSDK.Instance.BusinessAccounts.RemoveSigner(
    account.Id, wallet.Id, 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

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