Sotechy

Sotechy is a multi-store marketplace. Verified stores sell through the Sotechy app, each with its own storefront and its own reward token, and Sotechy itself is one of those stores (its own electronics catalogue, branches and the $SOTECHY token). Sotechy collects every payment, pays stores out, checks every store before it goes live, and runs support.

App	Path	Stack	Who uses it
Customer app	apps/mobile	Expo SDK 58 + Expo Router	Shoppers: Android, iOS and web
Merchant dashboard	apps/merchant	Next.js 16 + Tailwind	Stores: setup and verification, products, orders, delivery and pickup, payouts, token, promotions, walk-in sales, team
Admin dashboard	apps/admin	Next.js 16 + Tailwind	Sotechy: store review, payouts, orders, banners, support, tokens, settings; plus Sotechy's own catalogue, branches and POS
Landing page	apps/web	Next.js 16 + Tailwind	Marketing site (sotechy.shop)
API	apps/api	Hono + Drizzle ORM + Postgres	Backend for all of the above, on Railway
Shared	packages/shared	TypeScript	Types, money and token rules, categories, API client
Brand assets	brand-assets/	—	Logo and images → pnpm assets:sync

How tokens, the reserve and payouts work is in docs/tokens/README.md.

NEAR Hackathon

This repo is our NEAR Hackathon submission (tracks: Real-World Money and NFTs That Do Something). The submission's README is on the near-hackathon branch, which holds the code as submitted (tag hackathon-submission).

The NEAR code is in near/: the Sotechy contract on NEAR (store tokens as NEP-245, and soulbound receipts as dynamic NEP-171 that change with the order), with tests, deploy scripts and a demo that reads the live contract without keys. NEAR is wired into the live app:

• apps/api/src/services/near.ts writes every token change and receipt step to NEAR.
• apps/api/src/services/intents.ts, apps/api/src/services/deposit-watch.ts and apps/mobile/src/components/intents-pay.tsx let customers pay with any coin on any chain through NEAR Intents.

Live on mainnet at contract.sotechy.near.

Baseline (pre-hackathon code).

• Sotechy Shop has been an electronics store in Benin City since 2022. Its old website was a separate codebase and isn't in this repo.
• This repo's first commit (4bbbaa4, tag pre-hackathon, 25 Oct 2026) brought in about 10,850 lines that were already written: the API basics, the admin dashboard, the customer app shell and the landing page. Treat that commit as baseline.

Built during the hackathon (every commit after 4bbbaa4, from 25 Oct 2026, to tag hackathon-submission; see pre-hackathon...hackathon-submission):

• the marketplace: store verification, storefronts, payouts, offers, promotions and walk-in sales
• the merchant dashboard
• store tokens, sending them to friends, and the reserve
• the Base contracts
• everything in near/, writing tokens and receipts to NEAR, and the NEAR Intents checkout

Other submission by the same builder. We're also submitting Money Moves × NEAR Intents, a separate, independent project with its own code: github.com/soke-dev/money-moves-near. The two share no code and should be judged independently.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