@tychilabs/stonfi-gasless-sdk
v0.0.5
Published
Universal Gas Framework SDK for gasless payments - pay TON transaction fees with STON token
Downloads
25
Maintainers
Readme
STON.fi Gasless SDK
Universal Gas Framework SDK for paying TON transaction fees with STON tokens.
By Tychi Labs
Overview
The STON.fi Gasless SDK enables developers to build applications where users pay transaction fees with STON tokens instead of TON. This eliminates the friction of requiring users to hold native tokens for gas, making blockchain interactions more accessible and user-friendly.
Why UGF?
Traditional blockchain transactions create barriers for new users who must acquire native tokens just to pay gas fees. Universal Gas Framework solves this by:
- Simplifying User Experience - Users can transact using only STON tokens, removing the need to manage multiple token types
- Supporting DeFi Ecosystem - Locked STON provides liquidity to STON.fi, strengthening the broader ecosystem
- Enabling Gasless Flows - Developers can create seamless onboarding experiences where users never think about gas fees
- Maintaining Security - All transactions are cryptographically signed and verified on-chain
Whether you're building a DEX, NFT marketplace, or any dApp on TON, UGF enables truly gasless user experiences while leveraging STON's liquidity.
How It Works
- Users lock STON tokens in the UGF escrow contract
- Locked STON becomes an x402 balance used for gas payments
- Your application requests a quote via the SDK
- User signs the payment digest
- UGF verifies the signature and deducts STON
- The contract pays TON gas fees on the user's behalf
- Transaction executes seamlessly
No relaying, no wrapped tokens - just direct gas payment with STON.
Installation
npm install @tychilabs/stonfi-gasless-sdkRequirements
- Node.js 16 or higher
@ton/core>= 0.63.0 (peer dependency)- API Key - Contact us at [email protected] to get started
Features
- STON Gas Payments - Pay transaction fees with STON instead of TON
- Cryptographic Signing - Built-in utilities for digest signing and verification
- Full TypeScript Support - Complete type definitions for all API interactions
- Simple, Intuitive API - Clean interfaces that follow modern JavaScript patterns
- Comprehensive Error Handling - Typed error classes for precise error management
- Production Ready - Battle-tested code with proper validation and security measures
Documentation
Complete guides and references to get you started:
- Quick Start Guide - Get up and running in 5 minutes
- API Reference - Detailed documentation of all SDK methods
Use Cases
- DEX Integrations - Enable token swaps without requiring TON for gas
- NFT Marketplaces - Let users mint and trade NFTs using only STON
- Gaming dApps - Simplify in-game transactions by eliminating gas fee complexity
- Onboarding Flows - Create seamless signup experiences without native token requirements
- DeFi Applications - Build lending, staking, or yield farming platforms with gasless UX
Coming Soon
ston.universalgasframework.com - Self-service portal for API key management, analytics, and monitoring
Getting Help
We're here to support your integration:
- Technical Issues - GitHub Issues
- Integration Support - Email us at [email protected]
- Feature Requests - Open a discussion on GitHub
Contributing
We welcome contributions from the community. Please see our contributing guidelines and feel free to submit issues or pull requests.
License
MIT © Tychi Labs
