Skip to content

Latest commit

 

History

History
103 lines (76 loc) · 3.02 KB

README.md

File metadata and controls

103 lines (76 loc) · 3.02 KB
Raw

Gasilon

An 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 supported on Solana. It helps users 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 works as a transaction relayer, validates, signs and sends transaction

  • Transaction will be required to include fee paying instruction, the exchange fee queried from external price API
  • Supported instructions: Create Associated Token Account, Transfer Token, Set Compute Unit
  • Endpoints: getFee to get the transaction fee with exchange rate, transfer to send transaction

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, accept both base58 string or bytes array string>
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 is 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 other platforms)

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