@fernolab/wallet-adapter-core 0.1.0

package/dist/controller.d.ts

@@ -0,0 +1,48 @@
+import { type IdentifierString, type StandardWallet, type WalletAccount } from './wallet-standard';
+export type WalletConnectionStatus = 'disconnected' | 'connecting' | 'connected';
+export type WalletAddress = string;
+export interface WalletControllerState<TWallet extends StandardWallet = StandardWallet> {
+    availableWallets: readonly TWallet[];
+    connected: boolean;
+    connecting: boolean;
+    error: Error | null;
+    publicKey: WalletAddress | null;
+    shortAddress: string;
+    signing: boolean;
+    standardAccount: WalletAccount | null;
+    standardWallet: TWallet | null;
+    status: WalletConnectionStatus;
+}
+export interface WalletSignMessageResult {
+    signature: string | Uint8Array;
+    signatureType?: string;
+    signedMessage: string | Uint8Array;
+}
+export type WalletControllerListener<TWallet extends StandardWallet = StandardWallet> = (state: WalletControllerState<TWallet>) => void;
+export declare function resolveSolanaChainFromEndpoint(endpoint: string): IdentifierString;
+export declare class WalletController<TWallet extends StandardWallet = StandardWallet> {
+    private availableWalletsValue;
+    private connectedValue;
+    private connectingValue;
+    private errorValue;
+    private listeners;
+    private publicKeyValue;
+    private signingValue;
+    private standardAccountValue;
+    private standardEventsOff;
+    private standardWalletValue;
+    get state(): WalletControllerState<TWallet>;
+    subscribe(listener: WalletControllerListener<TWallet>): () => void;
+    setAvailableWallets(wallets: readonly TWallet[]): void;
+    clearError(): void;
+    connectStandard(wallet: TWallet): Promise<void>;
+    disconnect(): Promise<void>;
+    signMessage(message: string | Uint8Array): Promise<WalletSignMessageResult>;
+    private applyStandardAccount;
+    private watchStandardWallet;
+    private clearStandardEventsListener;
+    private setError;
+    private emit;
+}
+export declare function createWalletController<TWallet extends StandardWallet = StandardWallet>(): WalletController<TWallet>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gBAAgB,EAGrB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IACpF,gBAAgB,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,IAAI,CACtF,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,KAClC,IAAI,CAAC;AA8BV,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAgBjF;AAED,qBAAa,gBAAgB,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IAC3E,OAAO,CAAC,qBAAqB,CAA0B;IACvD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,oBAAoB,CAA8B;IAC1D,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,mBAAmB,CAAwB;IAEnD,IAAI,KAAK,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAa1C;IAED,SAAS,CAAC,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI;IAMlE,mBAAmB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAKtD,UAAU,IAAI,IAAI;IAIZ,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA8CjF,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,2BAA2B;IAKnC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CAIb;AAED,wBAAgB,sBAAsB,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,KAAK,gBAAgB,CAAC,OAAO,CAAC,CAEnH"}

package/dist/controller.js

