@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/registry/layers/capability/banking-baas/files/banking-config.json

@@ -0,0 +1,25 @@
+{
+  "provider": "{{bankingProvider}}",
+  "providers": {
+    "unit": {
+      "baseUrl": "https://api.unit.co",
+      "sandboxUrl": "https://api.s.unit.sh",
+      "apiKeyEnv": "UNIT_API_KEY",
+      "docs": "https://docs.unit.co",
+      "supports": ["account_opening", "ach", "card_issuance", "fbo", "business_accounts"]
+    },
+    "column": {
+      "baseUrl": "https://api.column.com",
+      "apiKeyEnv": "COLUMN_API_KEY",
+      "docs": "https://column.com/docs",
+      "supports": ["account_opening", "ach", "wire", "fbo", "program_banking"]
+    },
+    "mercury": {
+      "baseUrl": "https://api.mercury.com/api/v1",
+      "apiKeyEnv": "MERCURY_API_TOKEN",
+      "docs": "https://api.mercury.com/api/v1/docs",
+      "supports": ["read_accounts", "read_transactions", "send_ach"],
+      "note": "Mercury's API automates YOUR Mercury accounts — it's not a BaaS for issuing accounts to your users."
+    }
+  }
+}

package/registry/layers/capability/banking-baas/files/banking.ts

@@ -0,0 +1,125 @@
+// Provider-neutral banking client. Pick one provider at config time; the
+// method surface is the same. Each concrete implementation is a thin wrapper
+// over the provider's REST API — extend freely.
+
+import { z } from 'zod'
+import config from '../banking-config.json'
+
+type Provider = 'unit' | 'column' | 'mercury'
+const provider = config.provider as Provider
+const providerConfig = (config.providers as Record<Provider, { baseUrl: string; apiKeyEnv: string }>)[provider]
+
+const Account = z.object({
+  id: z.string(),
+  name: z.string(),
+  balanceCents: z.number(),
+  routingNumber: z.string().optional(),
+  accountNumber: z.string().optional(),
+})
+
+const Transfer = z.object({
+  id: z.string(),
+  amountCents: z.number(),
+  status: z.enum(['pending', 'sent', 'rejected', 'returned']),
+  createdAt: z.string(),
+})
+
+function apiKey(): string {
+  const key = process.env[providerConfig.apiKeyEnv]
+  if (!key) throw new Error(`Banking provider ${provider}: ${providerConfig.apiKeyEnv} is not set`)
+  return key
+}
+
+async function request(path: string, init?: RequestInit): Promise<unknown> {
+  const res = await fetch(`${providerConfig.baseUrl}${path}`, {
+    ...init,
+    headers: {
+      'content-type': 'application/json',
+      authorization: `Bearer ${apiKey()}`,
+      ...(init?.headers ?? {}),
+    },
+  })
+  if (!res.ok) {
+    throw new Error(`${provider} API ${init?.method ?? 'GET'} ${path}: ${res.status} ${await res.text()}`)
+  }
+  return res.json()
+}
+
+/** List accounts owned by the authenticated application. */
+export async function listAccounts(): Promise<z.infer<typeof Account>[]> {
+  switch (provider) {
+    case 'unit': {
+      const body = (await request('/accounts')) as { data: Array<{ id: string; attributes: Record<string, unknown> }> }
+      return body.data.map((a) => Account.parse({
+        id: a.id,
+        name: String(a.attributes['name'] ?? ''),
+        balanceCents: Number(a.attributes['balance'] ?? 0),
+        routingNumber: a.attributes['routingNumber'] as string | undefined,
+        accountNumber: a.attributes['accountNumber'] as string | undefined,
+      }))
+    }
+    case 'column': {
+      const body = (await request('/bank-accounts')) as { bank_accounts: Array<Record<string, unknown>> }
+      return body.bank_accounts.map((a) => Account.parse({
+        id: String(a['id']),
+        name: String(a['description'] ?? ''),
+        balanceCents: Number(a['available_amount'] ?? 0),
+        routingNumber: a['routing_number'] as string | undefined,
+        accountNumber: a['account_number'] as string | undefined,
+      }))
+    }
+    case 'mercury': {
+      const body = (await request('/accounts')) as { accounts: Array<Record<string, unknown>> }
+      return body.accounts.map((a) => Account.parse({
+        id: String(a['id']),
+        name: String(a['name'] ?? ''),
+        balanceCents: Math.round(Number(a['availableBalance'] ?? 0) * 100),
+        routingNumber: a['routingNumber'] as string | undefined,
+        accountNumber: a['accountNumber'] as string | undefined,
+      }))
+    }
+  }
+}
+
+/** Initiate an ACH transfer out of an account. Amount in cents. */
+export async function sendACH(params: {
+  fromAccountId: string
+  amountCents: number
+  recipientRoutingNumber: string
+  recipientAccountNumber: string
+  recipientName: string
+  memo?: string
+}): Promise<z.infer<typeof Transfer>> {
+  switch (provider) {
+    case 'unit':
+    case 'column': {
+      // Simplified — real payloads differ per provider; use the docs for full schemas.
+      const body = (await request(`/ach-transfers`, {
+        method: 'POST',
+        body: JSON.stringify({ ...params }),
+      })) as Record<string, unknown>
+      return Transfer.parse({
+        id: String(body['id'] ?? ''),
+        amountCents: params.amountCents,
+        status: 'pending',
+        createdAt: new Date().toISOString(),
+      })
+    }
+    case 'mercury': {
+      const body = (await request(`/account/${params.fromAccountId}/transactions`, {
+        method: 'POST',
+        body: JSON.stringify({
+          amount: params.amountCents / 100,
+          recipientId: `${params.recipientRoutingNumber}-${params.recipientAccountNumber}`,
+          note: params.memo,
+        }),
+      })) as Record<string, unknown>
+      return Transfer.parse({
+        id: String(body['id'] ?? ''),
+        amountCents: params.amountCents,
+        status: 'pending',
+        createdAt: new Date().toISOString(),
+      })
+    }
+  }
+}

