feat: add delegated signer support for Solana smart wallets

[devin-ai-integration]

Description

This PR adds support for delegated signers during Solana smart wallet creation, as requested by devlyn@paella.dev. The implementation allows specifying up to 10 delegated signers when creating a Solana smart wallet, with validation to ensure proper address format and prevent duplicates.

Key changes:

• Added conditional delegatedSigners field to WalletArgsFor<C> type (Solana chains only)
• Updated CreateWalletParams to support delegated signers for Solana smart wallets
• Implemented comprehensive validation logic in WalletFactory:
  • Maximum 10 signers limit
  • Solana address format validation (external-wallet:{address})
  • Prevention of admin signer duplication
  • Duplicate signer detection
• Updated type imports from versioned (V2025) to non-versioned types
• Modified wallet creation flow to use specific wallet types (solana-smart-wallet, evm-smart-wallet, etc.)

API usage example:

const wallet = await crossmint.wallets.createWallet({
    chain: "solana",
    signer: { type: "external-wallet", address: "5vV8..." },
    delegatedSigners: [
        "external-wallet:9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "external-wallet:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
    ]
});

Link to Devin run: https://app.devin.ai/sessions/7a17e0dfa8824c829193fd92de31126a

Requested by: devlyn@paella.dev

Test plan

• ✅ All existing unit tests pass (pnpm test:vitest)
• ✅ TypeScript compilation successful (pnpm build:libs)
• ✅ Linting passes (pnpm lint)
• ✅ Manual validation of delegated signer creation flow
• ✅ Error handling validation for invalid addresses, duplicate signers, and max limit exceeded
• ✅ Type safety verification that delegated signers only work with Solana chains

Critical areas for review:

• Solana address validation regex pattern (/^[1-9A-HJ-NP-Za-km-z]{32,44}$/)
• API compatibility with type changes from versioned to non-versioned types
• Extensive use of as any type casting for API compatibility
• Wallet creation flow changes (linkedUser vs owner, wallet type strings)

Package updates

No new packages added. Updated existing type definitions and validation logic within the wallets package.

[devin-ai-integration]

Original prompt from devlyn@paella.dev

We need to update the wallets SDK to support adding delegated signers upon wallet creation, for Solana Smart Wallets only. Here's instructions on how to do so:

Here's an example API payload for solana smart wallet wallet creation with a delegated signer:

{
    "type": "smart",
    "chainType": "solana",
    "config": {
        "adminSigner": {
            "type": "phone",
            "phone": "+175425559938"
        },
      "delegatedSigners": [
        {
            "signer": "external-wallet:EbXL4e6XgbcC7s33cD5EZtyn5nixRDsieBjPQB7zf448"
        }
    ]
    },
    "owner": "email:devlyn+glow4@paella.dev"
}

entrypoints: crossmint-sdk/packages/wallets/src/wallets/wallet.ts and crossmint-sdk/packages/wallets/src/wallets/wallet-factory.ts.


Updated Instructions for Adding Delegated Signer Support for Solana Smart Wallets Only 
Here are the updated comprehensive instructions focused specifically on Solana smart wallet delegated signer support during wallet creation:

1. Update the WalletArgsFor<C> Type for Solana Only 
Modify the WalletArgsFor<C> type to include optional delegated signers, but restrict this functionality to Solana chains only.

export type WalletArgsFor<C extends Chain> = {  
    chain: C;  
    signer: SignerConfigForChain<C>;  
    owner?: string;  
    plugins?: WalletPlugin<C>[];  
    options?: WalletOptions;  
    // Only allow delegated signers for Solana chains  
    delegatedSigners?: C extends "solana" ? string[] : never;  
};
The delegated signers should be an array of string addresses in the format "external-wallet:{address}" as shown in the API tests. delegated-signers-creation.spec.ts:208-209

2. Modify Wallet Factory for Solana Smart Wallets Only 
Update the createWallet Method 
The createWallet method should check if the chain is Solana and the wallet type is smart before processing delegated signers. Based on the backend implementation, Solana smart wallets support delegated signers during creation. solana-smart-wallet-v1-alpha2.se... (2881 chars truncated...)

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[changeset-bot]

⚠️ No Changeset found

Latest commit: 48d5b42

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
smart-wallet-auth-demo	Ignored			Aug 26, 2025 8:37pm