@tangle-network/starter-foundry 0.1.0

package/registry/layers/capability/crypto-swap-ui/files/token-select-dialog.tsx

@@ -0,0 +1,104 @@
+'use client'
+
+import { useState } from 'react'
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog'
+import { Input } from '@/components/ui/input'
+import { Badge } from '@/components/ui/badge'
+import { ScrollArea } from '@/components/ui/scroll-area'
+import { Search } from 'lucide-react'
+
+export interface Token {
+  symbol: string
+  name: string
+  balance: string
+  color: string
+}
+
+const POPULAR = ['ETH', 'USDC', 'USDT', 'WBTC']
+
+const TOKENS: Token[] = [
+  { symbol: 'ETH', name: 'Ethereum', balance: '1.234', color: '#627EEA' },
+  { symbol: 'USDC', name: 'USD Coin', balance: '500.00', color: '#2775CA' },
+  { symbol: 'USDT', name: 'Tether', balance: '250.00', color: '#26A17B' },
+  { symbol: 'WBTC', name: 'Wrapped Bitcoin', balance: '0.05', color: '#F7931A' },
+  { symbol: 'DAI', name: 'Dai', balance: '100.00', color: '#F5AC37' },
+  { symbol: 'LINK', name: 'Chainlink', balance: '25.0', color: '#2A5ADA' },
+]
+
+interface TokenSelectDialogProps {
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  onSelect: (token: Token) => void
+}
+
+export function TokenSelectDialog({ open, onOpenChange, onSelect }: TokenSelectDialogProps) {
+  const [query, setQuery] = useState('')
+
+  const filtered = TOKENS.filter(
+    (t) =>
+      t.symbol.toLowerCase().includes(query.toLowerCase()) ||
+      t.name.toLowerCase().includes(query.toLowerCase())
+  )
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="max-w-sm">
+        <DialogHeader>
+          <DialogTitle>Select Token</DialogTitle>
+        </DialogHeader>
+        <div className="relative">
+          <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" />
+          <Input
+            placeholder="Search by name or symbol"
+            value={query}
+            onChange={(e) => setQuery(e.target.value)}
+            className="pl-9"
+          />
+        </div>
+        <div className="flex flex-wrap gap-1.5">
+          {POPULAR.map((sym) => (
+            <Badge
+              key={sym}
+              variant="secondary"
+              className="cursor-pointer hover:bg-secondary/80"
+              onClick={() => {
+                const t = TOKENS.find((tk) => tk.symbol === sym)
+                if (t) onSelect(t)
+              }}
+            >
+              {sym}
+            </Badge>
+          ))}
+        </div>
+        <ScrollArea className="h-64">
+          <div className="space-y-1">
+            {filtered.map((token) => (
+              <button
+                key={token.symbol}
+                onClick={() => onSelect(token)}
+                className="flex w-full items-center gap-3 rounded-lg px-3 py-2 text-left hover:bg-muted/50 transition-colors"
+              >
+                <div
+                  className="flex h-8 w-8 items-center justify-center rounded-full text-xs font-bold text-white"
+                  style={{ backgroundColor: token.color }}
+                >
+                  {token.symbol[0]}
+                </div>
+                <div className="flex-1 min-w-0">
+                  <p className="text-sm font-medium">{token.symbol}</p>
+                  <p className="text-xs text-muted-foreground">{token.name}</p>
+                </div>
+                <span className="text-sm text-muted-foreground">{token.balance}</span>
+              </button>
+            ))}
+          </div>
+        </ScrollArea>
+      </DialogContent>
+    </Dialog>
+  )
+}

package/registry/layers/capability/crypto-swap-ui/manifest.json

