@solana/keychain-dfns 0.0.0 → 1.0.1

package/dist/dfns-signer.js

@@ -0,0 +1,392 @@
+import { assertIsAddress } from '@solana/addresses';
+import { getBase16Decoder, getBase16Encoder, getBase58Decoder } from '@solana/codecs-strings';
+import { assertSignatureValid, createSignatureDictionary, sanitizeRemoteErrorResponse, SignerErrorCode, throwSignerError, } from '@solana/keychain-core';
+import { getTransactionEncoder, } from '@solana/transactions';
+import { signUserAction } from './auth.js';
+/**
+ * Create and initialize a Dfns-backed signer.
+ *
+ * @throws {SignerError} `SIGNER_CONFIG_ERROR` when required config is missing or invalid.
+ * @throws {SignerError} `SIGNER_HTTP_ERROR`, `SIGNER_REMOTE_API_ERROR`, `SIGNER_PARSING_ERROR`,
+ * or `SIGNER_INVALID_PUBLIC_KEY` when initialization fails.
+ */
+export async function createDfnsSigner(config) {
+    return await DfnsSigner.create(config);
+}
+const DEFAULT_API_BASE_URL = 'https://api.dfns.io';
+let base16Encoder;
+let base16Decoder;
+let base58Decoder;
+function hexToBytes(hex) {
+    base16Encoder || (base16Encoder = getBase16Encoder());
+    const clean = hex.startsWith('0x') ? hex.slice(2) : hex;
+    return new Uint8Array(base16Encoder.encode(clean));
+}
+function bytesToHex(bytes) {
+    base16Decoder || (base16Decoder = getBase16Decoder());
+    return base16Decoder.decode(bytes);
+}
+function bytesToBase58(bytes) {
+    base58Decoder || (base58Decoder = getBase58Decoder());
+    return base58Decoder.decode(bytes);
+}
+/**
+ * Dfns-based signer for Solana transactions.
+ *
+ * Uses Dfns Keys API to sign Solana transactions and messages.
+ * Requires a Dfns account with an active Ed25519 Solana wallet.
+ *
+ * Use the static `create()` factory to construct an instance — it validates
+ * the wallet status, key scheme, and curve via the Dfns API.
+ *
+ * @example
+ * ```typescript
+ * const signer = await DfnsSigner.create({
+ *   authToken: 'your-service-account-token',
+ *   credId: 'your-credential-id',
+ *   privateKeyPem: '-----BEGIN PRIVATE KEY-----\n...',
+ *   walletId: 'your-wallet-id',
+ * });
+ * const signed = await signTransactionMessageWithSigners(transactionMessage, [signer]);
+ * ```
+ *
+ * @deprecated Prefer `createDfnsSigner()`. Class export will be removed in a future version.
+ */
+export class DfnsSigner {
+    constructor(config) {
+        this.address = config.address;
+        this.authToken = config.authToken;
+        this.credId = config.credId;
+        this.privateKeyPem = config.privateKeyPem;
+        this.walletId = config.walletId;
+        this.apiBaseUrl = config.apiBaseUrl;
+        this.keyId = config.keyId;
+        this.requestDelayMs = config.requestDelayMs;
+    }
+    /**
+     * Create and initialize a DfnsSigner.
+     *
+     * Validates config fields, fetches the wallet from Dfns, and checks that
+     * the wallet is active with an EdDSA/ed25519 signing key.
+     * @deprecated Use `createDfnsSigner()` instead.
+     */
+    static async create(config) {
+        if (!config.authToken) {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: 'Missing required authToken field',
+            });
+        }
+        if (!config.credId) {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: 'Missing required credId field',
+            });
+        }
+        if (!config.privateKeyPem) {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: 'Missing required privateKeyPem field',
+            });
+        }
+        if (!config.walletId) {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: 'Missing required walletId field',
+            });
+        }
+        const apiBaseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+        validateHttpsApiBaseUrl(apiBaseUrl);
+        const requestDelayMs = config.requestDelayMs ?? 0;
+        if (requestDelayMs < 0) {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: 'requestDelayMs must not be negative',
+            });
+        }
+        if (requestDelayMs > 3000) {
+            console.warn('requestDelayMs is greater than 3000ms, this may result in blockhash expiration errors for signing messages/transactions');
+        }
+        const wallet = await fetchWallet(apiBaseUrl, config.authToken, config.walletId);
+        if (wallet.status !== 'Active') {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: `Wallet is not active: ${wallet.status}`,
+            });
+        }
+        if (wallet.signingKey.scheme !== 'EdDSA') {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: `Unsupported key scheme: ${wallet.signingKey.scheme} (expected EdDSA)`,
+            });
+        }
+        if (wallet.signingKey.curve !== 'ed25519') {
+            throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+                message: `Unsupported key curve: ${wallet.signingKey.curve} (expected ed25519)`,
+            });
+        }
+        const pubkeyBytes = hexToBytes(wallet.signingKey.publicKey);
+        const bs58Address = bytesToBase58(pubkeyBytes);
+        let address;
+        try {
+            assertIsAddress(bs58Address);
+            address = bs58Address;
+        }
+        catch (error) {
+            throwSignerError(SignerErrorCode.INVALID_PUBLIC_KEY, {
+                cause: error,
+                message: 'Invalid public key from Dfns wallet',
+            });
+        }
+        return new DfnsSigner({
+            address,
+            apiBaseUrl,
+            authToken: config.authToken,
+            credId: config.credId,
+            keyId: wallet.signingKey.id,
+            privateKeyPem: config.privateKeyPem,
+            requestDelayMs,
+            walletId: config.walletId,
+        });
+    }
+    async delay(index) {
+        if (this.requestDelayMs > 0 && index > 0) {
+            await new Promise(resolve => setTimeout(resolve, index * this.requestDelayMs));
+        }
+    }
+    /**
+     * Sign multiple messages using Dfns
+     */
+    async signMessages(messages) {
+        return await Promise.all(messages.map(async (message, index) => {
+            await this.delay(index);
+            const messageBytes = message.content instanceof Uint8Array
+                ? message.content
+                : new Uint8Array(Array.from(message.content));
+            const signatureBytes = await this.sendSignatureRequest({
+                kind: 'Message',
+                message: `0x${bytesToHex(messageBytes)}`,
+            });
+            await assertSignatureValid({
+                data: messageBytes,
+                signature: signatureBytes,
+                signerAddress: this.address,
+            });
+            return createSignatureDictionary({
+                signature: signatureBytes,
+                signerAddress: this.address,
+            });
+        }));
+    }
+    /**
+     * Sign multiple transactions using Dfns
+     */
+    async signTransactions(transactions) {
+        const txEncoder = getTransactionEncoder();
+        return await Promise.all(transactions.map(async (transaction, index) => {
+            await this.delay(index);
+            const txBytes = txEncoder.encode(transaction);
+            const signatureBytes = await this.sendSignatureRequest({
+                blockchainKind: 'Solana',
+                kind: 'Transaction',
+                transaction: `0x${bytesToHex(new Uint8Array(txBytes))}`,
+            });
+            await assertSignatureValid({
+                data: transaction.messageBytes,
+                signature: signatureBytes,
+                signerAddress: this.address,
+            });
+            return createSignatureDictionary({
+                signature: signatureBytes,
+                signerAddress: this.address,
+            });
+        }));
+    }
+    /**
+     * Check if Dfns API is available
+     */
+    async isAvailable() {
+        try {
+            await fetchWallet(this.apiBaseUrl, this.authToken, this.walletId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Send a signature request to the Dfns Keys API
+     */
+    async sendSignatureRequest(request) {
+        const httpPath = `/keys/${this.keyId}/signatures`;
+        const requestBody = JSON.stringify(request);
+        const userAction = await signUserAction(this.apiBaseUrl, this.authToken, this.credId, this.privateKeyPem, 'POST', httpPath, requestBody);
+        const url = `${this.apiBaseUrl}${httpPath}`;
+        let response;
+        try {
+            response = await fetch(url, {
+                body: requestBody,
+                headers: {
+                    Authorization: `Bearer ${this.authToken}`,
+                    'Content-Type': 'application/json',
+                    'x-dfns-useraction': userAction,
+                },
+                method: 'POST',
+            });
+        }
+        catch (error) {
+            throwSignerError(SignerErrorCode.HTTP_ERROR, {
+                cause: error,
+                message: 'Dfns network request failed',
+                url,
+            });
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Failed to read error response');
+            throwSignerError(SignerErrorCode.REMOTE_API_ERROR, {
+                message: `Dfns signing API error: ${response.status}`,
+                response: sanitizeRemoteErrorResponse(errorText),
+                status: response.status,
+            });
+        }
+        let rawSigResponse;
+        try {
+            rawSigResponse = await response.json();
+        }
+        catch (error) {
+            throwSignerError(SignerErrorCode.PARSING_ERROR, {
+                cause: error,
+                message: 'Failed to parse Dfns signature response',
+            });
+        }
+        const sigResponse = parseSignatureResponse(rawSigResponse);
+        if (sigResponse.status === 'Failed') {
+            throwSignerError(SignerErrorCode.SIGNING_FAILED, {
+                message: 'Dfns signing failed',
+            });
+        }
+        if (sigResponse.status !== 'Signed') {
+            throwSignerError(SignerErrorCode.SIGNING_FAILED, {
+                message: `Unexpected signature status: ${sigResponse.status} (may require policy approval)`,
+            });
+        }
+        if (!sigResponse.signature) {
+            throwSignerError(SignerErrorCode.SIGNING_FAILED, {
+                message: 'Signature components missing from response',
+            });
+        }
+        return combineSignature(sigResponse.signature.r, sigResponse.signature.s);
+    }
+}
+/**
+ * Fetch wallet details from Dfns
+ */
+async function fetchWallet(apiBaseUrl, authToken, walletId) {
+    const url = `${apiBaseUrl}/wallets/${walletId}`;
+    let response;
+    try {
+        response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${authToken}`,
+            },
+            method: 'GET',
+        });
+    }
+    catch (error) {
+        throwSignerError(SignerErrorCode.HTTP_ERROR, {
+            cause: error,
+            message: 'Dfns network request failed',
+            url,
+        });
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => 'Failed to read error response');
+        throwSignerError(SignerErrorCode.REMOTE_API_ERROR, {
+            message: `Dfns API error: ${response.status}`,
+            response: sanitizeRemoteErrorResponse(errorText),
+            status: response.status,
+        });
+    }
+    let rawWalletResponse;
+    try {
+        rawWalletResponse = await response.json();
+    }
+    catch (error) {
+        throwSignerError(SignerErrorCode.PARSING_ERROR, {
+            cause: error,
+            message: 'Failed to parse Dfns wallet response',
+        });
+    }
+    return parseWalletResponse(rawWalletResponse);
+}
+function validateHttpsApiBaseUrl(apiBaseUrl) {
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(apiBaseUrl);
+    }
+    catch {
+        throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+            message: 'apiBaseUrl is not a valid URL',
+        });
+    }
+    if (parsedUrl.protocol !== 'https:') {
+        throwSignerError(SignerErrorCode.CONFIG_ERROR, {
+            message: 'apiBaseUrl must use HTTPS',
+        });
+    }
+}
+function parseSignatureResponse(raw) {
+    if (!isObject(raw) || typeof raw.status !== 'string') {
+        throwSignerError(SignerErrorCode.PARSING_ERROR, {
+            message: 'Unexpected Dfns signature response shape',
+        });
+    }
+    if (raw.signature !== undefined) {
+        if (!isObject(raw.signature) || typeof raw.signature.r !== 'string' || typeof raw.signature.s !== 'string') {
+            throwSignerError(SignerErrorCode.PARSING_ERROR, {
+                message: 'Unexpected Dfns signature components shape',
+            });
+        }
+    }
+    return raw;
+}
+function parseWalletResponse(raw) {
+    if (!isObject(raw) || typeof raw.status !== 'string' || !isObject(raw.signingKey)) {
+        throwSignerError(SignerErrorCode.PARSING_ERROR, {
+            message: 'Unexpected Dfns wallet response shape',
+        });
+    }
+    if (typeof raw.signingKey.id !== 'string' ||
+        typeof raw.signingKey.scheme !== 'string' ||
+        typeof raw.signingKey.curve !== 'string' ||
+        typeof raw.signingKey.publicKey !== 'string') {
+        throwSignerError(SignerErrorCode.PARSING_ERROR, {
+            message: 'Unexpected Dfns wallet signing key shape',
+        });
+    }
+    return raw;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Pad signature component to exactly 32 bytes.
+ * Components from Dfns may be shorter than 32 bytes and need left-padding with zeros.
+ */
+function padSignatureComponent(hex) {
+    const bytes = hexToBytes(hex);
+    if (bytes.length > 32) {
+        throwSignerError(SignerErrorCode.SIGNING_FAILED, {
+            message: `Invalid signature component length: ${bytes.length} (max 32)`,
+        });
+    }
+    const padded = new Uint8Array(32);
+    padded.set(bytes, 32 - bytes.length);
+    return padded;
+}
+/**
+ * Combine r and s hex-encoded components into a 64-byte Ed25519 signature.
+ * Each component is individually validated and left-padded to 32 bytes.
+ */
+function combineSignature(r, s) {
+    const rBytes = padSignatureComponent(r);
+    const sBytes = padSignatureComponent(s);
+    const combined = new Uint8Array(64);
+    combined.set(rBytes, 0);
+    combined.set(sBytes, 32);
+    return combined;
+}
+//# sourceMappingURL=dfns-signer.js.map

package/dist/dfns-signer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DfnsSigner, createDfnsSigner } from './dfns-signer.js';
+export type { DfnsSignerConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { DfnsSigner, createDfnsSigner } from './dfns-signer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Configuration for creating a DfnsSigner
+ */
+export interface DfnsSignerConfig {
+    /** API base URL (default: "https://api.dfns.io") */
+    apiBaseUrl?: string;
+    /** Service account token or personal access token */
+    authToken: string;
+    /** Credential ID for user action signing */
+    credId: string;
+    /** Private key in PEM format for signing user action challenges (Ed25519, P256, or RSA) */
+    privateKeyPem: string;
+    /** Optional delay in ms between concurrent signing requests to avoid rate limits (default: 0) */
+    requestDelayMs?: number;
+    /** Dfns wallet ID */
+    walletId: string;
+}
+/**
+ * Dfns wallet response
+ */
+export interface GetWalletResponse {
+    id: string;
+    signingKey: {
+        curve: string;
+        id: string;
+        publicKey: string;
+        scheme: string;
+    };
+    status: string;
+}
+/**
+ * Message signature request body for Dfns Keys API
+ */
+export interface GenerateMessageSignatureRequest {
+    kind: 'Message';
+    message: string;
+}
+/**
+ * Transaction signature request body for Dfns Keys API
+ */
+export interface GenerateTransactionSignatureRequest {
+    blockchainKind: string;
+    kind: 'Transaction';
+    transaction: string;
+}
+export type GenerateSignatureRequest = GenerateMessageSignatureRequest | GenerateTransactionSignatureRequest;
+/**
+ * Signature response from Dfns Keys API
+ */
+export interface GenerateSignatureResponse {
+    id: string;
+    signature?: SignatureComponents;
+    signedData?: string;
+    status: string;
+}
+export interface SignatureComponents {
+    r: string;
+    s: string;
+}
+/**
+ * User action challenge init request
+ */
+export interface UserActionInitRequest {
+    userActionHttpMethod: string;
+    userActionHttpPath: string;
+    userActionPayload: string;
+    userActionServerKind: string;
+}
+/**
+ * User action challenge init response
+ */
+export interface UserActionInitResponse {
+    allowCredentials: {
+        key: Array<{
+            id: string;
+        }>;
+    };
+    challenge: string;
+    challengeIdentifier: string;
+}
+/**
+ * User action sign request
+ */
+export interface UserActionSignRequest {
+    challengeIdentifier: string;
+    firstFactor: {
+        credentialAssertion: {
+            clientData: string;
+            credId: string;
+            signature: string;
+        };
+        kind: string;
+    };
+}
+/**
+ * User action sign response
+ */
+export interface UserActionResponse {
+    userAction: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,2FAA2F;IAC3F,aAAa,EAAE,MAAM,CAAC;IAEtB,iGAAiG;IACjG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC5C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,GAAG,mCAAmC,CAAC;AAE7G;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,gBAAgB,EAAE;QACd,GAAG,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9B,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE;QACT,mBAAmB,EAAE;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,65 @@
 {
   "name": "@solana/keychain-dfns",
-  "version": "0.0.0",
-  "description": "",
-  "license": "ISC",
-  "author": "",
-  "type": "commonjs",
-  "main": "index.js",
+  "author": "Solana Foundation",
+  "version": "1.0.1",
+  "description": "Dfns-based signer for Solana transactions",
+  "license": "MIT",
+  "repository": "https://github.com/solana-foundation/solana-keychain",
+  "keywords": [
+    "solana",
+    "signing",
+    "wallet",
+    "dfns",
+    "ed25519",
+    "eddsa"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@solana/keychain-core": "1.0.1"
+  },
+  "peerDependencies": {
+    "@solana/addresses": ">=6.0.1",
+    "@solana/codecs-strings": ">=6.0.1",
+    "@solana/keys": ">=6.0.1",
+    "@solana/signers": ">=6.0.1",
+    "@solana/transactions": ">=6.0.1"
+  },
+  "devDependencies": {
+    "@solana/addresses": "^6.0.1",
+    "@solana/codecs-strings": "^6.0.1",
+    "@solana/keys": "^6.0.1",
+    "@solana/kit": "^6.0.1",
+    "@solana/signers": "^6.0.1",
+    "@solana/transactions": "^6.0.1",
+    "dotenv": "^17.2.3",
+    "@solana/keychain-test-utils": "1.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run",
+    "test:unit": "vitest run --config ../../vitest.config.unit.ts",
+    "test:integration": "vitest run --config ../../vitest.config.integration.ts",
+    "test:watch": "vitest",
+    "test:watch:unit": "vitest --config ../../vitest.config.unit.ts",
+    "test:watch:integration": "vitest --config ../../vitest.config.integration.ts",
+    "typecheck": "tsc --noEmit",
+    "test:treeshakability": "agadoo dist/index.js"
   }
-}
+}

package/src/__tests__/dfns-signer.integration.test.ts

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