@@ -0,0 +1,197 @@
+import { SolanaSignMessage, StandardConnect, StandardDisconnect, StandardEvents } from './wallet-standard';
+function getWalletFeature(wallet, featureName) {
+    const features = wallet.features;
+    return features[featureName] ?? null;
+}
+function formatShortAddress(publicKey) {
+    return publicKey ? `${publicKey.slice(0, 4)}...${publicKey.slice(-4)}` : '';
+}
+function isWalletAccount(value) {
+    return (Boolean(value) &&
+        typeof value === 'object' &&
+        typeof value.address === 'string' &&
+        value.publicKey instanceof Uint8Array &&
+        Array.isArray(value.chains) &&
+        Array.isArray(value.features));
+}
+function getStatus(connected, connecting) {
+    if (connecting) {
+        return 'connecting';
+    }
+    return connected ? 'connected' : 'disconnected';
+}
+export function resolveSolanaChainFromEndpoint(endpoint) {
+    const normalized = endpoint.toLowerCase();
+    if (normalized.includes('devnet')) {
+        return 'solana:devnet';
+    }
+    if (normalized.includes('testnet')) {
+        return 'solana:testnet';
+    }
+    if (normalized.includes('localhost') || normalized.includes('127.0.0.1')) {
+        return 'solana:localnet';
+    }
+    return 'solana:mainnet';
+}
+export class WalletController {
+    availableWalletsValue = [];
+    connectedValue = false;
+    connectingValue = false;
+    errorValue = null;
+    listeners = new Set();
+    publicKeyValue = null;
+    signingValue = false;
+    standardAccountValue = null;
+    standardEventsOff = null;
+    standardWalletValue = null;
+    get state() {
+        return {
+            availableWallets: this.availableWalletsValue,
+            connected: this.connectedValue,
+            connecting: this.connectingValue,
+            error: this.errorValue,
+            publicKey: this.publicKeyValue,
+            shortAddress: formatShortAddress(this.publicKeyValue),
+            signing: this.signingValue,
+            standardAccount: this.standardAccountValue,
+            standardWallet: this.standardWalletValue,
+            status: getStatus(this.connectedValue, this.connectingValue)
+        };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.state);
+        return () => this.listeners.delete(listener);
+    }
+    setAvailableWallets(wallets) {
+        this.availableWalletsValue = wallets;
+        this.emit();
+    }
+    clearError() {
+        this.setError(null);
+    }
+    async connectStandard(wallet) {
+        this.connectingValue = true;
+        this.setError(null);
+        this.emit();
+        try {
+            const connectFeature = getWalletFeature(wallet.wallet, StandardConnect);
+            if (!connectFeature) {
+                throw new Error('Wallet does not support standard:connect');
+            }
+            const { accounts } = await connectFeature.connect({ silent: false });
+            const account = accounts?.[0] ?? wallet.wallet.accounts[0] ?? null;
+            if (!isWalletAccount(account)) {
+                throw new Error('Wallet did not return an account');
+            }
+            this.applyStandardAccount(wallet, account);
+            this.watchStandardWallet(wallet);
+        }
+        catch (error) {
+            this.clearStandardEventsListener();
+            this.connectingValue = false;
+            const nextError = error instanceof Error ? error : new Error('Failed to connect wallet');
+            this.setError(nextError);
+            throw nextError;
+        }
+    }
+    async disconnect() {
+        try {
+            if (this.standardWalletValue) {
+                const disconnectFeature = getWalletFeature(this.standardWalletValue.wallet, StandardDisconnect);
+                await disconnectFeature?.disconnect();
+            }
+            this.clearStandardEventsListener();
+            this.applyStandardAccount(null, null);
+            this.setError(null);
+        }
+        catch (error) {
+            const nextError = error instanceof Error ? error : new Error('Failed to disconnect');
+            this.setError(nextError);
+            throw nextError;
+        }
+    }
+    async signMessage(message) {
+        if (!this.standardWalletValue || !this.standardAccountValue) {
+            throw new Error('No wallet connected');
+        }
+        this.signingValue = true;
+        this.setError(null);
+        this.emit();
+        try {
+            const messageFeature = getWalletFeature(this.standardWalletValue.wallet, SolanaSignMessage);
+            if (!messageFeature || !this.standardAccountValue.features.includes(SolanaSignMessage)) {
+                throw new Error('Connected wallet does not support signing messages');
+            }
+            const payload = typeof message === 'string' ? new TextEncoder().encode(message) : new Uint8Array(message);
+            const results = await messageFeature.signMessage({
+                account: this.standardAccountValue,
+                message: payload
+            });
+            const result = Array.isArray(results) ? results[0] : results;
+            if (!result?.signature) {
+                throw new Error('Wallet did not return a message signature');
+            }
+            return {
+                signature: result.signature,
+                signatureType: result.signatureType,
+                signedMessage: result.signedMessage ?? payload
+            };
+        }
+        catch (error) {
+            const nextError = error instanceof Error ? error : new Error('Failed to sign message');
+            this.setError(nextError);
+            throw nextError;
+        }
+        finally {
+            this.signingValue = false;
+            this.emit();
+        }
+    }
+    applyStandardAccount(wallet, account) {
+        if (!wallet || !account) {
+            this.standardWalletValue = null;
+            this.standardAccountValue = null;
+            this.publicKeyValue = null;
+            this.connectedValue = false;
+            this.connectingValue = false;
+            this.emit();
+            return;
+        }
+        this.standardWalletValue = wallet;
+        this.standardAccountValue = account;
+        this.publicKeyValue = account.address;
+        this.connectedValue = true;
+        this.connectingValue = false;
+        this.emit();
+    }
+    watchStandardWallet(wallet) {
+        this.clearStandardEventsListener();
+        const eventsFeature = getWalletFeature(wallet.wallet, StandardEvents);
+        if (!eventsFeature) {
+            return;
+        }
+        const handler = (properties) => {
+            if ('accounts' in properties) {
+                const account = properties.accounts?.[0] ?? wallet.wallet.accounts[0] ?? null;
+                this.applyStandardAccount(wallet, isWalletAccount(account) ? account : null);
+            }
+        };
+        this.standardEventsOff = eventsFeature.on('change', handler);
+    }
+    clearStandardEventsListener() {
+        this.standardEventsOff?.();
+        this.standardEventsOff = null;
+    }
+    setError(error) {
+        this.errorValue = error;
+        this.emit();
+    }
+    emit() {
+        const state = this.state;
+        this.listeners.forEach((listener) => listener(state));
+    }
+}
+export function createWalletController() {
+    return new WalletController();
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './controller';
+export * from './mobile-deeplinks';
+export * from './wallet-standard';
+//# 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,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './controller';
+export * from './mobile-deeplinks';
+export * from './wallet-standard';

package/dist/mobile-deeplinks.d.ts

@@ -0,0 +1,72 @@
+export type MobileWalletId = 'backpack' | 'jupiter' | 'phantom' | 'solflare';
+export type MobilePlatform = 'android' | 'desktop' | 'ios' | 'other';
+export interface MobileRuntime {
+    isMobile: boolean;
+    isWalletBrowser: boolean;
+    platform: MobilePlatform;
+    supportsMobileWalletAdapter: boolean;
+    walletBrowser: MobileWalletId | null;
+}
+export interface MobileRuntimeInput {
+    maxTouchPoints?: number;
+    userAgent?: string;
+}
+export interface MobileWallet {
+    browseUrlTemplate?: string;
+    docsUrl: string;
+    encodeBrowseUrl?: boolean;
+    id: MobileWalletId;
+    name: string;
+    supportsMobileWalletAdapter: boolean;
+    websiteUrl: string;
+}
+export type MobileDeepLinkWallet = MobileWallet & {
+    browseUrlTemplate: string;
+};
+export interface InjectedSolanaProvider {
+    connect?(input?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey?: {
+            toBuffer?(): Uint8Array;
+            toBytes?(): Uint8Array;
+            toString(): string;
+        };
+    }>;
+    disconnect?(): Promise<void>;
+    isBackpack?: boolean;
+    isJupiter?: boolean;
+    isPhantom?: boolean;
+    isSolflare?: boolean;
+    signMessage?(message: Uint8Array, display?: 'hex' | 'utf8'): Promise<Uint8Array | {
+        signature?: Uint8Array | readonly number[];
+    }>;
+}
+export interface InjectedWallet {
+    id: MobileWalletId;
+    name: string;
+    provider: InjectedSolanaProvider;
+}
+export interface InjectedWalletTarget {
+    backpack?: {
+        solana?: InjectedSolanaProvider;
+    };
+    jupiter?: InjectedSolanaProvider;
+    phantom?: {
+        solana?: InjectedSolanaProvider;
+    };
+    solana?: InjectedSolanaProvider;
+    solflare?: InjectedSolanaProvider;
+}
+export declare const MOBILE_WALLETS: readonly MobileWallet[];
+export declare const MOBILE_DEEPLINK_WALLETS: MobileDeepLinkWallet[];
+export declare function detectInjectedWallets(target?: InjectedWalletTarget): InjectedWallet[];
+export declare function detectMobileRuntime(input?: MobileRuntimeInput): MobileRuntime;
+export declare function createMobileWalletBrowseUrl(wallet: MobileDeepLinkWallet, targetUrl: string, referrerUrl: string): string;
+export type AdapterMobileWalletId = MobileWalletId;
+export type AdapterMobilePlatform = MobilePlatform;
+export type AdapterMobileRuntime = MobileRuntime;
+export type AdapterMobileRuntimeInput = MobileRuntimeInput;
+export type AdapterMobileWallet = MobileWallet;
+export type AdapterMobileDeepLinkWallet = MobileDeepLinkWallet;
+//# sourceMappingURL=mobile-deeplinks.d.ts.map

package/dist/mobile-deeplinks.d.ts.map

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

package/dist/mobile-deeplinks.js

@@ -0,0 +1,133 @@
+export const MOBILE_WALLETS = [
+    {
+        browseUrlTemplate: 'jupjupjup://browse/{url}',
+        docsUrl: 'https://docs.jup.ag/user-docs/manage/mobile/app-features',
+        encodeBrowseUrl: false,
+        id: 'jupiter',
+        name: 'Jupiter Mobile',
+        supportsMobileWalletAdapter: true,
+        websiteUrl: 'https://jup.ag/mobile'
+    },
+    {
+        browseUrlTemplate: 'https://phantom.app/ul/browse/{url}?ref={ref}',
+        docsUrl: 'https://docs.phantom.com/phantom-deeplinks/other-methods/browse',
+        id: 'phantom',
+        name: 'Phantom',
+        supportsMobileWalletAdapter: true,
+        websiteUrl: 'https://phantom.app'
+    },
+    {
+        browseUrlTemplate: 'https://solflare.com/ul/v1/browse/{url}?ref={ref}',
+        docsUrl: 'https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse',
+        id: 'solflare',
+        name: 'Solflare',
+        supportsMobileWalletAdapter: true,
+        websiteUrl: 'https://solflare.com'
+    },
+    {
+        browseUrlTemplate: 'https://backpack.app/ul/v1/browse/{url}?ref={ref}',
+        docsUrl: 'https://docs.backpack.app/deeplinks/other-methods/browse',
+        id: 'backpack',
+        name: 'Backpack',
+        supportsMobileWalletAdapter: true,
+        websiteUrl: 'https://backpack.app'
+    }
+];
+export const MOBILE_DEEPLINK_WALLETS = MOBILE_WALLETS.filter((wallet) => Boolean(wallet.browseUrlTemplate));
+function getWalletById(id) {
+    const wallet = MOBILE_WALLETS.find((candidate) => candidate.id === id);
+    if (!wallet) {
+        throw new Error(`Unknown mobile wallet ${id}`);
+    }
+    return wallet;
+}
+function getRuntimeUserAgent(userAgent) {
+    if (userAgent !== undefined) {
+        return userAgent;
+    }
+    return globalThis.navigator?.userAgent ?? '';
+}
+function getRuntimeMaxTouchPoints(maxTouchPoints) {
+    if (maxTouchPoints !== undefined) {
+        return maxTouchPoints;
+    }
+    return globalThis.navigator?.maxTouchPoints ?? 0;
+}
+function detectPlatform(userAgent, maxTouchPoints) {
+    if (/android/i.test(userAgent)) {
+        return 'android';
+    }
+    if (/iPhone|iPad|iPod/i.test(userAgent) || (/Macintosh/i.test(userAgent) && maxTouchPoints > 1)) {
+        return 'ios';
+    }
+    if (/Mobile|webOS|BlackBerry|IEMobile|Opera Mini/i.test(userAgent)) {
+        return 'other';
+    }
+    return 'desktop';
+}
+function detectWalletBrowser(userAgent) {
+    const normalized = userAgent.toLowerCase();
+    if (normalized.includes('phantom')) {
+        return 'phantom';
+    }
+    if (normalized.includes('solflare')) {
+        return 'solflare';
+    }
+    if (normalized.includes('jupiter')) {
+        return 'jupiter';
+    }
+    if (normalized.includes('backpack')) {
+        return 'backpack';
+    }
+    return null;
+}
+function getRuntimeTarget(target) {
+    if (target) {
+        return target;
+    }
+    return globalThis;
+}
+function addInjectedWallet(wallets, seen, id, provider, isMatch) {
+    if (!provider || !isMatch(provider) || seen.has(provider)) {
+        return;
+    }
+    const wallet = getWalletById(id);
+    wallets.push({ id, name: wallet.name, provider });
+    seen.add(provider);
+}
+export function detectInjectedWallets(target) {
+    const runtimeTarget = getRuntimeTarget(target);
+    const wallets = [];
+    const seen = new Set();
+    const solana = runtimeTarget.solana;
+    addInjectedWallet(wallets, seen, 'phantom', runtimeTarget.phantom?.solana ?? (solana?.isPhantom ? solana : undefined), (provider) => Boolean(provider.isPhantom));
+    addInjectedWallet(wallets, seen, 'solflare', runtimeTarget.solflare ?? (solana?.isSolflare ? solana : undefined), (provider) => Boolean(provider.isSolflare));
+    addInjectedWallet(wallets, seen, 'jupiter', runtimeTarget.jupiter ?? (solana?.isJupiter ? solana : undefined), (provider) => Boolean(provider.isJupiter));
+    addInjectedWallet(wallets, seen, 'backpack', runtimeTarget.backpack?.solana ?? (solana?.isBackpack ? solana : undefined), (provider) => Boolean(provider.isBackpack));
+    return wallets;
+}
+function isAndroidChrome(userAgent) {
+    return (/Android/i.test(userAgent) &&
+        /Chrome\//i.test(userAgent) &&
+        !/; wv\)|WebView|EdgA\/|OPR\/|Firefox\/|SamsungBrowser\//i.test(userAgent));
+}
+export function detectMobileRuntime(input = {}) {
+    const userAgent = getRuntimeUserAgent(input.userAgent);
+    const maxTouchPoints = getRuntimeMaxTouchPoints(input.maxTouchPoints);
+    const platform = detectPlatform(userAgent, maxTouchPoints);
+    const walletBrowser = detectWalletBrowser(userAgent);
+    const isMobile = platform !== 'desktop';
+    return {
+        isMobile,
+        isWalletBrowser: walletBrowser !== null,
+        platform,
+        supportsMobileWalletAdapter: walletBrowser === null && isAndroidChrome(userAgent),
+        walletBrowser
+    };
+}
+export function createMobileWalletBrowseUrl(wallet, targetUrl, referrerUrl) {
+    const encodedTargetUrl = wallet.encodeBrowseUrl === false ? targetUrl : encodeURIComponent(targetUrl);
+    return wallet.browseUrlTemplate
+        .replace('{url}', encodedTargetUrl)
+        .replace('{ref}', encodeURIComponent(referrerUrl));
+}

package/dist/wallet-standard.d.ts

@@ -0,0 +1,125 @@
+export declare const StandardConnect = "standard:connect";
+export declare const StandardDisconnect = "standard:disconnect";
+export declare const StandardEvents = "standard:events";
+export declare const SolanaSignAndSendTransaction = "solana:signAndSendTransaction";
+export declare const SolanaSignMessage = "solana:signMessage";
+export declare const SolanaSignTransaction = "solana:signTransaction";
+export type IdentifierString = string;
+export type WalletIcon = string;
+export interface WalletAccount {
+    address: string;
+    chains: readonly IdentifierString[];
+    features: readonly IdentifierString[];
+    label?: string;
+    publicKey: Uint8Array;
+}
+export interface Wallet {
+    accounts: readonly WalletAccount[];
+    chains: readonly IdentifierString[];
+    features: Readonly<Record<string, unknown>>;
+    icon?: WalletIcon;
+    name: string;
+    version?: string;
+}
+export interface StandardWalletProvider {
+    accounts: readonly unknown[];
+    chains?: readonly IdentifierString[];
+    features: Readonly<Record<string, unknown>>;
+    icon?: string;
+    name: string;
+    version?: string;
+}
+export interface StandardConnectMethod {
+    connect(input?: {
+        silent?: boolean;
+    }): Promise<{
+        accounts: readonly WalletAccount[];
+    }>;
+    version?: string;
+}
+export interface StandardDisconnectMethod {
+    disconnect(): Promise<void>;
+    version?: string;
+}
+export interface StandardEventsListeners {
+    change(input: {
+        accounts?: readonly WalletAccount[];
+    }): void;
+}
+export interface StandardEventsMethod {
+    on<E extends keyof StandardEventsListeners>(event: E, listener: StandardEventsListeners[E]): () => void;
+    version?: string;
+}
+export interface SolanaSignMessageMethod {
+    signMessage(...inputs: readonly {
+        account: WalletAccount;
+        message: Uint8Array;
+    }[]): Promise<readonly {
+        signature: string | Uint8Array;
+        signatureType?: 'ed25519' | string;
+        signedMessage?: string | Uint8Array;
+    }[]>;
+    version?: string;
+}
+export interface SolanaSignTransactionMethod {
+    signTransaction(...inputs: readonly {
+        account: WalletAccount;
+        chain: IdentifierString;
+        options?: {
+            minContextSlot?: number;
+            preflightCommitment?: string;
+        };
+        transaction: Uint8Array;
+    }[]): Promise<readonly {
+        signedTransaction: Uint8Array;
+    }[]>;
+    supportedTransactionVersions?: readonly ('legacy' | number)[];
+    version?: string;
+}
+export interface SolanaSignAndSendTransactionMethod {
+    signAndSendTransaction(input: {
+        account: WalletAccount;
+        chain: IdentifierString;
+        options?: {
+            maxRetries?: number;
+            minContextSlot?: number;
+            preflightCommitment?: string;
+            skipPreflight?: boolean;
+        };
+        transaction: Uint8Array;
+    }): Promise<{
+        signature: string | Uint8Array;
+    } | readonly {
+        signature: string | Uint8Array;
+    }[]>;
+    supportedTransactionVersions?: readonly ('legacy' | number)[];
+    version?: string;
+}
+export interface StandardConnectFeature {
+    [StandardConnect]: StandardConnectMethod;
+}
+export interface StandardDisconnectFeature {
+    [StandardDisconnect]: StandardDisconnectMethod;
+}
+export interface StandardEventsFeature {
+    [StandardEvents]: StandardEventsMethod;
+}
+export interface SolanaSignMessageFeature {
+    [SolanaSignMessage]: SolanaSignMessageMethod;
+}
+export interface SolanaSignTransactionFeature {
+    [SolanaSignTransaction]: SolanaSignTransactionMethod;
+}
+export interface SolanaSignAndSendTransactionFeature {
+    [SolanaSignAndSendTransaction]: SolanaSignAndSendTransactionMethod;
+}
+export interface StandardWallet<TWallet extends StandardWalletProvider = StandardWalletProvider> {
+    name: string;
+    icon: string;
+    wallet: TWallet;
+}
+export declare function isSolanaWallet<TWallet extends StandardWalletProvider>(wallet: TWallet): boolean;
+export declare function adaptWallet<TWallet extends StandardWalletProvider>(wallet: TWallet): StandardWallet<TWallet> | null;
+export declare function dedupeStandardWallets<TWallet extends StandardWalletProvider>(wallets: readonly StandardWallet<TWallet>[], preferredNames?: readonly string[]): StandardWallet<TWallet>[];
+export declare function adaptStandardWallets<TWallet extends StandardWalletProvider>(wallets: readonly TWallet[], preferredNames?: readonly string[]): StandardWallet<TWallet>[];
+//# sourceMappingURL=wallet-standard.d.ts.map

package/dist/wallet-standard.d.ts.map

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

package/dist/wallet-standard.js

@@ -0,0 +1,54 @@
+export const StandardConnect = 'standard:connect';
+export const StandardDisconnect = 'standard:disconnect';
+export const StandardEvents = 'standard:events';
+export const SolanaSignAndSendTransaction = 'solana:signAndSendTransaction';
+export const SolanaSignMessage = 'solana:signMessage';
+export const SolanaSignTransaction = 'solana:signTransaction';
+const FALLBACK_ICON = 'data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2248%22%20height%3D%2248%22%20viewBox%3D%220%200%2048%2048%22%20fill%3D%22none%22%3E%3Crect%20width%3D%2248%22%20height%3D%2248%22%20rx%3D%2212%22%20fill%3D%22%23111827%22%2F%3E%3Cpath%20d%3D%22M16%2018h16v-2H16v2Zm0%207h16v-2H16v2Zm0%207h16v-2H16v2Z%22%20fill%3D%22white%22%2F%3E%3C%2Fsvg%3E';
+export function isSolanaWallet(wallet) {
+    const { features, chains } = wallet;
+    if (!features) {
+        return false;
+    }
+    const hasStandardFeatures = StandardConnect in features && StandardDisconnect in features && StandardEvents in features;
+    const hasSolanaSigning = SolanaSignMessage in features ||
+        SolanaSignTransaction in features ||
+        SolanaSignAndSendTransaction in features;
+    const supportsSolanaChain = chains?.some((chain) => chain.startsWith('solana:'));
+    return Boolean(hasStandardFeatures && hasSolanaSigning && supportsSolanaChain);
+}
+export function adaptWallet(wallet) {
+    if (!isSolanaWallet(wallet)) {
+        return null;
+    }
+    return {
+        name: wallet.name,
+        icon: wallet.icon ?? FALLBACK_ICON,
+        wallet
+    };
+}
+export function dedupeStandardWallets(wallets, preferredNames = []) {
+    const walletsByName = new Map();
+    for (const wallet of wallets) {
+        const existing = walletsByName.get(wallet.name);
+        if (!existing) {
+            walletsByName.set(wallet.name, wallet);
+            continue;
+        }
+        const existingHasSignAndSend = SolanaSignAndSendTransaction in existing.wallet.features;
+        const newHasSignAndSend = SolanaSignAndSendTransaction in wallet.wallet.features;
+        if (newHasSignAndSend && !existingHasSignAndSend) {
+            walletsByName.set(wallet.name, wallet);
+        }
+    }
+    const deduped = Array.from(walletsByName.values());
+    const preferred = deduped.filter((wallet) => preferredNames.includes(wallet.name));
+    const otherWallets = deduped.filter((wallet) => !preferredNames.includes(wallet.name));
+    return [...preferred, ...otherWallets];
+}
+export function adaptStandardWallets(wallets, preferredNames = []) {
+    const adapted = wallets
+        .map(adaptWallet)
+        .filter((wallet) => wallet !== null);
+    return dedupeStandardWallets(adapted, preferredNames);
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@fernolab/wallet-adapter-core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic Solana Wallet Standard adapter core.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FernoLabs/ferno-wallet.git",
+    "directory": "ferno-wallet-adapter-core"
+  },
+  "bugs": {
+    "url": "https://github.com/FernoLabs/ferno-wallet/issues"
+  },
+  "homepage": "https://github.com/FernoLabs/ferno-wallet#readme",
+  "keywords": [
+    "solana",
+    "wallet-standard",
+    "wallet-adapter",
+    "ferno"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc --noEmit",
+    "prepack": "npm run build",
+    "test": "vitest run"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}