package/registry/layers/capability/banking-baas/manifest.json

@@ -0,0 +1,59 @@
+{
+  "id": "banking-baas",
+  "description": "Banking-as-a-Service integration — account opening, ACH transfers, card issuance, ledger management. Ships provider-neutral wrappers for Unit, Column, and Mercury with runtime provider selection. For neobanks, expense-management apps, savings apps, business banking dashboards, compliance-heavy fintech.",
+  "appliesTo": [
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "bun-http",
+    "deno-edge"
+  ],
+  "defaults": {
+    "bankingProvider": "unit"
+  },
+  "files": [
+    {
+      "source": "files/banking-config.json",
+      "target": "banking-config.json"
+    },
+    {
+      "source": "files/banking.ts",
+      "target": "lib/banking.ts"
+    }
+  ],
+  "packageDeps": {
+    "dependencies": {
+      "zod": "^3.23.0"
+    }
+  },
+  "keywords": [
+    "unit banking",
+    "unit.co",
+    "column banking",
+    "column.com",
+    "mercury api",
+    "mercury banking",
+    "banking as a service",
+    "baas",
+    "neobank",
+    "open bank account",
+    "ach transfer",
+    "issue debit card",
+    "business banking",
+    "ledger api",
+    "expense management"
+  ],
+  "buildHints": {
+    "whenToUse": "Attach for products that move real money via US banking rails — neobanks, expense-management, savings, business banking, any US consumer/business fintech. For crypto-only payments use saas-billing + a crypto wallet capability instead.",
+    "firstSteps": [
+      "Pick a provider in banking-config.json (unit | column | mercury)",
+      "Set the provider's API key in env (UNIT_API_KEY | COLUMN_API_KEY | MERCURY_API_TOKEN)",
+      "Use the bankingClient from lib/banking.ts — provider-neutral method surface (openAccount, transfer, issueCard)"
+    ],
+    "gotchas": [
+      "KYC/KYB obligations differ per provider. Unit: you handle KYC docs. Column: bank-direct partnership. Mercury: API is for existing Mercury customers to automate their own accounts, NOT for issuing accounts to YOUR users.",
+      "ACH same-day vs standard — same-day has cutoff times (~2pm ET); plan UX around it",
+      "FBO (For Benefit Of) vs direct-issue: Unit + Column support FBO accounts; Mercury does not"
+    ]
+  }
+}

