@solana/connector 0.2.4 → 0.2.6

package/dist/chunk-QST7XLMB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/remote/protocol.ts"],"names":[],"mappings":";;;AAqLO,SAAS,gBAAgB,QAAA,EAA0D;AACtF,EAAA,OACI,OAAO,YAAa,QAAA,IACpB,QAAA,KAAa,QACb,OAAA,IAAW,QAAA,IACX,OAAQ,QAAA,CAAuC,KAAA,IAAU,QAAA;AAEjE;AA4BO,SAAS,aAAa,KAAA,EAA2B;AACpD,EAAA,IAAI,OAAO,MAAA,GAAW,GAAA;AAClB,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,SAAS,QAAQ,CAAA;AAG/C,EAAA,IAAM,MAAA,GAAS,KAAA,CAAM,IAAA,CAAK,KAAK,CAAA,CAC1B,GAAA,CAAI,CAAA,CAAA,KAAK,MAAA,CAAO,YAAA,CAAa,CAAC,CAAC,CAAA,CAC/B,KAAK,EAAE,CAAA;AACZ,EAAA,OAAO,KAAK,MAAM,CAAA;AACtB;AAKO,SAAS,aAAa,MAAA,EAA4B;AACrD,EAAA,IAAI,OAAO,MAAA,GAAW,GAAA;AAClB,IAAA,OAAO,IAAI,UAAA,CAAW,MAAA,CAAO,IAAA,CAAK,MAAA,EAAQ,QAAQ,CAAC,CAAA;AAGvD,EAAA,IAAM,MAAA,GAAS,KAAK,MAAM,CAAA,EACpB,QAAQ,IAAI,UAAA,CAAW,OAAO,MAAM,CAAA;AAC1C,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,MAAA,EAAQ,CAAA,EAAA;AAC/B,IAAA,KAAA,CAAM,CAAC,CAAA,GAAI,MAAA,CAAO,UAAA,CAAW,CAAC,CAAA;AAElC,EAAA,OAAO,KAAA;AACX","file":"chunk-QST7XLMB.js","sourcesContent":["/**\n * @solana/connector/remote - Protocol Types\n *\n * Defines the HTTP protocol for communication between the browser-side\n * remote wallet adapter and the server-side signer endpoint.\n *\n * All byte payloads use base64 encoding for JSON transport.\n */\n\n// ============================================================================\n// Metadata (GET response)\n// ============================================================================\n\n/**\n * Capabilities advertised by the remote signer\n */\nexport interface RemoteSignerCapabilities {\n    /** Supports signing individual transactions */\n    signTransaction: boolean;\n    /** Supports batch signing multiple transactions */\n    signAllTransactions: boolean;\n    /** Supports signing arbitrary messages */\n    signMessage: boolean;\n    /** Supports sign + send in one operation (server broadcasts) */\n    signAndSendTransaction: boolean;\n}\n\n/**\n * Response from GET /signer endpoint\n * Returns signer metadata and capabilities\n */\nexport interface RemoteSignerMetadata {\n    /** Signer's Solana address (base58) */\n    address: string;\n    /** Supported Solana chains (e.g., ['solana:mainnet', 'solana:devnet']) */\n    chains: string[];\n    /** Signer capabilities */\n    capabilities: RemoteSignerCapabilities;\n    /** Optional human-readable name */\n    name?: string;\n    /** Optional icon URL (data URI or https) */\n    icon?: string;\n}\n\n// ============================================================================\n// Operations (POST request/response)\n// ============================================================================\n\n/**\n * Base request structure for all POST operations\n */\nexport interface RemoteSignerRequestBase {\n    /** Operation type */\n    operation: 'signTransaction' | 'signAllTransactions' | 'signMessage' | 'signAndSendTransaction';\n}\n\n/**\n * Sign a single transaction\n */\nexport interface SignTransactionRequest extends RemoteSignerRequestBase {\n    operation: 'signTransaction';\n    /** Base64-encoded transaction bytes */\n    transaction: string;\n}\n\n/**\n * Sign multiple transactions\n */\nexport interface SignAllTransactionsRequest extends RemoteSignerRequestBase {\n    operation: 'signAllTransactions';\n    /** Array of base64-encoded transaction bytes */\n    transactions: string[];\n}\n\n/**\n * Sign an arbitrary message\n */\nexport interface SignMessageRequest extends RemoteSignerRequestBase {\n    operation: 'signMessage';\n    /** Base64-encoded message bytes */\n    message: string;\n}\n\n/**\n * Sign and send a transaction (server broadcasts to RPC)\n */\nexport interface SignAndSendTransactionRequest extends RemoteSignerRequestBase {\n    operation: 'signAndSendTransaction';\n    /** Base64-encoded transaction bytes */\n    transaction: string;\n    /** Optional send options */\n    options?: {\n        /** Skip preflight simulation */\n        skipPreflight?: boolean;\n        /** Maximum retries */\n        maxRetries?: number;\n        /** Preflight commitment level */\n        preflightCommitment?: 'processed' | 'confirmed' | 'finalized';\n    };\n}\n\n/**\n * Union type for all POST request bodies\n */\nexport type RemoteSignerRequest =\n    | SignTransactionRequest\n    | SignAllTransactionsRequest\n    | SignMessageRequest\n    | SignAndSendTransactionRequest;\n\n// ============================================================================\n// Responses\n// ============================================================================\n\n/**\n * Successful response for signTransaction\n */\nexport interface SignTransactionResponse {\n    /** Base64-encoded signed transaction bytes */\n    signedTransaction: string;\n}\n\n/**\n * Successful response for signAllTransactions\n */\nexport interface SignAllTransactionsResponse {\n    /** Array of base64-encoded signed transaction bytes */\n    signedTransactions: string[];\n}\n\n/**\n * Successful response for signMessage\n */\nexport interface SignMessageResponse {\n    /** Base64-encoded signature bytes (64 bytes) */\n    signature: string;\n}\n\n/**\n * Successful response for signAndSendTransaction\n */\nexport interface SignAndSendTransactionResponse {\n    /** Transaction signature (base58) */\n    signature: string;\n}\n\n/**\n * Error response structure\n */\nexport interface RemoteSignerErrorResponse {\n    error: {\n        /** Error code for programmatic handling */\n        code: RemoteSignerErrorCode;\n        /** Human-readable error message */\n        message: string;\n        /** Optional additional details */\n        details?: unknown;\n    };\n}\n\n/**\n * Error codes returned by the signer endpoint\n */\nexport type RemoteSignerErrorCode =\n    | 'UNAUTHORIZED'\n    | 'FORBIDDEN'\n    | 'INVALID_REQUEST'\n    | 'INVALID_OPERATION'\n    | 'SIGNING_FAILED'\n    | 'SEND_FAILED'\n    | 'POLICY_VIOLATION'\n    | 'PROVIDER_ERROR'\n    | 'INTERNAL_ERROR';\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Type guard for checking if a response is an error\n */\nexport function isErrorResponse(response: unknown): response is RemoteSignerErrorResponse {\n    return (\n        typeof response === 'object' &&\n        response !== null &&\n        'error' in response &&\n        typeof (response as RemoteSignerErrorResponse).error === 'object'\n    );\n}\n\n/**\n * Configuration for creating a remote wallet\n */\nexport interface RemoteWalletConfig {\n    /** Signer API endpoint URL */\n    endpoint: string;\n    /** Wallet name shown in UI */\n    name: string;\n    /** Wallet icon (data URI or URL) */\n    icon?: string;\n    /** Supported chains (defaults to mainnet + devnet) */\n    chains?: `solana:${string}`[];\n    /**\n     * Function to get auth headers for requests\n     * Called before each request to allow dynamic tokens\n     */\n    getAuthHeaders?: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\n// ============================================================================\n// Base64 Helpers (for protocol encoding)\n// ============================================================================\n\n/**\n * Encode Uint8Array to base64 string\n */\nexport function encodeBase64(bytes: Uint8Array): string {\n    if (typeof Buffer !== 'undefined') {\n        return Buffer.from(bytes).toString('base64');\n    }\n    // Browser fallback\n    const binary = Array.from(bytes)\n        .map(b => String.fromCharCode(b))\n        .join('');\n    return btoa(binary);\n}\n\n/**\n * Decode base64 string to Uint8Array\n */\nexport function decodeBase64(base64: string): Uint8Array {\n    if (typeof Buffer !== 'undefined') {\n        return new Uint8Array(Buffer.from(base64, 'base64'));\n    }\n    // Browser fallback\n    const binary = atob(base64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n        bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n}\n"]}