@fernolab/wallet-adapter-core 0.1.0 → 0.1.1

package/dist/controller.d.ts

@@ -1,4 +1,4 @@
-import { type IdentifierString, type StandardWallet, type WalletAccount } from './wallet-standard';
+import { type IdentifierString, type StandardWallet, type WalletAccount, type WalletStorage } from './wallet-standard';
 export type WalletConnectionStatus = 'disconnected' | 'connecting' | 'connected';
 export type WalletAddress = string;
 export interface WalletControllerState<TWallet extends StandardWallet = StandardWallet> {
@@ -6,6 +6,7 @@ export interface WalletControllerState<TWallet extends StandardWallet = Standard
     connected: boolean;
     connecting: boolean;
     error: Error | null;
+    lastUsedWalletName: string | null;
     publicKey: WalletAddress | null;
     shortAddress: string;
     signing: boolean;
@@ -19,21 +20,31 @@ export interface WalletSignMessageResult {
     signedMessage: string | Uint8Array;
 }
 export type WalletControllerListener<TWallet extends StandardWallet = StandardWallet> = (state: WalletControllerState<TWallet>) => void;
+export interface WalletControllerOptions {
+    lastUsedWalletName?: string | null;
+    storage?: WalletStorage | null;
+    storageKey?: string;
+}
 export declare function resolveSolanaChainFromEndpoint(endpoint: string): IdentifierString;
 export declare class WalletController<TWallet extends StandardWallet = StandardWallet> {
     private availableWalletsValue;
     private connectedValue;
     private connectingValue;
     private errorValue;
+    private lastUsedWalletNameValue;
     private listeners;
     private publicKeyValue;
     private signingValue;
     private standardAccountValue;
     private standardEventsOff;
     private standardWalletValue;
+    private storageValue;
+    private storageKeyValue;
+    constructor(options?: WalletControllerOptions);
     get state(): WalletControllerState<TWallet>;
     subscribe(listener: WalletControllerListener<TWallet>): () => void;
     setAvailableWallets(wallets: readonly TWallet[]): void;
+    setLastUsedWalletName(walletName: string | null): void;
     clearError(): void;
     connectStandard(wallet: TWallet): Promise<void>;
     disconnect(): Promise<void>;
@@ -41,8 +52,9 @@ export declare class WalletController<TWallet extends StandardWallet = StandardW
     private applyStandardAccount;
     private watchStandardWallet;
     private clearStandardEventsListener;
+    private setLastUsedWalletNameValue;
     private setError;
     private emit;
 }
-export declare function createWalletController<TWallet extends StandardWallet = StandardWallet>(): WalletController<TWallet>;
+export declare function createWalletController<TWallet extends StandardWallet = StandardWallet>(options?: WalletControllerOptions): WalletController<TWallet>;
 //# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

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

package/dist/controller.js

@@ -1,4 +1,4 @@
-import { SolanaSignMessage, StandardConnect, StandardDisconnect, StandardEvents } from './wallet-standard';
+import { SolanaSignMessage, StandardConnect, StandardDisconnect, StandardEvents, LAST_USED_WALLET_STORAGE_KEY, clearLastUsedWalletName, readLastUsedWalletName, saveLastUsedWalletName, sortWalletsByLastUsed } from './wallet-standard';
 function getWalletFeature(wallet, featureName) {
     const features = wallet.features;
     return features[featureName] ?? null;
@@ -38,18 +38,30 @@ export class WalletController {
     connectedValue = false;
     connectingValue = false;
     errorValue = null;
+    lastUsedWalletNameValue;
     listeners = new Set();
     publicKeyValue = null;
     signingValue = false;
     standardAccountValue = null;
     standardEventsOff = null;
     standardWalletValue = null;
+    storageValue;
+    storageKeyValue;
+    constructor(options = {}) {
+        this.storageValue = options.storage ?? null;
+        this.storageKeyValue = options.storageKey ?? LAST_USED_WALLET_STORAGE_KEY;
+        this.lastUsedWalletNameValue =
+            'lastUsedWalletName' in options
+                ? options.lastUsedWalletName ?? null
+                : readLastUsedWalletName(this.storageValue, this.storageKeyValue);
+    }
     get state() {
         return {
             availableWallets: this.availableWalletsValue,
             connected: this.connectedValue,
             connecting: this.connectingValue,
             error: this.errorValue,
+            lastUsedWalletName: this.lastUsedWalletNameValue,
             publicKey: this.publicKeyValue,
             shortAddress: formatShortAddress(this.publicKeyValue),
             signing: this.signingValue,
@@ -64,7 +76,11 @@ export class WalletController {
         return () => this.listeners.delete(listener);
     }
     setAvailableWallets(wallets) {
-        this.availableWalletsValue = wallets;
+        this.availableWalletsValue = sortWalletsByLastUsed(wallets, this.lastUsedWalletNameValue);
+        this.emit();
+    }
+    setLastUsedWalletName(walletName) {
+        this.setLastUsedWalletNameValue(walletName);
         this.emit();
     }
     clearError() {
@@ -84,6 +100,7 @@ export class WalletController {
             if (!isWalletAccount(account)) {
                 throw new Error('Wallet did not return an account');
             }
+            this.setLastUsedWalletNameValue(wallet.name);
             this.applyStandardAccount(wallet, account);
             this.watchStandardWallet(wallet);
         }
@@ -183,6 +200,16 @@ export class WalletController {
         this.standardEventsOff?.();
         this.standardEventsOff = null;
     }
+    setLastUsedWalletNameValue(walletName) {
+        this.lastUsedWalletNameValue = walletName;
+        this.availableWalletsValue = sortWalletsByLastUsed(this.availableWalletsValue, this.lastUsedWalletNameValue);
+        if (walletName) {
+            saveLastUsedWalletName(this.storageValue, walletName, this.storageKeyValue);
+        }
+        else {
+            clearLastUsedWalletName(this.storageValue, this.storageKeyValue);
+        }
+    }
     setError(error) {
         this.errorValue = error;
         this.emit();
@@ -192,6 +219,6 @@ export class WalletController {
         this.listeners.forEach((listener) => listener(state));
     }
 }
-export function createWalletController() {
-    return new WalletController();
+export function createWalletController(options = {}) {
+    return new WalletController(options);
 }

package/dist/crypto-vault.d.ts

@@ -0,0 +1,90 @@
+export declare const FERNO_HOT_WALLET_VAULT_VERSION = 1;
+export interface WalletWrappingKeyInput {
+    chainId: string;
+    domain: string;
+    purpose?: string;
+    walletAddress: string;
+    walletSignature: Uint8Array;
+}
+export interface WrappedHotWallet {
+    algorithm: 'Ed25519';
+    createdAt: string;
+    iv: Uint8Array;
+    publicKey: Uint8Array;
+    salt: Uint8Array;
+    version: typeof FERNO_HOT_WALLET_VAULT_VERSION;
+    wrappedPrivateKey: Uint8Array;
+}
+export interface UnlockedHotWallet {
+    algorithm: 'Ed25519';
+    privateKey: CryptoKey;
+    publicKey: Uint8Array;
+}
+export declare function getHotWalletAddress(wallet: Pick<WrappedHotWallet | UnlockedHotWallet, 'publicKey'>): string;
+export declare function getHotWalletStorageKey({ chainId, ownerAddress, storagePrefix }: {
+    chainId: string;
+    ownerAddress: string;
+    storagePrefix?: string;
+}): string;
+export declare function serializeWrappedHotWallet(wallet: WrappedHotWallet): string;
+export declare function deserializeWrappedHotWallet(value: string): WrappedHotWallet;
+export declare function readWrappedHotWallet({ chainId, ownerAddress, storage, storagePrefix }: {
+    chainId: string;
+    ownerAddress: string;
+    storage: Pick<Storage, 'getItem'> | null | undefined;
+    storagePrefix?: string;
+}): WrappedHotWallet | null;
+export declare function saveWrappedHotWallet({ chainId, ownerAddress, storage, storagePrefix, wallet }: {
+    chainId: string;
+    ownerAddress: string;
+    storage: Pick<Storage, 'setItem'> | null | undefined;
+    storagePrefix?: string;
+    wallet: WrappedHotWallet;
+}): void;
+export declare function createHotWalletUnlockMessage({ chainId, domain, uri, walletAddress }: {
+    chainId: string;
+    domain: string;
+    uri: string;
+    walletAddress: string;
+}): string;
+export declare function deriveHotWalletWrappingKey({ chainId, crypto, domain, purpose, walletAddress, walletSignature }: WalletWrappingKeyInput & {
+    crypto?: Crypto;
+}): Promise<{
+    key: CryptoKey;
+    salt: Uint8Array;
+}>;
+export declare function deriveHotWalletSeed({ chainId, crypto, domain, purpose, walletAddress, walletSignature }: WalletWrappingKeyInput & {
+    crypto?: Crypto;
+}): Promise<{
+    salt: Uint8Array;
+    seed: Uint8Array;
+}>;
+export declare function createWrappedHotWallet({ crypto, seed, wrappingKey }: {
+    crypto?: Crypto;
+    seed?: Uint8Array;
+    wrappingKey: CryptoKey;
+}): Promise<WrappedHotWallet>;
+export declare function createWrappedHotWalletFromSignature(input: WalletWrappingKeyInput & {
+    crypto?: Crypto;
+}): Promise<WrappedHotWallet>;
+export declare function unlockHotWallet({ crypto, wrappedWallet, wrappingKey }: {
+    crypto?: Crypto;
+    wrappedWallet: WrappedHotWallet;
+    wrappingKey: CryptoKey;
+}): Promise<UnlockedHotWallet>;
+export declare function unlockHotWalletFromSignature(input: WalletWrappingKeyInput & {
+    crypto?: Crypto;
+    wrappedWallet: WrappedHotWallet;
+}): Promise<UnlockedHotWallet>;
+export declare function signWithHotWallet({ crypto, message, privateKey }: {
+    crypto?: Crypto;
+    message: Uint8Array;
+    privateKey: CryptoKey;
+}): Promise<Uint8Array>;
+export declare function verifyHotWalletSignature({ crypto, message, publicKey, signature }: {
+    crypto?: Crypto;
+    message: Uint8Array;
+    publicKey: Uint8Array;
+    signature: Uint8Array;
+}): Promise<boolean>;
+//# sourceMappingURL=crypto-vault.d.ts.map

package/dist/crypto-vault.d.ts.map

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

package/dist/crypto-vault.js

@@ -0,0 +1,210 @@
+import { ed25519 } from '@noble/curves/ed25519.js';
+import { base58Encode } from './solana';
+export const FERNO_HOT_WALLET_VAULT_VERSION = 1;
+const DEFAULT_PURPOSE = 'ferno hot wallet seed encryption';
+const HOT_WALLET_SEED_INFO = 'ferno deterministic hot wallet seed v1';
+const WRAPPING_KEY_INFO = 'ferno hot wallet wrapping key v1';
+const SALT_PREFIX = 'ferno:v1:hot-wallet-vault';
+const ED25519_PKCS8_SEED_PREFIX = new Uint8Array([
+    0x30, 0x2e, 0x02, 0x01, 0x00, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x04, 0x22,
+    0x04, 0x20
+]);
+export function getHotWalletAddress(wallet) {
+    return base58Encode(wallet.publicKey);
+}
+export function getHotWalletStorageKey({ chainId, ownerAddress, storagePrefix = 'ferno:hot-wallet:' }) {
+    return `${storagePrefix}${chainId}:${ownerAddress}`;
+}
+export function serializeWrappedHotWallet(wallet) {
+    return JSON.stringify({
+        algorithm: wallet.algorithm,
+        createdAt: wallet.createdAt,
+        iv: bytesToBase64(wallet.iv),
+        publicKey: bytesToBase64(wallet.publicKey),
+        salt: bytesToBase64(wallet.salt),
+        version: wallet.version,
+        wrappedPrivateKey: bytesToBase64(wallet.wrappedPrivateKey)
+    });
+}
+export function deserializeWrappedHotWallet(value) {
+    const parsed = JSON.parse(value);
+    return {
+        algorithm: parsed.algorithm,
+        createdAt: parsed.createdAt,
+        iv: base64ToBytes(parsed.iv),
+        publicKey: base64ToBytes(parsed.publicKey),
+        salt: base64ToBytes(parsed.salt),
+        version: parsed.version,
+        wrappedPrivateKey: base64ToBytes(parsed.wrappedPrivateKey)
+    };
+}
+export function readWrappedHotWallet({ chainId, ownerAddress, storage, storagePrefix }) {
+    const stored = storage?.getItem(getHotWalletStorageKey({ chainId, ownerAddress, storagePrefix }));
+    return stored ? deserializeWrappedHotWallet(stored) : null;
+}
+export function saveWrappedHotWallet({ chainId, ownerAddress, storage, storagePrefix, wallet }) {
+    storage?.setItem(getHotWalletStorageKey({ chainId, ownerAddress, storagePrefix }), serializeWrappedHotWallet(wallet));
+}
+export function createHotWalletUnlockMessage({ chainId, domain, uri, walletAddress }) {
+    return `${domain} wants you to unlock your Ferno hot wallet encryption key.
+
+This signature does not authorize a transaction.
+Wallet: ${walletAddress}
+Purpose: ${DEFAULT_PURPOSE}
+Version: ${FERNO_HOT_WALLET_VAULT_VERSION}
+URI: ${uri}
+Chain ID: ${chainId}
+Resources:
+- urn:ferno:hot-wallet-seed:v${FERNO_HOT_WALLET_VAULT_VERSION}`;
+}
+export async function deriveHotWalletWrappingKey({ chainId, crypto = globalThis.crypto, domain, purpose = DEFAULT_PURPOSE, walletAddress, walletSignature }) {
+    assertWebCrypto(crypto);
+    const signatureCopy = new Uint8Array(walletSignature);
+    const salt = await createWrappingSalt({ chainId, crypto, domain, purpose, walletAddress });
+    const keyMaterial = await crypto.subtle.importKey('raw', toArrayBuffer(signatureCopy), 'HKDF', false, ['deriveKey']);
+    signatureCopy.fill(0);
+    const key = await crypto.subtle.deriveKey({
+        name: 'HKDF',
+        hash: 'SHA-256',
+        salt: toArrayBuffer(salt),
+        info: toArrayBuffer(encodeUtf8(WRAPPING_KEY_INFO))
+    }, keyMaterial, { name: 'AES-GCM', length: 256 }, false, ['wrapKey', 'unwrapKey']);
+    return { key, salt };
+}
+export async function deriveHotWalletSeed({ chainId, crypto = globalThis.crypto, domain, purpose = DEFAULT_PURPOSE, walletAddress, walletSignature }) {
+    assertWebCrypto(crypto);
+    const signatureCopy = new Uint8Array(walletSignature);
+    const salt = await createWrappingSalt({ chainId, crypto, domain, purpose, walletAddress });
+    const keyMaterial = await crypto.subtle.importKey('raw', toArrayBuffer(signatureCopy), 'HKDF', false, ['deriveBits']);
+    signatureCopy.fill(0);
+    const seed = new Uint8Array(await crypto.subtle.deriveBits({
+        name: 'HKDF',
+        hash: 'SHA-256',
+        salt: toArrayBuffer(salt),
+        info: toArrayBuffer(encodeUtf8(HOT_WALLET_SEED_INFO))
+    }, keyMaterial, 256));
+    return { salt, seed };
+}
+export async function createWrappedHotWallet({ crypto = globalThis.crypto, seed, wrappingKey }) {
+    assertWebCrypto(crypto);
+    const keyPair = seed
+        ? await importEd25519SeedKeyPair({ crypto, seed })
+        : await crypto.subtle.generateKey({ name: 'Ed25519' }, true, ['sign', 'verify']);
+    const iv = crypto.getRandomValues(new Uint8Array(12));
+    const publicKey = new Uint8Array(await crypto.subtle.exportKey('raw', keyPair.publicKey));
+    const wrappedPrivateKey = new Uint8Array(await crypto.subtle.wrapKey('pkcs8', keyPair.privateKey, wrappingKey, {
+        name: 'AES-GCM',
+        iv: toArrayBuffer(iv)
+    }));
+    return {
+        algorithm: 'Ed25519',
+        createdAt: new Date().toISOString(),
+        iv,
+        publicKey,
+        salt: new Uint8Array(),
+        version: FERNO_HOT_WALLET_VAULT_VERSION,
+        wrappedPrivateKey
+    };
+}
+export async function createWrappedHotWalletFromSignature(input) {
+    const crypto = input.crypto ?? globalThis.crypto;
+    const { key, salt } = await deriveHotWalletWrappingKey({ ...input, crypto });
+    const { seed } = await deriveHotWalletSeed({ ...input, crypto });
+    try {
+        const wrappedWallet = await createWrappedHotWallet({ crypto, seed, wrappingKey: key });
+        return {
+            ...wrappedWallet,
+            salt
+        };
+    }
+    finally {
+        seed.fill(0);
+    }
+}
+export async function unlockHotWallet({ crypto = globalThis.crypto, wrappedWallet, wrappingKey }) {
+    assertWebCrypto(crypto);
+    assertSupportedWrappedWallet(wrappedWallet);
+    const privateKey = await crypto.subtle.unwrapKey('pkcs8', toArrayBuffer(wrappedWallet.wrappedPrivateKey), wrappingKey, { name: 'AES-GCM', iv: toArrayBuffer(wrappedWallet.iv) }, { name: 'Ed25519' }, false, ['sign']);
+    return {
+        algorithm: 'Ed25519',
+        privateKey,
+        publicKey: wrappedWallet.publicKey
+    };
+}
+export async function unlockHotWalletFromSignature(input) {
+    const crypto = input.crypto ?? globalThis.crypto;
+    const { key } = await deriveHotWalletWrappingKey({ ...input, crypto });
+    return await unlockHotWallet({ crypto, wrappedWallet: input.wrappedWallet, wrappingKey: key });
+}
+export async function signWithHotWallet({ crypto = globalThis.crypto, message, privateKey }) {
+    assertWebCrypto(crypto);
+    return new Uint8Array(await crypto.subtle.sign({ name: 'Ed25519' }, privateKey, toArrayBuffer(message)));
+}
+export async function verifyHotWalletSignature({ crypto = globalThis.crypto, message, publicKey, signature }) {
+    assertWebCrypto(crypto);
+    const key = await crypto.subtle.importKey('raw', toArrayBuffer(publicKey), { name: 'Ed25519' }, false, ['verify']);
+    return await crypto.subtle.verify({ name: 'Ed25519' }, key, toArrayBuffer(signature), toArrayBuffer(message));
+}
+async function createWrappingSalt({ chainId, crypto, domain, purpose, walletAddress }) {
+    const saltInput = [SALT_PREFIX, domain, chainId, walletAddress, purpose].join('\n');
+    return new Uint8Array(await crypto.subtle.digest('SHA-256', toArrayBuffer(encodeUtf8(saltInput))));
+}
+function assertSupportedWrappedWallet(wrappedWallet) {
+    if (wrappedWallet.version !== FERNO_HOT_WALLET_VAULT_VERSION ||
+        wrappedWallet.algorithm !== 'Ed25519') {
+        throw new Error('Unsupported Ferno hot wallet vault');
+    }
+}
+function assertWebCrypto(crypto) {
+    if (!crypto?.subtle || !crypto.getRandomValues) {
+        throw new Error('WebCrypto is not available');
+    }
+}
+function encodeUtf8(value) {
+    return new TextEncoder().encode(value);
+}
+function bytesToBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+function base64ToBytes(value) {
+    return Uint8Array.from(atob(value), (char) => char.charCodeAt(0));
+}
+async function importEd25519SeedKeyPair({ crypto, seed }) {
+    if (seed.byteLength !== 32) {
+        throw new Error('Ed25519 hot wallet seeds must be 32 bytes');
+    }
+    const seedCopy = new Uint8Array(seed);
+    const privateKeyBytes = concatBytes(ED25519_PKCS8_SEED_PREFIX, seedCopy);
+    try {
+        const [privateKey, publicKey] = await Promise.all([
+            crypto.subtle.importKey('pkcs8', toArrayBuffer(privateKeyBytes), { name: 'Ed25519' }, true, [
+                'sign'
+            ]),
+            crypto.subtle.importKey('raw', toArrayBuffer(ed25519.getPublicKey(seedCopy)), { name: 'Ed25519' }, true, ['verify'])
+        ]);
+        return { privateKey, publicKey };
+    }
+    finally {
+        seedCopy.fill(0);
+        privateKeyBytes.fill(0);
+    }
+}
+function concatBytes(...chunks) {
+    const length = chunks.reduce((total, chunk) => total + chunk.byteLength, 0);
+    const bytes = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}
+function toArrayBuffer(bytes) {
+    const copy = new Uint8Array(bytes.byteLength);
+    copy.set(bytes);
+    return copy.buffer;
+}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './controller';
+export * from './crypto-vault';
 export * from './mobile-deeplinks';
+export * from './solana';
 export * from './wallet-standard';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
 export * from './controller';
+export * from './crypto-vault';
 export * from './mobile-deeplinks';
+export * from './solana';
 export * from './wallet-standard';

package/dist/solana.d.ts

@@ -0,0 +1,26 @@
+export interface SystemTransferTransactionInput {
+    blockhash: string;
+    fromAddress: string;
+    lamports: bigint;
+    toAddress: string;
+}
+export interface SystemTransferTransaction {
+    messageBytes: Uint8Array;
+    transaction: Uint8Array;
+}
+export declare function base58Encode(bytes: Uint8Array): string;
+export declare function base58Decode(value: string): Uint8Array;
+export declare function solToLamports(value: string): bigint;
+export declare function lamportsToSol(lamportsValue: bigint | null): string;
+export declare function solanaRpc<T>({ endpoint, method, params }: {
+    endpoint: string;
+    method: string;
+    params: unknown[];
+}): Promise<T>;
+export declare function getLatestSolanaBlockhash(endpoint: string): Promise<string>;
+export declare function getSolanaBalance(endpoint: string, address: string): Promise<bigint>;
+export declare function sendSerializedSolanaTransaction(endpoint: string, transaction: Uint8Array): Promise<string>;
+export declare function createSystemTransferTransaction({ blockhash, fromAddress, lamports, toAddress }: SystemTransferTransactionInput): SystemTransferTransaction;
+export declare function applySolanaTransactionSignature(transaction: Uint8Array, signature: Uint8Array): Uint8Array;
+export declare function normalizeSignatureBytes(signature: string | Uint8Array): Uint8Array;
+//# sourceMappingURL=solana.d.ts.map

package/dist/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../src/solana.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,UAAU,CAAC;IACzB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuBtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA4BtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASlE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,EACjC,QAAQ,EACR,MAAM,EACN,MAAM,EACP,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,CA2Bb;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhF;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzF;AAED,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,EACV,EAAE,8BAA8B,GAAG,yBAAyB,CAmC5D;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,UAAU,EACvB,SAAS,EAAE,UAAU,GACpB,UAAU,CASZ;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAElF"}

package/dist/solana.js

@@ -0,0 +1,172 @@
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+const BASE58_ZERO = '1';
+const LAMPORTS_PER_SOL = 1000000000n;
+export function base58Encode(bytes) {
+    let value = 0n;
+    for (const byte of bytes) {
+        value = value * 256n + BigInt(byte);
+    }
+    let encoded = '';
+    while (value > 0n) {
+        const remainder = Number(value % 58n);
+        value /= 58n;
+        encoded = (BASE58_ALPHABET[remainder] ?? BASE58_ZERO) + encoded;
+    }
+    for (const byte of bytes) {
+        if (byte !== 0) {
+            break;
+        }
+        encoded = BASE58_ZERO + encoded;
+    }
+    return encoded || BASE58_ZERO;
+}
+export function base58Decode(value) {
+    let decoded = 0n;
+    for (const char of value) {
+        const index = BASE58_ALPHABET.indexOf(char);
+        if (index < 0) {
+            throw new Error(`Invalid base58 character ${char}`);
+        }
+        decoded = decoded * 58n + BigInt(index);
+    }
+    const bytes = [];
+    while (decoded > 0n) {
+        bytes.unshift(Number(decoded % 256n));
+        decoded /= 256n;
+    }
+    for (const char of value) {
+        if (char !== BASE58_ZERO) {
+            break;
+        }
+        bytes.unshift(0);
+    }
+    return new Uint8Array(bytes);
+}
+export function solToLamports(value) {
+    const normalized = value.trim();
+    if (!/^\d+(\.\d{0,9})?$/.test(normalized)) {
+        throw new Error('Enter a SOL amount with up to 9 decimals');
+    }
+    const [whole, fractional = ''] = normalized.split('.');
+    return BigInt(whole || '0') * LAMPORTS_PER_SOL + BigInt(fractional.padEnd(9, '0'));
+}
+export function lamportsToSol(lamportsValue) {
+    if (lamportsValue === null) {
+        return 'Unknown';
+    }
+    const whole = lamportsValue / LAMPORTS_PER_SOL;
+    const fractional = (lamportsValue % LAMPORTS_PER_SOL).toString().padStart(9, '0').replace(/0+$/, '');
+    return fractional ? `${whole}.${fractional} SOL` : `${whole} SOL`;
+}
+export async function solanaRpc({ endpoint, method, params }) {
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+            jsonrpc: '2.0',
+            id: `ferno-${Date.now()}`,
+            method,
+            params
+        })
+    });
+    if (!response.ok) {
+        throw new Error(`Solana RPC ${response.status}`);
+    }
+    const payload = (await response.json());
+    if (payload.error) {
+        throw new Error(payload.error.message ?? 'Solana RPC request failed');
+    }
+    if (payload.result === undefined) {
+        throw new Error('Solana RPC returned no result');
+    }
+    return payload.result;
+}
+export async function getLatestSolanaBlockhash(endpoint) {
+    const result = await solanaRpc({
+        endpoint,
+        method: 'getLatestBlockhash',
+        params: [{ commitment: 'confirmed' }]
+    });
+    return result.value.blockhash;
+}
+export async function getSolanaBalance(endpoint, address) {
+    const result = await solanaRpc({
+        endpoint,
+        method: 'getBalance',
+        params: [address, { commitment: 'confirmed' }]
+    });
+    return BigInt(result.value);
+}
+export async function sendSerializedSolanaTransaction(endpoint, transaction) {
+    return await solanaRpc({
+        endpoint,
+        method: 'sendTransaction',
+        params: [
+            bytesToBase64(transaction),
+            {
+                encoding: 'base64',
+                preflightCommitment: 'confirmed',
+                skipPreflight: false
+            }
+        ]
+    });
+}
+export function createSystemTransferTransaction({ blockhash, fromAddress, lamports, toAddress }) {
+    const from = base58Decode(fromAddress);
+    const to = base58Decode(toAddress);
+    const recentBlockhash = base58Decode(blockhash);
+    const systemProgram = base58Decode('11111111111111111111111111111111');
+    if (from.byteLength !== 32 || to.byteLength !== 32 || recentBlockhash.byteLength !== 32) {
+        throw new Error('Invalid Solana transfer address or blockhash');
+    }
+    const transferData = new Uint8Array(12);
+    const transferDataView = new DataView(transferData.buffer);
+    transferDataView.setUint32(0, 2, true);
+    transferDataView.setBigUint64(4, lamports, true);
+    const instruction = concatBytes(new Uint8Array([2]), encodeShortVecLength(2), new Uint8Array([0, 1]), encodeShortVecLength(transferData.byteLength), transferData);
+    const messageBytes = concatBytes(new Uint8Array([1, 0, 1]), encodeShortVecLength(3), from, to, systemProgram, recentBlockhash, encodeShortVecLength(1), instruction);
+    const transaction = concatBytes(encodeShortVecLength(1), new Uint8Array(64), messageBytes);
+    return { messageBytes, transaction };
+}
+export function applySolanaTransactionSignature(transaction, signature) {
+    if (signature.byteLength !== 64) {
+        throw new Error('Solana transaction signatures must be 64 bytes');
+    }
+    const signed = new Uint8Array(transaction);
+    const signatureOffset = encodeShortVecLength(1).byteLength;
+    signed.set(signature, signatureOffset);
+    return signed;
+}
+export function normalizeSignatureBytes(signature) {
+    return typeof signature === 'string' ? base58Decode(signature) : new Uint8Array(signature);
+}
+function bytesToBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+function encodeShortVecLength(length) {
+    const bytes = [];
+    let remaining = length;
+    do {
+        let byte = remaining & 0x7f;
+        remaining >>= 7;
+        if (remaining > 0) {
+            byte |= 0x80;
+        }
+        bytes.push(byte);
+    } while (remaining > 0);
+    return new Uint8Array(bytes);
+}
+function concatBytes(...chunks) {
+    const length = chunks.reduce((total, chunk) => total + chunk.byteLength, 0);
+    const bytes = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}

package/dist/wallet-standard.d.ts

@@ -118,8 +118,20 @@ export interface StandardWallet<TWallet extends StandardWalletProvider = Standar
     icon: string;
     wallet: TWallet;
 }
+export declare const LAST_USED_WALLET_STORAGE_KEY = "lastConnectedWallet";
+export interface WalletStorage {
+    getItem(key: string): string | null;
+    removeItem(key: string): void;
+    setItem(key: string, value: string): void;
+}
 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>[];
+export declare function dedupeStandardWallets<TWallet extends StandardWalletProvider>(wallets: readonly StandardWallet<TWallet>[], preferredNames?: readonly string[], lastUsedWalletName?: string | null): StandardWallet<TWallet>[];
+export declare function adaptStandardWallets<TWallet extends StandardWalletProvider>(wallets: readonly TWallet[], preferredNames?: readonly string[], lastUsedWalletName?: string | null): StandardWallet<TWallet>[];
+export declare function sortWalletsByLastUsed<TWallet extends {
+    name: string;
+}>(wallets: readonly TWallet[], lastUsedWalletName: string | null | undefined): TWallet[];
+export declare function readLastUsedWalletName(storage: WalletStorage | null | undefined, storageKey?: string): string | null;
+export declare function saveLastUsedWalletName(storage: WalletStorage | null | undefined, walletName: string, storageKey?: string): void;
+export declare function clearLastUsedWalletName(storage: WalletStorage | null | undefined, storageKey?: string): void;
 //# sourceMappingURL=wallet-standard.d.ts.map

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

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

package/dist/wallet-standard.js

@@ -5,6 +5,7 @@ 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 const LAST_USED_WALLET_STORAGE_KEY = 'lastConnectedWallet';
 export function isSolanaWallet(wallet) {
     const { features, chains } = wallet;
     if (!features) {
@@ -27,7 +28,7 @@ export function adaptWallet(wallet) {
         wallet
     };
 }
-export function dedupeStandardWallets(wallets, preferredNames = []) {
+export function dedupeStandardWallets(wallets, preferredNames = [], lastUsedWalletName = null) {
     const walletsByName = new Map();
     for (const wallet of wallets) {
         const existing = walletsByName.get(wallet.name);
@@ -44,11 +45,47 @@ export function dedupeStandardWallets(wallets, preferredNames = []) {
     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];
+    return sortWalletsByLastUsed([...preferred, ...otherWallets], lastUsedWalletName);
 }
-export function adaptStandardWallets(wallets, preferredNames = []) {
+export function adaptStandardWallets(wallets, preferredNames = [], lastUsedWalletName = null) {
     const adapted = wallets
         .map(adaptWallet)
         .filter((wallet) => wallet !== null);
-    return dedupeStandardWallets(adapted, preferredNames);
+    return dedupeStandardWallets(adapted, preferredNames, lastUsedWalletName);
+}
+export function sortWalletsByLastUsed(wallets, lastUsedWalletName) {
+    const ordered = [...wallets];
+    const walletName = lastUsedWalletName?.trim();
+    if (!walletName) {
+        return ordered;
+    }
+    const lastUsedIndex = ordered.findIndex((wallet) => wallet.name === walletName);
+    if (lastUsedIndex <= 0) {
+        return ordered;
+    }
+    const [lastUsedWallet] = ordered.splice(lastUsedIndex, 1);
+    return lastUsedWallet ? [lastUsedWallet, ...ordered] : ordered;
+}
+export function readLastUsedWalletName(storage, storageKey = LAST_USED_WALLET_STORAGE_KEY) {
+    try {
+        const walletName = storage?.getItem(storageKey)?.trim();
+        return walletName || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveLastUsedWalletName(storage, walletName, storageKey = LAST_USED_WALLET_STORAGE_KEY) {
+    try {
+        storage?.setItem(storageKey, walletName);
+    }
+    catch {
+    }
+}
+export function clearLastUsedWalletName(storage, storageKey = LAST_USED_WALLET_STORAGE_KEY) {
+    try {
+        storage?.removeItem(storageKey);
+    }
+    catch {
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fernolab/wallet-adapter-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-agnostic Solana Wallet Standard adapter core.",
   "type": "module",
   "sideEffects": false,
@@ -41,6 +41,9 @@
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.9"
+  },
+  "dependencies": {
+    "@noble/curves": "^2.2.0"
   }
 }