Skip to content

Latest commit

 

History

History
95 lines (76 loc) · 3 KB

README.md

File metadata and controls

95 lines (76 loc) · 3 KB
Raw

Gasilon

A infrastructure layer that abstracts gas fees, allowing users to make any transaction on Solana without SOL

What is Gasilon?

Gasilon is a gasless solution currently supports on Solana. It helps user make a transaction without SOL, using SPL Token to pay fee instead.

Gasilon provides an API api.gasilon.com for anyone (Wallet, DApp,...) to easily integrate gasless features, making any transaction without SOL seamlessly. The source code also includes Client CLI as a code snippet for testing, see how it works and for playground quickly.

How it works?

Gasilon uses a technique called relayer, we have some references from Solana-labs/Octane project. With some improvements:

  • Use external price API call to market to get exchange fee
  • Make validation step more flexible with supporting both create account and transfer token
  • Calculate total fee including rent fee and transaction fee to make a swap instruction (fee paying)

Here is Gasilon flow:

sequenceDiagram
    Wallet/DApp->>Gasilon API: Get supported tokens
    activate Wallet/DApp
    activate Gasilon API
    Gasilon API-->>Wallet/DApp: Tokens list
    deactivate Gasilon API
    Wallet/DApp->>Wallet/DApp: Construct template transaction with SPL token as gas fee
    Wallet/DApp->>Gasilon API: Get estimated fee for transaction
    activate Gasilon API
    Gasilon API->>Gasilon API: Validate transaction
    Gasilon API->>Price API: Get exchange rate from SOL to SPL Token
    activate Price API
    Price API-->>Gasilon API: Exchange rate
    deactivate Price API
    Gasilon API-->>Wallet/DApp: Transaction Fee
    deactivate Gasilon API
    Wallet/DApp->>Wallet/DApp: Reconstruct and sign transaction
    Wallet/DApp->>Gasilon API: Sent to transfer
    activate Gasilon API
    Gasilon API->>Gasilon API: Validate transaction with checking fee
    Gasilon API->>On-chain RPC: Sign and send transaction
    activate On-chain RPC
    On-chain RPC-->>Gasilon API: Signature
    deactivate On-chain RPC
    Gasilon API-->>Wallet/DApp: Signature
    deactivate Gasilon API
    deactivate Wallet/DApp
Loading

Setup

First, install packages

yarn install

Playground with Client CLI

Create .env file at client/

PRIVATE_KEY=<client private key to make transaction>
GASILON_ENDPOINT=https://api.gasilon.com

Run commands:

cd client && yarn get-fee
# or
cd client && yarn transfer

Config API

Create .env file at project scope

ENVIRONMENT=<production || development>
SOLANA_SECRET_KEY=<private key>

# Use price API
REDIS_USERNAME
REDIS_PASSWORD
REDIS_HOST
  1. make sure .env file configured as described above
  2. run yarn setup to check associated accounts (for fee tokens in the config list in config.json)

Local run

cd server && yarn dev

Deploy

Deploy to production (AWS only for now, welcome PR for another platforms)

Run yarn deploy to deploy this to your AWS account (see sst.config.ts for further details)