Skip to content
Examples

unDelegate

The unDelegate method removes your multichain nexus delegations from your eoa

Overview

If you have previously delegated your account to another address, this method allows you to revoke those permissions. It's an important security feature that lets you regain exclusive control of your account.

Method Signature

function unDelegate(parameters?: UnDelegateParameters): Promise<UnDelegatePayload>

Parameters

ParameterTypeRequiredDescription
chainIdsnumber[]NoOptional array of chain IDs to remove delegations from. If not provided, removes delegations from all chains where the account is deployed

Returns

A Promise that resolves to a UnDelegatePayload object with the following properties:

PropertyTypeDescription
transactionHashesRecord<number, Hex>Object mapping chain IDs to transaction hashes for each undelegation transaction

Examples

Remove Delegations on All Chains

// Remove delegations on all chains where the account is deployed
const result = await mcAccount.unDelegate();
 
console.log("Undelegation transactions submitted:");
for (const [chainId, hash] of Object.entries(result.transactionHashes)) {
  console.log(`Chain ${chainId}: ${hash}`);
}
 
// Wait for transactions to be mined
await mcAccount.waitForTransactionReceipts({
  transactionHashes: result.transactionHashes
});
 
console.log("All undelegation transactions confirmed");

Remove Delegations on Specific Chains

import { optimism, base } from "viem/chains";
 
// Remove delegations only on specific chains
const result = await mcAccount.unDelegate({
  chainIds: [optimism.id, base.id]
});
 
// Check if transactions were submitted
if (result.transactionHashes[optimism.id]) {
  console.log(`Undelegation on Optimism: ${result.transactionHashes[optimism.id]}`);
}
 
if (result.transactionHashes[base.id]) {
  console.log(`Undelegation on Base: ${result.transactionHashes[base.id]}`);
}

Security Considerations

  • Always verify the success of undelegation operations using isDelegated after transactions are confirmed
  • Consider removing delegations before executing high-value transactions if they're no longer needed
  • Monitor for unexpected delegation changes as part of security best practices

Related Methods