Версия 0.1.3 · Команды установки используют точные версии.

Ruby SDK для Telegram Stars и Premium

Установка независимого SDK Fragment Donor для Ruby: username, подарки Stars/Premium и rate limit.

При покупке mnemonic кошелька и сессия/cookie Fragment передаются оператору API.

Runtime: Ruby 3.2+. Устанавливайте пакет из реестра только после статуса PUBLISHED; до этого используйте сборку каталога ruby из public source.

Клиент предлагает username, покупку Stars, подарок Premium и баланс с naming, принятым в Ruby. Запросы используют form-urlencoded. Баланс сохраняется decimal-строкой, дополнительные поля не удаляются.

Настройте timeout и данные кошелька на backend. Повтор чтения включается явно и ограничен; покупки никогда не повторяются автоматически. Точный constructor и типы ошибок приведены в README пакета.

Установка

gem install fragment-donor-sdk -v 0.1.3

Пример

require "fragment_donor_sdk"

client = FragmentDonor::Client.new(
  credentials: FragmentDonor::Credentials.new(
    mnemonic: ENV.fetch("FRAGMENT_MNEMONIC"),
    cookie: ENV.fetch("FRAGMENT_COOKIE"),
    wallet_version: "auto",
    provider_key: ENV["TONCONSOLE_API_KEY"] # optional provider key only
  ),
  connect_timeout: 5,
  request_timeout: 30
)
user = client.get_user_info("durov")
balance = client.wallet_balance
# Exact strings; do not convert to Float.
puts balance.ton

# Real-funds operations require both opt-in and one selected purchase.
if ENV["FRAGMENT_ALLOW_PURCHASES"] == "yes"
  begin
    case ENV["FRAGMENT_PURCHASE_KIND"]
    when "stars" then client.buy_stars("durov", 50, payment_method: "usdt_ton")
    when "premium" then client.buy_premium("durov", 3, payment_method: "ton")
    end
  rescue FragmentDonor::PurchaseOutcomeUnknownError => error
    # Reconcile error.details["tx_hash"] manually. Do not repeat the purchase.
  end
end

Исходный код · ruby

Читайте дальше

Telegram Stars API: 429, Retry-After и flood wait · Защита данных кошелька при интеграции API · Вопросы об API и SDK Fragment Donor

OpenAPI 3.0 · Postman collection