Merge branch 'main' into site-fixes

# Conflicts:
#	eslint.config.mjs
#	gator_versioned_docs/version-0.1.0/get-started/supported-networks.md
#	gator_versioned_docs/version-0.2.0/get-started/supported-networks.md
#	gator_versioned_docs/version-0.3.0/get-started/supported-networks.md
#	gator_versioned_docs/version-1.0.0/get-started/supported-networks.md
#	smart-accounts-kit/concepts/smart-accounts.md
#	smart-accounts-kit/get-started/smart-account-quickstart/eip7702.md
#	smart-accounts-kit/get-started/supported-advanced-permissions.md
#	smart-accounts-kit/get-started/supported-networks.md
#	smart-accounts-kit/get-started/use-scaffold-eth/smart-accounts.md
#	smart-accounts-kit/get-started/use-the-cli.md
#	smart-accounts-kit/guides/advanced-permissions/create-redelegation.md
#	smart-accounts-kit/guides/advanced-permissions/execute-on-metamask-users-behalf.md
#	smart-accounts-kit/guides/advanced-permissions/get-granted-permissions.md
#	smart-accounts-kit/guides/advanced-permissions/get-supported-permissions.md
#	smart-accounts-kit/guides/delegation/create-redelegation.md
#	smart-accounts-kit/guides/delegation/disable-delegation.md
#	smart-accounts-kit/guides/delegation/use-delegation-scopes/function-call.md
#	smart-accounts-kit/guides/delegation/use-delegation-scopes/spending-limit.md
#	smart-accounts-kit/guides/smart-accounts/deploy-smart-account.md
#	smart-accounts-kit/guides/smart-accounts/generate-multisig-signature.md
#	smart-accounts-kit/guides/smart-accounts/signers/passkey.md
#	smart-accounts-kit/reference/advanced-permissions/wallet-client.md
#	smart-accounts-kit/reference/delegation/caveats.md
#	smart-accounts-kit/reference/delegation/delegation-scopes.md
#	smart-accounts-kit/reference/delegation/index.md
#	smart-accounts-kit/reference/erc7710/bundler-client.md
#	smart-accounts-kit/reference/erc7710/wallet-client.md
#	smart-accounts-kit/reference/smart-account.md
#	smart-accounts-kit/reference/types.md
#	smart-accounts-kit/troubleshooting/error-codes.md
#	smart-accounts-kit/troubleshooting/invalid-delegate.md
#	smart-accounts-kit/troubleshooting/invalid-delegator.md

Author: alexandratran

.cursor/rules/product-smart-accounts-kit.mdc

@@ -1,6 +1,12 @@
 ---
-description: Product-specific guidance for Smart Accounts Kit documentation, including terminology, delegation concepts, and versioning.
-globs: ["smart-accounts-kit/**/*.md", "smart-accounts-kit/**/*.mdx"]
+description: Product-specific guidance for Smart Accounts Kit documentation, including terminology, delegation concepts, glossary/tooltips, and versioning.
+globs:
+  [
+    'smart-accounts-kit/**/*.md',
+    'smart-accounts-kit/**/*.mdx',
+    'src/lib/glossary.json',
+    'scripts/generate-smart-accounts-glossary.js',
+  ]
 alwaysApply: false
 ---
 
@@ -31,13 +37,13 @@ Smart Accounts Kit has three pillars. Use these terms consistently:
 
 ## Content organization
 
-| Folder              | Content type                                    |
-|---------------------|-------------------------------------------------|
-| `concepts/`         | Explanation (smart accounts, delegation, permissions) |
-| `get-started/`      | Quickstart and setup (install, CLI, supported networks) |
-| `guides/`           | How-to (create/deploy accounts, send ops, delegate) |
-| `reference/`        | API reference (methods, types, parameters)       |
-| `troubleshooting/`  | Problem/solution (error codes, common issues)    |
+| Folder             | Content type                                            |
+| ------------------ | ------------------------------------------------------- |
+| `concepts/`        | Explanation (smart accounts, delegation, permissions)   |
+| `get-started/`     | Quickstart and setup (install, CLI, supported networks) |
+| `guides/`          | How-to (create/deploy accounts, send ops, delegate)     |
+| `reference/`       | API reference (methods, types, parameters)              |
+| `troubleshooting/` | Problem/solution (error codes, common issues)           |
 
 ## Reference conventions
 
@@ -47,6 +53,26 @@ Smart Accounts Kit has three pillars. Use these terms consistently:
   multi-file examples.
 - Types and enums link to `reference/types.md`.
 
