$ npm install @exodus/token-delegationToken delegation feature for managing delegated token addresses per wallet account. Handles storing and managing token delegation relationships with transaction signing and broadcasting.
This module does not fetch delegations from the blockchain. Delegations must be provided externally via setDelegations(). This is intentional: resolving delegations on-chain typically requires expensive reverse lookups (e.g., scanning all accounts to find those with a matching delegate), which is prohibitively slow via RPC.
The module is chain-agnostic. Any asset implementing approveDelegation and revokeDelegation can be used.
yarn add @exodus/token-delegation
This feature is designed to be used together with @exodus/headless. See using the sdk.
import tokenDelegation from '@exodus/token-delegation'
exodus.use(tokenDelegation())
See using the sdk for more details on how features plug into the SDK.
Manages delegation data storage.
// Set delegations from external source (replaces existing)
await exodus.tokenDelegate.setDelegations({
solana: [
{ delegatedAddress: 'delegate-addr-1', assetName: 'usdcoin_solana' },
{ delegatedAddress: 'delegate-addr-2', assetName: 'tetherusd_solana' },
],
})
// Get all stored delegations as a map keyed by base asset
const delegations = await exodus.tokenDelegate.getDelegations()
// { solana: [{ delegatedAddress: '...', assetName: 'usdcoin_solana' }] }
Handles on-chain delegation transactions (sign + broadcast).
// Approve delegation (signs and broadcasts tx)
const { txId } = await exodus.tokenDelegator.approveDelegation({
assetName: 'usdcoin_solana',
delegateAddress: 'delegate-address',
amount: '1000000',
})
// Revoke delegation (signs and broadcasts tx)
const { txId } = await exodus.tokenDelegator.revokeDelegation({
assetName: 'usdcoin_solana',
})
The feature emits tokenDelegation/updated when setDelegations is called.