@solana/keychain 0.6.1 → 1.1.0

package/README.md

@@ -15,7 +15,7 @@ This installs all signer implementations. For a smaller bundle, install individu
 - `@solana/keychain-crossmint` - Crossmint signer
 - `@solana/keychain-dfns` - Dfns signer
 - `@solana/keychain-fireblocks` - Fireblocks signer
-- `@solana/keychain-gcp-kms` - Google Cloud KMS signer
+- `@solana/keychain-gcp-kms` - GCP KMS signer
 - `@solana/keychain-para` - Para MPC signer
 - `@solana/keychain-privy` - Privy signer
 - `@solana/keychain-turnkey` - Turnkey signer
@@ -23,47 +23,109 @@ This installs all signer implementations. For a smaller bundle, install individu
 
 ## Usage
 
-### Direct Signer Imports
+### Unified Factory (Recommended)
 
-The main signer classes are exported directly for convenience:
+Use `createKeychainSigner` with a discriminated config to create any backend:
 
 ```typescript
-import {
-    AwsKmsSigner,
-    CdpSigner,
-    CrossmintSigner,
-    DfnsSigner,
-    FireblocksSigner,
-    GcpKmsSigner,
-    ParaSigner,
-    PrivySigner,
-    TurnkeySigner,
-    VaultSigner,
-} from '@solana/keychain';
-
-// Use any signer directly
-const signer = new VaultSigner({
+import { createKeychainSigner } from '@solana/keychain';
+
+const signer = await createKeychainSigner({
+    backend: 'privy',
+    appId: 'your-app-id',
+    appSecret: 'your-app-secret',
+    walletId: 'your-wallet-id',
+});
+
+await signer.signTransactions([transaction]);
+```
+
+The `backend` field determines which signer is created. TypeScript narrows the config type automatically — you get full autocomplete for each backend's required fields.
+
+### Resolve Address Without Signing
+
+Use `resolveAddress` to get a signer's Solana address without initializing the full signing pipeline:
+
+```typescript
+import { resolveAddress } from '@solana/keychain';
+
+// Sync backends (AWS KMS, GCP KMS, Turnkey, Vault, CDP) return instantly
+const address = await resolveAddress({
+    backend: 'vault',
+    vaultAddr: 'https://vault.example.com',
+    vaultToken: 'hvs.xxx',
+    keyName: 'my-key',
+    publicKey: '4Nd1m...',
+});
+
+// Async backends (Privy, Para, Fireblocks, Crossmint, Dfns) fetch from the API
+const address2 = await resolveAddress({
+    backend: 'privy',
+    appId: '...',
+    appSecret: '...',
+    walletId: '...',
+});
+```
+
+### Config Types
+
+The `KeychainSignerConfig` discriminated union and individual config types are exported for building config management, CLIs, or dashboards:
+
+```typescript
+import type { KeychainSignerConfig, BackendName, PrivySignerConfig } from '@solana/keychain';
+
+// BackendName = 'aws-kms' | 'cdp' | 'crossmint' | 'dfns' | 'fireblocks' | 'gcp-kms' | 'para' | 'privy' | 'turnkey' | 'vault'
+
+function loadConfig(json: unknown): KeychainSignerConfig {
+    // Parse and validate your config...
+}
+```
+
+### Signing a Compiled Transaction
+
+If you already have a compiled transaction (e.g. from a dApp, backend service, or another system), use `signTransactionWithSigners` from `@solana/signers` (≥ 6.5) to sign it directly:
+
+```typescript
+import { signTransactionWithSigners } from '@solana/signers';
+import { createKeychainSigner } from '@solana/keychain';
+
+const signer = await createKeychainSigner({
+    backend: 'vault',
     vaultAddr: 'https://vault.example.com',
     vaultToken: 'hvs.xxx',
-    keyName: 'my-solana-key',
-    publicKey: 'YourSolanaPublicKey',
+    keyName: 'my-key',
+    publicKey: '4Nd1m...',
+});
+
+// Sign an already-compiled transaction
+const signedTx = await signTransactionWithSigners([signer], compiledTransaction);
+```
+
+This complements the message-level helpers (`signTransactionMessageWithSigners`) which extract signers from account metas automatically. The transaction-level variant is useful when signers aren't embedded in the transaction message.
+
+### Direct Factory Imports
+
+Each backend also exports its own factory function:
+
+```typescript
+import { createPrivySigner } from '@solana/keychain';
+
+const signer = await createPrivySigner({
+    appId: '...',
+    appSecret: '...',
+    walletId: '...',
 });
 ```
 
 ### Namespaced Imports
 
