@solana/keychain-cdp 0.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,100 @@
+# @solana/keychain-cdp
+
+Coinbase Developer Platform (CDP) signer for Solana transactions using CDP's managed wallet infrastructure.
+
+## Installation
+
+```bash
+pnpm add @solana/keychain-cdp
+```
+
+## Usage
+
+### Create and Initialize
+
+```typescript
+import { createCdpSigner } from '@solana/keychain-cdp';
+
+// API keys are created at https://portal.cdp.coinbase.com
+const signer = await createCdpSigner({
+    cdpApiKeyId: process.env.CDP_API_KEY_ID!,
+    cdpApiKeySecret: process.env.CDP_API_KEY_SECRET!,
+    cdpWalletSecret: process.env.CDP_WALLET_SECRET!,
+    address: process.env.CDP_SOLANA_ADDRESS!,
+});
+
+console.log('Signer address:', signer.address);
+```
+
+### Sign Messages
+
+```typescript
+import { createSignableMessage } from '@solana/signers';
+
+const message = createSignableMessage('Hello, CDP!');
+const [signatures] = await signer.signMessages([message]);
+```
+
+### Sign Transactions
+
+```typescript
+import {
+    createTransactionMessage,
+    pipe,
+    setTransactionMessageFeePayerSigner,
+    setTransactionMessageLifetimeUsingBlockhash,
+    signTransactionMessageWithSigners,
+} from '@solana/kit';
+
+const transaction = pipe(
+    createTransactionMessage({ version: 0 }),
+    tx => setTransactionMessageFeePayerSigner(signer, tx),
+    tx => setTransactionMessageLifetimeUsingBlockhash({ blockhash, lastValidBlockHeight }, tx),
+);
+const signed = await signTransactionMessageWithSigners(transaction);
+```
+
+### Check Availability
+
+```typescript
+const available = await signer.isAvailable();
+console.log('CDP API available:', available);
+```
+
+## API Reference
+
+### `createCdpSigner(config)`
+
+Creates and initializes a new CdpSigner instance.
+
+**Config options:**
+
+- `cdpApiKeyId` (string, required): CDP API key ID
+- `cdpApiKeySecret` (string, required): Base64-encoded Ed25519 key (64 bytes: seed || pubkey)
+- `cdpWalletSecret` (string, required): Base64-encoded PKCS#8 DER EC (P-256) private key
+- `address` (string, required): Solana account address managed by CDP
+- `baseUrl` (string, optional): Custom API base URL (defaults to `https://api.cdp.coinbase.com`)
+- `requestDelayMs` (number, optional): Delay in ms between concurrent signing requests to avoid rate limits (default: 0)
+
+**Returns:** `Promise<CdpSigner>`
+
+### Methods
+
+- `signMessages(messages)`: Signs one or more messages (UTF-8 strings only)
+- `signTransactions(transactions)`: Signs one or more transactions
+- `isAvailable()`: Checks if the CDP API is reachable
+- `address`: Read-only property containing the signer's Solana address
+
+## How It Works
+
+1. **Initialization**: Validates Ed25519 API key (seed/pubkey match) and loads P-256 wallet key
+2. **Authentication**: Every signing request sends two JWTs — an Ed25519 auth JWT and an ES256 wallet JWT with request body hash
+3. **Signing**: Sends transactions/messages to CDP's signing API endpoint
+4. **Extraction**: For transactions, uses `extractSignatureFromWireTransaction` to extract the signer's signature from CDP's signed wire transaction. For messages, decodes the base58-encoded signature directly from the response.
+
+## Security Notes
+
+- Store your `cdpApiKeySecret` and `cdpWalletSecret` securely (use environment variables)
+- Never expose credentials in client-side code
+- This signer is intended for server-side use or secure environments
+- CDP handles key management — your signing keys never leave CDP's infrastructure

package/dist/__tests__/cdp-signer.integration.test.d.ts

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

package/dist/__tests__/cdp-signer.integration.test.d.ts.map

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

