@joai/warps-adapter-solana 1.0.0-beta.23

package/README.md

@@ -0,0 +1,44 @@
+# @joai/warps-adapter-solana
+
+Solana blockchain adapter for the Warps SDK. Enables Warp execution on Solana mainnet, testnet, and devnet.
+
+## Installation
+
+```bash
+npm install @joai/warps-adapter-solana
+```
+
+## Usage
+
+```typescript
+import { WarpClient, withAdapterFallback } from '@joai/warps'
+import { SolanaAdapter } from '@joai/warps-adapter-solana'
+import { MultiversxAdapter } from '@joai/warps-adapter-multiversx'
+
+// Solana adapter requires a fallback adapter
+const client = new WarpClient(config, {
+  chains: [withAdapterFallback(SolanaAdapter, MultiversxAdapter)],
+})
+```
+
+## Supported Networks
+
+- **Solana Mainnet**
+- **Solana Testnet**
+- **Solana Devnet**
+
+## Features
+
+- Transaction creation and execution
+- Program (smart contract) interaction
+- Token transfers (SPL tokens)
+- Query program state
+- Transaction signing and sending
+- Explorer integration
+
+## Wallet Providers
+
+Supports multiple wallet providers:
+- Private key
+- Mnemonic
+- Read-only (for queries)

package/dist/index.d.cts

