@blockrun/clawrouter 0.11.14 → 0.12.1

package/dist/index.d.ts

@@ -760,6 +760,8 @@ type WalletResolution = {
     source: "saved" | "env" | "generated";
     mnemonic?: string;
     solanaPrivateKeyBytes?: Uint8Array;
+    /** Legacy (secp256k1) Solana key bytes, present when migration is needed. */
+    legacySolanaKeyBytes?: Uint8Array;
 };
 /**
  * Set up Solana wallet for existing EVM-only users.
@@ -1050,6 +1052,9 @@ declare function formatDuration(seconds: number): string;
  *
  * BIP-39 mnemonic generation + BIP-44 HD key derivation for EVM and Solana.
  * Absorbed from @blockrun/clawwallet. No file I/O here - auth.ts handles persistence.
+ *
+ * Solana uses SLIP-10 Ed25519 derivation (Phantom/Solflare/Backpack compatible).
+ * EVM uses standard BIP-32 secp256k1 derivation.
  */
 interface DerivedKeys {
     mnemonic: string;
@@ -1074,15 +1079,62 @@ declare function deriveEvmKey(mnemonic: string): {
     address: string;
 };
 /**
- * Derive 32-byte Solana private key from a BIP-39 mnemonic.
- * Path: m/44'/501'/0'/0' (standard Solana derivation)
+ * Derive 32-byte Solana private key using SLIP-10 Ed25519 derivation.
+ * Path: m/44'/501'/0'/0' (Phantom / Solflare / Backpack compatible)
+ *
+ * Algorithm (SLIP-0010 for Ed25519):
+ *   1. Master: HMAC-SHA512(key="ed25519 seed", data=bip39_seed) → IL=key, IR=chainCode
+ *   2. For each hardened child index:
+ *      HMAC-SHA512(key=chainCode, data=0x00 || key || ser32(index)) → split again
+ *   3. Final IL (32 bytes) = Ed25519 private key seed
  */
 declare function deriveSolanaKeyBytes(mnemonic: string): Uint8Array;
+/**
+ * Legacy Solana key derivation using secp256k1 BIP-32 (incorrect for Solana).
+ * Kept for migration: sweeping funds from wallets derived with the old method.
+ */
+declare function deriveSolanaKeyBytesLegacy(mnemonic: string): Uint8Array;
 /**
  * Derive both EVM and Solana keys from a single mnemonic.
  */
 declare function deriveAllKeys(mnemonic: string): DerivedKeys;
 
+/**
+ * Solana Wallet Sweep — migrate USDC from legacy (secp256k1) to new (SLIP-10) wallet.
+ *
+ * Used when upgrading from the old BIP-32 secp256k1 derivation to correct
+ * SLIP-10 Ed25519 derivation. Transfers all USDC from the old address to the new one.
+ *
+ * Uses raw instruction encoding to avoid @solana-program/token dependency.
+ */
+type SweepResult = {
+    transferred: string;
+    transferredMicros: bigint;
+    txSignature: string;
+    oldAddress: string;
+    newAddress: string;
+};
+type SweepError = {
+    error: string;
+    oldAddress: string;
+    newAddress?: string;
+    solBalance?: bigint;
+    usdcBalance?: bigint;
+};
+/**
+ * Sweep all USDC from old (legacy secp256k1) wallet to new (SLIP-10) wallet.
+ *
+ * The NEW wallet pays gas fees (not the old one). Users can't access the old
+ * wallet from Phantom/Solflare, so they can't send SOL to it. Instead they
+ * fund the new (Phantom-compatible) wallet with a tiny bit of SOL for gas.
+ *
+ * @param oldKeyBytes - 32-byte private key from legacy derivation
+ * @param newKeyBytes - 32-byte private key from SLIP-10 derivation (pays gas)
+ * @param rpcUrl - Optional RPC URL override
+ * @returns SweepResult on success, SweepError on failure
+ */
+declare function sweepSolanaWallet(oldKeyBytes: Uint8Array, newKeyBytes: Uint8Array, rpcUrl?: string): Promise<SweepResult | SweepError>;
+
 /**
  * Typed Error Classes for ClawRouter
  *
@@ -1328,4 +1380,4 @@ declare function buildPartnerTools(proxyBaseUrl: string): PartnerToolDefinition[
 
 declare const plugin: OpenClawPluginDefinition;
 
-export { type AggregatedStats, BALANCE_THRESHOLDS, BLOCKRUN_MODELS, type BalanceInfo, BalanceMonitor, type CachedLLMResponse, type CachedResponse, type CheckResult, DEFAULT_RETRY_CONFIG, DEFAULT_ROUTING_CONFIG, DEFAULT_SESSION_CONFIG, type DailyStats, type DerivedKeys, EmptyWalletError, FileSpendControlStorage, InMemorySpendControlStorage, InsufficientFundsError, type InsufficientFundsInfo, type LowBalanceInfo, MODEL_ALIASES, OPENCLAW_MODELS, PARTNER_SERVICES, type PartnerServiceDefinition, type PartnerToolDefinition, type PaymentChain, type ProxyHandle, type ProxyOptions, RequestDeduplicator, ResponseCache, type ResponseCacheConfig, type RetryConfig, type RoutingConfig, type RoutingDecision, RpcError, type SessionConfig, type SessionEntry, SessionStore, type SolanaBalanceInfo, SolanaBalanceMonitor, SpendControl, type SpendControlOptions, type SpendControlStorage, type SpendLimits, type SpendRecord, type SpendWindow, type SpendingStatus, type SufficiencyResult, type Tier, type UsageEntry, type WalletConfig, type WalletResolution, blockrunProvider, buildPartnerTools, buildProviderModels, calculateModelCost, plugin as default, deriveAllKeys, deriveEvmKey, deriveSolanaKeyBytes, fetchWithRetry, formatDuration, formatStatsAscii, generateWalletMnemonic, getAgenticModels, getFallbackChain, getFallbackChainFiltered, getModelContextWindow, getPartnerService, getProxyPort, getSessionId, getStats, hashRequestContent, isAgenticModel, isBalanceError, isEmptyWalletError, isInsufficientFundsError, isRetryable, isRpcError, isValidMnemonic, loadPaymentChain, logUsage, resolveModelAlias, resolvePaymentChain, route, savePaymentChain, setupSolana, startProxy };
+export { type AggregatedStats, BALANCE_THRESHOLDS, BLOCKRUN_MODELS, type BalanceInfo, BalanceMonitor, type CachedLLMResponse, type CachedResponse, type CheckResult, DEFAULT_RETRY_CONFIG, DEFAULT_ROUTING_CONFIG, DEFAULT_SESSION_CONFIG, type DailyStats, type DerivedKeys, EmptyWalletError, FileSpendControlStorage, InMemorySpendControlStorage, InsufficientFundsError, type InsufficientFundsInfo, type LowBalanceInfo, MODEL_ALIASES, OPENCLAW_MODELS, PARTNER_SERVICES, type PartnerServiceDefinition, type PartnerToolDefinition, type PaymentChain, type ProxyHandle, type ProxyOptions, RequestDeduplicator, ResponseCache, type ResponseCacheConfig, type RetryConfig, type RoutingConfig, type RoutingDecision, RpcError, type SessionConfig, type SessionEntry, SessionStore, type SolanaBalanceInfo, SolanaBalanceMonitor, SpendControl, type SpendControlOptions, type SpendControlStorage, type SpendLimits, type SpendRecord, type SpendWindow, type SpendingStatus, type SufficiencyResult, type SweepError, type SweepResult, type Tier, type UsageEntry, type WalletConfig, type WalletResolution, blockrunProvider, buildPartnerTools, buildProviderModels, calculateModelCost, plugin as default, deriveAllKeys, deriveEvmKey, deriveSolanaKeyBytes, deriveSolanaKeyBytesLegacy, fetchWithRetry, formatDuration, formatStatsAscii, generateWalletMnemonic, getAgenticModels, getFallbackChain, getFallbackChainFiltered, getModelContextWindow, getPartnerService, getProxyPort, getSessionId, getStats, hashRequestContent, isAgenticModel, isBalanceError, isEmptyWalletError, isInsufficientFundsError, isRetryable, isRpcError, isValidMnemonic, loadPaymentChain, logUsage, resolveModelAlias, resolvePaymentChain, route, savePaymentChain, setupSolana, startProxy, sweepSolanaWallet };