@@ -0,0 +1,25 @@
+{
+  "id": "crypto-swap-ui",
+  "description": "DEX swap interface with token pair selection, slippage settings, and liquidity pool cards.",
+  "group": "capability",
+  "appliesTo": ["nextjs-ts", "react-vite-ts", "fullstack-ts"],
+  "keywords": ["swap", "dex", "exchange", "token swap", "amm", "liquidity", "uniswap", "raydium", "jupiter"],
+  "capabilityRequires": ["shadcn"],
+  "files": [
+    { "source": "files/swap-card.tsx", "target": "src/components/crypto/swap-card.tsx" },
+    { "source": "files/token-select-dialog.tsx", "target": "src/components/crypto/token-select-dialog.tsx" },
+    { "source": "files/pool-card.tsx", "target": "src/components/crypto/pool-card.tsx" }
+  ],
+  "buildHints": {
+    "pages": ["/swap", "/pools", "/pools/[id]"],
+    "apiRoutes": ["/api/swap/quote", "/api/pools"],
+    "components": ["SwapCard", "TokenSelectDialog", "PoolCard"],
+    "integrations": ["DEX aggregator API for quotes and routing", "Wallet adapter for transaction signing"],
+    "architectureNotes": [
+      "SwapCard handles token pair input with direction toggle and slippage configuration.",
+      "TokenSelectDialog provides searchable token list with popular token shortcuts.",
+      "PoolCard displays liquidity position details with add/remove actions.",
+      "Wire swap execution to your DEX router contract or aggregator API."
+    ]
+  }
+}

package/registry/layers/capability/defi-bridge/files/bridge-config.json

@@ -0,0 +1,15 @@
+{
+  "model": "{{bridgeModel}}",
+  "messagingProtocol": "{{messagingProtocol}}",
+  "chains": [
+    { "id": 1, "name": "Ethereum", "rpc": "" },
+    { "id": 42161, "name": "Arbitrum", "rpc": "" }
+  ],
+  "features": ["lock-and-mint", "burn-and-release", "message-passing", "proof-verification"],
+  "references": ["LayerZero", "Wormhole", "Axelar", "Connext"],
+  "notes": [
+    "Lock-and-mint requires a relayer service to submit proofs on the destination chain.",
+    "Message passing needs finality guarantees — never relay unfinalized messages.",
+    "Use canonical bridges where available; custom bridges require security audits."
+  ]
+}

package/registry/layers/capability/defi-bridge/manifest.json

@@ -0,0 +1,35 @@
+{
+  "id": "defi-bridge",
+  "description": "Adds cross-chain bridge and messaging patterns with lock/mint, burn/release, and proof verification.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "bridgeModel": "lock-and-mint",
+    "messagingProtocol": "custom"
+  },
+  "files": [
+    {
+      "source": "files/bridge-config.json",
+      "target": "bridge-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "bridge-config.json"
+    ]
+  },
+  "keywords": [
+    "bridge protocol",
+    "cross-chain bridge",
+    "lock and mint",
+    "burn and release",
+    "cross-chain messaging",
+    "wormhole",
+    "axelar",
+    "connext"
+  ]
+}

package/registry/layers/capability/defi-dex/files/dex-config.json

@@ -0,0 +1,15 @@
+{
+  "model": "{{dexModel}}",
+  "feeModel": "{{feeModel}}",
+  "features": ["create-pool", "add-liquidity", "remove-liquidity", "swap", "multi-hop-routing"],
+  "feeConfig": {
+    "swapFeeBps": 30,
+    "protocolFeeBps": 5
+  },
+  "references": ["Uniswap V3/V4", "Curve", "Balancer V2"],
+  "notes": [
+    "Constant-product (x*y=k) is simplest; concentrated liquidity requires tick math.",
+    "Multi-hop routing needs a graph-based path finder.",
+    "Fee tiers should be configurable per pool for competitive pricing."
+  ]
+}

package/registry/layers/capability/defi-dex/manifest.json

@@ -0,0 +1,36 @@
+{
+  "id": "defi-dex",
+  "description": "Adds DEX/AMM protocol patterns with pool creation, swap routing, and liquidity management.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "dexModel": "constant-product",
+    "feeModel": "fixed"
+  },
+  "files": [
+    {
+      "source": "files/dex-config.json",
+      "target": "dex-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "dex-config.json"
+    ]
+  },
+  "keywords": [
+    "dex",
+    "amm",
+    "swap router",
+    "liquidity pool",
+    "constant product",
+    "concentrated liquidity",
+    "uniswap",
+    "curve",
+    "balancer"
+  ]
+}

package/registry/layers/capability/defi-lending/files/lending-config.json

