Add Roles

Use wallet.roles.add() to prepare a transaction that attaches a new authority and its permitted actions to an existing Swig wallet. Your application signs and submits the transaction. Choose the actions from the Permissions reference, then follow this guide to add the role. General role creation is available in TypeScript 0.10.0 and Python 0.9.0.

Before you begin

You need:

an existing Swig config address
the fee payer public key
an existing Ed25519 or secp256r1 requester authority whose role includes manageAuthority or all
the public authority value for the new role
one or more actions for the new role

The address variables below are base58 strings. signAndSubmit / sign_and_submit represents your application-owned signing, RPC submission, and confirmation helper.

Add a scoped SOL-transfer role

This example gives a new Ed25519 authority permission to transfer up to 1,000,000 lamports through Solana’s System Program.

TypeScript

import { SystemProgram } from '@solana/web3.js';

const wallet = swig.wallets.use(swigConfigAddress, {
  requesterAuthority: {
    ed25519: { publicKey: adminPublicKey },
  },
});

const prepared = await wallet.roles.add({
  feePayer,
  authority: {
    ed25519: { publicKey: newRolePublicKey },
  },
  actions: [
    {
      type: 'program',
      programId: SystemProgram.programId.toBase58(),
    },
    { type: 'solLimit', amount: 1_000_000n },
  ],
});

await signAndSubmit(prepared);

from solders.system_program import ID as SYSTEM_PROGRAM_ID
from swig_developer_sdk import ProgramAction, SolLimitAction

wallet = swig.wallets.use(
    swig_config_address,
    requester_authority={
        "ed25519": {"publicKey": admin_public_key}
    },
)

prepared = await wallet.roles.add(
    fee_payer=fee_payer,
    authority={
        "ed25519": {"publicKey": new_role_public_key}
    },
    actions=(
        ProgramAction(program_id=str(SYSTEM_PROGRAM_ID)),
        SolLimitAction(amount=1_000_000),
    ),
)

await sign_and_submit(prepared)

Both actions belong to the same new role. program permits the System Program invocation, while solLimit provides the role’s remaining one-time SOL budget. Each successful transfer decrements that budget. SignV2 checks program access and SOL spending independently, so the transfer needs both permissions. For other operations, choose the required actions and fields from Permissions.

Choose the new authority

The new role may use any of these authority shapes:

Authority	New-role shape	Typical use
Ed25519	`{ ed25519: { publicKey } }`	Solana keypair or custody signer
secp256r1	`{ secp256r1: { publicKey } }`	Passkey-backed signer
secp256k1	`{ secp256k1: { publicKey } }`	EVM-compatible signer
ParticipantSet	`{ participantSet: { address } }`	M-of-N threshold authorization

For a ParticipantSet role, create the set first and pass its address without a role ID. Adding the authority creates a new role whose ID is assigned by Swig. Continue to Participant Sets for member approval collection and compilation.

The authority being added may use any supported shape above. The existing authority requesting the add-role operation must use Ed25519 or secp256r1.

Confirm the role

The add-role call returns a prepared transaction; it does not broadcast or confirm it. After your signing helper submits the transaction and it lands, read the wallet roles to confirm the new authority and actions.

TypeScript

const { roles } = await wallet.roles.list();
console.log(roles);

Wait for the add-role transaction to confirm before using the new authority. Keep every private key, passkey assertion, and authorization decision in your application-owned signing layer.

Request boundaries

Supply at least one action.
Use an existing Ed25519 or secp256r1 authority as the requester.
Pass a ParticipantSet address without a role ID when adding it as the new authority.
Add the transaction-level signatures required by the serialized transaction before submission.

Participant Sets

Add M-of-N threshold authorization to a role

Transfer SOL and Tokens

Use a configured role for wallet transfers

Permissions

Look up available actions, fields, and units

Sponsor & Submit

Submit application-signed transactions

Start Here

Wallet Access

Build Wallet Flows

Use Cases

Balances and Funding

Operate in Production

Workspace Admin

Before you begin

Add a scoped SOL-transfer role

Choose the new authority

Confirm the role

Request boundaries

What to read next

Participant Sets

Transfer SOL and Tokens

Permissions

Sponsor & Submit

​Before you begin

​Add a scoped SOL-transfer role

​Choose the new authority

​Confirm the role

​Request boundaries

​What to read next

Participant Sets

Transfer SOL and Tokens

Permissions

Sponsor & Submit

Before you begin

Add a scoped SOL-transfer role

Choose the new authority

Confirm the role

Request boundaries

What to read next