@vleap/warps-adapter-solana 0.1.0-beta.1

package/dist/index.d.cts

@@ -0,0 +1,190 @@
+import { WarpChainAsset, AdapterFactory, WarpChain, 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 } from '@vleap/warps';
+import { Transaction } from '@solana/web3.js';
+
+declare const NativeTokenSol: WarpChainAsset;
+declare const getSolanaAdapter: AdapterFactory;
+
+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 KnownTokens: Record<WarpChain, Record<string, WarpChainAsset[]>>;
+declare const findKnownTokenById: (chain: WarpChain, env: WarpChainEnv, id: string) => WarpChainAsset | null;
+declare const getKnownTokensForChain: (chainName: string, env?: string) => WarpChainAsset[];
+
+interface TokenMetadata {
+    name: string;
+    symbol: string;
+    decimals: number;
+    logoUrl?: string;
+}
+interface TokenBalance {
+    tokenAddress: string;
+    balance: bigint;
+    metadata: TokenMetadata;
+}
+
+declare class WarpSolanaDataLoader implements AdapterWarpDataLoader {
+    private readonly config;
+    private readonly chain;
+    private 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;
+}
+
+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<Transaction>;
+    createTransferTransaction(executable: WarpExecutable): Promise<Transaction>;
+    createContractCallTransaction(executable: WarpExecutable): Promise<Transaction>;
+    private encodeInstructionData;
+    private encodeBasicInstructionData;
+    private encodeArgs;
+    private buildInstructionAccounts;
+    private createTokenTransferTransaction;
+    private createSingleTokenTransfer;
+    executeQuery(executable: WarpExecutable): Promise<WarpActionExecutionResult>;
+    verifyMessage(message: string, signature: string): Promise<string>;
+    private setTransactionDefaults;
+}
+
+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;
+    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[]>;
+    create(mnemonic: string): {
+        address: string;
+        privateKey: string;
+        mnemonic: string;
+    };
+    generate(): {
+        address: string;
+        privateKey: string;
+        mnemonic: string;
+    };
+    getAddress(): string | null;
+    getPublicKey(): string | null;
+    private getKeypair;
+}
+
+export { type ExplorerName, ExplorerUrls, KnownTokens, NativeTokenSol, SolanaExplorerMap, SolanaExplorerNames, SolanaExplorerUrls, SolanaExplorers, type TokenBalance, type TokenMetadata, WarpSolanaConstants, WarpSolanaDataLoader, WarpSolanaExecutor, WarpSolanaExplorer, WarpSolanaOutput, WarpSolanaSerializer, WarpSolanaWallet, findKnownTokenById, getKnownTokensForChain, getSolanaAdapter };

package/dist/index.d.ts

@@ -0,0 +1,190 @@
+import { WarpChainAsset, AdapterFactory, WarpChain, 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 } from '@vleap/warps';
+import { Transaction } from '@solana/web3.js';
+
+declare const NativeTokenSol: WarpChainAsset;
+declare const getSolanaAdapter: AdapterFactory;
+
+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 KnownTokens: Record<WarpChain, Record<string, WarpChainAsset[]>>;
+declare const findKnownTokenById: (chain: WarpChain, env: WarpChainEnv, id: string) => WarpChainAsset | null;
+declare const getKnownTokensForChain: (chainName: string, env?: string) => WarpChainAsset[];
+
+interface TokenMetadata {
+    name: string;
+    symbol: string;
+    decimals: number;
+    logoUrl?: string;
+}
+interface TokenBalance {
+    tokenAddress: string;
+    balance: bigint;
+    metadata: TokenMetadata;
+}
+
+declare class WarpSolanaDataLoader implements AdapterWarpDataLoader {
+    private readonly config;
+    private readonly chain;
+    private 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;
+}
+
+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<Transaction>;
+    createTransferTransaction(executable: WarpExecutable): Promise<Transaction>;
+    createContractCallTransaction(executable: WarpExecutable): Promise<Transaction>;
+    private encodeInstructionData;
+    private encodeBasicInstructionData;
+    private encodeArgs;
+    private buildInstructionAccounts;
+    private createTokenTransferTransaction;
+    private createSingleTokenTransfer;
+    executeQuery(executable: WarpExecutable): Promise<WarpActionExecutionResult>;
+    verifyMessage(message: string, signature: string): Promise<string>;
+    private setTransactionDefaults;
+}
+
+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;
+    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[]>;
+    create(mnemonic: string): {
+        address: string;
+        privateKey: string;
+        mnemonic: string;
+    };
+    generate(): {
+        address: string;
+        privateKey: string;
+        mnemonic: string;
+    };
+    getAddress(): string | null;
+    getPublicKey(): string | null;
+    private getKeypair;
+}
+
+export { type ExplorerName, ExplorerUrls, KnownTokens, NativeTokenSol, SolanaExplorerMap, SolanaExplorerNames, SolanaExplorerUrls, SolanaExplorers, type TokenBalance, type TokenMetadata, WarpSolanaConstants, WarpSolanaDataLoader, WarpSolanaExecutor, WarpSolanaExplorer, WarpSolanaOutput, WarpSolanaSerializer, WarpSolanaWallet, findKnownTokenById, getKnownTokensForChain, getSolanaAdapter };