**Security Notes:**
* Only delegate to audited, trusted contracts
* The authorization is valid for the specific chain ID and nonce
* After the transaction, verify the EOA state is as expected
* Be cautious with contracts that modify EOA storage permanently
Supported Networks [#supported-networks]
EIP-7702 is supported on networks that have implemented the Pectra upgrade:
* Ethereum Mainnet
* Base
* Optimism
* Arbitrum
* And other EVM chains with Pectra support
Limitations [#limitations]
* **Not compatible with flash-blocks**: The `authorizationList` parameter cannot be used with `transactionType: "flash-blocks"`
* **Nonce sensitivity**: The authorization nonce must match the EOA's current nonce exactly
* **Chain-specific**: Each authorization is only valid for the specified chain ID
SDK Support [#sdk-support]
```typescript filename="tachyon-sdk-eip7702.ts"
import { Tachyon } from '@rathfi/tachyon';
const tachyon = new Tachyon({
apiKey: process.env.TACHYON_API_KEY!,
});
// Authorization object from viem's signAuthorization
const auth = {
chainId: 8453, // Base
address: '0xDelegateContractAddress',
nonce: 0,
r: '0x...',
s: '0x...',
v: 27,
yParity: 0 as 0 | 1,
};
// Submit transaction with EIP-7702 authorization
const taskId = await tachyon.relay({
chainId: 8453,
to: '0xTargetAddress',
callData: '0xEncodedCallData',
value: '0',
gasLimit: '1000000',
authorizationList: [auth],
});
console.log('Task ID:', taskId);
// Wait for execution
const tx = await tachyon.waitForExecutionHash(taskId, 30_000);
console.log('Execution hash:', tx);
```
Further Reading [#further-reading]
* [EIP-7702 Specification](https://eips.ethereum.org/EIPS/eip-7702)
* [Viem EIP-7702 Documentation](https://viem.sh/docs/eip7702)
* [Discussion on Ethereum Magicians](https://ethereum-magicians.org/t/eip-7702-set-eoa-account-code/19923)
* [Account Abstraction Overview](https://ethereum.org/en/roadmap/account-abstraction/)
# Flashblocks (/tachyon/features/flashblocks)
## Documentation Index
Fetch the complete documentation index at: https://docs.rath.fi/llms.txt
Use this file to discover all available pages before exploring further.
Flashblocks [#flashblocks]
Ultra-fast transaction execution on Flash-Blocks supported chains with Tachyon's flashblocks feature. Reduce transaction latency from 150ms to under 50ms for lightning-fast user experiences.
Overview [#overview]
Flashblocks is Tachyon's high-speed transaction type that delivers ultra-low latency execution on Flash-Blocks supported chains. While standard Tachyon transactions already execute in under 150ms, flashblocks push the boundaries further with sub-50ms average latency, making them perfect for real-time applications, gaming, and high-frequency trading where every millisecond counts.
Performance Comparison [#performance-comparison]
| Transaction Type | Average Latency | Best Use Cases |
| ---------------- | --------------- | --------------------------------------------------- |
| Standard Relay | Under 150ms | General transactions, DeFi operations |
| Flashblocks | Under 50ms | Gaming, real-time trading, time-critical operations |
Supported Networks [#supported-networks]
Currently available on:
* **Base Mainnet** (Chain ID: 8453)
* **Base Sepolia Testnet** (Chain ID: 84532)
Flashblocks support is expanding to all EVM-compatible networks in Tachyon's ecosystem. Additional chains will be added progressively.
Usage [#usage]
**Note:** Gas limit is required for Aptos transactions.
**Note:** Gas limit is required for Sui transactions. Value is denominated in MIST (1 SUI = 10^9 MIST).
**Note:** Gas limit is required for Aptos transactions.
**Note:** Gas limit is required for Sui transactions. Value is denominated in MIST (1 SUI = 10^9 MIST).
**Note:** Flash-blocks transaction type is only supported on Base (8453) and Base Sepolia (84532). Authorization lists cannot be used with flash-blocks transactions.
Transaction with Authorization List (EIP-7702) [#transaction-with-authorization-list-eip-7702]
```bash filename="submit-transaction.sh"
curl -X POST "https://tachyon.rath.fi/api/submit-tx" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "1000000000000000",
"callData": "0x",
"authorizationList": [
{
"chainId": 8453,
"address": "0x1234567890abcdef1234567890abcdef12345678",
"nonce": 1,
"r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"yParity": 1
}
],
"label": "Delegated Transaction"
}'
```
With Custom Derivation Path [#with-custom-derivation-path]
```bash filename="submit-transaction.sh"
curl -X POST "https://tachyon.rath.fi/api/submit-tx" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "1000000000000000",
"callData": "0x",
"derivationPath": "m/44'\''/60'\''/0'\''/0/1",
"label": "Transaction from Custom Account"
}'
```
Transaction with Multicall Batching [#transaction-with-multicall-batching]
```bash filename="submit-transaction.sh"
curl -X POST "https://tachyon.rath.fi/api/submit-tx" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "0",
"callData": "0xa9059cbb000000000000000000000000...",
"shouldBatchInMulticall": true,
"label": "Batched Transaction"
}'
```
Transaction with Retries [#transaction-with-retries]
```bash filename="terminal"
curl -X POST "https://tachyon.rath.fi/api/submit-tx" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "1000000000000000",
"callData": "0x",
"retries": 3,
"label": "Transaction with Auto-Retry"
}'
```
# Get Relay Status (/tachyon/tachyon-api/relay_status)
## Documentation Index
Fetch the complete documentation index at: https://docs.rath.fi/llms.txt
Use this file to discover all available pages before exploring further.
Get Relay Status [#get-relay-status]
Get the current status of a submitted transaction, including execution details, costs, and on-chain transaction hash once available.
Endpoint [#endpoint]
```
GET https://tachyon.rath.fi/api/tx?id={txId}
```
Query Parameters [#query-parameters]
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------- |
| `id` | string | Yes | The transaction ID returned from submitting a relay transaction |
Response [#response]
Success Response [#success-response]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"userId": "68c275846a6ba1c9a2198a8c",
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"callData": "0x",
"value": "1",
"chainId": 8453,
"gasPrice": "1000000000",
"maxFeePerGas": null,
"maxPriorityFeePerGas": null,
"gasLimit": "21000",
"label": "My Transaction",
"status": "EXECUTED",
"executionTxHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"timestamp": "2025-10-23T13:57:36.672Z",
"latency": 2500,
"costUSD": 0.8400561743999754,
"retries": 0,
"isAccountCharged": true,
"extraData": null,
"error": null
},
"timestamp": "2025-10-24T12:34:56.789Z"
}
```
Response Fields [#response-fields]
| Field | Type | Description |
| ---------------------- | -------------- | ---------------------------------------------------------------------------- |
| `id` | string | Unique transaction identifier |
| `userId` | string | User ID associated with the transaction |
| `to` | string | Recipient address |
| `callData` | string | Encoded transaction data in hexadecimal format |
| `value` | string | Amount transferred in smallest unit (wei for EVM, lamports for Solana, etc.) |
| `chainId` | number | Blockchain network ID where the transaction was submitted |
| `gasPrice` | string | Gas price used for the transaction |
| `maxFeePerGas` | string \| null | Maximum fee per gas unit (EIP-1559 transactions) |
| `maxPriorityFeePerGas` | string \| null | Maximum priority fee per gas (EIP-1559 transactions) |
| `gasLimit` | string | Gas limit for the transaction |
| `label` | string | Human-readable transaction label |
| `status` | string | Current transaction status (see status values below) |
| `executionTxHash` | string \| null | On-chain transaction hash (null until executed) |
| `timestamp` | string | ISO 8601 timestamp of transaction submission |
| `latency` | number | Time taken for execution in milliseconds (0 if not executed) |
| `costUSD` | number | Transaction cost in USD |
| `retries` | number | Number of retry attempts made |
| `isAccountCharged` | boolean | Whether the account has been charged for the transaction |
| `extraData` | any | Additional transaction metadata |
| `error` | string \| null | Error message if transaction failed |
Transaction Status Values [#transaction-status-values]
| Status | Description |
| --------------------- | ------------------------------------------------------ |
| `NOT_PICKED_UP` | Transaction submitted but not yet picked up by relayer |
| `PICKED_UP` | Transaction picked up by relayer, awaiting execution |
| `PENDING` | Transaction is being processed |
| `NEEDS_TO_BE_RETRIED` | Transaction execution failed and will be retried |
| `EXECUTED` | Transaction successfully executed on-chain |
| `FAILED` | Transaction execution failed permanently |
Error Response [#error-response]
```json filename="error-response.json"
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Transaction not found",
"category": "NOT_FOUND_ERROR",
"details": {
"field": "id",
"message": "No transaction found with the provided ID"
},
"traceId": "trace_abc123xyz789"
},
"timestamp": "2025-10-24T12:34:56.789Z"
}
```
Example Requests [#example-requests]
Basic Status Check [#basic-status-check]
```bash filename="check-status.sh"
curl "https://tachyon.rath.fi/api/tx?id=68fa3450539a3c9d28bbca33" \
-H "api-key: YOUR_API_KEY"
```
Check Multiple Transactions [#check-multiple-transactions]
You can check multiple transactions by making separate requests:
```bash filename="check-status.sh"
#!/bin/bash
TX_IDS=("68fa3450539a3c9d28bbca33" "68fa3450539a3c9d28bbca34" "68fa3450539a3c9d28bbca35")
for tx_id in "${TX_IDS[@]}"; do
echo "Checking status for transaction: $tx_id"
curl "https://tachyon.rath.fi/api/tx?id=$tx_id" \
-H "api-key: YOUR_API_KEY"
echo ""
done
```
With jq for Formatted Output [#with-jq-for-formatted-output]
```bash filename="check-status.sh"
curl "https://tachyon.rath.fi/api/tx?id=68fa3450539a3c9d28bbca33" \
-H "api-key: YOUR_API_KEY" | jq '{
id: .data.id,
status: .data.status,
executionHash: .data.executionTxHash,
cost: .data.costUSD,
latency: .data.latency
}'
```
**Example Output:**
```json filename="status-response.json"
{
"id": "68fa3450539a3c9d28bbca33",
"status": "EXECUTED",
"executionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"cost": 0.8400561743999754,
"latency": 2500
}
```
Response Examples by Status [#response-examples-by-status]
Not Picked Up [#not-picked-up]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"status": "NOT_PICKED_UP",
"executionTxHash": null,
"latency": 0,
"costUSD": 0.8400561743999754,
"error": null,
...
}
}
```
Picked Up / Pending [#picked-up--pending]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"status": "PICKED_UP",
"executionTxHash": null,
"latency": 0,
"costUSD": 0.8400561743999754,
"error": null,
...
}
}
```
Executed [#executed]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"status": "EXECUTED",
"executionTxHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"latency": 2500,
"costUSD": 0.8400561743999754,
"isAccountCharged": true,
"error": null,
...
}
}
```
Failed [#failed]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"status": "FAILED",
"executionTxHash": null,
"latency": 1500,
"costUSD": 0,
"isAccountCharged": false,
"error": "Insufficient gas for transaction execution",
...
}
}
```
Needs Retry [#needs-retry]
```json filename="status-response.json"
{
"success": true,
"data": {
"id": "68fa3450539a3c9d28bbca33",
"status": "NEEDS_TO_BE_RETRIED",
"executionTxHash": null,
"latency": 0,
"costUSD": 0.8400561743999754,
"retries": 2,
"error": "Network congestion - retrying",
...
}
}
```
Understanding Costs and Charging [#understanding-costs-and-charging]
* **costUSD**: Shows the estimated or actual transaction cost
* **isAccountCharged**:
* `false`: Account not yet charged (transaction pending or failed)
* `true`: Account has been charged (transaction executed successfully)
* **Estimated vs Actual Cost**: Before execution, `costUSD` shows the estimate. After execution, it shows the actual cost.
Use Cases [#use-cases]
Transaction Monitoring [#transaction-monitoring]
Check transaction status periodically to update your UI:
```bash filename="check-status.sh"
# Check status every 5 seconds
while true; do
status=$(curl -s "https://tachyon.rath.fi/api/tx?id=68fa3450539a3c9d28bbca33" \
-H "api-key: YOUR_API_KEY" | jq -r '.data.status')
echo "Current status: $status"
if [ "$status" = "EXECUTED" ] || [ "$status" = "FAILED" ]; then
break
fi
sleep 5
done
```
Cost Tracking [#cost-tracking]
Retrieve cost information for accounting:
```bash filename="check-status.sh"
curl "https://tachyon.rath.fi/api/tx?id=68fa3450539a3c9d28bbca33" \
-H "api-key: YOUR_API_KEY" | jq '{
transactionId: .data.id,
cost: .data.costUSD,
charged: .data.isAccountCharged,
timestamp: .data.timestamp
}'
```
Error Handling [#error-handling]
Check for errors and retry logic:
```bash filename="terminal"
response=$(curl -s "https://tachyon.rath.fi/api/tx?id=68fa3450539a3c9d28bbca33" \
-H "api-key: YOUR_API_KEY")
status=$(echo $response | jq -r '.data.status')
error=$(echo $response | jq -r '.data.error')
if [ "$status" = "FAILED" ]; then
echo "Transaction failed: $error"
# Implement retry or notification logic
elif [ "$status" = "NEEDS_TO_BE_RETRIED" ]; then
echo "Transaction will be retried automatically"
fi
```
# Get Transaction Quote (/tachyon/tachyon-api/tx-quote)
## Documentation Index
Fetch the complete documentation index at: https://docs.rath.fi/llms.txt
Use this file to discover all available pages before exploring further.
Get Transaction Quote [#get-transaction-quote]
Before submitting a transaction, you can request a quote to estimate the cost in USD and the minimum balance required. This helps you understand the transaction cost upfront and ensure your account has sufficient balance.
Endpoint [#endpoint]
```
POST https://tachyon.rath.fi/api/quote
```
Request Body [#request-body]
| Parameter | Type | Required | Description |
| ------------------------ | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `chainId` | number | Yes | The blockchain network ID where the transaction will be executed |
| `to` | string | Yes | The recipient wallet address or smart contract address. Format varies by chain (hex for EVM, base58 for Solana, named for NEAR) |
| `value` | string | No | Amount of native currency to send in the smallest unit (wei for EVM, lamports for Solana, yoctoNEAR for NEAR, MIST for Sui). Defaults to '0' |
| `callData` | string | Yes | Encoded transaction data in hexadecimal format (use '0x' for simple transfers) |
| `label` | string | No | Optional human-readable label for tracking |
| `gasLimit` | string | No | Optional gas limit for the transaction. Required for Aptos and Sui transactions |
| `gasPrice` | string | No | Gas price in wei (for legacy transactions). Cannot be used with maxFeePerGas or maxPriorityFeePerGas |
| `maxFeePerGas` | string | No | Maximum fee per gas for EIP-1559 transactions. Must be used together with maxPriorityFeePerGas |
| `maxPriorityFeePerGas` | string | No | Maximum priority fee per gas for EIP-1559 transactions. Must be used together with maxFeePerGas |
| `maxUSD` | number | No | Maximum cost in USD that you're willing to pay for this transaction |
| `shouldBatchInMulticall` | boolean | No | Whether to batch this transaction in a multicall |
| `retries` | number | No | Number of retries if transaction fails. Defaults to 0 |
| `isAuthenticatedTx` | boolean | No | Whether to use authenticated relay mode for additional security. Defaults to false |
| `derivationPath` | string | No | Optional HD wallet derivation path for transaction signing |
| `transactionType` | string | No | Type of relay transaction: `"flash"` (default), `"authenticated"`, `"funding-signed"`, or `"flash-blocks"` (Base/Base Sepolia only) |
| `authorizationList` | array | No | Optional list of authorization entries for delegated transactions or batched operations (EIP-7702). Not allowed for flash-blocks transactions |
AuthorizationListItem Object [#authorizationlistitem-object]
When using `authorizationList`, each item should contain:
| Field | Type | Required | Description |
| --------- | ------------- | -------- | -------------------------------------------- |
| `chainId` | number | Yes | Chain ID for the authorization |
| `address` | string | Yes | Ethereum address (must start with "0x") |
| `nonce` | number | Yes | Nonce for the authorization |
| `r` | string | Yes | Signature r component (must start with "0x") |
| `s` | string | Yes | Signature s component (must start with "0x") |
| `yParity` | number | Yes | Signature y parity (0 or 1) |
| `v` | number/bigint | No | Optional signature v value |
Gas Parameter Rules [#gas-parameter-rules]
* **Legacy transactions**: Use `gasPrice` only
* **EIP-1559 transactions**: Use both `maxFeePerGas` and `maxPriorityFeePerGas` together
* You cannot mix `gasPrice` with `maxFeePerGas` or `maxPriorityFeePerGas`
Response [#response]
Success Response [#success-response]
```json filename="response.json"
{
"success": true,
"data": {
"costUSD": 0.0009221670934825817,
"minBalanceRequired": "223171904787"
},
"timestamp": "2025-10-24T12:34:56.789Z"
}
```
Response Fields [#response-fields]
| Field | Type | Description |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `costUSD` | number | Estimated transaction cost in USD. This includes gas fees and relay service charges |
| `minBalanceRequired` | string | Minimum balance required in the smallest unit to execute the transaction. Unit varies by chain (wei for EVM, lamports for Solana, yoctoNEAR for NEAR, octas for Aptos, MIST for Sui) |
Error Response [#error-response]
```json filename="error-response.json"
{
"success": false,
"error": {
"code": "INVALID_PARAMETERS",
"message": "Missing required transaction parameters for quote",
"category": "VALIDATION_ERROR",
"details": {
"field": "chainId",
"message": "chainId is required"
},
"traceId": "trace_abc123xyz789"
},
"timestamp": "2025-10-24T12:34:56.789Z"
}
```
Example Requests [#example-requests]
**Note:** Gas limit is required for Aptos transactions.
**Note:** Gas limit is required for Sui transactions. Value is denominated in MIST (1 SUI = 10^9 MIST).
**Note:** Flash-blocks transaction type is only supported on Base (8453) and Base Sepolia (84532). Authorization lists cannot be used with flash-blocks transactions.
Quote with Authorization List (EIP-7702) [#quote-with-authorization-list-eip-7702]
```bash filename="api-request.sh"
curl -X POST "https://tachyon.rath.fi/api/quote" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "1000000000000000",
"callData": "0x",
"authorizationList": [
{
"chainId": 8453,
"address": "0x1234567890abcdef1234567890abcdef12345678",
"nonce": 1,
"r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"yParity": 1
}
],
"label": "Delegated Transaction Quote"
}'
```
Quote with Custom Derivation Path [#quote-with-custom-derivation-path]
```bash filename="api-request.sh"
curl -X POST "https://tachyon.rath.fi/api/quote" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "1000000000000000",
"callData": "0x",
"derivationPath": "m/44'\''/60'\''/0'\''/0/1",
"label": "Quote from Custom Account"
}'
```
Quote with Multicall Batching [#quote-with-multicall-batching]
```bash filename="api-request.sh"
curl -X POST "https://tachyon.rath.fi/api/quote" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d '{
"chainId": 8453,
"to": "0x3dbE34f2C21b3B2980d4dc53f3c7E51e39663F49",
"value": "0",
"callData": "0xa9059cbb000000000000000000000000...",
"shouldBatchInMulticall": true,
"label": "Batched Transaction Quote"
}'
```
Understanding Units [#understanding-units]
The `minBalanceRequired` field uses different units depending on the blockchain:
| Network | Unit | Conversion |
| ---------- | --------- | ----------------------- |
| EVM Chains | Wei | 1 ETH = 10¹⁸ wei |
| Solana | Lamports | 1 SOL = 10⁹ lamports |
| NEAR | yoctoNEAR | 1 NEAR = 10²⁴ yoctoNEAR |
| Aptos | Octas | 1 APT = 10⁸ octas |
| Sui | MIST | 1 SUI = 10⁹ MIST |
Use Cases [#use-cases]
* **Pre-transaction validation**: Check if users have sufficient balance before attempting a transaction
* **Cost transparency**: Display estimated costs to users in your application UI
* **Budget planning**: Help users understand the financial impact of their transactions with maxUSD limits
* **Multi-chain comparison**: Compare costs across different blockchain networks for the same operation
* **Gas optimization**: Test different gas parameters to find the optimal transaction cost
# EIP-7702 with Account Abstraction (/tachyon/use-cases/eip7702-account-abstraction)
## Documentation Index
Fetch the complete documentation index at: https://docs.rath.fi/llms.txt
Use this file to discover all available pages before exploring further.
EIP-7702 with Account Abstraction [#eip-7702-with-account-abstraction]
This guide demonstrates how to combine EIP-7702 authorization with ERC-4337 Account Abstraction to execute UserOperations through an EOA delegated to a smart account implementation.
Overview [#overview]
By leveraging EIP-7702, you can temporarily delegate your EOA to an ERC-4337 compatible smart account, enabling:
* **Gas Sponsorship**: Execute transactions without holding native tokens
* **Batched Operations**: Multiple contract calls in a single transaction
* **Custom Validation**: Advanced signature schemes and access controls
* **No Migration Required**: Use smart account features without deploying a new wallet
Prerequisites [#prerequisites]
* Node.js 18+
* A funded EOA wallet
* Tachyon API key
* Basic understanding of [EIP-7702](/tachyon/features/eip-7702) and Account Abstraction
Step-by-Step Implementation [#step-by-step-implementation]