package/registry/layers/capability/chart-widget/manifest.json

@@ -1,7 +1,12 @@
 {
   "id": "chart-widget",
   "description": "Dashboard chart components (metric cards + recharts line/bar/area) with mock starter data.",
-  "appliesTo": ["frontend-static", "react-vite-ts", "nextjs-ts", "fullstack-ts"],
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts"
+  ],
   "files": [
     {
       "source": "files/starter-data.json",
@@ -17,7 +22,68 @@
     }
   ],
   "buildHints": {
-    "dependencies": ["recharts"],
-    "notes": "MetricCard is standalone (shadcn Card + lucide icons). SimpleChart requires recharts as a peer dependency. Both components use Tailwind CSS variables (--chart-1 through --chart-5) for theming."
+    "architectureNotes": [
+      "dependencies: recharts",
+      "notes: MetricCard is standalone (shadcn Card + lucide icons). SimpleChart requires recharts as a peer dependency. Both components use Tailwind CSS variables (--chart-1 through --chart-5) for theming."
+    ]
+  },
+  "packageDeps": {
+    "dependencies": {
+      "recharts": "^2.15.0"
+    }
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "gantt",
+      "burndown",
+      "kpi",
+      "analytics",
+      "metrics",
+      "churn",
+      "sentiment analysis",
+      "sentiment patterns",
+      "sentiment over time",
+      "see trends",
+      "shows sentiment",
+      "price changes",
+      "price tracking",
+      "tracks price",
+      "tracks floor",
+      "tracks mentions",
+      "tracks what performs",
+      "compensation trends",
+      "salary ranges",
+      "portfolio tracker",
+      "portfolio value",
+      "floor prices",
+      "valuation",
+      "sales reporting",
+      "auto-generates esg",
+      "sustainability reports",
+      "status reports",
+      "yield farming",
+      "apys across",
+      "competitive pricing",
+      "competitor websites",
+      "listing aggregator",
+      "auto-compound",
+      "neighborhood trends",
+      "comparable sales",
+      "deals below market",
+      "churn metrics",
+      "nps tracking",
+      "low-stock alerts",
+      "categorizes spending",
+      "savings tips",
+      "payment tracking",
+      "track what's paid",
+      "coaching opportunities",
+      "see stats",
+      "see metrics",
+      "dashboard to see",
+      "performance tracking",
+      "p&l",
+      "revenue metrics"
+    ]
   }
 }

package/registry/layers/capability/code-editor/files/code-editor.tsx

