@dynamic-labs-sdk/aleo

This package contains the Aleo integration for the Dynamic SDK. It enables support for Aleo external wallets via the Aleo Wallet Standard and adapter-based wallets (e.g. Shield).

Installation

pnpm add @dynamic-labs-sdk/aleo

Usage

import { addAleoExtension } from '@dynamic-labs-sdk/aleo';
import { createDynamicClient } from '@dynamic-labs-sdk/client';

const dynamicClient = createDynamicClient({
  environmentId: '123',
});
addAleoExtension(dynamicClient);

Embedded (WaaS) wallets

addWaasAleoExtension registers Dynamic's embedded, MPC-backed wallet for Aleo:

import { addWaasAleoExtension } from '@dynamic-labs-sdk/aleo/waas';
import { createDynamicClient } from '@dynamic-labs-sdk/client';

const dynamicClient = createDynamicClient({
  environmentId: '123',
});
addWaasAleoExtension(dynamicClient);

Current limitations of the embedded Aleo wallet:

• signMessage and decrypt are unsupported and throw AleoFeatureUnsupportedError — Aleo's MPC signer has no arbitrary-message-signing primitive yet, and the view key never leaves the WaaS iframe.
• requestTransaction supports exactly one transition per call — atomic multi-transition batches aren't exposed by the underlying WaaS client yet.
• requestRecords returns every record owned by the account across all Aleo programs; it does not filter by the requested program.