@@ -0,0 +1,223 @@
+import { WarpChainAsset, ChainAdapterFactory, WarpChainName, WarpChainEnv, AdapterWarpDataLoader, WarpClientConfig, WarpChainInfo, WarpChainAccount, WarpChainAction, WarpDataLoaderOptions, AdapterWarpExecutor, WarpExecutable, WarpActionExecutionResult, AdapterWarpExplorer, AdapterWarpOutput, Warp, WarpActionIndex, WarpAdapterGenericRemoteTransaction, ResolvedInput, WarpNativeValue, WarpExecutionOutput, AdapterWarpSerializer, WarpSerializer, WarpActionInputType, BaseWarpActionInputType, WarpAdapterGenericType, AdapterWarpWallet, WarpAdapterGenericTransaction, WarpWalletDetails, WarpWalletProvider } from '@joai/warps';
+import { Connection, VersionedTransaction } from '@solana/web3.js';
+
+declare const NativeTokenSol: WarpChainAsset;
+declare const SolanaAdapter: ChainAdapterFactory;
+
+declare const WarpSolanaConstants: {
+    ComputeUnitLimit: {
+        Default: number;
+        Transfer: number;
+        TokenTransfer: number;
+        ContractCall: number;
+    };
+    PriorityFee: {
+        Default: number;
+    };
+    Validation: {
+        MinComputeUnits: number;
+        MaxComputeUnits: number;
+    };
+    Programs: {
+        TokenProgram: string;
+        SystemProgram: string;
+    };
+    NativeToken: {
+        Identifier: string;
+        Decimals: number;
+    };
+};
+declare enum SolanaExplorers {
+    Solscan = "solscan",
+    SolscanMainnet = "solscan_mainnet",
+    SolscanDevnet = "solscan_devnet",
+    SolanaExplorer = "solana_explorer",
+    SolanaExplorerMainnet = "solana_explorer_mainnet",
+    SolanaExplorerDevnet = "solana_explorer_devnet"
+}
+type ExplorerName = SolanaExplorers;
+declare const SolanaExplorerMap: {
+    readonly solana: {
+        readonly mainnet: readonly [SolanaExplorers.SolscanMainnet, SolanaExplorers.SolanaExplorerMainnet];
+        readonly testnet: readonly [SolanaExplorers.Solscan, SolanaExplorers.SolanaExplorer];
+        readonly devnet: readonly [SolanaExplorers.SolscanDevnet, SolanaExplorers.SolanaExplorerDevnet];
+    };
+};
+declare const ExplorerUrls: Record<ExplorerName, string>;
+declare const SolanaExplorerNames: {
+    readonly mainnet: readonly [SolanaExplorers.SolscanMainnet, SolanaExplorers.SolanaExplorerMainnet];
+    readonly testnet: readonly [SolanaExplorers.Solscan, SolanaExplorers.SolanaExplorer];
+    readonly devnet: readonly [SolanaExplorers.SolscanDevnet, SolanaExplorers.SolanaExplorerDevnet];
+};
+declare const SolanaExplorerUrls: Record<ExplorerName, string>;
+declare const X402SolanaNetworkIdentifiers: {
+    readonly Mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly Devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+};
+declare const SupportedX402SolanaNetworks: string[];
+
+declare const KnownTokens: Partial<Record<WarpChainName, Record<WarpChainEnv, WarpChainAsset[]>>>;
+declare const findKnownTokenById: (chain: WarpChainName, env: WarpChainEnv, id: string) => WarpChainAsset | null;
+declare const getKnownTokensForChain: (chainName: WarpChainName, env: WarpChainEnv) => WarpChainAsset[];
+
+declare module '@solana/kit' {
+  export function createKeyPairSignerFromBytes(bytes: Uint8Array): Promise<{
+    signMessage: (message: Uint8Array) => Promise<Uint8Array>
+    signTransaction: (transaction: unknown) => Promise<unknown>
+  }>
+}
+
+declare module '@x402/svm/exact/client' {
+  export function registerExactSvmScheme(client: unknown, options: { signer: unknown }): void
+}
+
+declare class WarpSolanaDataLoader implements AdapterWarpDataLoader {
+    private readonly config;
+    private readonly chain;
+    readonly connection: Connection;
+    private cache;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    getAccount(address: string): Promise<WarpChainAccount>;
+    getAccountAssets(address: string): Promise<WarpChainAsset[]>;
+    getAsset(identifier: string): Promise<WarpChainAsset | null>;
+    getAction(identifier: string, awaitCompleted?: boolean): Promise<WarpChainAction | null>;
+    getAccountActions(address: string, options?: WarpDataLoaderOptions): Promise<WarpChainAction[]>;
+    private getTokenBalances;
+    private getTokenMetadata;
+    private waitForTransaction;
+    private tryFetchTransaction;
+    private calculateBackoffDelay;
+    private createFailedAction;
+    private parseTransactionToAction;
+    private extractAccountKeys;
+    private calculateTransactionValue;
+    private determineFunctionName;
+}
+
+declare class WarpSolanaExecutor implements AdapterWarpExecutor {
+    private readonly config;
+    private readonly chain;
+    private readonly serializer;
+    private readonly connection;
+    private readonly output;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    createTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    createTransferTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    createContractCallTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    private ensureATAs;
+    private encodeInstructionData;
+    private encodeBasicInstructionData;
+    private encodeArgs;
+    private buildInstructionAccounts;
+    private extractAccountInputs;
+    private resolveAccountFromInput;
+    private interpolateAccountAddress;
+    private createTokenTransferTransaction;
+    private createSingleTokenTransfer;
+    executeQuery(executable: WarpExecutable): Promise<WarpActionExecutionResult>;
+    verifyMessage(message: string, signature: string): Promise<string>;
+    private setTransactionDefaults;
+    private toPublicKey;
+    private extractContractArgs;
+    private buildInstructionData;
+    private extractAccountAddress;
+    private resolveAccountPubkey;
+    private determineAccountFlags;
+    private addComputeBudgetInstructions;
+    private buildAccountMetaMap;
+    private sortAccounts;
+    private buildAccountIndexMap;
+    private compileInstructions;
+    private buildMessageV0;
+}
+
+declare class WarpSolanaExplorer implements AdapterWarpExplorer {
+    private readonly chain;
+    private readonly config;
+    constructor(chain: WarpChainInfo, config: WarpClientConfig);
+    private getExplorers;
+    private getPrimaryExplorer;
+    private getExplorerUrlByName;
+    getAccountUrl(address: string, explorer?: ExplorerName): string;
+    getTransactionUrl(hash: string, explorer?: ExplorerName): string;
+    getBlockUrl(blockNumber: string | number, explorer?: ExplorerName): string;
+    getAssetUrl(identifier: string, explorer?: ExplorerName): string;
+    getContractUrl(address: string, explorer?: ExplorerName): string;
+    getAllExplorers(): readonly ExplorerName[];
+    getExplorerByName(name: string): ExplorerName | undefined;
+    getAccountUrls(address: string): Record<ExplorerName, string>;
+    getTransactionUrls(hash: string): Record<ExplorerName, string>;
+    getAssetUrls(identifier: string): Record<ExplorerName, string>;
+    getContractUrls(address: string): Record<ExplorerName, string>;
+    getBlockUrls(blockNumber: string | number): Record<ExplorerName, string>;
+}
+
+declare class WarpSolanaOutput implements AdapterWarpOutput {
+    private readonly config;
+    private readonly chain;
+    private readonly serializer;
+    private readonly connection;
+    private readonly cache;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    getActionExecution(warp: Warp, actionIndex: WarpActionIndex, tx: WarpAdapterGenericRemoteTransaction): Promise<WarpActionExecutionResult>;
+    private createFailedExecution;
+    private handleWarpChainAction;
+    private handleTransactionSignature;
+    extractQueryOutput(warp: Warp, typedValues: unknown[], actionIndex: number, inputs: ResolvedInput[]): Promise<{
+        values: {
+            string: string[];
+            native: WarpNativeValue[];
+            mapped: Record<string, any>;
+        };
+        output: WarpExecutionOutput;
+    }>;
+    getTransactionStatus(txHash: string): Promise<{
+        status: 'pending' | 'confirmed' | 'failed';
+        blockNumber?: number;
+        gasUsed?: bigint;
+    }>;
+    getTransactionReceipt(txHash: string): Promise<any>;
+}
+
+declare class WarpSolanaSerializer implements AdapterWarpSerializer {
+    readonly coreSerializer: WarpSerializer;
+    constructor();
+    typedToString(value: any): string;
+    typedToNative(value: any): [WarpActionInputType, WarpNativeValue];
+    nativeToTyped(type: WarpActionInputType, value: WarpNativeValue): any;
+    nativeToType(type: BaseWarpActionInputType): WarpAdapterGenericType;
+    stringToTyped(value: string): any;
+    private parseNativeValue;
+}
+
+declare class WarpSolanaWallet implements AdapterWarpWallet {
+    private config;
+    private chain;
+    private connection;
+    private walletProvider;
+    private cachedAddress;
+    private cachedPublicKey;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    signTransaction(tx: WarpAdapterGenericTransaction): Promise<WarpAdapterGenericTransaction>;
+    signTransactions(txs: WarpAdapterGenericTransaction[]): Promise<WarpAdapterGenericTransaction[]>;
+    signMessage(message: string): Promise<string>;
+    sendTransaction(tx: WarpAdapterGenericTransaction): Promise<string>;
+    sendTransactions(txs: WarpAdapterGenericTransaction[]): Promise<string[]>;
+    importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails>;
+    importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails>;
+    export(provider: WarpWalletProvider): Promise<WarpWalletDetails>;
+    generate(provider: WarpWalletProvider): Promise<WarpWalletDetails>;
+    getAddress(): string | null;
+    getPublicKey(): string | null;
+    registerX402Handlers(client: unknown): Promise<Record<string, () => void>>;
+    private createProvider;
+    private initializeCache;
+    private createProviderForOperation;
+    private resolveTransaction;
+    private shouldSkipPreflight;
+    private sendWithRetry;
+    private sendRawTransaction;
+    private isSimulationError;
+}
+
+export { type ExplorerName, ExplorerUrls, KnownTokens, NativeTokenSol, SolanaAdapter, SolanaExplorerMap, SolanaExplorerNames, SolanaExplorerUrls, SolanaExplorers, SupportedX402SolanaNetworks, WarpSolanaConstants, WarpSolanaDataLoader, WarpSolanaExecutor, WarpSolanaExplorer, WarpSolanaOutput, WarpSolanaSerializer, WarpSolanaWallet, X402SolanaNetworkIdentifiers, findKnownTokenById, getKnownTokensForChain };

