> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.umbraprivacy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversion

> API reference: getNetworkEncryptionToSharedEncryptionConverterFunction (MXE to Shared batch) + getMintEncryptionKeyRotatorFunction (X25519 key rotation per mint).

## getNetworkEncryptionToSharedEncryptionConverterFunction

**Import:** `@umbra-privacy/sdk/conversion`

```typescript theme={null}
function getNetworkEncryptionToSharedEncryptionConverterFunction(
  args: GetConvertToSharedEncryptionFunctionArgs,
  deps?: GetConvertToSharedEncryptionFunctionDeps,
): ConvertToSharedEncryptionFunction
```

Converts one or more encrypted token accounts from MXE-mode (network-decryptable only) to shared-mode (user-decryptable). Conversion is per-mint and involves an on-chain Arcium MPC computation. Mints that are already in shared mode, uninitialized, or non-existent are skipped rather than erroring.

***

### GetConvertToSharedEncryptionFunctionArgs

* `client: IUmbraClient`

### GetConvertToSharedEncryptionFunctionDeps

* `accountInfoProvider?: AccountInfoProviderFunction`
* `getLatestBlockhash?: GetLatestBlockhash`
* `transactionForwarder?: TransactionForwarder`

### Returns

`ConvertToSharedEncryptionFunction`

```typescript theme={null}
type ConvertToSharedEncryptionFunction = (
  mints: readonly Address[],
  optionalData?: OptionalData32,
  hooks?: ConvertToSharedHooks,
  microLamportsPerAcu?: MicroLamportsPerAcu,
) => Promise<ConvertToSharedEncryptionResult>;
```

* `mints: readonly Address[]` — token mints to convert. Processed in parallel (eligible only).
* `optionalData?: OptionalData32` — 32-byte caller metadata. Pre-hashed only.
* `hooks?: ConvertToSharedHooks` — per-mint and overall lifecycle hooks.
* `microLamportsPerAcu?: MicroLamportsPerAcu` — optional priority fee in micro-lamports per Arcium compute unit.

### ConvertToSharedEncryptionResult

```typescript theme={null}
interface ConvertToSharedEncryptionResult {
  readonly signatures: readonly TransactionSignature[];   // from OperationOutcome
  readonly converted: Map<Address, TransactionSignature>;
  readonly skipped:   Map<Address, ConvertToSharedEncryptionSkipReason>;
}
```

* `signatures` — every transaction signature submitted across all per-mint conversions.
* `converted` — mints successfully converted, with their handler-tx signature.
* `skipped` — mints not converted, with the reason.

### ConvertToSharedEncryptionSkipReason

* `"non_existent"` - No encrypted token account exists for this mint.
* `"not_initialised"` - The encrypted token account has not been initialised.
* `"already_shared"` - This mint is already in shared mode.
* `"balance_not_initialised"` - The balance state is not yet initialised (e.g. no deposits have occurred).

***

### Errors

Throws `ConversionError` if any non-skippable error occurs. See [Errors](./errors#conversionerror).

### Example

```typescript theme={null}
import { getNetworkEncryptionToSharedEncryptionConverterFunction } from "@umbra-privacy/sdk/conversion";

const convert = getNetworkEncryptionToSharedEncryptionConverterFunction({ client });
const result = await convert([usdcMint, solMint]);

for (const [mint, sig] of result.converted) {
  console.log(`Converted ${mint}:`, sig);
}
for (const [mint, reason] of result.skipped) {
  console.log(`Skipped ${mint}: ${reason}`);
}
```

***

## getMintEncryptionKeyRotatorFunction

**Import:** `@umbra-privacy/sdk/account`

```typescript theme={null}
function getMintEncryptionKeyRotatorFunction(
  args: GetRotateMintX25519EncryptionKeyFunctionArgs,
  deps?: GetRotateMintX25519EncryptionKeyFunctionDeps,
): RotateMintX25519EncryptionKeyFunction
```

Rotates the X25519 encryption key for a specific mint's shared-mode encrypted token account. Use this when the per-mint key may have been compromised. The account must already be in shared mode.

***

### GetRotateMintX25519EncryptionKeyFunctionArgs

* `client: IUmbraClient`

### GetRotateMintX25519EncryptionKeyFunctionDeps

* `accountInfoProvider?: AccountInfoProviderFunction`
* `getLatestBlockhash?: GetLatestBlockhash`
* `transactionForwarder?: TransactionForwarder`
* `mintX25519KeypairGenerator?: MintX25519KeypairGeneratorFunction` - Override the per-mint X25519 keypair derivation.

### Returns

`RotateMintX25519EncryptionKeyFunction`

```typescript theme={null}
type RotateMintX25519EncryptionKeyFunction = (
  mint: Address,
  optionalData?: OptionalData32,
  hooks?: RotateMintKeyHooks,
  microLamportsPerAcu?: MicroLamportsPerAcu,
  options?: RotateMintKeyOptions,
) => Promise<TransactionSignature>
```

* `mint: Address` - The token mint whose X25519 key to rotate.

***

### Errors

Throws `ConversionError`. See [Errors](./errors#conversionerror).

### Example

```typescript theme={null}
import { getMintEncryptionKeyRotatorFunction } from "@umbra-privacy/sdk/account";

const rotateMintKey = getMintEncryptionKeyRotatorFunction({ client });
const signature = await rotateMintKey(usdcMint);
```

***

## ConversionError

Thrown by both conversion functions.

Stage values: `"initialization"` | `"account-fetch"` | `"pda-derivation"` | `"instruction-build"` | `"transaction-build"` | `"transaction-compile"` | `"transaction-sign"` | `"transaction-validate"` | `"transaction-send"`

See [Errors](./errors#conversionerror) for full documentation.