# Gelato Developer Documentation

> Gelato is a comprehensive Web3 infrastructure platform providing developers with tools to build next-generation blockchain applications with improved user experience, scalability, and functionality.

This documentation covers gasless transactions, account abstraction, rollup deployment, and blockchain infrastructure services.

## Quick Links

- Documentation: https://docs.gelato.network
- Dashboard: https://app.gelato.cloud
- GitHub: https://github.com/gelatodigital

## Core Products

### Gasless with Relay (Turbo Relayer)
The fastest gasless transaction infrastructure across EVM chains, TRON, and Solana. Enables sponsored transactions and ERC-20 gas payments.

- Overview: /gasless-with-relay/gelato-turbo-relayer/overview
- Quick Start: /gasless-with-relay/gelato-turbo-relayer/quick-start
- Payment Methods: /gasless-with-relay/gasless-transactions-evm/payment-methods
- Sync Transactions: /gasless-with-relay/gasless-transactions-evm/sync-methods
- Multichain Transactions: /gasless-with-relay/gasless-transactions-evm/send-multichain
- 7702 Turbo Relayer: /gasless-with-relay/gasless-transactions-evm/7702-turbobundler
- Relayer API: /gasless-with-relay/relayer-api/overview

### Paymaster & Bundler
ERC-4337 and EIP-7702 account abstraction infrastructure for smart accounts with flexible gas payment options.

- Overview: /paymaster-&-bundler/gelato-bundler-paymaster/overview
- Quick Start: /paymaster-&-bundler/gelato-bundler-paymaster/quick-start
- Sponsor Gas: /paymaster-&-bundler/how-to-guides/sponsor-gas-with-gastank
- Pay with ERC-20: /paymaster-&-bundler/how-to-guides/pay-with-erc20-tokens/overview
- Pay with Native: /paymaster-&-bundler/how-to-guides/pay-with-native
- GasTank: /paymaster-&-bundler/gastank/introduction
- Bundler API: /paymaster-&-bundler/bundler-api-endpoints/bundlers/eth_senduseroperation

### Rollup as a Service (RaaS)
No-code platform for deploying custom Ethereum rollup chains with ABC Stack, OP Stack, or Arbitrum Orbit.

- Introduction: /rollup-as-a-service/introduction
- Deploy Rollup: /rollup-as-a-service/how-to-guides/deploy-your-own-rollup
- OP Stack: /rollup-as-a-service/rollup-stacks/op
- Arbitrum Orbit: /rollup-as-a-service/rollup-stacks/arbitrum-orbit
- ABC Stack: /rollup-as-a-service/rollup-stacks/abc
- Data Availability: /rollup-as-a-service/data-availability/celestia

### Private RPCs
High-performance, authenticated RPC endpoints with no rate limits and elastic scaling.

- Introduction: /private-rpcs/introduction
- Get Started: /private-rpcs/how-to-guides/get-a-private-rpc
- Supported Networks: /private-rpcs/additional-resources/supported-networks

### VRF (Verifiable Random Function)
Decentralized, verifiable random number generation for on-chain applications.

- Overview: /vrf/introduction/overview
- How It Works: /vrf/introduction/how-gelato-vrf-works
- Deploy Contract: /vrf/how-to-guides/deploy-your-contract-inheriting-gelato-vrf

### Web3 Functions
Serverless automation for Web3 with TypeScript and Solidity functions.

- Overview: /web3-functions/introduction/overview
- TypeScript Functions: /web3-functions/introduction/typescript-functions
- Trigger Types: /web3-functions/introduction/trigger-types

## Key Concepts

### Gasless Transactions
Enable users to interact with dApps without holding native tokens for gas. Three payment methods:
1. **Sponsored**: Developer pays via GasTank pre-funded balance
2. **ERC-20 Tokens**: User pays with USDC, USDT, or other supported tokens
3. **Native Tokens**: User pays with chain's native token

### Account Abstraction
Smart accounts providing enhanced functionality through ERC-4337 and EIP-7702 standards:
- Transaction batching
- Gas sponsorship
- Session keys
- Social recovery
- Custom validation logic

### EIP-7702
Protocol-level enhancement allowing EOAs to temporarily behave like smart accounts without deploying new contracts. Users keep their existing address while gaining smart account capabilities.

### Sync vs Async Transactions
- **Async**: Returns task ID immediately, poll for status separately
- **Sync**: Waits for final result in single call with timeout parameter

### Multichain Transactions
Submit transactions to multiple chains in a single batch with payment settled on one chain. Useful for cross-chain operations and portfolio rebalancing.

## SDK Installation

```bash
npm install @gelatocloud/gasless
```

## Quick Code Examples

### Send Sponsored Transaction
```typescript
import { createGelatoEvmRelayerClient, sponsored } from '@gelatocloud/gasless';

const relayer = createGelatoEvmRelayerClient({
  apiKey: process.env.GELATO_API_KEY,
  testnet: true
});

const taskId = await relayer.sendTransaction({
  chainId: 84532,
  to: '0xContractAddress',
  data: '0xCalldata',
  payment: sponsored()
});
```