+## Glossary and tooltips
+
+### Glossary page (`reference/glossary.mdx`)
+
+- **Source of truth:** Add or update definitions in [`src/lib/glossary.json`](src/lib/glossary.json). Each entry needs a `term` string and a `definition` string.
+- **Generated file:** [`smart-accounts-kit/reference/glossary.mdx`](smart-accounts-kit/reference/glossary.mdx) is **auto-generated**. Do not edit it by hand.
+- **Regeneration:** Run `npm run glossary:generate`, or use `npm start` / `npm run build` (both run the glossary script first). The generator is [`scripts/generate-smart-accounts-glossary.js`](scripts/generate-smart-accounts-glossary.js).
+
+The `term` string in each glossary entry must match exactly what you pass to the `term` prop on `GlossaryTerm` (see below).
+
+### Inline tooltips (`GlossaryTerm`)
+
+- Import the theme component: `import GlossaryTerm from '@theme/GlossaryTerm';`
+- Wrap visible text and set `term` to the matching glossary `term` string, for example:
+  `<GlossaryTerm term="User operation">user operations</GlossaryTerm>` or
+  `<GlossaryTerm term="MetaMask smart account" />` when the displayed label matches the glossary term.
+- Example page: [`smart-accounts-kit/get-started/smart-account-quickstart/index.md`](smart-accounts-kit/get-started/smart-account-quickstart/index.md).
+
+There is no strict rule for when to add tooltips. In practice, use them when a term appears for the first time in a documentation section and readers benefit from a short definition, but the term does **not** warrant linking out to a full concept or guide page. Tooltips add context without the extra step of opening another page.
+
 ## Versioning
 
 Smart Accounts Kit uses Docusaurus versioning. The current development version is at path

eslint.config.mjs

