GMShop Edge
GMShop Edge is a self-hosted, single-deployment, single-tenant digital-goods storefront for Cloudflare Workers or a Bun/Nitro Docker container.
One deployment provides a responsive public shop, customer accounts, checkout and fulfillment, Telegram integration, supplier operations, and a permission-driven administration console.
It is a separate companion project from Epusdt and GMPay Edge. Use GMShop Edge when the product you need to operate is a digital-goods storefront with catalog, checkout, delivery, and supplier workflows.
GMShop Edge is under active development. Built-in adapters mean integration paths exist; production use still requires deployer-owned credentials, backups, monitoring, and real-provider acceptance tests.
What it provides
- Stock products that atomically allocate encrypted preset text, private-download products, and automation products with explicit artifact policies.
- Permanent, fixed-term, limited, unlimited, free, one-time, and customer-renewed entitlements.
- Guest and registered checkout, coupons, refunds, after-sales handling, private order lookup, and account-based delivery access.
- Store wallet payments plus Stripe, Cryptomus, GMpay, EPay, Alipay Page/WAP, and WeChat Native/H5 adapters.
- Supplier catalog synchronization and fulfillment through ACG
3.5.5, Dujiao Nextv1.3.1, or the native GMShop Edge supplier API. - Runtime-configured email/password, social, OIDC, Telegram OIDC, Telegram Login Widget, and Telegram Mini App authentication.
- A grammY webhook bot with localized commands, Mini App buttons, and optional Forum Topic-backed customer support without persisting message content.
- Dynamic multi-role RBAC for
/admin, with root-account protection, server-side permission checks, reauthentication, and audit records. - English (
en-US) and Simplified Chinese (zh-CN) application locales.
Every capability listed above is part of the open-source project; there is no separate Pro or Enterprise tier.
Documentation sections
- Architecture: shared application stack, Workers bindings, Bun adapters, data ownership, and runtime limits.
- Deployment: Workers, Bun/Docker, installation, and production acceptance.
- Bun data operations: backup, restore, and Cloudflare D1/R2 import.
- Native supplier API: signed catalog, order, payment-channel, and top-up operations between GMShop Edge instances.
- Commerce and fulfillment: products, inventory, suppliers, delivery records, entitlements, and automation goods.
- Checkout and providers: wallet and external payments, fiat quotes, email, authentication, and Telegram support.
Links
- Repository: GMWalletApp/gmshop-edge
- Deployment checklist:
docs/DEPLOYMENT.md - Bun data operations:
docs/NODE_DATA_OPERATIONS.md - OpenAPI YAML:
public/openapi.yaml
