Business Accounts are in early access. See Business Accounts for the model.
BusinessAccountMemberRole has three values:
Adding someone as a member does not let them sign, and adding a signer does not grant admin rights. When a signer becomes active, they are added as a
.viewer member if they are not already a member.Who can call what
Every method acts on behalf of the signed-in user. Reads require membership, and modifications such as adding members or signers, linking wallets, and transferring ownership require the owner or admin role. A call made without the required role fails, so checkdetail.members for the caller’s role before you show those actions in your UI.
Add a member
addMember adds a member as .admin or .viewer (it defaults to .viewer). Identify them with a known userId, or with an identifier plus identifierType, in which case the user is created if they do not exist yet.
How to read
identifier: .email, .phoneNumber, .externalUserId, .socialUsername, .socialAccountId, or .id.List members
get returns the account with its members, including each member’s role.
Change a member’s role
updateMemberRole moves a member between .admin and .viewer. To change who the owner is, transfer ownership instead.
Remove a member
Transfer ownership
transferOwnership promotes an existing member to owner and demotes the current owner to .admin in the same operation. Owner only.
Custom roles
A business account can also define custom roles that inheritadmin or viewer, such as cfo or treasurer. Custom roles are defined, assigned, and deleted by name with the JavaScript SDK; BusinessAccountMemberRole here takes only the built-in values. A member holding a custom role reports its inherited built-in role, and a quorum policy can name a custom role as an approver (see Quorum policies).
Next steps
Manage signers
Grant and revoke signing access per wallet.
Sign transactions
Sign with a business-account wallet.