@@ -0,0 +1,82 @@
+// CodeMirror 6 editor component. Thin wrapper over the imperative CM6 API —
+// drop in and control value via props. Defaults to JavaScript + one-dark.
+
+import { useEffect, useRef } from 'react'
+import { EditorView, keymap, lineNumbers } from '@codemirror/view'
+import { EditorState } from '@codemirror/state'
+import { javascript } from '@codemirror/lang-javascript'
+import { json } from '@codemirror/lang-json'
+import { oneDark } from '@codemirror/theme-one-dark'
+import { defaultKeymap, history, historyKeymap } from '@codemirror/commands'
+import { autocompletion, closeBrackets } from '@codemirror/autocomplete'
+
+type Language = 'javascript' | 'typescript' | 'json'
+
+export interface CodeEditorProps {
+  value: string
+  onChange?: (value: string) => void
+  language?: Language
+  readOnly?: boolean
+  className?: string
+}
+
+function languageExtension(lang: Language) {
+  switch (lang) {
+    case 'json':
+      return json()
+    case 'typescript':
+      return javascript({ typescript: true })
+    default:
+      return javascript()
+  }
+}
+
+export function CodeEditor({
+  value,
+  onChange,
+  language = 'javascript',
+  readOnly = false,
+  className,
+}: CodeEditorProps) {
+  const host = useRef<HTMLDivElement>(null)
+  const view = useRef<EditorView | null>(null)
+
+  useEffect(() => {
+    if (!host.current) return
+    const state = EditorState.create({
+      doc: value,
+      extensions: [
+        lineNumbers(),
+        history(),
+        closeBrackets(),
+        autocompletion(),
+        keymap.of([...defaultKeymap, ...historyKeymap]),
+        languageExtension(language),
+        oneDark,
+        EditorState.readOnly.of(readOnly),
+        EditorView.updateListener.of((update) => {
+          if (update.docChanged && onChange) {
+            onChange(update.state.doc.toString())
+          }
+        }),
+      ],
+    })
+    view.current = new EditorView({ state, parent: host.current })
+    return () => view.current?.destroy()
+    // Recreate the view only when language/readOnly change; value is handled below.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [language, readOnly])
+
+  useEffect(() => {
+    const current = view.current
+    if (!current) return
+    const docText = current.state.doc.toString()
+    if (docText !== value) {
+      current.dispatch({
+        changes: { from: 0, to: docText.length, insert: value },
+      })
+    }
+  }, [value])
+
+  return <div ref={host} className={className} />
+}

package/registry/layers/capability/code-editor/manifest.json

@@ -0,0 +1,90 @@
+{
+  "id": "code-editor",
+  "description": "Browser code editor using CodeMirror 6 — syntax highlighting, theming, line numbers, autocomplete. For AI coding assistants, markdown editors, configuration UIs, playgrounds, query builders.",
+  "appliesTo": [
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "remix-ts",
+    "sveltekit-ts",
+    "vue-ts"
+  ],
+  "files": [
+    {
+      "source": "files/code-editor.tsx",
+      "target": "src/components/code-editor.tsx"
+    }
+  ],
+  "packageDeps": {
+    "dependencies": {
+      "codemirror": "^6.0.1",
+      "@codemirror/view": "^6.0.0",
+      "@codemirror/state": "^6.0.0",
+      "@codemirror/lang-javascript": "^6.0.0",
+      "@codemirror/lang-json": "^6.0.0",
+      "@codemirror/theme-one-dark": "^6.0.0",
+      "@codemirror/commands": "^6.0.0",
+      "@codemirror/autocomplete": "^6.0.0"
+    }
+  },
+  "keywords": [
+    "code editor",
+    "codemirror",
+    "monaco",
+    "syntax highlight",
+    "query editor",
+    "playground editor",
+    "markdown editor with code"
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/components/code-editor.tsx"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Attach when the product surface exposes a code/query/markup editor — AI code assistants, prompt playgrounds, markdown editors with syntax-highlighted code blocks, SQL query builders, config editors.",
+    "firstSteps": [
+      "Import CodeEditor from '@/components/code-editor'",
+      "Pass `value`, `onChange`, and optionally a `language` ('javascript' | 'json' | 'typescript')"
+    ]
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "code editor",
+      "query editor",
+      "sql editor",
+      "prompt playground",
+      "code playground",
+      "syntax highlight",
+      "syntax highlighting",
+      "markdown editor",
+      "config editor",
+      "schema editor",
+      "json editor",
+      "javascript editor",
+      "typescript editor",
+      "codemirror",
+      "code dashboard",
+      "strategy editor",
+      "\"strategy\" editor",
+      "strategy builder",
+      "script editor",
+      "rules editor",
+      "dsl editor",
+      "embedded editor",
+      "policy editor",
+      "workflow editor",
+      "expression editor",
+      "typescript snippet",
+      "typescript snippet editor",
+      "algorithm editor",
+      "algo editor",
+      "algorithm playground",
+      "trading strategy",
+      "on-chain strategy",
+      "inline editor",
+      "code snippet editor",
+      "live editor"
+    ]
+  }
+}

package/registry/layers/capability/date-utils/manifest.json

@@ -0,0 +1,64 @@
+{
+  "id": "date-utils",
+  "description": "date-fns for date parsing, formatting, arithmetic, and relative time. Tree-shakeable, locale-ready. For any product that displays, schedules, or reasons about dates.",
+  "appliesTo": [
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "remix-ts",
+    "sveltekit-ts",
+    "vue-ts",
+    "api-service",
+    "cloudflare-worker-ts",
+    "bun-http",
+    "deno-edge"
+  ],
+  "files": [],
+  "packageDeps": {
+    "dependencies": {
+      "date-fns": "^4.1.0"
+    }
+  },
+  "keywords": [
+    "date formatting",
+    "relative time",
+    "scheduling",
+    "calendar",
+    "timestamp",
+    "date picker",
+    "date range"
+  ],
+  "buildHints": {
+    "whenToUse": "Attach when the product renders, schedules, or reasons about dates. Import from 'date-fns' \u2014 the tree-shakeable per-function API keeps bundle size down.",
+    "firstSteps": [
+      "import { format, formatDistanceToNow, addDays } from 'date-fns'",
+      "Pick locale on demand via 'date-fns/locale/en-US' (etc.) for i18n"
+    ]
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "calendar",
+      "scheduling",
+      "booking",
+      "appointment",
+      "timeline",
+      "deadline",
+      "date range",
+      "date picker",
+      "recurring event",
+      "relative time",
+      "event scheduler",
+      "reminders",
+      "due date",
+      "time tracking",
+      "dao",
+      "governance",
+      "proposal",
+      "voting period",
+      "quorum",
+      "governor bravo",
+      "on-chain governance",
+      "snapshot vote"
+    ]
+  }
+}