@@ -0,0 +1,15 @@
+{
+  "protocol": "{{lendingProtocol}}",
+  "oracle": "{{lendingOracle}}",
+  "pools": [
+    { "asset": "WETH", "collateralFactor": 0.80, "liquidationThreshold": 0.85 },
+    { "asset": "USDC", "collateralFactor": 0.90, "liquidationThreshold": 0.95 }
+  ],
+  "features": ["supply", "borrow", "repay", "liquidate", "flash-loans"],
+  "references": ["Aave V3", "Compound V3", "Morpho"],
+  "notes": [
+    "Pool parameters follow Aave-style collateral factor and liquidation threshold model.",
+    "Flash loans require atomic transaction composition.",
+    "Oracle integration is mandatory — never use spot price for liquidation decisions."
+  ]
+}

package/registry/layers/capability/defi-lending/manifest.json

@@ -0,0 +1,36 @@
+{
+  "id": "defi-lending",
+  "description": "Adds DeFi lending/borrowing protocol patterns with pool management, collateral tracking, and liquidation logic.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "lendingProtocol": "custom",
+    "lendingOracle": "chainlink"
+  },
+  "files": [
+    {
+      "source": "files/lending-config.json",
+      "target": "lending-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "lending-config.json"
+    ]
+  },
+  "keywords": [
+    "lending protocol",
+    "borrowing protocol",
+    "lending pool",
+    "collateral",
+    "liquidation",
+    "flash loan",
+    "aave",
+    "compound",
+    "morpho"
+  ]
+}

package/registry/layers/capability/defi-perpetuals/files/perp-config.json

@@ -0,0 +1,11 @@
+{
+  "oracle": "{{perpOracle}}",
+  "collateral": "{{perpCollateral}}",
+  "markets": [
+    { "pair": "ETH-USD", "maxLeverage": 50, "maintenanceMargin": 0.005 },
+    { "pair": "BTC-USD", "maxLeverage": 100, "maintenanceMargin": 0.004 }
+  ],
+  "features": ["open-position", "close-position", "liquidation", "funding-rate", "cross-margin", "auto-deleverage"],
+  "references": ["GMX V2", "dYdX V4", "Hyperliquid"],
+  "notes": ["Funding rates settle every 8 hours based on mark vs index price.", "Liquidation engine must be MEV-resistant — use keeper network.", "Cross-margin shares collateral across positions in the same account."]
+}

package/registry/layers/capability/defi-perpetuals/manifest.json

@@ -0,0 +1,34 @@
+{
+  "id": "defi-perpetuals",
+  "description": "Adds EVM perpetual futures protocol patterns with funding rates, margin, and liquidation engine.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "perpOracle": "chainlink",
+    "perpCollateral": "USDC"
+  },
+  "files": [
+    {
+      "source": "files/perp-config.json",
+      "target": "perp-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "perp-config.json"
+    ]
+  },
+  "keywords": [
+    "perpetual futures",
+    "perps protocol",
+    "funding rate",
+    "liquidation engine",
+    "margin trading",
+    "gmx",
+    "hyperliquid"
+  ]
+}

package/registry/layers/capability/defi-restaking/files/restaking-config.json

@@ -0,0 +1,6 @@
+{
+  "protocol": "{{restakingProtocol}}",
+  "features": ["operator-registration", "delegation", "slashing", "withdrawal-queue", "strategy-management"],
+  "references": ["EigenLayer", "Symbiotic", "Karak"],
+  "notes": ["Operators register and opt-in to AVS services.", "Delegators stake through strategies (LST, native ETH).", "Slashing conditions are AVS-specific — define them in the AVS contract.", "Withdrawal queue enforces unbonding periods for security."]
+}

package/registry/layers/capability/defi-restaking/manifest.json

@@ -0,0 +1,32 @@
+{
+  "id": "defi-restaking",
+  "description": "Adds restaking protocol patterns for EigenLayer-style shared security and operator management.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "restakingProtocol": "eigenlayer-compatible"
+  },
+  "files": [
+    {
+      "source": "files/restaking-config.json",
+      "target": "restaking-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "restaking-config.json"
+    ]
+  },
+  "keywords": [
+    "restaking",
+    "shared security",
+    "operator registration",
+    "delegation",
+    "symbiotic",
+    "karak"
+  ]
+}