### Send Sync Transaction
```typescript
import { createGelatoEvmRelayerClient, sponsored, StatusCode } from '@gelatocloud/gasless';

const relayer = createGelatoEvmRelayerClient({
  apiKey: process.env.GELATO_API_KEY,
  testnet: true
});

const status = await relayer.sendTransactionSync({
  chainId: 84532,
  to: '0xContractAddress',
  data: '0xCalldata',
  payment: sponsored(),
  timeout: 30000
});

if (status.status === StatusCode.Included) {
  console.log('TX hash:', status.receipt.transactionHash);
}
```

### Send Multichain Transaction
```typescript
const taskIds = await relayer.sendTransactionMultichain([
  {
    chainId: 84532,
    to: '0xContract1',
    data: '0xCalldata1',
    payment: { type: 'token', address: '0xUSDC' }
  },
  {
    chainId: 8453,
    to: '0xContract2',
    data: '0xCalldata2',
    payment: { type: 'sponsored' }
  }
]);
```

### Pay with ERC-20 Token
```typescript
import { createGelatoEvmRelayerClient, token } from '@gelatocloud/gasless';

const taskId = await relayer.sendTransaction({
  chainId: 84532,
  to: '0xContractAddress',
  data: '0xCalldata',
  payment: token('0xUSDCAddress')
});
```

## API Endpoints

### Relayer API (JSON-RPC)
Base URL: `https://api.gelato.digital`

| Method | Description |
|--------|-------------|
| `relayer_getCapabilities` | Query supported features and chains |
| `relayer_getFeeData` | Get current fee parameters |
| `relayer_getFeeQuote` | Get accurate fee quotes |
| `relayer_getStatus` | Track transaction status |
| `relayer_sendTransaction` | Submit async transaction |
| `relayer_sendTransactionSync` | Submit sync transaction |
| `relayer_sendTransactionMultichain` | Submit multichain batch |

### Bundler API (ERC-4337)
| Method | Description |
|--------|-------------|
| `eth_sendUserOperation` | Submit UserOperation |
| `eth_estimateUserOperationGas` | Estimate gas for UserOperation |
| `eth_getUserOperationByHash` | Get UserOperation by hash |
| `eth_getUserOperationReceipt` | Get UserOperation receipt |
| `eth_supportedEntryPoints` | List supported entry points |
| `gelato_getUserOperationGasPrice` | Get gas price for UserOperations |

## Supported Networks

### Mainnets
Ethereum, Polygon, Arbitrum, Optimism, Base, BNB Chain, Avalanche, Fantom, Gnosis Chain, Cronos, zkSync Era, Linea, Scroll, Polygon zkEVM, Moonbeam, Moonriver, and 30+ more.

### Testnets
Sepolia, Base Sepolia, Arbitrum Sepolia, Optimism Sepolia, Polygon Amoy, Holesky, and others.

Full list: /gasless-with-relay/additional-resources/supported-networks

## Payment Tokens

Supported ERC-20 tokens for gas payments vary by network. Common tokens include:
- USDC
- USDT
- DAI
- WETH
- Native wrapped tokens

Full list: /gasless-with-relay/additional-resources/erc20-payment-tokens

## Pricing

- **Testnet**: Free for development and testing
- **Mainnet**: Usage-based pricing through GasTank
- **Enterprise**: Custom pricing available

Details: /pricing/pricing-plans

## Documentation Sections

### Gasless with Relay
- /gasless-with-relay/gelato-turbo-relayer/overview
- /gasless-with-relay/gasless-transactions-evm/implementation-paths
- /gasless-with-relay/gasless-transactions-evm/payment-methods
- /gasless-with-relay/gasless-transactions-evm/sync-methods
- /gasless-with-relay/gasless-transactions-evm/send-multichain
- /gasless-with-relay/gasless-transactions-evm/7702-turbobundler
- /gasless-with-relay/gasless-transactions-evm/webhooks
- /gasless-with-relay/gasless-transactions-tron/overview
- /gasless-with-relay/gasless-transactions-solana/solana
- /gasless-with-relay/how-to-guides/create-a-api-key
- /gasless-with-relay/how-to-guides/send-sync-transactions
- /gasless-with-relay/how-to-guides/send-multichain-transactions
- /gasless-with-relay/how-to-guides/sponsoredcalls/overview
- /gasless-with-relay/how-to-guides/pay-gas-with-erc20-tokens/overview
- /gasless-with-relay/how-to-guides/tracking-gelato-request
- /gasless-with-relay/relayer-api/overview
- /gasless-with-relay/relayer-api-endpoints/relayer/relayer_sendtransaction
- /gasless-with-relay/relayer-api-endpoints/relayer/relayer_sendtransactionsync
- /gasless-with-relay/relayer-api-endpoints/relayer/relayer_sendtransactionmultichain
- /gasless-with-relay/relayer-api-endpoints/relayer/relayer_getfeequote
- /gasless-with-relay/relayer-api-endpoints/relayer/relayer_getstatus
- /gasless-with-relay/additional-resources/supported-networks
- /gasless-with-relay/additional-resources/erc20-payment-tokens

