@vleap/warps-adapter-evm 0.2.0-alpha.3 → 0.2.0-alpha.31

package/README.md

@@ -1,400 +0,0 @@
-# Warp EVM Adapter
-
-A comprehensive EVM (Ethereum Virtual Machine) adapter for the Warp SDK, providing full support for Ethereum, Arbitrum, Base, and other EVM-compatible blockchains.
-
-## Features
-
-- ✅ **Multi-Chain Support**: Ethereum, Arbitrum, Base, and any EVM-compatible chain
-- ✅ **Complete Transaction Support**: Transfers, contract calls, and queries
-- ✅ **Robust Gas Estimation**: EIP-1559 and legacy pricing with fallbacks
-- ✅ **Comprehensive Data Types**: All EVM-compatible data types with validation
-- ✅ **Registry Operations**: Full warp and brand management
-- ✅ **Caching Layer**: Performance optimization for registry operations
-- ✅ **Error Handling**: Graceful degradation and meaningful error messages
-- ✅ **Type Safety**: Full TypeScript coverage
-- ✅ **Production Ready**: Zero technical debt, comprehensive testing
-
-## Installation
-
-```bash
-npm install @vleap/warps-adapter-evm ethers
-```
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { getEvmAdapter, getEthereumAdapter, getArbitrumAdapter, getBaseAdapter } from '@vleap/warps-adapter-evm'
-import { WarpClientConfig } from '@vleap/warps'
-
-const config: WarpClientConfig = {
-  env: 'mainnet',
-  user: {
-    wallets: {
-      evm: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-    },
-  },
-}
-
-// Get adapter for specific chain
-const ethereumAdapter = getEthereumAdapter(config)
-const arbitrumAdapter = getArbitrumAdapter(config)
-const baseAdapter = getBaseAdapter(config)
-
-// Or get adapter for any EVM chain
-const customAdapter = getEvmAdapter(config, 'polygon')
-```
-
-### Creating a Warp
-
-```typescript
-import { getEvmAdapter } from '@vleap/warps-adapter-evm'
-
-const adapter = getEvmAdapter(config)
-
-// Create a warp from raw data
-const warp = await adapter
-  .builder()
-  .createFromRaw('{"title":"My Warp","actions":[...]}')
-  .setTitle('My Custom Warp')
-  .setDescription('A description of my warp')
-  .setPreview('https://example.com/preview.png')
-  .addAction({
-    type: 'transfer',
-    label: 'Transfer ETH',
-    address: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-  })
-  .build()
-
-// Create inscription transaction
-const inscriptionTx = await adapter.builder().createInscriptionTransaction(warp)
-```
-
-### Executing Transactions
-
-```typescript
-// Create transfer transaction
-const transferExecutable = {
-  chain: { name: 'evm' },
-  warp,
-  action: 1,
-  destination: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-  value: BigInt('1000000000000000000'), // 1 ETH
-  args: [],
-  transfers: [],
-  resolvedInputs: [],
-}
-
-const transferTx = await adapter.executor.createTransaction(transferExecutable)
-
-// Create contract call transaction
-const contractExecutable = {
-  chain: { name: 'evm' },
-  warp: {
-    actions: [
-      {
-        type: 'contract',
-        func: 'transfer(address,uint256)',
-      },
-    ],
-  },
-  action: 1,
-  destination: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-  value: BigInt(0),
-  args: ['0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6', '1000000000000000000'],
-  transfers: [],
-  resolvedInputs: [],
-}
-
-const contractTx = await adapter.executor.createTransaction(contractExecutable)
-```
-
-### Executing Queries
-
-```typescript
-// Execute a query
-const queryExecutable = {
-  chain: { name: 'evm' },
-  warp: {
-    actions: [
-      {
-        type: 'query',
-        func: 'balanceOf(address)',
-      },
-    ],
-  },
-  action: 1,
-  destination: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-  value: BigInt(0),
-  args: ['0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'],
-  transfers: [],
-  resolvedInputs: [],
-}
-
-const queryResult = await adapter.executor.executeQuery(queryExecutable)
-console.log('Query result:', queryResult.values)
-```
-
-### Registry Operations
-
-```typescript
-// Register a warp
-const registerTx = await adapter.registry.createWarpRegisterTransaction('0x1234567890abcdef', 'my-warp-alias', 'my-brand-hash')
-
-// Get warp info by alias
-const { registryInfo, brand } = await adapter.registry.getInfoByAlias('my-warp-alias')
-
-// Get user's warps
-const userWarps = await adapter.registry.getUserWarpRegistryInfos()
-
-// Get chain information
-const chainInfo = await adapter.registry.getChainInfo('ethereum')
-```
-
-## Configuration
-
-### Multi-Chain Support
-
-The adapter supports multiple EVM chains out of the box:
-
-```typescript
-// Ethereum
-const ethereumConfig = {
-  env: 'mainnet',
-  user: {
-    wallets: {
-      evm: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-    },
-  },
-  // Custom API URL for Ethereum
-  apiUrl: 'https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY',
-}
-
-// Arbitrum
-const arbitrumConfig = {
-  env: 'mainnet',
-  user: {
-    wallets: {
-      evm: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-    },
-  },
-  // Custom API URL for Arbitrum
-  apiUrl: 'https://arb-mainnet.g.alchemy.com/v2/YOUR_API_KEY',
-}
-
-// Base
-const baseConfig = {
-  env: 'mainnet',
-  user: {
-    wallets: {
-      evm: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
-    },
-  },
-  // Custom API URL for Base
-  apiUrl: 'https://mainnet.base.org',
-}
-```
-
-### Supported Chains
-
-- **Ethereum**: Mainnet, Sepolia testnet, Local devnet
-- **Arbitrum**: Mainnet, Sepolia testnet, Local devnet
-- **Base**: Mainnet, Sepolia testnet, Local devnet
-- **Any EVM Chain**: Easily configurable for other chains
-
-### Environment Configuration
-
-```typescript
-// Mainnet
-const mainnetConfig = { env: 'mainnet' }
-
-// Testnet
-const testnetConfig = { env: 'testnet' }
-
-// Devnet
-const devnetConfig = { env: 'devnet' }
-```
-
-## Data Types
-
-The adapter supports all EVM-compatible data types:
-
-- **string**: Regular strings
-- **uint8/uint16/uint32/uint64**: Unsigned integers
-- **biguint**: Big integers for large numbers
-- **boolean**: Boolean values
-- **address**: Ethereum addresses (0x-prefixed)
-- **hex**: Hexadecimal strings (0x-prefixed)
-- **list**: Array support with type inference
-
-### Input Preprocessing
-
-```typescript
-// Preprocess inputs with validation
-const processedAddress = await adapter.executor.preprocessInput(
-  { name: 'evm' },
-  'input',
-  'address',
-  '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'
-)
-
-const processedAmount = await adapter.executor.preprocessInput({ name: 'evm' }, 'input', 'biguint', '1000000000000000000')
-```
-
-## Gas Estimation
-
-The adapter provides robust gas estimation with multiple fallback strategies:
-
-### EIP-1559 Support
-
-- Automatic detection of EIP-1559 support
-- Uses `maxFeePerGas` and `maxPriorityFeePerGas` when available
-- Falls back to legacy `gasPrice` for older chains
-
-### Fallback Strategy
-
-- Attempts to estimate gas from the network
-- Falls back to default values if estimation fails
-- Configurable default gas limits and prices
-
-### Custom Gas Configuration
-
-```typescript
-// The adapter automatically handles gas estimation
-// but you can also set custom values in the transaction
-const customTx = {
-  ...transferTx,
-  gasLimit: BigInt(50000),
-  maxFeePerGas: ethers.parseUnits('50', 'gwei'),
-  maxPriorityFeePerGas: ethers.parseUnits('2', 'gwei'),
-}
-```
-
-## Error Handling
-
-The adapter provides comprehensive error handling:
-
-### Graceful Degradation
-
-- Network failures don't crash the application
-- Gas estimation failures use safe defaults
-- Registry operations handle missing contracts
-
-### Meaningful Error Messages
-
-- Clear error messages for debugging
-- Input validation with specific error details
-- Network-specific error handling
-
-### Error Recovery
-
-- Automatic retry mechanisms for transient failures
-- Fallback strategies for critical operations
-- Safe defaults for missing configuration
-
-## Testing
-
-Run the test suite:
-
-```bash
-npm test
-```
-
-The test suite includes:
-
-- Unit tests for all components
-- Integration tests for complex scenarios
-- Error handling validation
-- Edge case coverage
-
-## Building
-
-Build the package:
-
-```bash
-npm run build
-```
-
-This generates:
-
-- CommonJS bundle (`dist/index.js`)
-- ES Module bundle (`dist/index.mjs`)
-- TypeScript declarations (`dist/index.d.ts`)
-
-## Architecture
-
-### Components
-
-1. **WarpEvmBuilder**: Warp creation and management
-2. **WarpEvmExecutor**: Transaction creation and execution
-3. **WarpEvmSerializer**: Data type serialization
-4. **WarpEvmResults**: Result processing and extraction
-5. **WarpEvmRegistry**: Registry operations with caching
-6. **WarpEvmExplorer**: Blockchain explorer integration
-7. **WarpEvmAbiBuilder**: ABI creation and management
-8. **WarpEvmBrandBuilder**: Brand creation and validation
-
-### Design Principles
-
-- **Modularity**: Each component has a single responsibility
-- **Extensibility**: Easy to add support for new EVM chains
-- **Performance**: Caching and efficient algorithms
-- **Reliability**: Comprehensive error handling and validation
-- **Type Safety**: Full TypeScript coverage
-
-### Multi-Chain Architecture
-
-The adapter uses a chain-specific configuration system:
-
-```typescript
-// Chain configurations are centralized
-export const EVM_CHAIN_CONFIGS = {
-  ethereum: {
-    /* config */
-  },
-  arbitrum: {
-    /* config */
-  },
-  base: {
-    /* config */
-  },
-  // Easy to add new chains
-}
-
-// Adapters are instantiated with chain-specific configs
-const adapter = getEvmAdapter(config, 'ethereum')
-```
-
-## Performance Optimizations
-
-### Caching
-
-- Registry operations are cached for performance
-- Configurable TTL for different data types
-- Memory and localStorage cache strategies
-
-### Gas Estimation
-
-- Efficient gas estimation with fallbacks
-- Cached fee data to reduce RPC calls
-- Batch operations where possible
-
-### Serialization
-
-- Optimized serialization for large data
-- Efficient type conversion algorithms
-- Memory-efficient data structures
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new functionality
-5. Ensure all tests pass
-6. Submit a pull request
-
-## License
-
-MIT

package/dist/index.d.mts

@@ -1,140 +0,0 @@
-import { WarpChainEnv, AdapterFactory, WarpClientConfig, Adapter, CombinedWarpBuilder, Warp, BaseWarpBuilder, WarpCacheConfig, AdapterWarpExecutor, WarpExecutable, WarpExecution, WarpChainInfo, WarpActionInputType, AdapterWarpExplorer, AdapterWarpResults, ResolvedInput, WarpExecutionResults, AdapterWarpSerializer, WarpSerializer, WarpNativeValue, BaseWarpActionInputType, WarpAdapterGenericType } from '@vleap/warps';
-import { ethers } from 'ethers';
-
-interface EvmChainConfig {
-    apiUrl: string;
-    explorerUrl: string;
-    chainId: string;
-    registryAddress: string;
-    nativeToken: string;
-    blockTime?: number;
-}
-declare const EVM_CHAIN_CONFIGS: Record<string, Record<WarpChainEnv, EvmChainConfig>>;
-declare const getEvmChainConfig: (chain: string | undefined, env: WarpChainEnv) => EvmChainConfig;
-declare const getEvmApiUrl: (env: WarpChainEnv, chain?: string) => string;
-declare const getEvmExplorerUrl: (env: WarpChainEnv, chain?: string) => string;
-declare const getEvmChainId: (env: WarpChainEnv, chain?: string) => string;
-declare const getEvmRegistryAddress: (env: WarpChainEnv, chain?: string) => string;
-declare const getEvmNativeToken: (env: WarpChainEnv, chain?: string) => string;
-declare const getEvmBlockTime: (env: WarpChainEnv, chain?: string) => number;
-declare const getSupportedEvmChains: () => string[];
-declare const getSupportedEnvironments: (chain: string) => WarpChainEnv[];
-
-declare const WarpEvmConstants: {
-    Ether: {
-        Identifier: string;
-        DisplayName: string;
-        Decimals: number;
-    };
-    GasLimit: {
-        Default: number;
-        ContractCall: number;
-        ContractDeploy: number;
-        Transfer: number;
-        Approve: number;
-        Swap: number;
-    };
-    GasPrice: {
-        Default: string;
-        Low: string;
-        Medium: string;
-        High: string;
-    };
-    Networks: {
-        Ethereum: {
-            ChainId: string;
-            Name: string;
-            BlockTime: number;
-        };
-        Arbitrum: {
-            ChainId: string;
-            Name: string;
-            BlockTime: number;
-        };
-        Base: {
-            ChainId: string;
-            Name: string;
-            BlockTime: number;
-        };
-    };
-    Validation: {
-        AddressLength: number;
-        HexPrefix: string;
-        MinGasLimit: number;
-        MaxGasLimit: number;
-    };
-    Timeouts: {
-        DefaultRpcTimeout: number;
-        GasEstimationTimeout: number;
-        QueryTimeout: number;
-    };
-};
-
-declare const getEthereumAdapter: AdapterFactory;
-declare const getArbitrumAdapter: AdapterFactory;
-declare const getBaseAdapter: AdapterFactory;
-declare const getAllEvmAdapters: (config: WarpClientConfig, fallback?: Adapter) => Adapter[];
-
-declare class WarpEvmBuilder implements CombinedWarpBuilder {
-    private readonly config;
-    private warp;
-    private actions;
-    constructor(config: WarpClientConfig);
-    createFromRaw(encoded: string): Promise<Warp>;
-    setTitle(title: string): BaseWarpBuilder;
-    setDescription(description: string): BaseWarpBuilder;
-    setPreview(preview: string): BaseWarpBuilder;
-    setActions(actions: any[]): BaseWarpBuilder;
-    addAction(action: any): BaseWarpBuilder;
-    build(): Promise<Warp>;
-    createInscriptionTransaction(warp: Warp): ethers.TransactionRequest;
-    createFromTransaction(tx: ethers.TransactionResponse, validate?: boolean): Promise<Warp>;
-    createFromTransactionHash(hash: string, cache?: WarpCacheConfig): Promise<Warp | null>;
-}
-
-declare class WarpEvmExecutor implements AdapterWarpExecutor {
-    private readonly config;
-    private readonly serializer;
-    private readonly provider;
-    private readonly results;
-    constructor(config: WarpClientConfig);
-    createTransaction(executable: WarpExecutable): Promise<ethers.TransactionRequest>;
-    createTransferTransaction(executable: WarpExecutable): Promise<ethers.TransactionRequest>;
-    createContractCallTransaction(executable: WarpExecutable): Promise<ethers.TransactionRequest>;
-    executeQuery(executable: WarpExecutable): Promise<WarpExecution>;
-    preprocessInput(chain: WarpChainInfo, input: string, type: WarpActionInputType, value: string): Promise<string>;
-    private estimateGasAndSetDefaults;
-    signMessage(message: string, privateKey: string): Promise<string>;
-}
-
-declare class WarpEvmExplorer implements AdapterWarpExplorer {
-    private readonly chainInfo;
-    private readonly chainName;
-    constructor(chainInfo: WarpChainInfo, chainName?: string);
-    getAccountUrl(address: string): string;
-    getTransactionUrl(hash: string): string;
-}
-
-declare class WarpEvmResults implements AdapterWarpResults {
-    private readonly config;
-    private readonly serializer;
-    constructor(config: WarpClientConfig);
-    getTransactionExecutionResults(warp: Warp, tx: ethers.TransactionReceipt): Promise<WarpExecution>;
-    extractQueryResults(warp: Warp, typedValues: any[], actionIndex: number, inputs: ResolvedInput[]): Promise<{
-        values: any[];
-        results: WarpExecutionResults;
-    }>;
-}
-
-declare class WarpEvmSerializer 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;
-}
-
-export { EVM_CHAIN_CONFIGS, type EvmChainConfig, WarpEvmBuilder, WarpEvmConstants, WarpEvmExecutor, WarpEvmExplorer, WarpEvmResults, WarpEvmSerializer, getAllEvmAdapters, getArbitrumAdapter, getBaseAdapter, getEthereumAdapter, getEvmApiUrl, getEvmBlockTime, getEvmChainConfig, getEvmChainId, getEvmExplorerUrl, getEvmNativeToken, getEvmRegistryAddress, getSupportedEnvironments, getSupportedEvmChains };