Triggering Delegation

How to trigger delegation for a user in React Native.

Recommended: JavaScript SDK for React Native

While this SDK is still supported, we recommend using newer JavaScript SDK, which is optimized for React Native, but also comes with a host of other benefits.

In your application, when a user is logged in, you’ll want to request delegation for your application so your server can act on their behalf (for example, to sign transactions or run automated flows). You can do this in React Native in the following ways.

Dynamic’s UI

Auto-prompt user on sign in

If you chose to prompt users on sign in in the Delegated Access Setup, the user is prompted to approve delegation for your application when they next sign in. No extra code is required in your app.

User-triggered delegation

The user can manually trigger delegation at any time from the Dynamic Widget: Settings → Security → Connected Apps → Wallets Delegated. Open the user profile (e.g. via your menu or a “Manage account” button that calls Dynamic’s user profile UI), then the user can navigate to that section and approve or manage delegation.

Using the Client API

You can use the Dynamic client’s delegation module to trigger delegation programmatically:

import { createClient } from '@dynamic-labs/client';
import { ChainEnum } from '@dynamic-labs/sdk-api-core';

const client = createClient({
  environmentId: 'your-environment-id',
  // ... other config
});

// Trigger delegation for all user wallets
await client.wallets.waas.delegation.initDelegationProcess({});

// Or trigger delegation for specific wallets
await client.wallets.waas.delegation.initDelegationProcess({
  walletIds: ['wallet-id-1', 'wallet-id-2'],
});

// Check if delegation prompt should be shown
const shouldPrompt = await client.wallets.waas.delegation.shouldPromptWalletDelegation();

// Get delegation status for all wallets
const walletsStatus = await client.wallets.waas.delegation.getWalletsDelegatedStatus();

Delegate Key Shares

You can delegate key shares for specific wallets with optional password encryption:

// Delegate without password
await client.wallets.waas.delegation.delegateKeyShares({
  wallets: [
    { chainName: ChainEnum.Evm, accountAddress: '0x123...' },
    { chainName: ChainEnum.Sol, accountAddress: 'abc...' },
  ],
});

// Delegate with password encryption
await client.wallets.waas.delegation.delegateKeyShares({
  wallets: [
    { chainName: ChainEnum.Evm, accountAddress: '0x123...' },
  ],
  password: 'secure-password',
});

When a password is provided, the delegated share will be encrypted with the password, providing an additional layer of security. Learn more about password encryption.

Available Delegation Methods

Method	Description
initDelegationProcess	Initiates the delegation process for specified wallets or all user wallets
shouldPromptWalletDelegation	Checks if the user should be prompted for delegation
getWalletsDelegatedStatus	Returns delegation status for all user wallets
delegateKeyShares	Delegates key shares for specific wallets (with optional password)
revokeDelegation	Revokes delegation for specific wallets (with optional password)
denyWalletDelegation	Denies delegation for a specific wallet
dismissDelegationPrompt	Dismisses the delegation prompt for a wallet
clearDelegationSessionState	Clears delegation session state

What's next?

Learn how to properly receive the delegation materials on your server