### Paymaster & Bundler
- /paymaster-&-bundler/gelato-bundler-paymaster/overview
- /paymaster-&-bundler/gelato-bundler-paymaster/quick-start
- /paymaster-&-bundler/features/implementation-paths
- /paymaster-&-bundler/features/paymnet-methods
- /paymaster-&-bundler/features/smart-accounts
- /paymaster-&-bundler/features/embedded-wallets
- /paymaster-&-bundler/features/EIP-7702 support
- /paymaster-&-bundler/how-to-guides/create-a-api-key
- /paymaster-&-bundler/how-to-guides/sponsor-gas-with-gastank
- /paymaster-&-bundler/how-to-guides/pay-with-erc20-tokens/overview
- /paymaster-&-bundler/how-to-guides/pay-with-native
- /paymaster-&-bundler/how-to-guides/estimate-gas
- /paymaster-&-bundler/how-to-guides/tracking-gelato-request
- /paymaster-&-bundler/gastank/introduction
- /paymaster-&-bundler/gastank/setting-up-gastank
- /paymaster-&-bundler/bundler-api-endpoints/bundlers/eth_senduseroperation
- /paymaster-&-bundler/bundler-api-endpoints/bundlers/eth_estimateuseroperationgas
- /paymaster-&-bundler/bundler-api-endpoints/bundlers/eth_getuseroperationreceipt
- /paymaster-&-bundler/additional-resources/supported-networks

### Rollup as a Service
- /rollup-as-a-service/introduction
- /rollup-as-a-service/rollup-stacks/op
- /rollup-as-a-service/rollup-stacks/arbitrum-orbit
- /rollup-as-a-service/rollup-stacks/abc
- /rollup-as-a-service/data-availability/celestia
- /rollup-as-a-service/data-availability/avail
- /rollup-as-a-service/data-availability/eigenda
- /rollup-as-a-service/customization/custom-gas-token
- /rollup-as-a-service/customization/flashblocks
- /rollup-as-a-service/how-to-guides/deploy-your-own-rollup
- /rollup-as-a-service/marketplace/gelato-services

### Private RPCs
- /private-rpcs/introduction
- /private-rpcs/how-to-guides/get-a-private-rpc
- /private-rpcs/additional-resources/supported-networks
- /private-rpcs/additional-resources/faq

### VRF
- /vrf/introduction/overview
- /vrf/introduction/how-gelato-vrf-works
- /vrf/introduction/understanding-vrf
- /vrf/how-to-guides/deploy-your-contract-inheriting-gelato-vrf
- /vrf/how-to-guides/create-a-vrf-task
- /vrf/additional-resources/supported-networks

### Web3 Functions
- /web3-functions/introduction/overview
- /web3-functions/introduction/typescript-functions
- /web3-functions/introduction/solidity-functions
- /web3-functions/introduction/trigger-types
- /web3-functions/how-to-guides/write-typescript-functions/getting-started
- /web3-functions/how-to-guides/test-deploy-typescript-functions
- /web3-functions/additional-resources/templates-and-use-cases

### Legacy Documentation
- /relay/introduction/overview (Legacy Relay - use Gasless with Relay instead)
- /smart-wallet-sdk/introduction/overview (Legacy Smart Wallet SDK)

### Pricing
- /pricing/pricing-plans
- /pricing/compute-units
- /pricing/compute-units-costs

## Use Cases

### DeFi Applications
- Gasless swaps and trades
- Sponsored lending/borrowing
- Cross-chain portfolio management

### Gaming
- Seamless player onboarding
- In-game transactions without gas interruptions
- Custom game-specific rollups

### NFT Platforms
- Gasless minting
- ERC-20 fee payments for trading
- Sponsored marketplace interactions

### DAO Governance
- Gasless voting to increase participation
- Sponsored proposal submissions

### Wallet Applications
- Embedded wallet integration
- Smart account features
- Gas abstraction for users

## Getting Started

1. Create account at https://app.gelato.cloud
2. Generate API key for your project
3. Install SDK: `npm install @gelatocloud/gasless`
4. Follow quick start guide: /gasless-with-relay/gelato-turbo-relayer/quick-start
5. Test on testnet (free)
6. Deploy to mainnet with GasTank funding

## Support

- Documentation: https://docs.gelato.network
- GitHub: https://github.com/gelatodigital
- Twitter: https://twitter.com/geaborednetwork

## Optional

For detailed API specifications and advanced usage:
- corpus.jsonl - Full documentation corpus for AI training
- summaries/ - Section-specific digests for each product area