package/dist/__tests__/cdp-signer.integration.test.js

@@ -0,0 +1,17 @@
+import { runSignerIntegrationTest } from '@solana/keychain-test-utils';
+import { config } from 'dotenv';
+import { describe, it } from 'vitest';
+import { getConfig } from './setup.js';
+config();
+describe('CdpSigner Integration', () => {
+    it.skipIf(!process.env.CDP_API_KEY_ID)('signs transactions with real API', async () => {
+        await runSignerIntegrationTest(await getConfig(['signTransaction']));
+    });
+    it.skipIf(!process.env.CDP_API_KEY_ID)('signs messages with real API', async () => {
+        await runSignerIntegrationTest(await getConfig(['signMessage']));
+    });
+    it.skipIf(!process.env.CDP_API_KEY_ID)('simulates transactions with real API', async () => {
+        await runSignerIntegrationTest(await getConfig(['simulateTransaction']));
+    });
+});
+//# sourceMappingURL=cdp-signer.integration.test.js.map

package/dist/__tests__/cdp-signer.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-signer.integration.test.js","sourceRoot":"","sources":["../../src/__tests__/cdp-signer.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,EAAE,CAAC;AAET,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,wBAAwB,CAAC,MAAM,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,wBAAwB,CAAC,MAAM,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,wBAAwB,CAAC,MAAM,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/__tests__/cdp-signer.test.d.ts

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

package/dist/__tests__/cdp-signer.test.d.ts.map

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

package/dist/__tests__/cdp-signer.test.js

