GasFree SDK

gem 'gasfree_sdk'

require 'gasfree_sdk'

GasfreeSdk.configure do |config|
  config.api_key = "your-api-key"
  config.api_secret = "your-api-secret"
  config.api_endpoint = "https://open.gasfree.io/tron/"  # TRON endpoint
end

client = GasfreeSdk.client

tokens = client.tokens
tokens.each do |token|
  puts "#{token.symbol} (#{token.token_address})"
  puts "  Activation Fee: #{token.activate_fee}"
  puts "  Transfer Fee: #{token.transfer_fee}"
end

providers = client.providers
providers.each do |provider|
  puts "#{provider.name} (#{provider.address})"
  puts "  Max Pending Transfers: #{provider.config.max_pending_transfer}"
  puts "  Default Deadline: #{provider.config.default_deadline_duration}s"
end

account = client.address("TYourTronAddress")
puts "GasFree Address: #{account.gas_free_address}"
puts "Active: #{account.active}"
puts "Nonce: #{account.nonce}"

account.assets.each do |asset|
  puts "#{asset.token_symbol}: #{asset.frozen} frozen"
end

# Example message data
message_data = {
  token: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", # USDT TRC-20
  serviceProvider: "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp",
  user: "TYRhsi1fkke2tjdVW9XGYLjf8TgbbutEgY",
  receiver: "TW1dWXfta5ygVN298JBN2UPhaSAUzo2owZ",
  value: "3000000", # 3 USDT (6 decimals)
  maxFee: "2000000", # 2 USDT max fee
  deadline: (Time.now.to_i + 300).to_s, # 5 minutes from now
  version: 1,
  nonce: 0
}

private_key = "your_private_key_hex"

# Sign for TRON Testnet (Nile)
testnet_signature = GasfreeSdk::TronEIP712Signer.sign_typed_data_testnet(private_key, message_data)

# Sign for TRON Mainnet
mainnet_signature = GasfreeSdk::TronEIP712Signer.sign_typed_data_mainnet(private_key, message_data)

# Generic signing with custom domain
signature = GasfreeSdk::TronEIP712Signer.sign_typed_data(
  private_key, 
  message_data, 
  domain: GasfreeSdk::TronEIP712Signer::DOMAIN_TESTNET
)

custom_domain = {
  name: "GasFreeController",
  version: "V1.0.0",
  chainId: 728_126_428,
  verifyingContract: "THQGuFzL87ZqhxkgqYEryRAd7gqFqL5rdc"
}

signature = GasfreeSdk::TronEIP712Signer.sign_typed_data(
  private_key,
  message_data,
  domain: custom_domain,
  use_ethereum_v: true
)

# Keccak256 hashing
hash = GasfreeSdk::TronEIP712Signer.keccac256("data to hash")
hex_hash = GasfreeSdk::TronEIP712Signer.keccac256_hex("data to hash")

# EIP-712 type encoding
encoded_type = GasfreeSdk::TronEIP712Signer.encode_type(:PermitTransfer)

# Structured data hashing
message_hash = GasfreeSdk::TronEIP712Signer.hash_struct(:PermitTransfer, message_data)
domain_hash = GasfreeSdk::TronEIP712Signer.hash_domain

# Base58 encoding/decoding for TRON addresses
binary_data = GasfreeSdk::Base58.base58_to_binary("TYRhsi1fkke2tjdVW9XGYLjf8TgbbutEgY")
base58_string = GasfreeSdk::Base58.binary_to_base58(binary_data)

# TRON Testnet (Nile)
GasfreeSdk::TronEIP712Signer::DOMAIN_TESTNET
# => {
#   name: "GasFreeController",
#   version: "V1.0.0", 
#   chainId: 728_126_428,
#   verifyingContract: "THQGuFzL87ZqhxkgqYEryRAd7gqFqL5rdc"
# }

# TRON Mainnet
GasfreeSdk::TronEIP712Signer::DOMAIN_MAINNET
# => {
#   name: "GasFreeController",
#   version: "V1.0.0",
#   chainId: 3_448_148_188,
#   verifyingContract: "TFFAMQLZybALaLb4uxHA9RBE7pxhUAjF3U"
# }

# Create and submit a transfer request
token = client.tokens.first
provider = client.providers.first

message_data = {
  token: token.token_address,
  serviceProvider: provider.address,
  user: "TYourTronAddress",
  receiver: "TReceiverAddress",
  value: "1000000", # 1 USDT
  maxFee: "500000",  # 0.5 USDT max fee
  deadline: (Time.now.to_i + provider.config.default_deadline_duration).to_s,
  version: 1,
  nonce: account.nonce
}

# Sign the message
signature = GasfreeSdk::TronEIP712Signer.sign_typed_data_testnet(private_key, message_data)

# Create transfer request
request = GasfreeSdk::Models::TransferRequest.new(
  token: message_data[:token],
  service_provider: message_data[:serviceProvider],
  user: message_data[:user],
  receiver: message_data[:receiver],
  value: message_data[:value],
  max_fee: message_data[:maxFee],
  deadline: message_data[:deadline].to_i,
  version: message_data[:version],
  nonce: message_data[:nonce],
  sig: signature
)

# Submit the transfer
response = client.submit_transfer(request)
puts "Transfer ID: #{response.id}"
puts "State: #{response.state}"

transfer_id = response.id

loop do
  status = client.transfer_status(transfer_id)
  puts "State: #{status.state}"
  puts "Transaction Hash: #{status.txn_hash}" if status.txn_hash
  
  break if %w[SUCCEED FAILED].include?(status.state)
  sleep 2
end

begin
  response = client.submit_transfer(request)
rescue GasfreeSdk::APIError => e
  puts "API Error (#{e.code}): #{e.message}"
  
  case e.message
  when /insufficient balance/
    puts "Solution: Get test tokens or transfer tokens to GasFree address"
  when /max fee exceeded/
    puts "Solution: Increase maxFee parameter"
  when /Invalid signature/
    puts "Solution: Check private key and address correspondence"
  end
rescue StandardError => e
  puts "Error: #{e.message}"
end