package/registry/layers/capability/evm-nft-mint-page/files/evm-nft-mint.md

@@ -0,0 +1,21 @@
+The EVM NFT mint page component is a versatile tool designed for use in various TypeScript-based frameworks, including react-vite-ts, nextjs-ts, and fullstack-ts. This component streamlines the process of minting NFTs on the Ethereum Virtual Machine (EVM) by integrating wallet connection, a mint button, a display for the number of minted NFTs, and a link to OpenSea for easy marketplace access. The contract address is dynamically read from environment variables, making it adaptable to different deployment scenarios.
+
+### When to Use
+- **NFT Marketplaces:** For creating platforms where users can mint their own NFTs.
+- **Digital Art Platforms:** To enable artists to create and sell unique digital artworks.
+- **Gaming Platforms:** For in-game item creation and trading.
+
+### Extension Points
+- **Customizable UI:** Modify the component's UI to fit your application's design language.
+- **Multi-Chain Support:** Extend the component to support minting on other blockchain platforms beyond EVM.
+- **Integration with AI Capabilities:** Combine with peer capabilities like agent-intel for AI-powered NFT analysis or ai-chat-ui for AI-driven NFT creation tools.
+
+### Gotchas
+- **Security:** Ensure that the wallet connection and minting process are secure to prevent fraud and theft.
+- **Gas Fees:** Be mindful of gas fees associated with minting NFTs on the EVM and consider optimizations or alternatives to minimize costs.
+- **Contract Address Management:** Properly manage and secure the contract address stored in environment variables to avoid unauthorized access or changes.
+
+### Peer Capabilities Integration
+- **Agent-Intel Integration:** Use agent-intel to analyze NFT market trends or to extract information from NFT metadata.
+- **AI-Agent-Dashboard Integration:** Integrate with ai-agent-dashboard to monitor and manage AI agents involved in NFT creation or trading processes.
+- **AI-Chat-UI Integration:** Combine with ai-chat-ui to create an interactive chat interface for NFT-related inquiries or transactions.

