Merge branch 'main' into feat/media-w-hf

Author: h4rkl

apps/templates/next.config.ts

@@ -4,6 +4,11 @@ import type { NextConfig } from "next";
 const nextConfig: NextConfig = {
   reactStrictMode: true,
   trailingSlash: false,
+  // Use basePath only when env var is set (for proxy integration)
+  // Without env var, templates serves at root for standalone subdomain
+  ...(process.env.NEXT_PUBLIC_USE_BASE_PATH === "true" && {
+    basePath: "/developers/templates",
+  }),
 
   webpack(config) {
     // Handle inline SVGs

apps/templates/public/locales/en/common.json

@@ -20,6 +20,7 @@
       "mobile": "Mobile",
       "payments": "Payments",
       "airdrop": "Airdrop",
+      "auth": "Auth",
       "nextjs": "Next.js",
       "expo": "Expo",
       "vite": "Vite",

apps/templates/src/app/[locale]/[id]/page.tsx

@@ -5,6 +5,8 @@ import { TemplatesProviderWrapper } from "@/components/providers/templates-provi
 import { BackgroundShapes } from "@/components/background-shapes";
 import type { Metadata } from "next";
 
+export const revalidate = 3600;
+
 export async function generateStaticParams() {
   const templates = await fetchTemplatesFromGitHub();
   return templates.map((template) => ({

apps/templates/src/app/[locale]/page.tsx

@@ -6,6 +6,8 @@ import { fetchTemplatesFromGitHub } from "@/lib/fetch-templates";
 import { AppProviders } from "@/components/app-providers";
 import { TemplatesProviderWrapper } from "@/components/providers/templates-provider-wrapper";
 
+export const revalidate = 3600;
+
 export default async function TemplatesPage() {
   const templates = await fetchTemplatesFromGitHub();
   const t = await getTranslations("templates");

apps/templates/src/lib/fetch-templates.ts

@@ -37,7 +37,7 @@ type TemplatesJsonGroup = {
 export async function fetchTemplatesFromGitHub(): Promise<Template[]> {
   try {
     const response = await fetch(GITHUB_TEMPLATES_JSON, {
-      next: { revalidate: 3600 }, // Revalidate every hour (ISR)
+      next: { revalidate: 60 }, // Revalidate every minute (ISR)
     });
 
     if (!response.ok) {
@@ -57,7 +57,7 @@ export async function fetchTemplatesFromGitHub(): Promise<Template[]> {
 
         try {
           const readmeResponse = await fetch(readmePath, {
-            next: { revalidate: 3600 }, // Revalidate every hour (ISR)
+            next: { revalidate: 60 }, // Revalidate every minute (ISR)
           });
           if (readmeResponse.ok) {
             const readmeText = await readmeResponse.text();

apps/templates/src/lib/templates/filter-templates.ts

@@ -7,8 +7,10 @@ const DEFAULT_TEMPLATE_NAMES = [
   "gill-react-vite-tailwind-basic", // Fullstack boilerplate (Vite)
   "web3js-expo", // Mobile
   "gill-jito-airdrop", // Airdrop
-  "x402-solana-protocol", // Payments
+  "x402-template", // X402 Next.js
+  "gill-node-solanax402", // X402 Express Server
   "gill-node-express", // Backend
+  "supabase-auth", // Auth
 ];
 
 export function filterTemplates({

apps/templates/src/lib/types/templates/filters.ts

@@ -28,6 +28,10 @@ export const createFilters = (t: (key: string) => string): TemplateFilter[] => [
         id: "airdrop",
         name: t("keywords.airdrop"),
       },
+      {
+        id: "auth",
+        name: t("keywords.auth"),
+      },
     ],
     name: t("categories.usecases"),
   },
@@ -109,6 +113,7 @@ export const filters: TemplateFilter[] = [
       { id: "mobile", name: "Mobile" },
       { id: "payments", name: "Payments" },
       { id: "airdrop", name: "Airdrop" },
+      { id: "auth", name: "Auth" },
     ],
     name: "Use Cases",
   },

apps/web/content/docs/ar/core/accounts.mdx

@@ -27,7 +27,11 @@ description:
 
 ### المفتاح العام
 
-يوضح المثال أدناه كيفية استخدام مكتبة تطوير سولانا لإنشاء زوج مفاتيح.
+يوضح المثال أدناه كيفية استخدام مجموعة تطوير برمجيات سولانا لإنشاء keypair.
+يتضمن `Keypair` ما يلي:
+
+- مفتاح عام يعمل كعنوان الحساب
+- مفتاح خاص يُستخدم لتوقيع المعاملات
 
 <CodeTabs storage="accounts" flags="r">
 
@@ -60,11 +64,11 @@ async fn main() {
 
 </CodeTabs>
 
-### العنوان المشتق من البرنامج
+### Program Derived Address
 
-[العنوان المشتق من البرنامج](/docs/core/pda) (PDA) هو عنوان يتم اشتقاقه بشكل
-حتمي باستخدام معرّف البرنامج ومدخل واحد أو أكثر اختياري (بذور). يوضح المثال
-أدناه كيفية استخدام مكتبة تطوير سولانا لإنشاء عنوان مشتق من البرنامج.
+[Program Derived Address](/docs/core/pda) (PDA) هو عنوان يتم اشتقاقه بشكل حتمي
+باستخدام معرّف البرنامج ومدخلات اختيارية واحدة أو أكثر (البذور). يوضح المثال
+أدناه كيفية استخدام مجموعة تطوير برمجيات سولانا لإنشاء Program Derived Address.
 
 <CodeTabs storage="accounts" flags="r">
 
@@ -124,12 +128,12 @@ async fn main() {
 
 <WithMentions>
 
-- [`lamports`](mention:lamports): عدد [لامبورتس](#lamports) في الحساب
-- [`data`](mention:data): [بيانات](#data) الحساب
-- [`owner`](mention:owner): معرّف البرنامج الذي [يملك](#owner) الحساب
-- [`executable`](mention:executable): يشير إلى ما إذا كان الحساب يحتوي على ثنائي
-  [قابل للتنفيذ](#executable)
-- [`rent_epoch`](mention:rent_epoch): حقل [فترة الإيجار](#rent-epoch) المهمل
+- [`lamports`](mention:lamports): عدد وحدات lamport في الحساب
+- [`data`](mention:data): بيانات الحساب
+- [`owner`](mention:owner): معرّف البرنامج الذي يملك الحساب
+- [`executable`](mention:executable): يشير إلى ما إذا كان الحساب يحتوي على ملف
+  ثنائي قابل للتنفيذ
+- [`rent_epoch`](mention:rent_epoch): حقل rent epoch المهمل
 
 ```rust title="Account"
 pub struct Account {
@@ -156,23 +160,24 @@ pub struct Account {
 
 <ScrollyCoding>
 
-## !!steps لامبورت
+## !!steps وحدات Lamports
 
-رصيد الحساب بوحدة [lamport](/docs/references/terminology#lamport).
+رصيد الحساب بوحدات [lamport](/docs/references/terminology#lamport).
 
 يجب أن يكون لكل حساب حد أدنى من رصيد lamport، يسمى
-[rent](/docs/references/terminology#rent)، والذي يسمح بتخزين بياناته على
-السلسلة. يتناسب الإيجار مع حجم الحساب.
+[rent](/docs/references/terminology#rent)، مما يسمح بتخزين بياناته على السلسلة.
+يتناسب rent مع حجم الحساب.
 
 <Callout type="info">
-  على الرغم من أن هذا الرصيد يسمى إيجار، إلا أنه يعمل أكثر مثل وديعة، حيث يمكن
+  على الرغم من أن هذا الرصيد يسمى rent، إلا أنه يعمل أكثر مثل وديعة، حيث يمكن
   استرداد الرصيد الكامل عند إغلاق الحساب. (يأتي اسم "rent" من حقل [rent
-  epoch](#rent-epoch) الذي تم إلغاؤه الآن.)
+  epoch](#rent-epoch) المهمل الآن.)
 </Callout>
 
-(انظر صيغة
+(انظر
 [الحد الأدنى للرصيد](https://github.com/anza-xyz/agave/blob/v2.1.13/sdk/rent/src/lib.rs#L93-L97)
-و[الثوابت](https://github.com/anza-xyz/agave/blob/v2.1.13/sdk/rent/src/lib.rs#L47-L70)
+صيغة و
+[الثوابت](https://github.com/anza-xyz/agave/blob/v2.1.13/sdk/rent/src/lib.rs#L47-L70)
 المطبقة.)
 
 ```rust !! title="Account Examples"
@@ -201,20 +206,20 @@ Account {
 
 ## !!steps البيانات
 
-يشار إلى هذا الحقل عادةً باسم "بيانات الحساب". تعتبر `data` في هذا الحقل عشوائية
-لأنها يمكن أن تحتوي على أي تسلسل من البايتات. يحدد كل برنامج هيكل البيانات
-المخزنة في هذا الحقل.
+يشار إلى هذا الحقل عادةً باسم "بيانات الحساب". تعتبر `data` في هذا الحقل
+اعتباطية حيث يمكن أن تحتوي على أي تسلسل من البايتات. كل برنامج يحدد بنية
+البيانات المخزنة في هذا الحقل.
 
-- حسابات البرامج: يحتوي هذا الحقل إما على كود البرنامج القابل للتنفيذ أو عنوان
-  [حساب بيانات البرنامج](#program-data-accounts) الذي يخزن كود البرنامج القابل
+- program account: يحتوي هذا الحقل إما على رمز البرنامج القابل للتنفيذ أو عنوان
+  [حساب بيانات البرنامج](#program-data-accounts) الذي يخزن رمز البرنامج القابل
   للتنفيذ.
 - حسابات البيانات: يخزن هذا الحقل عمومًا بيانات الحالة، المقصود قراءتها.
 
 تتضمن قراءة البيانات من حساب سولانا خطوتين:
 
 1. جلب الحساب باستخدام [عنوانه](#account-address)
-2. فك تشفير حقل `data` الخاص بالحساب من البايتات الخام إلى هيكل البيانات
-   المناسب، كما هو محدد من قبل البرنامج الذي يملك الحساب.
+2. فك تشفير حقل `data` الخاص بالحساب من البايتات الخام إلى بنية البيانات
+   المناسبة، كما هو محدد من قبل البرنامج الذي يملك الحساب.
 
 ```rust !! title="Account Examples"
 // Example Token Mint Account
@@ -244,14 +249,15 @@ Account {
 
 ## !!steps المالك
 
-يحتوي هذا الحقل على معرف البرنامج الخاص بمالك الحساب.
+يحتوي هذا الحقل على معرف البرنامج لمالك الحساب.
 
-كل حساب في سولانا له [برنامج](/docs/core/programs) معين كمالك له. مالك الحساب هو
-البرنامج الوحيد الذي يمكنه تغيير `data` الخاصة بالحساب أو خصم وحدات lamport، كما
+كل حساب في سولانا لديه [برنامج](/docs/core/programs) معين كمالك له. مالك الحساب
+هو البرنامج الوحيد الذي يمكنه تغيير `data` الخاصة بالحساب أو خصم لامبورتس، كما
 هو موضح في تعليمات البرنامج.
 
-(في حالة حساب البرنامج، يكون المالك هو
-[برنامج التحميل الخاص به](https://solana.com/docs/core/programs#loader-programs).)
+(في حالة program account، يكون المالك هو
+[برنامج التحميل](https://solana.com/docs/core/programs#loader-programs) الخاص
+به.)
 
 ```rust !! title="Account Examples"
 // Example Token Mint Account
@@ -279,10 +285,10 @@ Account {
 
 ## !!steps قابل للتنفيذ
 
-يشير هذا الحقل إلى ما إذا كان الحساب هو [حساب برنامج](#program-accounts) أو
+يشير هذا الحقل إلى ما إذا كان الحساب هو [program account](#program-accounts) أو
 [حساب بيانات](#data-accounts)
 
-- إذا كان `true`: فالحساب هو حساب برنامج
+- إذا كان `true`: فالحساب هو program account
 - إذا كان `false`: فالحساب هو حساب بيانات
 
 ```rust !! title="Account Examples"
@@ -313,8 +319,8 @@ Account {
 
 **حقل `rent_epoch` مهمل.**
 
-في الماضي، كان هذا الحقل يتتبع متى سيحتاج الحساب إلى دفع الإيجار. ومع ذلك، تم
-إهمال آلية تحصيل الإيجار هذه منذ ذلك الحين.
+في الماضي، كان هذا الحقل يتتبع متى سيحتاج الحساب إلى دفع rent. ومع ذلك، تم إهمال
+آلية تحصيل الإيجار هذه منذ ذلك الحين.
 
 ```rust !! title="Account Examples"
 // Example Token Mint Account
@@ -344,38 +350,37 @@ Account {
 
 ## أنواع الحسابات
 
-هناك فئتان أساسيتان تندرج فيهما الحسابات:
+هناك فئتان أساسيتان تندرج تحتهما الحسابات:
 
 - [حسابات البرامج](#program-accounts): حسابات تحتوي على رمز قابل للتنفيذ
 - [حسابات البيانات](#data-accounts): حسابات لا تحتوي على رمز قابل للتنفيذ
 
-هذا الفصل يعني أن الرمز القابل للتنفيذ للبرنامج وحالته يتم تخزينهما في حسابات
-منفصلة. (مشابه لأنظمة التشغيل، التي عادة ما يكون لديها ملفات منفصلة للبرامج
-وبياناتها.)
+هذا الفصل بين رمز البرنامج وحالته هو ميزة أساسية في نموذج حسابات سولانا. (مشابه
+لأنظمة التشغيل، التي عادة ما تحتوي على ملفات منفصلة للبرامج وبياناتها.)
 
 ### حسابات البرامج
 
-كل برنامج مملوك من قبل [برنامج التحميل](/docs/core/programs#loader-programs)،
-الذي يستخدم لنشر وإدارة الحساب. عندما يتم نشر [برنامج](/docs/core/programs)
-جديد، يتم إنشاء حساب لتخزين رمزه [القابل للتنفيذ](#executable). يسمى هذا حساب
+كل برنامج مملوك من قبل [برنامج محمّل](/docs/core/programs#loader-programs)، الذي
+يُستخدم لنشر وإدارة الحساب. عندما يتم نشر [برنامج](/docs/core/programs) جديد،
+يتم إنشاء حساب لتخزين رمزه [القابل للتنفيذ](#executable). هذا ما يسمى بحساب
 البرنامج. (للتبسيط، يمكنك اعتبار حساب البرنامج هو البرنامج نفسه.)
 
-في الرسم البياني أدناه، يمكنك رؤية استخدام برنامج التحميل لنشر حساب برنامج.
-يحتوي حقل `data` الخاص بحساب البرنامج على رمز البرنامج القابل للتنفيذ.
+في الرسم البياني أدناه، يمكنك رؤية استخدام برنامج محمّل لنشر حساب برنامج. يحتوي
+حقل `data` الخاص بحساب البرنامج على رمز البرنامج القابل للتنفيذ.
 
-![رسم توضيحي لحساب برنامج، ومكوناته الأربعة وبرنامج التحميل الخاص به.](/assets/docs/core/accounts/program-account-simple.svg)
+![رسم توضيحي لحساب برنامج، ومكوناته الأربعة وبرنامج المحمّل الخاص به.](/assets/docs/core/accounts/program-account-simple.svg)
 
 #### حسابات بيانات البرامج
 
 البرامج المنشورة باستخدام loader-v3 لا تحتوي على رمز البرنامج في حقل `data`
-الخاص بها. بدلاً من ذلك، يشير حقل `data` إلى **حساب بيانات البرنامج** منفصل،
-والذي يحتوي على رمز البرنامج. (انظر الرسم البياني أدناه.)
+الخاص بها. بدلاً من ذلك، يشير حقل `data` إلى **حساب بيانات برنامج** منفصل، يحتوي
+على رمز البرنامج. (انظر الرسم البياني أدناه.)
 
 ![حساب برنامج مع بيانات. البيانات تشير إلى حساب بيانات برنامج منفصل](/assets/docs/core/accounts/program-account-expanded.svg)
 
 <Callout>
-  أثناء نشر البرنامج أو الترقيات، يتم استخدام حسابات المخزن المؤقت لتجهيز
-  التحميل مؤقتًا.
+  أثناء نشر البرنامج أو الترقيات، تُستخدم حسابات المخزن المؤقت لتجهيز التحميل
+  مؤقتًا.
 </Callout>
 
 المثال أدناه يجلب حساب Token Program. لاحظ أن حقل `executable` مضبوط على `true`،
@@ -452,7 +457,7 @@ async fn main() -> Result<()> {
 
 ### حسابات البيانات
 
-حسابات البيانات لا تحتوي على كود قابل للتنفيذ. بدلاً من ذلك، تقوم بتخزين
+لا تحتوي حسابات البيانات على رمز قابل للتنفيذ. بدلاً من ذلك، تقوم بتخزين
 المعلومات.
 
 #### حساب حالة البرنامج
@@ -465,7 +470,8 @@ async fn main() -> Result<()> {
 
 1. استدعاء [System Program](/docs/core/programs#the-system-program) لإنشاء حساب.
    (ثم ينقل System Program الملكية إلى البرنامج الجديد.)
-2. تهيئة بيانات الحساب، كما هو محدد في [تعليماته](/docs/core/instructions).
+2. تهيئة بيانات الحساب، كما هو محدد في [التعليمات](/docs/core/instructions)
+   الخاصة به.
 
 ![رسم تخطيطي لحساب بيانات مملوك من قبل حساب برنامج](/assets/docs/core/accounts/data-account.svg)
 
@@ -770,9 +776,9 @@ async fn main() -> Result<()> {
 عندما يتم إرسال SOL إلى عنوان جديد لأول مرة، يتم إنشاء حساب في ذلك العنوان مملوك
 من قبل System Program.
 
-في المثال أدناه، يتم إنشاء keypair جديد وتمويله بـ SOL. بعد تشغيل الكود، يمكنك
-رؤية أن عنوان `owner` للحساب هو `11111111111111111111111111111111` (وهو
-[System Program](/docs/core/programs#the-system-program)).
+في المثال أدناه، يتم إنشاء زوج مفاتيح جديد وتمويله بـ SOL. بعد تشغيل الكود،
+يمكنك رؤية أن عنوان مالك الحساب `owner` هو `11111111111111111111111111111111`
+(وهو [System Program](/docs/core/programs#the-system-program)).
 
 <CodeTabs storage="accounts" flags="r">
 
@@ -869,8 +875,8 @@ async fn main() -> Result<()> {
 
 #### حسابات Sysvar
 
-توجد حسابات Sysvar في عناوين محددة مسبقًا وتوفر وصولاً إلى بيانات حالة المجموعة.
-تتحدث ديناميكيًا مع بيانات حول مجموعة الشبكة. راجع القائمة الكاملة لـ
+توجد حسابات Sysvar في عناوين محددة مسبقًا وتوفر الوصول إلى بيانات حالة المجموعة.
+يتم تحديثها ديناميكيًا ببيانات حول مجموعة الشبكة. راجع القائمة الكاملة لـ
 [حسابات Sysvar](https://docs.anza.xyz/runtime/sysvars).
 
 المثال أدناه يجلب ويفك تشفير البيانات من حساب Sysvar Clock.