@@ -0,0 +1,269 @@
+import * as nodeCrypto from 'node:crypto';
+import { assertIsSolanaSigner } from '@solana/keychain-core';
+import { generateKeyPairSigner } from '@solana/signers';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('@solana/keychain-core', async (importOriginal) => {
+    const mod = await importOriginal();
+    return {
+        ...mod,
+        assertSignatureValid: vi.fn(),
+        sanitizeRemoteErrorResponse: mod.sanitizeRemoteErrorResponse ??
+            ((text) => `${text
+                .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, ' ')
+                .replace(/\s+/g, ' ')
+                .trim()
+                .slice(0, 256)} [truncated]`),
+    };
+});
+import { CdpSigner } from '../cdp-signer.js';
+// --- Valid test credentials ---
+// Generate a real Ed25519 keypair so that createKeyPairFromBytes seed↔pubkey validation passes.
+// Ed25519 PKCS#8 DER: 16-byte header + 32-byte seed
+// Ed25519 SPKI DER:   12-byte header + 32-byte public key
+function generateTestApiKeySecret() {
+    const { privateKey, publicKey } = nodeCrypto.generateKeyPairSync('ed25519');
+    const pkcs8 = privateKey.export({ format: 'der', type: 'pkcs8' });
+    const seed = pkcs8.subarray(16, 48);
+    const spki = publicKey.export({ format: 'der', type: 'spki' });
+    const pubKeyBytes = spki.subarray(12, 44);
+    return Buffer.concat([seed, pubKeyBytes]).toString('base64');
+}
+const TEST_CDP_API_KEY_SECRET = generateTestApiKeySecret();
+// P-256 PKCS#8 DER (67 bytes)
+const TEST_CDP_WALLET_SECRET = Buffer.from([
+    // outer SEQUENCE (65 bytes)
+    0x30, 0x41,
+    // version INTEGER 0
+    0x02, 0x01, 0x00,
+    // AlgorithmIdentifier SEQUENCE (19 bytes)
+    0x30, 0x13,
+    // OID ecPublicKey (1.2.840.10045.2.1)
+    0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x02, 0x01,
+    // OID prime256v1 (1.2.840.10045.3.1.7)
+    0x06, 0x08, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x03, 0x01, 0x07,
+    // privateKey OCTET STRING (39 bytes)
+    0x04, 0x27,
+    // ECPrivateKey SEQUENCE (37 bytes)
+    0x30, 0x25,
+    // version INTEGER 1
+    0x02, 0x01, 0x01,
+    // privateKey OCTET STRING (32 bytes) — scalar 0x01...01 is in [1, n-1] for P-256
+    0x04, 0x20, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01,
+    0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01,
+]).toString('base64');
+// Mock global fetch
+const mockFetch = vi.fn();
+vi.stubGlobal('fetch', mockFetch);
+// Mock wire transaction (same real-structure tx used across keychain tests)
+const MOCK_B64_WIRE_TX = 'Af1fCRSrZ9ASprap8D3ZLPsbzeCs6uihvj/jfjm3UrAY72by5zKMRd7YAIbJCl9gyRHQbw+xdklET2ZNmZi3iA2AAQABAurnRuGN5bfL2osZZMdGlvL1qz8k0GbdLhiP1fICgkmsBUpTWpkpIQZNJOhxYNo4fHw1td28kruB5B+oQEEFRI1NhzEgE0w/YfwaeZi2Ns/mLoZvq2Sx5NVQg7Am7wrjGwEBAAxIZWxsbywgUHJpdnkA';
+vi.mock('@solana/transactions', async () => {
+    const actual = await vi.importActual('@solana/transactions');
+    return {
+        ...actual,
+        getBase64EncodedWireTransaction: vi.fn(() => MOCK_B64_WIRE_TX),
+    };
+});
+const createMockTransaction = () => {
+    return {};
+};
+// A valid base58 Solana address for tests
+const TEST_ADDRESS = '7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV';
+function makeConfig(overrides) {
+    return {
+        cdpApiKeyId: 'test-api-key-name',
+        cdpApiKeySecret: TEST_CDP_API_KEY_SECRET,
+        cdpWalletSecret: TEST_CDP_WALLET_SECRET,
+        address: TEST_ADDRESS,
+        ...overrides,
+    };
+}
+describe('CdpSigner', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    describe('create()', () => {
+        it('creates a CdpSigner with valid config', async () => {
+            const signer = await CdpSigner.create(makeConfig());
+            expect(signer.address).toBe(TEST_ADDRESS);
+            assertIsSolanaSigner(signer);
+            expect(signer.signMessages).toBeDefined();
+            expect(signer.signTransactions).toBeDefined();
+            expect(signer.isAvailable).toBeDefined();
+        });
+        it('throws CONFIG_ERROR for missing cdpApiKeyId', async () => {
+            await expect(CdpSigner.create(makeConfig({ cdpApiKeyId: '' }))).rejects.toThrow('Missing required cdpApiKeyId field');
+        });
+        it('throws CONFIG_ERROR for missing cdpApiKeySecret', async () => {
+            await expect(CdpSigner.create(makeConfig({ cdpApiKeySecret: '' }))).rejects.toThrow('Missing required cdpApiKeySecret field');
+        });
+        it('throws CONFIG_ERROR for missing cdpWalletSecret', async () => {
+            await expect(CdpSigner.create(makeConfig({ cdpWalletSecret: '' }))).rejects.toThrow('Missing required cdpWalletSecret field');
+        });
+        it('throws CONFIG_ERROR for missing address', async () => {
+            await expect(CdpSigner.create(makeConfig({ address: '' }))).rejects.toThrow('Missing required address field');
+        });
+        it('throws CONFIG_ERROR for invalid address', async () => {
+            await expect(CdpSigner.create(makeConfig({ address: 'not-a-valid-address' }))).rejects.toThrow('Invalid Solana address format');
+        });
+        it('throws CONFIG_ERROR for negative requestDelayMs', async () => {
+            await expect(CdpSigner.create(makeConfig({ requestDelayMs: -1 }))).rejects.toThrow('requestDelayMs must not be negative');
+        });
+        it('warns for high requestDelayMs', async () => {
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            await CdpSigner.create(makeConfig({ requestDelayMs: 5000 }));
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('requestDelayMs is greater than 3000ms'));
+            warnSpy.mockRestore();
+        });
+        it('accepts custom baseUrl', async () => {
+            const signer = await CdpSigner.create(makeConfig({ baseUrl: 'https://custom.example.com' }));
+            expect(signer).toBeDefined();
+        });
+        it('throws CONFIG_ERROR when baseUrl is not a valid URL', async () => {
+            await expect(CdpSigner.create(makeConfig({ baseUrl: 'not-a-url' }))).rejects.toMatchObject({
+                code: 'SIGNER_CONFIG_ERROR',
+                message: expect.stringContaining('baseUrl is not a valid URL'),
+            });
+        });
+        it('throws CONFIG_ERROR when baseUrl does not use HTTPS', async () => {
+            await expect(CdpSigner.create(makeConfig({ baseUrl: 'http://api.cdp.coinbase.com' }))).rejects.toMatchObject({
+                code: 'SIGNER_CONFIG_ERROR',
+                message: expect.stringContaining('baseUrl must use HTTPS'),
+            });
+        });
+        it('accepts requestDelayMs of 0', async () => {
+            const signer = await CdpSigner.create(makeConfig({ requestDelayMs: 0 }));
+            expect(signer).toBeDefined();
+        });
+        it('throws CONFIG_ERROR when Ed25519 pubkey does not match seed', async () => {
+            // 64 bytes where seed and pubkey are mismatched (all 0x42)
+            const mismatchedKey = Buffer.alloc(64, 0x42).toString('base64');
+            await expect(CdpSigner.create(makeConfig({ cdpApiKeySecret: mismatchedKey }))).rejects.toThrow('Invalid cdpApiKeySecret');
+        });
+    });
+    describe('signMessages', () => {
+        it('signs a message and returns a signature dictionary', async () => {
+            // Base58-encoded 64-byte signature
+            const base58Sig = '5LfnqEfGPFBaHHeQBiNkgQ2EPy4FkVLKE7cjMYc7gv6EjE8Vs5gqaXcZHjpxr3yj5TMt7j3JdJPkXfnwXxXiNAh';
+            mockFetch.mockResolvedValue(new Response(JSON.stringify({ signature: base58Sig }), { status: 200 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const message = { content: new TextEncoder().encode('hello'), signatures: {} };
+            const result = await signer.signMessages([message]);
+            expect(result).toHaveLength(1);
+            expect(result[0]?.[TEST_ADDRESS]).toBeDefined();
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [url, init] = mockFetch.mock.calls[0];
+            expect(url).toContain('/sign/message');
+            expect(JSON.parse(init.body)).toMatchObject({ message: 'hello' });
+        });
+        it('handles multiple messages with requestDelayMs', async () => {
+            const base58Sig = '5LfnqEfGPFBaHHeQBiNkgQ2EPy4FkVLKE7cjMYc7gv6EjE8Vs5gqaXcZHjpxr3yj5TMt7j3JdJPkXfnwXxXiNAh';
+            // Use mockImplementation so each concurrent call gets a fresh Response (body can only be read once)
+            mockFetch.mockImplementation(() => Promise.resolve(new Response(JSON.stringify({ signature: base58Sig }), { status: 200 })));
+            const signer = await CdpSigner.create(makeConfig({ requestDelayMs: 10 }));
+            const messages = [
+                { content: new TextEncoder().encode('one'), signatures: {} },
+                { content: new TextEncoder().encode('two'), signatures: {} },
+            ];
+            const startTime = Date.now();
+            const result = await signer.signMessages(messages);
+            const elapsed = Date.now() - startTime;
+            expect(result).toHaveLength(2);
+            expect(elapsed).toBeGreaterThanOrEqual(8); // at least one 10ms delay
+        });
+        it('throws HTTP_ERROR on network failure', async () => {
+            mockFetch.mockRejectedValue(new Error('Network error'));
+            const signer = await CdpSigner.create(makeConfig());
+            const message = { content: new TextEncoder().encode('hello'), signatures: {} };
+            await expect(signer.signMessages([message])).rejects.toThrow('CDP signMessage network request failed');
+        });
+        it('throws REMOTE_API_ERROR on non-2xx response', async () => {
+            mockFetch.mockResolvedValue(new Response('{"error":"Unauthorized"}', { status: 401 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const message = { content: new TextEncoder().encode('hello'), signatures: {} };
+            await expect(signer.signMessages([message])).rejects.toThrow('CDP signMessage API error: 401');
+        });
+        it('throws SIGNING_FAILED for invalid signature length', async () => {
+            // Return a base58 string that decodes to != 64 bytes (small value)
+            mockFetch.mockResolvedValue(new Response(JSON.stringify({ signature: '1' }), { status: 200 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const message = { content: new TextEncoder().encode('hello'), signatures: {} };
+            await expect(signer.signMessages([message])).rejects.toThrow('Invalid signature length');
+        });
+        it('throws SERIALIZATION_ERROR for invalid UTF-8 message', async () => {
+            const signer = await CdpSigner.create(makeConfig());
+            const message = { content: new Uint8Array([0xff]), signatures: {} };
+            await expect(signer.signMessages([message])).rejects.toThrow('CDP signMessage requires a valid UTF-8 message');
+        });
+    });
+    describe('signTransactions', () => {
+        it('accepts a key pair address as the signer address', async () => {
+            const keyPair = await generateKeyPairSigner();
+            const signer = await CdpSigner.create(makeConfig({ address: keyPair.address }));
+            expect(signer.address).toBe(keyPair.address);
+        });
+        it('calls CDP signTransaction with the correct address and wire transaction', async () => {
+            mockFetch.mockResolvedValue(new Response(JSON.stringify({ signedTransaction: MOCK_B64_WIRE_TX }), { status: 200 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const mockTx = createMockTransaction();
+            // The CDP call succeeds; extractSignatureFromWireTransaction throws because
+            // MOCK_B64_WIRE_TX was not signed by TEST_ADDRESS (integration tests cover success path)
+            await expect(signer.signTransactions([mockTx])).rejects.toThrow();
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [url, init] = mockFetch.mock.calls[0];
+            expect(url).toContain('/sign/transaction');
+            expect(JSON.parse(init.body)).toMatchObject({ transaction: MOCK_B64_WIRE_TX });
+        });
+        it('throws HTTP_ERROR on network failure', async () => {
+            mockFetch.mockRejectedValue(new Error('Network error'));
+            const signer = await CdpSigner.create(makeConfig());
+            const mockTx = createMockTransaction();
+            await expect(signer.signTransactions([mockTx])).rejects.toThrow('CDP signTransaction network request failed');
+        });
+        it('throws REMOTE_API_ERROR on non-2xx response', async () => {
+            mockFetch.mockResolvedValue(new Response('{"error":"Forbidden"}', { status: 403 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const mockTx = createMockTransaction();
+            await expect(signer.signTransactions([mockTx])).rejects.toThrow('CDP signTransaction API error: 403');
+        });
+    });
+    describe('isAvailable', () => {
+        it('returns true when the account is accessible', async () => {
+            mockFetch.mockResolvedValue(new Response(JSON.stringify({ address: TEST_ADDRESS }), { status: 200 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const available = await signer.isAvailable();
+            expect(available).toBe(true);
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [url] = mockFetch.mock.calls[0];
+            expect(url).toContain(TEST_ADDRESS);
+        });
+        it('returns false when the account is not found', async () => {
+            mockFetch.mockResolvedValue(new Response('', { status: 404 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const available = await signer.isAvailable();
+            expect(available).toBe(false);
+        });
+        it('returns false when the CDP API is unreachable', async () => {
+            mockFetch.mockRejectedValue(new Error('Network error'));
+            const signer = await CdpSigner.create(makeConfig());
+            const available = await signer.isAvailable();
+            expect(available).toBe(false);
+        });
+        it('returns false on 401 unauthorized', async () => {
+            mockFetch.mockResolvedValue(new Response('', { status: 401 }));
+            const signer = await CdpSigner.create(makeConfig());
+            const available = await signer.isAvailable();
+            expect(available).toBe(false);
+        });
+        it('returns false when auth header generation fails', async () => {
+            const signer = await CdpSigner.create(makeConfig());
+            const subtleSignSpy = vi
+                .spyOn(globalThis.crypto.subtle, 'sign')
+                .mockRejectedValueOnce(new Error('sign failed'));
+            const available = await signer.isAvailable();
+            expect(available).toBe(false);
+            expect(mockFetch).not.toHaveBeenCalled();
+            subtleSignSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=cdp-signer.test.js.map

package/dist/__tests__/cdp-signer.test.js.map

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

package/dist/__tests__/setup.d.ts

@@ -0,0 +1,4 @@
+import type { SolanaSigner } from '@solana/keychain-core';
+import type { SignerTestConfig, TestScenario } from '@solana/keychain-test-utils';
+export declare function getConfig(scenarios: TestScenario[]): Promise<SignerTestConfig<SolanaSigner>>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAmBlF,wBAAsB,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAKlG"}

package/dist/__tests__/setup.js

@@ -0,0 +1,20 @@
+import { createCdpSigner } from '../cdp-signer.js';
+const SIGNER_TYPE = 'cdp';
+const REQUIRED_ENV_VARS = ['CDP_API_KEY_ID', 'CDP_API_KEY_SECRET', 'CDP_WALLET_SECRET', 'CDP_SOLANA_ADDRESS'];
+const CONFIG = {
+    createSigner: () => createCdpSigner({
+        cdpApiKeyId: process.env.CDP_API_KEY_ID,
+        cdpApiKeySecret: process.env.CDP_API_KEY_SECRET,
+        cdpWalletSecret: process.env.CDP_WALLET_SECRET,
+        address: process.env.CDP_SOLANA_ADDRESS,
+    }),
+    requiredEnvVars: REQUIRED_ENV_VARS,
+    signerType: SIGNER_TYPE,
+};
+export async function getConfig(scenarios) {
+    return {
+        ...CONFIG,
+        testScenarios: scenarios,
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/__tests__/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,iBAAiB,GAAG,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,CAAC,CAAC;AAE9G,MAAM,MAAM,GAAmC;IAC3C,YAAY,EAAE,GAAG,EAAE,CACf,eAAe,CAAC;QACZ,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,cAAe;QACxC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAmB;QAChD,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAkB;QAC/C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAmB;KAC3C,CAAC;IACN,eAAe,EAAE,iBAAiB;IAClC,UAAU,EAAE,WAAW;CAC1B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAyB;IACrD,OAAO;QACH,GAAG,MAAM;QACT,aAAa,EAAE,SAAS;KAC3B,CAAC;AACN,CAAC"}

package/dist/cdp-signer.d.ts

@@ -0,0 +1,85 @@
+import { Address } from '@solana/addresses';
+import { SolanaSigner } from '@solana/keychain-core';
+import type { SignableMessage, SignatureDictionary } from '@solana/signers';
+import { type Transaction, type TransactionWithinSizeLimit, type TransactionWithLifetime } from '@solana/transactions';
+import type { CdpSignerConfig } from './types.js';
+/**
+ * Create and initialize a CDP-backed signer.
+ *
+ * @throws {SignerError} `SIGNER_CONFIG_ERROR` when required config is missing or invalid.
+ */
+export declare function createCdpSigner<TAddress extends string = string>(config: CdpSignerConfig): Promise<SolanaSigner<TAddress>>;
+/**
+ * CDP-based Solana signer using Coinbase Developer Platform's managed key infrastructure.
+ *
+ * Makes direct HTTP calls to the CDP REST API — no vendor SDK required.
+ * Authentication uses two JWTs per signing request:
+ * - `Authorization: Bearer <jwt>` — signed with the CDP API private key (Ed25519)
+ * - `X-Wallet-Auth: <jwt>` — signed with the wallet secret (always ES256)
+ *
+ * The CDP account address must be provided at construction time.
+ * Use CDP's API or dashboard to create a Solana account first.
+ *
+ * Use the static `create()` factory to construct an instance — it validates the
+ * Ed25519 key pair (seed↔pubkey match) and loads both keys asynchronously.
+ *
+ * @example
+ * ```typescript
+ * const signer = await CdpSigner.create({
+ *   cdpApiKeyId: process.env.CDP_API_KEY_ID!,
+ *   cdpApiKeySecret: process.env.CDP_API_KEY_SECRET!,
+ *   cdpWalletSecret: process.env.CDP_WALLET_SECRET!,
+ *   address: process.env.CDP_SOLANA_ADDRESS!,
+ * });
+ * const signed = await signTransactionMessageWithSigners(transactionMessage, [signer]);
+ * ```
+ *
+ * @deprecated Prefer `createCdpSigner()`. Class export will be removed in a future version.
+ */
+export declare class CdpSigner<TAddress extends string = string> implements SolanaSigner<TAddress> {
+    readonly address: Address<TAddress>;
+    private readonly apiKeyId;
+    private readonly apiKey;
+    private readonly walletKey;
+    private readonly apiHost;
+    private readonly baseUrl;
+    private readonly requestDelayMs;
+    private constructor();
+    /**
+     * Create and initialize a CdpSigner.
+     *
+     * Validates the Ed25519 API key (seed↔pubkey match via `createKeyPairFromBytes`)
+     * and loads the P-256 wallet key. Both keys are loaded in parallel.
+     * @deprecated Use `createCdpSigner()` instead.
+     */
+    static create<TAddress extends string = string>(config: CdpSignerConfig): Promise<CdpSigner<TAddress>>;
+    private delay;
+    private decodeMessageBytes;
+    private buildPostHeaders;
+    private buildGetHeaders;
+    /**
+     * Sign a UTF-8 message string using the CDP API.
+     * @returns The 64-byte Ed25519 signature.
+     */
+    private callSignMessage;
+    /**
+     * Sign a base64-encoded wire transaction using the CDP API.
+     * @returns The fully-signed wire transaction (base64-encoded).
+     */
+    private callSignTransaction;
+    /**
+     * Sign multiple messages using the CDP API.
+     * Message bytes are decoded as UTF-8 before sending to the CDP signMessage endpoint.
+     */
+    signMessages(messages: readonly SignableMessage[]): Promise<readonly SignatureDictionary[]>;
+    /**
+     * Sign multiple transactions using the CDP API.
+     * Returns the signature extracted from the fully-signed wire transaction.
+     */
+    signTransactions(transactions: readonly (Transaction & TransactionWithinSizeLimit & TransactionWithLifetime)[]): Promise<readonly SignatureDictionary[]>;
+    /**
+     * Check if the CDP API is reachable and this specific account is accessible.
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=cdp-signer.d.ts.map

package/dist/cdp-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-signer.d.ts","sourceRoot":"","sources":["../src/cdp-signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAOH,YAAY,EAEf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAgD,MAAM,YAAY,CAAC;AAEhG;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAClE,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAEjC;AAkJD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,SAAS,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,CAAE,YAAW,YAAY,CAAC,QAAQ,CAAC;IACtF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO;IAkBP;;;;;;OAMG;WACU,MAAM,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAoE9F,KAAK;IAMnB,OAAO,CAAC,kBAAkB;YAYZ,gBAAgB;YAYhB,eAAe;IAO7B;;;OAGG;YACW,eAAe;IAqD7B;;;OAGG;YACW,mBAAmB;IA6CjC;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAmBjG;;;OAGG;IACG,gBAAgB,CAClB,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,0BAA0B,GAAG,uBAAuB,CAAC,EAAE,GAC9F,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IA2B1C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAaxC"}