@@ -21,6 +21,7 @@ export default [
       'node_modules/*',
       '.docusaurus/*',
       '.integrationBuilderCache/*',
+      'scripts/*.js',
       '**/*.md',
       '**/*.mdx',
       'static/*',

gator-sidebar.js

@@ -199,6 +199,11 @@ const sidebar = {
           items: ['reference/erc7710/bundler-client', 'reference/erc7710/wallet-client'],
         },
         'reference/types',
+        {
+          type: 'doc',
+          id: 'reference/glossary',
+          label: 'Glossary',
+        },
       ],
     },
     {

gator_versioned_docs/version-0.1.0/get-started/supported-networks.md

@@ -64,8 +64,10 @@ If you don't see the network you're looking for, you can request support by emai
 | Binance Smart Chain | ✅     |
 | Ethereum            | ✅     |
 | Gnosis              | ✅     |
+| Linea               | ✅     |
 | Optimism            | ✅     |
 | Polygon             | ✅     |
+| Sei                 | ✅     |
 | Sonic               | ✅     |
 | Unichain            | ✅     |
 
@@ -80,9 +82,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Chiado              | ✅     |
 | Citrea              | ✅     |
 | Hoodi               | ✅     |
+| Linea Sepolia       | ✅     |
 | MegaEth             | ✅     |
 | Optimism Sepolia    | ✅     |
 | Polygon Amoy        | ✅     |
+| Sei                 | ✅     |
 | Sepolia             | ✅     |
 | Sonic               | ✅     |
 | Unichain Sepolia    | ✅     |

gator_versioned_docs/version-0.2.0/get-started/supported-networks.md

@@ -67,9 +67,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Citrea              | ✅     | ✅     |
 | Ethereum            | ✅     | ✅     |
 | Gnosis              | ✅     | ✅     |
+| Linea               | ✅     | ✅     |
 | Monad               | ✅     | ✅     |
 | Optimism            | ✅     | ✅     |
 | Polygon             | ✅     | ✅     |
+| Sei                 | ✅     | ✅     |
 | Sonic               | ✅     | ✅     |
 | Unichain            | ✅     | ✅     |
 
@@ -84,9 +86,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Chiado              | ✅     | ✅     |
 | Citrea              | ✅     | ✅     |
 | Hoodi               | ✅     | ✅     |
+| Linea Sepolia       | ✅     | ✅     |
 | MegaEth             | ✅     | ✅     |
 | Optimism Sepolia    | ✅     | ✅     |
 | Polygon Amoy        | ✅     | ✅     |
+| Sei                 | ✅     | ✅     |
 | Sepolia             | ✅     | ✅     |
 | Sonic               | ✅     | ✅     |
 | Unichain Sepolia    | ✅     | ✅     |

gator_versioned_docs/version-0.3.0/get-started/supported-networks.md

@@ -67,9 +67,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Citrea              | ✅     | ✅     | ✅     |
 | Ethereum            | ✅     | ✅     | ✅     |
 | Gnosis              | ✅     | ✅     | ✅     |
+| Linea               | ✅     | ✅     | ✅     |
 | Monad               | ✅     | ✅     | ✅     |
 | Optimism            | ✅     | ✅     | ✅     |
 | Polygon             | ✅     | ✅     | ✅     |
+| Sei                 | ✅     | ✅     | ✅     |
 | Sonic               | ✅     | ✅     | ✅     |
 | Unichain            | ✅     | ✅     | ✅     |
 
@@ -84,9 +86,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Chiado              | ✅     | ✅     | ✅     |
 | Citrea              | ✅     | ✅     | ✅     |
 | Hoodi               | ✅     | ✅     | ✅     |
+| Linea Sepolia       | ✅     | ✅     | ✅     |
 | MegaEth             | ✅     | ✅     | ✅     |
 | Optimism Sepolia    | ✅     | ✅     | ✅     |
 | Polygon Amoy        | ✅     | ✅     | ✅     |
+| Sei                 | ✅     | ✅     | ✅     |
 | Sepolia             | ✅     | ✅     | ✅     |
 | Sonic               | ✅     | ✅     | ✅     |
 | Unichain Sepolia    | ✅     | ✅     | ✅     |

gator_versioned_docs/version-1.0.0/get-started/supported-networks.md

@@ -75,9 +75,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Citrea              | ✅     | ✅     | ✅     | ✅     |
 | Ethereum            | ✅     | ✅     | ✅     | ✅     |
 | Gnosis              | ✅     | ✅     | ✅     | ✅     |
+| Linea               | ✅     | ✅     | ✅     | ✅     |
 | Monad               | ✅     | ✅     | ✅     | ✅     |
 | Optimism            | ✅     | ✅     | ✅     | ✅     |
 | Polygon             | ✅     | ✅     | ✅     | ✅     |
+| Sei                 | ✅     | ✅     | ✅     | ✅     |
 | Sonic               | ✅     | ✅     | ✅     | ✅     |
 | Unichain            | ✅     | ✅     | ✅     | ✅     |
 
@@ -92,9 +94,11 @@ If you don't see the network you're looking for, you can request support by emai
 | Chiado              | ✅     | ✅     | ✅     | ✅     |
 | Citrea              | ✅     | ✅     | ✅     | ✅     |
 | Hoodi               | ✅     | ✅     | ✅     | ✅     |
+| Linea Sepolia       | ✅     | ✅     | ✅     | ✅     |
 | MegaETH             | ✅     | ✅     | ✅     | ✅     |
 | Optimism Sepolia    | ✅     | ✅     | ✅     | ✅     |
 | Polygon Amoy        | ✅     | ✅     | ✅     | ✅     |
+| Sei                 | ✅     | ✅     | ✅     | ✅     |
 | Sepolia             | ✅     | ✅     | ✅     | ✅     |
 | Sonic               | ✅     | ✅     | ✅     | ✅     |
 | Unichain Sepolia    | ✅     | ✅     | ✅     | ✅     |

package-lock.json

@@ -5,8 +5,9 @@
   "license": "(MIT OR Apache-2.0)",
   "scripts": {
     "docusaurus": "docusaurus",
-    "start": "docusaurus snaps:generate && docusaurus start -p 3003",
-    "build": "docusaurus snaps:generate && docusaurus build",
+    "start": "npm run glossary:generate && docusaurus snaps:generate && docusaurus start -p 3003",
+    "build": "npm run glossary:generate && docusaurus snaps:generate && docusaurus build",
+    "glossary:generate": "node ./scripts/generate-smart-accounts-glossary.js",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",
     "clear": "docusaurus clear",

package.json

@@ -0,0 +1,55 @@
+const fs = require('fs')
+const path = require('path')
+
+const rootDir = path.resolve(__dirname, '..')
+const glossaryJsonPath = path.join(rootDir, 'src/lib/glossary.json')
+const glossaryMdxPath = path.join(rootDir, 'smart-accounts-kit/reference/glossary.mdx')
+
+function loadGlossaryTerms() {
+  const raw = fs.readFileSync(glossaryJsonPath, 'utf8')
+  const data = JSON.parse(raw)
+
+  if (!data || !Array.isArray(data.terms)) {
+    throw new Error('Invalid glossary JSON: expected a top-level "terms" array.')
+  }
+
+  return [...data.terms]
+    .filter(term => term && typeof term.term === 'string' && typeof term.definition === 'string')
+    .sort((a, b) => a.term.localeCompare(b.term))
+}
+
+function buildGlossaryMdx(terms) {
+  const lines = [
+    '---',
+    'description: Glossary of terms used across Smart Accounts Kit documentation.',
+    'title: Glossary',
+    'keywords: [glossary, smart accounts kit, delegation, advanced permissions, terms]',
+    '---',
+    '',
+    'This glossary defines common Smart Accounts Kit terms used across the documentation.',
+    '',
+    '<!-- AUTO-GENERATED by scripts/generate-smart-accounts-glossary.js. -->',
+    '<!-- Edit src/lib/glossary.json and run npm run glossary:generate. -->',
+    '',
+  ]
+
+  terms.forEach(({ term, definition }) => {
+    lines.push(`### ${term}`)
+    lines.push('')
+    lines.push(definition.trim())
+    lines.push('')
+  })
+
+  return `${lines.join('\n')}\n`
+}
+
+function main() {
+  const terms = loadGlossaryTerms()
+  const mdx = buildGlossaryMdx(terms)
+  fs.writeFileSync(glossaryMdxPath, mdx, 'utf8')
+  console.log(
+    `Generated ${path.relative(rootDir, glossaryMdxPath)} from ${path.relative(rootDir, glossaryJsonPath)} (${terms.length} terms).`
+  )
+}
+
+main()