v0.5.x to v0.6.3 - Arcium Docs

This release requires a program redeploy due to a change in the Arcium program ID. Follow this guide to migrate your MXE from v0.5.x to v0.6.3.

1. Redeploy Required

The Arcium program ID has changed. You must redeploy your MXE program to use v0.6.3.

Version	Program ID
v0.5.x	`BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP`
v0.6.3	`Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ`

After updating dependencies and code (steps below), run:

arcium deploy --cluster-offset <your-offset> --recovery-set-size <size> --keypair-path <path> --rpc-url <url>

2. Update Rust Dependencies

Update your program dependencies to v0.6.3:

cd programs/your-program-name
cargo update --package arcium-client --precise 0.6.3
cargo update --package arcium-macros --precise 0.6.3
cargo update --package arcium-anchor --precise 0.6.3

Update your encrypted-ixs dependencies:

cd ../../encrypted-ixs
cargo update --package arcis --precise 0.6.3

arcis-imports no longer exists in v0.6.3. You must migrate to the arcis crate (see section 7).

3. Update TypeScript Dependencies

npm install @arcium-hq/[email protected]

4. Rename SignerAccount to ArciumSignerAccount (Rust)

The SignerAccount type has been renamed to ArciumSignerAccount. Update all references in your program:

// Before v0.6
#[account(
    init_if_needed,
    payer = payer,
    space = 8 + 1,
    seeds = [b"SignerAccount"],
    bump,
    address = derive_sign_pda!(),
)]
pub sign_pda_account: Account<'info, SignerAccount>,

// v0.6.3
#[account(
    init_if_needed,
    payer = payer,
    space = 8 + 1,
    seeds = [b"ArciumSignerAccount"],
    bump,
    address = derive_sign_pda!(),
)]
pub sign_pda_account: Account<'info, ArciumSignerAccount>,

The seed in the seeds attribute must also be updated from b"SignerAccount" to b"ArciumSignerAccount".

5. Update PDA Seed in TypeScript

If you derive the signer PDA manually in your TypeScript code, update the seed:

// Before v0.6
const signPda = PublicKey.findProgramAddressSync(
  [Buffer.from("SignerAccount")],
  program.programId
)[0];

// v0.6.3
const signPda = PublicKey.findProgramAddressSync(
  [Buffer.from("ArciumSignerAccount")],
  program.programId
)[0];

6. (Optional) Configure Arcium.toml for Non-Localnet Testing

v0.6.3 adds the --cluster flag to run tests against devnet, mainnet, or custom clusters directly.

Prerequisites

Mode	Requirements
Localnet (default)	Docker running, ports available
Remote clusters	Cluster offset in `Arcium.toml`, RPC URL in `Anchor.toml`

Configure Cluster Offsets

Add cluster configurations to your Arcium.toml:

[localnet]
nodes = 2
localnet_timeout_secs = 60
backends = ["Cerberus"]

# Cluster config for devnet testing
# Note: Cluster 123 is v0.5.4, cluster 456 is v0.7.0
[clusters.devnet]
offset = 456

Run Tests

# Localnet (default) - starts Docker, validator, ARX nodes
arcium test

# Devnet - uses cluster config from Arcium.toml
arcium test --cluster devnet

RPC Configuration

For non-localnet testing, configure your RPC endpoint in Anchor.toml:

[provider]
cluster = "devnet"
wallet = "~/.config/solana/id.json"

Non-localnet tests skip Docker, local validator, and ARX nodes entirely. The CLI reads the cluster offset from Arcium.toml and sets the ARCIUM_CLUSTER_OFFSET environment variable for your tests.

If you run arcium test --cluster devnet without configuring [clusters.devnet] in Arcium.toml, you’ll see an error with instructions to add the configuration.

7. Migrate from arcis-imports to arcis

The arcis-imports crate no longer exists in v0.6.3. You must migrate to the arcis crate:

# Before v0.6 (Cargo.toml)
[dependencies]
arcis-imports = "0.5.1"

# v0.6.3 (Cargo.toml)
[dependencies]
arcis = "0.6.3"
blake3 = "=1.8.2"

Blake3 must be pinned to exactly 1.8.2. Newer versions use Rust edition 2024, which is incompatible with Anchor programs.

In your circuit code, update the import:

// Before v0.6
use arcis_imports::*;

// v0.6.3
use arcis::*;

8. Add `mut` to clock_account

The clock_account now requires the mut attribute in your account constraints:

// Before v0.6
#[account(
    address = ARCIUM_CLOCK_ACCOUNT_ADDRESS
)]
pub clock_account: Account<'info, ClockAccount>,

// v0.6.3
#[account(
    mut,
    address = ARCIUM_CLOCK_ACCOUNT_ADDRESS
)]
pub clock_account: Account<'info, ClockAccount>,

9. Verify Migration

After completing all steps, verify your migration:

# Build
arcium build

# Type check
cargo check --all

# Run tests
arcium test

10. Summary of Breaking Changes

Change	Before v0.6	v0.6.3
Program ID	`BpaW2ZmCJnDwizWY8eM34JtVqp2kRgnmQcedSVc9USdP`	`Arcj82pX7HxYKLR92qvgZUAd7vGS1k4hQvAFcPATFdEQ`
Signer Account Type	`SignerAccount`	`ArciumSignerAccount`
Signer PDA Seed	`"SignerAccount"`	`"ArciumSignerAccount"`
Rust Dependencies	`0.5.x`	`0.6.3`
TypeScript Client	`@arcium-hq/[email protected]`	`@arcium-hq/[email protected]`
Arcis Crate	`arcis-imports`	`arcis`
blake3 (encrypted-ixs)	Not required	`blake3 = "=1.8.2"`
clock_account	No `mut`	Requires `mut`

​1. Redeploy Required

​2. Update Rust Dependencies

​3. Update TypeScript Dependencies

​4. Rename SignerAccount to ArciumSignerAccount (Rust)

​5. Update PDA Seed in TypeScript

​6. (Optional) Configure Arcium.toml for Non-Localnet Testing

​Prerequisites

​Configure Cluster Offsets

​Run Tests

​RPC Configuration

​7. Migrate from arcis-imports to arcis

​8. Add mut to clock_account

​9. Verify Migration

​10. Summary of Breaking Changes

1. Redeploy Required

2. Update Rust Dependencies

3. Update TypeScript Dependencies

4. Rename SignerAccount to ArciumSignerAccount (Rust)

5. Update PDA Seed in TypeScript

6. (Optional) Configure Arcium.toml for Non-Localnet Testing

Prerequisites

Configure Cluster Offsets

Run Tests

RPC Configuration

7. Migrate from arcis-imports to arcis

8. Add `mut` to clock_account

9. Verify Migration

10. Summary of Breaking Changes