package/registry/layers/capability/evm-nft-mint-page/files/src/components/MintPage.tsx

@@ -0,0 +1,38 @@
+import React, { useState, useEffect } from 'react';
+import { useWallet } from '@binance-chain/bsc-use-wallet';
+import { Link } from 'react-router-dom';
+import { MintButton } from './MintButton';
+import { MintedCountDisplay } from './MintedCountDisplay';
+import { OpenSeaLink } from './OpenSeaLink';
+
+const MintPage = () => {
+  const [mintedCount, setMintedCount] = useState(0);
+  const wallet = useWallet();
+  const contractAddress = process.env.CONTRACT_ADDRESS;
+
+  useEffect(() => {
+    const fetchMintedCount = async () => {
+      // fetch minted count from contract
+      const response = await fetch(`https://api.${contractAddress}.com/minted-count`);
+      const data = await response.json();
+      setMintedCount(data.count);
+    };
+    fetchMintedCount();
+  }, [contractAddress]);
+
+  const handleMint = async () => {
+    // mint NFT logic
+  };
+
+  return (
+    <div>
+      <h1>Mint Page</h1>
+      <MintButton onMint={handleMint} />
+      <MintedCountDisplay count={mintedCount} />
+      <OpenSeaLink contractAddress={contractAddress} />
+      {wallet.account && <p>Connected to {wallet.account}</p>}
+    </div>
+  );
+};
+
+export default MintPage;

package/registry/layers/capability/evm-nft-mint-page/files/src/mint-page-config.json

@@ -0,0 +1 @@
+{"contractAddress": "0x...", "openseaLink": "https://opensea.io/", "mintButtonLabel": "Mint NFT", "mintedCountLabel": "Minted Count: "}

package/registry/layers/capability/evm-nft-mint-page/manifest.json

@@ -0,0 +1,75 @@
+{
+  "id": "evm-nft-mint-page",
+  "description": "EVM NFT mint page component — wallet connect + mint button + minted-count display + OpenSea link. Reads contract address from env.",
+  "appliesTo": [
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts"
+  ],
+  "defaults": {
+    "contractAddress": "0x...",
+    "walletProvider": "MetaMask",
+    "openSeaApiKey": "YOUR_API_KEY"
+  },
+  "files": [
+    {
+      "source": "files/src/mint-page-config.json",
+      "target": "src/mint-page-config.json"
+    },
+    {
+      "source": "files/src/components/MintPage.tsx",
+      "target": "src/components/MintPage.tsx"
+    },
+    {
+      "source": "files/evm-nft-mint.md",
+      "target": "evm-nft-mint.md"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "wallet connection customization",
+      "mint button configuration",
+      "OpenSea link modification",
+      "contract address injection"
+    ]
+  },
+  "capabilityRequires": [
+    "wallet integration",
+    "smart contract deployment",
+    "OpenSea API access",
+    "environment variable configuration"
+  ],
+  "keywords": [
+    "EVM",
+    "NFT",
+    "minting",
+    "wallet",
+    "OpenSea",
+    "blockchain",
+    "React",
+    "Vite",
+    "Next.js",
+    "TypeScript",
+    "fullstack development"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "EVM",
+      "NFT",
+      "minting",
+      "wallet",
+      "OpenSea"
+    ],
+    "tier2": [
+      "blockchain",
+      "React",
+      "Vite",
+      "Next.js",
+      "TypeScript",
+      "fullstack development"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "When building blockchain-based applications that require a user-friendly interface for minting NFTs, especially in scenarios where users need to connect their wallets and track minted counts."
+  }
+}