package/registry/layers/capability/defi-yield/files/yield-config.json

@@ -0,0 +1,16 @@
+{
+  "vaultStandard": "{{vaultStandard}}",
+  "compoundFrequency": "{{compoundFrequency}}",
+  "strategies": [
+    { "name": "single-asset-staking", "risk": "low" },
+    { "name": "lp-farming", "risk": "medium" },
+    { "name": "leveraged-yield", "risk": "high" }
+  ],
+  "features": ["deposit", "withdraw", "harvest", "auto-compound", "emergency-withdraw"],
+  "references": ["Yearn V3", "Beefy", "ERC-4626 Tokenized Vaults"],
+  "notes": [
+    "ERC-4626 is the standard vault interface — use it for composability.",
+    "Auto-compound requires a keeper or cron worker to trigger harvests.",
+    "Emergency withdraw bypasses strategy and returns underlying directly."
+  ]
+}

package/registry/layers/capability/defi-yield/manifest.json

@@ -0,0 +1,36 @@
+{
+  "id": "defi-yield",
+  "description": "Adds yield aggregator and vault strategy patterns with auto-compounding and reward harvesting.",
+  "appliesTo": [
+    "forge-contracts",
+    "hardhat-contracts",
+    "api-service",
+    "evm-infra-ts",
+    "worker-job"
+  ],
+  "defaults": {
+    "vaultStandard": "erc4626",
+    "compoundFrequency": "daily"
+  },
+  "files": [
+    {
+      "source": "files/yield-config.json",
+      "target": "yield-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "yield-config.json"
+    ]
+  },
+  "keywords": [
+    "yield aggregator",
+    "vault strategy",
+    "auto-compound",
+    "yield farming",
+    "erc-4626",
+    "erc4626",
+    "yearn",
+    "beefy"
+  ]
+}

package/registry/layers/capability/deploy-docker/files/deploy-config.json

@@ -0,0 +1,15 @@
+{
+  "containerRuntime": "docker",
+  "compose": true,
+  "services": [
+    { "name": "app", "port": 3000, "healthCheck": "/health" }
+  ],
+  "environment": ["NODE_ENV=production"],
+  "volumes": [],
+  "notes": [
+    "Generate a Dockerfile appropriate for the project language and runtime.",
+    "docker-compose.yml should include the app service and any dependencies (postgres, redis).",
+    "Use multi-stage builds to keep production images lean.",
+    "Add .dockerignore to exclude node_modules, .git, and build artifacts."
+  ]
+}

package/registry/layers/capability/deploy-docker/manifest.json

@@ -0,0 +1,42 @@
+{
+  "id": "deploy-docker",
+  "description": "Adds Dockerfile, docker-compose.yml, and container deployment patterns.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "go-api",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "worker-job",
+    "python-worker",
+    "go-worker",
+    "fullstack-ts",
+    "nextjs-ts",
+    "evm-infra-ts",
+    "mcp-server-ts",
+    "x402-service",
+    "zk-prover-service"
+  ],
+  "files": [
+    {
+      "source": "files/deploy-config.json",
+      "target": "deploy-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "deploy-config.json",
+      "Dockerfile",
+      "docker-compose.yml"
+    ]
+  },
+  "keywords": [
+    "docker",
+    "dockerfile",
+    "docker-compose",
+    "containerize",
+    "container deployment"
+  ]
+}

package/registry/layers/capability/deploy-github-actions/files/ci-config.json

@@ -0,0 +1,12 @@
+{
+  "provider": "github-actions",
+  "triggers": ["push:main", "pull_request"],
+  "stages": ["lint", "test", "build", "deploy"],
+  "deployTarget": null,
+  "notes": [
+    "Generate .github/workflows/ci.yml with steps appropriate for the project language.",
+    "Use language-specific caching (npm, pip, cargo, go modules).",
+    "Deploy stage should be conditional on branch (main only).",
+    "Add secrets for API keys and deploy credentials in GitHub repo settings."
+  ]
+}

package/registry/layers/capability/deploy-github-actions/manifest.json