-Each signer package is also available under its namespace for accessing types and utilities:
+Each signer package is available under its namespace for accessing types and utilities:
 
 ```typescript
-import { awsKms, cdp, crossmint, dfns, fireblocks, gcpKms, para, privy, turnkey, vault } from '@solana/keychain';
+import { fireblocks, vault } from '@solana/keychain';
 
-// Access types
 type VaultConfig = vault.VaultSignerConfig;
-type CrossmintConfig = crossmint.CrossmintSignerConfig;
 type FireblocksStatus = fireblocks.FireblocksTransactionStatus;
-
-// Or use signers via namespace
-const signer = new vault.VaultSigner({ ... });
 ```
 
 ### Core Utilities
@@ -71,9 +133,8 @@ const signer = new vault.VaultSigner({ ... });
 Core types and utilities from `@solana/keychain-core` are re-exported:
 
 ```typescript
-import { SignerErrorCode, SolanaSigner } from '@solana/keychain';
+import { SignerErrorCode, type SolanaSigner } from '@solana/keychain';
 
-// Use error codes
 try {
     await signer.signMessages([message]);
 } catch (error) {
@@ -85,22 +146,22 @@ try {
 
 ## Available Signers
 
-| Signer |  Package |
-|--------|----------|
-| `AwsKmsSigner` | [@solana/keychain-aws-kms](../aws-kms/README.md) |
-| `CdpSigner` | [@solana/keychain-cdp](../cdp/README.md) |
-| `CrossmintSigner` | [@solana/keychain-crossmint](../crossmint/README.md) |
-| `DfnsSigner` | [@solana/keychain-dfns](../dfns/README.md) |
-| `FireblocksSigner` | [@solana/keychain-fireblocks](../fireblocks/README.md) |
-| `GcpKmsSigner` | [@solana/keychain-gcp-kms](../gcp-kms/README.md) |
-| `ParaSigner` | [@solana/keychain-para](../para/README.md) |
-| `PrivySigner` | [@solana/keychain-privy](../privy/README.md) |
-| `TurnkeySigner` | [@solana/keychain-turnkey](../turnkey/README.md) |
-| `VaultSigner` | [@solana/keychain-vault](../vault/README.md) |
+| Backend | Package | Address Source |
+|---------|---------|---------------|
+| `aws-kms` | [@solana/keychain-aws-kms](../aws-kms/README.md) | Config (`publicKey`) |
+| `cdp` | [@solana/keychain-cdp](../cdp/README.md) | Config (`address`) |
+| `crossmint` | [@solana/keychain-crossmint](../crossmint/README.md) | API |
+| `dfns` | [@solana/keychain-dfns](../dfns/README.md) | API |
+| `fireblocks` | [@solana/keychain-fireblocks](../fireblocks/README.md) | API |
+| `gcp-kms` | [@solana/keychain-gcp-kms](../gcp-kms/README.md) | Config (`publicKey`) |
+| `para` | [@solana/keychain-para](../para/README.md) | API |
+| `privy` | [@solana/keychain-privy](../privy/README.md) | API |
+| `turnkey` | [@solana/keychain-turnkey](../turnkey/README.md) | Config (`publicKey`) |
+| `vault` | [@solana/keychain-vault](../vault/README.md) | Config (`publicKey`) |
 
 ## Common Interface
 
-All signers are compatible with the `@solana/kit` and `@solana/signers` libraries and implement the `SolanaSigner` interface:
+All signers implement `SolanaSigner`, which is compatible with `@solana/kit` and `@solana/signers`:
 
 ```typescript
 interface SolanaSigner<TAddress extends string = string> {
@@ -111,15 +172,6 @@ interface SolanaSigner<TAddress extends string = string> {
 }
 ```
 
-This allows you to write code that works with any signer:
-
-```typescript
-async function signAndSend(signer: SolanaSigner, transaction: Transaction) {
-    const [signatures] = await signer.signTransactions([transaction]);
-    // ... send transaction
-}
-```
-
 ## License
 
 MIT

package/dist/__tests__/create-keychain-signer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-keychain-signer.test.d.ts.map

package/dist/__tests__/create-keychain-signer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-keychain-signer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-keychain-signer.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/create-keychain-signer.test.js

@@ -0,0 +1,137 @@
+import { SignerErrorCode } from '@solana/keychain-core';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createKeychainSigner } from '../create-keychain-signer.js';
+const TEST_ADDRESS = '11111111111111111111111111111111';
+function makeMockSigner(address = TEST_ADDRESS) {
+    return {
+        address,
+        isAvailable: vi.fn().mockResolvedValue(true),
+        signMessages: vi.fn().mockResolvedValue([]),
+        signTransactions: vi.fn().mockResolvedValue([]),
+    };
+}
+// Mock all backend factories
+vi.mock('@solana/keychain-aws-kms', () => ({ createAwsKmsSigner: vi.fn() }));
+vi.mock('@solana/keychain-cdp', () => ({ createCdpSigner: vi.fn() }));
+vi.mock('@solana/keychain-crossmint', () => ({ createCrossmintSigner: vi.fn() }));
+vi.mock('@solana/keychain-dfns', () => ({ createDfnsSigner: vi.fn() }));
+vi.mock('@solana/keychain-fireblocks', () => ({ createFireblocksSigner: vi.fn() }));
+vi.mock('@solana/keychain-gcp-kms', () => ({ createGcpKmsSigner: vi.fn() }));
+vi.mock('@solana/keychain-para', () => ({ createParaSigner: vi.fn() }));
+vi.mock('@solana/keychain-privy', () => ({ createPrivySigner: vi.fn() }));
+vi.mock('@solana/keychain-turnkey', () => ({ createTurnkeySigner: vi.fn() }));
+vi.mock('@solana/keychain-vault', () => ({ createVaultSigner: vi.fn() }));
+// Table-driven test configs — one per backend
+const BACKEND_CONFIGS = {
+    'aws-kms': {
+        config: { backend: 'aws-kms', keyId: 'key-1', publicKey: TEST_ADDRESS },
+        factoryName: 'createAwsKmsSigner',
+        modulePath: '@solana/keychain-aws-kms',
+    },
+    cdp: {
+        config: {
+            backend: 'cdp',
+            address: TEST_ADDRESS,
+            cdpApiKeyId: 'id',
+            cdpApiKeySecret: 's',
+            cdpWalletSecret: 'w',
+        },
+        factoryName: 'createCdpSigner',
+        modulePath: '@solana/keychain-cdp',
+    },
+    crossmint: {
+        config: { backend: 'crossmint', apiKey: 'key', walletLocator: 'loc' },
+        factoryName: 'createCrossmintSigner',
+        modulePath: '@solana/keychain-crossmint',
+    },
+    dfns: {
+        config: { backend: 'dfns', authToken: 'tok', credId: 'cred', privateKeyPem: 'pem', walletId: 'w' },
+        factoryName: 'createDfnsSigner',
+        modulePath: '@solana/keychain-dfns',
+    },
+    fireblocks: {
+        config: { backend: 'fireblocks', apiKey: 'key', privateKeyPem: 'pem', vaultAccountId: 'v' },
+        factoryName: 'createFireblocksSigner',
+        modulePath: '@solana/keychain-fireblocks',
+    },
+    'gcp-kms': {
+        config: { backend: 'gcp-kms', keyName: 'key', publicKey: TEST_ADDRESS },
+        factoryName: 'createGcpKmsSigner',
+        modulePath: '@solana/keychain-gcp-kms',
+    },
+    para: {
+        config: { backend: 'para', apiKey: 'key', walletId: 'w' },
+        factoryName: 'createParaSigner',
+        modulePath: '@solana/keychain-para',
+    },
+    privy: {
+        config: { backend: 'privy', appId: 'app', appSecret: 'secret', walletId: 'w' },
+        factoryName: 'createPrivySigner',
+        modulePath: '@solana/keychain-privy',
+    },
+    turnkey: {
+        config: {
+            backend: 'turnkey',
+            apiPrivateKey: 'pk',
+            apiPublicKey: 'pub',
+            organizationId: 'org',
+            privateKeyId: 'pkid',
+            publicKey: TEST_ADDRESS,
+        },
+        factoryName: 'createTurnkeySigner',
+        modulePath: '@solana/keychain-turnkey',
+    },
+    vault: {
+        config: {
+            backend: 'vault',
+            keyName: 'key',
+            publicKey: TEST_ADDRESS,
+            vaultAddr: 'https://v',
+            vaultToken: 'tok',
+        },
+        factoryName: 'createVaultSigner',
+        modulePath: '@solana/keychain-vault',
+    },
+};
+describe('createKeychainSigner', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe.each(Object.entries(BACKEND_CONFIGS))('%s', (_backend, { config, modulePath, factoryName }) => {
+        it('dispatches to the correct factory', async () => {
+            const mockSigner = makeMockSigner();
+            const mod = await import(modulePath);
+            const factory = mod[factoryName];
+            factory.mockResolvedValue(mockSigner);
+            const result = await createKeychainSigner(config);
+            expect(result).toBe(mockSigner);
+            expect(factory).toHaveBeenCalledOnce();
+        });
+        it('passes config without the backend field', async () => {
+            const mockSigner = makeMockSigner();
+            const mod = await import(modulePath);
+            const factory = mod[factoryName];
+            factory.mockResolvedValue(mockSigner);
+            await createKeychainSigner(config);
+            const passedConfig = factory.mock.calls[0][0];
+            expect(passedConfig).not.toHaveProperty('backend');
+        });
+        it('propagates factory errors', async () => {
+            const mod = await import(modulePath);
+            const factory = mod[factoryName];
+            factory.mockRejectedValue(new Error('factory error'));
+            await expect(createKeychainSigner(config)).rejects.toThrow('factory error');
+        });
+    });
+    it('throws SignerError for unknown backend', async () => {
+        const badConfig = { backend: 'nonexistent' };
+        try {
+            await createKeychainSigner(badConfig);
+            expect.unreachable('should have thrown');
+        }
+        catch (error) {
+            expect(error.code).toBe(SignerErrorCode.CONFIG_ERROR);
+        }
+    });
+});
+//# sourceMappingURL=create-keychain-signer.test.js.map

package/dist/__tests__/create-keychain-signer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-keychain-signer.test.js","sourceRoot":"","sources":["../../src/__tests__/create-keychain-signer.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/resolve-address.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-address.test.d.ts.map

package/dist/__tests__/resolve-address.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-address.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/resolve-address.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/resolve-address.test.js

@@ -0,0 +1,106 @@
+import { SignerErrorCode } from '@solana/keychain-core';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const TEST_ADDRESS = '11111111111111111111111111111111';
+function makeMockSigner(address = TEST_ADDRESS) {
+    return {
+        address,
+        isAvailable: vi.fn().mockResolvedValue(true),
+        signMessages: vi.fn().mockResolvedValue([]),
+        signTransactions: vi.fn().mockResolvedValue([]),
+    };
+}
+// Mock createKeychainSigner so we don't pull in all backend deps
+vi.mock('../create-keychain-signer.js', () => ({
+    createKeychainSigner: vi.fn().mockResolvedValue(makeMockSigner()),
+}));
+// Must import after mock setup
+const { resolveAddress } = await import('../resolve-address.js');
+const { createKeychainSigner } = await import('../create-keychain-signer.js');
+describe('resolveAddress', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('sync backends (publicKey in config)', () => {
+        it.each(['aws-kms', 'gcp-kms', 'turnkey', 'vault'])('%s returns publicKey directly', async (backend) => {
+            const config = {
+                backend,
+                keyId: 'k',
+                keyName: 'k',
+                publicKey: TEST_ADDRESS,
+                vaultAddr: 'https://v',
+                vaultToken: 't',
+                apiPrivateKey: 'pk',
+                apiPublicKey: 'pub',
+                organizationId: 'org',
+                privateKeyId: 'pkid',
+            };
+            const address = await resolveAddress(config);
+            expect(address).toBe(TEST_ADDRESS);
+            expect(createKeychainSigner).not.toHaveBeenCalled();
+        });
+        it('throws for invalid publicKey', async () => {
+            const config = {
+                backend: 'vault',
+                keyName: 'k',
+                publicKey: 'not-a-valid-address',
+                vaultAddr: 'https://v',
+                vaultToken: 't',
+            };
+            await expect(resolveAddress(config)).rejects.toThrow();
+        });
+    });
+    describe('cdp (address in config)', () => {
+        it('returns address directly', async () => {
+            const config = {
+                backend: 'cdp',
+                address: TEST_ADDRESS,
+                cdpApiKeyId: 'id',
+                cdpApiKeySecret: 's',
+                cdpWalletSecret: 'w',
+            };
+            const address = await resolveAddress(config);
+            expect(address).toBe(TEST_ADDRESS);
+            expect(createKeychainSigner).not.toHaveBeenCalled();
+        });
+        it('throws for invalid address', async () => {
+            const config = {
+                backend: 'cdp',
+                address: 'bad',
+                cdpApiKeyId: 'id',
+                cdpApiKeySecret: 's',
+                cdpWalletSecret: 'w',
+            };
+            await expect(resolveAddress(config)).rejects.toThrow();
+        });
+    });
+    describe('async backends (fetch from API)', () => {
+        it.each(['crossmint', 'dfns', 'fireblocks', 'para', 'privy'])('%s delegates to createKeychainSigner', async (backend) => {
+            const config = {
+                backend,
+                apiKey: 'k',
+                appId: 'a',
+                appSecret: 's',
+                authToken: 't',
+                credId: 'c',
+                privateKeyPem: 'p',
+                vaultAccountId: 'v',
+                walletId: 'w',
+                walletLocator: 'l',
+            };
+            const address = await resolveAddress(config);
+            expect(address).toBe(TEST_ADDRESS);
+            expect(createKeychainSigner).toHaveBeenCalledWith(config);
+        });
+    });
+    it('throws SignerError for unknown backend', async () => {
+        const badConfig = { backend: 'nonexistent' };
+        try {
+            await resolveAddress(badConfig);
+            expect.unreachable('should have thrown');
+        }
+        catch (error) {
+            expect(error.code).toBe(SignerErrorCode.CONFIG_ERROR);
+        }
+    });
+});
+//# sourceMappingURL=resolve-address.test.js.map

package/dist/__tests__/resolve-address.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-address.test.js","sourceRoot":"","sources":["../../src/__tests__/resolve-address.test.ts"],"names":[],"mappings":"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"}

package/dist/create-keychain-signer.d.ts

@@ -0,0 +1,20 @@
+import type { SolanaSigner } from '@solana/keychain-core';
+import type { KeychainSignerConfig } from './types.js';
+/**
+ * Create a {@link SolanaSigner} from a backend-tagged configuration.
+ *
+ * Dispatches to the correct `createXxxSigner()` factory based on
+ * the `backend` discriminant.
+ *
+ * @example
+ * ```typescript
+ * const signer = await createKeychainSigner({
+ *     backend: 'privy',
+ *     appId: '...',
+ *     appSecret: '...',
+ *     walletId: '...',
+ * });
+ * ```
+ */
+export declare function createKeychainSigner(config: KeychainSignerConfig): Promise<SolanaSigner>;
+//# sourceMappingURL=create-keychain-signer.d.ts.map

package/dist/create-keychain-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-keychain-signer.d.ts","sourceRoot":"","sources":["../src/create-keychain-signer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAW1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B9F"}

package/dist/create-keychain-signer.js

@@ -0,0 +1,61 @@
+import { createAwsKmsSigner } from '@solana/keychain-aws-kms';
+import { createCdpSigner } from '@solana/keychain-cdp';
+import { SignerErrorCode, throwSignerError } from '@solana/keychain-core';
+import { createCrossmintSigner } from '@solana/keychain-crossmint';
+import { createDfnsSigner } from '@solana/keychain-dfns';
+import { createFireblocksSigner } from '@solana/keychain-fireblocks';
+import { createGcpKmsSigner } from '@solana/keychain-gcp-kms';
+import { createParaSigner } from '@solana/keychain-para';
+import { createPrivySigner } from '@solana/keychain-privy';
+import { createTurnkeySigner } from '@solana/keychain-turnkey';
+import { createVaultSigner } from '@solana/keychain-vault';
+function stripBackend({ backend: _, ...rest }) {
+    return rest;
+}
+/**
+ * Create a {@link SolanaSigner} from a backend-tagged configuration.
+ *
+ * Dispatches to the correct `createXxxSigner()` factory based on
+ * the `backend` discriminant.
+ *
+ * @example
+ * ```typescript
+ * const signer = await createKeychainSigner({
+ *     backend: 'privy',
+ *     appId: '...',
+ *     appSecret: '...',
+ *     walletId: '...',
+ * });
+ * ```
+ */
+export async function createKeychainSigner(config) {
+    switch (config.backend) {
+        case 'aws-kms':
+            return createAwsKmsSigner(stripBackend(config));
+        case 'cdp':
+            return await createCdpSigner(stripBackend(config));
+        case 'crossmint':
+            return await createCrossmintSigner(stripBackend(config));
+        case 'dfns':
+            return await createDfnsSigner(stripBackend(config));
+        case 'fireblocks':
+            return await createFireblocksSigner(stripBackend(config));
+        case 'gcp-kms':
+            return createGcpKmsSigner(stripBackend(config));
+        case 'para':
+            return await createParaSigner(stripBackend(config));
+        case 'privy':
+            return await createPrivySigner(stripBackend(config));
+        case 'turnkey':
+            return createTurnkeySigner(stripBackend(config));
+        case 'vault':
+            return createVaultSigner(stripBackend(config));
+        default: {
+            const _exhaustive = config;
+            return throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: `Unknown backend: ${String(_exhaustive.backend)}`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=create-keychain-signer.js.map

package/dist/create-keychain-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-keychain-signer.js","sourceRoot":"","sources":["../src/create-keychain-signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,SAAS,YAAY,CAAgC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAK;IAC3E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAA4B;IACnE,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,SAAS;YACV,OAAO,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,KAAK,KAAK;YACN,OAAO,MAAM,eAAe,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,WAAW;YACZ,OAAO,MAAM,qBAAqB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,KAAK,MAAM;YACP,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,KAAK,YAAY;YACb,OAAO,MAAM,sBAAsB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,KAAK,SAAS;YACV,OAAO,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM;YACP,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,KAAK,OAAO;YACR,OAAO,MAAM,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,KAAK,SAAS;YACV,OAAO,mBAAmB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,KAAK,OAAO;YACR,OAAO,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,OAAO,gBAAgB,CAAC,eAAe,CAAC,YAAY,EAAE;gBAClD,OAAO,EAAE,oBAAoB,MAAM,CAAE,WAAmC,CAAC,OAAO,CAAC,EAAE;aACtF,CAAC,CAAC;QACP,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,17 @@
 export * from '@solana/keychain-core';
+export { createKeychainSigner } from './create-keychain-signer.js';
+export { resolveAddress } from './resolve-address.js';
+export type { BackendName, KeychainSignerConfig } from './types.js';
+export type { AwsKmsSignerConfig } from '@solana/keychain-aws-kms';
+export type { CdpSignerConfig } from '@solana/keychain-cdp';
+export type { CrossmintSignerConfig } from '@solana/keychain-crossmint';
+export type { DfnsSignerConfig } from '@solana/keychain-dfns';
+export type { FireblocksSignerConfig } from '@solana/keychain-fireblocks';
+export type { GcpKmsSignerConfig } from '@solana/keychain-gcp-kms';
+export type { ParaSignerConfig } from '@solana/keychain-para';
+export type { PrivySignerConfig } from '@solana/keychain-privy';
+export type { TurnkeySignerConfig } from '@solana/keychain-turnkey';
+export type { VaultSignerConfig } from '@solana/keychain-vault';
 export * as awsKms from '@solana/keychain-aws-kms';
 export * as cdp from '@solana/keychain-cdp';
 export * as crossmint from '@solana/keychain-crossmint';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AAGtC,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,5 +1,8 @@
 // Core types and utilities (flat export)
 export * from '@solana/keychain-core';
+// Unified signer factory, address resolver, and config union
+export { createKeychainSigner } from './create-keychain-signer.js';
+export { resolveAddress } from './resolve-address.js';
 // Signer implementations (namespaced to avoid conflicts)
 export * as awsKms from '@solana/keychain-aws-kms';
 export * as cdp from '@solana/keychain-cdp';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,cAAc,uBAAuB,CAAC;AAEtC,yDAAyD;AACzD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,uDAAuD;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,cAAc,uBAAuB,CAAC;AAEtC,6DAA6D;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAetD,yDAAyD;AACzD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,uDAAuD;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}