package/dist/index.d.ts

@@ -0,0 +1,223 @@
+import { WarpChainAsset, ChainAdapterFactory, WarpChainName, WarpChainEnv, AdapterWarpDataLoader, WarpClientConfig, WarpChainInfo, WarpChainAccount, WarpChainAction, WarpDataLoaderOptions, AdapterWarpExecutor, WarpExecutable, WarpActionExecutionResult, AdapterWarpExplorer, AdapterWarpOutput, Warp, WarpActionIndex, WarpAdapterGenericRemoteTransaction, ResolvedInput, WarpNativeValue, WarpExecutionOutput, AdapterWarpSerializer, WarpSerializer, WarpActionInputType, BaseWarpActionInputType, WarpAdapterGenericType, AdapterWarpWallet, WarpAdapterGenericTransaction, WarpWalletDetails, WarpWalletProvider } from '@joai/warps';
+import { Connection, VersionedTransaction } from '@solana/web3.js';
+
+declare const NativeTokenSol: WarpChainAsset;
+declare const SolanaAdapter: ChainAdapterFactory;
+
+declare const WarpSolanaConstants: {
+    ComputeUnitLimit: {
+        Default: number;
+        Transfer: number;
+        TokenTransfer: number;
+        ContractCall: number;
+    };
+    PriorityFee: {
+        Default: number;
+    };
+    Validation: {
+        MinComputeUnits: number;
+        MaxComputeUnits: number;
+    };
+    Programs: {
+        TokenProgram: string;
+        SystemProgram: string;
+    };
+    NativeToken: {
+        Identifier: string;
+        Decimals: number;
+    };
+};
+declare enum SolanaExplorers {
+    Solscan = "solscan",
+    SolscanMainnet = "solscan_mainnet",
+    SolscanDevnet = "solscan_devnet",
+    SolanaExplorer = "solana_explorer",
+    SolanaExplorerMainnet = "solana_explorer_mainnet",
+    SolanaExplorerDevnet = "solana_explorer_devnet"
+}
+type ExplorerName = SolanaExplorers;
+declare const SolanaExplorerMap: {
+    readonly solana: {
+        readonly mainnet: readonly [SolanaExplorers.SolscanMainnet, SolanaExplorers.SolanaExplorerMainnet];
+        readonly testnet: readonly [SolanaExplorers.Solscan, SolanaExplorers.SolanaExplorer];
+        readonly devnet: readonly [SolanaExplorers.SolscanDevnet, SolanaExplorers.SolanaExplorerDevnet];
+    };
+};
+declare const ExplorerUrls: Record<ExplorerName, string>;
+declare const SolanaExplorerNames: {
+    readonly mainnet: readonly [SolanaExplorers.SolscanMainnet, SolanaExplorers.SolanaExplorerMainnet];
+    readonly testnet: readonly [SolanaExplorers.Solscan, SolanaExplorers.SolanaExplorer];
+    readonly devnet: readonly [SolanaExplorers.SolscanDevnet, SolanaExplorers.SolanaExplorerDevnet];
+};
+declare const SolanaExplorerUrls: Record<ExplorerName, string>;
+declare const X402SolanaNetworkIdentifiers: {
+    readonly Mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly Devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+};
+declare const SupportedX402SolanaNetworks: string[];
+
+declare const KnownTokens: Partial<Record<WarpChainName, Record<WarpChainEnv, WarpChainAsset[]>>>;
+declare const findKnownTokenById: (chain: WarpChainName, env: WarpChainEnv, id: string) => WarpChainAsset | null;
+declare const getKnownTokensForChain: (chainName: WarpChainName, env: WarpChainEnv) => WarpChainAsset[];
+
+declare module '@solana/kit' {
+  export function createKeyPairSignerFromBytes(bytes: Uint8Array): Promise<{
+    signMessage: (message: Uint8Array) => Promise<Uint8Array>
+    signTransaction: (transaction: unknown) => Promise<unknown>
+  }>
+}
+
+declare module '@x402/svm/exact/client' {
+  export function registerExactSvmScheme(client: unknown, options: { signer: unknown }): void
+}
+
+declare class WarpSolanaDataLoader implements AdapterWarpDataLoader {
+    private readonly config;
+    private readonly chain;
+    readonly connection: Connection;
+    private cache;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    getAccount(address: string): Promise<WarpChainAccount>;
+    getAccountAssets(address: string): Promise<WarpChainAsset[]>;
+    getAsset(identifier: string): Promise<WarpChainAsset | null>;
+    getAction(identifier: string, awaitCompleted?: boolean): Promise<WarpChainAction | null>;
+    getAccountActions(address: string, options?: WarpDataLoaderOptions): Promise<WarpChainAction[]>;
+    private getTokenBalances;
+    private getTokenMetadata;
+    private waitForTransaction;
+    private tryFetchTransaction;
+    private calculateBackoffDelay;
+    private createFailedAction;
+    private parseTransactionToAction;
+    private extractAccountKeys;
+    private calculateTransactionValue;
+    private determineFunctionName;
+}
+
+declare class WarpSolanaExecutor implements AdapterWarpExecutor {
+    private readonly config;
+    private readonly chain;
+    private readonly serializer;
+    private readonly connection;
+    private readonly output;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    createTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    createTransferTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    createContractCallTransaction(executable: WarpExecutable): Promise<VersionedTransaction>;
+    private ensureATAs;
+    private encodeInstructionData;
+    private encodeBasicInstructionData;
+    private encodeArgs;
+    private buildInstructionAccounts;
+    private extractAccountInputs;
+    private resolveAccountFromInput;
+    private interpolateAccountAddress;
+    private createTokenTransferTransaction;
+    private createSingleTokenTransfer;
+    executeQuery(executable: WarpExecutable): Promise<WarpActionExecutionResult>;
+    verifyMessage(message: string, signature: string): Promise<string>;
+    private setTransactionDefaults;
+    private toPublicKey;
+    private extractContractArgs;
+    private buildInstructionData;
+    private extractAccountAddress;
+    private resolveAccountPubkey;
+    private determineAccountFlags;
+    private addComputeBudgetInstructions;
+    private buildAccountMetaMap;
+    private sortAccounts;
+    private buildAccountIndexMap;
+    private compileInstructions;
+    private buildMessageV0;
+}
+
+declare class WarpSolanaExplorer implements AdapterWarpExplorer {
+    private readonly chain;
+    private readonly config;
+    constructor(chain: WarpChainInfo, config: WarpClientConfig);
+    private getExplorers;
+    private getPrimaryExplorer;
+    private getExplorerUrlByName;
+    getAccountUrl(address: string, explorer?: ExplorerName): string;
+    getTransactionUrl(hash: string, explorer?: ExplorerName): string;
+    getBlockUrl(blockNumber: string | number, explorer?: ExplorerName): string;
+    getAssetUrl(identifier: string, explorer?: ExplorerName): string;
+    getContractUrl(address: string, explorer?: ExplorerName): string;
+    getAllExplorers(): readonly ExplorerName[];
+    getExplorerByName(name: string): ExplorerName | undefined;
+    getAccountUrls(address: string): Record<ExplorerName, string>;
+    getTransactionUrls(hash: string): Record<ExplorerName, string>;
+    getAssetUrls(identifier: string): Record<ExplorerName, string>;
+    getContractUrls(address: string): Record<ExplorerName, string>;
+    getBlockUrls(blockNumber: string | number): Record<ExplorerName, string>;
+}
+
+declare class WarpSolanaOutput implements AdapterWarpOutput {
+    private readonly config;
+    private readonly chain;
+    private readonly serializer;
+    private readonly connection;
+    private readonly cache;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    getActionExecution(warp: Warp, actionIndex: WarpActionIndex, tx: WarpAdapterGenericRemoteTransaction): Promise<WarpActionExecutionResult>;
+    private createFailedExecution;
+    private handleWarpChainAction;
+    private handleTransactionSignature;
+    extractQueryOutput(warp: Warp, typedValues: unknown[], actionIndex: number, inputs: ResolvedInput[]): Promise<{
+        values: {
+            string: string[];
+            native: WarpNativeValue[];
+            mapped: Record<string, any>;
+        };
+        output: WarpExecutionOutput;
+    }>;
+    getTransactionStatus(txHash: string): Promise<{
+        status: 'pending' | 'confirmed' | 'failed';
+        blockNumber?: number;
+        gasUsed?: bigint;
+    }>;
+    getTransactionReceipt(txHash: string): Promise<any>;
+}
+
+declare class WarpSolanaSerializer implements AdapterWarpSerializer {
+    readonly coreSerializer: WarpSerializer;
+    constructor();
+    typedToString(value: any): string;
+    typedToNative(value: any): [WarpActionInputType, WarpNativeValue];
+    nativeToTyped(type: WarpActionInputType, value: WarpNativeValue): any;
+    nativeToType(type: BaseWarpActionInputType): WarpAdapterGenericType;
+    stringToTyped(value: string): any;
+    private parseNativeValue;
+}
+
+declare class WarpSolanaWallet implements AdapterWarpWallet {
+    private config;
+    private chain;
+    private connection;
+    private walletProvider;
+    private cachedAddress;
+    private cachedPublicKey;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo);
+    signTransaction(tx: WarpAdapterGenericTransaction): Promise<WarpAdapterGenericTransaction>;
+    signTransactions(txs: WarpAdapterGenericTransaction[]): Promise<WarpAdapterGenericTransaction[]>;
+    signMessage(message: string): Promise<string>;
+    sendTransaction(tx: WarpAdapterGenericTransaction): Promise<string>;
+    sendTransactions(txs: WarpAdapterGenericTransaction[]): Promise<string[]>;
+    importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails>;
+    importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails>;
+    export(provider: WarpWalletProvider): Promise<WarpWalletDetails>;
+    generate(provider: WarpWalletProvider): Promise<WarpWalletDetails>;
+    getAddress(): string | null;
+    getPublicKey(): string | null;
+    registerX402Handlers(client: unknown): Promise<Record<string, () => void>>;
+    private createProvider;
+    private initializeCache;
+    private createProviderForOperation;
+    private resolveTransaction;
+    private shouldSkipPreflight;
+    private sendWithRetry;
+    private sendRawTransaction;
+    private isSimulationError;
+}
+
+export { type ExplorerName, ExplorerUrls, KnownTokens, NativeTokenSol, SolanaAdapter, SolanaExplorerMap, SolanaExplorerNames, SolanaExplorerUrls, SolanaExplorers, SupportedX402SolanaNetworks, WarpSolanaConstants, WarpSolanaDataLoader, WarpSolanaExecutor, WarpSolanaExplorer, WarpSolanaOutput, WarpSolanaSerializer, WarpSolanaWallet, X402SolanaNetworkIdentifiers, findKnownTokenById, getKnownTokensForChain };