@@ -0,0 +1,46 @@
+{
+  "id": "deploy-github-actions",
+  "description": "Adds GitHub Actions CI/CD workflow templates for build, test, and deploy.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "go-api",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "worker-job",
+    "python-worker",
+    "go-worker",
+    "fullstack-ts",
+    "nextjs-ts",
+    "react-vite-ts",
+    "forge-contracts",
+    "hardhat-contracts",
+    "solana-program",
+    "move-contracts",
+    "evm-infra-ts",
+    "mcp-server-ts",
+    "x402-service"
+  ],
+  "files": [
+    {
+      "source": "files/ci-config.json",
+      "target": "ci-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "ci-config.json",
+      ".github/workflows/ci.yml"
+    ]
+  },
+  "keywords": [
+    "github actions",
+    "ci/cd",
+    "ci cd",
+    "continuous integration",
+    "continuous deployment",
+    "github workflow"
+  ]
+}

package/registry/layers/capability/effect-ts/files/effect-config.json

@@ -0,0 +1,5 @@
+{
+  "framework": "effect-ts",
+  "features": ["typed-errors", "dependency-injection", "structured-concurrency", "streaming", "schema-validation"],
+  "notes": ["Use Effect.gen for generator-based control flow.", "Layer system replaces manual dependency injection.", "Schema module replaces zod/joi for runtime validation.", "Structured concurrency prevents resource leaks in async workflows."]
+}

package/registry/layers/capability/effect-ts/manifest.json

@@ -0,0 +1,30 @@
+{
+  "id": "effect-ts",
+  "description": "Adds Effect-TS patterns for typed errors, dependency injection, and structured concurrency.",
+  "appliesTo": [
+    "api-service",
+    "agent-service-ts",
+    "fullstack-ts",
+    "worker-job",
+    "cli-ts",
+    "cloudflare-worker-ts"
+  ],
+  "files": [
+    {
+      "source": "files/effect-config.json",
+      "target": "effect-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "effect-config.json"
+    ]
+  },
+  "keywords": [
+    "effect-ts",
+    "effect ts",
+    "effect runtime",
+    "typed errors",
+    "structured concurrency"
+  ]
+}

package/registry/layers/capability/evm-account-abstraction/files/Deploy.s.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract DeployScript {
+    function run() external returns ({{contractName}} deployed) {
+        deployed = new {{contractName}}("ipfs://starter-foundry/");
+    }
+}

package/registry/layers/capability/evm-account-abstraction/files/GaslessCollectible.sol

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+contract {{contractName}} {
+    string public baseURI;
+    uint256 public nextTokenId = 1;
+    mapping(uint256 => address) private owners;
+
+    constructor(string memory initialBaseURI) {
+        baseURI = initialBaseURI;
+    }
+
+    function mint(address recipient) external returns (uint256 tokenId) {
+        tokenId = nextTokenId++;
+        owners[tokenId] = recipient;
+    }
+
+    function ownerOf(uint256 tokenId) external view returns (address) {
+        return owners[tokenId];
+    }
+}

package/registry/layers/capability/evm-account-abstraction/files/GaslessCollectible.t.sol

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract {{contractName}}Test {
+    {{contractName}} internal collectible;
+
+    function setUp() public {
+        collectible = new {{contractName}}("ipfs://collection/");
+    }
+
+    function test_mint_assigns_owner() public {
+        uint256 tokenId = collectible.mint(address(0xCAFE));
+        assert(collectible.ownerOf(tokenId) == address(0xCAFE));
+    }
+}

package/registry/layers/capability/evm-account-abstraction/files/MintWithBundler.s.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract MintWithBundlerScript {
+    function run({{contractName}} collectible, address recipient) external returns (uint256) {
+        // In the real product flow this would be wrapped by a bundler or paymaster.
+        return collectible.mint(recipient);
+    }
+}

package/registry/layers/capability/evm-account-abstraction/files/bundler-config.json

@@ -0,0 +1,10 @@
+{
+  "stack": "erc-4337",
+  "client": "permissionless.js",
+  "transport": "viem",
+  "gasMode": "sponsored",
+  "notes": [
+    "Bias the agent toward a separate bundler client lane instead of mixing UI and deploy concerns.",
+    "Treat OKB gas abstraction as a first-class product behavior."
+  ]
+}